From unknown Sat Aug 09 04:57:53 2025 X-Loop: help-debbugs@gnu.org Subject: bug#18201: 24.4.50; doc string of `file-accessible-directory-p' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 05 Aug 2014 19:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 18201 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 18201@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.14072660426578 (code B ref -1); Tue, 05 Aug 2014 19:15:02 +0000 Received: (at submit) by debbugs.gnu.org; 5 Aug 2014 19:14:02 +0000 Received: from localhost ([127.0.0.1]:59184 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XEkBO-0001i2-3L for submit@debbugs.gnu.org; Tue, 05 Aug 2014 15:14:02 -0400 Received: from eggs.gnu.org ([208.118.235.92]:58119) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1XEkBM-0001hR-1D for submit@debbugs.gnu.org; Tue, 05 Aug 2014 15:14:00 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XEkB6-0002p3-IP for submit@debbugs.gnu.org; Tue, 05 Aug 2014 15:13:54 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.5 required=5.0 tests=BAYES_05 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:42961) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XEkB6-0002oz-Fc for submit@debbugs.gnu.org; Tue, 05 Aug 2014 15:13:44 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:59806) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XEkAx-0000VQ-MG for bug-gnu-emacs@gnu.org; Tue, 05 Aug 2014 15:13:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XEkAo-0002nB-VX for bug-gnu-emacs@gnu.org; Tue, 05 Aug 2014 15:13:35 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:32164) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XEkAo-0002n6-PN for bug-gnu-emacs@gnu.org; Tue, 05 Aug 2014 15:13:26 -0400 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s75JDPBv008707 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 5 Aug 2014 19:13:25 GMT Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id s75JDOmN025953 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 5 Aug 2014 19:13:24 GMT Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s75JDN6i012178 for ; Tue, 5 Aug 2014 19:13:23 GMT MIME-Version: 1.0 Message-ID: Date: Tue, 5 Aug 2014 12:13:22 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.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: -4.0 (----) The doc string: Return t if file FILENAME names a directory you can open. For the value to be t, FILENAME must specify the name of a directory as a = file, and the directory must allow you to open files in it. In order to use a directory as a buffer's current directory, this predicate must return true= . A directory name spec may be given instead; then the value is t if the directory so specified exists and really is a readable and searchable directory. 1. Unless other non-nil values can be returned, in which case they need to be documented, the doc should refer to "non-nil" (or "true"), not to `t'. 2. "Return t if file FILENAME names a directory..." is wrong. It should say just "FILENAME", not "file FILENAME". A file does not name anything. A file name names something (in this case, a directory). #1 and #2 are problems for other, related doc strings, as well. Presumably someone renamed the parameter from FILE to FILENAME without adapting the doc string properly (?). 3. The biggest problem with this doc string is that it refers to something called a "directory name spec", without either (1) saying what that is or (2) telling you where to find this information. You CANNOT understand this doc string without knowing what "directory name spec" means. 4. The lines of text should not be longer than 70 chars (except the first, which can be a little longer. The second line is 79 chars. Please fill all but the first line. In GNU Emacs 24.4.50.1 (i686-pc-mingw32) of 2014-06-28 on ODIEONE Bzr revision: 117431 rgm@gnu.org-20140628015517-eku6hj8mpgcvfnso Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/Devel/emacs/snapshot/trunk --enable-checking=3Dyes,glyphs 'CFLAGS=3D-O0 -g3' LDFLAGS=3D-Lc:/Devel/emacs/lib 'CPPFLAGS=3D-DGC_MCHECK=3D1 -Ic:/Devel/emacs/include'' From unknown Sat Aug 09 04:57:53 2025 X-Loop: help-debbugs@gnu.org Subject: bug#18201: 24.4.50; doc string of `file-accessible-directory-p' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 29 Apr 2016 23:26:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 18201 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 18201@debbugs.gnu.org Received: via spool by 18201-submit@debbugs.gnu.org id=B18201.146197233917527 (code B ref 18201); Fri, 29 Apr 2016 23:26:02 +0000 Received: (at 18201) by debbugs.gnu.org; 29 Apr 2016 23:25:39 +0000 Received: from localhost ([127.0.0.1]:56190 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awHn1-0004Yd-4Y for submit@debbugs.gnu.org; Fri, 29 Apr 2016 19:25:39 -0400 Received: from hermes.netfonds.no ([80.91.224.195]:51935) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awHmz-0004YV-0h for 18201@debbugs.gnu.org; Fri, 29 Apr 2016 19:25:37 -0400 Received: from cm-84.215.1.64.getinternet.no ([84.215.1.64] helo=mouse) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1awHmv-0004FT-TE; Sat, 30 Apr 2016 01:25:36 +0200 From: Lars Ingebrigtsen References: Date: Sat, 30 Apr 2016 01:25:33 +0200 In-Reply-To: (Drew Adams's message of "Tue, 5 Aug 2014 12:13:22 -0700 (PDT)") Message-ID: <87bn4sknf6.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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: > Return t if file FILENAME names a directory you can open. > For the value to be t, FILENAME must specify the name of a directory as a file, > and the directory must allow you to open files in it. In order to use a > directory as a buffer's current directory, this predicate must return true. > A directory name spec may be given instead; then the value is t > if the directory so specified exists and really is a readable and > searchable directory. > > 1. Unless other non-nil values can be returned, in which case they need > to be documented, the doc should refer to "non-nil" (or "true"), not > to `t'. No, it does return precisely t. Perhaps later it'll return other values. > 2. "Return t if file FILENAME names a directory..." is wrong. It should > say just "FILENAME", not "file FILENAME". A file does not name > anything. A file name names something (in this case, a directory). Fixed. > 3. The biggest problem with this doc string is that it refers to > something called a "directory name spec", without either (1) saying > what that is or (2) telling you where to find this information. You > CANNOT understand this doc string without knowing what "directory > name spec" means. Hm... I don't know what the doc string means here. And looking at the code, I still don't understand. Anybody? > 4. The lines of text should not be longer than 70 chars (except the > first, which can be a little longer. The second line is 79 chars. > Please fill all but the first line. Fixed. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From unknown Sat Aug 09 04:57:53 2025 X-Loop: help-debbugs@gnu.org Subject: bug#18201: 24.4.50; doc string of `file-accessible-directory-p' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 29 May 2021 04:03:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 18201 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 18201@debbugs.gnu.org Received: via spool by 18201-submit@debbugs.gnu.org id=B18201.162226097430121 (code B ref 18201); Sat, 29 May 2021 04:03:02 +0000 Received: (at 18201) by debbugs.gnu.org; 29 May 2021 04:02:54 +0000 Received: from localhost ([127.0.0.1]:55657 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lmqBa-0007pl-Gc for submit@debbugs.gnu.org; Sat, 29 May 2021 00:02:54 -0400 Received: from quimby.gnus.org ([95.216.78.240]:34004) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lmqBY-0007mS-C1 for 18201@debbugs.gnu.org; Sat, 29 May 2021 00:02:53 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=DjnBOy0QTLfcvluKH6zZsYCkHw6fhL3NCNewQwIzET0=; b=hM/mQ7t49g4oCUP26Y6Yq9EXNF WYJIbXeTTNeMOREerz0q7iIo3kj7qvf0lbjbCdhaHAJE0hiclc+8VIZGusJcRyeTLnxwnBNz69X5D r6Nphq6/Np9oi2N8o/De2E0QMpxd/vwKFs+w+dScKPbYgjlIDvLlZQ9uQ2N8riEKP0i4=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lmqBP-0000xo-EW; Sat, 29 May 2021 06:02:45 +0200 From: Lars Ingebrigtsen References: <87bn4sknf6.fsf@gnus.org> X-Now-Playing: Joni Mitchell's _Ladies of the Canyon_: "The Circle Game" Date: Sat, 29 May 2021 06:02:42 +0200 In-Reply-To: <87bn4sknf6.fsf@gnus.org> (Lars Ingebrigtsen's message of "Sat, 30 Apr 2016 01:25:33 +0200") Message-ID: <87zgwetcf1.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Lars Ingebrigtsen writes: >> 3. The biggest problem with this doc string is that it refers to >> something called a "directory name spec", without either (1) saying >> what that is or (2) telling you where to find this informa [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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: -1.0 (-) Lars Ingebrigtsen writes: >> 3. The biggest problem with this doc string is that it refers to >> something called a "directory name spec", without either (1) saying >> what that is or (2) telling you where to find this information. You >> CANNOT understand this doc string without knowing what "directory >> name spec" means. > > Hm... I don't know what the doc string means here. And looking at the > code, I still don't understand. Anybody? The manual had a better explanation, so I copied that over in Emacs 28. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sat May 29 00:02:59 2021 Received: (at control) by debbugs.gnu.org; 29 May 2021 04:02:59 +0000 Received: from localhost ([127.0.0.1]:55660 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lmqBe-0007q2-Nf for submit@debbugs.gnu.org; Sat, 29 May 2021 00:02:58 -0400 Received: from quimby.gnus.org ([95.216.78.240]:34018) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lmqBc-0007pd-Ny for control@debbugs.gnu.org; Sat, 29 May 2021 00:02:56 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=Y+P1UiuOtnrUHB1efmPOoMPT0uJPDz3QXZA1GiZXIxc=; b=ogq4hqQtRS9rUsTzAXgGksDQGT tnQEZDsv4cqouCc83dkQKvHP0ljd5TCJpvtOo3TsJ59B3purfPDacLAUmYe2VqOKYE6nBLf1MZxl1 kDWV7S1ueLEbdTFKZhOjOXVQItZmn/yyWCSqWBNQtXIB+M+GBS0IxuR+lgxuFPZsSOGc=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lmqBV-0000xx-Ad for control@debbugs.gnu.org; Sat, 29 May 2021 06:02:51 +0200 Date: Sat, 29 May 2021 06:02:48 +0200 Message-Id: <87y2bytcev.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #18201 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 18201 fixed close 18201 28.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 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: -1.0 (-) tags 18201 fixed close 18201 28.1 quit