59 lines
2.3 KiB
Groff
59 lines
2.3 KiB
Groff
.TH PTS-SUBSCRIBE 1 "Debian Utilities" "DEBIAN" \" -*- nroff -*-
|
|
.SH NAME
|
|
pts-subscribe \- time-limited subscription to the PTS
|
|
.SH SYNOPSIS
|
|
\fBpts-subscribe\fR [\fIoptions\fR] \fIpackage\fR
|
|
.PP
|
|
\fBpts-unsubscribe\fR [\fIoptions\fR] \fIpackage\fR
|
|
.SH DESCRIPTION
|
|
\fBpts-subscribe\fR sends a subscription request for \fIpackage\fR to
|
|
the Package Tracking System at pts@qa.debian.org, and cancels the
|
|
subscription 30 days later.
|
|
.PP
|
|
If called as \fBpts-unsubscribe\fR, send an unsubscription request
|
|
for \fIpackage\fR to the Package Tracking System.
|
|
.PP
|
|
This utility is useful if a developer has made an NMU and wants to
|
|
track the package for a limited period of time.
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB\-\-until \fItime\fR, \fB\-u\fR \fItime\fR
|
|
When \fBat\fR(1) should cancel the subscription. \fItime\fR must be
|
|
specified using \fBat\fR's syntax. Default is 'now + 30 days'. This
|
|
option will probably require quoting!
|
|
.TP
|
|
.B \-\-forever
|
|
Don't cancel the subscription automatically. This can also be
|
|
specified as \fB\-\-until forever\fR.
|
|
.TP
|
|
.BR \-\-help ", " \-h
|
|
Display a help message and exit successfully.
|
|
.TP
|
|
.B \-\-version
|
|
Display version and copyright information and exit successfully.
|
|
.SH "ENVIRONMENT VARIABLES"
|
|
.TP
|
|
.BR DEBEMAIL ", " EMAIL
|
|
If one of these is set (with preference give to \fBDEBEMAIL\fR), then this
|
|
will be used for the subscription address. If neither is set, then
|
|
the email will be sent without a specified subscription address, and
|
|
the email's From: line will be used to determine the sender's
|
|
address. This will be determined by \fBmail\fR(1).
|
|
.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 PTS_UNTIL
|
|
Setting this is equivalent to giving a \fB\-\-until\fR option.
|
|
.SH "SEE ALSO"
|
|
.BR at (1),
|
|
information about the Package Tracking System in the Developer's
|
|
Reference at
|
|
https://www.debian.org/doc/developers-reference/resources.html#pkg-tracking-system
|
|
.SH AUTHOR
|
|
This program was written by Julian Gilbey <jdg@debian.org> based on a
|
|
public domain prototype by Raphael Hertzog <hertzog@debian.org> and is
|
|
copyright under the GPL, version 2 or later.
|