bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: dot in node not accepted in Info in menu entry


From: Patrice Dumas
Subject: Re: dot in node not accepted in Info in menu entry
Date: Wed, 28 Mar 2012 19:50:11 +0200
User-agent: Mutt/1.5.20 (2009-12-10)

On Wed, Mar 28, 2012 at 12:03:49AM -0400, Eli Zaretskii wrote:
> 
> > If this is so, it should certainly be clearer in the manual, either
> > in the part about menus, or at least in the Info format
> > specification part of the manual (I could propose a documentation
> > patch, in case this is the issue).
> 
> This is already documented:
> 
>    * Unfortunately, you cannot use periods, commas, colons or
>      parentheses within a node name; these confuse the Texinfo
>      processors.  Perhaps this limitation will be removed some day, too.

That's not good enough, in my opinion.  For one thing, punctuation signs
do not confuse the Texinfo processors per se, this is rather a limitation 
of the Info language.  In Texinfo you can use anything within a node 
provided you escape them properly (a comma by @comma, other punctuation 
in @asis, for example).  At least it is so with texi2any.

The real issue is with Info, but I think that we can be more precise 
than this list.  For instance, in the node header (the line like

  File: c.info,  Node: Top,  Next: c.  d,  Up: (dir)

the only issue should be a comma.  We can come with something more 
precise, and to overcome those Info language limitations, it is 
useful to know which are intrinsic limitations of the language and 
which are due to the implementation of reader and may be changed in 
the reader.  This allows to have more cases handled right, even without
changes in the Info format, and also give ideas of what should be
changed in the Info format to remove this limitation, not today, but
maybe tomorrow (and not some day :-).

-- 
Pat



reply via email to

[Prev in Thread] Current Thread [Next in Thread]