1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
.TH WATCHUPSTREAM 1 "August 19, 2007"
.SH NAME
watchupstream \- Look for newer upstream releases
.SH SYNOPSIS
.B watchupstream
.RI [ " options " ] " " [ " packagename ... " ]
.SH DESCRIPTION
The program
.B watchupstream
is a command line tool that uses
.B uscan
and
.B debian/watch
files to see whether there are newer upstream releases for the selected Debian packages.
The output on standard output is human readable but also easy to parse by scripts.
No need to have the packages installed; any Debian package can be queried.
.PP
The program does some caching, so it should be OK to use
.B watchupstream
in
.B crontab
for a reasonable number of packages.
Hint: start with a low number of packages.
.PP
There are three ways for selecting packages to be queried.
One, using the package selection options documented below,
two, by enumerating package names on the command line separated by spaces,
and three, by reading package names from standard input.
.PP
The package names can be binary and/or source package names.
The program
.B watchupstream
looks up the source package names for the given binary package names,
and continues with only the resulting list of source package names.
.PP
Missing debian/watch files can be added without modifying the Debian package.
Simply put your watch file named
.nh
.B sourcepackagename.watch
.hy
in the directory
.nh
.B ~/.watchupstream/watchfiles
.hy
and this watch file will be used instead of the debian/watch in the package.
.PP
.SH OPTIONS
Options for selecting packages to be queried:
.TP
.B \-\-packre=regularexpression
Use the given regular expression
on binary and source package names
to select packages to be queried.
.TP
.B \-\-maintre=regularexpression
Use the given regular expression
on the "Maintainer:" field
to select packages to be queried.
.TP
.B \-\-installed
Select all packages that are
.B installed
on the local system.
.TP
.B \-\-all
Select
.B all
packages known in Debian.
.PP
Options related to caching of query results:
.TP
.B \-\-nocache
Perform the queries without returning cached results.
.TP
.B \-\-cacheonly
Perform the queries with only returning cached results.
.TP
.B \-\-forget
Don't perform any query
and remove the cached results for the selected packages.
This option also deletes the file
.B ~/.watchupstream/watchfiles/packagename.watch
for each selected package.
.PP
Various other options:
.TP
.B \-\-export
Export the watch files to
.B ~/.watchupstream/watchfiles/packagename.watch
for each of the selected packages,
except for watch files that produce the result "unknown".
This option implies the option --nocache.
.TP
.B \-\-try=url
Try to create a watch file automatically using the given url.
This option implies the options --nocache and --export.
.SH EXAMPLES
.TP
.B watchupstream --packre='xslt.*-perl$'
.TP
.B watchupstream --maintre=namuri
.TP
.B watchupstream < sponsoredpackages.txt
.TP
.B watchupstream qiv --try='http://klografx.net/qiv/download/'
.TP
.B watchupstream freedroidrpg --try='http://freedroid.sf.net/'
.TP
.B watchupstream acct --try=http://ftp.gnu.org/gnu/acct/acct-6.3.tar.gz
.TP
.B watchupstream gmp --try=ftp://ftp.gnu.org/gnu/gmp/
.SH SEE ALSO
.BR uscan (1).
|
