From b02b93b2a22e1dbf5ef03aa0104f73836deb5d25 Mon Sep 17 00:00:00 2001 From: Ryan Graham Date: Tue, 16 Apr 2013 13:52:52 -0700 Subject: [PATCH] doc: note a gotcha with http.Server sockets --- doc/api/http.markdown | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/api/http.markdown b/doc/api/http.markdown index 594d19bacc..e93aa2d2dd 100644 --- a/doc/api/http.markdown +++ b/doc/api/http.markdown @@ -64,8 +64,10 @@ per connection (in the case of keep-alive connections). `function (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. The - `socket` can also be accessed at `request.connection`. + `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`. ### Event: 'close'