[docs] [issue12185] Decimal documentation lists "first" and "second" arguments, should be "self" and "other"

Eric V. Smith report at bugs.python.org
Sat May 28 16:39:21 CEST 2011


Eric V. Smith <eric at trueblade.com> added the comment:

I'm not talking about the method itself but rather the descriptive text. For example:

copy_sign(other)

    Return a copy of the first operand with the sign set to be the same as the sign of the second operand. 

There is no second operand, unless you consider "self" the first and "other" the second. Which of course is true inside the method, but it reads oddly as a description of the method from the outside.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue12185>
_______________________________________


More information about the docs mailing list