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#21962: 25.0.50; doc of `normal-top-level-add-subdirs-to-load-path' Date: Thu, 19 Nov 2015 21:15:52 -0800 (PST) Message-ID: <4c09cdd8-32cc-4d67-92fb-bfd20e404c80@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1447996677 27771 80.91.229.3 (20 Nov 2015 05:17:57 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 20 Nov 2015 05:17:57 +0000 (UTC) To: 21962@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 20 06:17:44 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Zze4k-0005CM-Mp for geb-bug-gnu-emacs@m.gmane.org; Fri, 20 Nov 2015 06:17:34 +0100 Original-Received: from localhost ([::1]:45399 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zze4k-0003MT-8E for geb-bug-gnu-emacs@m.gmane.org; Fri, 20 Nov 2015 00:17:34 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55662) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zze4I-0002ib-3Y for bug-gnu-emacs@gnu.org; Fri, 20 Nov 2015 00:17:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Zze4E-0001Xa-TS for bug-gnu-emacs@gnu.org; Fri, 20 Nov 2015 00:17:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:55709) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zze4E-0001XW-QU for bug-gnu-emacs@gnu.org; Fri, 20 Nov 2015 00:17:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Zze4E-0007tP-8Z for bug-gnu-emacs@gnu.org; Fri, 20 Nov 2015 00:17:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 20 Nov 2015 05:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 21962 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.144799656430230 (code B ref -1); Fri, 20 Nov 2015 05:17:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 20 Nov 2015 05:16:04 +0000 Original-Received: from localhost ([127.0.0.1]:45417 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Zze3I-0007rT-3d for submit@debbugs.gnu.org; Fri, 20 Nov 2015 00:16:04 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:45441) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Zze3F-0007qv-9B for submit@debbugs.gnu.org; Fri, 20 Nov 2015 00:16:02 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Zze3E-0001ME-Eu for submit@debbugs.gnu.org; Fri, 20 Nov 2015 00:16:01 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:38760) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zze3E-0001MA-BT for submit@debbugs.gnu.org; Fri, 20 Nov 2015 00:16:00 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55441) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zze3D-0002G3-F1 for bug-gnu-emacs@gnu.org; Fri, 20 Nov 2015 00:16:00 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Zze3A-0001Ll-2q for bug-gnu-emacs@gnu.org; Fri, 20 Nov 2015 00:15:59 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:28912) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zze39-0001LU-SK for bug-gnu-emacs@gnu.org; Fri, 20 Nov 2015 00:15:55 -0500 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id tAK5FsjV028267 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 20 Nov 2015 05:15:54 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id tAK5FrCu006499 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Fri, 20 Nov 2015 05:15:54 GMT Original-Received: from abhmp0009.oracle.com (abhmp0009.oracle.com [141.146.116.15]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id tAK5Fr05030038 for ; Fri, 20 Nov 2015 05:15:53 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 208.118.235.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:108945 Archived-At: Looking at the code, it seems that this function does not add only subdirectories of the current `default-directory'. It seems to add all descendant directories of `default-directory'. A subdirectory is a child, not a grandchild etc. I believe that is the usual terminology. It is, in any case, the terminology that Emacs uses in, for example Dired. It is also why the doc uses language such as "with subdirectories handled recursively" to distinguish the practice of handling not only the subdirectories of a directory, but their subdirectories, and so on, recursively. So IIUC what the function does, IMO its description is incorrect. Or at best it is misleading, if you claim that "subdirectory" means any descendant directory. Please change the doc to make clear just what directories are added to `load-path'. And consider documenting this function in the Elisp manual, if not in the Emacs manual. Similarly, function `normal-top-level-add-to-load-path. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2015-11-09 Bzr revision: 86c19714b097aa477d339ed99ffb5136c755a046 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/Devel/emacs/snapshot/trunk --enable-checking=3Dyes,glyphs --enable-check-lisp-object-type --without-compress-install --with-wide-int 'CFLAGS=3D-O0 -ggdb3' LDFLAGS=3D-Lc:/Devel/emacs/lib 'CPPFLAGS=3D-DGC_MCHECK=3D1 -Ic:/Devel/emacs/include''