diff --git a/lazyio.cabal b/lazyio.cabal
--- a/lazyio.cabal
+++ b/lazyio.cabal
@@ -1,5 +1,5 @@
 Name:             lazyio
-Version:          0.1.0.3
+Version:          0.1.0.4
 License:          BSD3
 License-File:     LICENSE
 Author:           Henning Thielemann <haskell@henning-thielemann.de>
@@ -13,6 +13,20 @@
   which is however driven by its output.
   That is, the LazyIO action is only executed as far as necessary
   in order to provide the required data.
+  .
+  The package may help you to avoid stack overflows in @mapM@.
+  Say you have
+  .
+  > mapM f xs
+  .
+  where @xs@ is a long list. When run, you may encounter a stack overflow.
+  To prevent it, write instead:
+  .
+  > import qualified System.IO.Lazy as LazyIO
+  >
+  > LazyIO.run $ mapM (LazyIO.interleave . f) xs
+  .
+  The stack overflow is gone.
 Tested-With:       GHC==6.8.2, GHC==6.12.1
 Tested-With:       GHC==7.4.1, GHC==7.6.3
 Cabal-Version:     >=1.6
@@ -27,7 +41,7 @@
 Source-Repository this
   type:     darcs
   location: http://code.haskell.org/~thielema/lazyio/
-  tag:      0.1.0.3
+  tag:      0.1.0.4
 
 Flag splitBase
   description: Choose the new smaller, split-up base package.