diff --git a/Language/Haskell/Exts/QQ.hs b/Language/Haskell/Exts/QQ.hs
--- a/Language/Haskell/Exts/QQ.hs
+++ b/Language/Haskell/Exts/QQ.hs
@@ -2,14 +2,14 @@
 -- declarations.
 --
 -- Antiquotations steal the splice syntax of Template Haskell, so for
--- example example 'x' appears antiquoted in @[hs| $x ++ $(Hs.strE \"bar\") |]@.
+-- example example 'x' appears antiquoted in @[$hs| $x ++ $(Hs.strE \"bar\") |]@.
 -- Expressions appearing inside parenthesized splices are limited to concrete
 -- syntax expressible by Template Haskell's 'Exp' data type.
 --
 -- Names in patterns can also be antiquoted, using double parentheses. For
 -- instance:
 --
--- > let f = Hs.name "foo" in [hs| ((f)) x = x + x |]
+-- > let f = Hs.name "foo" in [$dec| ((f)) x = x + x |]
 --
 -- In a pattern context, antiquotations use the same syntax.
 
@@ -24,6 +24,7 @@
 import Data.List (intercalate)
 
 
+-- | A quasiquoter for expressions.
 hs = QuasiQuoter { quoteExp = Hs.parseExpWithMode
                               Hs.defaultParseMode{Hs.extensions = Hs.knownExtensions}
                                     `project` antiquoteExp
@@ -34,6 +35,7 @@
 #endif
                  }
 
+-- | A quasiquoter for top-level declarations.
 dec = QuasiQuoter { quoteExp = Hs.parseDeclWithMode
                                Hs.defaultParseMode{Hs.extensions = Hs.knownExtensions}
                                      `project` antiquoteExp
diff --git a/haskell-src-exts-qq.cabal b/haskell-src-exts-qq.cabal
--- a/haskell-src-exts-qq.cabal
+++ b/haskell-src-exts-qq.cabal
@@ -1,5 +1,5 @@
 Name:           haskell-src-exts-qq
-Version:        0.2.1
+Version:        0.2.2
 Author:         Mathieu Boespflug
 Maintainer:     Mathieu Boespflug <mboes@tweag.net>
 Synopsis:       A quasiquoter for haskell-src-exts.
@@ -8,13 +8,13 @@
     more concisely and legibly. This package supports:
     .
     * Antiquotations, denoted by stealing the splice syntax of
-    Template Haskell, for example @[hs| $x ++ $(Hs.strE "bar") |]@.
+    Template Haskell, for example @[$hs| $x ++ $(Hs.strE "bar") |]@.
     Splices may not nested.
 
     * Antiquoting names in patterns. Names that are antiquoted appear
     surrounded by double parentheses. For instance:
     .
-    > let f = Hs.name "foo" in [hs| ((f)) x = x + x |]
+    > let f = Hs.name "foo" in [$hs| ((f)) x = x + x |]
 Category:       Language
 License:        BSD3
 License-File:   LICENSE