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

[Gavin Smith]

On Thu, Aug 21, 2014 at 11:05 PM, Vincent Belaïche
<address@hidden> wrote:
>
>   *References to the node* should all use that name, with no leading or
>   trailing spaces a single internal space.
>
> I understand the term "References to the node" as anything that can be a
> node reference that is to say:
>
> * Up/Previous/Next pointers in the node line
> * @ref{...} and suchlikes
> * menu entry
>
> The first item in this list concern the node line, but the two other
> not: this is just for these two other items that I am saying that this
> node is not only about node line.
>
> But maybe I am simply just not understanding correctly what "References
> to the node" means.

I think the Texinfo manual should specify that menu entries should use
the normalized node names, as this is what Info in Emacs expects (see
other discussion at
http://debbugs.gnu.org/cgi/bugreport.cgi?bug=18308#1). The passage you
mention in "Node Line Requirements" is not correct for
cross-references in the generated Info file at least. Maybe it should
say something like the spaces are normalized to give the "official"
node name, and whether extra whitespace is ignored or not allowed can
be described elsewhere for each case.