make all-pdf failure

[[e-mail]-stuttgart,de]

[2]
Chapter 1.
[3] [4]
Chapter 2.
(/usr/share/texmf/tex/latex/psnfss/ts1ptm.fd) [5] [6] [7] [8]
Underfull \hbox (badness 10000) in paragraph at lines 518--521
\T1/ptm/m/n/10 Biopython is a set of tools for bi-o-log-i-cal com-pu-ta-tion []
[]http://biopython.org/wiki/Main_Page[][] Li-cense:
[9] [10] [11] [12] [13] [14]
Overfull \hbox (22.60109pt too wide) in paragraph at lines 1125--1126
[][]
[15] [16] [17] [18] [19] [20] [21] [22] [23] [24] [25]

! LaTeX Error: Something's wrong--perhaps a missing \item.

See the LaTeX manual or LaTeX Companion for explanation.
Type H <return> for immediate help.
 ...

l.2347 \end{tabulary}

?
! Missing \endgroup inserted.
<inserted text>
                \endgroup
l.2347 \end{tabulary}

I am using

------------------------------------------------------------
revno: 1955
committer: joep <email address hidden>
branch nick: statsmodels_trunk3
timestamp: Mon 2010-02-15 12:54:04 -0500
message:
  small changes to install notes, add sandbox/tests folder to manifest.in

on opensuse11.2

[joep (josef-pktd)]

I get the same error with pdflatex

I tried building latex and pdf a while ago and I thought it might be a problem with windows.

creating latex ends without errors, but the generated latex file has 2 extra \item

I managed to correct the latex file by hand and it compiles to pdf, see attachment. The pdf file doesn't look very nice, e.g. incomplete toc, missing index, docstrings look ok (149 pages)

Since it's autogenerated rst and latex from a docstring, it might not be so easy to figure out what is introducing the incorrect latex.

here's the patch for the latex that inserts nonsense instead of the latex error (for latex file build with "make latex"

diff U3 C:/Josef/eclipsegworkspace/statsmodels_trunk3/scikits/statsmodels/docs/build/latex/statsmodels.tex C:/Josef/eclipsegworkspace/statsmodels_trunk3/scikits/statsmodels/docs/build/latex/statsmodels_corrected.tex
--- C:/Josef/eclipsegworkspace/statsmodels_trunk3/scikits/statsmodels/docs/build/latex/statsmodels.tex Fri Mar 05 15:56:00 2010
+++ C:/Josef/eclipsegworkspace/statsmodels_trunk3/scikits/statsmodels/docs/build/latex/statsmodels_corrected.tex Fri Mar 05 15:43:03 2010
@@ -2332,9 +2332,8 @@

 \hyperlink{scikits.statsmodels.regression.RegressionResults.summary}{\code{summary}}({[}yname, xname{]})
  &
-\begin{quote}\begin{description}
-\item[Parameters] \leavevmode
-\end{description}\end{quote}
+jhlgjhgljh?????????????
+

 \\

@@ -5282,9 +5281,7 @@

 \hyperlink{scikits.statsmodels.family.family.NegativeBinomial.deviance}{\code{deviance}}(Y, mu{[}, scale{]})
  &
-\begin{quote}\begin{description}
-\item[Parameters] \leavevmode
-\end{description}\end{quote}
+aa?????????????

 \\

[joep (josef-pktd)]

I two docstrings that killed the latex compilation had a missing summary line and started with the parameter header

in RegressionResults:

    def summary(self, yname=None, xname=None):
        """
        Parameters
        -----------

in family NegativeBinomial

    def deviance(self, Y, mu, scale=1.):
        """
        Parameters
        -----------

the Parameters header was included in the class docstring method summary and this was illegal latex inside a tabular.

after adding two missing summary lines, pdflatex builds without stopping
fixed in trunk, but not committed yet

If we want to get a nicer pdf file, we have to figure out some sphinx options for TOC, index, chapter numbering, ....