diff --git a/Network/Wai/Handler/Warp.hs b/Network/Wai/Handler/Warp.hs
--- a/Network/Wai/Handler/Warp.hs
+++ b/Network/Wai/Handler/Warp.hs
@@ -119,7 +119,7 @@
 setOnException :: (Maybe Request -> SomeException -> IO ()) -> Settings -> Settings
 setOnException x y = y { settingsOnException = x }
 
--- | A function to create `Response` when an exception occurs.
+-- | A function to create a `Response` when an exception occurs.
 --
 -- Default: 500, text/plain, \"Something went wrong\"
 --
@@ -127,7 +127,7 @@
 setOnExceptionResponse :: (SomeException -> Response) -> Settings -> Settings
 setOnExceptionResponse x y = y { settingsOnExceptionResponse = x }
 
--- | What to do when a connection is open. When 'False' is returned, the
+-- | What to do when a connection is opened. When 'False' is returned, the
 -- connection is closed immediately. Otherwise, the connection is going on.
 -- Default: always returns 'True'.
 --
@@ -135,7 +135,7 @@
 setOnOpen :: (SockAddr -> IO Bool) -> Settings -> Settings
 setOnOpen x y = y { settingsOnOpen = x }
 
--- | What to do when a connection is close. Default: do nothing.
+-- | What to do when a connection is closed. Default: do nothing.
 --
 -- Since 2.1.0
 setOnClose :: (SockAddr -> IO ()) -> Settings -> Settings
@@ -154,7 +154,7 @@
 setManager :: Manager -> Settings -> Settings
 setManager x y = y { settingsManager = Just x }
 
--- | Cache duratoin time of file descriptors in seconds. 0 means that the cache mechanism is not used. Default value: 10
+-- | Cache duration time of file descriptors in seconds. 0 means that the cache mechanism is not used. Default value: 10
 setFdCacheDuration :: Int -> Settings -> Settings
 setFdCacheDuration x y = y { settingsFdCacheDuration = x }
 
diff --git a/Network/Wai/Handler/Warp/Settings.hs b/Network/Wai/Handler/Warp/Settings.hs
--- a/Network/Wai/Handler/Warp/Settings.hs
+++ b/Network/Wai/Handler/Warp/Settings.hs
@@ -22,9 +22,9 @@
 -- | Various Warp server settings. This is purposely kept as an abstract data
 -- type so that new settings can be added without breaking backwards
 -- compatibility. In order to create a 'Settings' value, use 'defaultSettings'
--- and record syntax to modify individual records. For example:
+-- and the various \'set\' functions to modify individual fields. For example:
 --
--- > defaultSettings { settingsTimeout = 20 }
+-- > setTimeout 20 defaultSettings
 data Settings = Settings
     { settingsPort :: Int -- ^ Port to listen on. Default value: 3000
     , settingsHost :: HostPreference -- ^ Default value: HostIPv4
diff --git a/warp.cabal b/warp.cabal
--- a/warp.cabal
+++ b/warp.cabal
@@ -1,5 +1,5 @@
 Name:                warp
-Version:             3.0.0.4
+Version:             3.0.0.5
 Synopsis:            A fast, light-weight web server for WAI applications.
 License:             MIT
 License-file:        LICENSE