[Doc-SIG] epydoc reST markup for stdlib docstrings

Georg Brandl g.brandl at gmx.net
Wed Apr 14 17:53:48 CEST 2010

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,

More information about the Doc-SIG mailing list