writing plain text to multi page pdf

Jouni K. Sepp�nen <jks@...278...> 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

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 <jks@...278...> 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