3
mainline \- command line interface to Dosage
11
is a command line interface to Dosage. Dosage is a an application designed
12
to keep a local \(oqmirror\(cq of specific web comics and other picture\-based
13
content, such as \(oqPicture Of The Day\(cq sites, with a variety of options
14
for updating and maintaining collections.
17
.BI \-b " PATH" "\fR,\fP \-\^\-base\--path=" PATH
18
Specifies a base path to put comic subdirectories. The default is \(oqComics\(cq.
20
.BI \-\^\-base\-url= PATH
21
Specifies the base URL for output events. The default is a local file URI.
23
.BR \-c ", " \-\^\-catch-up
24
Traverses all available strips until an (identical) existing one is found.
25
This can be useful if your collection was previously up to date,
26
but you've missed a few days worth of strips. Alternatively you can specify
28
twice for a \(oqfull catchup\(cq, which will not stop until all comics
29
have been traversed. Catchups can \(oqresumed\(cq by using the index syntax, see
34
sections for more information.
36
.BR \-h ", " \-\^\-help
37
Output brief help information.
39
.BR \-l ", " \-\^\-list
40
List available comic modules in multi\-column fashion.
42
.BR \-\^\-single\-list
43
List available comic modules in single-column fashion.
45
.BI \-m " MODULE" "\fR,\fP \-\^\-module-help=" MODULE
46
Output module-specific help for
49
.BI \-o " OUTPUT" "\fR,\fP \-\^\-output=" OUTPUT
51
may be any one of the following:
55
Provides no additional output and is the default value.
60
Writes out an HTML file linking to the strips actually downloaded in the
61
current run, named by date (ala dailystrips). The files can be found in the
62
\'html' directory of your Comics directory.
67
Writes out an RSS feed detailing what strips were downloaded in the last 24
68
hours. The feed can be found in Comics/dailydose.xml.
73
Writes an RSS feed with all of the strips downloaded during the run, for use
74
with your favourite RSS aggregator.
77
.BR \-p ", " \-\^\-progress
78
Display a progress bar while downloading comics.
80
.BR \-q ", " \-\^\-quiet
81
Decrease the output level by one with each occurence.
83
.BR \-t ", " \-\^\-timestamps
84
Print timestamps for all output at any level.
86
.BR \-v ", " \-\^\-verbose
87
Increase the output level by one with each occurence.
89
.BR \-V ", " \-\^\-version
90
Display the version number.
94
must be specified. A list of valid modules can be found by passing the
98
arguments can be specified on the command line.
100
One can indicate the start of a list of
107
is specified with index syntax then \(oqresume\(cq mode is activated,
108
where a \(oqcatchup\(cq will start at the given index.
114
Some users may find certain comics offensive and wish to disable them.
116
.B /etc/dosage/disabled
118
.B ~/.dosage/disabled
119
will be disabled. These files should contain only one module name per line.
123
This expands to mean all the comics currently in your \(oqComics\(cq
127
This expands to mean all the comics available to Dosage.
132
but this is unlikely to be useful.
134
Retrieve the latest Mega Tokyo comic:
136
.B mainline MegaTokyo
139
Retrieve every strip from every comic that there is a module for:
144
Retrieve all Penny Arcade strips from (and including) a given index to
145
the beginning regardless of whether they already exist or not:
147
.B mainline \-c PennyArcade:2004\-07\-22
152
will use the specified HTTP proxy whenever possible.
154
Should retrieval fail on any given strip
156
will attempt to retry. However the retry information is only outputted
159
and successive output levels.
161
At the time of writing, a
163
Dosage collection weighs in at around 3.0GB.
166
.I http://trac.slipgate.za.net/dosage
167
for a list of current development tasks and suggestions.
169
.IP "\fB/etc/dosage/disabled\fR"
170
Disables comic modules on a global scale.
171
.IP "\fB~/.dosage/disabled\fR"
172
Disables comic modules on a local scale.
174
.BR mainline " and " Dosage
175
were written by Jonathan Jacobs <korpse@slipgate.za.net> and Tristan Seligmann
176
<mithrandi@slipgate.za.net>. This manual page was written by Jonathan Jacobs.
added
removed
doc/mainline.1
