(Info-directory-list): Doc fix.

2 files changed, 15 insertions, 5 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 0f5d20ecb40..d422cb057ae 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2000-09-02  Eli Zaretskii  <eliz@is.elta.co.il>
+
+        * info.el (Info-directory-list): Doc fix.
+
 2000-08-31  Peter Breton  <pbreton@ne.mediaone.net>
 
         * filecache.el (file-cache-add-directory-using-find): Don't quote 
diff --git a/lisp/info.el b/lisp/info.el
index eb71449e6c4..cd9f86384bb 100644
--- a/lisp/info.el
+++ b/lisp/info.el
@@ -88,13 +88,19 @@ The Lisp code is executed when the node is selected.")
 nil means not yet initialized.  In this case, Info uses the environment
 variable INFOPATH to initialize it, or `Info-default-directory-list'
 if there is no INFOPATH variable in the environment.
-The last element of `Info-default-directory-list' is the directory
-where Emacs installs the Info files that come with it.
+
+When `Info-directory-list' is initialized from the value of
+`Info-default-directory-list', the first element of the resulting
+list is the directory where Emacs installs the Info files that
+come with it.  This is so that Emacs's own manual, which suits the
+version of Emacs you are using, will always be found first.  (If
+you want to override that, set INFOPATH in the environment.)
 
 If you run the Emacs executable from the `src' directory in the Emacs
-source tree, the `info' directory in the source tree is used as the last
-element, in place of the installation Info directory.  This is useful
-when you run a version of Emacs without installing it.")
+source tree, and INFOPATH is not defined, the `info' directory in the
+source tree is used as the first element of `Info-directory-list', in
+place of the installation Info directory.  This is useful when you run
+a version of Emacs without installing it.")
 
 (defcustom Info-additional-directory-list nil
   "List of additional directories to search for Info documentation files.