#24277: What's New and news entries for previous commit.

diff --git a/Doc/whatsnew/3.6.rst b/Doc/whatsnew/3.6.rst
index e48ed01fc214097531abb1b8b500d9b55d52cf17..4398da516cf222fbeb4d991552e53f0d9ec910cf 100644 (file)
--- a/Doc/whatsnew/3.6.rst
+++ b/Doc/whatsnew/3.6.rst
@@ -462,6 +462,11 @@ need to be adapted. See :issue:`27819` for more details.
 email
 -----
 
+The new email API, enabled via the *policy* keyword to various constructors, is
+no longer provisional.  The :mod:`email` documentation has been reorganized and
+rewritten to focus on the new API, while retaining the old documentation for
+the legacy API.  (Contributed by R. David Murray in :issue:`24277`.)
+
 The :mod:`email.mime` classes now all accept an optional *policy* keyword.
 (Contributed by Berker Peksag in :issue:`27331`.)
 

diff --git a/Misc/NEWS b/Misc/NEWS
index 726461590b4179d82c5a85884dbbc4a297337d3f..c60e8708034fb382070b6e4ca105cdd5598e0c87 100644 (file)
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -99,6 +99,9 @@ Core and Builtins
 Library
 -------
 
+- Issue #24277: The new email API is no longer provisional, and the docs
+  have been reorganized and rewritten to emphasize the new API.
+
 - lib2to3.pgen3.driver.load_grammar() now creates a stable cache file
   between runs given the same Grammar.txt input regardless of the hash
   randomization setting.