From 1a6b73dcdf1c45d3c77959ae8a2e9ea38ebe57b2 Mon Sep 17 00:00:00 2001
From: Raymond Hettinger <python@rcn.com>
Date: Fri, 17 Apr 2009 20:55:52 +0000
Subject: Add porting notes.

---
 Doc/whatsnew/3.1.rst | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/Doc/whatsnew/3.1.rst b/Doc/whatsnew/3.1.rst
index 1fe2de8..e4d2a24 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
+    **********************************************************************
-- 
cgit v0.12