From: Eli Zaretskii <eliz@gnu.org>
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=92ca881dc83617a53fb057bcb9e91877cc848f9a;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
<james.yoo@gmail.com> 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