Re: Unable to build documentation

[Bruno Haible]

Elijah Zarezky wrote:
> I've just trieed to build documentation via
> /usr/bin/make --jobs=1 -C doc gnulib.html gnulib.pdf
> and got the following error(s):
> 
> make: Entering directory '/home/elijah/.local/rpmbuild/BUILD/gnulib/doc
> 'date -u -r agpl-3.0.texi +"@set UPDATED %F %T" > updated-stampenv
> LANG= LC_MESSAGES= LC_ALL= LANGUAGE= makeinfo --no-split 
> --reference-limit=2000 --html -o gnulib.html gnulib.texi
> ./strings.texi:208: warning: node next `Strings with NUL characters' in menu 
> `Comparison of string APIs' and in sectioning `String Functions in C Locale' 
> differ
> ./c-locale.texi:1: warning: node `Comparison of string APIs' is next for 
> `String Functions in C Locale' in sectioning but not in menu
> ./c-locale.texi:1: warning: node `Strings with NUL characters' is prev for 
> `String Functions in C Locale' in sectioning but not in menu
> ./c-locale.texi:1: warning: node `Strings' is up for `String Functions in C 
> Locale' in sectioning but not in menu
> ./strings.texi:21: node `Strings' lacks menu item for `String Functions in C 
> Locale' despite being its Up target
> ./strings.texi:233: warning: node prev `Comparison of string APIs' in menu 
> `Strings with NUL characters' and in sectioning `String Functions in C 
> Locale' differ
> make: *** [Makefile:24: gnulib.html] Error 1

Thanks for the report. Fixed through the patch below.
You must be using a makeinfo version 6.4 to 6.7, whereas I am using makeinfo
version 6.8. I filed a bug report at
https://lists.gnu.org/archive/html/bug-texinfo/2023-06/msg00014.html .


2023-06-22  Bruno Haible  <bruno@clisp.org>

        doc: Correct info menu structure.
        Reported by Elijah Zarezky <elijah@zarezky.spb.ru> in
        <https://lists.gnu.org/archive/html/bug-gnulib/2023-06/msg00105.html>.
        * doc/strings.texi (Strings): Add missing @menu item.

diff --git a/doc/strings.texi b/doc/strings.texi
index cbed6533c4..612d4fb083 100644
--- a/doc/strings.texi
+++ b/doc/strings.texi
@@ -27,6 +27,7 @@
 @menu
 * C strings::
 * Strings with NUL characters::
+* String Functions in C Locale::
 * Comparison of string APIs::
 @end menu