#include <infodrom.style>

<page title="Infodrom Oldenburg Tools">

<h2>Debian upscan</h2>

<p>From a maintainer's point of view I need to see when a new upstream
version of a package is available.  When maintaining a lot of
different packages and also working on other stuff one easily forgets
to check remote servers frequently, hence, missing new upstream
versions.</p>

<p>In the <a href="http://packages.debian.org/devscripts">\
devscripts</a> package the program <code>uscan</code> should do the
monitoring.  However, for some reason it did not work for me and it
also did not support an ftp/http proxy, which is a requirement for
me.  Hence, I had to develop a similar tool on my own.</p>

<h3>Synopsis</h3>

<pre>
  upscan [--config|-c config] [--proxy|-p proxy-path]
</pre>

<h3>Configuration</h3>

<p>The configuration is similar to the one in <code>uscan</code>.  You
can place multiple sources in the same configuration file, which looks
like:</p>

<pre>
manpages \
  ftp://ftp.win.tue.nl/pub/linux-local/manpages/man-pages-(.*)\.tar\.gz \
  1.60 \
  mail=joey
</pre>

<p>You can place everything in one line if you like.  The four fields
have the following meaning:</p>

<p><ol>

<li> Name of the package will be used for the second bug header.

<li> Path to the upstream source, where the last component is a
     regular expression (see <code>perlre</code>) and should place the
     version in <code>$1</code>.  It can either be a HTTP or a FTP
     URL.  The last component will be matched.

<li> The current version.  Only more recent versions will be
     reported.  Older versions will be ignored.

<li> The action to be taken.  <code>mail=addr</code> means to send a
     mail to the given address.  This is currently the only action
     supported.  More will be ipmlemented on demand.

</ol></p>

<h3>Source</h3>

<p><a href="http://cvs.infodrom.org/tools/debian/upscan?cvsroot=infodrom">CVS</a>.
<p><a href="http://cvs.infodrom.org/~checkout~/tools/debian/upscan?rev=HEAD&content-type=text/plain&cvsroot=infodrom">Download</a>.

</page>

# Local variables:
# mode: indented-text
# end: