[SciPy-Dev] Problem building html docs

[Warren Weckesser]

David Goldsmith wrote:
> On Mon, May 24, 2010 at 9:50 AM, Warren Weckesser 
> <warren.weckesser at enthought.com 
> <mailto:warren.weckesser at enthought.com>> wrote:
>
>     First, many thanks to Ralf Gommers for his work on the documentation
>     over the weekend.
>
>     I now have a problem building the docs.  Something is wrong with
>     doc/source/fftpack.rst.  I think the change in r6407 messed up the
>     restructured text.  
>
>
> It's something more complicated than that (though exactly what I don't 
> know): a) fftpack.rst is a semi-autogenerated document, and what's 
> there is not returning any errors in the Wiki, and b) if I'm reading 
> your error msg. correctly, it's reporting the error is on line 152, 
> but that must be an autogenerated line cause the rst source only has 
> 79 lines.  So it sounds like whatever is doing the autogeneration is 
> causing some sort of problem...
>

I don't know what is or was autogenerated, but in the latest trunk 
(r6410), fftpack.rst has 223 lines.  In r6407, a block of rst was 
inserted in the file.  I suspect something went wrong there.


Warren

> DG
>  
>
>     When I run 'make html' in the doc directory, I get:
>
>     <snip>
>     reading sources... [  0%]
>     fftpack
>     reST markup error:
>     /Users/warren/scipy_src/doc/source/fftpack.rst:152: (SEVERE/4) Title
>     level inconsistent:
>
>     Fast Fourier transforms
>     =======================
>     make: *** [html] Error 1
>
>
>
>     Warren
>
>     _______________________________________________
>     SciPy-Dev mailing list
>     SciPy-Dev at scipy.org <mailto:SciPy-Dev at scipy.org>
>     http://mail.scipy.org/mailman/listinfo/scipy-dev
>
>
>
>
> -- 
> Mathematician: noun, someone who disavows certainty when their 
> uncertainty set is non-empty, even if that set has measure zero.
>
> Hope: noun, that delusive spirit which escaped Pandora's jar and, with 
> her lies, prevents mankind from committing a general suicide.  (As 
> interpreted by Robert Graves)
> ------------------------------------------------------------------------
>
> _______________________________________________
> SciPy-Dev mailing list
> SciPy-Dev at scipy.org
> http://mail.scipy.org/mailman/listinfo/scipy-dev
>