Provided by: git-buildpackage_0.5.19ubuntu1_all bug

NAME

       git-pbuilder - Wrapper around pbuilder for git-buildpackage

SYNOPSIS

       DIST=distribution ARCH=architecture git-pbuilder debbuild-options

       DIST=distribution ARCH=architecture \
           git-pbuilder (update | create | login) cowbuilder-options

DESCRIPTION

       git-pbuilder is a wrapper around pdebuild intended for use by git-
       buildpackage.  It configures pdebuild to use cowbuilder, passes
       appropriate options to debbuild, and sets the base path for cowbuilder
       based on the environment variable DIST and, if set, the environment
       variable ARCH.

       By default, git-pbuilder assumes the target distribution is "sid", the
       same architecture as the cowbuilder default, and uses
       /var/cache/pbuilder/base-sid.cow if it exists.  If it doesn't,
       /var/cache/pbuilder/base.cow is tried.  If DIST is set, its value is
       the target distribution and /var/cache/pbuilder/base-dist.cow is used
       instead.  If DIST is "etch" or "ebo", --debian-etch-workaround is also
       passed to cowbuilder.  If ARCH is set, its value is the target
       architecture and /var/cache/pbuilder/base-dist-arch.cow is used, with
       dist being set to "sid" if DIST was not set.

       If git-pbuilder is invoked via a name that starts with "git-pbuilder-",
       the part after the last hyphen is taken to be the distribution
       (although the environment variable overrides this).  One can therefore
       create symlinks like "git-pbuilder-lenny" pointing to git-pbuilder and
       use that name when wanting to use a distribution of "lenny".

       Any arguments are passed as-is to dpkg-buildpackage via the
       --debbuildopts option to pdebuild.

       Normally, one does not run this script directly.  Instead, it's used as
       the builder script for git-buildpackage.  To configure git-buildpackage
       to use it, add a stanza like:

           [DEFAULT]
           builder = /path/to/git-pbuilder

       in your gbp.conf file (which can be .gbp.conf in your home directory or
       at the top level of the repository, or gbp.conf in the .git directory).
       DIST is read as an environment variable so that you can set it before
       running git-buildpackage without having to worry about passing
       parameters through git-buildpackage.

       Alternately, git-pbuilder may be called with an argument of "update",
       "create", or "login".  In this case, it calls cowbuilder using sudo and
       passes the corresponding command to cowbuilder, using the same logic as
       above to determine the base directory and distribution.  Any additional
       arguments to git-pbuilder are passed along to cowbuilder.

ENVIRONMENT

       DIST
           Sets the target distribution.  This is used primarily to determine
           the base path for cowbuilder, but it's also used to determine
           whether to pass --debian-etch-workaround to cowbuilder.

FILES

       /var/cache/pbuilder/base-sid.cow
       /var/cache/pbuilder/base.cow
           The default "cowbuilder --basepath" directories, searched for in
           that order, if DIST is not set.

       /var/cache/pbuilder/base-$DIST.cow
           The "cowbuilder --basepath" directory used if DIST is set.

SEE ALSO

       cowbuilder(8), dpkg-buildpackage(1), git-buildpackage(1), pdebuild(1),
       sudo(8)

       The latest version of this script is available from
       <http://www.eyrie.org/~eagle/software/scripts/>.

AUTHOR

       Russ Allbery <rra@stanford.edu>