summaryrefslogtreecommitdiffstats
path: root/scripts/who-uploads.1
blob: 431dc4331ee5bb4f16087942617ae279b5c68b46 (plain)
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
.TH WHO-UPLOADS 1 "Debian Utilities" "DEBIAN" \" -*- nroff -*-
.SH NAME
who-uploads \- identify the uploaders of Debian source packages
.SH SYNOPSIS
\fBwho\-uploads\fR [\fIoptions\fR] \fIsource_package\fR ...
.SH DESCRIPTION
\fBwho\-uploads\fR uses the Package Tracking System (PTS) to identify
the uploaders of the three most recent versions of the given source
packages.  Note that the uploaders are identified using their
\fBgpg\fR(1) or \fBgpg2\fR(1) keys; installing a recent version of the
\fIdebian-keyring\fR package should provide most of the required keys.
.PP
Note that because the PTS uses source packages, you must give the
source package names, not the binary package names.
.SH OPTIONS
.TP
\fB\-M\fR, \fB\-\-max\-uploads=\fIN\fR
Specify the maximum number of uploads to display for each package; the
default is 3.  Note that you may not see this many uploads if there
are not this many recorded in the PTS.
.TP
\fB\-\-keyring \fIkeyring\fR
Add \fIkeyring\fR to the list of keyrings to be searched for the
uploader's GPG key.
.TP
\fB\-\-no\-default\-keyrings\fR
By default, \fBwho\-uploads\fR uses the three Debian keyrings
\fI/usr/share/keyrings/debian-keyring.gpg\fR,
\fI/usr/share/keyrings/debian-nonupload.gpg\fR, and
\fI/usr/share/keyrings/debian-maintainers.gpg\fR (although this
default can be changed in the configuration file, see below).
Specifying this option means that the default keyrings will not be
examined.  The \fB\-\-keyring\fR option overrides this one.
.TP
\fB\-\-date\fR
Show the date of the upload alongside the uploader's details
.TP
.BR \-\-nodate ", " \-\-no\-date
Do not show the date of the upload alongside the uploader's details.
This is the default behaviour.
.TP
\fB\-\-no-conf\fR, \fB\-\-noconf\fR
Do not read any configuration files.  This can only be used as the
first option given on the command-line.
.TP
.BR \-\-help ", " \-h
Display a help message and exit successfully.
.TP
.B \-\-version
Display version and copyright information and exit successfully.
.SH "CONFIGURATION VARIABLES"
The two configuration files \fI/etc/devscripts.conf\fR and
\fI~/.devscripts\fR are sourced in that order to set configuration
variables.  Command line options can be used to override configuration
file settings.  Environment variable settings are ignored for this
purpose.  The currently recognised variables are:
.TP
.B WHOUPLOADS_DATE
Show the date of the upload alongside the uploader's details.  By
default, this is "no".
.TP
.B WHOUPLOADS_MAXUPLOADS
The maximum number of uploads to display for each package.  By
default, this is 3.
.TP
.B WHOUPLOADS_KEYRINGS
This is a colon-separated list of the default keyrings to be used.  By
default, it is the three Debian keyrings
\fI/usr/share/keyrings/debian-keyring.gpg\fR,
\fI/usr/share/keyrings/debian-nonupload.gpg\fR,
and
\fI/usr/share/keyrings/debian-maintainers.gpg\fR.
.SH AUTHOR
The original version of \fBwho-uploads\fR was written by Adeodato Sim\['o]
<dato@net.com.org.es>.  The current version is by Julian Gilbey
<jdg@debian.org>.