Document parallel download option with xargs.

doc/README.txt

@@ -53,6 +53,11 @@ strip of all of them:
 
 `$ dosage @`
 
+On Unix, ``xargs`` can download several comic strips in parallel,
+for example using up to 4 processes:
+
+`$ cd Comics && find . -type d | xargs -n1 -P4 dosage -b . -v`
+
 For advanced options and features execute `dosage -h` or look at the dosage
 manual page.
 

doc/changelog.txt

@@ -5,6 +5,8 @@ Features:
 - comics: Added PandyLand comic strip.
 - comics: Added all comic strips from Arcamax (eg. including
   Hagar the horrible).
+- documentation: Document parallel download option with xargs
+  on Unix systems.
 
 Changes:
 - comics: CyanideAndHappiness image filename now has the strip number prefixed.

doc/dosage.1

@@ -128,11 +128,18 @@ Retrieve the Penny Arcade strip for a given index:
 .RS
 .B dosage pennyarcade:2004\-07\-22
 .RE
+.PP
 Retrieve Calvin and Hobbes strips from a given index going backwards to
-the beginning until an existing file is found:
+the beginning.
 .RS
 .B dosage \-a calvinandhobbes:20120722
 .RE
+.PP
+On Unix, \fBxargs(1)\fP can download several comic strips in parallel,
+for example using up to 4 processes:
+.RS
+.B cd Comics && find . -type d | xargs -n1 -P4 dosage -b . -v
+.RE
 .SH ENVIRONMENT
 .IP HTTP_PROXY
 .B mainline

doc/dosage.1.html

@@ -177,13 +177,24 @@ Retrieve the Penny Arcade strip for a given index:
 
 </DL>
 
+<P>
+
 Retrieve Calvin and Hobbes strips from a given index going backwards to
-the beginning until an existing file is found:
+the beginning.
 <DL COMPACT><DT><DD>
 <B>dosage -a calvinandhobbes:20120722</B>
 
 </DL>
 
+<P>
+
+On Unix, <B><A HREF="../man1/xargs.1.html">xargs</A>(1)</B> can download several comic strips in parallel,
+for example using up to 4 processes:
+<DL COMPACT><DT><DD>
+<B>cd Comics &amp;&amp; find . -type d | xargs -n1 -P4 dosage -b . -v</B>
+
+</DL>
+
 <A NAME="lbAI">&nbsp;</A>
 <H2>ENVIRONMENT</H2>
 

doc/dosage.txt

@@ -114,10 +114,16 @@ EXAMPLES
 
        Retrieve the Penny Arcade strip for a given index:
               dosage pennyarcade:2004-07-22
+
        Retrieve  Calvin  and  Hobbes  strips  from a given index going
-       backwards to the beginning until an existing file is found:
+       backwards to the beginning.
               dosage -a calvinandhobbes:20120722
 
+       On Unix, xargs(1) can download several comic strips  in  paral‐
+       lel, for example using up to 4 processes:
+              cd  Comics && find . -type d | xargs -n1 -P4 dosage -b .
+              -v
+
 ENVIRONMENT
        HTTP_PROXY
               mainline will use the specified HTTP  proxy  when  down‐