From cdb4948056e0715e688e09378fed48888f6e36b8 Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Thu, 11 Jan 1996 17:05:41 +0000 Subject: [PATCH] Describe version-specific site-lisp dirs. Capitalize Lisp. --- INSTALL | 36 +++++++++++++++++++++--------------- 1 file changed, 21 insertions(+), 15 deletions(-) diff --git a/INSTALL b/INSTALL index 0e151bb4059..2a009f8db7d 100644 --- a/INSTALL +++ b/INSTALL @@ -182,16 +182,22 @@ are installed in the following directories: `/usr/local/share/emacs/VERSION/lisp' holds the Emacs Lisp library; `VERSION' stands for the number of the Emacs version you are installing, like `18.59' or `19.27'. Since the - lisp library changes from one version of Emacs to + Lisp library changes from one version of Emacs to another, including the version number in the path allows you to have several versions of Emacs installed - at the same time; this means that you don't have to - make Emacs unavailable while installing a new - version. + at the same time; in particular, you don't have to + make Emacs unavailable while installing a new version. - Emacs searches for its lisp files in - `/usr/local/share/emacs/site-lisp', then in this - directory. +`/usr/local/share/emacs/VERSION/site-lisp' holds the local Emacs Lisp + files installed for Emacs version VERSION only. + +`/usr/local/share/emacs/site-lisp' holds the local Emacs Lisp + files installed for all Emacs versions. + + When Emacs is installed, it searches for its Lisp files + in `/usr/local/share/emacs/VERSION/site-lisp', then in + `/usr/local/share/emacs/site-lisp', and finally in + `/usr/local/share/emacs/VERSION/lisp'. `/usr/local/share/emacs/VERSION/etc' holds the Emacs tutorial, the DOC file, the `yow' database, and other @@ -228,7 +234,7 @@ are installed in the following directories: If these directories are not what you want, you can specify where to install Emacs's libraries and data files or where Emacs should search -for its lisp files by giving values for `make' variables as part of +for its Lisp files by giving values for `make' variables as part of the command. See the section below called `MAKE VARIABLES' for more information on this. @@ -268,7 +274,7 @@ Here is a complete list of the variables you may want to set. read-only data files that Emacs refers to while it runs; it defaults to /usr/local/share. We create the following subdirectories under `datadir': - - `emacs/VERSION/lisp', containing the Emacs lisp library, and + - `emacs/VERSION/lisp', containing the Emacs Lisp library, and - `emacs/VERSION/etc', containing the Emacs tutorial, the DOC file, and the `yow' database. `VERSION' is the number of the Emacs version you are installing, @@ -339,20 +345,20 @@ Here is a complete list of the variables you may want to set. The above variables serve analogous purposes in the makefiles for all GNU software; here are some variables specific to Emacs. -`lispdir' indicates where Emacs installs and expects its lisp library. +`lispdir' indicates where Emacs installs and expects its Lisp library. Its default value, based on `datadir' (see above), is `/usr/local/share/emacs/VERSION/lisp' (where `VERSION' is as described above). -`locallisppath' indicates where Emacs should search for lisp files +`locallisppath' indicates where Emacs should search for Lisp files specific to your site. It should be a colon-separated list of directories; Emacs checks them in order before checking - `lispdir'. Its default value, based on `datadir' (see above), - is `/usr/local/share/emacs/site-lisp'. + `lispdir'. Its default value, based on `datadir' (see above), is + `/usr/local/share/emacs/VERSION/site-lisp:/usr/local/share/emacs/site-lisp'. `lisppath' is the complete list of directories Emacs should search for - its lisp files; its default value is the concatenation of - `lispdir' and `locallisppath'. It should be a colon-separated + its Lisp files; its default value is the concatenation of + `locallisppath' and `lispdir'. It should be a colon-separated list of directories; Emacs checks them in the order they appear. -- 2.39.2