GNU bug report logs - #49424
27.2; Misdocumented default initialisation file

Previous Next

Package: emacs;

Reported by: Peter Oliver <p.d.oliver <at> mavit.org.uk>

Date: Mon, 5 Jul 2021 22:58:02 UTC

Severity: normal

Found in version 27.2

Full log

View this message in rfc822 format

From: Stefan Kangas <stefan <at> marxist.se>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: Eli Zaretskii <eliz <at> gnu.org>, Peter Oliver <p.d.oliver <at> mavit.org.uk>, 49424 <at> debbugs.gnu.org, rpluim <at> gmail.com
Subject: bug#49424: 27.2; Misdocumented default initialisation file
Date: Sun, 24 Oct 2021 07:10:19 -0700

Lars Ingebrigtsen <larsi <at> gnus.org> writes:

>> This is the text under discussion:
>>
>>        For brevity the rest of the Emacs documentation generally uses just
>>     the current default location ‘~/.emacs.d/init.el’ for the init file.
>>
>> The sentence says: "the current default location ‘~/.emacs.d/init.el’".
>> I can't interpret this in any other way than that this is the default
>> location.  This is, as we know, incorrect.
>
> Well, it's the default default location, isn't it?

The default is ".emacs.el", if this text from (info "(emacs) Find Init")
is correct:

     Emacs looks for your init file using the filenames ‘~/.emacs.el’,
     ‘~/.emacs’, or ‘~/.emacs.d/init.el’ in that order; you can choose
     to use any one of these names. [...] Emacs can also look in an
     XDG-compatible location for ‘init.el’, the default is the directory
     ‘~/.config/emacs’.

> But saying "current" here is very odd -- it's probably meant as opposed
> to "historical", but why should the person reading this text care?  Why
> not just say
>
>        For brevity the rest of the Emacs documentation generally uses
>        ‘~/.emacs.d/init.el’ for the init file.

I guess because that's not the convention we actually use.  :-)
We say ".emacs" everywhere.  AFAICT, the only place we even mention
"~/.emacs.d/init.el" in the manual is this node (!).

That's why I proposed to change "current" to "historical", but the word
"traditional" is also good IMO.
This bug report was last modified 3 years and 238 days ago.

Previous Next

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