[SciPy-dev] documentation

[Alan Isaac]

Perhaps this is relevant to the documentation discussion.

Thanks to David Goodger, it is now (in CVS and snapshot)
possible to more easily use reST to produce documentation
containing display math in mutliple formats.  Format
generation is easily automated.

What is new: the raw directive accepts mulitiple arguments.
E.g., 
.. raw:: latex html
This means that a single itex display can be passed
to multiple writers.

Aside from that, everything is the same:
One step conversions:
reST -> LaTeX with display math: use 'raw' directive
Two step conversions:
PDF:   reST -> LaTeX -> PDF
        (second step with pdflatex or other routes)
XHTML+MathML:   reST -> HTML+itex -> XHTML/MathML
        (second step with itex2mml)

Background:
see the thread  "multiple arguments for raw directive" at
  http://sourceforge.net/mailarchive/forum.php?forum=docutils-users

Alan Isaac