dmoonfire/dosage
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Activity

Document parallel download option with xargs.

Browse source
This commit is contained in:
Bastian Kleineidam 2013-01-24 07:53:34 +01:00
parent 51d0176f53
commit 1b23e0c111
5 changed files with 34 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
doc/README.txt
View file

@ -53,6 +53,11 @@ strip of all of them:
`$ dosage @` `$ 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 For advanced options and features execute `dosage -h` or look at the dosage
manual page. manual page.

2
doc/changelog.txt
View file

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

9
doc/dosage.1
View file

@ -128,11 +128,18 @@ Retrieve the Penny Arcade strip for a given index:
.RS .RS
.B dosage pennyarcade:2004\-07\-22 .B dosage pennyarcade:2004\-07\-22
.RE .RE
.PP
Retrieve Calvin and Hobbes strips from a given index going backwards to Retrieve Calvin and Hobbes strips from a given index going backwards to
the beginning until an existing file is found: the beginning.
.RS .RS
.B dosage \-a calvinandhobbes:20120722 .B dosage \-a calvinandhobbes:20120722
.RE .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 .SH ENVIRONMENT
.IP HTTP_PROXY .IP HTTP_PROXY
.B mainline .B mainline

13
doc/dosage.1.html
View file

@ -177,13 +177,24 @@ Retrieve the Penny Arcade strip for a given index:
</DL> </DL>
<P>
Retrieve Calvin and Hobbes strips from a given index going backwards to 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> <DL COMPACT><DT><DD>
<B>dosage -a calvinandhobbes:20120722</B> <B>dosage -a calvinandhobbes:20120722</B>
</DL> </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> <A NAME="lbAI">&nbsp;</A>
<H2>ENVIRONMENT</H2> <H2>ENVIRONMENT</H2>

8
doc/dosage.txt
View file

@ -114,10 +114,16 @@ EXAMPLES
Retrieve the Penny Arcade strip for a given index: Retrieve the Penny Arcade strip for a given index:
dosage pennyarcade:2004-07-22 dosage pennyarcade:2004-07-22
Retrieve Calvin and Hobbes strips from a given index going 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 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 ENVIRONMENT
HTTP_PROXY HTTP_PROXY
mainline will use the specified HTTP proxy when down‐ mainline will use the specified HTTP proxy when down‐