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)