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


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

From: Stefan Monnier <monnier <at> iro.umontreal.ca>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 10057 <at> debbugs.gnu.org
Subject: Re: bug#10057: 24.0.91; doc string of `Info-find-file'
Date: Tue, 15 Nov 2011 23:22:54 -0500
> I've sent plenty of patches, throughout "all these years", as you know.

No, I do not think you've sent plenty of them.  Especially not
docstring patches.

> If you need a patch to change `t' to `non-nil' then there is a problem.

You've overlooked the "and even  install them yourself" part.

> But it's not the lack of a patch that prevents you from making this
> doc change, obviously.  You do not _want_ to make it.

The docstring you quoted has a clear meaning of "undocumented behavior
for non-nil and non-t values".  I do not know whether that was the
intention of the original author and do not care to figure it out, so no
I don't want to install such a patch.  But if someone else wants to,
I won't oppose it.

> 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.  So be it.

Saying this explicitly everywhere we rely on it would be silly.
It's a general rule that applies to all software I know.


        Stefan




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.