gbp-clone

&dhsection;

gbp-clone

Clone a repository from remote

          &gbp-clone;

          &man.common.options.synopsis;
          --all
          --[no-]pristine-tar
          --debian-branch=branch_name
          --upstream-branch=branch_name
          --depth=depth
          --reference=repository
          --postclone=COMMAND
          --[no-]hooks
          --repo-user=[GIT|DEBIAN]
          --repo-email=[GIT|DEBIAN]
          repository
          directory

## DESCRIPTION

&gbp-clone; clones a remote repository and sets up tracking branches for the debian, upstream and pristine-tar branches. This way you can easily update later using &gbp-pull;.

## OPTIONS

&man.common.options.description;

`--all`

- Track all branches, not only `debian` and `upstream`.

`--debian-branch`=`branch_name`

- The branch in the Git repository the Debian package is being developed on, default is `master`.

`--upstream-branch`=`branch_name`

- The branch in the &git; repository the upstream sources are put onto. Default is `upstream`.

`--depth`=`depth`

- Git history depth, for creating shallow git clones.

`--reference`=`repository`

- Local repository to use as alternate instead of re-copying data from remote repository.

`--pristine-tar`

- Track pristine tar branch.

`--[no-]hooks`

- Enable running hooks.

`--postclone=``COMMAND`

- Execute `COMMAND` after cloning the source from the remote.

  Exported environment variables are: `GBP_GIT_DIR` (the repository the package is being built from).

  Note that if you clone a repository that contains a hook configuration in `debian/gbp.conf` this hook will not be run automatically to prevent execution of untrusted code.

`--repo-email=``[GIT|DEBIAN]`

- When set to `DEBIAN` use the `DEBEMAIL` environment variable to set the user.email &git; configuration otherwise use &git;'s defaults.

`--repo-user=``[GIT|DEBIAN]`

- When set to `DEBIAN` use the `DEBUSER` environment variable to set the user.name &git; configuration otherwise use &git;'s defaults.

`repository`

- The (possibly remote) repository to clone from. This is usually a &git; URL but some shortcuts are supported (see below).

`directory`

- The directory to clone to.

## EXAMPLES

Clone a repository and setup a tracking branch for pristine-tar as well:

          &gbp-clone; --pristine-tar git://honk.sigxcpu.org/git/git-buildpackage.git

Clone from the Git-Vcs URL of a package:

          &gbp-clone; vcsgit:libvirt

Clone from a github repository:

          &gbp-clone; github:agx/git-buildpackage

&man.gbp.config-files;

## SEE ALSO

man.gbp.buildpackage, man.gbp.pull, man.gbp.conf

## AUTHOR

&dhusername; &dhemail;