Mercurial > projects > relmon

annotate relmon.1.xml @ 5:86a0c5d11f05 version-1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add discover subcommand The discover subcommand assists with the creation of watchlist entries and allows to reproduce each step of an update operation for a watchlist entry.
author Guido Berhoerster <guido+relmon@berhoerster.name>
date Sun, 26 Oct 2014 21:36:05 +0100
parents f28486666a4f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
1 <?xml version="1.0"?>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
2 <!--
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
3
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
4 Copyright (C) 2014 Guido Berhoerster <guido+relmon@berhoerster.name>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
5
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
6 Permission is hereby granted, free of charge, to any person obtaining
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
7 a copy of this software and associated documentation files (the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
8 "Software"), to deal in the Software without restriction, including
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
9 without limitation the rights to use, copy, modify, merge, publish,
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
10 distribute, sublicense, and/or sell copies of the Software, and to
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
11 permit persons to whom the Software is furnished to do so, subject to
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
12 the following conditions:
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
13
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
14 The above copyright notice and this permission notice shall be included
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
15 in all copies or substantial portions of the Software.
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
16
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
17 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
18 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
19 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
20 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
21 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
22 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
23 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
24
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
25 -->
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
26 <refentry xmlns="http://docbook.org/ns/docbook" xml:lang="en">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
27 <info>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
28 <author>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
29 <personname>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
30 <firstname>Guido</firstname>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
31 <surname>Berhoerster</surname>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
32 </personname>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
33 <email>guido+relmon@berhoerster.name</email>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
34 <personblurb/>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
35 </author>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
36 <date>24 October, 2014</date>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
37 </info>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
38 <refmeta>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
39 <refentrytitle>relmon</refentrytitle>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
40 <manvolnum>1</manvolnum>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
41 <refmiscinfo class="source"/>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
42 <refmiscinfo class="version"/>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
43 <refmiscinfo class="manual">User Commands</refmiscinfo>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
44 </refmeta>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
45 <refnamediv>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
46 <refname>relmon</refname>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
47 <refpurpose>monitor websites of software projects for releases</refpurpose>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
48 </refnamediv>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
49 <refsynopsisdiv>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
50 <cmdsynopsis>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
51 <command>relmon list</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
52 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
53 <option>-H</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
54 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
55 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
56 <option>-f</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
57 <group choice="plain">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
58 <arg choice="plain">html</arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
59 <arg choice="plain">parseable</arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
60 <arg choice="plain">text</arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
61 </group>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
62 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
63 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
64 <option>-F</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
65 <replaceable>url</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
66 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
67 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
68 <option>-n</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
69 <replaceable>number_items</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
70 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
71 <arg choice="plain">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
72 <replaceable>statefile</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
73 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
74 </cmdsynopsis>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
75 <cmdsynopsis>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
76 <command>relmon list</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
77 <arg choice="plain">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
78 <option>-f</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
79 <arg choice="plain">atom</arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
80 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
81 <arg choice="plain">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
82 <option>-F</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
83 <arg choice="plain">url</arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
84 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
85 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
86 <option>-n</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
87 <replaceable>number_items</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
88 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
89 <arg choice="plain">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
90 <replaceable>statefile</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
91 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
92 </cmdsynopsis>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
93 <cmdsynopsis>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
94 <command>relmon show</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
95 <arg choice="plain">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
96 <replaceable>statefile</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
97 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
98 <arg choice="plain" rep="repeat">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
99 <replaceable>name</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
100 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
101 </cmdsynopsis>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
102 <cmdsynopsis>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
103 <command>relmon update</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
104 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
105 <option>-d</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
106 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
107 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
108 <option>-e</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
109 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
110 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
111 <option>-v</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
112 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
113 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
114 <option>-c</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
115 <replaceable>max_connections</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
116 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
117 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
118 <option>-C</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
119 <replaceable>ca_dir</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
120 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
121 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
122 <option>-D</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
123 <replaceable>delay</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
124 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
125 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
126 <option>-H</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
127 <replaceable>max_host_connections</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
128 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
129 <arg choice="opt"><option>-i</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
130 <arg choice="plain"><replaceable>item</replaceable></arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
131 <arg choice="opt" rep="repeat"><replaceable>,</replaceable></arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
132 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
133 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
134 <option>-l</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
135 <replaceable>logfile</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
136 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
137 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
138 <option>-r</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
139 <replaceable>retries</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
140 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
141 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
142 <option>-t</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
143 <replaceable>min_time</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
144 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
145 <arg choice="plain">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
146 <replaceable>watchlist</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
147 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
148 <arg choice="plain">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
149 <replaceable>statefile</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
150 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
151 </cmdsynopsis>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
152 <cmdsynopsis>
5
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
153 <command>relmon discover</command>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
154 <arg choice="opt">
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
155 <option>-d</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
156 </arg>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
157 <arg choice="opt">
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
158 <option>-c</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
159 <replaceable>max_connections</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
160 </arg>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
161 <arg choice="opt">
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
162 <option>-C</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
163 <replaceable>ca_dir</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
164 </arg>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
165 <arg choice="opt">
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
166 <option>-D</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
167 <replaceable>delay</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
168 </arg>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
169 <arg choice="opt">
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
170 <option>-H</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
171 <replaceable>max_host_connections</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
172 </arg>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
173 <arg choice="opt">
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
174 <option>-r</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
175 <replaceable>retries</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
176 </arg>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
177 <arg choice="opt">
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
178 <option>-t</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
179 <replaceable>min_time</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
180 </arg>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
181 <arg choice="plain">
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
182 <replaceable>base_url</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
183 </arg>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
184 <arg choice="opt">
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
185 <replaceable>pattern</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
186 </arg>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
187 </cmdsynopsis>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
188 <cmdsynopsis>
4
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
189 <command>relmon help</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
190 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
191 <replaceable>subcommand</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
192 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
193 </cmdsynopsis>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
194 </refsynopsisdiv>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
195 <refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
196 <title>Description</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
197 <para><command>relmon</command> is a utility for monitoring websites of
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
198 software projects for new releases. It can crawl websites via HTTP or
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
199 HTTPS using a configurable number of simultaneous connections and parse
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
200 HTML and XHTML documents as well as RSS 2.0 and Atom feeds. Software
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
201 releases are detected by extracting the version numbers from links to
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
202 distribution files from the parsed documents or feeds and comparing them
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
203 to previously extracted version numbers.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
204 <para>The crawling of the website of a software projects and the extraction
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
205 of version numbers are controlled by an entry with directions in a
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
206 watchlist file, see
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
207 <citerefentry><refentrytitle>relmon_watchlist</refentrytitle>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
208 <manvolnum>4</manvolnum></citerefentry> for the exact format of
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
209 watchlist entries and further details on the operation of
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
210 <command>relmon</command>. In addition to the version numbers, the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
211 history of releases consisting of the times new release were initially
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
212 discovered, any encountered errors and the time the version information
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
213 was last updated are recorded in a statefile. <command>relmon</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
214 can selectively update explicitly specified items or on the basis of the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
215 time an item was last updated or whether any errors were encountered
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
216 during the previous update of an item.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
217 <para>The recorded information on each software project can be output in
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
218 several different formats, including formatted text, machine-parseable
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
219 text, and HTML, optionally with the history of releases in Atom feed
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
220 format.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
221 </refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
222 <refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
223 <title>Subcommands</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
224 <variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
225 <para><command>relmon</command> has the following subcommands:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
226 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
227 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
228 <command>list</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
229 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
230 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
231 <para>List version information for each software project in the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
232 statefile in a tabular form and/or the history of releases in the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
233 specified output format</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
234 <variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
235 <para>The following options are supported:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
236 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
237 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
238 <option>-f</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
239 <replaceable>format</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
240 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
241 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
242 <para>Emit output in the specified format. Possible values for
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
243 <replaceable>format</replaceable> are html, atom, parseable
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
244 and text, the default output format is text. The parseable
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
245 format consist of one line per software project with four
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
246 fields seperated by a single tab containing the name,
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
247 version, timestamp and status. If the atom format is
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
248 selected, an Atom feed which only contains the history of
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
249 releases is emitted. Otherwise version information for each
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
250 software project in the statefile is emitted in a tabular
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
251 form.
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
252 </para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
253 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
254 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
255 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
256 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
257 <option>-F</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
258 <replaceable>url</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
259 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
260 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
261 <para>If the output format is set to html, add a link to an
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
262 Atom feed with the specified URL. If the output format is
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
263 atom, use the specified URL as the URL where the Atom feed is
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
264 published. This option is mandatory if the atom ouput format
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
265 is selected.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
266 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
267 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
268 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
269 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
270 <option>-H</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
271 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
272 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
273 <para>Include the history of released versions in the output.
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
274 If the parseable ouput format was selected, the history is
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
275 separated with a single blank line from the version
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
276 information and consists of one line per history entry with
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
277 three fields seperated by a single tab containing the times,
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
278 name and version.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
279 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
280 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
281 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
282 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
283 <option>-n</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
284 <replaceable>number_items</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
285 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
286 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
287 <para>If used in combination with the <option>-H</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
288 option or if the atom ouput format was selected, limit the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
289 output to the specified number of recent history
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
290 entries.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
291 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
292 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
293 </variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
294 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
295 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
296 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
297 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
298 <command>show</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
299 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
300 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
301 <para>The <command>show</command> subcommand shows the name, latest
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
302 version, time of the last update, all known version nubers and
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
303 links to the corresponding distribution files, any errors
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
304 encountered during the last update operation, as well as the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
305 release history for each specified software project from the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
306 specified statefile.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
307 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
308 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
309 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
310 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
311 <command>update</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
312 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
313 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
314 <para>The <command>update</command> subcommand gathers information
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
315 on all or a specified subset of the software projects specified in
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
316 the watchlist and updates or creates a new statefile. Before
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
317 updating the statefile a backup copy is created using the current
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
318 filename with a <literal>~</literal> suffix added to it.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
319 <para>The following options are supported:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
320 <variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
321 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
322 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
323 <option>-d</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
324 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
325 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
326 <para>Trace and log all transfers and parsing. This option is
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
327 used for debugging purposes.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
328 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
329 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
330 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
331 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
332 <option>-e</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
333 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
334 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
335 <para>Only update version information for projects from the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
336 watchlist which were not successfully updated during the last
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
337 update due to errors.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
338 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
339 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
340 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
341 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
342 <option>-v</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
343 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
344 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
345 <para>Increase logging verbosity and log information about each
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
346 transfer.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
347 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
348 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
349 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
350 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
351 <option>-c</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
352 <replaceable>max_connections</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
353 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
354 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
355 <para>Limit the number of simultaneous connections to the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
356 specified number. The default value is 16.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
357 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
358 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
359 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
360 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
361 <option>-C</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
362 <replaceable>ca_dir</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
363 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
364 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
365 <para>Verify the validity of TLS certificates using the CA
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
366 certificates in the specified directory.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
367 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
368 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
369 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
370 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
371 <option>-D</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
372 <replaceable>delay</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
373 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
374 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
375 <para>Wait at least the specified number of seconds before
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
376 making subsequent connections to the same host. The default
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
377 value is 0.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
378 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
379 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
380 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
381 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
382 <option>-H</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
383 <replaceable>max_host_connections</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
384 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
385 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
386 <para>Limit the number of simultaneous connections to a single
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
387 host to the specified number. The default value is 4.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
388 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
389 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
390 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
391 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
392 <option>-i</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
393 <replaceable>items</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
394 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
395 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
396 <para>Update only the specified items. Multiple items can be
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
397 specifed in the form of a comma-sperated list.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
398 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
399 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
400 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
401 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
402 <option>-l</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
403 <replaceable>logfile</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
404 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
405 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
406 <para>Log to the specified logfile instead of stderr.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
407 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
408 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
409 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
410 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
411 <option>-r</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
412 <replaceable>retries</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
413 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
414 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
415 <para>Limit the number of retries in case of connection
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
416 failures. The default value is 3.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
417 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
418 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
419 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
420 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
421 <option>-t</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
422 <replaceable>min_time</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
423 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
424 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
425 <para>Only update version information for projects from the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
426 watchlist which have not been updated for the specified
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
427 number of seconds.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
428 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
429 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
430 </variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
431 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
432 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
433 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
434 <term>
5
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
435 <command>discover</command>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
436 </term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
437 <listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
438 <para>The <command>discover</command> subcommand assists with the
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
439 creation of watchlist entries. The arguments to the
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
440 <command>discover</command> subcommand correspond to the fields
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
441 of a watchlist entry without the name field, see
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
442 <citerefentry><refentrytitle>relmon_format</refentrytitle>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
443 <manvolnum>4</manvolnum></citerefentry> for details on the
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
444 format. Only the <replaceable>base_url</replaceable> is mandatory
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
445 and <command>relmon</command> will log all matching and
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
446 non-matching links of each retrieved document or feed so that
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
447 each step of an update operation for a watchlist entry can be
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
448 reproduced.</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
449 <para>The following options are supported:</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
450 <variablelist>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
451 <varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
452 <term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
453 <option>-d</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
454 </term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
455 <listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
456 <para>Trace and log all transfers and parsing. This option is
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
457 used for debugging purposes.</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
458 </listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
459 </varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
460 <varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
461 <term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
462 <option>-c</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
463 <replaceable>max_connections</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
464 </term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
465 <listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
466 <para>Limit the number of simultaneous connections to the
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
467 specified number.</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
468 </listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
469 </varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
470 <varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
471 <term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
472 <option>-C</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
473 <replaceable>ca_dir</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
474 </term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
475 <listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
476 <para>Verify the validity of TLS certificates using the CA
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
477 certificates in the specified directory.</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
478 </listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
479 </varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
480 <varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
481 <term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
482 <option>-D</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
483 <replaceable>delay</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
484 </term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
485 <listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
486 <para>Wait at least the specified number of seconds before
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
487 making subsequent connections to the same host.</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
488 </listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
489 </varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
490 <varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
491 <term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
492 <option>-H</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
493 <replaceable>max_host_connections</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
494 </term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
495 <listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
496 <para>Limit the number of simultaneous connections to a single
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
497 host to the specified number.</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
498 </listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
499 </varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
500 <varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
501 <term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
502 <option>-r</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
503 <replaceable>retries</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
504 </term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
505 <listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
506 <para>Limit the number of retries in case of connection
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
507 failures.</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
508 </listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
509 </varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
510 <varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
511 <term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
512 <option>-t</option>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
513 <replaceable>min_time</replaceable>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
514 </term>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
515 <listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
516 <para>Only update version information for projects from the
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
517 watchlist which have not been updated for the specified
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
518 number of seconds.</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
519 </listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
520 </varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
521 </variablelist>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
522 </listitem>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
523 </varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
524 <varlistentry>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
525 <term>
4
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
526 <command>help</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
527 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
528 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
529 <para>The <command>help</command> subcommand displays usage
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
530 information about the specified subcommand or all subcommands and
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
531 exits.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
532 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
533 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
534 </variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
535 </refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
536 <refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
537 <title>Examples</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
538 <example>
5
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
539 <title>Creating a new watchlist entry</title>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
540 <para>The following command displays all links found in the HTML document
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
541 at <uri>http://example.net/foo/</uri>:</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
542 <screen>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
543 $ relmon discover http://example.net/foo/
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
544 </screen>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
545 <para>The following command tests whether the specified version-matching
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
546 regular expression matches the distribution file linked from
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
547 <uri>http://example.net/foo/</uri>:</para>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
548 <screen>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
549 $ relmon discover http://example.net/foo/ '/foo-([[:digit:].]+)\.tar\.gz'
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
550 </screen>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
551 </example>
86a0c5d11f05 Add discover subcommand
Guido Berhoerster <guido+relmon@berhoerster.name>
parents: 4
diff changeset
552 <example>
4
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
553 <title>Updating version information</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
554 <para>The following command retrieves the version information for the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
555 entries in the watchlist <filename>foo.watchlist</filename> and stores
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
556 the results in the statefile <filename>foo.json</filename> using using
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
557 up to 100 simultaneous connections and logging all output to
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
558 <filename>relmon.log</filename>:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
559 <screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
560 $ relmon update -c 100 foo.watchlist foo.json
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
561 </screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
562 </example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
563 <example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
564 <title>Conditionally updating version information</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
565 <para>The following command updates version information in the statefile
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
566 <filename>bar.json</filename> only for those entries in the watchlist
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
567 <filename>foo.watchlist</filename> which either have not been updated
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
568 for at least 48 hours or which could not be sucessfully updated during
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
569 the last update operation due to errors:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
570 <screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
571 $ relmon update -v -t 172800 -e -l relmon.log watchlist relmon.json
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
572 </screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
573 </example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
574 <example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
575 <title>Displaying detailed information on a monitored project</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
576 <para>The following command displays all recorded information for the
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
577 monitored project named foo from the statefile
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
578 <filename>foo.json</filename>:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
579 <screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
580 $ relmon show foo.json baz
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
581 </screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
582 </example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
583 <example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
584 <title>Creating a HTML document with the version information on each
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
585 of the monitored projects</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
586 <para>The following command sequence creates a HTML document containing a
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
587 table with the version information of each monitored project as well as
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
588 an associated Atom feed with the URL
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
589 <uri>http://example.net/releases.xml</uri> containing the 100 most
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
590 recently discovered releases from the statefile
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
591 <filename>foo.json</filename>:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
592 <screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
593 $ relmon list -f html -F 'http://example.net/releases.xml' foo.json > releases.html
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
594 $ relmon list -f atom -F 'http://example.net/releases.xml' -n 100 foo.json
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
595 </screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
596 </example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
597 </refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
598 <refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
599 <title>Exit Status</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
600 <para>The following exit values are returned:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
601 <variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
602 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
603 <term>0</term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
604 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
605 <para>Command successfully executed.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
606 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
607 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
608 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
609 <term>&gt; 0</term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
610 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
611 <para>An error has occured.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
612 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
613 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
614 </variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
615 </refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
616 <refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
617 <title>See Also</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
618 <para><citerefentry><refentrytitle>relmon_format</refentrytitle>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
619 <manvolnum>4</manvolnum></citerefentry></para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
620 </refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
621 </refentry>