bug-texinfo
[Top][All Lists]
Advanced

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

Re: [bug #43042] Texinfo manual typo and improvement in info node 'Node


From: Vincent Belaïche
Subject: Re: [bug #43042] Texinfo manual typo and improvement in info node 'Node Line Requirements'
Date: Sat, 04 Oct 2014 23:20:39 +0200
User-agent: Thunderbird 2.0.0.24 (Windows/20100228)

Thank you, I think that this closes the issue as for the manual.

However I think that texi2any does not make any warning if you use multiple spaces within a node name in a menu entry. There should both be this warning and a produced info file with those multiple spaces corrected to a single space when in the menu entry.

  Vincent.

Gavin Smith a écrit :
On Thu, Aug 21, 2014 at 6:22 PM, Vincent Belaïche
<address@hidden> wrote:
= Clarifying _References_ =

Furthermore, what _References_ means it a bit ambiguous. I understand that it
means references in the texinfo manual source code, and that it is one of the
following:

* a @ref, @xref, or @pxref
* a menu entry

= Making a separate item =

Finally, the stance about space handling, is in the same item as case
sensititivity. I think it would improve the manual if a separate item.


Hello Vincent,

There's been no further talk about this so I've commited the following change:

Modified: trunk/doc/texinfo.texi
===================================================================
--- trunk/doc/texinfo.texi      2014-10-03 09:28:43 UTC (rev 5855)
+++ trunk/doc/texinfo.texi      2014-10-03 09:47:52 UTC (rev 5856)
@@ -5227,6 +5227,7 @@

 @cindex White space in node name
 @cindex Spaces in node name
address@hidden
 Spaces before and after names on the @samp{@@node} line are ignored.
 Multiple whitespace characters ``inside'' a name are collapsed to a
 single space.  For example:
@@ -5238,9 +5239,10 @@
 @@node  foo  bar ,
 @end example

address@hidden all define the same node, namely @samp{foo bar}.  References
-to the node should all use that name, with no leading or trailing
-spaces, and a single internal space.
address@hidden all define the same node, namely @samp{foo bar}.  In contexts
+where the exact node name is required (for example, in a menu entry),
+this is the name that that should be used, i.e.@: with no leading or
+trailing spaces, and a single internal space.
 @end itemize





reply via email to

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