Subject: Re: bug#49424: 27.2; Misdocumented default initialisation file

From: Peter Oliver <[email-masked]>
Date: Wed, 7 Jul 2021 19:12:03 +0100 (BST)

On Wed, 7 Jul 2021, Robert Pluim wrote:

>    > Peter Oliver <[email-masked]> writes:
>    >> The info page “49.4.4 How Emacs Finds Your Init File” says:
>    >>
>    >>> For brevity the rest of the Emacs documentation generally uses just
>    >>> the current default location ‘~/.emacs.d/init.el’ for the init file.
>    >>
>    >> However, this seems to be inaccurate: if I start Emacs as a new user
>    >> and make a customisation, that customisation is written to ~/.emacs.
>
> Yes, we should change that to say '~/.emacs'

Here’s a patch to do that.

-- 
Peter Oliver

From e0a95ea7a048c505820829d8e10f0addf2cc6c4a Mon Sep 17 00:00:00 2001
From: Peter Oliver <[email-masked]>
Date: Wed, 7 Jul 2021 19:09:58 +0100
Subject: [PATCH] Document init file with the highest precedence as ~/.emacs

* doc/emacs/custom.texi: Default location of init file is ~/.emacs
(bug#49424).
---
 doc/emacs/custom.texi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index de5d825248..708349e833 100644
--- a/doc/emacs/custom.texi
+++ b/doc/emacs/custom.texi
@@ -2713,7 +2713,7 @@ Find Init
 name in the system's data base of users.
 
   For brevity the rest of the Emacs documentation generally uses just
-the current default location @file{~/.emacs.d/init.el} for the
+the current default location @file{~/.emacs} for the
 init file.
 @c  LocalWords:  backtab
 
-- 
2.31.1