From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#49424: 27.2; Misdocumented default initialisation file Date: Wed, 07 Jul 2021 22:27:41 +0300 Message-ID: <83tul5exg2.fsf@gnu.org> References: <87bl7fscid.fsf@gnus.org> <87zguybhzw.fsf@gmail.com> <995892f5-e466-ada6-a64a-e1199d4e33a6@froglet.home.mavit.org.uk> <831r8aezu6.fsf@gnu.org> <05beaaf-113c-1260-e58-a4736396a765@froglet.home.mavit.org.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="15603"; mail-complaints-to="usenet@ciao.gmane.io" Cc: larsi@gnus.org, 49424@debbugs.gnu.org, rpluim@gmail.com To: Peter Oliver Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Jul 07 21:29:03 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1m1DEE-0003pY-JZ for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 07 Jul 2021 21:29:02 +0200 Original-Received: from localhost ([::1]:54344 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1m1DED-0006NG-LL for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 07 Jul 2021 15:29:01 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43878) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1m1DDG-0005Gt-FQ for bug-gnu-emacs@gnu.org; Wed, 07 Jul 2021 15:28:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:41995) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1m1DDG-0006nK-7N for bug-gnu-emacs@gnu.org; Wed, 07 Jul 2021 15:28:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1m1DDG-0002CO-11 for bug-gnu-emacs@gnu.org; Wed, 07 Jul 2021 15:28:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 07 Jul 2021 19:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 49424 X-GNU-PR-Package: emacs Original-Received: via spool by 49424-submit@debbugs.gnu.org id=B49424.16256860588393 (code B ref 49424); Wed, 07 Jul 2021 19:28:01 +0000 Original-Received: (at 49424) by debbugs.gnu.org; 7 Jul 2021 19:27:38 +0000 Original-Received: from localhost ([127.0.0.1]:53541 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m1DCs-0002BH-F1 for submit@debbugs.gnu.org; Wed, 07 Jul 2021 15:27:38 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:45986) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m1DCp-0002At-TY for 49424@debbugs.gnu.org; Wed, 07 Jul 2021 15:27:36 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:43098) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1m1DCk-0006gZ-Ho; Wed, 07 Jul 2021 15:27:30 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:2131 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1m1DCk-0005HA-6V; Wed, 07 Jul 2021 15:27:30 -0400 In-Reply-To: <05beaaf-113c-1260-e58-a4736396a765@froglet.home.mavit.org.uk> (message from Peter Oliver on Wed, 7 Jul 2021 20:08:20 +0100 (BST)) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:209623 Archived-At: > Date: Wed, 7 Jul 2021 20:08:20 +0100 (BST) > From: Peter Oliver > cc: rpluim@gmail.com, larsi@gnus.org, 49424@debbugs.gnu.org > > >> 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. > > > > Thanks, but this is still inaccurate. Can we please change the > > documentation so that it tells the whole story? > > What do we think is wrong or missing? In the context of the rest of that page, I admit it looks okay to me. Then I don't think I understand the change at all. This sentence explains that the rest of the documentation doesn't mention the logic of finding the init file under its various names, instead using just one possible name. You changed that one name without changing the rest of the documentation -- what does that achieve? Stepping back a notch, the original report was: 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. How can a simplifying convention in a manual be "inaccurate"? And what does that convention have to do with the order and logic of how Emacs actually looks for the init file? What am I missing here?