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.


Reply via email to