[Twisted-Python] Re: [Twisted-commits] r17664 - This was pre-UQDS code, so in making the transition I have to add lots of docs

Stephen Waterbury 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
> """
> Blah.
> """
> for one line docstrings.

It doesn't bother me, but


doesn't either, for one-liners.

More information about the Twisted-Python mailing list