.SH COPYRIGHT
Copyright \(co 2004-2005 Tristan Seligmann and Jonathan Jacobs
.br
Copyright \(co 2012-2014 Bastian Kleineidam
dosage-2.12/doc/dosage.1.html 0000664 0000000 0000000 00000016250 12270563672 0015752 0 ustar 00root root 0000000 0000000
Man page of DOSAGE
DOSAGE
Section: User Commands (1)
Index
Return to Main Contents
NAME
dosage - a comic strip downloader and archiver
SYNOPSIS
dosage [options] module...
DESCRIPTION
dosage
is an application designed to keep a local mirror of specific
web comics and other picture-based content, such as
Picture Of The Day sites, with a variety of options
for updating and maintaining collections.
OPTIONS
- -b PATH, --basepath=PATH
-
Specifies a base path to put comic subdirectories. The default is Comics.
- --baseurl=PATH
-
Specifies the base URL for output handlers. The default is a local file URI.
- -a, --all
-
Traverses all available strips backwards from the current one.
This can be useful you want a full collection of a new comic strip,
or update an existing one where files are missing.
Catchups can start at a specific strip by using the index syntax, see
the
INDEX SYNTAX
and
SPECIAL SYNTAX
sections for more information. This is useful when you missed some days
and want only to download the missing files.
- -c, --continue
-
Same as --all, but stop at the first existing image file.
Useful for cron jobs that are not executed every day.
- -h, --help
-
Output brief help information.
- -l, --list
-
List available comic modules in multi-column fashion.
- --singlelist
-
List available comic modules in single-column fashion.
- -m MODULE, --modulehelp=MODULE
-
Output module-specific help for MODULE.
- -o OUTPUT, --output=OUTPUT
-
OUTPUT may be any one of the following:
-
html -
Writes out an HTML file linking to the strips actually downloaded in the
current run, named by date (ala dailystrips). The files can be found in the
html directory of your Comics directory.
-
rss -
Writes out an RSS feed detailing what strips were downloaded in the last 24
hours. The feed can be found in Comics/dailydose.xml.
-
json -
Write a JSON file with all download infos (URLs, images). Can be used with
other scripts, eg. order-symlinks.py to add symbolic links.
This option can be given multiple times.
- -t, --timestamps
-
Print timestamps for all output at any level.
- -v, --verbose
-
Increase the output level by one with each occurence.
- -V, --version
-
Display the version number.
- --vote
-
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
module
At least one valid
module
must be specified. A list of valid modules 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
Instead of starting at the latest comic strip, an index lets dosage start
at a certain strip. The index can be specified by appending a colon :
and the index name after the module. Multiple comma-spearated indices can
also be specified.
The index name itself usually is the part of the comic strip URL that identifiess
a strip, eg. a number or a date. The expected format is documented when using
the --modulehelp option.
SPECIAL SYNTAX
- @
-
This expands to mean all the comics currently in your Comics
directory. All other specified comic module names will be ignored.
- @@
-
This expands to mean all the comics available to Dosage.
INDEX SYNTAX can not be used with SPECIAL SYNTAX.
EXAMPLES
Retrieve all Mega Tokyo comics:
-
dosage -a megatokyo
Retrieve the current comic of Cyanide and Happiness:
-
dosage cyanideandhappiness
Retrieve the current strip of all comics in your Comics directory:
-
dosage @
Vote for the comics in your Comics directory:
-
dosage --vote @
Retrieve the current strip of every comic that there is a module for:
-
dosage @@
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.
-
dosage -a calvinandhobbes:2012/07/22
ENVIRONMENT
- HTTP_PROXY
-
dosage
will use the specified HTTP proxy when downloading URL contents.
NOTES
Should retrieval fail on any given strip
dosage
will attempt to retry. However the retry information is only outputted
in the
second
and successive output levels.
At the time of writing, a
complete
Dosage collection weighs in at around 3.0GB.
RETURN VALUE
The return value greater than zero when
- •
-
a program error occurred.
- •
-
comics could not be found or downloaded
- •
-
the program run was aborted with Ctrl-C
Else the return value is zero.
BUGS
Users can report or view bugs, patches or feature suggestions at
https://github.com/wummel/dosage/issues
AUTHORS
Jonathan Jacobs, Tristan Seligmann, Bastian Kleineidam <bastian.kleineidam@web.de>
COPYRIGHT
Copyright © 2004-2005 Tristan Seligmann and Jonathan Jacobs
Copyright © 2012-2014 Bastian Kleineidam
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- INDEX SYNTAX
-
- SPECIAL SYNTAX
-
- EXAMPLES
-
- ENVIRONMENT
-
- NOTES
-
- RETURN VALUE
-
- BUGS
-
- AUTHORS
-
- COPYRIGHT
-
This document was created by
man2html,
using the manual pages.
dosage-2.12/doc/dosage.1.html.diff 0000664 0000000 0000000 00000001030 12270563672 0016647 0 ustar 00root root 0000000 0000000 --- dosage.1.html.orig 2013-03-26 19:02:14.690504207 +0100
+++ dosage.1.html 2013-03-26 19:04:24.808185171 +0100
@@ -4,7 +4,7 @@
DOSAGE
Section: User Commands (1)
Index
-Return to Main Contents
+Return to Main Contents
NAME
@@ -282,7 +282,7 @@
This document was created by
-man2html,
+man2html,
using the manual pages.
dosage-2.12/doc/dosage.txt 0000664 0000000 0000000 00000014014 12270563672 0015462 0 ustar 00root root 0000000 0000000 DOSAGE(1) DOSAGE(1)
NAME
dosage - a comic strip downloader and archiver
SYNOPSIS
dosage [options] module...
DESCRIPTION
dosage is an application designed to keep a local mirror of
specific web comics and other picture-based content, such as
Picture Of The Day sites, with a variety of options for updatâ€
ing and maintaining collections.
OPTIONS
-b PATH, --basepath=PATH
Specifies a base path to put comic subdirectories. The
default is Comics.
--baseurl=PATH
Specifies the base URL for output handlers. The default
is a local file URI.
-a, --all
Traverses all available strips backwards from the curâ€
rent one. This can be useful you want a full collection
of a new comic strip, or update an existing one where
files are missing. Catchups can start at a specific
strip by using the index syntax, see the INDEX SYNTAX
and SPECIAL SYNTAX sections for more information. This
is useful when you missed some days and want only to
download the missing files.
-c, --continue
Same as --all, but stop at the first existing image
file. Useful for cron jobs that are not executed every
day.
-h, --help
Output brief help information.
-l, --list
List available comic modules in multi-column fashion.
--singlelist
List available comic modules in single-column fashion.
-m MODULE, --modulehelp=MODULE
Output module-specific help for MODULE.
-o OUTPUT, --output=OUTPUT
OUTPUT may be any one of the following:
html - Writes out an HTML file linking to the strips
actually downloaded in the current run, named by date
(ala dailystrips). The files can be found in the html
directory of your Comics directory.
rss - Writes out an RSS feed detailing what strips were
downloaded in the last 24 hours. The feed can be found
in Comics/dailydose.xml.
json - Write a JSON file with all download infos (URLs,
images). Can be used with other scripts, eg. order-symâ€
links.py to add symbolic links.
This option can be given multiple times.
-t, --timestamps
Print timestamps for all output at any level.
-v, --verbose
Increase the output level by one with each occurence.
-V, --version
Display the version number.
--vote 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://wumâ€
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
Instead of starting at the latest comic strip, an index lets
dosage start at a certain strip. The index can be specified by
appending a colon : and the index name after the module. Multiâ€
ple comma-spearated indices can also be specified.
The index name itself usually is the part of the comic strip
URL that identifiess a strip, eg. a number or a date. The
expected format is documented when using the --modulehelp
option.
SPECIAL SYNTAX
@ This expands to mean all the comics currently in your
Comics directory. All other specified comic module names
will be ignored.
@@ This expands to mean all the comics available to Dosage.
INDEX SYNTAX can not be used with SPECIAL SYNTAX.
EXAMPLES
Retrieve all Mega Tokyo comics:
dosage -a megatokyo
Retrieve the current comic of Cyanide and Happiness:
dosage cyanideandhappiness
Retrieve the current strip of all comics in your Comics direcâ€
tory:
dosage @
Vote for the comics in your Comics directory:
dosage --vote @
Retrieve the current strip of every comic that there is a modâ€
ule for:
dosage @@
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.
dosage -a calvinandhobbes:2012/07/22
ENVIRONMENT
HTTP_PROXY
dosage will use the specified HTTP proxy when downloadâ€
ing URL contents.
NOTES
Should retrieval fail on any given strip dosage will attempt to
retry. However the retry information is only outputted in the
second and successive output levels.
At the time of writing, a complete Dosage collection weighs in
at around 3.0GB.
RETURN VALUE
The return value greater than zero when
· a program error occurred.
· comics could not be found or downloaded
· the program run was aborted with Ctrl-C
Else the return value is zero.
BUGS
Users can report or view bugs, patches or feature suggestions
at https://github.com/wummel/dosage/issues
AUTHORS
Jonathan Jacobs, Tristan Seligmann, Bastian Kleineidam
COPYRIGHT
Copyright © 2004-2005 Tristan Seligmann and Jonathan Jacobs
Copyright © 2012-2014 Bastian Kleineidam
DOSAGE(1)
dosage-2.12/doc/icon/ 0000775 0000000 0000000 00000000000 12270563672 0014407 5 ustar 00root root 0000000 0000000 dosage-2.12/doc/icon/Makefile 0000664 0000000 0000000 00000000411 12270563672 0016043 0 ustar 00root root 0000000 0000000 ICOICONS := logo16x16.png logo32x32.png
ICNSICONS := logo16x16.png logo32x32.png logo48x48.png logo128x128.png
all: favicon.ico favicon.icns
favicon.ico: $(ICOICONS)
png2ico favicon.ico $(ICOICONS)
favicon.icns: $(ICNSICONS)
png2icns favicon.icns $(ICNSICONS)
dosage-2.12/doc/icon/favicon.icns 0000664 0000000 0000000 00000127554 12270563672 0016730 0 ustar 00root root 0000000 0000000 icns ¯lis32 ë »€…‡ èß F–‰_žÈöƒ
|¦‹Zjro[:`‚ €âòî»Wqs7idqü€ Ê•ÖÏÄ¿aæ„D]‚ s²¶¦«®OBvÉgï‚
R‘®G`AoÒyƒ SŒ‰TQ_;g1 à‚ Tƒ›m:M Sø‚ S‚O7‚ tƒ ZV€ $I ý„ …•Ì߀ Åž ¹„„‡ àâ QÏÀbšÆõƒ
h@”PLzŠˆmOb‚ ˆ€ÿ×j=l˜Šhnü€ ÇñêâäY:N<`‚ sÔØÌÍÓ?@ó‚
XÁ»¶ÎAQ(•nƒ X¶®¼`T91 à‚ W§¸g1) Sø‚ V¢K"‚ tƒ [c
€ $I ý„ …•Ì߀ Åž ¹…‚‡ ßá Wëßc˜Äôƒ
c-•K;s‘”y[b‚ Š€ÿäq6y«jmü€ Æ·ýöñøY?-+^‚ råéáßä\ö‚
ZÚÑËß