#6051: refer to email examples for better way to construct email messages.

diff --git a/Doc/library/email-examples.rst b/Doc/library/email-examples.rst
index f606f9bb3b52585d54dfe7d2554cd440c33d4cd3..c1b16da39471c5b9a5389d3266946585fb2fc48a 100644 (file)
--- a/Doc/library/email-examples.rst
+++ b/Doc/library/email-examples.rst
@@ -1,3 +1,5 @@
+.. _email-examples:
+
 :mod:`email`: Examples
 ----------------------
 

diff --git a/Doc/library/smtplib.rst b/Doc/library/smtplib.rst
index 8facc9a6d81137a95258f1af361fe2b58e643758..4c1c61407777285210abe90dfda26044a9b78e54 100644 (file)
--- a/Doc/library/smtplib.rst
+++ b/Doc/library/smtplib.rst
@@ -380,3 +380,8 @@ example doesn't do any processing of the :rfc:`822` headers.  In particular, the
    server.sendmail(fromaddr, toaddrs, msg)
    server.quit()
 
+.. note::
+
+   In general, you will want to use the :mod:`email` package's features to
+   construct an email message, which you can then convert to a string and send
+   via :meth:`sendmail`; see :ref:`email-examples`.