mirror of
https://git.launchpad.net/ubuntu-dev-tools
synced 2025-03-13 08:01:09 +00:00
87 lines
3.2 KiB
Groff
87 lines
3.2 KiB
Groff
.TH BACKPORTPACKAGE "1" "December 2010" "ubuntu-dev-tools"
|
|
.SH NAME
|
|
backportpackage \- helper to test package backports
|
|
.SH SYNOPSIS
|
|
.TP
|
|
.B backportpackage \fR[\fIadditional options\fR]
|
|
\-\-upload <\fIupload target\fR>
|
|
.br
|
|
<\fIsource package\fR>
|
|
.PP
|
|
.B backportpackage \-h
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-d \fIDEST\fR, \-\-destination=\fIDEST\fR
|
|
\fBRequired\fR. Backport the package to the specified Ubuntu
|
|
release. If this option is unspecified, then \fBbackportpackage\fR
|
|
defaults to the release on which it is currently running.
|
|
.TP
|
|
.B \-s \fISOURCE\fR, \-\-source=\fISOURCE\fR
|
|
Backport the package from the specified Ubuntu release. If neither
|
|
this option nor \fB\-\-version\fR are specified, then
|
|
\fBbackportpackage\fR defaults to the current Ubuntu development
|
|
release.
|
|
.TP
|
|
.B \-b, \-\-build
|
|
Build the package with the specified builder before uploading. Note
|
|
for \fBpbuilder\fR(8) users: This assumes the common configuration,
|
|
where the \fBDIST\fR environment is read by \fBpbuilderrc\fR(5) to
|
|
select the correct base image.
|
|
.TP
|
|
.B \-B \fIBUILDER\fR, \fB\-\-builder\fR=\fIBUILDER
|
|
Use the specified builder to build the package. Supported are
|
|
\fBpbuilder\fR(8) and \fBsbuild\fR(1). This overrides
|
|
\fBUBUNTUTOOLS_BUILDER\fR. The default is \fBpbuilder\fR(8).
|
|
.TP
|
|
.B \-u \fIUPLOAD\fR, \-\-upload=\fIUPLOAD\fR
|
|
Upload to \fIUPLOAD\fR with \fBdput\fR(1) (after confirmation).
|
|
.TP
|
|
.B \-v \fIVERSION\fR, \-\-version=\fIVERSION\fR
|
|
If the \fB\-\-source\fR option is specified, then
|
|
\fBbackportpackage\fR verifies that the current version of \fIsource
|
|
package\fR in \fISOURCE\fR is the same as \fIVERSION\fR. Otherwise,
|
|
\fBbackportpackage\fR finds version \fIVERSION\fR of \fIsource
|
|
package\fR, regardless of the release in which it was published (or if
|
|
that version is still current).
|
|
.TP
|
|
.B \-l \fIINSTANCE\fR, \-\-launchpad=\fIINSTANCE\fR
|
|
Use the specified instance of Launchpad (e.g. "staging"), instead of
|
|
the default of "production".
|
|
.SH DESCRIPTION
|
|
\fBbackportpackage\fR fetches a package from one Ubuntu release and
|
|
creates a no-change backport of that package to a previous release,
|
|
optionally doing a test build of the package and/or uploading the
|
|
resulting backport for testing.
|
|
.PP
|
|
The backported package is fetched and built in a temporary directory
|
|
in \fB/tmp\fR, which is removed once the script finishes running.
|
|
.PP
|
|
\fBbackportpackage\fR is only recommended for testing backports in a
|
|
PPA, not uploading backports to the Ubuntu archive.
|
|
.SH ENVIRONMENT
|
|
.TP
|
|
.B UBUNTUTOOLS_BUILDER
|
|
The default builder for Ubuntu development tools that support it
|
|
(including \fBbackportpackage\fR. Supported are \fBpbuilder\fR(8) and
|
|
\fBsbuild\fR(1). If unset and not provided on the command line,
|
|
\fBpbuilder\fR(8) is used.
|
|
.SH EXAMPLES
|
|
Test-build in your PPA a backport of znc from the current development
|
|
release to your workstation's release:
|
|
.IP
|
|
.nf
|
|
.B backportpackage -u ppa:\fIuser\fR/\fIppa\fB znc
|
|
.fi
|
|
.PP
|
|
Backport squashfs-tools from Maverick to both Karmic and Lucid and
|
|
test-build both locally:
|
|
.IP
|
|
.nf
|
|
.B backportpackage -b -s maverick -d karmic -d lucid squashfs-tools
|
|
.fi
|
|
.SH AUTHOR
|
|
\fBbackportpackage\fR and this manpage were written by Evan Broder
|
|
<evan@ebroder.net>
|
|
.PP
|
|
Both are released under GNU General Public License, version 2.
|