'\" t
.\"     Title: stg-pull
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 03/13/2012
.\"    Manual: StGit Manual
.\"    Source: StGit
.\"  Language: English
.\"
.TH "STG\-PULL" "1" "03/13/2012" "StGit" "StGit Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
stg-pull \- Pull changes from a remote repository
.SH "SYNOPSIS"
.sp
.nf
\fIstg\fR pull [options] [<repository>]
.fi
.SH "DESCRIPTION"
Pull the latest changes from the given remote repository (defaulting to branch\&.<name>\&.remote, or \fIorigin\fR if not set)\&. This command works by popping all the patches from the stack, pulling the changes in the parent repository, setting the base of the stack to the latest parent HEAD and pushing the patches back (unless \fI\-\-nopush\fR is specified)\&. The \fIpush\fR operation can fail if there are conflicts\&. They need to be resolved and the patch pushed again\&.

Check the \fIgit fetch\fR documentation for the <repository> format\&.
.SH "OPTIONS"
.PP
\-n, \-\-nopush
.RS 4
Do not push the patches back after pulling\&.
.RE
.PP
\-m, \-\-merged
.RS 4
Check for patches merged upstream\&.
.RE
.SH "STGIT"
Part of the StGit suite \- see linkman:stg[1]