[Python-Dev] Re: interlocking dependencies on the path
to a release
Phillip J. Eby
pje at telecommunity.com
Sat Nov 6 17:34:55 CET 2004
At 11:12 AM 11/6/04 +0100, Martin v. Löwis wrote:
>Phillip J. Eby wrote:
>>IMO a better long term option might be to use the Python docutils and
>>migrate to reStructuredText, since there are a bevy of backends available
>>for latex, PDF, HTML, etc. They would probably need more work before
>>they'll be suitable to handle the entire doc generation process, though.
>I'm not convinced this would be a good idea. Having TeX as the primary
>source allows to produce well-formatted printed documentation.
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.
More information about the Python-Dev