[Python-checkins] cpython (merge 3.2 -> default): Merge #11555 as_string doc fix from 3.2.
r.david.murray
python-checkins at python.org
Tue Mar 15 19:04:45 CET 2011
http://hg.python.org/cpython/rev/1c0cded97280
changeset: 68510:1c0cded97280
parent: 68507:a9bb1909cbed
parent: 68509:9daa9a4c4cc4
user: R David Murray <rdmurray at bitdance.com>
date: Tue Mar 15 14:04:00 2011 -0400
summary:
Merge #11555 as_string doc fix from 3.2.
files:
diff --git a/Doc/library/email.message.rst b/Doc/library/email.message.rst
--- a/Doc/library/email.message.rst
+++ b/Doc/library/email.message.rst
@@ -46,15 +46,16 @@
be generated or modified).
Note that this method is provided as a convenience and may not always
- format the message the way you want. For example, by default it mangles
- lines that begin with ``From``. For more flexibility, instantiate a
+ format the message the way you want. For example, by default it does
+ not do the mangling of lines that begin with ``From`` that is
+ required by the unix mbox format. For more flexibility, instantiate a
:class:`~email.generator.Generator` instance and use its :meth:`flatten`
method directly. For example::
from io import StringIO
from email.generator import Generator
fp = StringIO()
- g = Generator(fp, mangle_from_=False, maxheaderlen=60)
+ g = Generator(fp, mangle_from_=True, maxheaderlen=60)
g.flatten(msg)
text = fp.getvalue()
diff --git a/Lib/email/message.py b/Lib/email/message.py
--- a/Lib/email/message.py
+++ b/Lib/email/message.py
@@ -157,8 +157,7 @@
header.
This is a convenience method and may not generate the message exactly
- as you intend because by default it mangles lines that begin with
- "From ". For more flexibility, use the flatten() method of a
+ as you intend. For more flexibility, use the flatten() method of a
Generator instance.
"""
from email.generator import Generator
--
Repository URL: http://hg.python.org/cpython
More information about the Python-checkins
mailing list