Errors running texi2dvi on r5rs.texi from the Guile docs distro

[Neil Jerram]

Hi Texinfo people,

This report is for unexpected errors when running texi2dvi on the file
guile-doc/ref/r5rs.texi from the Guile CVS.  If you prefer, I can mail
you a copy of this file (and also the accompanying texinfo.tex).

I'm afraid I don't know enough to know whether these errors indicate
bugs in the source or bugs in texi2dvi.  But r5rs.texi is a very
widely distributed document, so I would tend to suspect texi2dvi.

texi2dvi version is:

-----------------texi2dvi version-----------------------------
address@hidden guile-doc]$ texi2dvi --version
texi2dvi (GNU Texinfo 4.0) 0.43

Copyright (C) 1999 Free Software Foundation, Inc.
There is NO warranty.  You may redistribute this software
under the terms of the GNU General Public License.
For more information about these matters, see the files named COPYING.
-----------------texi2dvi version-----------------------------

The output for the first error is as follows:

------------------first error output begin--------------------
address@hidden guile-doc]$ make dvi
Making dvi in ref
make[1]: Entering directory `/home/neil/Guile/guile-lsh/guile/guile-doc/ref'
TEXINPUTS=.:$TEXINPUTS \
  MAKEINFO='makeinfo -I .' texi2dvi r5rs.texi
This is TeX, Version 3.14159 (Web2C 7.3.1)
(/tmp/t2d2849/src/r5rs.texi (texinfo.tex
Loading texinfo package [Version 1.2]: Basics, fonts, page headings, tables,
indexing, sectioning, toc printing, environments, defuns, cross reference,
(/usr/share/texmf/tex/plain/dvips/epsf.tex)
and turning on texinfo input format.) (r5rs.aux) (Summary) [1] [2] [3]
(Introduction) [1] Chapter1 [2] [3] [4]
! Unbalanced parentheses in @def.
@defunargs ...age {Unbalanced parentheses in @def}
                                                  @fi @interlinepenalty =100...

@deffnheader ...p @defname address@hidden {#3}
                                                  @endgroup @catcode 
address@hidden 

@spacesplitfoo ...lax address@hidden #1{#2}{#3#4}
                                                  @fi 
l.605 ...cedure} (vector-ref @var{vector} @var{k})
                                                  
? q
OK, entering @batchmode/usr/bin/texi2dvi: tex exited with bad status, quitting.
/usr/bin/texi2dvi: see r5rs.log for errors.
make[1]: *** [r5rs.dvi] Error 1
make[1]: Leaving directory `/home/neil/Guile/guile-lsh/guile/guile-doc/ref'
make: *** [dvi-recursive] Error 1
------------------first error output end----------------------

A workaround for this error is to comment out line 3982 of
texinfo.tex.  Then I get the following error:

