whatsnew: 'U' mode deprecation (#15204).

diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
index d26cee64f013f6b7f04a1ff6d2cd921d09965fbe..4a65b890238fbd1cc5e863f40a1e088bfe8ab50e 100644 (file)
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -1948,6 +1948,11 @@ Deprecations in the Python API
 * The :mod:`sysconfig` key ``SO`` is deprecated, it has been replaced by
   ``EXT_SUFFIX``.
 
+* The ``U`` mode accepted by various ``open`` functions is deprecated.
+  In Python3 it does not do anything useful, and should be replaced by
+  appropriate uses of :class:`io.TextIOWrapper` (if needed) and its *newline*
+  argument.
+
 
 Deprecations in the C API
 -------------------------
@@ -2242,7 +2247,14 @@ Changes in the Python API
 
 * Since the *digestmod* argument to the :func:`hmac.new` function will in the
   future have no default, all calls to :func:`hmac.new` should be changed to
-  explicitly specify a *digestmod*. (:issue:`17276`).
+  explicitly specify a *digestmod* (:issue:`17276`).
+
+* Any calls to ``open`` functions that specify ``U`` should be modified.
+  ``U`` is ineffective in Python3 and will eventually raise an error if used.
+  Depending on the function, the equivalent of its old Python2 behavior can be
+  achieved using either a *newline* argument, or if necessary by wrapping the
+  stream in :mod:`~io.TextIOWrapper` to use its *newline* argument
+  (:issue:`15204`).
 
 
 Changes in the C API