From unknown Tue Jun 17 20:15:39 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#31576 <31576@debbugs.gnu.org> To: bug#31576 <31576@debbugs.gnu.org> Subject: Status: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec Reply-To: bug#31576 <31576@debbugs.gnu.org> Date: Wed, 18 Jun 2025 03:15:39 +0000 retitle 31576 emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node= , @unnumberedsec reassign 31576 emacs submitter 31576 Van L severity 31576 wishlist tag 31576 wontfix thanks From debbugs-submit-bounces@debbugs.gnu.org Wed May 23 20:42:15 2018 Received: (at submit) by debbugs.gnu.org; 24 May 2018 00:42:15 +0000 Received: from localhost ([127.0.0.1]:45792 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLeKd-0002vB-3x for submit@debbugs.gnu.org; Wed, 23 May 2018 20:42:15 -0400 Received: from eggs.gnu.org ([208.118.235.92]:59205) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLeKa-0002uw-Vv for submit@debbugs.gnu.org; Wed, 23 May 2018 20:42:13 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fLeKV-0000Rp-6c for submit@debbugs.gnu.org; Wed, 23 May 2018 20:42:07 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:41906) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fLeKV-0000Rf-3m for submit@debbugs.gnu.org; Wed, 23 May 2018 20:42:07 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:50172) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fLeKU-0004sQ-5j for bug-gnu-emacs@gnu.org; Wed, 23 May 2018 20:42:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fLeKR-0000PI-2x for bug-gnu-emacs@gnu.org; Wed, 23 May 2018 20:42:06 -0400 Received: from relay4-d.mail.gandi.net ([217.70.183.196]:38411) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fLeKQ-0000Np-Sj for bug-gnu-emacs@gnu.org; Wed, 23 May 2018 20:42:03 -0400 X-Originating-IP: 123.243.244.176 Received: from epi.local (123-243-244-176.tpgi.com.au [123.243.244.176]) (Authenticated sender: van@scratch.space) by relay4-d.mail.gandi.net (Postfix) with ESMTPSA id D0947E0003 for ; Thu, 24 May 2018 02:42:00 +0200 (CEST) From: Van L Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Subject: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec Message-Id: Date: Thu, 24 May 2018 10:41:55 +1000 To: bug-gnu-emacs@gnu.org Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\)) X-Mailer: Apple Mail (2.3124) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.3 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.3 (-----) Hello. IMO, having `@node NAME' consistent with `@unnumberedsec TITLE' is = better in an intro. #+BEGIN_EXAMPLE 8cda6f8f (Glenn Morris 2007-09-06 1057) @ifnottex d6adf7e7 (Glenn Morris 2012-05-28 1058) @node Numbers = Lists 8cda6f8f (Glenn Morris 2007-09-06 1059) = @unnumberedsubsec Numbers, Lists inside of Lists 8cda6f8f (Glenn Morris 2007-09-06 1060) @end ifnottex 8cda6f8f (Glenn Morris 2007-09-06 6759) @ifnottex d6adf7e7 (Glenn Morris 2012-05-28 6760) @node Strange = Names 8cda6f8f (Glenn Morris 2007-09-06 6761) @unnumberedsec = Strange Names 8cda6f8f (Glenn Morris 2007-09-06 6762) @end ifnottex #+END_EXAMPLE From debbugs-submit-bounces@debbugs.gnu.org Wed May 23 22:38:09 2018 Received: (at 31576) by debbugs.gnu.org; 24 May 2018 02:38:09 +0000 Received: from localhost ([127.0.0.1]:45832 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLg8n-0005VP-Fs for submit@debbugs.gnu.org; Wed, 23 May 2018 22:38:09 -0400 Received: from eggs.gnu.org ([208.118.235.92]:56804) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLg8l-0005VD-UD for 31576@debbugs.gnu.org; Wed, 23 May 2018 22:38:08 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fLg8d-0004FQ-Iy for 31576@debbugs.gnu.org; Wed, 23 May 2018 22:38:02 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:54688) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fLg8d-0004FL-FL; Wed, 23 May 2018 22:37:59 -0400 Received: from [176.228.60.248] (port=3257 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fLg8c-0005pb-Lp; Wed, 23 May 2018 22:37:59 -0400 Date: Thu, 24 May 2018 05:38:08 +0300 Message-Id: <83zi0pbwxb.fsf@gnu.org> From: Eli Zaretskii To: Van L In-reply-to: (message from Van L on Thu, 24 May 2018 10:41:55 +1000) Subject: Re: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec References: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 31576 Cc: 31576@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) > From: Van L > Date: Thu, 24 May 2018 10:41:55 +1000 > > Hello. > > IMO, having `@node NAME' consistent with `@unnumberedsec TITLE' is better in an intro. I'm not sure I understand why. This is an introduction to Emacs Lisp, not to Texinfo. All our manuals use different names for nodes and for corresponding chapters/sections, primarily because the node name is just a label, and also because some characters should not appear ion a node name. I see no problem here. From debbugs-submit-bounces@debbugs.gnu.org Wed May 23 22:47:22 2018 Received: (at 31576) by debbugs.gnu.org; 24 May 2018 02:47:22 +0000 Received: from localhost ([127.0.0.1]:45837 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLgHg-0005i8-BO for submit@debbugs.gnu.org; Wed, 23 May 2018 22:47:22 -0400 Received: from relay12.mail.gandi.net ([217.70.178.232]:46063) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLgHe-0005i0-Tp for 31576@debbugs.gnu.org; Wed, 23 May 2018 22:47:19 -0400 Received: from epi.local (123-243-244-176.tpgi.com.au [123.243.244.176]) (Authenticated sender: van@scratch.space) by relay12.mail.gandi.net (Postfix) with ESMTPSA id 3EA7D200006; Thu, 24 May 2018 04:47:15 +0200 (CEST) Content-Type: text/plain; charset=utf-8 Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\)) Subject: Re: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec From: Van L In-Reply-To: <83zi0pbwxb.fsf@gnu.org> Date: Thu, 24 May 2018 12:47:10 +1000 Content-Transfer-Encoding: quoted-printable Message-Id: <0D178B6C-7DD7-48AA-A2C6-504F06EACC8E@scratch.space> References: <83zi0pbwxb.fsf@gnu.org> To: Eli Zaretskii X-Mailer: Apple Mail (2.3124) X-Spam-Level: X-Spam-Score: -1.8 (-) X-Debbugs-Envelope-To: 31576 Cc: 31576@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.8 (--) > Eli Zaretskii writes: >=20 > I see no problem here. I don=E2=80=99t want to nitpick, just registering what looks out of = place with fresh eyes. I=E2=80=99m not looking at how the label fits the = context, if either both adequately capture the context I see no problem = either. From debbugs-submit-bounces@debbugs.gnu.org Wed May 23 23:33:43 2018 Received: (at 31576) by debbugs.gnu.org; 24 May 2018 03:33:43 +0000 Received: from localhost ([127.0.0.1]:45859 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLh0Z-0000GT-Jn for submit@debbugs.gnu.org; Wed, 23 May 2018 23:33:43 -0400 Received: from relay4-d.mail.gandi.net ([217.70.183.196]:57269) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLh0X-0000GL-GG for 31576@debbugs.gnu.org; Wed, 23 May 2018 23:33:41 -0400 X-Originating-IP: 123.243.244.176 Received: from epi.local (123-243-244-176.tpgi.com.au [123.243.244.176]) (Authenticated sender: van@scratch.space) by relay4-d.mail.gandi.net (Postfix) with ESMTPSA id 12E7DE0002; Thu, 24 May 2018 05:33:40 +0200 (CEST) Content-Type: text/plain; charset=utf-8 Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\)) Subject: Re: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec From: Van L In-Reply-To: <83zi0pbwxb.fsf@gnu.org> Date: Thu, 24 May 2018 13:33:34 +1000 Content-Transfer-Encoding: quoted-printable Message-Id: <08A6E187-0BA0-475D-AC0E-7C8F67DFA01B@scratch.space> References: <83zi0pbwxb.fsf@gnu.org> To: Eli Zaretskii X-Mailer: Apple Mail (2.3124) X-Spam-Level: X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 31576 Cc: 31576@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) > Eli Zaretskii writes: >=20 > I'm not sure I understand why. This is an introduction to Emacs Lisp, > not to Texinfo. To my understanding, the texi file is the source and the other files are = facets in the presentation. A person may switch between reading the = infopage and pdf. Jotting down on paper `numbers, lists in lists=E2=80=99 = from reading the pdf then later on resuming on the infopage will look = different as `numbers lists=E2=80=99.= From debbugs-submit-bounces@debbugs.gnu.org Thu May 24 00:30:13 2018 Received: (at 31576) by debbugs.gnu.org; 24 May 2018 04:30:13 +0000 Received: from localhost ([127.0.0.1]:45868 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLhtE-0001X2-Rs for submit@debbugs.gnu.org; Thu, 24 May 2018 00:30:13 -0400 Received: from eggs.gnu.org ([208.118.235.92]:49802) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLhtC-0001Vy-81 for 31576@debbugs.gnu.org; Thu, 24 May 2018 00:30:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fLht6-0001PR-BD for 31576@debbugs.gnu.org; Thu, 24 May 2018 00:30:05 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:56502) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fLht1-0001N3-IZ; Thu, 24 May 2018 00:29:59 -0400 Received: from [176.12.212.47] (port=33661 helo=[10.212.117.208]) by fencepost.gnu.org with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1fLht0-0007p6-PP; Thu, 24 May 2018 00:29:59 -0400 Date: Thu, 24 May 2018 07:29:55 +0300 User-Agent: K-9 Mail for Android In-Reply-To: <08A6E187-0BA0-475D-AC0E-7C8F67DFA01B@scratch.space> References: <83zi0pbwxb.fsf@gnu.org> <08A6E187-0BA0-475D-AC0E-7C8F67DFA01B@scratch.space> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Subject: Re: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec To: Van L From: Eli Zaretskii Message-ID: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 31576 Cc: 31576@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) On May 24, 2018 6:33:34 AM GMT+03:00, Van L wrote: >=20 > > Eli Zaretskii writes: > >=20 > > I'm not sure I understand why=2E This is an introduction to Emacs > Lisp, > > not to Texinfo=2E >=20 > To my understanding, the texi file is the source and the other files > are facets in the presentation=2E A person may switch between reading > the infopage and pdf=2E Jotting down on paper `numbers, lists in lists= =E2=80=99 > from reading the pdf then later on resuming on the infopage will look > different as `numbers lists=E2=80=99=2E The chapter and section names are shown in the Info format as well=2E So I still don't think I see the problem=2E Besides, renaming all the nod= es and sections is a huge job, and a waste if done unnesessarily=2E From debbugs-submit-bounces@debbugs.gnu.org Thu May 24 00:35:29 2018 Received: (at 31576) by debbugs.gnu.org; 24 May 2018 04:35:29 +0000 Received: from localhost ([127.0.0.1]:45872 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLhyL-0001fX-Ga for submit@debbugs.gnu.org; Thu, 24 May 2018 00:35:29 -0400 Received: from eggs.gnu.org ([208.118.235.92]:50705) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLhyK-0001fM-9t for 31576@debbugs.gnu.org; Thu, 24 May 2018 00:35:28 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fLhyE-0005PH-Dh for 31576@debbugs.gnu.org; Thu, 24 May 2018 00:35:23 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:56559) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fLhy7-0005FT-7i; Thu, 24 May 2018 00:35:15 -0400 Received: from [176.12.212.47] (port=33613 helo=[10.212.117.208]) by fencepost.gnu.org with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1fLhy6-0003g1-65; Thu, 24 May 2018 00:35:14 -0400 Date: Thu, 24 May 2018 07:35:10 +0300 User-Agent: K-9 Mail for Android In-Reply-To: <0D178B6C-7DD7-48AA-A2C6-504F06EACC8E@scratch.space> References: <83zi0pbwxb.fsf@gnu.org> <0D178B6C-7DD7-48AA-A2C6-504F06EACC8E@scratch.space> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Subject: Re: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec To: Van L From: Eli Zaretskii Message-ID: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 31576 Cc: 31576@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) On May 24, 2018 5:47:10 AM GMT+03:00, Van L wrote: >=20 > > Eli Zaretskii writes: > >=20 > > I see no problem here=2E >=20 > I don=E2=80=99t want to nitpick, just registering what looks out of plac= e with > fresh eyes=2E I=E2=80=99m not looking at how the label fits the context,= if > either both adequately capture the context I see no problem either=2E You don't need to apologize for reporting something that looks strange to you, but please also accept the responses, even if you aren't entirely convinced=2E There's a lot of history, conventions, and other good reasons behind what we do, so not everything you find surprising at first sight is nesessarily a real problem=2E Thanks=2E From debbugs-submit-bounces@debbugs.gnu.org Thu May 24 07:52:11 2018 Received: (at 31576) by debbugs.gnu.org; 24 May 2018 11:52:11 +0000 Received: from localhost ([127.0.0.1]:46045 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLomx-0005bv-7U for submit@debbugs.gnu.org; Thu, 24 May 2018 07:52:11 -0400 Received: from relay7-d.mail.gandi.net ([217.70.183.200]:38085) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLoms-0005bl-Uz for 31576@debbugs.gnu.org; Thu, 24 May 2018 07:52:09 -0400 X-Originating-IP: 123.243.244.176 Received: from epi.local (123-243-244-176.tpgi.com.au [123.243.244.176]) (Authenticated sender: van@scratch.space) by relay7-d.mail.gandi.net (Postfix) with ESMTPSA id 4F3F72000F; Thu, 24 May 2018 13:52:09 +0200 (CEST) Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\)) Subject: Re: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec From: Van L In-Reply-To: Date: Thu, 24 May 2018 21:51:59 +1000 Content-Transfer-Encoding: quoted-printable Message-Id: References: <83zi0pbwxb.fsf@gnu.org> <0D178B6C-7DD7-48AA-A2C6-504F06EACC8E@scratch.space> To: Eli Zaretskii X-Mailer: Apple Mail (2.3124) X-Spam-Level: X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 31576 Cc: 31576@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) > Eli Zaretskii writes: >=20 > You don't need to apologize for reporting something that looks > strange to you, but please also accept the responses, even if you > aren't entirely convinced. There's a lot of history Thanks for your help. I agree with you. Looking at : d6adf7e7 (Glenn Morris 2012-05-28 1206) @node Typing = Lists : 8cda6f8f (Glenn Morris 2007-09-06 1207) @subsection GNU = Emacs Helps You Type Lists it makes sense why the node name is short, presentation-wise in the = infopage.=20 A comment saying this is justified at the first instance will help = future readers in the texi file.= From debbugs-submit-bounces@debbugs.gnu.org Thu May 24 11:33:03 2018 Received: (at 31576) by debbugs.gnu.org; 24 May 2018 15:33:03 +0000 Received: from localhost ([127.0.0.1]:46640 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLsEh-0002JP-Gb for submit@debbugs.gnu.org; Thu, 24 May 2018 11:33:03 -0400 Received: from eggs.gnu.org ([208.118.235.92]:58026) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fLsEg-0002Iv-1X for 31576@debbugs.gnu.org; Thu, 24 May 2018 11:33:02 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fLsEW-0005TU-1e for 31576@debbugs.gnu.org; Thu, 24 May 2018 11:32:56 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:36882) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fLsEV-0005TM-UK; Thu, 24 May 2018 11:32:51 -0400 Received: from [176.228.60.248] (port=3882 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fLsEV-0003BE-AQ; Thu, 24 May 2018 11:32:51 -0400 Date: Thu, 24 May 2018 18:33:01 +0300 Message-Id: <83muwpax1u.fsf@gnu.org> From: Eli Zaretskii To: Van L In-reply-to: (message from Van L on Thu, 24 May 2018 21:51:59 +1000) Subject: Re: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec References: <83zi0pbwxb.fsf@gnu.org> <0D178B6C-7DD7-48AA-A2C6-504F06EACC8E@scratch.space> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 31576 Cc: 31576@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) > From: Van L > Date: Thu, 24 May 2018 21:51:59 +1000 > Cc: 31576@debbugs.gnu.org > > : d6adf7e7 (Glenn Morris 2012-05-28 1206) @node Typing Lists > : 8cda6f8f (Glenn Morris 2007-09-06 1207) @subsection GNU Emacs Helps You Type Lists > > it makes sense why the node name is short, presentation-wise in the infopage. Yes, that's one of the aspects of a good Texinfo usage. > A comment saying this is justified at the first instance will help future readers in the texi file. I don't think this manual is a place to document that. How to choose good node names is explained in the Texinfo manual, see the node "Node Names" there. This manual should (as any other manual, IMO) assume the typical reader reads it either in Info/HTML, or in PDF, or as a book. the Texinfo source is not the medium whose appearance we should judge wrt these aspects. From debbugs-submit-bounces@debbugs.gnu.org Sat May 26 00:32:41 2018 Received: (at 31576) by debbugs.gnu.org; 26 May 2018 04:32:41 +0000 Received: from localhost ([127.0.0.1]:48912 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fMQsi-0000X9-Ca for submit@debbugs.gnu.org; Sat, 26 May 2018 00:32:41 -0400 Received: from relay11.mail.gandi.net ([217.70.178.231]:33151) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fMQsg-0000Wz-KX for 31576@debbugs.gnu.org; Sat, 26 May 2018 00:32:39 -0400 Received: from epi.local (123-243-244-176.tpgi.com.au [123.243.244.176]) (Authenticated sender: van@scratch.space) by relay11.mail.gandi.net (Postfix) with ESMTPSA id 4B308100009; Sat, 26 May 2018 06:32:35 +0200 (CEST) Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\)) Subject: Re: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec From: Van L In-Reply-To: <83muwpax1u.fsf@gnu.org> Date: Sat, 26 May 2018 14:32:31 +1000 Content-Transfer-Encoding: quoted-printable Message-Id: <9D16C302-4D1B-40B7-B0D0-150D547F312B@scratch.space> References: <83zi0pbwxb.fsf@gnu.org> <0D178B6C-7DD7-48AA-A2C6-504F06EACC8E@scratch.space> <83muwpax1u.fsf@gnu.org> To: Eli Zaretskii X-Mailer: Apple Mail (2.3124) X-Spam-Level: X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 31576 Cc: 31576@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) > Eli Zaretskii writes: >=20 >> it makes sense why the node name is short, presentation-wise in the = infopage.=20 >=20 > Yes, that's one of the aspects of a good Texinfo usage. >=20 >> A comment saying this is justified at the first instance will help = future readers in the texi file. >=20 > I don't think this manual is a place to document that. How to choose > good node names is explained in the Texinfo manual, see the node "Node > Names" there. >=20 diff --git a/doc/lispintro/emacs-lisp-intro.texi = b/doc/lispintro/emacs-lisp-intro.texi index b79432e..43a8e55 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi @@ -1054,6 +1054,13 @@ Lisp Lists * Typing Lists:: How GNU Emacs helps you type lists. @end menu =20 +@ignore +The `node name' and `section title' vary. This is common. The node +name is shorter for presentation on Info page only. Further down are +nodes for `typing lists' and `strange names' for comparison. How to +choose good node names is explained in the Texinfo manual, see the +node "Node Names" there. +@end ignore @ifnottex @node Numbers Lists @unnumberedsubsec Numbers, Lists inside of Lists From debbugs-submit-bounces@debbugs.gnu.org Sun Oct 06 00:34:08 2019 Received: (at 31576) by debbugs.gnu.org; 6 Oct 2019 04:34:08 +0000 Received: from localhost ([127.0.0.1]:45438 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iGyFE-0001EC-Hu for submit@debbugs.gnu.org; Sun, 06 Oct 2019 00:34:08 -0400 Received: from mail-pf1-f195.google.com ([209.85.210.195]:33325) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iGyFC-0001Dj-GG for 31576@debbugs.gnu.org; Sun, 06 Oct 2019 00:34:07 -0400 Received: by mail-pf1-f195.google.com with SMTP id q10so6403874pfl.0 for <31576@debbugs.gnu.org>; Sat, 05 Oct 2019 21:34:06 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to:cc; bh=FeKNE5Lv3ZYYQh8rvT6XjZKoYnOclvWz8IIA5wNd6ko=; b=L7JvH8xz3mXZ2dwlLWz9h3c9HerxbNa9lTx1aQxUWT/EZIUTHno3h7rJXkJuSEEh8A 8WCOZSNwb+0vADobu+zZsS4MLq9qwFKRcphXirMU1VqBzBouYxoYgN3OLHe+8uLYnFNR u9rdhNIidGWZeKHkQj9Bx/NAurpK4P3BzZdjogqBL5DeVugtMCReog/jvY0qQ8q1yE3c dHKkRLkKFUSgc6UVaSdnTKoOepoZJGwXqI8eWF/NMn1RkgDA4FdgvFdsSbRXi/Z+fq7K Vh+COj5bnSXuYjAchodfcXDfRYnG8GMKXVvXEahv1VrKv6NyrISLLYgTea2H6C7KPEpS IBtw== X-Gm-Message-State: APjAAAXWLSIe7/wJe9QpDeFUZP5a52dXqwtx1+Y39ISgfNPzjaOJn7Jt MqqiapoH544UTNDAQlGFricH+/cjCh+KT5IsB/f4OV3c X-Google-Smtp-Source: APXvYqw7MX7oq6LbheObMZYyrbMXxPKuwpRd2/vcxYFTXmaeyI7KxqusojAIZdfkfa1PlI0viKPwAXomQGAm5Qd+/dA= X-Received: by 2002:a17:90a:cc08:: with SMTP id b8mr26083766pju.119.1570336440481; Sat, 05 Oct 2019 21:34:00 -0700 (PDT) MIME-Version: 1.0 From: Stefan Kangas Date: Sun, 6 Oct 2019 06:33:49 +0200 Message-ID: Subject: Re: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec To: Eli Zaretskii Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.3 (/) X-Debbugs-Envelope-To: 31576 Cc: Van L , 31576@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) tags 31576 + wontfix close 31576 quit Eli Zaretskii writes: >> From: Van L >> Date: Thu, 24 May 2018 10:41:55 +1000 >> >> Hello. >> >> IMO, having `@node NAME' consistent with `@unnumberedsec TITLE' is better in an intro. > > I'm not sure I understand why. This is an introduction to Emacs Lisp, > not to Texinfo. All our manuals use different names for nodes and for > corresponding chapters/sections, primarily because the node name is > just a label, and also because some characters should not appear ion a > node name. > > I see no problem here. Having read the discussion, and in the interest of not keeping bug reports open that we will not want to work on, I'm closing this as wontfix. If anyone thinks that's the wrong thing to do, feel free reopen the bug report. Best regards, Stefan Kangas From unknown Tue Jun 17 20:15:39 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 03 Nov 2019 12:24:09 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator