GNU bug report logs - #30552
27.0.50; Incorrect link to Early Init File node and Early Init File clarification

Previous Next

Package: emacs;

Reported by: Kaushal Modi <kaushal.modi <at> gmail.com>

Date: Tue, 20 Feb 2018 17:48:02 UTC

Severity: minor

Found in version 27.0.50

Done: Stefan Kangas <stefan <at> marxist.se>

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 30552 in the body.
You can then email your comments to 30552 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to radon.neon <at> gmail.com, bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Tue, 20 Feb 2018 17:48:02 GMT) Full text and rfc822 format available.

Acknowledgement sent to Kaushal Modi <kaushal.modi <at> gmail.com>:
New bug report received and forwarded. Copy sent to radon.neon <at> gmail.com, bug-gnu-emacs <at> gnu.org. (Tue, 20 Feb 2018 17:48:02 GMT) Full text and rfc822 format available.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Kaushal Modi <kaushal.modi <at> gmail.com>
To: "bug-gnu-emacs <at> gnu.org" <bug-gnu-emacs <at> gnu.org>
Subject: 27.0.50; Incorrect link to Early Init File node and Early Init File
 clarification
Date: Tue, 20 Feb 2018 17:47:32 +0000
[Message part 1 (text/plain, inline)]
X-Debbugs-CC: radon.neon <at> gmail.com

Hello,

I was following the changes for the early init file in the emacs manual,
and I across:

> After a package is installed, it is automatically made available by
Emacs in all subsequent sessions.  This happens at startup, before
processing the init file but after processing the early init file (*note
(elisp)Early Init File::).  As an exception, Emacs does not make
packages available at startup if invoked with the ‘-q’ or
‘--no-init-file’ options (*note Initial Options::).

   To keep Emacs from automatically making packages available at
startup, change the variable ‘package-enable-at-startup’ to ‘nil’.  You
must do this in the early init file (*note (elisp)Early Init File::), as

in (emacs) Package Installation

It looks like the (elisp)Early Init File node does not exist.. navigating
there gives:

user-error: No such node or anchor: ‘Early Init File’

But there *is* a (emacs) Early Init File node.

So, may be just needs /(elisp)/(emacs)/ ?


Here's a related request:

In (emacs) Early Init File, it says:

> However, it is sometimes desirable to
have customizations that take effect during Emacs startup earlier than
the normal init file is processed.  Such customizations can be put in
the early init file, ‘~/.emacs.d/early-init.el’.

It's not clear what those customizations are.. can you put a definitive
list of customizations that if one does *have* to now be in early-init.el?

For example, now package-user-dir *has* to be in early-init.el, but that
variable is not mentioned in that node.

If a list of variables cannot be listed in there for the sake of
maintenance.. there should be some way for a user to figure out if a
variable *needs to be* in early-init.el or *can be* in init.el.

Example:

- package-user-dir has to be in early-init.el
- But having package-archives in init.el is fine.

Why so? The answer to that Why needs to go in the Early Init File node.

Thanks.


In GNU Emacs 27.0.50 (build 2, x86_64-pc-linux-gnu, GTK+ Version 2.24.23)
 of 2018-02-19
Repository revision: 071a0a571243f9498e0e58e5fe938a7b892a22db
Windowing system distributor 'The X.Org Foundation', version 11.0.60900000
System Description: Red Hat Enterprise Linux Workstation release 6.6
(Santiago)
-- 

Kaushal Modi
[Message part 2 (text/html, inline)]

Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Tue, 20 Feb 2018 19:29:02 GMT) Full text and rfc822 format available.

Message #8 received at 30552 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Kaushal Modi <kaushal.modi <at> gmail.com>
Cc: 30552 <at> debbugs.gnu.org, radon.neon <at> gmail.com
Subject: Re: bug#30552: 27.0.50;
 Incorrect link to Early Init File node and Early Init File
 clarification
Date: Tue, 20 Feb 2018 21:28:12 +0200
> From: Kaushal Modi <kaushal.modi <at> gmail.com>
> Date: Tue, 20 Feb 2018 17:47:32 +0000
> Cc: radon.neon <at> gmail.com
> 
>    To keep Emacs from automatically making packages available at
> startup, change the variable ‘package-enable-at-startup’ to ‘nil’.  You
> must do this in the early init file (*note (elisp)Early Init File::), as
> 
> in (emacs) Package Installation
> 
> It looks like the (elisp)Early Init File node does not exist.. navigating there gives:
> 
> user-error: No such node or anchor: ‘Early Init File’

Fixed, thanks.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Tue, 20 Feb 2018 20:40:02 GMT) Full text and rfc822 format available.

