From: Raymond Hettinger <python@rcn.com>
Date: Fri, 17 Apr 2009 20:55:52 +0000 (+0000)
Subject: Add porting notes.
X-Git-Tag: v3.1b1~259
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=1a6b73dcdf1c45d3c77959ae8a2e9ea38ebe57b2;p=python

Add porting notes.
---

diff --git a/Doc/whatsnew/3.1.rst b/Doc/whatsnew/3.1.rst
index 1fe2de8724..e4d2a24286 100644
--- a/Doc/whatsnew/3.1.rst
+++ b/Doc/whatsnew/3.1.rst
@@ -431,3 +431,32 @@ Changes to Python's build process and to the C API include:
 * Deprecated :cfunc:`PyNumber_Int`.  Use :cfunc:`PyNumber_Long` instead.
 
   (Contributed by Mark Dickinson; :issue:`4910`.)
+
+Porting to Python 3.1
+=====================
+
+This section lists previously described changes and other bugfixes
+that may require changes to your code:
+
+* The new floating point string representations can break existing doctests.
+  For example::
+
+    def e():
+        '''Compute the base of natural logarithms.
+
+        >>> e()
+        2.7182818284590451
+
+        '''
+        return sum(1/math.factorial(x) for x in reversed(range(30)))
+
+    doctest.testmod()
+
+    **********************************************************************
+    Failed example:
+        e()
+    Expected:
+        2.7182818284590451
+    Got:
+        2.718281828459045
+    **********************************************************************