I've been bitten by this before, too.

The current implementation of "make.py clean" is probably a remnant of 
an earlier iteration of the doc build system that really did scatter 
files all over the place.  I made some changes a few months ago to try 
to restrict "built" files to the build and examples directories.  I can 
go ahead and fix "clean" to just be a couple of "removedirs".  But I'll 
wait a day or so just to see if anyone can think of a good reason not to.

Mike

Jouni K. Seppänen wrote:
> Jouni K. Seppänen <j...@iki.fi> writes:
>
>   
>>> The current interface looks easy enough to use -- it just needs to be
>>> advertised better, eg in a FAQ ( I had to read the source to find it,
>>> which works well enough for me, but not for everyone).  If you want to
>>> write one up, I'll add it to the docs.
>>>       
>> I seem to recall that the ReST docstring of backend_pdf.PdfPages was
>> included in the documentation at some point, but it is missing now from
>> <http://matplotlib.sourceforge.net/api/index_backend_api.html>. 
>>     
>
> I added some documentation again. Here's what I think probably happened
> the previous time: I added doc/api/backend_pdf_api.rst and edited
> doc/api/index_backend_api.rst, built the documentation locally to check
> that it looks OK, then at some point ran "make.html clean" to debug some
> doc problems... which destroyed my uncommitted doc changes by running
> svn-clean.
>
> How about changing "make.html clean" to be more careful? After building
> the docs, "svn status" shows the following unversioned files:
>
> ?       build
> ?       examples
> ?       _static/matplotlibrc
> ?       _templates/gallery.html
>
> "svn status --no-ignore" adds a lot of *.pyc files in various
> subdirectories. Would removing all of these achieve the expected
> cleaning effect?
>
>   

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


------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day 
trial. Simplify your report design, integration and deployment - and focus on 
what you do best, core application coding. Discover what's new with 
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

Reply via email to