[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: menu and sectioning consistency warning too strict?
From: |
Patrice Dumas |
Subject: |
Re: menu and sectioning consistency warning too strict? |
Date: |
Thu, 11 Apr 2024 14:03:13 +0200 |
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