GNU bug report logs - #31576
emacs-lisp-intro.texi - NAME, TITLE inconsistency among @node, @unnumberedsec

Previous Next

Full log

Message #26 received at 31576 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Van L <van <at> scratch.space>
Cc: 31576 <at> debbugs.gnu.org
Subject: Re: 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 <at> scratch.space>
> Date: Thu, 24 May 2018 21:51:59 +1000
> Cc: 31576 <at> 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.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.