table of contents
other versions
- wheezy 0.6.0~git20120601
- wheezy-backports 0.6.22~bpo70+1
- jessie 0.6.22
- jessie-backports 0.8.7~bpo8+1
- testing 0.8.12.2
- unstable 0.8.12.2
- experimental 0.8.16
GBP.CONF(5) | gbp.conf Manual | GBP.CONF(5) |
NAME¶
gbp.conf - git-buildpackage configuration fileSYNOPSIS¶
- /etc/git-buildpackage/gbp.conf
- system wide
- ~/.gbp.conf
- per user
- .gbp.conf
- per branch, can be published with the repository (deprecated)
- debian/gbp.conf
- per branch, can be published with the repository
- .git/gbp.conf
- per repository
DESCRIPTION¶
The gbp.conf provides default global options and specific options for git-buildpackage commands. All have the same format and are parsed in the above order. The file consists of several sections, one for each command. Comments start with a hash sign ( #). The generic file syntax is:[DEFAULT] # This is section for global settings. Affects all commands key = value [<command>] # Specific sections for each command, like git-buildpackage key = value [remote-config <name>] # Specific sections for a remote configuration. This can be used several # times to set up remote configuration for gbp-create-remote-repo key = valuekey=value pairs of the command sections reflect the command line options and their settings. For example git-buildpackage(1) manualpage contains the --git-export-dir=diirectory option which can be turned into configuration file setting by dropping the --git prefix with:
[git-buildpackage] export-dir = directoryNotice that some option are actually repeatable, or take Python lists. For example the git-import-orig(1) commmand has the --filter=pattern option which can be truned into a configuration file option like this:
[git-import-orig] filter = .svn filter = .hgAn alternative way is to write it using Python list syntax:
[git-import-orig] filter = [ '.svn', '.hg' ]Boolean options can bei either True or False. For example git-import-orig(1); has the --pristine-tar and --no-pristine-tar options which translate to:
[git-import-orig] pristine-tar = Trueand
[git-import-orig] pristine-tar = Falserespectively.
Note: To see the current set of values
that would be applied after parsing the configuration files run the command
with --help and check it's output.
Note: git-import-dscs and
git-pbuilder can't be configured via gbp.conf.
gbp-create-remote-repo(1) can additionally parse remote site
configurations from gbp.conf. For example a configration like:
[remote-config pkg-libvirt] # Location of the repository remote-url-pattern = ssh://git.debian.org/git/pkg-libvirt/%(pkg)s # Template dir to passed to git-init template-dir = /srv/alioth.debian.org/chroot/home/groups/pkg-libvirt/git-templateCan be used to create remote repositories for the pkg-libvirt project using:
gbp-create-remote-repo --remote-config=pkg-libvirtThis can be useful if you're often creating new remote repositores for different projects.
EXAMPLES¶
An example set up for packaging work:# $HOME/gbp.conf [DEFAULT] pristine-tar = True cleaner = fakeroot debian/rules clean [git-buildpackage] export-dir = ../build-area/ [git-import-orig] dch = False filter = .svn filter = .hg filter = .bzr filter = CVS filter = debian/* filter = */debian/* filter-pristine-tar = True [git-import-dsc] filter = [ 'CVS', '.cvsignore', '.hg', '.hgignore' '.bzr', '.bzrignore', '.gitignore' ] # End of file
ENVIRONMENT¶
- GBP_CONF_FILES
- Colon separated list of files to parse. The default is the above list of configuration files.
FILES¶
See See /etc/git-buildpackage/gbp.conf for an example.STANDARDS¶
The at The Git-Buildpackage Manual <URL:file:///usr/share/doc/git-buildpackage/manual-html/index.html> at /usr/share/doc/git-buildpackage/manual-html/index.htmlSEE ALSO¶
gbp-clone(1), gbp-create-remote-repo(1), gbp-pq(1) gbp-pull(1), git-dch(1), git-import-dsc(1), git-import-orig(1), git-buildpackage(1)AUTHORS¶
Guido Guenther <agx@sigxcpu.org> This manual page is based on a POD version by Jari Aalto <jari.aalto@cante.net>. Released under license GNU GPL version 2 or (at your option) any later. version.01 June 2012 |