File: rc-alert.1

package info (click to toggle)
devscripts 2.10.35lenny7
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 2,452 kB
  • ctags: 440
  • sloc: perl: 12,973; sh: 4,225; makefile: 149; ansic: 17
file content (86 lines) | stat: -rw-r--r-- 3,127 bytes parent folder | download
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
.TH RC-ALERT 1 "Debian Utilities" "DEBIAN" \" -*- nroff -*-
.SH NAME
rc-alert \- check for installed packages with release-critical bugs
.SH SYNOPSIS
\fBrc-alert [inclusion options] [package ...]\fR
.br
\fBrc-alert \-\-help|\-\-version\fR
.SH DESCRIPTION
\fBrc-alert\fR downloads the list of release-critical bugs from the
Debian BTS webpages, and then outputs a list of packages installed on
the system, or given on the command-line, which are in that list.
.P
If the directory \fI~/.devscripts_cache\fP exists or the
\fB\-\-cache\fP option is given, then the (sizable) downloaded list
will be cached, and will only be downloaded again on a second
invocation if it has changed.
.SH OPTIONS
.TP
.BR \-\-cache
Force the creation of the \fI~/.devscripts_cache\fP cache directory.
.TP
.BR \-\-help ", " \-h
Show a summary of options.
.TP
.BR \-\-version ", " \-v
Show version and copyright information.
.TP
It is also possible to filter the list of bugs reported based on the
tags and distributions associated with the package. The filtering options
are:
.TP
.BR \-\-include\-tags ", " \-f
A list of tags which the bug must have, in the format used for output.
For example, to include bugs tagged security or help wanted, use "SH".
.TP
.BR \-\-include\-tag\-op ", " \-t
If set to \fIand\fP, a bug must have all of the tags specified by
\fB\-\-includetags\fP.
.TP
.BR \-\-exclude\-tags
A list of tags which the bug must not have, in the same format as
\fB\-\-includetags\fP.
.TP
.BR \-\-exclude\-tag\-op
If set to \fIand\fP, a bug must have none of the tags specified by
\fB\-\-excludetags\fP.  By default, the bug will be excluded if any tag
matches.
.TP
.BR \-\-include\-dists ", " \-d
A list of distributions which the bug must apply to, in the format used for
output.  For example, to include bugs affecting testing or unstable, use "TU".
.TP
.BR \-\-include\-dist\-op ", " \-o
If set to \fIand\fP, a bug must apply to all of the specified distributions in
order to be included.
.TP
.BR \-\-exclude\-dists
A list of distributions to which the bug must not apply, in the same format as
\fB\-\-includedists\fP.
.TP
.BR \-\-exclude\-dist\-op
If set to \fIand\fP, a bug must apply to all of the specified distributions
in order to be excluded.  By default the bug will be excluded if it applies
to any of the listed distributions.
.SH EXAMPLES
.TP
.BR \-\-include\-dists " OS"
The bug must apply to at least one of oldstable or stable
.TP
.BR \-\-include\-dists " TU" " \-\-include\-dist\-op" " and"
The bug must apply to both testing and unstable
.TP
.BR \-\-include\-dists " O" " \-\-include\-tags" " S" " \-\-exclude\-tags" " +"
The bug must apply to oldstable and be tagged security but not patch
.TP
.BR \-\-exclude\-dists " SOT" " \-\-include\-tags" " R"
The bug must apply to only unstable or experimental (or both) and be tagged
unreproducible
.SH BUGS
It is not possible to say "does not apply only to unstable"
.SH SEE ALSO
.BR popbugs(1)
.SH AUTHOR
\fBrc-alert\fR was written by Anthony DeRobertis and modified by
Julian Gilbey <jdg@debian.org> and Adam D. Barratt <adam@adam-barratt.org.uk>
for the devscripts package.