diff --git a/Network/Smtp.hs b/Network/Smtp.hs
--- a/Network/Smtp.hs
+++ b/Network/Smtp.hs
@@ -5,7 +5,25 @@
 -- Maintainer: Ertugrul Soeylemez <es@ertes.de>
 -- Stability:  experimental
 --
--- Convenience module.
+-- This package provides a monad for fast, incremental ESMTP sessions,
+-- with which you can, among other things, send emails.  Here is an
+-- example session:
+--
+-- > mailSession :: ByteString -> ByteString -> ByteString ->
+-- >                Builder -> Mail ()
+-- > mailSession srcDomain fromAddr toAddr content = do
+-- >     waitForWelcome
+-- >     sendHello srcDomain
+-- >     sendMailFrom fromAddr
+-- >     sendRcptTo toAddr
+-- >     sendData content
+-- >     sendQuit
+--
+-- You can use the 'sendMail' function to send a mail via a domain's MX
+-- server, which is looked up via DNS.  Alternatively you can connect to
+-- a specific SMTP server directly by using the 'sendMailDirect'
+-- function.  Finally for a low-level interface you can use the
+-- 'runMail' function.
 
 module Network.Smtp
     ( -- * Reexports
diff --git a/Network/Smtp/Protocol.hs b/Network/Smtp/Protocol.hs
--- a/Network/Smtp/Protocol.hs
+++ b/Network/Smtp/Protocol.hs
@@ -15,12 +15,12 @@
       Mail,
       MailConfig(..),
 
-      -- * Session
-      -- ** Creating
+      -- * Sessions
+      -- ** Running sessions
       runMail,
       sendMail,
       sendMailDirect,
-      -- ** Chatting
+      -- ** Chatting with the server
       waitForWelcome,
       sendHello,
       sendMailFrom,
@@ -29,8 +29,13 @@
       sendReset,
       sendQuit,
 
-      -- * Parsers
-      codeParser
+      -- * Utilities
+      -- ** Parsing
+      codeParser,
+
+      -- ** Input/output
+      mailPut,
+      mailPutList
     )
     where
 
diff --git a/ismtp.cabal b/ismtp.cabal
--- a/ismtp.cabal
+++ b/ismtp.cabal
@@ -1,7 +1,7 @@
 Name:          ismtp
-Version:       1.0.0
+Version:       1.0.1
 Category:      Network
-Synopsis:      Incremental SMTP sessions
+Synopsis:      Fast, incremental ESMTP sessions
 Maintainer:    Ertugrul Söylemez <es@ertes.de>
 Author:        Ertugrul Söylemez <es@ertes.de>
 Copyright:     (c) 2010 Ertugrul Söylemez
@@ -11,9 +11,10 @@
 Stability:     experimental
 Cabal-version: >= 1.6
 Description:
-    This library provides incremental SMTP sessions, so you can control
-    each aspect of the session.  It also provides a small DNS cache for
-    MX records.
+
+    This library provides fast, incremental SMTP sessions, so you can
+    control each aspect of the session.  It uses iteratees and
+    blaze-builder for fast I/O.
 
 Library
     Build-depends: