On Mon, Oct 12, 2026 at 04:51:40PM +0200, Patrice Dumas wrote:
> > I think this means the default for Info and HTML is AUTO_SECTION_NODE=1 and
> > WARN_DUPLICATE_SECTION_TARGET=0. For other formats it is
> > AUTO_SECTION_NODE=0
> > and WARN_DUPLICATE_SECTION_TARGET=1.
>
> That would be my preference, too.
I don't understand the purpose of not setting AUTO_SECTION_NODE=1 for all
output formats.
I am reviewing text in the node "The Body of the Document" in texinfo.texi
(below).
I have removed the @node lines before the @chapter line and the two
@section lines, but then it is not true any more that there are always three
nodes here.
I think I managed to revise the text here appropriately, although it may be
worth bearing in mind that the inconsistency between output formats potentially
complicates the semantics of the language.
The body segment contains all the text of the document. A manual is
divided into one or more “nodes” (*note Nodes::). The example
illustrates a chapter made of three nodes, one for introductory material
in the chapter, and two sections. The introductory material contains an
enumerated list.
@node First Chapter
@chapter First Chapter
@cindex chapter, first
This is the first chapter.
@cindex index entry, another
Here is a numbered list.
@enumerate
@item
This is the first item.
@item
This is the second item.
@end enumerate
@node First Section
@section First Section
First section of first chapter.
@node Second Section
@section Second Section
Second section of first chapter.