On Wed, Apr 10, 2024 at 11:53:31PM +0100, Gavin Smith wrote: > On Wed, Apr 10, 2024 at 09:57:19PM +0200, Patrice Dumas wrote: > > Hello, > > > > With CHECK_NORMAL_MENU_STRUCTURE set to 1, there is a warning by > > texi2any: > > > > a.texi:10: warning: node `node after chap1' is next for `chap1' in menu but > > not in sectioning > > > > for the following code: > > > > @node Top > > @top top > > > > @menu > > * chap1:: > > * node after chap1:: > > @end menu > > > > @node chap1 > > @chapter Chapter 1 > > > > @node node after chap1,, chap1, Top > > It's questionable whether lone @node without a following sectioning > command is proper Texinfo. or what these constructs mean or how they should > be output.
I disagree, to me it is clearly proper Texinfo. Sectionning commands are not necessary, nodes can be the only structuring commands. For a "non-standard" structure, for instance a topic/guide structure, having all nodes associated to sectioning commands could be cumbersome. How these constructs are output is explained in the main manual and in the texi2any_api manual for more details (for HTML). I have added more information in the new HTML customization section from the texi2any_api manual on that subject. For Info, it is in the main manual. -- Pat
