mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-05-31 01:32:00 -07:00
Code Issues Projects Releases Wiki Activity

doc: Remove long obsolete references to package-initialize

Browse source 
Since Emacs-27, `package-initialize` is for internal use only,
and callers should either call `package-activate-all` instead
(cheaper and faster) or do nothing at all (because the other
functions should trigger the needed initialization automatically
as needed).

* doc/lispref/package.texi (Packaging Basics): Delete `package-initialize`.

* doc/misc/eglot.texi (Reporting bugs): Don't recommend using `package-initialize`.

* doc/misc/org.org (Using Emacs packaging system): Simplify the command
line since both `(require 'package)` and `(package-initialize)` are
redundant here.
This commit is contained in:
Stefan Monnier 2026-05-13 10:34:03 -04:00
parent 9bc04b001a
commit ce3098752c
3 changed files with 2 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

9
doc/lispref/package.texi
View file

@ -133,15 +133,6 @@ init file, and any code that should run after it in the primary init
file (@pxref{Init File,,, emacs, The GNU Emacs Manual}).
@end defun
@deffn Command package-initialize &optional no-activate
This function initializes Emacs's internal record of which packages are
installed, and then calls @code{package-activate-all}.
The optional argument @var{no-activate}, if non-@code{nil}, causes
Emacs to update its record of installed packages without actually
making them available.
@end deffn
@node Simple Packages
@section Simple Packages
@cindex single file package

2
doc/misc/eglot.texi
View file

@ -1969,7 +1969,7 @@ directory is a way to tell the maintainers about ELPA package versions.
@item
Include a recipe to replicate the problem with @emph{a clean Emacs run}.
The invocation @code{emacs -Q -f package-initialize} starts Emacs with
The invocation @code{emacs -Q -f package-activate-all} starts Emacs with
no configuration and initializes the ELPA packages. A very minimal
@file{.emacs} initialization file (10 lines or less) is also acceptable
and good means to describe changes to variables.

2
doc/misc/org.org
View file

@ -125,7 +125,7 @@ To avoid interference with the built-in Org mode, you can use the
command line (you need Emacs 30 or later):
#+begin_src sh
emacs -Q -batch -eval "(progn (require 'package) (package-initialize) (package-refresh-contents) (package-upgrade 'org))"
emacs -Q -batch -eval "(progn (package-refresh-contents) (package-upgrade 'org))"
#+end_src
This approach has the advantage of isolating the upgrade process from