diff --git a/Database/RethinkDB/Driver.hs b/Database/RethinkDB/Driver.hs
--- a/Database/RethinkDB/Driver.hs
+++ b/Database/RethinkDB/Driver.hs
@@ -40,13 +40,18 @@
 import Database.RethinkDB.ReQL
 
 -- $setup
---
--- Get the doctests ready
---
+-- >>> :set -XOverloadedStrings
 -- >>> :load Database.RethinkDB.NoClash
 -- >>> import qualified Database.RethinkDB as R
--- >>> :set -XOverloadedStrings
+-- >>> import Control.Exception
+-- >>> import Data.Text
+-- >>> let try' x = (try x `asTypeOf` return (Left (undefined :: SomeException))) >> return ()
 -- >>> h <- fmap (use "doctests") $ connect "localhost" 28015 def
+-- >>> try' $ run' h $ dbCreate "doctests"
+-- >>> try' $ run' h $ tableCreate (table "users"){ tablePrimaryKey = Just "name" }
+-- >>> try' $ run' h $ delete $ table "users"
+-- >>> run h $ table "users" # insert (R.map (\x -> ["name":=x]) ["bill", "bob", "nancy" :: Text]) :: IO WriteResponse
+-- {inserted:3}
 
 
 -- | Per-query settings
@@ -106,7 +111,7 @@
 -- >>> next c
 -- Just "bill"
 -- >>> collect c
--- ["nancy","sabrina"]
+-- ["bob","nancy"]
 run :: (Expr query, Result r) => RethinkDBHandle -> query -> IO r
 run h = runOpts h []
 
diff --git a/Database/RethinkDB/Functions.hs b/Database/RethinkDB/Functions.hs
--- a/Database/RethinkDB/Functions.hs
+++ b/Database/RethinkDB/Functions.hs
@@ -522,6 +522,9 @@
 
 -- | Merge two objects together
 --
+-- NOTE: This driver is based on the official JavaScript driver, you are correct to expect the same semantics.
+-- However the order of composition is flipped by putting the first argument last.
+--
 -- >>> run' h $ merge ["a" := 1, "b" := 1] ["b" := 1, "c" := 2]
 -- {"a":1,"b":1,"c":2}
 merge :: (Expr a, Expr b) => a -> b -> ReQL
diff --git a/rethinkdb.cabal b/rethinkdb.cabal
--- a/rethinkdb.cabal
+++ b/rethinkdb.cabal
@@ -1,5 +1,5 @@
 name: rethinkdb
-version: 2.2.0.8
+version: 2.2.0.9
 cabal-version: >=1.8
 build-type: Simple
 license: Apache
@@ -16,7 +16,7 @@
   GHC==7.6.3,
   GHC==7.8.4,
   GHC==7.10.3,
-  GHC==8.0.1
+  GHC==8.0.2
 
 source-repository head
     type: git
@@ -37,7 +37,7 @@
         data-default >=0.5 && <0.8,
         network >=2.4 && <2.7,
         mtl >=2.1 && <2.3,
-        vector >=0.10 && <0.12,
+        vector >=0.10 && <0.13,
         time >=1.4 && <1.7,
         utf8-string >=0.3 && <1.1,
         binary >=0.5 && <0.9,