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 $*"
16 test -z "$(git ls-files -u)" ||
17 die "You are in the middle of a conflicted merge."
19 strategy_args= diffstat= no_commit= squash= no_ff= log_arg= verbosity=
20 curr_branch=$(git symbolic-ref -q HEAD)
21 curr_branch_short=$(echo "$curr_branch" | sed "s|refs/heads/||")
22 rebase=$(git config --bool branch.$curr_branch_short.rebase)
27 verbosity="$verbosity -q" ;;
29 verbosity="$verbosity -v" ;;
30 -n|--no-stat|--no-summary)
36 --no-c|--no-co|--no-com|--no-comm|--no-commi|--no-commit)
37 no_commit=--no-commit ;;
38 --c|--co|--com|--comm|--commi|--commit)
40 --sq|--squ|--squa|--squas|--squash)
42 --no-sq|--no-squ|--no-squa|--no-squas|--no-squash)
48 -s=*|--s=*|--st=*|--str=*|--stra=*|--strat=*|--strate=*|\
49 --strateg=*|--strategy=*|\
50 -s|--s|--st|--str|--stra|--strat|--strate|--strateg|--strategy)
53 strategy=`expr "z$1" : 'z-[^=]*=\(.*\)'` ;;
60 strategy_args="${strategy_args}-s $strategy "
62 -r|--r|--re|--reb|--reba|--rebas|--rebase)
65 --no-r|--no-re|--no-reb|--no-reba|--no-rebas|--no-rebase)
68 -h|--h|--he|--hel|--help)
72 # Pass thru anything that may be meant for fetch.
79 error_on_no_merge_candidates () {
84 -t|--t|--ta|--tag|--tags)
85 echo "Fetching tags only, you probably meant:"
86 echo " git fetch --tags"
91 curr_branch=${curr_branch#refs/heads/}
93 if [ -z "$curr_branch" ]; then
94 echo "You are not currently on a branch, so I cannot use any"
95 echo "'branch.<branchname>.merge' in your configuration file."
96 echo "Please specify which branch you want to merge on the command"
97 echo "line and try again (e.g. 'git pull <repository> <refspec>')."
98 echo "See git-pull(1) for details."
100 echo "You asked me to pull without telling me which branch you"
101 echo "want to merge with, and 'branch.${curr_branch}.merge' in"
102 echo "your configuration file does not tell me either. Please"
103 echo "specify which branch you want to merge on the command line and"
104 echo "try again (e.g. 'git pull <repository> <refspec>')."
105 echo "See git-pull(1) for details."
107 echo "If you often merge with the same branch, you may want to"
108 echo "configure the following variables in your configuration"
111 echo " branch.${curr_branch}.remote = <nickname>"
112 echo " branch.${curr_branch}.merge = <remote-ref>"
113 echo " remote.<nickname>.url = <url>"
114 echo " remote.<nickname>.fetch = <refspec>"
116 echo "See git-config(1) for details."
121 test true = "$rebase" && {
122 git update-index --ignore-submodules --refresh &&
123 git diff-files --ignore-submodules --quiet &&
124 git diff-index --ignore-submodules --cached --quiet HEAD -- ||
125 die "refusing to pull with rebase: your working tree is not up-to-date"
127 . git-parse-remote &&
128 reflist="$(get_remote_merge_branch "$@" 2>/dev/null)" &&
129 oldremoteref="$(git rev-parse -q --verify \
132 orig_head=$(git rev-parse -q --verify HEAD)
133 git fetch $verbosity --update-head-ok "$@" || exit 1
135 curr_head=$(git rev-parse -q --verify HEAD)
136 if test -n "$orig_head" && test "$curr_head" != "$orig_head"
138 # The fetch involved updating the current branch.
140 # The working tree and the index file is still based on the
141 # $orig_head commit, but we are merging into $curr_head.
142 # First update the working tree to match $curr_head.
144 echo >&2 "Warning: fetch updated the current branch head."
145 echo >&2 "Warning: fast forwarding your working tree from"
146 echo >&2 "Warning: commit $orig_head."
147 git update-index -q --refresh
148 git read-tree -u -m "$orig_head" "$curr_head" ||
149 die 'Cannot fast-forward your working tree.
150 After making sure that you saved anything precious from
151 $ git diff '$orig_head'
158 merge_head=$(sed -e '/ not-for-merge /d' \
159 -e 's/ .*//' "$GIT_DIR"/FETCH_HEAD | \
162 case "$merge_head" in
165 0) error_on_no_merge_candidates "$@";;
166 1) echo >&2 "You are not currently on a branch; you must explicitly"
167 echo >&2 "specify which branch you wish to merge:"
168 echo >&2 " git pull <remote> <branch>"
174 if test -z "$orig_head"
176 die "Cannot merge multiple branches into empty head"
178 if test true = "$rebase"
180 die "Cannot rebase onto multiple branches"
185 if test -z "$orig_head"
187 git update-ref -m "initial pull" HEAD $merge_head "$curr_head" &&
188 git read-tree --reset -u HEAD || exit 1
192 merge_name=$(git fmt-merge-msg $log_arg <"$GIT_DIR/FETCH_HEAD") || exit
193 test true = "$rebase" &&
194 exec git-rebase $diffstat $strategy_args --onto $merge_head \
195 ${oldremoteref:-$merge_head}
196 exec git-merge $diffstat $no_commit $squash $no_ff $log_arg $strategy_args \
197 "$merge_name" HEAD $merge_head $verbosity