diff --git a/features/commandline.xml b/features/commandline.xml
index 575ec5de23..9d08c6c61f 100644
--- a/features/commandline.xml
+++ b/features/commandline.xml
@@ -1075,9 +1075,14 @@ $ some_application | some_filter | php | sort -u > final_output.txt
    can be passed to your script is not limited by PHP (the shell has a certain
    size limit in the number of characters which can be passed; usually you won't
    hit this limit). The arguments passed to your script are available in the
-   global array <varname>$argv</varname>. The zero index always contains the
-   script name (which is <literal>-</literal> in case the PHP codeis coming from
-   either standard input or from the command line switch <option>-r</option>).
+   global array <varname>$argv</varname>. The first index (zero) always contains the
+   name of the script as called from the command line.  Note that, if the code is
+   executed in-line using the command line switch <option>-r</option>, the value of
+   <varname>$argv[0]</varname> will be simply a dash (<literal>-</literal>).  The
+   same is true if the code is executed via a pipe from <literal>STDIN</literal>.
+  </para>
+
+  <para>
    The second registered global variable is <varname>$argc</varname> which
    contains the number of elements in the <varname>$argv</varname> array
    (<emphasis role="strong">not</emphasis> the number of arguments passed to the