Ticket #8638: 8638.2.diff

docs/topics/email.txt

@@ -350 +350 @@
     connection = SMTPConnection()   # Use default settings for connection
     messages = get_notification_email()
     connection.send_messages(messages)
+
+Preventing or testing e-mails
+-----------------------------
+
+The are times when you do not want Django to send e-mails at all, i.e.
+during development, or you would like to quickly test e-mail generation
+and output.  The least intrusive way to do so is to use a "dumb" e-mail
+server that receives the e-mails locally and displays them, but does not
+actually send anything.
+
+Python has a built-in way to accomplish this with a single command::
+
+    python -m smtpd -n -c DebuggingServer localhost:1025
+
+This command will start a simple SMTP server listening on port 1025 of
+localhost.  This server simply prints to standard output all email
+headers and the email body.  You then only need to set the
+:setting:`EMAIL_HOST` and :setting:`EMAIL_PORT` accordingly, and you are
+set.
+
+For more entailed testing and processing of e-mails locally, see the
+Python documentation on the `SMTP Server`_.
+
+.. _SMTP Server: http://docs.python.org/library/smtpd.html