GNU bug report logs - #21962
25.0.50; doc of `normal-top-level-add-subdirs-to-load-path'

Previous Next

Full log

Message #8 received at 21962 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 21962 <at> debbugs.gnu.org
Subject: Re: bug#21962: 25.0.50;
 doc of `normal-top-level-add-subdirs-to-load-path'
Date: Sun, 01 May 2016 00:26:15 +0200

Drew Adams <drew.adams <at> oracle.com> writes:

> 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'.

I've now done so.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.