From 92ca881dc83617a53fb057bcb9e91877cc848f9a Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Tue, 13 Feb 2018 07:59:26 +0200 Subject: [PATCH] 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. --- doc/emacs/building.texi | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) 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 -- 2.39.2