changeset:   96127:4a254750ad20
user:        R David Murray <rdmurray@bitdance.com>
date:        Sun May 17 19:36:16 2015 -0400
files:       Doc/library/email.policy.rst
description:
#24211: Add missing docs for SMTPUTF8 policy instance.


diff -r 30795a477f85 -r 4a254750ad20 Doc/library/email.policy.rst
--- a/Doc/library/email.policy.rst	Sun May 17 19:27:22 2015 -0400
+++ b/Doc/library/email.policy.rst	Sun May 17 19:36:16 2015 -0400
@@ -534,6 +534,14 @@
    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