diff --git a/doc/api/http.md b/doc/api/http.md index e4300cc4299f50..4a84e50ba0b029 100644 --- a/doc/api/http.md +++ b/doc/api/http.md @@ -797,11 +797,14 @@ added: v0.1.0 * `socket` {net.Socket} -When a new TCP stream is established. `socket` is an object of type -[`net.Socket`][]. Usually users will not want to access this event. In -particular, the socket will not emit `'readable'` events because of how -the protocol parser attaches to the socket. The `socket` can also be -accessed at `request.connection`. +This event is emitted when a new TCP stream is established. `socket` is +typically an object of type [`net.Socket`][]. Usually users will not want to +access this event. In particular, the socket will not emit `'readable'` events +because of how the protocol parser attaches to the socket. The `socket` can +also be accessed at `request.connection`. + +*Note*: This event can also be explicitly emitted by users to inject connections +into the HTTP server. In that case, any [`Duplex`][] stream can be passed. ### Event: 'request'