IMAP examples

[Guyon Morée]

Maybe it is an idea to include existing examples like the ones from the
cookbook in the pyhton documentation. This will enhance the documentation
quite a bit I think.


> If my english was better I would love to help improve the python
> documentation, most modules in the standard libraries lack good
> examples how to *use* them with just a simple description.  And a
> short motivation for the design of a module if possible like "just
> copied the C API" or "Because of efficiency ..." or "We use a class
> framework here because ...".  A gigantic task.  The PSL book by effbot
> is great but it's a book.  And it needs a new version.