changeset 103315:e40e0e5e2eda

* building.texi (Lisp Libraries): Add example of changing load-path (Bug#3446).
author Chong Yidong <cyd@stupidchicken.com>
date Thu, 04 Jun 2009 03:06:17 +0000
parents f85882b5408c
children 73c56f47ad80
files doc/emacs/ChangeLog doc/emacs/building.texi
diffstat 2 files changed, 21 insertions(+), 9 deletions(-) [+]
line wrap: on
line diff
--- a/doc/emacs/ChangeLog	Thu Jun 04 02:45:14 2009 +0000
+++ b/doc/emacs/ChangeLog	Thu Jun 04 03:06:17 2009 +0000
@@ -1,3 +1,8 @@
+2009-06-04  Chong Yidong  <cyd@stupidchicken.com>
+
+	* building.texi (Lisp Libraries): Add example of changing
+	load-path (Bug#3446).
+
 2009-05-28  Chong Yidong  <cyd@stupidchicken.com>
 
 	* mark.texi (Mark): Further clarifications.
--- a/doc/emacs/building.texi	Thu Jun 04 02:45:14 2009 +0000
+++ b/doc/emacs/building.texi	Thu Jun 04 03:06:17 2009 +0000
@@ -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
+@code{nil} 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
+@code{load-path}, by adding a line like this to your init file
+(@pxref{Init File}):
+
+@example
+(add-to-list 'load-path "/path/to/lisp/libraries")
+@end example
 
 @cindex autoload
   Often you do not have to give any command to load a library, because