guides/user/Command-line-user-interface.md

@@ -73,13 +73,13 @@ in the [knowledge base](http://support.arachni-scanner.com/kb/).
     * [Debug (--debug)](#debug)
     * [Only positives (--only-positives)](#only-positives)
 * [HTTP](#http)
-    * [HTTP request limit (--http-req-limit)](#http-req-limit)
+    * [User agent (--http-user-agent)](#http-user-agent)
+    * [Request concurrency (--http-request-concurrency)](#http-req-limit)
     * [HTTP request queue size (--http-queue-size)](#http-queue-size)
     * [HTTP request timeout (--http-timeout)](#http-timeout)
     * [HTTPS only (--https-only)](#https-only)
     * [Cookie jar (--cookie-jar)](#cookie-jar)
     * [Cookie string (--cookie-string)](#cookie-string)
-    * [User agent (--user-agent)](#user-agent)
     * [Custom header (--custom-header)](#custom-header)
         * [Example](#custom-header_example)
     * [Login check URL (--login-check-url)](#login-check-url)
@@ -354,11 +354,21 @@ arachni http://example.com --debug 2> debug.log
 **Multiple invocations?**: `no`
 
 
-This will suppress all messages except for positive matches -- vulnerabilities.
+This will suppress all messages except for for the ones denoting sucess -- usually regarding the discovery of some issue.
 
 <h2 id='http'><a href='#http'>HTTP</a></h2>
 
-<h3 id='http-req-limit'><a href='#http-req-limit'>HTTP request limit (--http-req-limit)</a></h3>
+<h3 id='http-user-agent'><a href='#http-user-agent'>User agent (--http-user-agent)</a></h3>
+
+**Expects**: `string`
+
+**Default**: `"Arachni/<version>"`
+
+**Multiple invocations?**: `no`
+
+Specify a value for the `User-Agent` HTTP request header field.
+
+<h3 id='http-request-concurrency'><a href='#http-request-concurrency'>Request concurrency (--http-request-concurrency)</a></h3>
 
 **Expects**: `integer`
 
@@ -367,11 +377,11 @@ This will suppress all messages except for positive matches -- vulnerabilities.
 **Multiple invocations?**: `no`
 
 
-Limit how many concurrent HTTP request are sent.
+Sets the maximum amount of requests to be active at any given time; this usually directly translates to the amount of open connections.
 
-**Note**: If your scan seems unresponsive try lowering the limit.
+**Note**: If your scan seems unresponsive try lowering the limit to easy the server's burden.
 
-**Warning**: Given enough bandwidth and a high limit it could cause a DoS.
+**Warning**: Given enough bandwidth and a high enough concurrency setting the scan could cause a DoS.
 Be careful when setting this option too high, don't kill your server.
 
 <h3 id='http-queue-size'><a href='#http-queue-size'>HTTP request queue size (--http-queue-size)</a></h3>
@@ -444,18 +454,6 @@ Cookies, as a string, to be sent to the web application.
 
     --cookie-string='userid=19;sessionid=deadbeefbabe'
 
-<h3 id='user-agent'><a href='#user-agent'>User agent (--user-agent)</a></h3>
-
-**Expects**: `string`
-
-**Default**: `"Arachni/<version>"`
-
-**Multiple invocations?**: `no`
-
-
-You can pass your own user agent string which will be sent to the webserver under audit.
-Default is `Arachni/<version>`.
-
 <h3 id='custom-header'><a href='#custom-header'>Custom header (--custom-header)</a></h3>
 
 **Expects**: `string`