On Sat, Feb 15, 2025 at 02:01:13PM +0000, Gavin Smith wrote:
> I don't see the purpose of this as documents should use a sectioning
> command, not a @*heading command after a node.

I disagree, I think that @*heading command after a node is a natural
setting for a manual organized in topics that do not follow a sectionning
tree.  Like it can be done with dita/mallard/DocBook topics.  In the
interpretation that @node is an output unit delimiter, it should be
possible to have content linked to and from nodes to follow different
organization than a sectioning tree.

> I understand USE_NEXT_HEADING_FOR_LONE_NODE as a minor alteration for the
> HTML output (possibly other formats) to avoid duplication in headings,
> but one which only makes a difference in rare cases.

I think that we should make writing manuals in the topics style simpler
and more natural, associating @node to @*headings and having that
possibility work well would be a step in that direction.

-- 
Pat

Reply via email to