bug#72961: closed (Possible documentation improvement: Clarification for package installation)

[GNU bug Tracking System]

Your message dated Thu, 05 Sep 2024 09:24:54 +0300
with message-id <86plpi4nyh.fsf@gnu.org>
and subject line Re: bug#72961: Possible documentation improvement: 
Clarification for package installation
has caused the debbugs.gnu.org bug report #72961,
regarding Possible documentation improvement: Clarification for package 
installation
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs@gnu.org.)


-- 
72961: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=72961
GNU Bug Tracking System
Contact help-debbugs@gnu.org with problems

--- Begin Message --- Subject: Possible documentation improvement: Clarification for package installation Date: Mon, 2 Sep 2024 12:41:11 +0200

Hello,

I was reading the section on "Libraries of Lisp Code for Emacs" (section 28.8) in the Emacs manual, and I encountered a passage that seems a bit unclear. The text suggests that when using package-install, Emacs might automatically add initialization code to the init.el file, which doesn’t seem to match my experience.

Specifically, the manual states: "Installing a package using package-install takes care of placing the package’s Lisp files in a directory where Emacs will find it, and also writes the necessary initialization code into your init files [...]"

From my understanding, package-install does not modify init.el directly, which is how I interpret the documentation above. Instead, Emacs calls package-initialize which makes the installed packages available, automatically.

I want to check if this is a valid concern / interpretation that warrants a documentation change. If so, I'll be happy to create a patch.

Looking forward to your thoughts.

Krystian

--- End Message ---

> --- Begin Message ---
>
>
>
> Subject: 
>
> Re: bug#72961: Possible documentation improvement: Clarification for package installation
>
>
>
>
> Date: 
>
> Thu, 05 Sep 2024 09:24:54 +0300
>
>
>
>
> > From: Philip Kaludercic <philipk@posteo.net>
> > Cc: Krystian Samp <samp.krystian@gmail.com>,  72961@debbugs.gnu.org
> > Date: Mon, 02 Sep 2024 18:49:40 +0000
> > 
> > I believe the documentation here is just outdated.  From NEWS.27:
> > 
> >   ** Installed packages are now activated *before* loading the init file.
> >   As a result of this change, it is no longer necessary to call
> >   'package-initialize' in your init file.
> > 
> >   Previously, a call to 'package-initialize' was automatically inserted
> >   into the init file when Emacs was started.  This call can now safely
> >   be removed.
> > 
> > Otherwise it might also refer to the fact that user option
> > `package-selected-packages' is saved, which by default will be stored in
> > the default Emacs configuration file. 
>
> Thanks, I've updated the text accordingly on the emacs-30 release
> branch, and I'm therefore closing this bug.
>
>
> --- End Message ---