PEP 287: reStructuredText Standard Docstring Format

Aahz aahz at pythoncraft.com
Sat Apr 20 20:33:06 EDT 2002


In article <iyAq8.29179$n4.5840426 at newsc.telia.net>,
Fredrik Lundh <fredrik at pythonware.com> wrote:
>Delaney, Timothy wrote:
>>
>> The whole point is that this is the *input*, optionally to produce another
>> format, and is also human-readable in the source code (or any other text
>> file).
>
>who cares, when it's not human-writable.

Mind providing at least some anecdotal evidence for this assertion?  I'm
speaking as someone who uses vi to write XML and HTML with some
proficiency, but who does find XML/HTML slightly awkward.  I have no
experience yet with reST.
-- 
Aahz (aahz at pythoncraft.com)           <*>         http://www.pythoncraft.com/

What if there were no rhetorical questions?



More information about the Python-list mailing list