as_string(): Added some text to the docstring to make it clear that
it's a convenience only and give hints on what to do for more
flexibility.
diff --git a/Lib/email/Message.py b/Lib/email/Message.py
index 66f8640..0f513f5 100644
--- a/Lib/email/Message.py
+++ b/Lib/email/Message.py
@@ -102,6 +102,10 @@
"""Return the entire formatted message as a string.
Optional `unixfrom' when True, means include the Unix From_ envelope
header.
+
+ This is a convenience method and may not generate the message exactly
+ as you intend. For more flexibility, use the flatten() method of a
+ Generator instance.
"""
from email.Generator import Generator
fp = StringIO()