gbranden pushed a commit to branch master
in repository groff.

commit 294a5d43604f2fb9ca1902865159882c3d033681
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Jan 17 11:10:30 2026 -0600

    doc/groff.texi.in: Fix Savannah #67838 (2/2).
    
    Fix erroneous menu entries.  This finishes cleaning up warnings about
    the document's node topology from recent Texinfo.
---
 ChangeLog         | 19 +++++++++++++++++++
 doc/groff.texi.in |  5 ++---
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 859a22a54..a60c82b2b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,22 @@
+2026-01-16  G. Branden Robinson <[email protected]>
+
+       * doc/groff.texi.in:
+       - Stop attempting to manually recapitulate the topology of the
+         Info node tree with arguments after the first to `@node`
+         commands; doing so is no longer required by recent versions of
+         Texinfo--thanks to Alexis Hildebrandt for bringing this to my
+         attention and providing a proof-of-concept patch--but the
+         normative topology of the directed tree is radically
+         unintuitive to me, leading me to make many errors.  It _seems_
+         like Info's idea of the node traversal strategy preferred by
+         humans is breadth-first in one direction ("Next") and
+         _depth_-first in the other ("Prev").
+       - Fix erroneous menu entries.  This finishes cleaning up
+         warnings about the document's node topology from recent
+         Texinfo.
+
+       Fixes Savannah #67838.
+
 2026-01-16  G. Branden Robinson <[email protected]>
 
        Crib gnulib's coverage generation from its "maint.mk" file.
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index fe052eda1..d46b07df6 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -530,8 +530,8 @@ extensively for over thirty years.
 * Macro Package Intro::
 * Preprocessor Intro::
 * Output Device Intro::
-* Conventions Used in This Manual::
 * Installation::
+* Conventions Used in This Manual::
 * Credits::
 @end menu
 
@@ -5538,8 +5538,8 @@ and supplementing it with inter-sentence space.
 
 @menu
 * Filling::
-* Hyphenation::
 * Sentences::
+* Hyphenation::
 * Breaking::
 * Adjustment::
 * Tabs and Leaders::
@@ -17416,7 +17416,6 @@ The formatter passes no arguments to macros called by 
traps.
 
 @menu
 * Vertical Position Traps::
-* Diversion Traps::
 * Input Line Traps::
 * Blank Line Traps::
 * Leading Space Traps::

_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to