summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2015-05-17 23:36:16 (GMT)
committerR David Murray <rdmurray@bitdance.com>2015-05-17 23:36:16 (GMT)
commit1dbee9460e6a242bfbdd701ce328f11f7dd69019 (patch)
tree55f4db7657979de6164465627f5fc401d3812819
parent8308444eefee8a6b5bb58b9f51a29d1a8d3683bf (diff)
downloadcpython-1dbee9460e6a242bfbdd701ce328f11f7dd69019.zip
cpython-1dbee9460e6a242bfbdd701ce328f11f7dd69019.tar.gz
cpython-1dbee9460e6a242bfbdd701ce328f11f7dd69019.tar.bz2
#24211: Add missing docs for SMTPUTF8 policy instance.
-rw-r--r--Doc/library/email.policy.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/Doc/library/email.policy.rst b/Doc/library/email.policy.rst
index 6e13186..045b119 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