From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Memnon Anon Newsgroups: gmane.emacs.bugs Subject: bug#10057: 24.0.91; doc string of `Info-find-file' Date: Wed, 16 Nov 2011 18:43:53 +0000 (UTC) Message-ID: <87ty643pub.fsf@mean.albasani.net> References: <8B7B45455BDC4BFBAC6E24B36D21695F@us.oracle.com> <7DCB4AC13F2B4BA19A9BBB34E78086CA@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: dough.gmane.org 1321469875 21146 80.91.229.12 (16 Nov 2011 18:57:55 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 16 Nov 2011 18:57:55 +0000 (UTC) To: 10057@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Nov 16 19:57:51 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RQkg8-0002P5-3G for geb-bug-gnu-emacs@m.gmane.org; Wed, 16 Nov 2011 19:57:48 +0100 Original-Received: from localhost ([::1]:55027 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQkg7-0003yF-Mw for geb-bug-gnu-emacs@m.gmane.org; Wed, 16 Nov 2011 13:57:47 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:42394) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQkfd-0003xT-Mb for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:57:18 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RQkfc-0005C4-8q for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:57:17 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:52159) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQkfc-0005By-7J for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:57:16 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1RQkgL-0002N8-Ni for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:58:01 -0500 X-Loop: help-debbugs@gnu.org In-Reply-To: <8B7B45455BDC4BFBAC6E24B36D21695F@us.oracle.com> Resent-From: Memnon Anon Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 16 Nov 2011 18:58:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10057 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.13214698489073 (code B ref -1); Wed, 16 Nov 2011 18:58:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 16 Nov 2011 18:57:28 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RQkfo-0002MG-Ev for submit@debbugs.gnu.org; Wed, 16 Nov 2011 13:57:28 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RQkZc-0002Cj-BW for submit@debbugs.gnu.org; Wed, 16 Nov 2011 13:51:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RQkYl-00044v-Hn for submit@debbugs.gnu.org; Wed, 16 Nov 2011 13:50:12 -0500 Original-Received: from lists.gnu.org ([140.186.70.17]:58020) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQkYl-00044r-GM for submit@debbugs.gnu.org; Wed, 16 Nov 2011 13:50:11 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:42282) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQkYk-0003LI-GG for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:50:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RQkYj-00044I-Eg for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:50:10 -0500 Original-Received: from lo.gmane.org ([80.91.229.12]:53937) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQkYj-00043j-9Z for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:50:09 -0500 Original-Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1RQkYh-0006JC-Iv for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 19:50:07 +0100 Original-Received: from e178213104.adsl.alicedsl.de ([85.178.213.104]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 16 Nov 2011 19:50:07 +0100 Original-Received: from gegendosenfleisch by e178213104.adsl.alicedsl.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 16 Nov 2011 19:50:07 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 36 Original-X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: e178213104.adsl.alicedsl.de Cancel-Lock: sha1:ZocFZAXk7iCc2Vot/2oZUdOUTMU= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Mailman-Approved-At: Wed, 16 Nov 2011 13:57:27 -0500 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 16 Nov 2011 13:58:01 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-Mailman-Approved-At: Wed, 16 Nov 2011 13:57:46 -0500 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:53996 Archived-At: Stefan Monnier writes: >> 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. ,----[ (info "(elisp)Documentation Tips") ] | * The documentation string for a variable that is a yes-or-no flag | should start with words such as "Non-nil means," to make it clear ! that all non-`nil' values are equivalent and indicate explicitly | what `nil' and non-`nil' mean. `---- How is this so much different? The function checks for '(if noerror ...' , so "non-nil" matches what the function actually does more precisely. Future compatibility? The sentence in the docstring dates back to 2004, for all versions since then, the test was always '(if noerror ...'. When is this future to come? If there were plans to differentiate 't' from other non-nil values, I think they got lost :). And it's not like the file is under heavy development and an ever moving target, anyways ... Whatever, this teeny tiny issue got way more attention than it deserved in the first place I guess, so ... I'll stop now ;) Memnon