While the current Short Sample work fine, if we remove the second
section and run run the following command:
makeinfo -D "VERSION 0.1" -D "UPDATED now" shortsample.texi'
we end up with the following warning:
shortsample.texi:50: warning: node `First Section' unreferenced
According to the 'Unreferenced Node' thread that was started the
Saturday 17 May 2025[1] on the help-texinfo mailing list, the proper
way to avoid these warnings is to add these node in a menu that is in
the node that is one up in the hierarchy (so in section for
subsections, in subsection for subsubsections, etc).
[1]https://lists.gnu.org/archive/html/help-texinfo/2025-05/msg00007.html
* doc/texinfo.texi (Short Sample): add menu inside First Chapter.
Signed-off-by: Denis 'GNUtoo' Carikli <[email protected]>
---
ChangeLog | 20 ++++++++++++++++++++
doc/texinfo.texi | 4 ++++
2 files changed, 24 insertions(+)
diff --git a/ChangeLog b/ChangeLog
index e7d0e51f27..0298855358 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,23 @@
+2025-07-19 Denis 'GNUtoo' Carikli <[email protected]>
+
+ Short Sample: show how to avoid warning: node `[...]' unreferenced.
+
+ While the current Short Sample work fine, if we remove the second
+ section and run run the following command:
+ makeinfo -D "VERSION 0.1" -D "UPDATED now" shortsample.texi'
+ we end up with the following warning:
+ shortsample.texi:50: warning: node `First Section' unreferenced
+
+ According to the 'Unreferenced Node' thread that was started the
+ Saturday 17 May 2025[1] on the help-texinfo mailing list, the proper
+ way to avoid these warnings is to add these node in a menu that is in
+ the node that is one up in the hierarchy (so in section for
+ subsections, in subsection for subsubsections, etc).
+
+ [1]https://lists.gnu.org/archive/html/help-texinfo/2025-05/msg00007.html
+
+ * doc/texinfo.texi (Short Sample): add menu inside First Chapter.
+
2025-07-18 Patrice Dumas <[email protected]>
* tta/C/main/element_types.txt, tta/C/main/utils.c
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 2c256db56d..e382d6484d 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -997,6 +997,10 @@ This is the second item.
@@end enumerate
@end group
+@@menu
+* First Section:: The first section.
+* Second Section:: The second section.
+@@end menu
@@node First Section
@@section First Section
--
2.46.0
