[Documentation] It is too hard to figure out how to do trivial common-case sending email with twisted.mail

New submission from arkanes <[email protected]>:

t.mail.smtp.sendmail needs to be documented a little more clearly.
Specifically, the msg parameter should clarify that email.Message refers to the stdlib package (with a link to the stdlib docs), and it should more simply say that it can be an email.Message object or the raw RF2822 message.

The current t.mail HOWTOs only include a fairly compliated SMTP client. There should be a short example answering the use case "I just want to send an email", rather than "I want to write an email client" or "I want to write an email server".

----------
Type     : task
Component: mail
Keywords : documentation twisted mail
Priority : normal
Nosy     : 
----------
http://twistedmatrix.com/trac/ticket/4042