GNU bug report logs - #10057
24.0.91; doc string of `Info-find-file'

Previous Next

Full log

Message #20 received at 10057 <at> debbugs.gnu.org (full text, mbox):

From: Andreas Schwab <schwab <at> linux-m68k.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 'Juri Linkov' <juri <at> jurta.org>, 10057 <at> debbugs.gnu.org
Subject: Re: bug#10057: 24.0.91; doc string of `Info-find-file'
Date: Tue, 15 Nov 2011 23:17:00 +0100

"Drew Adams" <drew.adams <at> oracle.com> writes:

>> > "Optional second argument NOERROR, if t, means if file is not found
>> > just return nil (no error)."
>> >
>> > This says only what a value of `t' means.  It does not say what
>> > other non-nil values mean.  Please state clearly and completely what
>> > NOERROR means.
>> 
>> Do you know other possible non-nil values?
>
> No, not I.  If all non-nil values are treated the same, then the doc should not
> single out `t'.  As it stands now, it says "if t, ..." it means ..., which
> _suggests_ that that is the case _only_ if t.

You are supposed to use only the value that is documented.  This is
called future compatibility.

Andreas.

-- 
Andreas Schwab, schwab <at> linux-m68k.org
GPG Key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.