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

[Alan Mackenzie <acm@muc.de>]

Hi, Robert!

On Mon, 12 Dec 2005, Robert J. Chassell wrote:

>   ... We've had a node called "Sample .emacs File" in the CC Mode
>   manual since 22nd February 1995 ...

>And possibly Info searched for that node as "Sample" ...  That is the
>only node in that manual that starts with the word "Sample".

>The Texinfo manual has included a warning about the characters that a
>node name may contain since at least 1987 and probably earlier.  I don't
>remember dot specifically, but I do remember thinking that the rule was
>to use characters that are not in regexps.

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.

>In any event, the customary solution is to name the node and the title
>differently.  As is said in  (texinfo)Node Line Tips , `try to pick node
>names that are informative but short'.  The node name might be `Sample'
>and the chapter or section title `Sample @code{.emacs} File'.

OK, thanks.

>    Robert J. Chassell                         

-- 
Alan Mackenzie (Munich, Germany)