[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 mailing list