diff --git a/doc/api/http.markdown b/doc/api/http.markdown
index 260d22de1d9..d7f43529e4f 100644
--- a/doc/api/http.markdown
+++ b/doc/api/http.markdown
@@ -32,6 +32,12 @@ Returns a new web server object.
 The `requestListener` is a function which is automatically
 added to the `'request'` event.
 
+## http.createClient([port], [host])
+
+This function is **deprecated**; please use
+[http.request()](#http_http_request_options_callback) instead. Constructs a new
+HTTP client. `port` and `host` refer to the server to be connected to.
+
 ## Class: http.Server
 
 This is an `EventEmitter` with the following events: