summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRichard M. Stallman <rms@gnu.org>1996-07-23 15:50:08 +0000
committerRichard M. Stallman <rms@gnu.org>1996-07-23 15:50:08 +0000
commit2b78ab95054bb8d710669ff5302eaef88e7cf3e0 (patch)
tree6d4d52f8f05eee783cd95685cbcc52e8ec69dd8c
parentd27fb9f471c26e296109f433fa2a58fc006f5366 (diff)
downloademacs-2b78ab95054bb8d710669ff5302eaef88e7cf3e0.tar.gz
Describe the version-specific site-list directory.
-rw-r--r--lispref/loading.texi29
1 files changed, 29 insertions, 0 deletions
diff --git a/lispref/loading.texi b/lispref/loading.texi
index 1e6b5df8229..34d90168ae1 100644
--- a/lispref/loading.texi
+++ b/lispref/loading.texi
@@ -193,6 +193,35 @@ you should bind @code{load-path} locally with @code{let} around the
calls to @code{load}.
@end defopt
+ The default value of @code{load-path}, when running an Emacs which has
+been installed on the system, looks like this:
+
+@smallexample
+("/usr/local/share/emacs/@var{version}/site-lisp"
+ "/usr/local/share/emacs/site-lisp"
+ "/usr/local/share/emacs/@var{version}/lisp")
+@end smallexample
+
+ The last of these three directories is where the Lisp files of Emacs
+itself are installed; the first two are for additional Lisp packages
+installed at your site. The first directory is for locally installed
+packages that belong with a particular Emacs version; the second is for
+locally installed packages that can be used with any installed Emacs
+version.
+
+ There are several reasons why a Lisp package that works well in one
+Emacs version can cause trouble in another. Sometimes packages need
+updating for incompatible changes in Emacs; sometimes they depend on
+undocumented internal Emacs data that can change without notice;
+sometimes a newer Emacs version incorporates a version of the package,
+and should be used only with that version.
+
+ If you run Emacs from the directory where it was built---that is, an
+executable that has not been formally installed---then @code{load-path}
+normally contains two additional directories. These are the @code{lisp}
+and @code{site-lisp} subdirectories of the main build directory. (Both
+are represented as absolute file names.)
+
@defvar load-in-progress
This variable is non-@code{nil} if Emacs is in the process of loading a
file, and it is @code{nil} otherwise.