Purpose: Builds a Debian package from a branch.
Usage: bzr builddeb [BRANCH_OR_BUILD_OPTIONS...]
Options:
-e, --export-only Export only, don't build.
--dont-purge Don't purge the build directory after building.
--result Present only for compatibility with bzr-builddeb <=
2.0. Use --result-dir instead.
-v, --verbose Display more information.
--package-merge Build using the appropriate -v and -sa options for
merging in the changes from another source.
--merge Merge the debian part of the source in to the upstream
tarball.
-h, --help Show help message.
--export-upstream-revision=REVISION
Select the upstream revision that will be exported.
-S, --source Build a source package.
--split Automatically create an .orig.tar.gz from a full
source branch.
--usage Show usage message and options.
--native Build a native package.
--strict Refuse to build if there are unknown files in the
working tree, --no-strict disables the check.
-w, --working-tree This option has no effect.
-r ARG, --revision=ARG
See "help revisionspec" for details.
--use-existing Use an existing build directory.
--build-dir=ARG The dir to use for building.
--reuse Try to avoid exporting too much on each build. Only
works in merge mode; it saves unpacking the upstream
tarball each time. Implies --dont-purge and --use-
existing.
--result-dir=DIRECTORY
Directory in which to place the resulting package
files.
--builder=BUILDER Command to build the package.
--export-upstream=BRANCH
Create the .orig.tar.gz from specified bzr branch
before building.
-q, --quiet Only display errors and warnings.
--orig-dir=DIRECTORY Directory containing the .orig.tar.gz files. For use
when only debian/ is versioned.
--quick Quickly build the package, uses quick-builder, which
defaults to "fakeroot debian/rules binary".
Description:
If BRANCH is specified it is assumed that the branch you wish to build is
located there. If it is not specified then the current directory is used.
By default, if a working tree is found, it is used to build. Otherwise the
last committed revision found in the branch is used. To force building the
last committed revision use --revision -1. You can also specify any other
revision with the --revision option.
If you only wish to export the package, and not build it (especially useful
for merge mode), use --export-only.
To leave the build directory when the build is completed use --dont-purge.
Specify the command to use when building using the --builder option, by
default "debuild" is used. It can be overriden by setting the "builder"
variable in you configuration. You can specify extra options to build with
by adding them to the end of the command, after using "--" to indicate the
end of the options to builddeb itself. The builder that you specify must
accept the options you provide at the end of its command line.
You can also specify directories to use for different things. --build-dir
is the directory to build the packages beneath, which defaults to
'../build-area'. '--orig-dir' specifies the directory that contains the
.orig.tar.gz files , which defaults to '..'. '--result-dir' specifies where
the resulting package files should be placed, which defaults to '..'.
--result-dir will have problems if you use a build command that places
the results in a different directory.
The --reuse option will be useful if you are in merge mode, and the upstream
tarball is very large. It attempts to reuse a build directory from an earlier
build. It will fail if one doesn't exist, but you can create one by using
--export-only.
--quick allows you to define a quick-builder in your configuration files,
which will be used when this option is passed. It defaults to 'fakeroot
debian/rules binary'. It is overriden if --builder is passed. Using this
and --reuse allows for fast rebuilds.
Aliases: bd
From: plugin "builddeb"
