[Doc-SIG] epydoc reST markup for stdlib docstrings

[Georg Brandl]

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.

not-name-dropping-ly y'rs,
Georg