Re: epydoc reST markup for stdlib docstrings

Michael Foord <[email protected]> Wed, 14 Apr 2010 17:59:24 +0200

Newsgroups	gmane.comp.python.documentation
Message-ID	<[email protected]>

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  -  [email protected]
> http://mail.python.org/mailman/listinfo/doc-sig
>    


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

_______________________________________________
Doc-SIG maillist  -  [email protected]
http://mail.python.org/mailman/listinfo/doc-sig