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