------------------second error output begin-------------------
address@hidden guile-doc]$ rm ref/r5rs.dvi
address@hidden guile-doc]$ make dvi
Making dvi in ref
make[1]: Entering directory `/home/neil/Guile/guile-lsh/guile/guile-doc/ref'
TEXINPUTS=.:$TEXINPUTS \
  MAKEINFO='makeinfo -I .' texi2dvi r5rs.texi
This is TeX, Version 3.14159 (Web2C 7.3.1)
(/tmp/t2d2926/src/r5rs.texi (texinfo.tex
Loading texinfo package [Version 1.2]: Basics, fonts, page headings, tables,
indexing, sectioning, toc printing, environments, defuns, cross reference,
(/usr/share/texmf/tex/plain/dvips/epsf.tex)
and turning on texinfo input format.) (r5rs.aux) (Summary) [1] [2] [3]
(Introduction) [1] Chapter1 [2] [3] [4] [5] Chapter2 [6] [7] [8] Chapter3
[9] [10] [11] [12] [13] Chapter4 [14] [15] [16] [17] [18] [19] [20] [21]
[22] [23] [24] [25] [26] [27] [28] [29] [30] Chapter5 [31] [32] Chapter6
[33] [34] [35] [36] [37] [38] [39] [40] [41] [42] [43] [44] [45] [46] [47]
[48] [49] [50] [51] [52] [53] [54] [55] [56] [57] [58] [59] [60] [61] [62]
[63] [64] [65] [66]
Overfull \hbox (79.27252pt too wide) in paragraph at lines 6349--6361
 address@hidden Proc @textrm must be a pro-ce-dure of one ar-gu-ment. The 
pro-ce-dur
e address@hidden address@hidden '[] |
[67]
Overfull \hbox (116.57858pt too wide) in paragraph at lines 6373--6377
 address@hidden The fol-low-ing ex-am-ples show only the most com-mon ways in 
which 
address@hidden address@hidden '[] |
[68] [69]
Overfull \hbox (19.43394pt too wide) in paragraph at lines 6546--6549
 address@hidden If in-vok-ing a con-tin-u-a-tion re-quires call-ing the @textsl 
be-f
ore @textrm from one call to address@hidden address@hidden '[] |
[70]
Overfull \hbox (13.69946pt too wide) in paragraph at lines 6614--6625
 @textrm Scheme re-port (the address@hidden address@hidden 5 Re-port on 
Scheme). address@hidden
exttt address@hidden '[] |
[71]
Overfull \hbox (4.11963pt too wide) in paragraph at lines 6700--6711
 @textrm address@hidden address@hidden '[] and address@hidden call
address@hidden '[] |
[72] [73] [74] [75] [76] Chapter7 [77]
! Argument of @doignoretext has an extra }.
<inserted text> 
                @par 
<to be read again> 
                   }
@t #1->address@hidden @rawbackslash @frenchspacing #1}
                                            @null 
l.7217      | \" | \\ }
                       
? x
Output written on r5rs.dvi (80 pages, 222404 bytes).
Transcript written on r5rs.log.
/usr/bin/texi2dvi: tex exited with bad status, quitting.
/usr/bin/texi2dvi: see r5rs.log for errors.
make[1]: *** [r5rs.dvi] Error 1
make[1]: Leaving directory `/home/neil/Guile/guile-lsh/guile/guile-doc/ref'
make: *** [dvi-recursive] Error 1
------------------second error output end---------------------

I couldn't find a simple workaround for this one, so...

Over to you!

Regards,

        Neil


------- Start of forwarded message -------
To: "Dale P. Smith" <address@hidden>
CC: address@hidden
Subject: Re: Guile Docs
References: <address@hidden>
From: Neil Jerram <address@hidden>
Date: 28 Oct 2000 16:42:43 +0100
Message-ID: <address@hidden>

>>>>> "Dale" == Dale P Smith <address@hidden> writes:

    Dale> Howdy Neil, Just saw you committing some stuff to the
    Dale> guile-doc cvs module so I'm picking on you. Probably should
    Dale> send a bug-report somewhere...

In general, address@hidden is the place for Guile bug reports.  In
this case, however, you're right that it's mostly me working on the
docs right now.

    Dale> The current cvs guile-doc fails on a "make dvi".  I just
    Dale> type an `r' and run "make dvi" again until the make
    Dale> finishes.  Looks like something wrong with the r4rs.texi and
    Dale> r5rs.texi files.

I don't get any problems with r4rs - what problems do you see with
this one?

With r5rs, I get a problem at line 714 of r5rs.texi: "! Unbalanced
parentheses in @def", which can be `fixed' by commenting out line 3982
of texinfo.tex.

When this is fixed, I get a problem at line 7326 of r5rs.texi: "!
Argument of @doignoretext has an extra }".  This one is beyond me, I'm
afraid.

Anyway, these are bugs either in the r5rs.texi source, or in the
texi2dvi tool, so I think the right thing is to forward this to the
Texinfo people.

Regards,
        Neil
------- End of forwarded message -------