@@ -427,7 +427,7 @@ req method url body Proxy options = do
427427-- A note about safety, in case 'unsafePerformIO' looks suspicious to you.
428428-- The value of 'globalManager' is named and lives on top level. This means
429429-- it will be shared, i.e. computed only once on first use of manager. From
430−-- that moment on the 'IORef' will be just reused — exactly the behaviour we
430+-- that moment on the 'IORef' will be just reused — exactly the behavior we
431431-- want here in order to maximize connection sharing. GHC could spoil the
432432-- plan by inlining the definition, hence the @NOINLINE@ pragma.
433433
@@ -924,8 +924,8 @@ type family ProvidesBody body :: CanHaveBody where
924924-- 'CanHaveBody'. When method says it should have 'NoBody', the only body
925925-- option to use is 'NoReqBody'.
926926--
927−-- __Note__: users of GHC 8.0.1 will see slightly more friendly error
928−-- messages when method does not allow a body and body is provided.
927+-- __Note__: users of GHC 8.0.1 and later will see a slightly more friendly
928+-- error message when method does not allow a body and body is provided.
929929
930930type family HttpBodyAllowed
931931 (allowsBody :: CanHaveBody)
@@ -1101,12 +1101,12 @@ cookieJar jar = withRequest $ \x ->
11011101
11021102-- $authentication
11031103--
1104−-- This section provides common authentication helpers in form of 'Option's.
1105−-- You should always prefer the provided authentication 'Option's to manual
1106−-- construction of headers because it ensures that you only use one
1107−-- authentication method at a time (they overwrite each other) and provides
1108−-- additional type safety that prevents leaking of credentials in cases when
1109−-- authentication relies on TLS for encrypting sensitive data.
1104+-- This section provides the common authentication helpers in the form of
1105+-- 'Option's. You should always prefer the provided authentication 'Option's
1106+-- to manual construction of headers because it ensures that you only use
1107+-- one authentication method at a time (they overwrite each other) and
1108+-- provides additional type safety that prevents leaking of credentials in
1109+-- cases when authentication relies on TLS for encrypting sensitive data.
11101110
11111111-- | The 'Option' adds basic authentication.
11121112--
@@ -1172,8 +1172,8 @@ oAuth2Token token = asFinalizer
11721172-- Request — Optional parameters — Other
11731173
11741174-- | Specify the port to connect to explicitly. Normally, 'Url' you use
1175−-- determines default port, @80@ for HTTP and @443@ for HTTPS, this 'Option'
1176−-- allows to choose arbitrary port overwriting the defaults.
1175+-- determines the default port: @80@ for HTTP and @443@ for HTTPS. This
1176+-- 'Option' allows to choose arbitrary port overwriting the defaults.
11771177
11781178port :: Int -> Option scheme
11791179port n = withRequest $ \x ->
@@ -1196,8 +1196,8 @@ decompress
11961196decompress f = withRequest $ \x ->
11971197 x { L.decompress = f }
11981198
1199−-- | Specify number of microseconds to wait for response. Default is 30
1200−-- seconds.
1199+-- | Specify number of microseconds to wait for response. The default value
1200+-- is 30 seconds.
12011201
12021202responseTimeout
12031203 :: Int -- ^ Number of microseconds to wait
@@ -1205,7 +1205,7 @@ responseTimeout
12051205responseTimeout n = withRequest $ \x ->
12061206 x { L.responseTimeout = LI.ResponseTimeoutMicro n }
12071207
1208−-- | HTTP version to send to server, default is HTTP 1.1.
1208+-- | HTTP version to send to server, the default is HTTP 1.1.
12091209
12101210httpVersion
12111211 :: Int -- ^ Major version number
@@ -1409,12 +1409,12 @@ class RequestComponent a where
14091409
14101410 getRequestMod :: a -> Endo L.Request
14111411
1412−-- | This wrapper is only used to attach a type-level tag to given type.
1412+-- | This wrapper is only used to attach a type-level tag to a given type.
14131413-- This is necessary to define instances of 'RequestComponent' for any thing
14141414-- that implements 'HttpMethod' or 'HttpBody'. Without the tag, GHC can't
14151415-- see the difference between @'HttpMethod' method => 'RequestComponent'
14161416-- method@ and @'HttpBody' body => 'RequestComponent' body@ when it decides
1417−-- which instance to use (i.e. constraints are taken into account later,
1417+-- which instance to use (i.e. the constraints are taken into account later,
14181418-- when instance is already chosen).
14191419
14201420newtype Womb (tag :: Symbol) a = Womb a