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

[Lars Ingebrigtsen]

Drew Adams <drew.adams@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