On Tue, Jun 24, 2025 at 02:28:44PM +0300, Eli Zaretskii wrote: > > So while the Info output is basically fine, output that doesn't use > > menus, including the default HTML output and output with TeX, has > > problems. Hence I believe we should keep the new warnings with > > CHECK_NORMAL_MENU_STRUCTURE, even though the authors have provided > > explicit node pointers that match the intended document structure, as > > you describe. > > I think there are two separate issues here. One is the actual > structure of the glibc manual wrt these subsections. Any such > problems can only be addressed by the authors of the manual, since we > cannot expect makeinfo to understand which structure is good and which > isn't. > > The other issue is what kind of warnings, if any, should makeinfo > issue in these cases. My comment was only about this second issue, > because I think that's the only issue that should be your bother while > you reimplement this stuff.
Yes, I agree there are these two issues. > 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. The only irregularities I could find in this manual are multiple menu entries for the same node (in "Help-Inv" and "Help-M"). It's possible that there will be warnings about this by default depending on what changes are made.
