[Twisted-Python] Re: [Twisted-commits] r17664 - This was pre-UQDS code, so in making the transition I have to add lots of docs
golux at comcast.net
Mon Jul 24 22:03:12 EDT 2006
Jonathan Lange wrote:
> The standard is definitely unclear.
> I don't have strong feelings about how docstrings should be formatted.
> However I would prefer it if we used PEP 257 formatting.
Just for the record, the multi-line docstring format
Blah blah blah blah blah
is consistent with PEP 257's recommendations.
> Also, I strongly object to using
> for one line docstrings.
It doesn't bother me, but
doesn't either, for one-liners.
More information about the Twisted-Python