bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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


From: Lars Ingebrigtsen
Subject: bug#21962: 25.0.50; doc of `normal-top-level-add-subdirs-to-load-path'
Date: Sun, 01 May 2016 00:26:15 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux)

Drew Adams <address@hidden> 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





reply via email to

[Prev in Thread] Current Thread [Next in Thread]