diff --git a/doc/README.txt b/doc/README.txt index acaaae239..88391f292 100644 --- a/doc/README.txt +++ b/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. diff --git a/doc/changelog.txt b/doc/changelog.txt index 7071f05d8..2e067dc58 100644 --- a/doc/changelog.txt +++ b/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. diff --git a/doc/dosage.1 b/doc/dosage.1 index a123e0e3e..71812de0d 100644 --- a/doc/dosage.1 +++ b/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 diff --git a/doc/dosage.1.html b/doc/dosage.1.html index 3f4c8b3d9..468869cc1 100644 --- a/doc/dosage.1.html +++ b/doc/dosage.1.html @@ -177,13 +177,24 @@ Retrieve the Penny Arcade strip for a given index: +
+ Retrieve Calvin and Hobbes strips from a given index going backwards to -the beginning until an existing file is found: +the beginning.
+ +On Unix, xargs(1) can download several comic strips in parallel, +for example using up to 4 processes: +