bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node


From: Eli Zaretskii
Subject: bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec
Date: Thu, 24 May 2018 18:33:01 +0300

> From: Van L <van@scratch.space>
> 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.





reply via email to

[Prev in Thread] Current Thread [Next in Thread]