From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec Date: Thu, 24 May 2018 18:33:01 +0300 Message-ID: <83muwpax1u.fsf@gnu.org> References: <83zi0pbwxb.fsf@gnu.org> <0D178B6C-7DD7-48AA-A2C6-504F06EACC8E@scratch.space> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1527175940 13134 195.159.176.226 (24 May 2018 15:32:20 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 24 May 2018 15:32:20 +0000 (UTC) Cc: 31576@debbugs.gnu.org To: Van L Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu May 24 17:32:16 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 1fLsDw-0003Jb-C9 for geb-bug-gnu-emacs@m.gmane.org; Thu, 24 May 2018 17:32:16 +0200 Original-Received: from localhost ([::1]:39229 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fLsG3-0002hy-6K for geb-bug-gnu-emacs@m.gmane.org; Thu, 24 May 2018 11:34:27 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49445) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fLsFk-0002eT-R8 for bug-gnu-emacs@gnu.org; Thu, 24 May 2018 11:34:14 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fLsFf-0005w2-A1 for bug-gnu-emacs@gnu.org; Thu, 24 May 2018 11:34:08 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:38743) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fLsFf-0005vw-5c for bug-gnu-emacs@gnu.org; Thu, 24 May 2018 11:34:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fLsFd-0002Ke-Vk for bug-gnu-emacs@gnu.org; Thu, 24 May 2018 11:34: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: Thu, 24 May 2018 15:34:01 +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.15271759838895 (code B ref 31576); Thu, 24 May 2018 15:34:01 +0000 Original-Received: (at 31576) by debbugs.gnu.org; 24 May 2018 15:33:03 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 In-reply-to: (message from Van L on Thu, 24 May 2018 21:51:59 +1000) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:146482 Archived-At: > 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.