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.
