Re: menu and sectioning consistency warning too strict?

[Patrice Dumas]

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