Message #11 received at 30552 <at> debbugs.gnu.org (full text, mbox):

From: Radon Rosborough <radon.neon <at> gmail.com>
To: Kaushal Modi <kaushal.modi <at> gmail.com>
Cc: 30552 <at> debbugs.gnu.org
Subject: Re: bug#30552: 27.0.50; Incorrect link to Early Init File node and
 Early Init File clarification
Date: Tue, 20 Feb 2018 12:38:34 -0800
[Message part 1 (text/plain, inline)]
> there should be some way for a user to figure out if a variable
> *needs to be* in early-init.el or *can be* in init.el.

The set of variables which need to be set in early-init.el is exactly
the same as the set of variables which need to be set before
`package-initialize' is run, and hasn't changed as a result of this
patch. I do agree that adding explicit documentation of these
variables would be a good thing, though.
[Message part 2 (text/html, inline)]

Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Wed, 21 Feb 2018 16:14:01 GMT) Full text and rfc822 format available.

Message #14 received at 30552 <at> debbugs.gnu.org (full text, mbox):

From: Kaushal Modi <kaushal.modi <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 30552 <at> debbugs.gnu.org, radon.neon <at> gmail.com
Subject: Re: bug#30552: 27.0.50; Incorrect link to Early Init File node and
 Early Init File clarification
Date: Wed, 21 Feb 2018 16:13:24 +0000
[Message part 1 (text/plain, inline)]
On Tue, Feb 20, 2018 at 2:28 PM Eli Zaretskii <eliz <at> gnu.org> wrote:

> Fixed, thanks.
>

Hi Eli,

That doesn't seem to have fixed this. I believe the fix is this?:

diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi
index 6c7493790d..b4398a553f 100644
--- a/doc/emacs/package.texi
+++ b/doc/emacs/package.texi
@@ -252,7 +252,7 @@ Package Installation
   After a package is installed, it is automatically made available by
 Emacs in all subsequent sessions.  This happens at startup, before
 processing the init file but after processing the early init file
-(@pxref{Early Init File,,, elisp, The Emacs Lisp Reference Manual}).
+(@pxref{Early Init File,,, emacs, The Emacs Manual}).
 As an exception, Emacs does not make packages available at startup if
 invoked with the @samp{-q} or @samp{--no-init-file} options
 (@pxref{Initial Options}).
@@ -261,7 +261,7 @@ Package Installation
   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 (@pxref{Early
-Init File,,, elisp, The Emacs Lisp Reference Manual}), as the variable
+Init File,,, emacs, The Emacs Manual}), as the variable
 is read before loading the regular init file.  Currently this variable
 cannot be set via Customize.


-- 

Kaushal Modi
[Message part 2 (text/html, inline)]

Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Wed, 21 Feb 2018 16:18:02 GMT) Full text and rfc822 format available.

Message #17 received at 30552 <at> debbugs.gnu.org (full text, mbox):

From: Kaushal Modi <kaushal.modi <at> gmail.com>
To: Radon Rosborough <radon.neon <at> gmail.com>
Cc: 30552 <at> debbugs.gnu.org
Subject: Re: bug#30552: 27.0.50; Incorrect link to Early Init File node and
 Early Init File clarification
Date: Wed, 21 Feb 2018 16:16:53 +0000
[Message part 1 (text/plain, inline)]
On Tue, Feb 20, 2018 at 3:39 PM Radon Rosborough <radon.neon <at> gmail.com>
wrote:

>
> The set of variables which need to be set in early-init.el is exactly
> the same as the set of variables which need to be set before
> `package-initialize' is run, and hasn't changed as a result of this
> patch.
>

Thanks, that makes sense.


> I do agree that adding explicit documentation of these
> variables would be a good thing, though.
>

Do you still want to add few examples in the Early Init File node?
Something that says along the lines of:

"Variables that need to be set before calling package-initialize, like
package-user-dir, package-enable-at-startup should now be customized inside
this Early Init file. Variables that can be set post package-initialize,
like package-archives can be set in default Emacs Init file."
-- 

Kaushal Modi
[Message part 2 (text/html, inline)]

Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Wed, 21 Feb 2018 18:13:01 GMT) Full text and rfc822 format available.

Message #20 received at 30552 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Kaushal Modi <kaushal.modi <at> gmail.com>
Cc: 30552 <at> debbugs.gnu.org, radon.neon <at> gmail.com
Subject: Re: bug#30552: 27.0.50; Incorrect link to Early Init File node and
 Early Init File clarification
