.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "GBP-PULL" "1" "01 June 2012" "" "git-buildpackage Manual"

.SH NAME
gbp-pull \- Safely update a repository from remote
.SH SYNOPSIS

\fBgbp-pull\fR [ \fB--verbose\fR ] [ \fB--force\fR ] [ \fB--redo-pq\fR ] [ \fB--[no-]pristine-tar\fR ] [ \fB--debian-branch=\fIbranch_name\fB\fR ] [ \fB--upstream-branch=\fIbranch_name\fB\fR ] [ \fB--depth=\fIdepth\fB\fR ]

.SH "DESCRIPTION"
.PP
\fBgbp-pull\fR updates the \fBdebian\fR,
\fBupstream\fR and \fBpristine-tar\fR
branches from a remote repository in one go. It checks if the update is safe (would
result in a \fBfast-forward\fR merge) and aborts otherwise.
.SH "OPTIONS"
.TP
\fB--force\fR
force a branch update even if this results in a non fast
forward update. 
.sp
.RS
.B "Warning:"
Forcing a branch updates
makes you lose your modifications.
.RE
.TP
\fB--redo-pq\fR
also rebuild the corresponding patch-queue using \fBgbp-pq\fR\&.
.sp
.RS
.B "Warning:"
This drops the patch-queue branch if it exists.
.RE
.TP
\fB--debian-branch=\fIbranch_name\fB \fR
The branch in the Git repository the Debian package is being
developed on, default is \fImaster\fR\&.
.TP
\fB--upstream-branch=\fIbranch_name\fB \fR
The branch in the Git repository the upstream sources are put
onto. Default is \fIupstream\fR\&.
.TP
\fB--depth=\fIdepth\fB \fR
Git history depth, for deepening shallow git clones.
.TP
\fB--verbose\fR
.TP
\fB-v\fR
verbose execution
.TP
\fB--pristine-tar \fR
Whether to update the pristine-tar branch too.
.SH "EXIT CODES"
.PP
When \fBgbp-pull\fR finishes it indicates success or failure with it's exit code:
.TP
\fB0\fR
Success.
.TP
\fB1\fR
An error occured during the pull, see the printed error message for details.
.TP
\fB2\fR
At least one branch couldn't be fast forwarded.
.SH "CONFIGURATION FILES"
.PP
Several \fIgbp.conf\fR files are parsed 
to set defaults for the above commandline arguments. See the
[XRef to GBP.MAN.GBP.CONF] manpage for details.
.SH "SEE ALSO"
.PP
\fBgit-buildpackage\fR(1),
\fBgbp-clone\fR(1),
\fBgbp-pq\fR(1),
\fBgbp.conf\fR(5)
.SH "AUTHOR"
.PP
Guido Guenther <agx@sigxcpu.org>