From: R. David Murray <rdmurray@bitdance.com>
Date: Fri, 8 Oct 2010 21:37:39 +0000 (+0000)
Subject: What's new entry for email 5.1.
X-Git-Tag: v3.2a3~14
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=7c0a2271ff4ee62f5cecef8f3d106cbda91cf40a;p=thirdparty%2FPython%2Fcpython.git

What's new entry for email 5.1.
---

diff --git a/Doc/library/email.rst b/Doc/library/email.rst
index 8926ae462e5e..ddf4d4b104e3 100644
--- 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 97a169609ed3..2e7deecd03f6 100644
--- 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
 ======================