[Zope-dev] zope.sendmail grantma-retryfixes branch review

Chris Withers chris at simplistix.co.uk
Thu Mar 20 18:33:10 EDT 2008


Marius Gedminas wrote:
>> +        """Process results of an SMTP error
>> +           returns True to indicate break needed"""
> 
> The standard docstring convention is to do this:
> 
>            """Process results of an SMTP error.
> 
>            Returns True to indicate break needed.
>            """

This standard sucks.

             """
             Process results of an SMTP error.

             Returns True to indicate break needed.
             """

...is much more readable. If there's a tool that does something silly 
with this, fix the tool.

> Also, it's conventional to leave two blank lines between class and
> interface declarations.  (PEP-8 says this.)

What does this actually mean? I couldn't follow from your example.

Other than that, completely agree with everything you said :-)

cheers,

Chris

-- 
Simplistix - Content Management, Zope & Python Consulting
            - http://www.simplistix.co.uk


More information about the Zope-Dev mailing list