diff --git a/CHANGELOG.md b/CHANGELOG.md
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # bz2
 
+## 0.1.1.1
+
+  * Haddock improvements
+
 ## 0.1.1.0
 
   * Change type signature of `bZ2BzlibVersion`
diff --git a/bz2.cabal b/bz2.cabal
--- a/bz2.cabal
+++ b/bz2.cabal
@@ -1,6 +1,6 @@
 cabal-version:      1.18
 name:               bz2
-version:            0.1.1.0
+version:            0.1.1.1
 license:            BSD3
 license-file:       LICENSE
 copyright:          Copyright: (c) 2020 Vanessa McHale
diff --git a/src/Codec/Compression/BZip.hs b/src/Codec/Compression/BZip.hs
--- a/src/Codec/Compression/BZip.hs
+++ b/src/Codec/Compression/BZip.hs
@@ -1,4 +1,7 @@
-module Codec.Compression.BZip ( -- * High-level functions
+-- | High-level functions throw 'BZError' on error.
+--
+-- @since 0.1.1.0
+module Codec.Compression.BZip ( -- * High-level functions.
                                 compress
                               , compressWith
                               , decompress
diff --git a/src/Codec/Compression/BZip/Unpack.chs b/src/Codec/Compression/BZip/Unpack.chs
--- a/src/Codec/Compression/BZip/Unpack.chs
+++ b/src/Codec/Compression/BZip/Unpack.chs
@@ -36,6 +36,11 @@
         (fmap snd . extractBuf bs)
 
     where
+        
+        -- thing-to-cons-to (cdr) -> backward-traveling state (?)
+        -- ret value -> forward-traveling state!
+        -- stuff "remaining" to be fed in could be forward-traveling state ?
+        -- -> [BS.ByteString] Writer + BZError state :p
 
         -- corresponds to inner loop in zlib example
         fillBuf :: [BS.ByteString] -> Ptr a -> IO (BZError, [BS.ByteString])