[Doc-SIG] epydoc reST markup for stdlib docstrings

Michael Foord fuzzyman at voidspace.org.uk
Wed Apr 14 17:59:24 CEST 2010


On 14/04/2010 17:41, Barry Warsaw wrote:
> 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. :)
>    

I completely agree that Georg is the man to take this forward and 
complete the task... :-)

Michael

> -Barry
>    
>
>
> _______________________________________________
> Doc-SIG maillist  -  Doc-SIG at python.org
> http://mail.python.org/mailman/listinfo/doc-sig
>    


-- 
http://www.ironpythoninaction.com/

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/doc-sig/attachments/20100414/93f1e1a7/attachment.html>


More information about the Doc-SIG mailing list