> From: Gavin Smith <gavinsmith0...@gmail.com> > Date: Sat, 28 Jun 2025 20:47:31 +0100 > Cc: pertu...@free.fr, bug-texinfo@gnu.org > > On Tue, Jun 24, 2025 at 02:28:44PM +0300, Eli Zaretskii wrote: > > As an example of a manual whose structure is not a tree, but is > > well-thought out, see info.texi. I'd expect to see such warnings > > there as well (unless the few explicit node pointers it has will avoid > > that), although the structure of that manual is fine. > > I've downloaded info.texi from > <https://cgit.git.savannah.gnu.org/cgit/emacs.git/plain/doc/misc/info.texi>, > commented out the @include lines, and ran it with the current development > version of texi2any. There were no warnings issued.
I believe that's because info.texi uses explicit node pointers in the @node lines. > The only irregularities I could find in this manual are multiple menu entries > for the same node (in "Help-Inv" and "Help-M"). That manual's structure is not a tree. > It's possible that there will be warnings about this by default depending > on what changes are made. It would be good to avoid them if possible, but it isn't a catastrophe if not. After all, whether the structure is correct or not is a human decision, and only the author knows for sure.
