In the first example in the documentation for library module email.policy (http://docs.python.org/3/library/email.policy.html#module-email.policy):

  >>> from email import msg_from_binary_file
  >>> from email.generator import BytesGenerator
  >>> from subprocess import Popen, PIPE
  >>> with open('mymsg.txt', 'b') as f:
  ...     msg = msg_from_binary_file(f)

line 1: The module is "message_from_binary_file", not "msg_from_binary_file"
line 4: The mode must be "rb", not "b".
line 5: Same module (mis-)name problem as line 1.

Then in following example...

  >>> import os
  >>> with open('converted.txt', 'wb') as f:
  ...   f.write(msg.as_string (policy=msg.policy.clone (linesep=os.linesep))

line 3: Ubnbalanced parens, .as_string() has no "policy" keyword arg.

Please note I am trying to figure out how to use the email module for the first time and the above errors are glaring.  There may be (probably are) other errors in the examples and in the text that I am unaware of -- I've made  no attempt to find any others.  I suggest that someone familiar with email module review this page more carefully.

Thank you for the report.  We currently don't have automated testing of the doctest strings, and I must have neglected to hand test those examples before release.  I will fix (and test!) them ASAP.

New changeset ffc7ea3c04a5 by R David Murray in branch '3.3':
#18584: make doctest examples in email documentation pass.
http://hg.python.org/cpython/rev/ffc7ea3c04a5

New changeset 206685a4b19c by R David Murray in branch 'default':
Merge #18584: make doctest examples in email documentation pass.
http://hg.python.org/cpython/rev/206685a4b19c

OK, this fixed.  The 'as_string' example will still fail, as I never added the policy argument to that method.  I'll deal with that in a separate issue.

Unfortunately it is quite possible there are other errors in the new docs, since they are new...I will review them in the coming month as I'll be working on adding some additional new features to the provisional policies.

New changeset 7b86be4e822c by R David Murray in branch '3.3':
#18584: s/testcleanup/testsetup/ until we switch to Sphinx 1.1.
http://hg.python.org/cpython/rev/7b86be4e822c

New changeset 1901a04a3b4a by R David Murray in branch 'default':
Merge #18584: s/testcleanup/testsetup/ until we switch to Sphinx 1.1.
http://hg.python.org/cpython/rev/1901a04a3b4a