Fix misleading statement about mixed-type numeric comparisons (GH-18615) (GH-18737)

(cherry picked from commit 9f1cb1bb49476246de5d9ed5fe680301cf7f7571)

Co-authored-by: Mark Dickinson <dickinsm@gmail.com>

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 5e9b59eb84bbb95f622a65cda7776e5969cb21e7..c4c4ccd76d5a71b30032f3fbc550ec47d3863db3 100644 (file)
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -263,8 +263,10 @@ and imaginary parts.
 Python fully supports mixed arithmetic: when a binary arithmetic operator has
 operands of different numeric types, the operand with the "narrower" type is
 widened to that of the other, where integer is narrower than floating point,
-which is narrower than complex.  Comparisons between numbers of mixed type use
-the same rule. [2]_ The constructors :func:`int`, :func:`float`, and
+which is narrower than complex. A comparison between numbers of different types
+behaves as though the exact values of those numbers were being compared. [2]_
+
+The constructors :func:`int`, :func:`float`, and
 :func:`complex` can be used to produce numbers of a specific type.
 
 All numeric types (except complex) support the following operations (for priorities of

diff --git a/Misc/NEWS.d/next/Documentation/2020-02-23-13-26-40.bpo-39530._bCvzQ.rst b/Misc/NEWS.d/next/Documentation/2020-02-23-13-26-40.bpo-39530._bCvzQ.rst
new file mode 100644 (file)
index 0000000..b7a0252
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2020-02-23-13-26-40.bpo-39530._bCvzQ.rst
@@ -0,0 +1 @@
+Fix misleading documentation about mixed-type numeric comparisons.