NAME

       gbp.conf - Gbp configuration file

SYNOPSIS

       /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  configuration files provide default global options and specific options for individual gbp
       commands.  All files have the same format as described below and are parsed in the above order  from  top
       to bottom with increasing precedence.

       Each  file consists of either zero or one default section, and zero or one sections for each gbp command.
       Additionally, there can be an arbitrary number of remote-config sections.  Comments  start  with  a  hash
       sign (#). The syntax is:

           [DEFAULT]
           # This section is for global settings. Affects all commands
           key = value

           [<command>]
           # Specific sections for each command, like 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 = value

       The  sections  for  each  command  are named like the command (without gbp) surrounded by square brackets
       (e.g. [buildpackage]).  For backwards compatibility, command sections starting with git- or gbp- are also
       supported but will provoke a warning when parsed by gbp.

       The key=value pairs of the command sections are named like the command-line options of the  corresponding
       command with the '--' stripped off and can hold the same values (but see below for details). For example,
       the  gbp-buildpackage(1)> manual page documents the --git-export-dir=directory option which can be turned
       into configuration file setting by dropping the --git prefix:

           [buildpackage]
           export-dir = directory

       Options that can be repeated on the command line take Python-like lists in the config file. For  example,
       the  gbp-import-orig(1)> command has the --filter=pattern option which can be turned into a configuration
       file option like this:

           [import-orig]
           filter = [ '.svn', '.hg' ]

       Boolean options can be either True or False. For example, gbp-import-orig(1)> has the --pristine-tar  and
       --no-pristine-tar options which translate to:

           [import-orig]
           pristine-tar = True

       and

           [import-orig]
           pristine-tar = False

       respectively.

              Note:  To  see  the  current  set  of values that would be applied after parsing the configuration
              files, use gbp-config(1)>.

              Note: gbp 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 configuration 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-template

       can be used to create remote repositories for the pkg-libvirt project using:

       gbp-create-remote-repo --remote-config=pkg-libvirt

       This can be useful if you're often creating new remote repositories for different projects.

EXAMPLES

       An example set up for packaging work:

        # $HOME/.gbp.conf

        [DEFAULT]
        pristine-tar = True
        cleaner = fakeroot debian/rules clean

        [buildpackage]
        export-dir  = ../build-area/

        [import-orig]
        dch = False
        filter = .svn
        filter = .hg
        filter = .bzr
        filter = CVS
        filter = debian/*
        filter = */debian/*
        filter-pristine-tar = True

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

       GBP_DISABLE_SECTION_DEPRECTATION
              Don't print a deprecation warning when gbp encounters a section starting with git- or gbp-.

FILES

       See /etc/git-buildpackage/gbp.conf for an example.

SEE ALSO

       gbp-clone(1)>,  gbp-create-remote-repo(1)>,  gbp-pq(1)>,  gbp-pull(1)>,  gbp-dch(1)>, gbp-import-dsc(1)>,
       gbp-import-orig(1)>, gbp-buildpackage(1)>, The  Git-Buildpackage  Manual  <URL:file:///usr/share/doc/git-
       buildpackage/manual-html/index.html>

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.

                                                 29 January 2016                                     GBP.CONF(5)