Lubuntu/ubuntu-dev-tools
3
0
Fork 0
mirror of https://git.launchpad.net/ubuntu-dev-tools synced 2025-07-24 21:31:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

document new syncpackage behaviour

Browse Source
This commit is contained in:
Colin Watson 2011-08-16 15:42:23 +01:00
parent 122e711d28
commit fdfef34b37
2 changed files with 23 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
doc/syncpackage.1
View File

@ -1,12 +1,11 @@
.TH SYNCPACKAGE "1" "June 2010" "ubuntu-dev-tools" .TH SYNCPACKAGE "1" "June 2010" "ubuntu-dev-tools"
.SH NAME .SH NAME
syncpackage \- helper to prepare .changes file to upload synced packages syncpackage \- copy packages from Debian to Ubuntu
.SH SYNOPSIS .SH SYNOPSIS
.B syncpackage .B syncpackage
[\fIoptions\fR] \fI<.dsc URL/path or package name>\fR [\fIoptions\fR] \fI<.dsc URL/path or package name>\fR
.SH DESCRIPTION .SH DESCRIPTION
\fBsyncpackage\fR generates a changes file to be directly uploaded to Ubuntu \fBsyncpackage\fR causes a package to be copied from Debian to Ubuntu.
primary archive or PPA starting from a pristine Debian package.
.PP .PP
\fBsyncpackage\fR allows you to upload files with the same checksums of the \fBsyncpackage\fR allows you to upload files with the same checksums of the
Debian ones, as the common script used by Ubuntu archive administrators does, Debian ones, as the common script used by Ubuntu archive administrators does,
@ -15,14 +14,15 @@ this way you can preserve source files integrity between the two distributions.
\fBsyncpackage\fR will detect source tarballs with mismatching checksums \fBsyncpackage\fR will detect source tarballs with mismatching checksums
and will automatically create fake syncs instead. and will automatically create fake syncs instead.
.SH WARNING .SH WARNING
The use of \fBsyncpackage\fR is discouraged by the Ubuntu Archive The use of \fBsyncpackage \-\-no-\-lp\fR, which generates a changes file to
Administrators, as it introduces an unnecessary window for error. be directly uploaded to the Ubuntu primary archive or a PPA, is discouraged
In future launchpad will offer the ability to directly perform sync by the Ubuntu Archive Administrators, as it introduces an unnecessary window
requests, without a developer having to do an upload. for error.
Until then, it's advised to use \fBsyncpackage\fR with caution, and This only exists for backward compatibility, for unusual corner cases, and
request syncs via bugs with for uploads to archives other than the Ubuntu primary archive.
.BR requestsync (1) Omitting this option will cause Launchpad to perform the sync request
where possible. directly, which is the preferred method for uploads to the Ubuntu primary
archive.
.SH OPTIONS .SH OPTIONS
.TP .TP
\fB\-h\fR, \fB\-\-help\fR \fB\-h\fR, \fB\-\-help\fR
@ -43,6 +43,13 @@ Specify the component to sync from.
\fB\-v\fR, \fB\-\-verbose\fR \fB\-v\fR, \fB\-\-verbose\fR
Display more progress information. Display more progress information.
.TP .TP
.B \-\-no\-lp
Construct sync locally rather than letting Launchpad copy the package
directly (not recommended).
.TP
\fB\-l\fI INSTANCE\fR, \fB\-\-lpinstance\fR=\fIINSTANCE\fR
Launchpad instance to connect to (default: production).
.TP
\fB\-n\fI UPLOADER_NAME\fR, \fB\-\-uploader\-name\fR=\fIUPLOADER_NAME\fR \fB\-n\fI UPLOADER_NAME\fR, \fB\-\-uploader\-name\fR=\fIUPLOADER_NAME\fR
Use UPLOADER_NAME as the name of the maintainer for this upload instead Use UPLOADER_NAME as the name of the maintainer for this upload instead
of evaluating DEBFULLNAME and UBUMAIL. of evaluating DEBFULLNAME and UBUMAIL.
@ -75,6 +82,9 @@ back to the default mirror.
.B \-\-no\-conf .B \-\-no\-conf
Do not read any configuration files, or configuration from environment Do not read any configuration files, or configuration from environment
variables. variables.
.TP
.B \-\-simulate
Show what would be done, but don't actually do it.
.SH ENVIRONMENT .SH ENVIRONMENT
.TP .TP
.BR DEBFULLNAME ", " DEBEMAIL ", " UBUMAIL .BR DEBFULLNAME ", " DEBEMAIL ", " UBUMAIL

3
syncpackage
View File

@ -357,7 +357,8 @@ def main():
parser.add_option("--no-lp", parser.add_option("--no-lp",
dest="lp", action="store_false", default=True, dest="lp", action="store_false", default=True,
help="Construct sync locally rather than letting " help="Construct sync locally rather than letting "
"Launchpad copy the package directly.") "Launchpad copy the package directly (not "
"recommended).")
parser.add_option('-l', '--lpinstance', metavar='INSTANCE', parser.add_option('-l', '--lpinstance', metavar='INSTANCE',
dest='lpinstance', default=None, dest='lpinstance', default=None,
help='Launchpad instance to connect to ' help='Launchpad instance to connect to '