Re: Info bug with @xref{Sample .emacs File, , , ccmode, the CC Mode Manual}.

[Eli Zaretskii <eliz@gnu.org>]

> Date: Mon, 12 Dec 2005 09:32:55 +0000 (GMT)
> From: Alan Mackenzie <acm@muc.de>
> Cc: emacs-devel@gnu.org
> 
> OK.  The warning in that manual is somewhat inconspicuous.  On the page
> "node" we have:
> 
>       To create a node, write an `@node' command at the beginning of a
>     line, and follow it with up to four arguments, separated by commas, on
>     the rest of the same line.
> 
> , with no mention of colons, parens or periods.  In the sub-node
> "Choosing Node and Pointer Names", there is no mention of the
> restriction.  Only in (the relatively obscurely named) "Node Line
> Requirements" is this restriction mentioned.  This seems suboptimal.

Did you try index search (the `i' command)?  There are at least two
index entries that should have helped you find this text in a blink:
"Period in nodename" and "Node names, invalid characters in".  Index
search is The Right Way of finding something in an Info manual quickly
and efficiently.

That said, if you think this information should be referenced from
less obscure places, please submit a bug report to the Texinfo
bug-reporting mailing list.