[Python-Dev] The docs, reloaded (original) (raw)

Georg Brandl g.brandl at gmx.net
Tue May 22 10:39:22 CEST 2007

Armin Ronacher schrieb:

Hoi,

Fred L. Drake, Jr. <fdrake 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