Improve docstrings on messages and module title.
Add detection of different types of MIME multipart messages.

This should allow us to do the right thing when it comes to HTML
messages with text/plain fallback later.