Suite to help with maintaining [Debian](http://www.debian.org) packages in [Git](http://git-scm.com) repositories.

[[!toc]]

## Tools
GBP ships the following tools:

* *gbp import-{dsc,dscs}*: import existing Debian source packages into a git repository
* *gbp import-orig*: import a new upstream version into the git repository
* *gbp buildpackage*: build a package out of a git repository, check for local modifications and tag appropriately
* *gbp dch*: generate Debian changelog entries from Git commit messages
* *gbp pq*: maintain *debian/patches* on a patch queue branch
* *gbp clone*: clone a remote repository and make it ready for *gbp buildpackage*
* *gbp pull*: pull from a remote repository and update the necessary branches
* *gbp create-remote-repo*: mirror your git repository to a remote side
* *gbp config*: print configuration values

There are some helpers in */usr/share/doc/git-buildpackage/examples/*:

* *gbp-posttag-push*: posttag hook for *gbp buildpackage* to push out the necessary changes to a remote repository after a release
* *gbp-add-patch*: Commits a patch to the current branch and uses the Path Header for the commit message, useful after *gbp pq export*.

## Documentation
* git-buildpackage's [official manual](http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/gbp.html).
* A possible workflow for maintaining [[development/debian packages in git]].
* The current [api documentation](http://honk.sigxcpu.org/projects/git-buildpackage/apidocs/) in case you want to extend git-buildpackage.
The usage of the *GitRepository* class is shown (and tested) in
[test_GitRepository](http://honk.sigxcpu.org/projects/git-buildpackage/apidocs/tests.test_GitRepository-module.html).


[[!template  id=honk_git repo="git-buildpackage"]]

There's also a clone on [github](https://github.com/agx/git-buildpackage).

## Debian packages
Debian packages of git-buildpackage can be downloaded from the [[!debpkg git-buildpackage desc="Debian Archive"]]. Git snapshots are available [here](http://honk.sigxcpu.org:8001/job/git-buildpackage/).

## Bugreports
For enhancements and feature requests you can either use the [Debian bugtracking system](http://bugs.debian.org) or email [me](mailto:agx@sigxcpu.org) directly.

[[!template  id=honk_ml project="git-buildpackage"]]

## gbp.conf
Here's my current [[gbp.conf]].

## Related Tools
* [Git-pbuilder][0] by Russ Allbery is included in gbp but a newer version might be available.
* [Chef Cookbook for gbp][1]
* [git-buildpackage-rpm][2] by Markus Lehtonen. A fork of gbp adding RPM support. Large parts merged into gbp already.

## Todo
* templating for gbp dch ([[!debbug 536719]]. [[!debbug 529332]])
* translate the manual
* [[!debbug git-buildpackage desc="bugs"]] filed in the Debian bugtracking system

## Author
git-buildpackage was written by [[Guido Günther|/agx]] with contributions from many individuals. See the changelog for attributions.

## License
git-buildpackage is free software and licensed under the GPL Version 2.

[0]: http://www.eyrie.org/~eagle/software/scripts/git-pbuilder.html
[1]: https://github.com/mlafeldt/gbp-cookbook
[2]: https://github.com/marquiz/git-buildpackage-rpm