blob: fc15a45356a904e5c846b6bf5fb04f0883f98d25 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
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
|
