Describe version-specific site-lisp dirs.

Capitalize Lisp.

1 files 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.