[issue24277] Take the new email package features out of provisional status

[R. David Murray]

R. David Murray added the comment:

Obviously I quite missed the 3.5 deadline, and it is only thanks to the Core Sprint that I'm going to make the 3.6 deadline, but at least I'm making it.

There is one code change in this patch, changing the default behavior of as_string/str on EmailMessage (only) to be more sensible, and take advantage of the policy.utf8 flag to make str output more readable by default.  Otherwise, it is simply (hah) a fairly complete documentation reorganization and rewrite giving primacy to the new API and demoting the old API to 'legacy'.

----------
components: +email
keywords: +patch
nosy: +barry
stage: needs patch -> patch review
versions: +Python 3.6 -Python 3.5
Added file: http://bugs.python.org/file44410/email_doc_rewrite.patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24277>
_______________________________________