Updated documentation.

[ci skip]
This commit is contained in:
Bastian Kleineidam 2013-04-09 23:40:35 +02:00
parent eb7247623b
commit 0371943c3f
3 changed files with 36 additions and 22 deletions

View file

@ -77,6 +77,11 @@ Increase the output level by one with each occurence.
.TP .TP
\fB\-V\fP, \fB\-\-version\fP \fB\-V\fP, \fB\-\-version\fP
Display the version number. Display the version number.
.TP
\fB\-\-vote\fP
Vote for the selected comics to tell others that you like them.
The sum of all votes for a comic will be displayed at the comic
index pages at http://wummel.github.io/dosage/comic-index.html
.I module .I module
At least one valid At least one valid
.I module .I module

View file

@ -94,6 +94,10 @@ Print timestamps for all output at any level.
Increase the output level by one with each occurence. Increase the output level by one with each occurence.
<DT><B>-V</B>, <B>--version</B><DD> <DT><B>-V</B>, <B>--version</B><DD>
Display the version number. Display the version number.
<DT><B>--vote</B><DD>
Vote for the selected comics to tell others that you like them.
The sum of all votes for a comic will be displayed at the comic
index pages at <A HREF="http://wummel.github.io/dosage/comic-index.html">http://wummel.github.io/dosage/comic-index.html</A>
<I>module</I> <I>module</I>
At least one valid At least one valid

View file

@ -74,26 +74,31 @@ OPTIONS
Increase the output level by one with each occurence. Increase the output level by one with each occurence.
-V, --version -V, --version
Display the version number. module At least one valid Display the version number.
module must be specified. A list of valid modules can be
found by passing the -l option. Multiple module argu --vote Vote for the selected comics to tell others that you
ments can be specified on the command line. Module like them. The sum of all votes for a comic will be
names are case insensitive, and it is sufficient to displayed at the comic index pages at http://wum
specify a unique substring of the module name. mel.github.io/dosage/comic-index.html module At least
one valid module must be specified. A list of valid mod
ules can be found by passing the -l option. Multiple
module arguments can be specified on the command line.
Module names are case insensitive, and it is sufficient
to specify a unique substring of the module name.
INDEX SYNTAX INDEX SYNTAX
Instead of starting at the latest comic strip, an index lets Instead of starting at the latest comic strip, an index lets
dosage start at a certain strip. The index can be specified by dosage start at a certain strip. The index can be specified by
appending a colon : and the index name after the module. Multi appending a colon : and the index name after the module. Multi
ple comma-spearated indices can also be specified. ple comma-spearated indices can also be specified.
The index name itself usually is the part of the comic strip The index name itself usually is the part of the comic strip
URL that identifiess a strip, eg. a number or a date. The URL that identifiess a strip, eg. a number or a date. The
expected format is documented when using the --modulehelp expected format is documented when using the --modulehelp
option. option.
SPECIAL SYNTAX SPECIAL SYNTAX
@ This expands to mean all the comics currently in your @ This expands to mean all the comics currently in your
Comics directory. All other specified comic module names Comics directory. All other specified comic module names
will be ignored. will be ignored.
@ -108,40 +113,40 @@ EXAMPLES
Retrieve the current comic of Cyanide and Happiness: Retrieve the current comic of Cyanide and Happiness:
dosage cyanideandhappiness dosage cyanideandhappiness
Retrieve the current strip of all comics in your Comics direc Retrieve the current strip of all comics in your Comics direc
tory: tory:
dosage @ dosage @
Vote for the comics in your Comics directory: Vote for the comics in your Comics directory:
dosage --vote @ dosage --vote @
Retrieve the current strip of every comic that there is a mod Retrieve the current strip of every comic that there is a mod
ule for: ule for:
dosage @@ dosage @@
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. backwards to the beginning.
dosage -a calvinandhobbes:2012/07/22 dosage -a calvinandhobbes:2012/07/22
On Unix, xargs(1) can download several comic strips in paral On Unix, xargs(1) can download several comic strips in paral
lel, for example using up to 4 processes: lel, for example using up to 4 processes:
cd Comics && find . -type d | xargs -n1 -P4 dosage -b . cd Comics && find . -type d | xargs -n1 -P4 dosage -b .
-v -v
ENVIRONMENT ENVIRONMENT
HTTP_PROXY HTTP_PROXY
dosage will use the specified HTTP proxy when download dosage will use the specified HTTP proxy when download
ing URL contents. ing URL contents.
NOTES NOTES
Should retrieval fail on any given strip dosage will attempt to Should retrieval fail on any given strip dosage will attempt to
retry. However the retry information is only outputted in the retry. However the retry information is only outputted in the
second and successive output levels. second and successive output levels.
At the time of writing, a complete Dosage collection weighs in At the time of writing, a complete Dosage collection weighs in
at around 3.0GB. at around 3.0GB.
RETURN VALUE RETURN VALUE
@ -156,11 +161,11 @@ RETURN VALUE
Else the return value is zero. Else the return value is zero.
BUGS BUGS
Users can report or view bugs, patches or feature suggestions Users can report or view bugs, patches or feature suggestions
at https://github.com/wummel/dosage/issues at https://github.com/wummel/dosage/issues
AUTHORS AUTHORS
Jonathan Jacobs, Tristan Seligmann, Bastian Kleineidam <bas Jonathan Jacobs, Tristan Seligmann, Bastian Kleineidam <bas
tian.kleineidam@web.de> tian.kleineidam@web.de>
COPYRIGHT COPYRIGHT