When building gnulib documentation I get the following error:

/home/collin/.local/src/gnulib/doc/gnulib-tool.texi:472: Argument of @asis has 
an extra }.
<inserted text> 
                @par 
<to be read again> 
                   }
@doitemize ...1}@setbox 0 = @hbox {@itemcontents }
                                                  @ifx @itemcontents @empty ...
l.472 @itemize @asis
                    
? 
/home/collin/.local/src/gnulib/doc/gnulib-tool.texi:472: Emergency stop.
<inserted text> 
                @par 
<to be read again> 
                   }
@doitemize ...1}@setbox 0 = @hbox {@itemcontents }
                                                  @ifx @itemcontents @empty ...
l.472 @itemize @asis

I don't know Texinfo (or TeX error messages to be honest). It seems
that this doesn't affect info or html, but only dvi, pdf etc. The two
offending lines are both "@itemize @asis".

A lucky grep in my cloned sources finds this ChangeLog entry from
Emacs:

2009-01-25  Karl Berry  <k...@gnu.org>

        * text.texi (Foldout): Use @itemize @w{} to make an itemize
        item with no marker, instead of the syntactically incorrect
        @itemize @asis.

I've attached a patch that does this. It removes the bullet points
which seems to be the original intent.

Collin
From 412c885c9bab2f2c32aa1bc28aed7a7f570fd4ad Mon Sep 17 00:00:00 2001
From: Collin Funk <collin.fu...@gmail.com>
Date: Mon, 4 Mar 2024 05:09:51 -0800
Subject: [PATCH] doc: Fix build errors.

* doc/gnulib-tool.texi (Style of #include statements): Use @itemize w{}
instead of the incorrect @itemize @asis.
---
 ChangeLog            | 6 ++++++
 doc/gnulib-tool.texi | 4 ++--
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 75925373ae..85df0bf00d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2024-03-04  Collin Funk  <collin.fu...@gmail.com>
+
+	doc: Fix build errors.
+	* doc/gnulib-tool.texi (Style of #include statements): Use @itemize w{}
+	instead of the incorrect @itemize @asis.
+
 2024-03-03  Collin Funk  <collin.fu...@gmail.com>
 
 	gnulib-tool.py: Adjust construction of configure.ac path.
diff --git a/doc/gnulib-tool.texi b/doc/gnulib-tool.texi
index 5626ce9d53..e006a6d35f 100644
--- a/doc/gnulib-tool.texi
+++ b/doc/gnulib-tool.texi
@@ -469,7 +469,7 @@ and these flags have no effect after any system header file has been included.
 When including including specific header files, you need to use the
 @samp{#include <...>} syntax, not the @samp{#include "..."} syntax.
 This is true for the following POSIX or ISO C standardized header files:
-@itemize @asis
+@itemize @w{}
 @item @code{arpa/inet.h}
 @item @code{assert.h}
 @item @code{ctype.h}
@@ -529,7 +529,7 @@ This is true for the following POSIX or ISO C standardized header files:
 @noindent
 as well as for the following header files that exist in the GNU C library
 but are not standardized:
-@itemize @asis
+@itemize @w{}
 @item @code{alloca.h}
 @item @code{error.h}
 @item @code{getopt.h}
-- 
2.44.0

Reply via email to