[Python-checkins] cpython (merge 3.2 -> default): Merge #11780: document that email.encoders throw TypeError on multipart

[r.david.murray]

http://hg.python.org/cpython/rev/060eda590fa0
changeset:   75764:060eda590fa0
parent:      75762:474338602bd8
parent:      75763:1be426a555ca
user:        R David Murray <rdmurray at bitdance.com>
date:        Fri Mar 16 22:04:25 2012 -0400
summary:
  Merge #11780: document that email.encoders throw TypeError on multipart messages.

files:
  Doc/library/email.encoders.rst |  4 ++++
  1 files changed, 4 insertions(+), 0 deletions(-)


diff --git a/Doc/library/email.encoders.rst b/Doc/library/email.encoders.rst
--- a/Doc/library/email.encoders.rst
+++ b/Doc/library/email.encoders.rst
@@ -18,6 +18,10 @@
 payload, encode it, and reset the payload to this newly encoded value.  They
 should also set the :mailheader:`Content-Transfer-Encoding` header as appropriate.
 
+Note that these functions are not meaningful for a multipart message.  They
+must be applied to individual subparts instead, and will throw a
+:exc:`TypeError` if passed a message whose type is multipart.
+
 Here are the encoding functions provided:
 
 

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