Re: [matplotlib-devel] Doc changes

Ok.  Based on your success report, I'll go ahead and merge this to trunk.

Sandro: please let me know if these changes break anything in your 
package build scripts.

Mike

John Hunter wrote:
> On Wed, Dec 17, 2008 at 10:52 AM, Michael Droettboom <md...@st...> wrote:
>
>   
>> SUMMARY: Since so much has changed in the doc build, I need help testing
>> it in other environments -- particularly because LaTeX docs have never
>> built on my machine.  I've done this on the branch, so the Debian guys
>> can run with it, but it's a little risky, due to the depth of cuts I had
>> to make.  I've tested successfully with Sphinx 0.5.1 and docutils 0.5.
>> Please clean your checkout and then build for yourself and let me know
>> if you see anything funny.
>>
>> DETAILS:
>>
>> You can now do
>>
>>  python make.py --small html
>>
>> which will only generate low-res PNGs for the html build.  "--small" has
>> no effect for pdf build.
>>     
>
> Very nice -- it seems like you've solved some of the unneeded rebuild
> problems we had been having too, because successive calls to make html
> seem to go much faster now.
>
>   
>> gen_gallery now runs in a sphinx callback (env-updated) after all the
>> input files have been parsed, (and all the plots have been generated),
>> but right before the html or latex is written out.  This eliminates the
>> need to run the build multiple times, and the need to have an
>> autogenerated file (doc/_templates/gallery.html) in SVN.  The thumbnail
>> downsampling is now done as part of this step, rather than as part of
>> plot_directive, since it isn't needed for LaTeX builds.
>>     
>
> I have built the pdf on a linux environment and the html on a linux
> and os x environment, so it is looking good.  I've built with and w/o
> the --small
>
>   
>> Lastly, since files are in many different places, the Sourceforge site
>> should probably be cleaned (if it isn't automatically already) to ensure
>> we don't go over quota.
>>     
>
> Will do -- some time ago I emailed the sf support people and asked for
> a quota increase, and they replied that there wasn't really a quota
> anymore, but I will clean it so we minimize our footprint.  And it
> they ever do get anxious about the size we consume, we can always go
> --small :-)
>
> Thanks again, sorry that was such a bear.  Hopefully the plot
> directive emerges stronger from the carnage.
>
> JDH
>   

-- 
Michael Droettboom
Science Software Branch
Operations and Engineering Division
Space Telescope Science Institute
Operated by AURA for NASA