This is an archival dump of old wiki content --- see scipy.org for current material

Generating PDF documentation

gendocs.py is a very simple script that can generate documentation (in PDF format) from docstrings of !NumPy/!SciPy modules using pdfLaTeX.

It depends on pyparsing (http://pyparsing.wikispaces.com) by Paul McGuire.

There is no installation, just run the gendocs.py script. Title page templates are in 'pages' directory.

Run './gendocs.py --help' to see options.

Download: gendocs-00.00.02.tar.gz

Example

Tested with

./gendocs.py -m 'numpy.lib.arraysetops'
./gendocs.py -m 'scipy.linsolve.umfpack'

- look at the documentation of those modules (SVN version) to see the necessary formatting. The info.py file in scipy/linsolve/umfpack/ was updated recently - revision 3601 of SciPy or later is needed for the second example to work.

Note: previous version (00.00.01) does not work properly on Python 2.3 (trivial bug).

Display

Example outputs:

SciPy: Generate_Documentation (last edited 2015-10-24 17:48:24 by anonymous)