Date: Wed, 21 Feb 2018 20:12:13 +0200
> From: Kaushal Modi <kaushal.modi <at> gmail.com>
> Date: Wed, 21 Feb 2018 16:13:24 +0000
> Cc: 30552 <at> debbugs.gnu.org, radon.neon <at> gmail.com
> 
> On Tue, Feb 20, 2018 at 2:28 PM Eli Zaretskii <eliz <at> gnu.org> wrote:
> 
>  Fixed, thanks.
> 
> Hi Eli,
> 
> That doesn't seem to have fixed this.

Ah, yes.  I fixed another instance of the same problem.

> I believe the fix is this?:

Almost: there's no need to use the 5- argument @xref for references to
the same manual, and the second of these 2 @xref's is redundant.

Thanks.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Wed, 21 Feb 2018 21:03:02 GMT) Full text and rfc822 format available.

Message #23 received at 30552 <at> debbugs.gnu.org (full text, mbox):

From: Radon Rosborough <radon.neon <at> gmail.com>
To: Kaushal Modi <kaushal.modi <at> gmail.com>
Cc: 30552 <at> debbugs.gnu.org
Subject: Re: bug#30552: 27.0.50; Incorrect link to Early Init File node and
 Early Init File clarification
Date: Wed, 21 Feb 2018 13:01:16 -0800
> Do you still want to add few examples in the Early Init File node?

I have no objection. I will get to it at some point, or someone else
can do it first.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Sat, 28 Sep 2019 22:14:01 GMT) Full text and rfc822 format available.

Message #26 received at 30552 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefan <at> marxist.se>
To: Radon Rosborough <radon.neon <at> gmail.com>
Cc: 30552 <at> debbugs.gnu.org, Kaushal Modi <kaushal.modi <at> gmail.com>
Subject: Re: bug#30552: 27.0.50; Incorrect link to Early Init File node and
 Early Init File clarification
Date: Sun, 29 Sep 2019 00:13:16 +0200
Radon Rosborough <radon.neon <at> gmail.com> writes:

>> Do you still want to add few examples in the Early Init File node?
>
> I have no objection. I will get to it at some point, or someone else
> can do it first.

Did you ever get around to doing this?

Best regards,
Stefan Kangas




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Sun, 29 Sep 2019 15:40:01 GMT) Full text and rfc822 format available.

Message #29 received at 30552 <at> debbugs.gnu.org (full text, mbox):

From: Radon Rosborough <radon.neon <at> gmail.com>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: 30552 <at> debbugs.gnu.org, Kaushal Modi <kaushal.modi <at> gmail.com>
Subject: Re: bug#30552: 27.0.50; Incorrect link to Early Init File node and
 Early Init File clarification
Date: Sun, 29 Sep 2019 08:39:03 -0700
[Message part 1 (text/plain, inline)]
I did not, sorry, and don't see it happening in the foreseeable future
given my current workload.

On Sat, Sep 28, 2019 at 3:13 PM Stefan Kangas <stefan <at> marxist.se> wrote:

> Radon Rosborough <radon.neon <at> gmail.com> writes:
>
> >> Do you still want to add few examples in the Early Init File node?
> >
> > I have no objection. I will get to it at some point, or someone else
> > can do it first.
>
> Did you ever get around to doing this?
>
> Best regards,
> Stefan Kangas
>
[Message part 2 (text/html, inline)]

Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Sun, 29 Sep 2019 16:01:02 GMT) Full text and rfc822 format available.

Message #32 received at 30552 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefan <at> marxist.se>
To: Radon Rosborough <radon.neon <at> gmail.com>
Cc: 30552 <at> debbugs.gnu.org, Kaushal Modi <kaushal.modi <at> gmail.com>
Subject: Re: bug#30552: 27.0.50; Incorrect link to Early Init File node and
 Early Init File clarification
Date: Sun, 29 Sep 2019 17:59:49 +0200
Radon Rosborough <radon.neon <at> gmail.com> writes:

> I did not, sorry, and don't see it happening in the foreseeable future given my current workload.

I see that this text has changed a bit since this was last discussed.
Is the current text good, or is there still something missing?  It
explains which variables should be put in the early init file.

-----

49.4.6 The Early Init File
--------------------------

Most customizations for Emacs should be put in the normal init file.
*Note Init File::.  However, it is sometimes desirable to have
customizations that take effect during Emacs startup earlier than the
normal init file is processed.  Such customizations can be put in the
early init file, ‘~/.config/emacs.d/early-init.el’ or
‘~/.emacs.d/early-init.el’.  This file is loaded before the package
system and GUI is initialized, so in it you can customize variables that
affect frame appearance as well as the package initialization process,
such as ‘package-enable-at-startup’, ‘package-load-list’, and
‘package-user-dir’.  Note that variables like ‘package-archives’ which
only affect the installation of new packages, and not the process of
making already-installed packages available, may be customized in the
regular init file.  *Note Package Installation::.

   We do not recommend that you move into ‘early-init.el’ customizations
