diff --git a/doc/api/http.markdown b/doc/api/http.markdown
index 3ba57a19567c6c..bfdeb86406aab4 100644
--- a/doc/api/http.markdown
+++ b/doc/api/http.markdown
@@ -897,7 +897,8 @@ is finished.
 
 ### request.abort()
 
-Aborts a request.  (New since v0.3.8.)
+Marks the request as aborting. Calling this will cause remaining data
+in the response to be dropped and the socket to be destroyed.
 
 ### request.setTimeout(timeout[, callback])