2895. [func] genrandom: add support for the generation of multiple

files.  [RT #20917]

bin/tools/genrandom.docbook

@@ -17,7 +17,7 @@
  - PERFORMANCE OF THIS SOFTWARE.
 -->
 
-<!-- $Id: genrandom.docbook,v 1.4 2009/09/18 13:14:47 fdupont Exp $ -->
+<!-- $Id: genrandom.docbook,v 1.5 2010/05/17 04:38:45 marka Exp $ -->
 <refentry id="man.genrandom">
   <refentryinfo>
     <date>Feb 19, 2009</date>
@@ -44,6 +44,7 @@
   <refsynopsisdiv>
     <cmdsynopsis>
       <command>genrandom</command>
+      <arg><option>-n <replaceable class="parameter">number</replaceable></option></arg>
       <arg choice="req"><replaceable class="parameter">size</replaceable></arg>
       <arg choice="req"><replaceable class="parameter">filename</replaceable></arg>
     </cmdsynopsis>
@@ -53,15 +54,25 @@
     <title>DESCRIPTION</title>
     <para>
       <command>genrandom</command>
-      generates a file containing a specified quantity of pseudo-random
-      data, which can be used as a source of entropy for other commands
-      on systems with no random device.
+      generates a file or a set of files containing a specified quantity
+      of pseudo-random data, which can be used as a source of entropy for
+      other commands on systems with no random device.
     </para>
   </refsect1>
 
   <refsect1>
     <title>ARGUMENTS</title>
     <variablelist>
+      <varlistentry>
+        <term>-n <replaceable class="parameter">number</replaceable></term>
+        <listitem>
+          <para>
+            In place of generating one file, generates <option>number</option>
+            (from 2 to 9) files, appending <option>number</option> to the name.
+          </para>
+        </listitem>
+      </varlistentry>
+
       <varlistentry>
         <term>size</term>
         <listitem>