Re: [matplotlib-devel] writing plain text to multi page pdf

[Jouni K. S. <jk...@ik...>]

Jouni K. Seppänen <jk...@ik...> 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?

-- 
Jouni K. Seppänen
http://www.iki.fi/jks