doc: update the http.request.setTimeout docs to be accurate

Refs: #8895 PR-URL: #25123 Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: James M Snell <[email protected]>
nodejs · Feb 28, 2019 · b17819d · b17819d
1 parent a1aff28
commit b17819d
Showing 1 changed file with 3 additions and 2 deletions.
diff --git a/doc/api/http.md b/doc/api/http.md
@@ -625,8 +625,9 @@ added: v0.5.9
 * `timeout` {number} Milliseconds before a request times out.
 * `callback` {Function} Optional function to be called when a timeout occurs. Same as binding to the `timeout` event.
 
-Once a socket is assigned to this request and is connected
-[`socket.setTimeout()`][] will be called.
+If no socket is assigned to this request then [`socket.setTimeout()`][] will be
+called immediately. Otherwise [`socket.setTimeout()`][] will be called after the
+assigned socket is connected.
 
 Returns `request`.