URL: <https://savannah.gnu.org/bugs/?67838>
Summary: [doc] [PATCH] Fix makeinfo warnings regarding
non-existent nodes and incorrect next/previous node pointers
Group: GNU roff
Submitter: afh
Submitted: Sun 21 Dec 2025 08:29:08 AM UTC
Category: General
Severity: 3 - Normal
Item Group: Documentation
Status: None
Privacy: Public
Assigned to: None
Open/Closed: Open
Discussion Lock: Unlocked
Planned Release: None
_______________________________________________________
Follow-up Comments:
-------------------------------------------------------
Date: Sun 21 Dec 2025 08:29:08 AM UTC By: Alexis <afh>
When processing groff.texi `makeinfo` warns about several next and prev node
pointers being inconsistent with the related menu:
sed -e 's/@VERSION@/M.m.p/' < doc/groff.texi.in > doc/groff.texi; makeinfo
--no-split --output doc/groff.info doc/groff.texi 2>&1 | tee
groff-texi-makeinfo-warnings.txt | head -5
groff.texi:732: warning: node next pointer for `Output Device Intro' is
`Installation' but next is `Conventions Used in This Manual' in menu
groff.texi:750: warning: node next pointer for `Installation' is `Conventions
Used in This Manual' but next is `Credits' in menu
groff.texi:750: warning: node prev pointer for `Installation' is `Output
Device Intro' but prev is `Conventions Used in This Manual' in menu
groff.texi:762: warning: node next pointer for `Conventions Used in This
Manual' is `Credits' but next is `Installation' in menu
groff.texi:762: warning: node prev pointer for `Conventions Used in This
Manual' is `Installation' but prev is `Output Device Intro' in menu
At the risk of being being too naïve and overzealous I set out to address the
warnings to the best of my knowledge by looking at the file locations of each
warning and trying to figure out which next and/or prev node and related menu
would be most appropriate by looking at the next and/or previous node and
menu.
Please find attached a patch that addresses the warnings as well was the
groff-texi-makeinfo-warnings.txt output from the example above for your
convenience.
Ideally the proposed changes are correct, if not they hopefully provide a good
start for someone more familiar with groff.texi and the changes introduced
since 1.22.4.
Why 1.22.4 and not 1.23.0? Checking out the 1.23.0 tag the majority of the
node warnings are still present, whereas checking out the 1.22.4 tag only a
single node up pointer is inconsistent.
_______________________________________________________
File Attachments:
Name: fix-groff-texi-node-warnings.patch Size: 3.1KiB
<https://file.savannah.gnu.org/file/fix-groff-texi-node-warnings.patch?file_id=58003>
Name: groff-texi-makeinfo-warnings.txt Size: 2.8KiB
<https://file.savannah.gnu.org/file/groff-texi-makeinfo-warnings.txt?file_id=58004>
AGPL NOTICE
These attachments are served by Savane. You can download the corresponding
source code of Savane at
https://savannah.gnu.org/source/savane-1e6fd23c41fc02d9904e289de521b5c19703a648.tar.gz
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?67838>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/
signature.asc
Description: PGP signature
