'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH gbp-create-remote-repo 1 "21 March 2019" "" "git-buildpackage Manual"
.SH NAME
gbp-create-remote-repo \- Create remote repositories
.SH SYNOPSIS
'nh
.fi
.ad l
\fBgbp\ create-remote-repo\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fB--version\fR] [\fB--help\fR] [\fB--verbose\fR] [\fB--color=\fR[auto|on|off]] [\fB--color-scheme=\fR \fICOLOR_SCHEME\fR] [\fB--remote-url-pattern=\fR \fIurl-pattern\fR] [\fB--remote-name=\fR \fIname\fR] [\fB--template-dir=\fR \fIdirectory\fR] [\fB--remote-config=\fR \fIconfig\fR] [\fB--[no-]pristine-tar\fR] [\fB--debian-branch=\fR \fIbranch_name\fR] [\fB--upstream-branch=\fR \fIbranch_name\fR] [\fB--[no-]track\fR] [\fB--[no-]bare\fR] [\fIcreate\fR | \fIlist\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBgbp\ create-remote-repo\fR creates a repository at a remote location via ssh
and pushes the local repository into it. It then sets up remote branch
tracking so you can use \fBgbp\ pull\fR to update your repository from there.
.PP
Before performing any action on the remote location, it will print the
remote URL and ask for confirmation.
.PP
Note: By default, the remote repositories are created in the \*(T<collab\-maint\*(T> repository on \*(T<git.debian.org\*(T>.
.PP
When invoked with \*(T<\fBlist\fR\*(T> it lists the available
remote config templates.
.SH OPTIONS
.TP 
\*(T<\fB\-\-version\fR\*(T>
Print version of the program, i.e. version of the git-buildpackage
suite
.TP 
\*(T<\fB\-v\fR\*(T>, \*(T<\fB\-\-verbose\fR\*(T>
Verbose execution
.TP 
\*(T<\fB\-h\fR\*(T>, \*(T<\fB\-\-help\fR\*(T>
Print help and exit
.TP 
\*(T<\fB\-\-color=\fR\*(T>[auto|on|off] 
Whether to use colored output.
.TP 
\*(T<\fB\-\-color\-scheme=\fR\*(T>\fICOLOR_SCHEME\fR 
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,
\*(T<\fB\-\-git\-color\-scheme=\fR\*(T>\*(T<'cyan:34::'\*(T> would
show debug messages in cyan, info messages in blue and other messages
in default (i.e. warning and error messages in red).
.TP 
\*(T<\fB\-\-remote\-url\-pattern\fR\*(T>=\fIpattern\fR 
Where to create the remote repository. The part
\fI%(pkg)s\fR will be replaced by the package name.
.TP 
\*(T<\fB\-\-remote\-name\fR\*(T>=\fIname\fR 
What name git will use when referring to that repository, e.g.
\&'origin'.
.TP 
\*(T<\fB\-\-template\-dir\fR\*(T>=\fIdirectory\fR 
Template directory to pass to \fBgit init\fR on the remote
side. This can be used to customize the remote repository, e.g. to set up hooks.
.TP 
\*(T<\fB\-\-remote\-config\fR\*(T>=\fIconfig\fR 
Name of a config file section in \*(T<\fIgbp.conf\fR\*(T>
that specifies the above parameters. See \fBgbp.conf\fR(5)
manpage for details.
.TP 
\*(T<\fB\-\-debian\-branch\fR\*(T>=\fIbranch_name\fR 
The branch in the Git repository the Debian package is being
developed on, default is \fImaster\fR.
.TP 
\*(T<\fB\-\-upstream\-branch\fR\*(T>=\fIbranch_name\fR 
The branch in the Git repository the upstream sources are put
onto. Default is \fIupstream\fR.
.TP 
\*(T<\fB\-\-pristine\-tar\fR\*(T> 
Whether to push the pristine tar branch.
.TP 
\*(T<\fB\-\-[no\-]track\fR\*(T> 
Whether to set up branch tracking for the debian, upstream and
pristine-tar branches.
.TP 
\*(T<\fB\-\-[no\-]bare\fR\*(T> 
Whether to the remote repository should be a bare
repository (this is the default).
.SH "CONFIGURATION FILES"
Several \*(T<\fIgbp.conf\fR\*(T> files are parsed 
to set defaults for the above command-line arguments. See the
\fBgbp.conf\fR(5) manpage for details.
.SH "SEE ALSO"
\fBgbp-buildpackage\fR(1),
\fBgbp-pull\fR(1),
\fBgbp.conf\fR(5)
.SH AUTHOR
Guido G\(:unther <\*(T<agx@sigxcpu.org\*(T>>