gbp-clone(1)
NAME
gbp-clone - Clone a repository from remote
SYNOPSIS
gbp clone [ --version ] [ --help ] [ --verbose ] [
--color=[auto|on|off] ] [ --color-scheme=COLOR_SCHEME ] [ --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
--version
Print version of the program, i.e. version of the git-
buildpackage suite
-v
--verbose
Verbose execution
-h
--help Print help and exit
--color=[auto|on|off]
Whether to use colored output.
--color-scheme=COLOR_SCHEME
Colors to use in output (when color is enabled). The format for
COLOR_SCHEME is '<debug>:<info>:<warning>:<error>'. Numerical
values and color names are accepted, empty fields imply the
default color. For example, --git-color-scheme='cyan:34::' would
show debug messages in cyan, info messages in blue and other
messages in default (i.e. warning and error messages in red).
--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.
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
CONFIGURATION FILES
Several gbp.conf files are parsed to set defaults for the above
command-line arguments. See the gbp.conf(5)> manpage for details.
SEE ALSO
gbp-buildpackage(1)>, gbp-pull(1)>, gbp.conf(5)>
AUTHOR
Guido Guenther <agx@sigxcpu.org>
31 December 2016 GBP-CLONE(1)
Free and Open Source Software