diff --git a/Data/Aeson/Quick.hs b/Data/Aeson/Quick.hs
--- a/Data/Aeson/Quick.hs
+++ b/Data/Aeson/Quick.hs
@@ -4,7 +4,6 @@
 module Data.Aeson.Quick
     (
     -- $use
-    -- $examples
       module Ae
     , (.?)
     , (.!)
@@ -76,15 +75,15 @@
 
 Extract key from object:
 
->>> "{key}" .? value :: Maybe Foo
+>>> value .? "{key}" :: Maybe Foo
 
 Extract list of objects:
 
->>> "[{key}]" .? value :: Maybe [Foo]
+>>> value .? "[{key}]" :: Maybe [Foo]
 
 Extract with optional key:
 
->>> "{key,opt?}" .? value :: Maybe (Foo, Maybe Bar)
+>>> value .? "{key,opt?}" :: Maybe (Foo, Maybe Bar)
 -}
 (.?) :: FromJSON a => Value -> Structure -> Maybe a
 (.?) = AT.parseMaybe . flip extract
@@ -93,7 +92,7 @@
 -- TODO: Appropriate infixes?
 
 {- |
-The (very!) unsafe version of '.?'. This can fail very easily, do not depend on this in your program. Will probably be removed.
+Unsafe version of '.?'. Returns 'error' on failure.
 -}
 (.!) :: FromJSON a => Value -> Structure -> a
 (.!) v s = either err id $ AT.parseEither (extract s) v
@@ -179,6 +178,6 @@
 --
 -- @
 -- extractHobbyist :: 'Value' -> 'Maybe' ('String', 'Int', ['String'])
--- extractHobbyist value = value '.?' "{name,age,hobbies:[{name}]}"
+-- extractHobbyist = ('.?' "{name,age,hobbies:[{name}]}")
 -- @
 --
diff --git a/aeson-quick.cabal b/aeson-quick.cabal
--- a/aeson-quick.cabal
+++ b/aeson-quick.cabal
@@ -1,5 +1,5 @@
 Name:              aeson-quick
-Version:           0.1.1
+Version:           0.1.1.1
 Build-Type:        Simple
 Cabal-Version:     >= 1.10
 License:           BSD3