; Improve documentation of the -L command-line option

* doc/emacs/cmdargs.texi (Action Arguments): Mention that '-L' is
in effect only after the init files are loaded.

(cherry picked from commit 18e1aabbeaa284ef86a1d77de434dd2acde418c3)

diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi
index 7b74c42288ead0c8d46384b0a22ee7b6c032b6ee..7f3116c2929a75f717f8e1e45ee57d94eac86d90 100644 (file)
--- a/doc/emacs/cmdargs.texi
+++ b/doc/emacs/cmdargs.texi
@@ -146,6 +146,13 @@ appends (rather than prepends) the remainder to @code{load-path}.
 (On MS Windows, use @samp{;} instead of @samp{:}; i.e., use
 the value of @code{path-separator}.)
 
+Note that the changes to @code{load-path} as result of using this option
+do @emph{not} affect the directories where Emacs looks for the site
+startup file and the Lisp packages loaded by the user's early-init and
+init files (@pxref{Init File}), because @code{load-path} is changed by
+the @samp{-L} option @emph{after} these files are loaded and
+interpreted.
+
 @item -f @var{function}
 @opindex -f
 @itemx --funcall=@var{function}