[Python-Dev] query: docstring formatting in python distutils code

Antoine Pitrou solipsis at pitrou.net
Wed Jul 7 23:22:34 CEST 2010


On Wed, 07 Jul 2010 22:58:47 +0200
Martin Geisler <mg at lazybytes.net> wrote:

> "C. Titus Brown" <ctb at msu.edu> writes:
> 
> > I guess docutils isn't in the stdlib (should it be?) or else we could
> > modify 'help' to use it to prepare a straight text formatting.
> 
> We're using light-weight ReST markup in the Mercurial help texts and
> transform it into straight text upon display in the terminal.
> 
> We want no external dependencies for Mercurial, so I wrote a "mini ReST"
> parser in about 400 lines of code. It cheats a lot and can only handle
> simple constructs... but maybe it would be interesting for Python's
> help? You find it here:
> 
>   http://selenic.com/hg/file/tip/mercurial/minirst.py

Given that Mercurial is GPL, this is probably of no use to us,
unfortunately.

Regards

Antoine.




More information about the Python-Dev mailing list