sponsor-patch

Langue: en

Version: 336807 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

NAME

sponsor-patch - Pull a patch / merge request from Launchpad, test-build it, and upload.

SYNOPSIS

sponsor-patch [options] bug
sponsor-patch -h

DESCRIPTION

sponsor-patch downloads the patch or Bazaar branch linked to an Ubuntu bug, applies it, generates a review diff, (optionally) test builds it with pbuilder(8), runs lintian(1) and, after review and confirmation, can upload it.

sponsor-patch can be used for sponsoring patches, merges from Debian, SRUs, and creating debdiffs from patches. If bug has multiple patches or branches linked, it will prompt the user to select one. The same applies to bug tasks. If the attached patch is not a debdiff, edit-patch(1) is used to apply it.

Some obvious checks are performed, in particular:

step].
update-maintainer(1) is run on the source package to ensure that the Maintainer field meets the Ubuntu policy.
step].
The version number must be greater than the current version in the archive. The changes file is also correctly generated to list all changes since the current version in the archive.
step].
The changelog must automatically close the sponsorship bug.
step].
The changelog target must be valid.
step].
The changelog timestamp is touched.

Should any checks (or the build fail), the user has an option to edit the patched source and try building it again.

The sources and patches will be downloaded into the working directory (which defaults to the current directory). pbuilder(8) output will be placed in workdir/sourcepkg-buildresult/.

OPTIONS

-b, --build
Build the package with pbuilder(1). This assumes the common configuration, where the DIST environment is read by pbuilderrc(5) to select the correct base image.
-e, --edit
Launch a sub-shell to allow editing of the patched source before building.
-kKEY, --key=KEY
Specify a key ID for signing the upload.
-s, --sponsor
Shortcut for sponsored uploads. Equivalent to -b -u ubuntu.
-uDEST, --upload=DEST
Upload to DEST with dput(1) (after confirmation).
-v, --verbose
Print more information.
-wDIR, --workdir=DIR
Use the specified working directory, creating it if necessary, instead of the current directory. This overrides SPONSOR_PATCH_WORKDIR.
-h, --help
Display a help message and exit.

ENVIRONMENT

SPONSOR_PATCH_WORKDIR
The default working directory for sponsor-patch. If unset and not provided on the command line, the current directory is used.

EXAMPLES

Test-building and sponsoring an upload of bug 1234:
 sponsor-patch -s 1234
 

Performing a test build of bug 1234 in your PPA:

 sponsor-patch -u ppa:user/ppa 1234
 

SEE ALSO

bzr(1), debchange(1), debdiff(1), dput(1), edit-patch(1), lintian(1), pbuilder(8), update-maintainer(1)

AUTHORS

sponsor-patch was written by Benjamin Drung <bdrung@ubuntu.com>, and this manual page was written by Stefano Rivera <stefanor@ubuntu.com>.

Both are released under the terms of the ISC License.