#3734: document complex coercing behavior better.

diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index 5b6f1e82436333ec0e13d3e92d0e7a8a920d2bb0..37640e5073f369e452ebd47e787c94b07d16c6d0 100644 (file)
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -2252,7 +2252,8 @@ will not be supported.
 
   In the current implementation, the built-in numeric types :class:`int`,
   :class:`long` and :class:`float` do not use coercion; the type :class:`complex`
-  however does use it.  The difference can become apparent when subclassing these
+  however does use coercion for binary operators and rich comparisons, despite
+  the above rules.  The difference can become apparent when subclassing these
   types.  Over time, the type :class:`complex` may be fixed to avoid coercion.
   All these types implement a :meth:`__coerce__` method, for use by the built-in
   :func:`coerce` function.