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)
This commit is contained in:
Eli Zaretskii 2024-04-27 11:52:30 +03:00
parent 53333132e4
commit a7d51085cf
2 changed files with 13 additions and 3 deletions

View file

@ -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

View file

@ -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")