From unknown Sat Aug 16 19:19:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#12674: 24.2.50; doc of `locate-file' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 18 Oct 2012 16:31:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 12674 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 12674@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.135057782915436 (code B ref -1); Thu, 18 Oct 2012 16:31:01 +0000 Received: (at submit) by debbugs.gnu.org; 18 Oct 2012 16:30:29 +0000 Received: from localhost ([127.0.0.1]:50150 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TOszM-00040u-87 for submit@debbugs.gnu.org; Thu, 18 Oct 2012 12:30:28 -0400 Received: from eggs.gnu.org ([208.118.235.92]:51474) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TOszK-00040f-0F for submit@debbugs.gnu.org; Thu, 18 Oct 2012 12:30:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TOsxr-0007XK-Cr for submit@debbugs.gnu.org; Thu, 18 Oct 2012 12:28:56 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:44345) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TOsxr-0007Wj-9d for submit@debbugs.gnu.org; Thu, 18 Oct 2012 12:28:55 -0400 Received: from eggs.gnu.org ([208.118.235.92]:33456) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TOsxl-0002YN-IV for bug-gnu-emacs@gnu.org; Thu, 18 Oct 2012 12:28:55 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TOsxf-0007Sq-QL for bug-gnu-emacs@gnu.org; Thu, 18 Oct 2012 12:28:49 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:42108) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TOsxf-0007RM-Ip for bug-gnu-emacs@gnu.org; Thu, 18 Oct 2012 12:28:43 -0400 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q9IGSe7M022383 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Thu, 18 Oct 2012 16:28:41 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q9IGSdrK029260 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Thu, 18 Oct 2012 16:28:40 GMT Received: from abhmt107.oracle.com (abhmt107.oracle.com [141.146.116.59]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q9IGSdgF031086 for ; Thu, 18 Oct 2012 11:28:39 -0500 Received: from dradamslap1 (/10.159.186.224) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 18 Oct 2012 09:28:39 -0700 From: "Drew Adams" Date: Thu, 18 Oct 2012 09:28:15 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 thread-index: Ac2tTZM65WNTKcjpSLyce2mJboRMQw== X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 208.118.235.17 X-Spam-Score: -3.4 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.4 (---) The description in the Elisp manual is fine. The doc string is generally OK, except for its second sentence. This part of the second sentence is not clear (meaningless, misleading): ", with its suffixes". It's unclear what that might mean (return the absolute file name, plus a list of its suffixes?). But it certainly cannot mean what really happens: the absolute file name is returned, including ONE of the suffixes if appropriate. Just say what the manual says: the absolute file name is returned: If it finds such a file, it returns the file's absolute file name; otherwise it returns `nil'. In GNU Emacs 24.2.50.1 (i386-mingw-nt5.1.2600) of 2012-10-15 on DANI-PC Bzr revision: 110553 monnier@iro.umontreal.ca-20121015164957-6zms5w2js1xkldtg Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -I../../libs/libxpm-3.5.8/include -I../../libs/libxpm-3.5.8/src -I../../libs/libpng-1.4.10 -I../../libs/zlib-1.2.6 -I../../libs/giflib-4.1.4-1/include -I../../libs/jpeg-6b-4/include -I../../libs/tiff-3.8.2-1/include -I../../libs/libxml2-2.7.8-w32-bin/include/libxml2 -I../../libs/gnutls-3.0.16/include -I../../libs/libiconv-1.14-2-mingw32-dev/include' From unknown Sat Aug 16 19:19:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#12674: 24.2.50; doc of `locate-file' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 09 Feb 2014 03:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12674 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Drew Adams" Cc: 12674@debbugs.gnu.org Received: via spool by 12674-submit@debbugs.gnu.org id=B12674.13919148122209 (code B ref 12674); Sun, 09 Feb 2014 03:01:02 +0000 Received: (at 12674) by debbugs.gnu.org; 9 Feb 2014 03:00:12 +0000 Received: from localhost ([127.0.0.1]:58595 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCKcu-0000Yt-5E for submit@debbugs.gnu.org; Sat, 08 Feb 2014 22:00:12 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:58396) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCKcs-0000WB-2j for 12674@debbugs.gnu.org; Sat, 08 Feb 2014 22:00:10 -0500 Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WCKca-0004CV-Dc; Sun, 09 Feb 2014 03:59:52 +0100 From: Lars Ingebrigtsen References: Date: Sat, 08 Feb 2014 18:58:42 -0800 In-Reply-To: (Drew Adams's message of "Thu, 18 Oct 2012 09:28:15 -0700") Message-ID: <87a9e1j8kd.fsf@building.gnus.org> User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1WCKca-0004CV-Dc X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392519595.60783@yUQxaRTfKNSnIgJKcQ61Sw X-Spam-Status: No X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) "Drew Adams" writes: > The description in the Elisp manual is fine. The doc string is > generally OK, except for its second sentence. This part of the second > sentence is not clear (meaningless, misleading): ", with its suffixes". > > It's unclear what that might mean (return the absolute file name, plus a > list of its suffixes?). But it certainly cannot mean what really > happens: the absolute file name is returned, including ONE of the > suffixes if appropriate. > > Just say what the manual says: the absolute file name is returned: > > If it finds such a file, it returns the file's absolute file name; > otherwise it returns `nil'. Fixed on trunk. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 08 22:00:15 2014 Received: (at control) by debbugs.gnu.org; 9 Feb 2014 03:00:15 +0000 Received: from localhost ([127.0.0.1]:58597 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCKcw-0000c2-NY for submit@debbugs.gnu.org; Sat, 08 Feb 2014 22:00:14 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:58400) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCKct-0000Xi-E4 for control@debbugs.gnu.org; Sat, 08 Feb 2014 22:00:11 -0500 Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WCKcf-0004CY-12 for control@debbugs.gnu.org; Sun, 09 Feb 2014 03:59:57 +0100 Date: Sat, 08 Feb 2014 18:58:46 -0800 Message-Id: <878utlj8k9.fsf@building.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #12674 X-MailScanner-ID: 1WCKcf-0004CY-12 X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392519597.79642@IwkvD26KFyUX4UL8LL847A X-Spam-Status: No X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.0 (/) close 12674 24.4