From 1dbee9460e6a242bfbdd701ce328f11f7dd69019 Mon Sep 17 00:00:00 2001 From: R David Murray Date: Sun, 17 May 2015 19:36:16 -0400 Subject: #24211: Add missing docs for SMTPUTF8 policy instance. --- Doc/library/email.policy.rst | 8 ++++++++ 1 file changed, 8 insertions(+) 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 -- cgit v0.12