What's new entry for email 5.1.

diff --git a/Doc/library/email.rst b/Doc/library/email.rst
index 8926ae462e5e556089645624cf263e80eca08e7d..ddf4d4b104e37ea2f9eae16d8f32db79b0504819 100644 (file)
--- a/Doc/library/email.rst
+++ b/Doc/library/email.rst
@@ -118,7 +118,7 @@ version 5.0:
   convert message bodies that have a :mailheader:`Content-Transfer-Encoding` of
   8bit to instead have a 7bit Content-Transfer-Encoding.
 
-* New function :class:`~email.generator.BytesGenerator` produces bytes
+* New class :class:`~email.generator.BytesGenerator` produces bytes
   as output, preserving any unchanged non-ASCII data that was
   present in the input used to build the model, including message bodies
   with a :mailheader:`Content-Transfer-Encoding` of 8bit.

diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst
index 97a169609ed3f661b3330ced4e608ce25a0a3489..2e7deecd03f684c524ba765f5b76d58333784d67 100644 (file)
--- a/Doc/whatsnew/3.2.rst
+++ b/Doc/whatsnew/3.2.rst
@@ -184,6 +184,34 @@ module::
       PEP written by Barry Warsaw.
 
 
+Email 5.1
+=========
+
+The email package is extended to be able to parse and generate email messages
+in bytes format.
+
+* New functions :func:`~email.message_from_bytes` and
+  :func:`~email.message_from_binary_file`, and new classes
+  :class:`~email.parser.BytesFeedParser` and :class:`~email.parser.BytesParser`
+  allow binary message data to be parsed into model objects.
+
+* Given bytes input to the model, :meth:`~email.message.Message.get_payload`
+  will by default decode a message body that has a
+  :mailheader:`Content-Transfer-Encoding` of `8bit` using the charset specified
+  in the MIME headers and return the resulting string.
+
+* Given bytes input to the model, :class:`~email.generator.Generator` will
+  convert message bodies that have a :mailheader:`Content-Transfer-Encoding` of
+  8bit to instead have a 7bit Content-Transfer-Encoding.
+
+* New class :class:`~email.generator.BytesGenerator` produces bytes
+  as output, preserving any unchanged non-ASCII data that was
+  present in the input used to build the model, including message bodies
+  with a :mailheader:`Content-Transfer-Encoding` of 8bit.
+
+  (Proposed and implemented by R. David Murray, :issue:`4661`.)
+
+
 Other Language Changes
 ======================