From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#10057: 24.0.91; doc string of `Info-find-file' Date: Wed, 16 Nov 2011 10:29:14 -0800 Message-ID: References: <8B7B45455BDC4BFBAC6E24B36D21695F@us.oracle.com><7DCB4AC13F2B4BA19A9BBB34E78086CA@us.oracle.com> <87wrb0p2nf.fsf@mail.jurta.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1321468235 7673 80.91.229.12 (16 Nov 2011 18:30:35 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 16 Nov 2011 18:30:35 +0000 (UTC) Cc: 10057@debbugs.gnu.org To: "'Juri Linkov'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Nov 16 19:30:30 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 1RQkFg-0003wL-PY for geb-bug-gnu-emacs@m.gmane.org; Wed, 16 Nov 2011 19:30:28 +0100 Original-Received: from localhost ([::1]:58661 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQkFf-0006CG-VC for geb-bug-gnu-emacs@m.gmane.org; Wed, 16 Nov 2011 13:30:27 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:47993) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQkFZ-0006CB-Lv for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:30:25 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RQkFU-0008FG-Sr for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:30:21 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:52054) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQkFU-0008F6-RM for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:30:16 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1RQkGE-0001iw-Cr for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2011 13:31:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 16 Nov 2011 18:31:02 +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.13214682166556 (code B ref 10057); Wed, 16 Nov 2011 18:31:02 +0000 Original-Received: (at 10057) by debbugs.gnu.org; 16 Nov 2011 18:30:16 +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 1RQkFT-0001hh-KX for submit@debbugs.gnu.org; Wed, 16 Nov 2011 13:30:16 -0500 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RQkFS-0001hU-94 for 10057@debbugs.gnu.org; Wed, 16 Nov 2011 13:30:14 -0500 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id pAGITLtI030173 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 16 Nov 2011 18:29:21 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id pAGITK2j019926 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 16 Nov 2011 18:29:20 GMT Original-Received: from abhmt102.oracle.com (abhmt102.oracle.com [141.146.116.54]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id pAGITEKS015996; Wed, 16 Nov 2011 12:29:14 -0600 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 16 Nov 2011 10:29:13 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcykgcDXZHNKiWOzRi+iTjy5Z45gzgAB5YNg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 In-Reply-To: <87wrb0p2nf.fsf@mail.jurta.org> X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-CT-RefId: str=0001.0A090207.4EC40102.0009,ss=1,re=0.000,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 16 Nov 2011 13:31:02 -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:53993 Archived-At: > Drew, it's __so difficult__ to figure out from your documentation > bug reports what and how you actually want to fix It's a joke, right? What part of this problem statement (your "what") is so difficult to understand? >> This says only what a value of `t' means. >> It does not say what other non-nil values mean. As to "how" I would like it to be fixed, that really doesn't matter much, does it? It should be enough to point out the problem, especially in a trivial case such as this. In any case, I did say how I would like to see it fixed: >> Please state clearly and completely what NOERROR means. However that might be done would be fine with me. The "how" isn't important. So far, we explain what a `nil' value means and what a `t' value means. That's clear as far as it goes, but it is not complete, which means that in the end it is also not clear. Singling out the particular non-nil value `t' this way leaves the reader wondering. Unless, that is, s?he assumes Stefan's general rule that anything not mentioned is unpredictable and unsupported.