GNU bug report logs - #72961
Possible documentation improvement: Clarification for package installation

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#72961: closed (Possible documentation improvement:
 Clarification for package installation)
Date: Thu, 05 Sep 2024 06:30:02 +0000

[Message part 1 (text/plain, inline)]

Your message dated Thu, 05 Sep 2024 09:24:54 +0300
with message-id <86plpi4nyh.fsf <at> 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 <at> gnu.org.)


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

[Message part 2 (message/rfc822, inline)]

From: Krystian Samp <samp.krystian <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Subject: Possible documentation improvement: Clarification for package
 installation
Date: Mon, 2 Sep 2024 12:41:11 +0200

[Message part 3 (text/plain, inline)]

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

[Message part 4 (text/html, inline)]

[Message part 5 (message/rfc822, inline)]

From: Eli Zaretskii <eliz <at> gnu.org>
To: Philip Kaludercic <philipk <at> posteo.net>
Cc: samp.krystian <at> gmail.com, 72961-done <at> debbugs.gnu.org
Subject: Re: bug#72961: Possible documentation improvement: Clarification
 for package installation
Date: Thu, 05 Sep 2024 09:24:54 +0300

> From: Philip Kaludercic <philipk <at> posteo.net>
> Cc: Krystian Samp <samp.krystian <at> gmail.com>,  72961 <at> 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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.