[Python-checkins] cpython (3.2): #1440472: Explain that email parser/generator isn't *quite* "idempotent"

[r.david.murray]

http://hg.python.org/cpython/rev/8bd30967bc4b
changeset:   76977:8bd30967bc4b
branch:      3.2
parent:      76975:41382250e5e1
user:        R David Murray <rdmurray at bitdance.com>
date:        Tue May 15 22:07:52 2012 -0400
summary:
  #1440472: Explain that email parser/generator isn't *quite* "idempotent"

files:
  Doc/library/email.generator.rst |  12 +++++++++++-
  1 files changed, 11 insertions(+), 1 deletions(-)


diff --git a/Doc/library/email.generator.rst b/Doc/library/email.generator.rst
--- a/Doc/library/email.generator.rst
+++ b/Doc/library/email.generator.rst
@@ -17,7 +17,8 @@
 standards-compliant way, should handle MIME and non-MIME email messages just
 fine, and is designed so that the transformation from flat text, to a message
 structure via the :class:`~email.parser.Parser` class, and back to flat text,
-is idempotent (the input is identical to the output).  On the other hand, using
+is idempotent (the input is identical to the output) [#]_.  On the other hand,
+using
 the Generator on a :class:`~email.message.Message` constructed by program may
 result in changes to the :class:`~email.message.Message` object as defaults are
 filled in.
@@ -204,3 +205,12 @@
    The default value for *fmt* is ``None``, meaning ::
 
       [Non-text (%(type)s) part of message omitted, filename %(filename)s]
+
+
+.. rubric:: Footnotes
+
+.. [#] This statement assumes that you use the appropriate setting for the
+       ``unixfrom`` argument, and that you set maxheaderlen=0 (which will
+       preserve whatever the input line lengths were).  It is also not strictly
+       true, since in many cases runs of whitespace in headers are collapsed
+       into single blanks.  The latter is a bug that will eventually be fixed.

-- 
Repository URL: http://hg.python.org/cpython