Mercurial > projects > relmon

annotate relmon.1.xml @ 6:45fe94dbc236

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added tag version-1 for changeset 86a0c5d11f05
author Guido Berhoerster <guido+relmon@berhoerster.name>
date Fri, 07 Nov 2014 20:54:29 +0100
parents 86a0c5d11f05
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>