Re: broken links for "next section in reading order"

[Graham Percival]

On Wed, May 26, 2010 at 05:05:08PM +0100, James Lowe wrote:
> Graham,
>
> Graham Percival wrote:
>> Anyway, what does the texinfo manual say about @-commands in node
>> names?  Could you look this up, James?
>
> http://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#Node-Line-Requirements
>
> I think this bit is what you are after:
>
> --snip--
>
> @-commands in node names are not allowed. This includes punctuation  
> characters that are escaped with a address@hidden, such as @ and {, and 
> accent  
> commands such as ‘@'’.

Yeah, that looks familiar.

Now, we _know_ that the texinfo manual isn't always accurate, just
like we know that our own manuals aren't always accurate.  But in
this case, I don't think there's any harm in following it.  Users
never see the @node names; they only see the @section names, which
_do_ allow @commands.

James, could you remove any @ symbols in @node names?  Doing
something like
  grep "@node.*@" Documentation/* -r
would probably be useful.

- this is a very low-priority request
- please check that the docs compile after changing stuff.  This
  is precisely the kind of change that's likely to bork stuff.
- you might prefer to work manual-by-manual (i.e. cd
  Documentation/learning/ ; grep "@node.*@" * ; fix stuff; check
  it; send me patch for the learning dir)
- hmm... let's say **don't** modify any of the translations.

Cheers,
- Graham