From: Eli Zaretskii Date: Tue, 13 Feb 2018 05:59:26 +0000 (+0200) Subject: Minor change in the Emacs manual X-Git-Tag: emacs-26.1-rc1~222 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=92ca881;p=emacs.git Minor change in the Emacs manual * doc/emacs/building.texi (Lisp Libraries): Explain why nil in load-path is not a good idea. Suggested by James Yoo in emacs-manual-bugs@gnu.org. --- diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi index f2819c67c5d..878d2f53d53 100644 --- a/doc/emacs/building.texi +++ b/doc/emacs/building.texi @@ -1410,12 +1410,13 @@ Loading,,, elisp, the Emacs Lisp Reference Manual}. @code{load-path}. Its value should be a list of directories (strings). These directories are searched, in the specified order, by the @kbd{M-x load-library} command, the lower-level @code{load} -function, and other Emacs functions that find Emacs Lisp libraries. A -list entry in @code{load-path} can also have the special value +function, and other Emacs functions that find Emacs Lisp libraries. +An entry in @code{load-path} can also have the special value @code{nil}, which stands for the current default directory, but it is -almost always a bad idea to use this. (If you find yourself wishing -that @code{nil} were in the list, most likely what you really want is -to use @kbd{M-x load-file}.) +almost always a bad idea to use this, because its meaning will depend +on the buffer that is current when @code{load-path} is used by Emacs. +(If you find yourself wishing that @code{nil} were in the list, most +likely what you really want is to use @kbd{M-x load-file}.) The default value of @code{load-path} is a list of directories where the Lisp code for Emacs itself is stored. If you have libraries of