Fixed #13471 -- Added example of send_mass_mail usage. Thanks to gtaylor for the report and patch.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@13127 bcc190cf-cafb-0310-a4f2-bffc1f526a37

1 files changed, 8 insertions, 0 deletions

diff --git a/docs/topics/email.txt b/docs/topics/email.txt
index f1b0047c9b..74e153de61 100644
--- a/docs/topics/email.txt
+++ b/docs/topics/email.txt
@@ -91,6 +91,14 @@ As in :meth:`~django.core.mail.send_mail()`, recipients in the same
 ``recipient_list`` will all see the other addresses in the e-mail messages'
 "To:" field.
 
+For example, the following code would send two different messages to
+two different sets of recipients; however, only one connection to the
+mail server would be opened::
+
+    message1 = ('Subject here', 'Here is the message', 'from@example.com, ['first@example.com', 'other@example.com'])
+    message2 = ('Another Subject', 'Here is another message', 'from@example.com', ['second@test.com'])
+    send_mass_mail((message1, message2), fail_silently=False)
+
 send_mass_mail() vs. send_mail()
 --------------------------------