doc: mention the behaviour if URL is invalid

If the URL passed to `http.request` is not properly parsable by `url.parse`, we
fall back to use `localhost` and port 80. This creates confusing error messages
like in this question http://stackoverflow.com/q/32675907/1903116.

PR-URL: #2966

Reviewed-By: James M Snell <[email protected]>

Author: thefourtheye

doc/api/http.markdown

@@ -469,7 +469,12 @@ Node.js maintains several connections per server to make HTTP requests.
 This function allows one to transparently issue requests.
 
 `options` can be an object or a string. If `options` is a string, it is
-automatically parsed with [url.parse()][].
+automatically parsed with [url.parse()][] and it must be a valid complete URL,
+including protocol and complete domain name or IP address.
+
+**Note**: If the passed string is not in the valid URL format, then the
+ connection will be established to the default domain name, localhost, and on
+ the default port, 80. *This will be fixed soon.*
 
 Options:
 
@@ -569,7 +574,7 @@ There are a few special headers that should be noted.
 ## http.get(options[, callback])
 
 Since most requests are GET requests without bodies, Node.js provides this
-convenience method. The only difference between this method and `http.request()`
+convenience method. The only difference between this method and [http.request][]
 is that it sets the method to GET and calls `req.end()` automatically.
 
 Example: