On Saturday 31 May 2008 11:44:34 pm Darren Dale wrote:
> On Saturday 31 May 2008 10:19:47 pm John Hunter wrote:
> > On Sat, May 31, 2008 at 9:01 PM, Fernando Perez <[EMAIL PROTECTED]>
>
> wrote:
> > > I don't know if you are so in the middle of things that you'd rather
> > > not get bug reports on this for a while.  If that's the case I'll wait
> > > until the dust settles a bit.
> >
> > Well, we definitely want our docs to build so we're happy to get the
> > feedback -- sometimes it's a simple matter of a dev forgetting to
> > commit a critical file.  I am getting this error too.  It appears to
> > be a bug in the pyplot docstrings -- Darren, perhaps you haven't
> > committed all you recent changes?
>
> All my changes had already been committed. I had only been creating html
> (./make.py html) and it looks like some of the tables I have been creating
> dont agree with latex. I'll fix it tomorrow, but in the meantime, please
> just make html.

Alright, I've tracked down the source of these two errors. Sphinx can not 
create tables in latex that have cells spanning multiple rows or multiple 
columns. Maybe it is a limitation of latex, I'm not sure, I don't have my 
latex books handy. But it looks like tables with row- or column-spanning 
cells are henceforth verboten.

I've updated pyplot_api.rst in svn so it is basically empty and will not cause 
anyone trouble while I fix the broken tables.

> > But if I remove entirely the pyplot
> > api doc which is causing this problem, I get lots of other errors
> > along the lines of those shown below.  Is this a latex or sphinxext
> > config error?
> >
> > [8 <./pyplot_formatstr.png> <./pyplot_three.png>] [9] [10]
> > <pyplot_two_subplots.png, id=368, 578.16pt x 433.62pt>
> > <use pyplot_two_subplots.png> <use pyplot_two_subplots.png> [11
> > <./pyplot_two_s ubplots.png>] <pyplot_text.png, id=375, 578.16pt x
> > 433.62pt>
> > <use pyplot_text.png> <use pyplot_text.png> [12 <./pyplot_text.png>] [13]
> > [14]
> > Chapter 2.
> > [15] [16]
> > ! Undefined control sequence.
> > <recently read> \mathbb
> >
> > l.954 \end{tabulary}

I tracked this down by checking the contents of the generated 
build/latex/Matplotlib.tex, line 954. It is from the following code from 
mathtext.rst:

> When using the STIX fonts, you also have the choice of:
>
>     ================ =================================
>     Command          Result
>     ================ =================================
>     ``\mathbb``      :math:`\mathbb{Blackboard}`
>     ``\mathcircled`` :math:`\mathcircled{Circled}`
>     ``\mathfrak``    :math:`\mathfrak{Fraktur}`
>     ``\mathsf``      :math:`\mathsf{sans-serif}`
>     ================ =================================


I'm not sure this is being properly rendered in the HTML output for me, 
either. Mike, are you able to compile this into a pdf on your machine, and if 
so, would you tell us how to configure STIX support? I commented this block 
out in svn for now.

Cheers,
Darren

-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

Reply via email to