From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Van L Newsgroups: gmane.emacs.bugs Subject: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec Date: Sat, 26 May 2018 14:32:31 +1000 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> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1527309067 12592 195.159.176.226 (26 May 2018 04:31:07 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 26 May 2018 04:31:07 +0000 (UTC) Cc: 31576@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat May 26 06:31:03 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fMQr8-00037X-4A for geb-bug-gnu-emacs@m.gmane.org; Sat, 26 May 2018 06:31:02 +0200 Original-Received: from localhost ([::1]:47663 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fMQtD-0005kr-PX for geb-bug-gnu-emacs@m.gmane.org; Sat, 26 May 2018 00:33:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56791) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fMQt7-0005ka-RH for bug-gnu-emacs@gnu.org; Sat, 26 May 2018 00:33:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fMQt4-0004J6-O8 for bug-gnu-emacs@gnu.org; Sat, 26 May 2018 00:33:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:41015) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fMQt4-0004Iu-Ke for bug-gnu-emacs@gnu.org; Sat, 26 May 2018 00:33:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fMQt4-0000Xj-8Z for bug-gnu-emacs@gnu.org; Sat, 26 May 2018 00:33:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Van L Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 26 May 2018 04:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31576 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 31576-submit@debbugs.gnu.org id=B31576.15273091612060 (code B ref 31576); Sat, 26 May 2018 04:33:02 +0000 Original-Received: (at 31576) by debbugs.gnu.org; 26 May 2018 04:32:41 +0000 Original-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 Original-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 Original-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) In-Reply-To: <83muwpax1u.fsf@gnu.org> X-Mailer: Apple Mail (2.3124) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:146561 Archived-At: > 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