[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: |
Gavin Smith |
Subject: |
Re: [bug #43042] Texinfo manual typo and improvement in info node 'Node Line Requirements' |
Date: |
Fri, 3 Oct 2014 10:52:10 +0100 |
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
- Re: [bug #43042] Texinfo manual typo and improvement in info node 'Node Line Requirements',
Gavin Smith <=