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

Backport of r13127 from trunk.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.1.X@13131 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 c9c0050b96..05e787b49a 100644
--- a/docs/topics/email.txt
+++ b/docs/topics/email.txt
@@ -84,6 +84,14 @@ Each separate element of ``datatuple`` results in a separate e-mail message.
 As in ``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()
 --------------------------------