#2147: PEP 237 changes to overflow behavior.
diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst
index be2b581..01b54b3 100644
--- a/Doc/library/exceptions.rst
+++ b/Doc/library/exceptions.rst
@@ -254,11 +254,10 @@
Raised when the result of an arithmetic operation is too large to be
represented. This cannot occur for long integers (which would rather raise
- :exc:`MemoryError` than give up). Because of the lack of standardization of
- floating point exception handling in C, most floating point operations also
- aren't checked. For plain integers, all operations that can overflow are
- checked except left shift, where typical applications prefer to drop bits than
- raise an exception.
+ :exc:`MemoryError` than give up) and for most operations with plain integers,
+ which return a long integer instead. Because of the lack of standardization
+ of floating point exception handling in C, most floating point operations
+ also aren't checked.
.. exception:: ReferenceError
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 5894957..5288212 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -406,8 +406,7 @@
operations and higher than the comparisons; the unary operation ``~`` has the
same priority as the other unary numeric operations (``+`` and ``-``).
-This table lists the bit-string operations sorted in ascending priority
-(operations in the same box have the same priority):
+This table lists the bit-string operations sorted in ascending priority:
+------------+--------------------------------+----------+
| Operation | Result | Notes |
@@ -440,12 +439,11 @@
Negative shift counts are illegal and cause a :exc:`ValueError` to be raised.
(2)
- A left shift by *n* bits is equivalent to multiplication by ``pow(2, n)``
- without overflow check.
+ A left shift by *n* bits is equivalent to multiplication by ``pow(2, n)``. A
+ long integer is returned if the result exceeds the range of plain integers.
(3)
- A right shift by *n* bits is equivalent to division by ``pow(2, n)`` without
- overflow check.
+ A right shift by *n* bits is equivalent to division by ``pow(2, n)``.
.. _typeiter: