[Python-Dev] The docs, reloaded
Georg Brandl
g.brandl at gmx.net
Tue May 22 10:39:22 CEST 2007
Armin Ronacher schrieb:
> Hoi,
>
> Fred L. Drake, Jr. <fdrake <at> acm.org> writes:
>
>>
>> On Monday 21 May 2007, A.M. Kuchling wrote:
>> > Disadvantages:
>> >
>> > * reST markup isn't much simpler than LaTeX.
>>
>> * reST doesn't support nested markup, which is used in the current
>> documentation.
>
> For a lightweight markup language that is human readable (which rst certainly
> is) the syntax is surprisingly powerful. You can nest any block tag and I'm not
> sure how often you have to nest roles and stuff like that. The goal of the new
> docs is a less complex syntax and currently nothing beats reStructuredText in
> terms of readability and possibilities.
Also, I believe there are efforts within docutils to make a limited amount of
nested inline markup possible. Lea will probably be able to provide details.
cheers,
Georg
More information about the Python-Dev
mailing list