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

[Eric V. Smith]

New submission from Eric V. Smith <eric at trueblade.com>:

http://docs.python.org/library/decimal.html

In 9.4.2, "Decimal objects", some of the methods mention the first and second parameters, when really it should be "self" and the argument, usually named "other" and sometimes something more specific. These include:

compare_total
copy_sign
next_toward
quantize (argument is exp)
rotate
scaleb
shift

It looks this is left over from where the same-named functions are described in the "Context objects" section.

----------
assignee: docs at python
components: Documentation
messages: 136947
nosy: docs at python, eric.smith
priority: normal
severity: normal
status: open
title: Decimal documentation lists "first" and "second" arguments, should be "self" and "other"
versions: Python 2.7

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