Re: "make info" fails with new versions of texinfo

[Peter Stephenson <p.w.stephenson@xxxxxxxxxxxx>]

On Fri, 12 Apr 2013 12:11:05 +0200
Frank Terbeck <ft@xxxxxxxxxxxxxxxxxxx> wrote:
> Oh, I forgot the yodl versions, that were used: I used version 3.00 and
> the guy on IRC used 3.01.

I can't get 3.01 to do anything sensible, I get a fatal error you're
obviously not getting.  However, the .texi file I get from my version,
which is very old, gives output that corresponds to the warnings and
errors you got:

makeinfo ./zsh.texi
./zsh.texi:433: warning: @item missing argument
./zsh.texi:1083: warning: @item missing argument
./zsh.texi:1654: warning: @item missing argument
./zsh.texi:14714: warning: @item missing argument
./zsh.texi:22674: @itemx must follow @item
./zsh.texi:23289: warning: @item missing argument
./zsh.texi:23434: warning: @item missing argument
./zsh.texi:23867: warning: @item missing argument
./zsh.texi:23895: warning: @item missing argument
./zsh.texi:25010: warning: @item missing argument
./zsh.texi:25013: warning: @item missing argument
./zsh.texi:25016: warning: @item missing argument
make[1]: *** [zsh.info] Error 1

I haven't got the latest texinfo because my Linux distribution is out of
date, because it made the boot partition too small and now refuses to
upgrade, but I can make reasonable guesses.

The warnings about empty items do indeed correspond to empty items.
They come from the zsh macro, not Yodl's macros; it's deliberate.  I've
removed it below, but it does look like it might be better to have a bit
more space afterwards.  There are probably better ways of doing that ---
like explicitly inserting a blank line, so that's what I've done.  With
any luck the result is very similar.

The error looks like it might be because texinfo is getting confused by
a line split.  Does putting it back together make a difference?

diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo
index 2991c1f..4a436da 100644
--- a/Doc/Zsh/compsys.yo
+++ b/Doc/Zsh/compsys.yo
@@ -4414,8 +4414,7 @@ tt(ambiguous), tt(special-dirs), tt(list-suffixes) and tt(file-sort)
 described above.
 )
 findex(_pick_variant)
-xitem(tt(_pick_variant) [ tt(-b) var(builtin-label) ] [ tt(-c)
-var(command) ] [ tt(-r) var(name) ])
+xitem(tt(_pick_variant) [ tt(-b) var(builtin-label) ] [ tt(-c) var(command) ] [ tt(-r) var(name) ])
 item(   var(label)tt(=)var(pattern) ... var(label) [ var(args) ... ])(
 This function is used to resolve situations where a single command name
 requires more than one type of handling, either because it
diff --git a/Doc/ztexi.yo b/Doc/ztexi.yo
index ed0236b..513452b 100644
--- a/Doc/ztexi.yo
+++ b/Doc/ztexi.yo
@@ -193,8 +193,8 @@ def(startlist)(0)(\
   startitem()\
 )
 def(endlist)(0)(\
-  NOTRANS(@item)+NL()\
-  enditem()\
+  enditem()+NL()\
+  NOTRANS(@sp 1)\
 )
 def(list)(1)(\
   item(ARG1)()\

-- 
Peter Stephenson <p.w.stephenson@xxxxxxxxxxxx>
Web page now at http://homepage.ntlworld.com/p.w.stephenson/