Hi,

During work on the GNU Boot manual, I stumbled upon some "warning:
node `[...]'  unreferenced" warnings.

Having these warnings didn't look very logical to me since the Short
Sample provided in the texinfo manual didn't have them and also didn't
do anything special to avoid them.

But if we remove the second section of the Short Sample, we get such
warnings.

So at the end of the day the fix was well documented in the
'Unreferenced Node' thread that was started the Saturday 17 May
2025[1] on the help-texinfo mailing list.

[1]https://lists.gnu.org/archive/html/help-texinfo/2025-05/msg00007.html

And so my logical conclusion is that this Short Sample needs to be
updated to do the right thing (and not require people to be online to
lookup this in search engines or mailing list archives), but also note
that I'm still a beginner with texinfo, so I could also have missed
something.

Also I've no idea why makeinfo / texi2any --info doesn't do any
warnings when there are more than one section (to me it looks like a
bug, but I've no idea how to debug something like that, so I'll leave
that to people that are more used to texinfo than I am).

I can open a bug report if needed though.

Denis 'GNUtoo' Carikli (1):
  Short Sample: show how to avoid warning: node `[...]' unreferenced.

 ChangeLog        | 20 ++++++++++++++++++++
 doc/texinfo.texi |  4 ++++
 2 files changed, 24 insertions(+)


base-commit: e2f6aad41fa85a1990ba5d82983d65b1385e5c0a
-- 
2.46.0


Reply via email to