diff --git a/README.md b/README.md
index 6a43c6ad..bf529036 100644
--- a/README.md
+++ b/README.md
@@ -368,7 +368,7 @@ The package also provides several utility functions.
 
 Parses and validates a HTTP proxy URL. If the proxy requires authentication,
 then the function starts an open local proxy server that forwards to the proxy.
-The port is chosen randomly.
+The port (on which the local proxy server will start) can be set via the `port` property of the first argument, if not provided, it will be chosen randomly.
 
 The function takes an optional callback that receives the anonymous proxy URL.
 If no callback is supplied, the function returns a promise that resolves to a String with