Mercurial > projects > relmon

annotate relmon.1.xml @ 4:f28486666a4f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add manpages for relmon and relmon_watchlist
author Guido Berhoerster <guido+relmon@berhoerster.name>
date Fri, 24 Oct 2014 22:44:39 +0200
parents
children 86a0c5d11f05
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>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
153 <command>relmon help</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
154 <arg choice="opt">
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
155 <replaceable>subcommand</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
156 </arg>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
157 </cmdsynopsis>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
158 </refsynopsisdiv>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
159 <refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
160 <title>Description</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
161 <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
162 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
163 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
164 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
165 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
166 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
167 to previously extracted version numbers.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
168 <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
169 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
170 watchlist file, see
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
171 <citerefentry><refentrytitle>relmon_watchlist</refentrytitle>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
172 <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
173 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
174 <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
175 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
176 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
177 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
178 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
179 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
180 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
181 <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
182 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
183 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
184 format.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
185 </refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
186 <refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
187 <title>Subcommands</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
188 <variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
189 <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
190 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
191 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
192 <command>list</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
193 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
194 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
195 <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
196 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
197 specified output format</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
198 <variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
199 <para>The following options are supported:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
200 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
201 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
202 <option>-f</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
203 <replaceable>format</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
204 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
205 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
206 <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
207 <replaceable>format</replaceable> are html, atom, parseable
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
208 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
209 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
210 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
211 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
212 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
213 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
214 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
215 form.
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
216 </para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
217 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
218 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
219 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
220 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
221 <option>-F</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
222 <replaceable>url</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
223 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
224 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
225 <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
226 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
227 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
228 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
229 is selected.</para>
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 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
232 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
233 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
234 <option>-H</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
235 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
236 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
237 <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
238 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
239 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
240 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
241 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
242 name and version.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
243 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
244 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
245 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
246 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
247 <option>-n</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
248 <replaceable>number_items</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
249 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
250 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
251 <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
252 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
253 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
254 entries.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
255 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
256 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
257 </variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
258 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
259 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
260 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
261 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
262 <command>show</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
263 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
264 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
265 <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
266 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
267 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
268 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
269 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
270 specified statefile.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
271 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
272 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
273 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
274 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
275 <command>update</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
276 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
277 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
278 <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
279 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
280 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
281 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
282 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
283 <para>The following options are supported:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
284 <variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
285 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
286 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
287 <option>-d</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
288 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
289 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
290 <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
291 used for debugging purposes.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
292 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
293 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
294 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
295 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
296 <option>-e</option>
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 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
299 <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
300 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
301 update due to errors.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
302 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
303 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
304 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
305 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
306 <option>-v</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
307 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
308 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
309 <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
310 transfer.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
311 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
312 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
313 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
314 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
315 <option>-c</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
316 <replaceable>max_connections</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
317 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
318 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
319 <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
320 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
321 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
322 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
323 <varlistentry>
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 <option>-C</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
326 <replaceable>ca_dir</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
327 </term>
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 <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
330 certificates in the specified directory.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
331 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
332 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
333 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
334 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
335 <option>-D</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
336 <replaceable>delay</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
337 </term>
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 <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
340 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
341 value is 0.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
342 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
343 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
344 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
345 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
346 <option>-H</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
347 <replaceable>max_host_connections</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
348 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
349 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
350 <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
351 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
352 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
353 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
354 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
355 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
356 <option>-i</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
357 <replaceable>items</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
358 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
359 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
360 <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
361 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
362 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
363 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
364 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
365 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
366 <option>-l</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
367 <replaceable>logfile</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
368 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
369 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
370 <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
371 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
372 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
373 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
374 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
375 <option>-r</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
376 <replaceable>retries</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
377 </term>
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 <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
380 failures. The default value is 3.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
381 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
382 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
383 <varlistentry>
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 <option>-t</option>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
386 <replaceable>min_time</replaceable>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
387 </term>
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 <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
390 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
391 number of seconds.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
392 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
393 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
394 </variablelist>
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 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
397 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
398 <term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
399 <command>help</command>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
400 </term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
401 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
402 <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
403 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
404 exits.</para>
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 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
407 </variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
408 </refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
409 <refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
410 <title>Examples</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
411 <example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
412 <title>Updating version information</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
413 <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
414 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
415 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
416 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
417 <filename>relmon.log</filename>:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
418 <screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
419 $ 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
420 </screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
421 </example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
422 <example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
423 <title>Conditionally updating version information</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
424 <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
425 <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
426 <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
427 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
428 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
429 <screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
430 $ 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
431 </screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
432 </example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
433 <example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
434 <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
435 <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
436 monitored project named foo from the statefile
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
437 <filename>foo.json</filename>:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
438 <screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
439 $ relmon show foo.json baz
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
440 </screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
441 </example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
442 <example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
443 <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
444 of the monitored projects</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
445 <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
446 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
447 an associated Atom feed with the URL
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
448 <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
449 recently discovered releases from the statefile
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
450 <filename>foo.json</filename>:</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
451 <screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
452 $ 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
453 $ 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
454 </screen>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
455 </example>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
456 </refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
457 <refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
458 <title>Exit Status</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
459 <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
460 <variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
461 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
462 <term>0</term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
463 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
464 <para>Command successfully executed.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
465 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
466 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
467 <varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
468 <term>&gt; 0</term>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
469 <listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
470 <para>An error has occured.</para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
471 </listitem>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
472 </varlistentry>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
473 </variablelist>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
474 </refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
475 <refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
476 <title>See Also</title>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
477 <para><citerefentry><refentrytitle>relmon_format</refentrytitle>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
478 <manvolnum>4</manvolnum></citerefentry></para>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
479 </refsect1>
f28486666a4f Add manpages for relmon and relmon_watchlist
Guido Berhoerster <guido+relmon@berhoerster.name>
parents:
diff changeset
480 </refentry>