bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: menu and sectioning consistency warning too strict?


From: Gavin Smith
Subject: Re: menu and sectioning consistency warning too strict?
Date: Wed, 10 Apr 2024 23:53:31 +0100

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
> 
> 
> 
> 
> I am not sure that this warning is warranted, this code seems ok to
> me, the lone node is not fully consistent with the sectioning structure,
> but not that inconsistent either.
> 
> If there is another chapter after the lone node, there are two warnings,
> but this seems ok to me, as in that case, there is a clearer
> inconsistency, since with sectioning there is this time a different next:

I agree that the warning is not really necessary.   I don't mind
either way.  It's up to you if you want to try to remove the warning.
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.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]