[Doc-SIG] epydoc reST markup for stdlib docstrings

[Michael Foord]

On 14/04/2010 17:53, Georg Brandl wrote:
> Am 14.04.2010 15:25, schrieb Michael Foord:
>    
>> On 14/04/2010 17:24, Fred Drake wrote:
>>      
>>> On Wed, Apr 14, 2010 at 11:13 AM, Ralf Gommers
>>> <ralf.gommers at googlemail.com>   wrote:
>>>
>>>        
>>>> You're a core developer (I think). But for the *average* user, do you really
>>>> think tags are fine? Earlier in this thread there was a mention of people
>>>> that love to read XML. I'm exaggerating a bit of course, but this is
>>>> similar. Whitespace beats tags for readability.
>>>>
>>>>          
>>> All consumers of docstrings are programmers.  Maybe only by necessity,
>>> but they are.
>>>
>>> Frankly, terminals and any other window just can't handle all that
>>> much text on the typical horizontal monitor, placing a premium on
>>> vertical whitespace.
>>>
>>> Widescreen is good for movies, but sucks for general-purpose computer monitors.
>>>
>>>        
>> They're great if you turn them sideways though...
>>      
> Uh, or just use an editor that can usefully display three files side-by-side.
>
>    
Like Wing?

http://skitch.com/fuzzyman/n6581/wing-ide-vera-backend.wpr-views.py-vera-mailing

Michael

> not-name-dropping-ly y'rs,
> Georg
>
> _______________________________________________
> Doc-SIG maillist  -  Doc-SIG at python.org
> http://mail.python.org/mailman/listinfo/doc-sig
>    


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