From 8f7d07e6bc5223bdaefcee9ab4dba4b3f4b9a4c3 Mon Sep 17 00:00:00 2001 From: Michael Bienia Date: Sat, 20 Mar 2010 18:49:42 +0100 Subject: [PATCH] doc/requestsync.1: Update the paragraph about sponsoring (lp: #538990). --- debian/changelog | 3 ++- doc/requestsync.1 | 21 +++++++++++++-------- 2 files changed, 15 insertions(+), 9 deletions(-) diff --git a/debian/changelog b/debian/changelog index 77988e2..47cfc48 100644 --- a/debian/changelog +++ b/debian/changelog @@ -7,8 +7,9 @@ ubuntu-dev-tools (0.97) UNRELEASED; urgency=low for different LP API versions. * ubuntutools/lp/__init__.py: Set the '1.0' LP API version as default. * massfile: Updated to 1.0 LP API. + * doc/requestsync.1: Update the paragraph about sponsoring (lp: #538990). - -- Michael Bienia Sat, 20 Mar 2010 18:26:49 +0100 + -- Michael Bienia Sat, 20 Mar 2010 18:48:34 +0100 ubuntu-dev-tools (0.96) lucid; urgency=low diff --git a/doc/requestsync.1 b/doc/requestsync.1 index db1c5b5..ba95330 100644 --- a/doc/requestsync.1 +++ b/doc/requestsync.1 @@ -2,7 +2,7 @@ .SH NAME requestsync \- helper to file sync requests for Ubuntu .SH SYNOPSIS -.B requestsync\fR [\fB\-d distro\fR] [\fB\-nse\fR] [\fB\-k \fIkeyid\fR] <\fBsource package\fR> [\fBtarget release\fR] [\fIbase version\fR] +.B requestsync\fR [\fB\-d \fIdistro\fR] [\fB\-nse\fR] [\fB\-k \fIkeyid\fR] <\fBsource package\fR> [\fBtarget release\fR] [\fIbase version\fR] .br .B requestsync \-\-lp\fR [\fB\-nse\fR] <\fBsource package\fR> <\fBtarget release\fR> [\fIbase version\fR] .br @@ -22,10 +22,15 @@ the launchpadlib module fails. .PP \fBrequestsync\fR checks if you have the permissions to request the sync from -the archive administrators directly by checking if you are a member of the -\fI~ubuntu\-dev\fR team on Launchpad. -If you are not a member of the team, the script will subscribe -the necessary team with approval rights to the bug report for you. +the archive administrators directly by checking if you have upload permissions +for that package through package set permissions or component permissions. If +you don't have upload permissions, the script will subscribe the necessary +team with approval rights to the bug report for you. + +This check is only performed if \fBrequestsync\fR is allowed to use the LP API +(option \fB\-\-lp\fR). In the other case \fBrequestsync\fR relies on that you +answer the question about upload permissions honestly to determine if a team +with approval rights is to be subscribed to the bug. .PP \fBrequestsync\fR uses launchpadlib authentication to file its requests. Please @@ -57,8 +62,8 @@ file the sync request in Launchpad. .TP .B \-s Specifies that you require sponsorship. -You need this option if you are not a member of ubuntu-dev. This shall disable the -Launchpad team membership checking described above. +You need this option if you don't have upload permissions for that package. +This disables the upload permissions check described above. .TP .B \-e Use this flag after FeatureFreeze for non-bug fix syncs. \fBrequestsync\fR will @@ -96,7 +101,7 @@ If unspecified this defaults to fiordland.ubuntu.com. .B DEBSMTP_PORT Sets which port of the SMTP server to use. Default is 25. .TP -.B DEBSMTP_USER and DEBSMTP_PASS +.B DEBSMTP_USER \fRand\fB DEBSMTP_PASS Sets the username and password to use when authenticating to the SMTP server. .SH SEE ALSO