Configuration files

Three configuration files are parsed in this order:

/etc/git-buildpackage/gbp.conf	system wide configuraton
~/.gbp.conf	per user configuration
.git/gbp.conf	per working copy configuration

All three have the same format. They consist of (at most) four sections, all of them are optional:

[DEFAULT]	Options in this section apply to git-buildpackage, git-import-orig and git-import-dsc.
[git-buildpackage]	Options in this section apply to git-buildpackage only and override options from the [DEFAULT] section.
[git-import-orig]	Options in this section apply to git-import-orig only and override options from the [DEFAULT] section.
[git-import-dsc]	Options in this section apply to git-import-dsc only and override options from the [DEFAULT] section.

The actual options in these sections are the command line options without the '--' prefix. So --upstream-branch=dfsgfree would read:

upstream-branch=dfsgfree

in the config file. In the special case of git-buildpackage the stripped prefix is not '--' but '--git-'. Here's a full example:

[DEFAULT]
# the default build command
builder=debuild
# the default branch for upstream sources
upstream-branch=upstream
# the default branch for the debian patch
debian-branch=master

# Special options for git-buildpackage
[git-buildpackage]
upstream-branch=dfsgclean
# Sign tags with GPG:
sign-tags = True
# Keyid to sign tags with
#keyid = 0xdeadbeef

# Special options for git-import-orig
[git-import-orig]
upstream-branch=notdfsgclean

# Special options for git-import-dsc
[git-import-dsc]
upstream-branch=notdfsgclean