[Doc-SIG] epydoc reST markup for stdlib docstrings

Barry Warsaw barry at python.org
Wed Apr 14 17:41:42 CEST 2010


On Apr 14, 2010, at 04:56 PM, Michael Foord wrote:

>I would say that reading docstrings in a terminal is the *main* use case 
>- but that is why I tend to value the vertical space highly and 
>personally prefer the less verbose way.

I agree about the vertical whitespace when reading in the terminal.  You also
want compact output for online docs too though.

I'm tempted to say that whatever Georg implements in Sphinx is good enough for
me. :)

-Barry
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/doc-sig/attachments/20100414/68641d66/attachment.pgp>


More information about the Doc-SIG mailing list