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)
127 --recurse-submodules)
128 recurse_submodules
=--recurse-submodules
130 --recurse-submodules=*)
131 recurse_submodules
="$1"
133 --no-recurse-submodules)
134 recurse_submodules
=--no-recurse-submodules
137 verify_signatures
=--verify-signatures
139 --no-verify-signatures)
140 verify_signatures
=--no-verify-signatures
142 --d|
--dr|
--dry|
--dry-|
--dry-r|
--dry-ru|
--dry-run)
149 # Pass thru anything that may be meant for fetch.
163 rebase_args
=--preserve-merges
168 echo "Invalid value for --rebase, should be true, false, interactive or preserve"
174 error_on_no_merge_candidates
() {
179 -t|
--t|
--ta|
--tag|
--tags)
180 echo "It doesn't make sense to pull all tags; you probably meant:"
181 echo " git fetch --tags"
186 if test true
= "$rebase"
195 upstream
=$
(git config
"branch.$curr_branch_short.merge")
196 remote
=$
(git config
"branch.$curr_branch_short.remote")
198 if [ $# -gt 1 ]; then
199 if [ "$rebase" = true
]; then
200 printf "There is no candidate for rebasing against "
202 printf "There are no candidates for merging "
204 echo "among the refs that you just fetched."
205 echo "Generally this means that you provided a wildcard refspec which had no"
206 echo "matches on the remote end."
207 elif [ $# -gt 0 ] && [ "$1" != "$remote" ]; then
208 echo "You asked to pull from the remote '$1', but did not specify"
209 echo "a branch. Because this is not the default configured remote"
210 echo "for your current branch, you must specify a branch on the command line."
211 elif [ -z "$curr_branch" -o -z "$upstream" ]; then
213 error_on_missing_default_upstream
"pull" $op_type $op_prep \
214 "git pull <remote> <branch>"
216 echo "Your configuration specifies to $op_type $op_prep the ref '${upstream#refs/heads/}'"
217 echo "from the remote, but no such ref was fetched."
222 test true
= "$rebase" && {
223 if ! git rev-parse
-q --verify HEAD
>/dev
/null
225 # On an unborn branch
226 if test -f "$GIT_DIR/index"
228 die
"$(gettext "updating an unborn branch with changes added to the index
")"
231 require_clean_work_tree
"pull with rebase" "Please commit or stash them."
234 test -n "$curr_branch" &&
235 . git-parse-remote
&&
236 remoteref
="$(get_remote_merge_branch "$@
" 2>/dev/null)" &&
237 oldremoteref
=$
(git merge-base
--fork-point "$remoteref" $curr_branch 2>/dev
/null
)
239 orig_head
=$
(git rev-parse
-q --verify HEAD
)
240 git fetch
$verbosity $progress $dry_run $recurse_submodules --update-head-ok "$@" ||
exit 1
241 test -z "$dry_run" ||
exit 0
243 curr_head
=$
(git rev-parse
-q --verify HEAD
)
244 if test -n "$orig_head" && test "$curr_head" != "$orig_head"
246 # The fetch involved updating the current branch.
248 # The working tree and the index file is still based on the
249 # $orig_head commit, but we are merging into $curr_head.
250 # First update the working tree to match $curr_head.
252 eval_gettextln
"Warning: fetch updated the current branch head.
253 Warning: fast-forwarding your working tree from
254 Warning: commit \$orig_head." >&2
255 git update-index
-q --refresh
256 git read-tree
-u -m "$orig_head" "$curr_head" ||
257 die
"$(eval_gettext "Cannot fast-forward your working tree.
258 After making sure that you saved anything precious from
259 $ git
diff \
$orig_head
266 merge_head
=$
(sed -e '/ not-for-merge /d' \
267 -e 's/ .*//' "$GIT_DIR"/FETCH_HEAD | \
270 case "$merge_head" in
272 error_on_no_merge_candidates
"$@"
275 if test -z "$orig_head"
277 die
"$(gettext "Cannot merge multiple branches into empty
head")"
279 if test true
= "$rebase"
281 die
"$(gettext "Cannot rebase onto multiple branches
")"
286 # Pulling into unborn branch: a shorthand for branching off
287 # FETCH_HEAD, for lazy typers.
288 if test -z "$orig_head"
290 # Two-way merge: we claim the index is based on an empty tree,
291 # and try to fast-forward to HEAD. This ensures we will not
292 # lose index/worktree changes that the user already made on
294 empty_tree
=4b825dc642cb6eb9a060e54bf8d69288fbee4904
295 git read-tree
-m -u $empty_tree $merge_head &&
296 git update-ref
-m "initial pull" HEAD
$merge_head "$curr_head"
300 if test true
= "$rebase"
302 o
=$
(git show-branch
--merge-base $curr_branch $merge_head $oldremoteref)
303 if test "$oldremoteref" = "$o"
309 merge_name
=$
(git fmt-merge-msg
$log_arg <"$GIT_DIR/FETCH_HEAD") ||
exit
312 eval="git-rebase $diffstat $strategy_args $merge_args $rebase_args $verbosity"
313 eval="$eval --onto $merge_head ${oldremoteref:-$merge_head}"
316 eval="git-merge $diffstat $no_commit $verify_signatures $edit $squash $no_ff $ff_only"
317 eval="$eval $log_arg $strategy_args $merge_args $verbosity $progress"
318 eval="$eval \"\$merge_name\" HEAD $merge_head"