as_string(): Added some text to the docstring to make it clear that

warsaw · warsaw · commit 482c5f7eb7eb · 2003-04-18T23:04:35.000Z
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
@@ -102,6 +102,10 @@ def as_string(self, unixfrom=False):
         """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()
