On Sat, Feb 20, 2021 at 01:58:54PM +0000, Gavin Smith wrote: > On Thu, Feb 18, 2021 at 1:22 AM Patrice Dumas <[email protected]> wrote: > > > I created a minimal failing example: > > > > > > \input texinfo @c -*-texinfo-*- > > > > > > @node Top > > > @top top > > > > > > @node chap1 > > > @chapter chap1 > > > > > > @node sec1 > > > @section sec1 > > > > > > @node chap2 > > > @chapter chap2 > > > > > > @node sec2 > > > @section sec2 > > > > > > @bye > > > > > > Procesing with ./texi2any.pl --html --split=chapter test.texi > > > gave spurious warnings: > > > > These are not spurious, the nodes cannot be reached as they are not in > > any @menu nor in node directions. It could be possible to remove this > > warning if FORMAT_MENU is set to anything else than menu, though. > > > > > test.texi:9: warning: node `sec1' unreferenced > > > test.texi:15: warning: node `sec2' unreferenced > > For Info output, they are referenced in the menus that are output in > nodes chap1 and chap2.
This is not easy to determine which warning to output since the node is automatically added during output. I think that we have two possibilities, * pass to Structuring.pm the information that nodes will be generated automatically and add a special case for nodes in generated menus. * modify the tree before or in Texinfo::Structuring::nodes_tree(). > For HTML output, they are referenced in the > sectional tables of contents. I didn't check with other values of > FORMAT_MENU. I will have to check what the default value of > FORMAT_MENU is and what errors are output for each setting. I checked that with FORMAT_MENU set to menu or nomenu in HTML, the node will actually be unreferenced. I am not sure what to do with nomenu, if FORMAT_MENU=mini_toc, it would make sense to consider that all the nodes associated with sectioning commands are referenced. -- Pat
