On Sun, Jun 29, 2025 at 02:42:08PM +0300, Eli Zaretskii wrote:
> > It's because there are three menu entries for the same node. The
> > first menu entry is expected because that node is subordinate in
> > the sectioning structure (a @subsection underneath a @section),
> > but the other two are unexpected as there are no more subsections
> > to follow.
>
> Then maybe it would be possible to make the warning more explicit,
> like:
>
> warning: two or more menu items leading to the same node
Yes, it's possible, although I think it is easy to figure out
what the problem is in this case.
> > It's not clear if the explicit node pointers would help here as
> > these are given for the child node:
> >
> > @node Help-], , , Help-Inv
> > @subsection The @kbd{]} and @kbd{[} commands
> >
> > - but not for the parent node that contains the menu:
> >
> > @node Help-Inv
> > @section Invisible text in Emacs Info
>
> The parent node cannot have an explicit pointer to a child node, can
> it?
No, not on the node line. It is only Next, Prev and Up.
> > If we did allow explicit node pointers to suppress this warning,
> > we'd have to consider which of these nodes to check.
>
> Not sure it's justified. An explicit warning should be good enough.
> Bonus points for adding some mechanism for suppressing specific
> warnings, if that could be made general enough.
