[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
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
"""Blah."""
doesn't either, for one-liners.
More information about the Twisted-Python
mailing list