gh-73487: Convert _decimal to use Argument Clinic (part 4)

[skirpichev]

• Issue: decimal: Use Argument Clinic #73487

[skirpichev]

Docstrings diff:

--- ref.txt 2025-08-20 12:30:34.001295564 +0300+++ patch.txt 2025-08-20 12:29:57.118168737 +0300@@ -108,13 +108,16 @@
| Methods defined here:
|
| Etiny(self, /)
- | Return a value equal to Emin - prec + 1, which is the minimum exponent value- | for subnormal results. When underflow occurs, the exponent is set to Etiny.+ | Return a value equal to Emin - prec + 1.+ |+ | This is the minimum exponent value for subnormal results. When+ | underflow occurs, the exponent is set to Etiny.
|
| Etop(self, /)
- | Return a value equal to Emax - prec + 1. This is the maximum exponent- | if the _clamp field of the context is set to 1 (IEEE clamp mode). Etop()- | must not be negative.+ | Return a value equal to Emax - prec + 1.+ |+ | This is the maximum exponent if the _clamp field of the context is set+ | to 1 (IEEE clamp mode). Etop() must not be negative.
|
| __copy__(self, /)
|
@@ -437,10 +440,12 @@
class Decimal(builtins.object)
| Decimal(value='0', context=None)
|
- | Construct a new Decimal object. 'value' can be an integer, string, tuple,- | or another Decimal object. If no value is given, return Decimal('0'). The- | context does not affect the conversion and is only passed to determine if- | the InvalidOperation trap is active.+ | Construct a new Decimal object.+ |+ | value can be an integer, string, tuple, or another Decimal object. If+ | no value is given, return Decimal('0'). The context does not affect+ | the conversion and is only passed to determine if the InvalidOperation+ | trap is active.
|
| Methods defined here:
|
@@ -454,12 +459,14 @@
| True if self else False
|
| __ceil__(self, /)
+ | Return the ceiling as an Integral.
|
| __complex__(self, /)
+ | Convert this value to exact type complex.
|
| __copy__(self, /)
|
- | __deepcopy__(self, object, /)+ | __deepcopy__(self, memo, /)
|
| __divmod__(self, value, /)
| Return divmod(self, value).
@@ -471,6 +478,7 @@
| float(self)
|
| __floor__(self, /)
+ | Return the floor as an Integral.
|
| __floordiv__(self, value, /)
| Return self//value.
@@ -524,7 +532,7 @@
| Return divmod(value, self).
|
| __reduce__(self, /)
- | Helper for pickle.+ | Return state information for pickling.
|
| __repr__(self, /)
| Return repr(self).
@@ -538,7 +546,8 @@
| __rmul__(self, value, /)
| Return value*self.
|
- | __round__(...)+ | __round__(self, ndigits=<unrepresentable>, /)+ | Return the Integral closest to self, rounding half toward even.
|
| __rpow__(self, value, mod=None, /)
| Return pow(value, self, mod).
@@ -550,7 +559,7 @@
| Return value/self.
|
| __sizeof__(self, /)
- | Size of object in memory, in bytes.+ | Returns size in memory, in bytes
|
| __str__(self, /)
| Return str(self).
@@ -562,6 +571,7 @@
| Return self/value.
|
| __trunc__(self, /)
+ | Return the Integral closest to x between 0 and x.
|
| adjusted(self, /)
| Return the adjusted exponent (exp + digits - 1) of the number.

[serhiy-storchaka]

LGTM. 👍

[AA-Turner]

Thanks!

A