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.