git-buildpackage

Name

git-buildpackage -- Build Debian packages from a Git repository

Synopsis

git-buildpackage [--git-ignore-new] [--git-tag] [--git-verbose] [--git-upstream-branch=treeish] [--git-debian-branch=branch_name] [--git-builder=BUILD_CMD] [--git-cleaner=CLEAN_CMD] [--git-sign-tags] [--git-keyid=gpg-keyid] [--git-posttag=command] [--git-debian-tag=tag-format] [--git-no-create-orig] [--git-tarball-dir=directory] [--git-export-dir=directory] [--git-export=treeish] [--git-pristine-tar] [--git-dont-purge] [--git-tag-only]

DESCRIPTION

git-buildpackage is used to build Debian source and .deb packages from a Git repository.

git-buildpackage will, in order:

OPTIONS

--git-ignore-new

Build the .diff.gz and debian package although there are uncommitted changes in the source tree.

--git-tag

Add a git tag after a successfull build.

--git-builder=BUILD_CMD

Use BUILD_CMD instead of debuild -i\.git -I.git

--git-cleaner=CLEAN_CMD

Use CLEAN_CMD instead of debuild clean

--git-verbose

verbose execution

--git-upstream-branch=branch_name

Branch to build the orig.tar.gz from if no tag matching the upstream version is found. Default is upstream. You can give any treeish object here.

--git-debian-branch=branch_name

If you're not on this branch when invoking git-buildpackage it will fail. Default is master. This is done to make sure you don't accidentally release from a topic branch. Not being on this branch will be ignored when using --git-ignore-new.

--git-sign-tags

GPG sign all created tags

--git-keyid=gpg-keyid

use this keyid for gpg signing tags

--git-posttag=command

excecute command after tagging a new version

--git-debian-tag=tag-format

use this tag format when tagging Debian versions, default is debian/<version>

--git-no-create-orig

Don't try to create any orig.tar.gz

--git-export-dir=directory

Export the current branch head (or the treeish object given via --git-export to directory before building.

--git-export=treeish

Instead of exporting the current branch head, export the treeish object treeish. The special name INDEX exports the current index.

--git-tarball-dir=directory

Search for original tarballs in directory instead of generating them

--git-pristine-tar

use pristine-tar to create the orig.tar.gz

--git-dont-purge

retain exported build directory after build

--git-tag-only

don't build, only tag and run post-tag hooks

CONFIGURATION FILES

Four configuration files are parsed to set defaults for the above commandline arguments:

/etc/git-buildpackage/gbp.conf

system wide configuraton

~/.gbp.conf

per user configuration

.gbp.conf

per branch configuration, can be published with the repository

.git/gbp.conf

per repository configuration

See /etc/git-buildpackage/gbp.conf for an example.

All options in the config files are specified without the 'git-' prefix.

SEE ALSO

git-import-dsc(1), git-import-dscs(1), git-import-orig(1), git-dch(1), debuild(1), git(1), git_load_dirs(1), pristine-tar(1), The Git-Buildpackage Manual

AUTHOR

Guido Guenther