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

Previous Next

Package: emacs;

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

Date: Tue, 15 Nov 2011 20:32:01 UTC

Severity: minor

Tags: notabug

Found in version 24.0.91

Done: Chong Yidong <cyd <at> gnu.org>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Eli Zaretskii'" <eliz <at> gnu.org>
Cc: 10057 <at> debbugs.gnu.org, monnier <at> iro.umontreal.ca
Subject: bug#10057: 24.0.91; doc string of `Info-find-file'
Date: Wed, 16 Nov 2011 10:29:59 -0800
> > Not according to Stefan's "general rule": According to 
> > that, omission indicates clearly to everyone that that
> > the behavior is unpredictable and unsupported.
> 
> That's a misrepresentation of what Stefan said. 

No, I don't think so:

>> You apparently want a non-nil, non-t value to implicitly be
>> considered unpredictable and unsupported ("you're on your own"),
   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>> for the benefit of "future compatibility", and you apparently
>> do not want to tell users that explicitly.
>
> Saying this explicitly everywhere we rely on it would be silly.
> It's a general rule that applies to all software I know.

What part of what he said does _not_ confirm that he claims that omission
implicitly indicates to readers that the behavior is unpredictable and
unsupported?

And again:

> Well, [the doc string] does say that if you use a non-nil
> and non-t value, you're on your own.

The doc string says nothing explicit about non-nil and non-t.
His claim is that it says this implicitly, by omission.





This bug report was last modified 13 years and 183 days ago.

Previous Next


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