3 # Copyright (c) 2005 Junio C Hamano
5 # Fetch one or more remote refs and merge it/them into the current HEAD.
7 USAGE
='[-n | --no-stat] [--[no-]commit] [--[no-]squash] [--[no-]ff] [--[no-]rebase|--rebase=preserve] [-s strategy]... [<fetch-options>] <repo> <head>...'
8 LONG_USAGE
='Fetch one or more remote refs and integrate it/them with the current HEAD.'
13 set_reflog_action
"pull${1+ $*}"
14 require_work_tree_exists
19 git diff-index
--cached --name-status -r --ignore-submodules HEAD
--
20 if [ $
(git config
--bool --get advice.resolveConflict ||
echo true
) = "true" ]; then
21 die
"$(gettext "Pull is not possible because you have unmerged files.
22 Please
, fix them up
in the work tree
, and
then use
'git add/rm <file>'
23 as appropriate to mark resolution
, or use
'git commit -a'.
")"
25 die
"$(gettext "Pull is not possible because you have unmerged files.
")"
30 if [ $
(git config
--bool --get advice.resolveConflict ||
echo true
) = "true" ]; then
31 die
"$(gettext "You have not concluded your merge
(MERGE_HEAD exists
).
32 Please
, commit your changes before you can merge.
")"
34 die
"$(gettext "You have not concluded your merge
(MERGE_HEAD exists
).
")"
38 test -z "$(git ls-files -u)" || die_conflict
39 test -f "$GIT_DIR/MERGE_HEAD" && die_merge
41 bool_or_string_config
() {
42 git config
--bool "$1" 2>/dev
/null || git config
"$1"
45 strategy_args
= diffstat
= no_commit
= squash
= no_ff
= ff_only
=
46 log_arg
= verbosity
= progress
= recurse_submodules
= verify_signatures
=
47 merge_args
= edit
= rebase_args
=
48 curr_branch
=$
(git symbolic-ref
-q HEAD
)
49 curr_branch_short
="${curr_branch#refs/heads/}"
50 rebase
=$
(bool_or_string_config branch.
$curr_branch_short.rebase
)
53 rebase
=$
(bool_or_string_config pull.rebase
)
60 verbosity
="$verbosity -q" ;;
62 verbosity
="$verbosity -v" ;;
64 progress
=--progress ;;
66 progress
=--no-progress ;;
67 -n|
--no-stat|
--no-summary)
73 --no-c|
--no-co|
--no-com|
--no-comm|
--no-commi|
--no-commit)
74 no_commit
=--no-commit ;;
75 --c|
--co|
--com|
--comm|
--commi|
--commit)
81 --sq|
--squ|
--squa|
--squas|
--squash)
83 --no-sq|
--no-squ|
--no-squa|
--no-squas|
--no-squash)
91 -s=*|
--s=*|
--st=*|
--str=*|
--stra=*|
--strat=*|
--strate=*|\
92 --strateg=*|
--strategy=*|\
93 -s|
--s|
--st|
--str|
--stra|
--strat|
--strate|
--strateg|
--strategy)
96 strategy
=`expr "z$1" : 'z-[^=]*=\(.*\)'` ;;
103 strategy_args
="${strategy_args}-s $strategy "
110 xx
="-X $(git rev-parse --sq-quote "$2")"
113 xx
=$
(git rev-parse
--sq-quote "$1") ;;
115 merge_args
="$merge_args$xx "
117 -r=*|
--r=*|
--re=*|
--reb=*|
--reba=*|
--rebas=*|
--rebase=*)
120 -r|
--r|
--re|
--reb|
--reba|
--rebas|
--rebase)
123 --no-r|
--no-re|
--no-reb|
--no-reba|
--no-rebas|
--no-rebase)
126 --recurse-submodules)
127 recurse_submodules
=--recurse-submodules
129 --recurse-submodules=*)
130 recurse_submodules
="$1"
132 --no-recurse-submodules)
133 recurse_submodules
=--no-recurse-submodules
136 verify_signatures
=--verify-signatures
138 --no-verify-signatures)
139 verify_signatures
=--no-verify-signatures
141 --d|
--dr|
--dry|
--dry-|
--dry-r|
--dry-ru|
--dry-run)
148 # Pass thru anything that may be meant for fetch.
158 rebase_args
=--preserve-merges
163 echo "Invalid value for --rebase, should be true, false, or preserve"
169 error_on_no_merge_candidates
() {
174 -t|
--t|
--ta|
--tag|
--tags)
175 echo "Fetching tags only, you probably meant:"
176 echo " git fetch --tags"
181 if test true
= "$rebase"
190 upstream
=$
(git config
"branch.$curr_branch_short.merge")
191 remote
=$
(git config
"branch.$curr_branch_short.remote")
193 if [ $# -gt 1 ]; then
194 if [ "$rebase" = true
]; then
195 printf "There is no candidate for rebasing against "
197 printf "There are no candidates for merging "
199 echo "among the refs that you just fetched."
200 echo "Generally this means that you provided a wildcard refspec which had no"
201 echo "matches on the remote end."
202 elif [ $# -gt 0 ] && [ "$1" != "$remote" ]; then
203 echo "You asked to pull from the remote '$1', but did not specify"
204 echo "a branch. Because this is not the default configured remote"
205 echo "for your current branch, you must specify a branch on the command line."
206 elif [ -z "$curr_branch" -o -z "$upstream" ]; then
208 error_on_missing_default_upstream
"pull" $op_type $op_prep \
209 "git pull <remote> <branch>"
211 echo "Your configuration specifies to $op_type $op_prep the ref '${upstream#refs/heads/}'"
212 echo "from the remote, but no such ref was fetched."
217 test true
= "$rebase" && {
218 if ! git rev-parse
-q --verify HEAD
>/dev
/null
220 # On an unborn branch
221 if test -f "$GIT_DIR/index"
223 die
"$(gettext "updating an unborn branch with changes added to the index
")"
226 require_clean_work_tree
"pull with rebase" "Please commit or stash them."
229 test -n "$curr_branch" &&
230 . git-parse-remote
&&
231 remoteref
="$(get_remote_merge_branch "$@
" 2>/dev/null)" &&
232 oldremoteref
=$
(git merge-base
--fork-point "$remoteref" $curr_branch 2>/dev
/null
)
234 orig_head
=$
(git rev-parse
-q --verify HEAD
)
235 git fetch
$verbosity $progress $dry_run $recurse_submodules --update-head-ok "$@" ||
exit 1
236 test -z "$dry_run" ||
exit 0
238 curr_head
=$
(git rev-parse
-q --verify HEAD
)
239 if test -n "$orig_head" && test "$curr_head" != "$orig_head"
241 # The fetch involved updating the current branch.
243 # The working tree and the index file is still based on the
244 # $orig_head commit, but we are merging into $curr_head.
245 # First update the working tree to match $curr_head.
247 eval_gettextln
"Warning: fetch updated the current branch head.
248 Warning: fast-forwarding your working tree from
249 Warning: commit \$orig_head." >&2
250 git update-index
-q --refresh
251 git read-tree
-u -m "$orig_head" "$curr_head" ||
252 die
"$(eval_gettext "Cannot fast-forward your working tree.
253 After making sure that you saved anything precious from
254 $ git
diff \
$orig_head
261 merge_head
=$
(sed -e '/ not-for-merge /d' \
262 -e 's/ .*//' "$GIT_DIR"/FETCH_HEAD | \
265 case "$merge_head" in
267 error_on_no_merge_candidates
"$@"
270 if test -z "$orig_head"
272 die
"$(gettext "Cannot merge multiple branches into empty
head")"
274 if test true
= "$rebase"
276 die
"$(gettext "Cannot rebase onto multiple branches
")"
281 # Pulling into unborn branch: a shorthand for branching off
282 # FETCH_HEAD, for lazy typers.
283 if test -z "$orig_head"
285 # Two-way merge: we claim the index is based on an empty tree,
286 # and try to fast-forward to HEAD. This ensures we will not
287 # lose index/worktree changes that the user already made on
289 empty_tree
=4b825dc642cb6eb9a060e54bf8d69288fbee4904
290 git read-tree
-m -u $empty_tree $merge_head &&
291 git update-ref
-m "initial pull" HEAD
$merge_head "$curr_head"
295 if test true
= "$rebase"
297 o
=$
(git show-branch
--merge-base $curr_branch $merge_head $oldremoteref)
298 if test "$oldremoteref" = "$o"
304 merge_name
=$
(git fmt-merge-msg
$log_arg <"$GIT_DIR/FETCH_HEAD") ||
exit
307 eval="git-rebase $diffstat $strategy_args $merge_args $rebase_args $verbosity"
308 eval="$eval --onto $merge_head ${oldremoteref:-$merge_head}"
311 eval="git-merge $diffstat $no_commit $verify_signatures $edit $squash $no_ff $ff_only"
312 eval="$eval $log_arg $strategy_args $merge_args $verbosity $progress"
313 eval="$eval \"\$merge_name\" HEAD $merge_head"