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 66f8640eb1f7459434f59de7051da0deb9a94b0f..0f513f5498560685e184fbda0955317a27ee1a13 100644 (file)
--- a/Lib/email/Message.py
+++ b/Lib/email/Message.py
@@ -102,6 +102,10 @@ class Message:
         """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()