To whom it may concern:

The documentation for numbers.Integral reports incorrect abstract method requirements for numbers.Integral.

The documentation for numbers.Integral (in both Python 2.7 and Python 3.2) states:

Defaults for operations <<, >>, &, ^, |, and ~ are not provided, and a look at the source code shows that they are all given as abstract methods. In addition, in Python 2.x, numbers.Integral adds an abstract conversion to long. This is not recorded in the documentation.

Originally, I was going to report this as a bug, because PEP 3141 (the PEP that specifies the numbers module) goes so far as to include the <<, >>, &, ^, |, and ~ in the source code for numbers.Integral. It looks like somebody already had reported this years ago, however, to python-dev with Issue 3056. The issue was never resolved, but has since been closed.

Since the development community does not seem interested in adding these features, the features should be removed from documentation.

Thank you for your time,