dosage/doc/dosage.1.html

277 lines
6.9 KiB
HTML
Raw Normal View History

2012-06-20 19:58:13 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2012-10-11 12:17:10 +00:00
<HTML><HEAD><TITLE>Man page of DOSAGE</TITLE>
2012-06-20 19:58:13 +00:00
</HEAD><BODY>
2012-10-11 12:17:10 +00:00
<H1>DOSAGE</H1>
2012-06-20 19:58:13 +00:00
Section: User Commands (1)<BR><A HREF="#index">Index</A>
2012-12-17 20:28:20 +00:00
<A HREF="index.html">Return to Main Contents</A><HR>
2012-06-20 19:58:13 +00:00
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
2012-12-07 23:45:18 +00:00
dosage - a commandline webcomic downloader and archiver
2012-06-20 19:58:13 +00:00
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>dosage</B> [<I>options</I>] <I>module</I>...
2012-06-20 19:58:13 +00:00
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
2012-10-11 12:17:10 +00:00
<B>dosage</B>
2012-06-20 19:58:13 +00:00
is an application designed to keep a local mirror of specific
2012-10-11 12:17:10 +00:00
web comics and other picture-based content, such as
<I>Picture Of The Day</I> sites, with a variety of options
2012-06-20 19:58:13 +00:00
for updating and maintaining collections.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT><B>-b</B> <I>PATH</I>, <B>--basepath=</B><I>PATH</I><DD>
Specifies a base path to put comic subdirectories. The default is <B>Comics</B>.
<DT><B>--baseurl=</B><I>PATH</I><DD>
2012-06-20 19:58:13 +00:00
Specifies the base URL for output events. The default is a local file URI.
<DT><B>-a</B>, <B>--all</B><DD>
2012-10-11 12:17:10 +00:00
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
2012-06-20 19:58:13 +00:00
the
<B>INDEX SYNTAX</B>
and
<B>SPECIAL SYNTAX</B>
2012-10-11 12:17:10 +00:00
sections for more information. This is useful when you missed some days
and want only to download the missing files. To make this task easy,
the traversal ends at the first existing image file when starting from
an index (excluding the index itself).
<DT><B>-h</B>, <B>--help</B><DD>
2012-06-20 19:58:13 +00:00
Output brief help information.
<DT><B>-l</B>, <B>--list</B><DD>
2012-06-20 19:58:13 +00:00
List available comic modules in multi-column fashion.
<DT><B>--singlelist</B><DD>
2012-06-20 19:58:13 +00:00
List available comic modules in single-column fashion.
<DT><B>-m</B> <I>MODULE</I>, <B>--modulehelp=</B><I>MODULE</I><DD>
Output module-specific help for <I>MODULE</I>.
<DT><B>-o</B> <I>OUTPUT</I>, <B>--output=</B><I>OUTPUT</I><DD>
<I>OUTPUT</I> may be any one of the following:
2012-06-20 19:58:13 +00:00
</DL>
<P>
<DL COMPACT><DT><DD>
<B>html </B>-
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
<B>html</B> directory of your <B>Comics</B> directory.
2012-06-20 19:58:13 +00:00
</DL>
<P>
<DL COMPACT><DT><DD>
<B>rss </B>-
Writes out an RSS feed detailing what strips were downloaded in the last 24
hours. The feed can be found in <B>Comics/dailydose.xml</B>.
2012-06-20 19:58:13 +00:00
</DL>
<P>
<DL COMPACT><DT><DD>
<B>rss </B>-
Writes an RSS feed with all of the strips downloaded during the run, for use
with your favourite RSS aggregator.
</DL>
<DL COMPACT>
<DT><B>-t</B>, <B>--timestamps</B><DD>
2012-06-20 19:58:13 +00:00
Print timestamps for all output at any level.
<DT><B>-v</B>, <B>--verbose</B><DD>
2012-06-20 19:58:13 +00:00
Increase the output level by one with each occurence.
<DT><B>-V</B>, <B>--version</B><DD>
2012-06-20 19:58:13 +00:00
Display the version number.
<I>module</I>
At least one valid
<I>module</I>
must be specified. A list of valid modules can be found by passing the
<B>-l</B>
option. Multiple
<I>module</I>
arguments can be specified on the command line.
2012-10-11 12:17:10 +00:00
Module names are case insensitive, and it is sufficient to specify a
unique substring of the module name.
2012-06-20 19:58:13 +00:00
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>INDEX SYNTAX</H2>
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 <B>:</B>
and the index name after the module. Multiple comma-spearated indices can
also be specified.
2012-06-20 19:58:13 +00:00
<P>
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 <B>--modulehelp</B> option.
2012-06-20 19:58:13 +00:00
<A NAME="lbAG">&nbsp;</A>
<H2>SPECIAL SYNTAX</H2>
<DL COMPACT>
<DT><B>@</B>
<DD>
This expands to mean all the comics currently in your <B>Comics</B>
2012-10-11 12:17:10 +00:00
directory. All other specified comic module names will be ignored.
2012-06-20 19:58:13 +00:00
<DT><B>@@</B>
<DD>
This expands to mean all the comics available to Dosage.
</DL>
<P>
<B>INDEX SYNTAX</B> can not be used with <B>SPECIAL SYNTAX</B>.
<A NAME="lbAH">&nbsp;</A>
2012-06-20 19:58:13 +00:00
<H2>EXAMPLES</H2>
2012-10-11 12:17:10 +00:00
Retrieve all Mega Tokyo comics:
<DL COMPACT><DT><DD>
<B>dosage -a megatokyo</B>
</DL>
<P>
Retrieve the current comic of Cyanide and Happiness:
2012-06-20 19:58:13 +00:00
<DL COMPACT><DT><DD>
2012-10-11 12:17:10 +00:00
<B>dosage cyanideandhappiness</B>
2012-06-20 19:58:13 +00:00
</DL>
<P>
Retrieve the current strip of all comics in your <B>Comics</B> directory:
2012-06-20 19:58:13 +00:00
<DL COMPACT><DT><DD>
2012-10-11 12:17:10 +00:00
<B>dosage @</B>
2012-06-20 19:58:13 +00:00
</DL>
<P>
2012-10-11 12:17:10 +00:00
Retrieve the current strip of every comic that there is a module for:
2012-06-20 19:58:13 +00:00
<DL COMPACT><DT><DD>
2012-10-11 12:17:10 +00:00
<B>dosage @@</B>
</DL>
<P>
Retrieve the Penny Arcade strip for a given index:
<DL COMPACT><DT><DD>
<B>dosage pennyarcade:2004-07-22</B>
</DL>
Retrieve Calvin and Hobbes strips from a given index going backwards to
the beginning until an existing file is found:
<DL COMPACT><DT><DD>
2013-01-23 18:54:26 +00:00
<B>dosage -a calvinandhobbes:20120722</B>
2012-06-20 19:58:13 +00:00
</DL>
<A NAME="lbAI">&nbsp;</A>
2012-06-20 19:58:13 +00:00
<H2>ENVIRONMENT</H2>
<DL COMPACT>
<DT>HTTP_PROXY<DD>
<B>mainline</B>
will use the specified HTTP proxy when downloading URL contents.
2012-06-20 19:58:13 +00:00
</DL>
<A NAME="lbAJ">&nbsp;</A>
2012-06-20 19:58:13 +00:00
<H2>NOTES</H2>
Should retrieval fail on any given strip
<B>mainline</B>
will attempt to retry. However the retry information is only outputted
in the
<B>second</B>
and successive output levels.
<P>
At the time of writing, a
<B>complete</B>
Dosage collection weighs in at around 3.0GB.
<A NAME="lbAK">&nbsp;</A>
2012-06-20 19:58:13 +00:00
<H2>RETURN VALUE</H2>
2012-10-11 12:17:10 +00:00
The return value greater than zero when
2012-06-20 19:58:13 +00:00
<DL COMPACT>
<DT>&bull;<DD>
a program error occurred.
<DT>&bull;<DD>
comics could not be found or downloaded
<DT>&bull;<DD>
the program run was aborted with Ctrl-C
</DL>
<P>
Else the return value is zero.
<A NAME="lbAL">&nbsp;</A>
2012-06-20 19:58:13 +00:00
<H2>BUGS</H2>
Users can report or view bugs, patches or feature suggestions at
<I><A HREF="https://github.com/wummel/dosage/issues">https://github.com/wummel/dosage/issues</A></I>
2012-06-20 19:58:13 +00:00
<A NAME="lbAM">&nbsp;</A>
2012-06-20 19:58:13 +00:00
<H2>AUTHORS</H2>
2012-10-11 12:17:10 +00:00
Jonathan Jacobs &lt;<A HREF="mailto:korpse@slipgate.za.net">korpse@slipgate.za.net</A>&gt;
<BR>
Tristan Seligmann &lt;<A HREF="mailto:mithrandi@slipgate.za.net">mithrandi@slipgate.za.net</A>&gt;
<BR>
2012-12-17 20:28:20 +00:00
Bastian Kleineidam &lt;<A HREF="mailto:bastian.kleineidam@web.de">bastian.kleineidam@web.de</A>&gt;
<A NAME="lbAN">&nbsp;</A>
2012-10-11 12:17:10 +00:00
<H2>COPYRIGHT</H2>
Copyright &#169; 2004-2005 Tristan Seligmann and Jonathan Jacobs
<BR>
2012-06-20 19:58:13 +00:00
2013-01-09 21:21:19 +00:00
Copyright &#169; 2012-2013 Bastian Kleineidam
2012-06-20 19:58:13 +00:00
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">INDEX SYNTAX</A><DD>
<DT><A HREF="#lbAG">SPECIAL SYNTAX</A><DD>
<DT><A HREF="#lbAH">EXAMPLES</A><DD>
<DT><A HREF="#lbAI">ENVIRONMENT</A><DD>
<DT><A HREF="#lbAJ">NOTES</A><DD>
<DT><A HREF="#lbAK">RETURN VALUE</A><DD>
<DT><A HREF="#lbAL">BUGS</A><DD>
<DT><A HREF="#lbAM">AUTHORS</A><DD>
<DT><A HREF="#lbAN">COPYRIGHT</A><DD>
2012-06-20 19:58:13 +00:00
</DL>
<HR>
This document was created by
2012-12-17 20:28:20 +00:00
man2html,
2012-06-20 19:58:13 +00:00
using the manual pages.<BR>
</BODY>
</HTML>