(original) (raw)
On Mon, Sep 23, 2013 at 3:01 PM, Terry Reedy <tjreedy@udel.edu> wrote:
> IIRC in the Java world you \*have\* toMy take is that 'Returns' describes to the programmer what the function (interpreter) does, while 'Return' says what the programmer says to the interpreter when using the function. I strongly prefer the directive form.
use 'Returns', but I don't buy the argument from nit-picky grammarians
that leads to this rule. (It's something about the documentation not
being a command. But English is more flexible than that.)
+1
I don't think "Returns bar." is a valid English sentence because it lacks subject. I would not mind
def foo():
"""returns bar"""
which I would read as "Function foo() returns bar," but in this case "returns" should be in lower case.