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] [-s strategy]... [<fetch-options>] <repo> <head>...'
8 LONG_USAGE
='Fetch one or more remote refs and merge it/them into the current HEAD.'
12 set_reflog_action
"pull $*"
18 git diff-index
--cached --name-status -r --ignore-submodules HEAD
--
19 if [ $
(git config
--bool --get advice.resolveConflict ||
echo true
) = "true" ]; then
20 die
"Pull is not possible because you have unmerged files.
21 Please, fix them up in the work tree, and then use 'git add/rm <file>'
22 as appropriate to mark resolution, or use 'git commit -a'."
24 die
"Pull is not possible because you have unmerged files."
29 if [ $
(git config
--bool --get advice.resolveConflict ||
echo true
) = "true" ]; then
30 die
"You have not concluded your merge (MERGE_HEAD exists).
31 Please, commit your changes before you can merge."
33 die
"You have not concluded your merge (MERGE_HEAD exists)."
37 test -z "$(git ls-files -u)" || die_conflict
38 test -f "$GIT_DIR/MERGE_HEAD" && die_merge
40 strategy_args
= diffstat
= no_commit
= squash
= no_ff
= ff_only
=
41 log_arg
= verbosity
= progress
= recurse_submodules
=
43 curr_branch
=$
(git symbolic-ref
-q HEAD
)
44 curr_branch_short
="${curr_branch#refs/heads/}"
45 rebase
=$
(git config
--bool branch.
$curr_branch_short.rebase
)
51 verbosity
="$verbosity -q" ;;
53 verbosity
="$verbosity -v" ;;
55 progress
=--progress ;;
56 -n|
--no-stat|
--no-summary)
62 --no-c|
--no-co|
--no-com|
--no-comm|
--no-commi|
--no-commit)
63 no_commit
=--no-commit ;;
64 --c|
--co|
--com|
--comm|
--commi|
--commit)
66 --sq|
--squ|
--squa|
--squas|
--squash)
68 --no-sq|
--no-squ|
--no-squa|
--no-squas|
--no-squash)
76 -s=*|
--s=*|
--st=*|
--str=*|
--stra=*|
--strat=*|
--strate=*|\
77 --strateg=*|
--strategy=*|\
78 -s|
--s|
--st|
--str|
--stra|
--strat|
--strate|
--strateg|
--strategy)
81 strategy
=`expr "z$1" : 'z-[^=]*=\(.*\)'` ;;
88 strategy_args
="${strategy_args}-s $strategy "
95 xx
="-X $(git rev-parse --sq-quote "$2")"
98 xx
=$
(git rev-parse
--sq-quote "$1") ;;
100 merge_args
="$merge_args$xx "
102 -r|
--r|
--re|
--reb|
--reba|
--rebas|
--rebase)
105 --no-r|
--no-re|
--no-reb|
--no-reba|
--no-rebas|
--no-rebase)
108 --recurse-submodules)
109 recurse_submodules
=--recurse-submodules
111 --d|
--dr|
--dry|
--dry-|
--dry-r|
--dry-ru|
--dry-run)
114 -h|
--h|
--he|
--hel|
--help)
118 # Pass thru anything that may be meant for fetch.
125 error_on_no_merge_candidates
() {
130 -t|
--t|
--ta|
--tag|
--tags)
131 echo "Fetching tags only, you probably meant:"
132 echo " git fetch --tags"
137 if test true
= "$rebase"
146 curr_branch
=${curr_branch#refs/heads/}
147 upstream
=$
(git config
"branch.$curr_branch.merge")
148 remote
=$
(git config
"branch.$curr_branch.remote")
150 if [ $# -gt 1 ]; then
151 if [ "$rebase" = true
]; then
152 printf "There is no candidate for rebasing against "
154 printf "There are no candidates for merging "
156 echo "among the refs that you just fetched."
157 echo "Generally this means that you provided a wildcard refspec which had no"
158 echo "matches on the remote end."
159 elif [ $# -gt 0 ] && [ "$1" != "$remote" ]; then
160 echo "You asked to pull from the remote '$1', but did not specify"
161 echo "a branch. Because this is not the default configured remote"
162 echo "for your current branch, you must specify a branch on the command line."
163 elif [ -z "$curr_branch" ]; then
164 echo "You are not currently on a branch, so I cannot use any"
165 echo "'branch.<branchname>.merge' in your configuration file."
166 echo "Please specify which remote branch you want to use on the command"
167 echo "line and try again (e.g. 'git pull <repository> <refspec>')."
168 echo "See git-pull(1) for details."
169 elif [ -z "$upstream" ]; then
170 echo "You asked me to pull without telling me which branch you"
171 echo "want to $op_type $op_prep, and 'branch.${curr_branch}.merge' in"
172 echo "your configuration file does not tell me, either. Please"
173 echo "specify which branch you want to use on the command line and"
174 echo "try again (e.g. 'git pull <repository> <refspec>')."
175 echo "See git-pull(1) for details."
177 echo "If you often $op_type $op_prep the same branch, you may want to"
178 echo "use something like the following in your configuration file:"
180 echo " [branch \"${curr_branch}\"]"
181 echo " remote = <nickname>"
182 echo " merge = <remote-ref>"
183 test rebase
= "$op_type" &&
184 echo " rebase = true"
186 echo " [remote \"<nickname>\"]"
188 echo " fetch = <refspec>"
190 echo "See git-config(1) for details."
192 echo "Your configuration specifies to $op_type $op_prep the ref '${upstream#refs/heads/}'"
193 echo "from the remote, but no such ref was fetched."
198 test true
= "$rebase" && {
199 if ! git rev-parse
-q --verify HEAD
>/dev
/null
201 # On an unborn branch
202 if test -f "$GIT_DIR/index"
204 die
"updating an unborn branch with changes added to the index"
207 git update-index
--ignore-submodules --refresh &&
208 git diff-files
--ignore-submodules --quiet &&
209 git diff-index
--ignore-submodules --cached --quiet HEAD
-- ||
210 die
"refusing to pull with rebase: your working tree is not up-to-date"
213 . git-parse-remote
&&
214 remoteref
="$(get_remote_merge_branch "$@
" 2>/dev/null)" &&
215 oldremoteref
="$(git rev-parse -q --verify "$remoteref")" &&
216 for reflog
in $
(git rev-list
-g $remoteref 2>/dev
/null
)
218 if test "$reflog" = "$(git merge-base $reflog $curr_branch)"
220 oldremoteref
="$reflog"
225 orig_head
=$
(git rev-parse
-q --verify HEAD
)
226 git fetch
$verbosity $progress $dry_run $recurse_submodules --update-head-ok "$@" ||
exit 1
227 test -z "$dry_run" ||
exit 0
229 curr_head
=$
(git rev-parse
-q --verify HEAD
)
230 if test -n "$orig_head" && test "$curr_head" != "$orig_head"
232 # The fetch involved updating the current branch.
234 # The working tree and the index file is still based on the
235 # $orig_head commit, but we are merging into $curr_head.
236 # First update the working tree to match $curr_head.
238 echo >&2 "Warning: fetch updated the current branch head."
239 echo >&2 "Warning: fast-forwarding your working tree from"
240 echo >&2 "Warning: commit $orig_head."
241 git update-index
-q --refresh
242 git read-tree
-u -m "$orig_head" "$curr_head" ||
243 die
'Cannot fast-forward your working tree.
244 After making sure that you saved anything precious from
245 $ git diff '$orig_head'
252 merge_head
=$
(sed -e '/ not-for-merge /d' \
253 -e 's/ .*//' "$GIT_DIR"/FETCH_HEAD | \
256 case "$merge_head" in
258 error_on_no_merge_candidates
"$@"
261 if test -z "$orig_head"
263 die
"Cannot merge multiple branches into empty head"
265 if test true
= "$rebase"
267 die
"Cannot rebase onto multiple branches"
272 if test -z "$orig_head"
274 git update-ref
-m "initial pull" HEAD
$merge_head "$curr_head" &&
275 git read-tree
--reset -u HEAD ||
exit 1
279 if test true
= "$rebase"
281 o
=$
(git show-branch
--merge-base $curr_branch $merge_head $oldremoteref)
282 if test "$oldremoteref" = "$o"
288 merge_name
=$
(git fmt-merge-msg
$log_arg <"$GIT_DIR/FETCH_HEAD") ||
exit
291 eval="git-rebase $diffstat $strategy_args $merge_args"
292 eval="$eval --onto $merge_head ${oldremoteref:-$merge_head}"
295 eval="git-merge $diffstat $no_commit $squash $no_ff $ff_only"
296 eval="$eval $log_arg $strategy_args $merge_args"
297 eval="$eval \"\$merge_name\" HEAD $merge_head $verbosity"