Latex Documentation build errors - possibly scale_docs

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

I'm pretty sure this is fixed in svn -- I made some docstring edits to
fix this bug a while back. I've tried to emphasize that the docs are
a very fast moving target, slated for release end of summer, so should
be considered bleeding-edge only. In other words, if you expect them
to build, you should be ready to use mpl svn and/or svn from any of
the packages they depend on (sphinx, pygments, ....)

JDH

···

On Mon, Jun 30, 2008 at 8:40 PM, Chris Walker <chrisw@...235...> wrote:

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:

Hi Chris,

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

here the same with 0.91.2

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=@\[\]]

?

I got this fixed with:

MATPLOTLIBDATA=../lib/matplotlib/mpl-data/
PYTHONPATH=../build/lib.linux-x86_64-2.5/ ./make.py

(discard the PYTHONPATH) in the matplotlib debian trunk.

Cheers,
Sandro

···

--
Sandro Tosi (aka morph, Morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

You need to install 0.98.svn to work with the sphinx-based docs.

Darren

···

On Tuesday 01 July 2008 08:21:10 am Sandro Tosi wrote:

Hi Chris,

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

here the same with 0.91.2

Sorry, mistype: I'm using 0.98.2 (the source only release created fro Debian).

···

On Tue, Jul 1, 2008 at 14:42, Darren Dale <dsdale24@...149...> wrote:

On Tuesday 01 July 2008 08:21:10 am Sandro Tosi wrote:

Hi Chris,

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

here the same with 0.91.2

You need to install 0.98.svn to work with the sphinx-based docs.

--
Sandro Tosi (aka morph, Morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

Looks like John fixed it, latex was successful here.

Darren

···

On Tuesday 01 July 2008 08:44:32 am Sandro Tosi wrote:

On Tue, Jul 1, 2008 at 14:42, Darren Dale <dsdale24@...149...> wrote:
> On Tuesday 01 July 2008 08:21:10 am Sandro Tosi wrote:
>> Hi Chris,
>>
>> > I'm using the svn version of the docs on a debian system with
>> > matplotlib 0.98.1 and sphinx 0.4.
>>
>> here the same with 0.91.2
>
> You need to install 0.98.svn to work with the sphinx-based docs.

Sorry, mistype: I'm using 0.98.2 (the source only release created fro
Debian).