scripts/who-uploads.1

   1 .TH WHO-UPLOADS 1 "Debian Utilities" "DEBIAN" \" -*- nroff -*-
   2 .SH NAME
   3 who-uploads \- identify the uploaders of Debian source packages
   4 .SH SYNOPSIS
   5 \fBwho\-uploads\fR [\fIoptions\fR] \fIsource_package\fR [...]
   6 .SH DESCRIPTION
   7 \fBwho\-uploads\fR uses the Package Tracking System (PTS) to identify
   8 the uploaders of the three most recent versions of the given source
   9 packages.  Note that the uploaders are identified using their
  10 \fBgpg\fR(1) keys; installing a recent version of the
  11 \fIdebian-keyring\fR package should provide most of the required keys.
  12 .PP
  13 Note that because the PTS uses source packages, you must give the
  14 source package names, not the binary package names.
  15 .SH OPTIONS
  16 .TP
  17 \fB\-M\fR, \fB\-\-max\-uploads=\fIN\fR
  18 Specify the maximum number of uploads to display for each package; the
  19 default is 3.  Note that you may not see this many uploads if there
  20 are not this many recorded in the PTS.
  21 .TP
  22 \fB\-\-keyring \fIkeyring\fR
  23 Add \fIkeyring\fR to the list of keyrings to be searched for the
  24 uploader's GPG key.
  25 .TP
  26 \fB\-\-no\-default\-keyrings\fR
  27 By default, \fBwho\-uploads\fR uses the three Debian keyrings
  28 \fI/usr/share/keyrings/debian-keyring.{gpg,pgp}\fR and
  29 \fI/usr/share/keyrings/debian-maintainers.gpg\fR (although this
  30 default can be changed in the configuration file, see below).
  31 Specifying this option means that the default keyrings will not be
  32 examined.  The \fB\-\-keyring\fR option overrides this one.
  33 .TP
  34 \fB\-\-date\fR
  35 Show the date of the upload alongside the uploader's details
  36 .TP
  37 .BR \-\-nodate ", " \-\-no\-date
  38 Do not show the date of the upload alongside the uploader's details.
  39 This is the default behaviour.
  40 .TP
  41 \fB\-\-no-conf\fR, \fB\-\-noconf\fR
  42 Do not read any configuration files.  This can only be used as the
  43 first option given on the command-line.
  44 .TP
  45 .BR \-\-help ", " \-h
  46 Display a help message and exit successfully.
  47 .TP
  48 .B \-\-version
  49 Display version and copyright information and exit successfully.
  50 .SH "CONFIGURATION VARIABLES"
  51 The two configuration files \fI/etc/devscripts.conf\fR and
  52 \fI~/.devscripts\fR are sourced in that order to set configuration
  53 variables.  Command line options can be used to override configuration
  54 file settings.  Environment variable settings are ignored for this
  55 purpose.  The currently recognised variables are:
  56 .TP
  57 .B WHOUPLOADS_DATE
  58 Show the date of the upload alongside the uploader's details.  By
  59 default, this is "no".
  60 .TP
  61 .B WHOUPLOADS_MAXUPLOADS
  62 The maximum number of uploads to display for each package.  By
  63 default, this is 3.
  64 .TP
  65 .B WHOUPLOADS_KEYRINGS
  66 This is a colon-separated list of the default keyrings to be used.  By
  67 default, it is the three Debian keyrings
  68 \fI/usr/share/keyrings/debian-keyring.{gpg,pgp}\fR
  69 and
  70 \fI/usr/share/keyrings/debian-maintainers.gpg\fR.
  71 .SH AUTHOR
  72 The original version of \fBwho-uploads\fR was written by Adeodato Sim\['o]
  73 <dato@net.com.org.es>.  The current version is by Julian Gilbey
  74 <jdg@debian.org>.