diff --git a/Doc/library/email.policy.rst b/Doc/library/email.policy.rst --- a/Doc/library/email.policy.rst +++ b/Doc/library/email.policy.rst @@ -4,7 +4,7 @@ .. module:: email.policy :synopsis: Controlling the parsing and generating of messages -.. versionadded: 3.3 +.. versionadded:: 3.3 The :mod:`email` package's prime focus is the handling of email messages as @@ -48,16 +48,18 @@ file on disk and pass it to the system ` >>> import email.policy >>> from subprocess import Popen, PIPE >>> with open('mymsg.txt', 'b') as f: - ... Msg = msg_from_binary_file(f, policy=email.policy.mbox) + ... msg = msg_from_binary_file(f, policy=email.policy.mbox) >>> p = Popen(['sendmail', msg['To'][0].address], stdin=PIPE) >>> g = BytesGenerator(p.stdin, policy=email.policy.SMTP) >>> g.flatten(msg) >>> p.stdin.close() >>> rc = p.wait() +.. XXX email.policy.mbox does not exist yet + Some email package methods accept a *policy* keyword argument, allowing the policy to be overridden for that method. For example, the following code uses -the :meth:`email.message.Message.as_string` method of the *msg* object from the +the :meth:`~email.message.Message.as_string` method of the *msg* object from the previous example and re-write it to a file using the native line separators for the platform on which it is running::