[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.