Improve documentation of 'package-enable-at-startup'

* doc/emacs/package.texi (Package Installation): Clarify how to
customize 'package-enable-at-startup'.

* lisp/emacs-lisp/package.el (package-enable-at-startup): Add note
about customization.  (Bug#70402)

(cherry picked from commit a7d51085cf0a6e6d01fa265001d7d6a4bd728ed2)

diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi
index c8f790bab47c34bb9a296873caa4e119e959dba6..fd445805068d72fa6342d2bd3531da50bb488a65 100644 (file)
--- a/doc/emacs/package.texi
+++ b/doc/emacs/package.texi
@@ -490,8 +490,12 @@ startup if invoked with the @samp{-q} or @samp{--no-init-file} options
   To keep Emacs from automatically making packages available at
 startup, change the variable @code{package-enable-at-startup} to
 @code{nil}.  You must do this in the early init file, as the variable
-is read before loading the regular init file.  Currently this variable
-cannot be set via Customize.
+is read before loading the regular init file.  Therefore, if you
+customize this variable via Customize, you should save your customized
+setting into your early init file.  To do this, set or change the value
+of the variable @code{custom-file} (@pxref{Saving Customizations}) to
+point to your early init file before saving the customized value of
+@code{package-enable-at-startup}.
 
 @findex package-quickstart-refresh
 @vindex package-quickstart

diff --git a/lisp/emacs-lisp/package.el b/lisp/emacs-lisp/package.el
index ab1731aeb54703d12619d4770f2ad73d56f2049d..8c915766e1cf911e28fba745ce60aa09de46ddff 100644 (file)
--- a/lisp/emacs-lisp/package.el
+++ b/lisp/emacs-lisp/package.el
@@ -174,7 +174,13 @@ with \"-q\").
 
 Even if the value is nil, you can type \\[package-initialize] to
 make installed packages available at any time, or you can
-call (package-activate-all) in your init-file."
+call (package-activate-all) in your init-file.
+
+Note that this variable must be set to a non-default value in
+your early-init file, as the variable's value is used before
+loading the regular init file.  Therefore, if you customize it
+via Customize, you should save your customized setting into
+your `early-init-file'."
   :type 'boolean
   :version "24.1")