summaryrefslogtreecommitdiff
path: root/projects/git-buildpackage.mdwn
blob: db8d8e41b8e0347966195299ab71cba00bc298de (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:

* *git-import-{dsc,dscs}*: import existing Debian source packages into a git repository
* *git-import-orig*: import a new upstream version into the git repository
* *git-buildpackage*: build a package out of a git repository, check for local modifications and tag appropriately
* *git-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 *git-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

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

* *gbp-posttag-push*: posttag hook for *git-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*.

[[!template  id=flattr thing="48091" name="Git-buildpackage"]]

### 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/test_GitRepository-module.html).

### Source Code
The source code is available via git (of course):
    
    git clone http://honk.sigxcpu.org/git/git-buildpackage.git

You can browse the source code online via [git.debian.org](http://git.debian.org/?p=users/agx/git-buildpackage.git;a=summary).

### 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.

### 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]

### Todo
* use git-fast-import in git-import-dsc(s) ([[!debbug 506211]])
* templating for git-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