From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 16 May 2025 12:02:58 +0000 (+0300)
Subject: ; Improve documentation of the -L command-line option
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a5873f73f268c508ee0e45e2608e1e586b63a63e;p=emacs.git

; 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 7b74c42288e..7f3116c2929 100644
--- 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}