On Sat, Oct 24, 2026 at 11:07:29AM +0100, Gavin Smith wrote: > I would like to keep the "Nodes" chapter still mainly about the Texinfo > language per se, not about options of the Texinfo processors. It should > be possible to read and understand this chapter without understanding > what AUTO_SECTION_NODE does in texi2any output, so we should avoid adding > mentions of AUTO_SECTION_NODE throughout the chapter, or presenting the > idea that there are two different versions of the Texinfo language that > the reader has to understand.
This is not fully possible, and implying that there may be different versions of the Texinfo language is already done in the last paragraph of the Nodes node, where the default case, with nodes added for sectioning commands without node is mentioned. Which is right, as it is a relevant information. > The "Unstructured Nodes" node is not processor-specific (its contents are > equally relevant regardless of whether you are processing with texi2any or > texinfo.tex), so one suggestion is to put a new section *after* this node, > as the other later sections in the chapter are more specific to texi2any > (@nodedescription and @menu). I did that, and tried to explain the two interpretations of the Texinfo code in an abstract way before referring to AUTO_SECTION_NODE or splitting. -- Pat
