From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.bugs Subject: bug#10057: 24.0.91; doc string of `Info-find-file' Date: Tue, 15 Nov 2011 23:22:54 -0500 Message-ID: References: <8B7B45455BDC4BFBAC6E24B36D21695F@us.oracle.com> <7DCB4AC13F2B4BA19A9BBB34E78086CA@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1321417409 9071 80.91.229.12 (16 Nov 2011 04:23:29 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 16 Nov 2011 04:23:29 +0000 (UTC) Cc: 10057@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Nov 16 05:23:25 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 1RQX1v-0004gD-Qw for geb-bug-gnu-emacs@m.gmane.org; Wed, 16 Nov 2011 05:23:23 +0100 Original-Received: from localhost ([::1]:49015 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQX1v-00078c-9u for geb-bug-gnu-emacs@m.gmane.org; Tue, 15 Nov 2011 23:23:23 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:58725) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQX1s-00078V-Ed for bug-gnu-emacs@gnu.org; Tue, 15 Nov 2011 23:23:21 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RQX1r-0003q8-98 for bug-gnu-emacs@gnu.org; Tue, 15 Nov 2011 23:23:20 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:49713) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQX1r-0003pI-7V for bug-gnu-emacs@gnu.org; Tue, 15 Nov 2011 23:23:19 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1RQX2X-00052A-RI for bug-gnu-emacs@gnu.org; Tue, 15 Nov 2011 23:24:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 16 Nov 2011 04:24: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: Original-Received: via spool by 10057-submit@debbugs.gnu.org id=B10057.132141742719330 (code B ref 10057); Wed, 16 Nov 2011 04:24:01 +0000 Original-Received: (at 10057) by debbugs.gnu.org; 16 Nov 2011 04:23:47 +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 1RQX2I-00051i-Df for submit@debbugs.gnu.org; Tue, 15 Nov 2011 23:23:47 -0500 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.183] helo=ironport2-out.pppoe.ca) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RQX2F-00051T-Sj for 10057@debbugs.gnu.org; Tue, 15 Nov 2011 23:23:44 -0500 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: ApUFAPg5w05MCqs//2dsb2JhbABDpwxCgiOBBoFyAQEEAVYjBQsLNBIUGA0kiBW5J4oXBIgUmXCESg X-IronPort-AV: E=Sophos;i="4.69,518,1315195200"; d="scan'208";a="148177821" Original-Received: from 76-10-171-63.dsl.teksavvy.com (HELO pastel.home) ([76.10.171.63]) by ironport2-out.pppoe.ca with ESMTP/TLS/ADH-AES256-SHA; 15 Nov 2011 23:22:54 -0500 Original-Received: by pastel.home (Postfix, from userid 20848) id 561FA5936A; Tue, 15 Nov 2011 23:22:54 -0500 (EST) In-Reply-To: <7DCB4AC13F2B4BA19A9BBB34E78086CA@us.oracle.com> (Drew Adams's message of "Tue, 15 Nov 2011 19:05:07 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.91 (gnu/linux) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Tue, 15 Nov 2011 23:24:01 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 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:53974 Archived-At: > 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