Documentation of "decimal" library

[roman-huk]

Documentation of "decimal" library - Context.logical_??? methods

There is a understatement in docstring of decimal.Context.logical_xxx methods. All arguments should be instances of decimal.Decimal, but consisting only of binary digits only (i.e. "0" and "1"). If the number is not an integer or consists of digits other than 0 and 1, an exception is thrown:

>>> import decimal
>>> ctx = decimal.getcontext()
>>> ctx.logical_or(decimal.Decimal(15), decimal.Decimal(22))
Traceback (most recent call last):
  File "<pyshell#71>", line 1, in <module>
    ctx.logical_or(Decimal(15), Decimal(22))
decimal.InvalidOperation: [<class 'decimal.InvalidOperation'>]

I think it would be good to describe this behavior explicitly.

Linked PRs

• gh-102431: clarify constraints on arguments of logical_xxx methods #102836
• [3.14] gh-102431: Clarify constraints on operands of Decimal logical operations (GH-102836) #140105
• [3.13] gh-102431: Clarify constraints on operands of Decimal logical operations (GH-102836) #140106

[skirpichev]

All arguments should be instances of decimal.Decimal, but consisting only of binary digits only (i.e. "0" and "1").

Also exponent and sign should be zero, see sphinx docs.