From: R David Murray <rdmurray@bitdance.com>
Date: Sun, 17 May 2015 23:36:16 +0000 (-0400)
Subject: #24211: Add missing docs for SMTPUTF8 policy instance.
X-Git-Tag: v3.5.0b1~89
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=1dbee9460e6a242bfbdd701ce328f11f7dd69019;p=thirdparty%2FPython%2Fcpython.git

#24211: Add missing docs for SMTPUTF8 policy instance.
---

diff --git a/Doc/library/email.policy.rst b/Doc/library/email.policy.rst
index 6e1318672bdf..045b11930305 100644
--- a/Doc/library/email.policy.rst
+++ b/Doc/library/email.policy.rst
@@ -534,6 +534,14 @@ more closely to the RFCs relevant to their domains.
    Like ``default``, but with ``linesep`` set to ``\r\n``, which is RFC
    compliant.
 
+.. data:: SMTPUTF8
+
+   The same as ``SMTP`` except that :attr:`~EmailPolicy.utf8` is ``True``.
+   Useful for serializing messages to a message store without using encoded
+   words in the headers.  Should only be used for SMTP trasmission if the
+   sender or recipient addresses have non-ASCII characters (the
+   :meth:`smtplib.SMTP.send_message` method handles this automatically).
+
 .. data:: HTTP
 
    Suitable for serializing headers with for use in HTTP traffic.  Like