SMTPClient documentation doesn't describe sending multiple emails

[indigo]

http://twistedmatrix.com/documents/current/api/twisted.protocols.smtp.SMTPClient.html
Describes getMailFrom, getMailTo, and getMailData as rather simply returning.
However, if getMailFrom does not return None, SMTPClient sends the mail and
returns to the DATA state, calling getMailFrom, then getMailTo then getMailData
again. The ability to send multiple mails per connection is not obvious, and if
one were to follow the documentation, the result would be an endless loop. Now I
know who is responsible for all those duplicate posts on mailing lists!

[Jerub]

wow, this is over a year old. I'm stealing this issue.
The link is a 404 now, the new link is:
http://twistedmatrix.com/documents/current/api/twisted.mail.smtp.SMTPClient.html
because of the package split.