> From: Gavin Smith <[email protected]> > Date: Wed, 21 Oct 2026 19:33:27 +0100 > > Testing with groff.texi from groff 1.24.2, there is a warning: > > $ texi2any groff.texi > groff.texi:3288: warning: @node name should not contain `,': Titles (headers, > footers) > groff.texi:3288: warning: node name with index entries should not contain `,' > > This is due to the new "shadow targets" feature where a sectioning command > without > a @node creates a possible target for a cross-reference. groff.texi has such > a command: > > @unnumberedsubsubsec Titles (headers, footers) > > @Defmpstr {LH, ms} > Defines the text displayed in the left header position. > > Effective: next header. > > Default: empty. > @endDefmpstr > > ... > > > Probably, using @unnumberedsubsubsec was a mistake here and @subsubheading > was intended, since we never recommended before that users could use > sectioning > commands on their own like this. > > The first warning is confusing because there is no @node command in the > Texinfo source. > > Perhaps we could just drop the '@' character: > > groff.texi:3288: warning: node name should not contain `,': Titles (headers, > footers) > > Does that look alright? > > texi2any does output the quoting characters for the ensuing Info node in > a few places, such in the header line of the previous node: > > File: groff.info, Node: Margin settings, Next: ^?Titles (headers, > footers)^?, Up: ms Document Control Settings > > - so a warning does seem appropriate. > > The second warning appears to refer to index entries in the node. The Info > file has an index entry like: > > * LH [ms]: Titles (headers, footers). > (line 7) > > texi2any uses ^? (DEL) quoting characters for this: > > * LH [ms]: ^?Titles (headers, footers)^?. > (line 7) > > So the warning about the ',' in a node with index entries seems appropriate > here.
I don't understand: are you saying that the DEL quoting should NOT have happened in these two cases? If not, i.e. if you are saying that this quoting is legitimate, then why is the warning emitted? And at least in the first example, with the node's header line, AFAIU node names should never be quoted there -- did I misunderstand?
