Fredrik Lundh <fred...@effbot.org> added the comment: > 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. ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue6488> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com