From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#49424: 27.2; Misdocumented default initialisation file Date: Sun, 24 Oct 2021 01:12:49 -0700 Message-ID: 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> <83tul5exg2.fsf@gnu.org> <79b0205e-b8c5-d11c-5b78-812c352d755@froglet.home.mavit.org.uk> <83h7h5e334.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="11226"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: larsi@gnus.org, Peter Oliver , 49424@debbugs.gnu.org, rpluim@gmail.com To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Oct 24 10:13:12 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 1meYcx-0002kx-Gt for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 24 Oct 2021 10:13:11 +0200 Original-Received: from localhost ([::1]:56974 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1meYcv-00041C-Gf for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 24 Oct 2021 04:13:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37946) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1meYco-00040n-DL for bug-gnu-emacs@gnu.org; Sun, 24 Oct 2021 04:13:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54559) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1meYco-0003WO-5n for bug-gnu-emacs@gnu.org; Sun, 24 Oct 2021 04:13:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1meYcn-0004O1-Ul for bug-gnu-emacs@gnu.org; Sun, 24 Oct 2021 04:13:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 24 Oct 2021 08:13: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.163506318016854 (code B ref 49424); Sun, 24 Oct 2021 08:13:01 +0000 Original-Received: (at 49424) by debbugs.gnu.org; 24 Oct 2021 08:13:00 +0000 Original-Received: from localhost ([127.0.0.1]:37872 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meYcm-0004Nm-8e for submit@debbugs.gnu.org; Sun, 24 Oct 2021 04:13:00 -0400 Original-Received: from mail-pl1-f180.google.com ([209.85.214.180]:34725) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meYci-0004NU-5X for 49424@debbugs.gnu.org; Sun, 24 Oct 2021 04:12:59 -0400 Original-Received: by mail-pl1-f180.google.com with SMTP id r5so1201169pls.1 for <49424@debbugs.gnu.org>; Sun, 24 Oct 2021 01:12:56 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:in-reply-to:references:user-agent :mime-version:date:message-id:subject:to:cc :content-transfer-encoding; bh=d9L1XzgSmTIBBwFT+NtIU0o8HEMdXyKkNkv7AlCKo6I=; b=sgrtcnChoPAECdvpQBsIh7nwZlhaPTXBlCig2/ywDl8pITt/Q5g2ViI9RH3DpcCOMW 6lvcoXOe0QuWV0W0GYUTpQuFUR0mLylRS/cm1/ZsPtH5Q+xgLQ4nsE5Y/OjOpRLQBy88 j4fKNVE7IYYnNDgKeeSr6iTZUMzeWYF+Zl+noSWPKW/Uwtl+IU/qDq6CcrbMKy1tzlE7 nl1vDshsTAtqOTTRzF+9ejoepzUyEIo7eoXBBFkzuDdSPgIs35MrJfL1zqo27aWL9xih nXDif5k6xi2d/HlrXLMgoeV2cIfxHdU/WPermj2rQgmLMmDn031lQFyU2eamt8QITbHI yt1Q== X-Gm-Message-State: AOAM532ewOHK77sxJl/0Tje58Fax78YXs/YudaJFHbjL9XfgQlbmQtTJ GKGLiW7X7cQwYPNChEaCwMsspBLvOXlwh0wl4fs= X-Google-Smtp-Source: ABdhPJy+4vgdxiv3adScx4mm6ruB8P/rSWJOl4lLiymIgJKGVX2t7WUw0kqS5FP3oq4uEYjAf594j8NDbas4gkpF1Bw= X-Received: by 2002:a17:902:b691:b029:12d:2b6:d116 with SMTP id c17-20020a170902b691b029012d02b6d116mr9347890pls.71.1635063170455; Sun, 24 Oct 2021 01:12:50 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 24 Oct 2021 01:12:49 -0700 In-Reply-To: <83h7h5e334.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 08 Jul 2021 09:23:27 +0300") 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:218077 Archived-At: Eli Zaretskii writes: >> I understand the sentence to be making two assertions: >> >> 1. Throughout the documentation, =E2=80=9C~/.emacs.d/init.el=E2=80=9D wi= ll be used as a >> shorthand for =E2=80=9Cthe initialisation file=E2=80=9D, whatever filena= me that happens to >> have. >> 2. The default location of the initialisation file is =E2=80=9C~/.emacs.= d/init.el=E2=80=9D. >> >> Neither is true. > > The 2nd one is not what that sentence says. This is the text under discussion: For brevity the rest of the Emacs documentation generally uses just the current default location =E2=80=98~/.emacs.d/init.el=E2=80=99 for t= he init file. The sentence says: "the current default location =E2=80=98~/.emacs.d/init.e= l=E2=80=99". I can't interpret this in any other way than that this is the default location. This is, as we know, incorrect. > If the 1st one is incorrect, it should be fixed to reflect the truth. The proposed fix here was to change it to say: For brevity the rest of the Emacs documentation generally uses just the current default location =E2=80=98~/.emacs=E2=80=99 for the init fi= le. That is incidentally also the convention we have used historically, and what you will find all over the documentation. However, this is also not entirely correct, as the default will differ depending on the details discussed in `(emacs) Find Init'. So I would suggest this simple change instead: For brevity the rest of the Emacs documentation generally uses just the historical default location =E2=80=98~/.emacs=E2=80=99 for the init= file. As for the rest of this bug report, there is some discussion about: A) Inadequacies in the Info node `(emacs) Find Init'. B) Further changes to how we load the init file. As for A, I think the text is fine as is. As for B, I agree with Eli that we should let the dust settle on the recent changes for a while before doing anything more.