GNU bug report logs - #9274
24.0.50; doc string of `normal-top-level-add-subdirs-to-load-path'

Previous Next

Package: emacs;

Reported by: "Drew Adams" <drew.adams <at> oracle.com>

Date: Tue, 9 Aug 2011 22:28:02 UTC

Severity: minor

Found in version 24.0.50

Done: Chong Yidong <cyd <at> stupidchicken.com>

Bug is archived. No further changes may be made.

Full log

View this message in rfc822 format

From: "Drew Adams" <drew.adams <at> oracle.com>
To: 9274 <at> debbugs.gnu.org
Subject: bug#9274: 24.0.50; doc string of `normal-top-level-add-subdirs-to-load-path'
Date: Tue, 9 Aug 2011 15:25:34 -0700

The doc string should say `default-directory', not "current directory".
The latter is confusing because imprecise - it should almost never be
used.  The former lets users use `C-h v' to find out exactly which
directory is meant.
 

FWIW - Sheesh, what a horrible function name!  Should have been called
something like `add-subdirs-to-load-path'.  Or, if you're worried about
calling out which subdirs in the name, `add-normal-subdirs-to-load-path'
or some such.  (But "normal" is not a great choice for naming the
subdirs in question, in any case.)  But "normal-top-level" means nothing
here.
 
In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-08-08 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt'
This bug report was last modified 13 years and 362 days ago.

Previous Next

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