[Python-Dev] Re: interlocking dependencies on the path to a
"Martin v. Löwis"
martin at v.loewis.de
Sat Nov 6 11:18:49 CET 2004
Phillip J. Eby wrote:
> More control of what? I thought that reST was specifically designed to
> accommodate all of the Python-specific markup we're using in the latex
How do you create a module index and a "global" index in reST?
How do you express document inclusion (in the spirit of \input)?
> As a matter of language expressiveness, as far as I can tell, reST
> accomodates marking up both short strings and long blocks, with
> application-specific markup, so I don't really understand why there
> shouldn't be a largely 1:1 mapping between the markup systems.
It's not about source code display. It is about the other 200
typographic features that we use in the Python documentation.
> * Conversion could be very time consuming, for the parts that can't be
If the conversion cannot be fully automatic, that would indicate that
there will be a loss of information. Likely, this loss is unacceptable.
> Anyway, I thought the whole point behind the docutils initiative was to
> create a doc format that could be used anywhere Python needs docs, ala
> Perl's POD.
I'm still uncertain what the point behind the docutils initiative is.
More information about the Python-Dev