From: Georg Brandl <georg@python.org>
Date: Fri, 13 Feb 2009 10:44:17 +0000 (+0000)
Subject: #3734: document complex coercing behavior better.
X-Git-Tag: v2.7a1~2039
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9834dd72bc9d73bc54295af6f36b8d76ad8ba245;p=python

#3734: document complex coercing behavior better.
---

diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index 5b6f1e8243..37640e5073 100644
--- 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.