[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.
- bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec, Van L, 2018/05/23
- bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec, Eli Zaretskii, 2018/05/23
- bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec, Van L, 2018/05/23
- bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec, Eli Zaretskii, 2018/05/24
- bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec, Van L, 2018/05/24
- bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec,
Eli Zaretskii <=
- bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec, Van L, 2018/05/26
bug#31576: emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec, Van L, 2018/05/23