[Emacs-diffs] emacs/doc/emacs ChangeLog building.texi

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      09/06/04 03:06:17

Modified files:
        doc/emacs      : ChangeLog building.texi 

Log message:
        * building.texi (Lisp Libraries): Add example of changing
        load-path (Bug#3446).

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/ChangeLog?cvsroot=emacs&r1=1.324&r2=1.325
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/building.texi?cvsroot=emacs&r1=1.19&r2=1.20

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/ChangeLog,v
retrieving revision 1.324
retrieving revision 1.325
diff -u -b -r1.324 -r1.325
--- ChangeLog   28 May 2009 20:36:03 -0000      1.324
+++ ChangeLog   4 Jun 2009 03:06:17 -0000       1.325
@@ -1,3 +1,8 @@
+2009-06-04  Chong Yidong  <address@hidden>
+
+       * building.texi (Lisp Libraries): Add example of changing
+       load-path (Bug#3446).
+
 2009-05-28  Chong Yidong  <address@hidden>
 
        * mark.texi (Mark): Further clarifications.

Index: building.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/building.texi,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -b -r1.19 -r1.20
--- building.texi       28 Apr 2009 18:59:18 -0000      1.19
+++ building.texi       4 Jun 2009 03:06:17 -0000       1.20
@@ -1251,16 +1251,23 @@
 recompile it until they think it is ready to use.
 
 @vindex load-path
-  The sequence of directories searched by @kbd{M-x load-library} is
-specified by the variable @code{load-path}, a list of strings that are
-directory names.  The default value of the list contains the directories where
+  The variable @code{load-path} specifies the sequence of directories
+searched by @kbd{M-x load-library}.  Its value should be a list of
+strings that are directory names, or @code{nil} for the current
+default directory.  (Generally, it is not a good idea to put
address@hidden in the list; if you find yourself wishing that @code{nil}
+were in the list, most likely what you really want is to do @kbd{M-x
+load-file} this once.)
+
+  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
-your own, put them in a single directory and add that directory
-to @code{load-path}.  @code{nil} in this list stands for the current default
-directory, but it is probably not a good idea to put @code{nil} in the
-list.  If you find yourself wishing that @code{nil} were in the list,
-most likely what you really want to do is use @kbd{M-x load-file}
-this once.
+your own, put them in a single directory and add that directory to
address@hidden, by adding a line like this to your init file
+(@pxref{Init File}):
+
address@hidden
+(add-to-list 'load-path "/path/to/lisp/libraries")
address@hidden example
 
 @cindex autoload
   Often you do not have to give any command to load a library, because