On Thu, Jul 23, 2026 at 05:26:10PM +0100, Gavin Smith wrote:
> That should be ok, as long as we avoid creating shadow targets if there
> is an associated node (my patch to texinfo.tex avoided this).  Then
> outputting a warning won't affect many existing manuals.

After some thinking, I am not sure that it is having a new way to
specify the TREE_TRANSFORMATIONS insert_nodes_for_sectioning_commands
is worth it.  Instead, it seems enough to me to explicitly explain that
this can be used in the document where we explain what happens when
nodes are not specified.

Also I now think that adding targets for sectioning commands without
nodes should be done in the default case.  There could be a
customization variable to silence the warning about having the target
already registered.

Finally, I think that we should consider applying the
insert_nodes_for_sectioning_commands TREE_TRANSFORMATIONS in the default
case for Info and HTML.  There would need to have a customization
variable not to do it, as sectioning commands without associated node
may also be a relevant setup.  This would be a non backward compatible
change, but this also would advance towards not needing to have explicit
nodes for Texinfo manuals being organized like books.

-- 
Pat

Reply via email to