Thread: [matplotlib-devel] Latex Documentation build errors - possibly scale_docs

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

When building the docs using make.py in the doc directory, Latex hangs. 

I'm using the svn version of the docs on a debian system with
matplotlib 0.98.1 and sphinx 0.4.

Latex hangs ( but can be made to continue by pressing return) at the
following point:

Underfull \hbox (badness 10000) in paragraph at lines 17819--17822
[]\T1/txr/m/n/10.95 A dic-tio-nary with key-word ar-gu-ments ac-cepted by the
[181] [182]
Underfull \hbox (badness 10000) in paragraph at lines 18251--18254
[][][]\T1/txtt/m/n/10.95 semilogx()[][] \T1/txr/m/n/10.95 sup-ports all the key
-word ar-gu-ments of [][]\T1/txtt/m/n/10.95 plot()[][] \T1/txr/m/n/10.95 and
[183]
Overfull \hbox (92.42264pt too wide) in paragraph at lines 18443--18444
[][] 

Underfull \hbox (badness 10000) in paragraph at lines 18458--18461
[][][]\T1/txtt/m/n/10.95 semilogy()[][] \T1/txr/m/n/10.95 sup-ports all the key
-word ar-gu-ments of \T1/txtt/m/n/10.95 plot() \T1/txr/m/n/10.95 and
[184]
Overfull \hbox (92.42264pt too wide) in paragraph at lines 18650--18651
[][] 
[185]
Overfull \hbox (92.41579pt too wide) in paragraph at lines 18760--18761
[][] 
[186]
Overfull \hbox (92.45047pt too wide) in paragraph at lines 19150--19151
[][] 
[187]
Overfull \hbox (92.45047pt too wide) in paragraph at lines 19351--19352
[][] 
[188] [189]

! LaTeX Error: Too deeply nested.

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

l.19440 \begin{Verbatim}[commandchars=@\[\]]

? 

This corresponds to the following latex code where a second
\begin{quote} is opened before closing the first. Commenting out one
of these \begin{quote} (and the corresponding \end{quote} fixes the
problem:

   Set the scaling of the y-axis: `linear' | `log' | `symlog'

   ACCEPTS: {[}'linear' | `log' | `symlog'{]}

   Different kwargs are accepted, depending on the scale:
   `linear'
   \begin{quote}

   `log'
   \begin{quote}
   \begin{description}
   \item[\emph{basex}/\emph{basey}:]
   The base of the logarithm

   \item[\emph{subsx}/\emph{subsy}:]
   Where to place the subticks between each major tick.
   Should be a sequence of integers.  For example, in a log10
   scale:

This latex seems to be generated by the following lines in axes.py -
but I haven't worked out how to fix it.

    def set_yscale(self, value, **kwargs):
        """
        call signature::

          set_yscale(value)

        Set the scaling of the y-axis: %(scale)s

        ACCEPTS: [%(scale)s]

        Different kwargs are accepted, depending on the scale:
        %(scale_docs)s
        """
        self.yaxis.set_scale(value, **kwargs)
        self.autoscale_view()
        self._update_transScale()

    set_yscale.__doc__ = cbook.dedent(set_yscale.__doc__) % {
        'scale': ' | '.join([repr(x) for x in mscale.get_scale_names()]),
        'scale_docs': mscale.get_scale_docs().strip()}

Chris