Re: footer navigation headers

[Patrice Dumas]

On Sat, Feb 20, 2021 at 01:58:54PM +0000, Gavin Smith wrote:
> On Thu, Feb 18, 2021 at 1:22 AM Patrice Dumas <pertusus@free.fr> 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