[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]

Duncan McGreggor wrote:
> Jean-Paul Calderone wrote:
> 
>> On Sun, 23 Jul 2006 19:11:04 -0600, Glyph Lefkowitz
>>> class Argument:
>>> +    """ Base-class of all objects that take values from Amp packets
>>> and convert
>>> +    them into objects for Python functions.
>>> +    """
>> Blech.  Does this style of docstring formatting make anyone else barf?
> 
> I'll cast my vote:
> 
> Yes, it does induce nausea. I actually can't stand it and much prefer
> your proposed syntax. In fact, my behavior verges on obsessive,

OK, it appears that the voting has begun in earnest ... I actually
thought everyone would agree with Jp, but since they don't
(shocking!) ... I also vote for the

"""
Blah ...
"""

format (which I have always used).

Steve