[Python-Dev] Re: interlocking dependencies on the path to a release

[Phillip J. Eby]

At 06:35 PM 11/6/04 +0100, Martin v. Löwis wrote:
>Phillip J. Eby wrote:
>>If what you mean is that TeX itself does better formatting than e.g. the 
>>docutils PDF backend, I would note that there are two LaTeX backends for 
>>docutils: one a generic latex backend, and the other that's supposed to 
>>generate markup suitable for the current Python documentation toolchain.
>
>That still might not be sufficient. reST certainly uses a specific subset 
>of TeX's capabilities when generating LaTeX, so some features
>of TeX may simply be unaccessible when you have to stick to reST
>syntax.

There's a 'raw' directive that can be used for this:

.. raw:: latex

    \setlength{\parindent}{0pt}

The data will be ignored by non-latex backends.  Similarly, you may use raw 
HTML with 'raw:: html'.

See 
http://docutils.sourceforge.net/docs/ref/rst/directives.html#raw-data-pass-through