that can be left in the normal init files.  That is because the early
init file is read before the GUI is initialized, so customizations
related to GUI features will not work reliably in ‘early-init.el’.  By
contrast, the normal init files are read after the GUI is initialized.
If you must have customizations in the early init file that rely on GUI
features, make them run off hooks provided by the Emacs startup, such as
‘window-setup-hook’ or ‘tty-setup-hook’.  *Note Hooks::.

   For more information on the early init file, *note (elisp)Init
File::.

-----

Thanks in advance.

Best regards,
Stefan Kangas




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#30552; Package emacs. (Sun, 29 Sep 2019 16:03:02 GMT) Full text and rfc822 format available.

Message #35 received at 30552 <at> debbugs.gnu.org (full text, mbox):

From: Radon Rosborough <radon.neon <at> gmail.com>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: 30552 <at> debbugs.gnu.org, Kaushal Modi <kaushal.modi <at> gmail.com>
Subject: Re: bug#30552: 27.0.50; Incorrect link to Early Init File node and
 Early Init File clarification
Date: Sun, 29 Sep 2019 09:02:07 -0700
[Message part 1 (text/plain, inline)]
It seems not unreasonable to me.

On Sun, Sep 29, 2019 at 9:00 AM Stefan Kangas <stefan <at> marxist.se> wrote:

> Radon Rosborough <radon.neon <at> gmail.com> writes:
>
> > I did not, sorry, and don't see it happening in the foreseeable future
> given my current workload.
>
> I see that this text has changed a bit since this was last discussed.
> Is the current text good, or is there still something missing?  It
> explains which variables should be put in the early init file.
>
> -----
>
> 49.4.6 The Early Init File
> --------------------------
>
> Most customizations for Emacs should be put in the normal init file.
> *Note Init File::.  However, it is sometimes desirable to have
> customizations that take effect during Emacs startup earlier than the
> normal init file is processed.  Such customizations can be put in the
> early init file, ‘~/.config/emacs.d/early-init.el’ or
> ‘~/.emacs.d/early-init.el’.  This file is loaded before the package
> system and GUI is initialized, so in it you can customize variables that
> affect frame appearance as well as the package initialization process,
> such as ‘package-enable-at-startup’, ‘package-load-list’, and
> ‘package-user-dir’.  Note that variables like ‘package-archives’ which
> only affect the installation of new packages, and not the process of
> making already-installed packages available, may be customized in the
> regular init file.  *Note Package Installation::.
>
>    We do not recommend that you move into ‘early-init.el’ customizations
> that can be left in the normal init files.  That is because the early
> init file is read before the GUI is initialized, so customizations
> related to GUI features will not work reliably in ‘early-init.el’.  By
> contrast, the normal init files are read after the GUI is initialized.
> If you must have customizations in the early init file that rely on GUI
> features, make them run off hooks provided by the Emacs startup, such as
> ‘window-setup-hook’ or ‘tty-setup-hook’.  *Note Hooks::.
>
>    For more information on the early init file, *note (elisp)Init
> File::.
>
> -----
>
> Thanks in advance.
>
> Best regards,
> Stefan Kangas
>
[Message part 2 (text/html, inline)]

Reply sent to Stefan Kangas <stefan <at> marxist.se>:
You have taken responsibility. (Sun, 29 Sep 2019 16:16:02 GMT) Full text and rfc822 format available.

Notification sent to Kaushal Modi <kaushal.modi <at> gmail.com>:
bug acknowledged by developer. (Sun, 29 Sep 2019 16:16:02 GMT) Full text and rfc822 format available.

Message #40 received at 30552-done <at> debbugs.gnu.org (full text, mbox):

From: Stefan Kangas <stefan <at> marxist.se>
To: Radon Rosborough <radon.neon <at> gmail.com>
Cc: 30552-done <at> debbugs.gnu.org, Kaushal Modi <kaushal.modi <at> gmail.com>
Subject: Re: bug#30552: 27.0.50; Incorrect link to Early Init File node and
 Early Init File clarification
Date: Sun, 29 Sep 2019 18:15:24 +0200
Radon Rosborough <radon.neon <at> gmail.com> writes:

> It seems not unreasonable to me.

Thanks.  I'm going to assume that the current text is satisfactory and
close this bug.  If anyone feels that there is more to do here, please
reopen this bug and explain what is still missing.

Best regards,
Stefan Kangas




bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Mon, 28 Oct 2019 11:24:12 GMT) Full text and rfc822 format available.

This bug report was last modified 4 years and 153 days ago.

Previous Next


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