Author effbot
Recipients MLModel, effbot, eric.araujo, flox, georg.brandl, jaraco, r.david.murray
Date 2010-04-01.12:02:33
SpamBayes Score 0.00410207
Marked as misclassified No
Message-id <1270123355.34.0.146210893617.issue6488@psf.upfronthosting.co.za>
In-reply-to
Content
> As per PEP 257, “Returns” should become “Return” (it’s a command, not a description).

Upstream ET uses JavaDoc conventions, where the conventions are
designed by technical writers, not hackers.  In JavaDoc, descriptions
are 3rd person declarative (after all, the documentation describes
what the function does, not what you want it to do).

http://java.sun.com/j2se/javadoc/writingdoccomments/

The incompatibilities with Python's NIH-standards are unfortunate, but
that's the way it is.
History
Date User Action Args
2010-04-01 12:02:35effbotsetrecipients: + effbot, georg.brandl, jaraco, eric.araujo, MLModel, r.david.murray, flox
2010-04-01 12:02:35effbotsetmessageid: <1270123355.34.0.146210893617.issue6488@psf.upfronthosting.co.za>
2010-04-01 12:02:34effbotlinkissue6488 messages
2010-04-01 12:02:33effbotcreate