3 # Copyright (c) 2005 Junio C Hamano
8 git-merge [options] <remote>...
9 git-merge [options] <msg> HEAD <remote>
11 stat show a diffstat at the end of the merge
12 n,no-stat don't show a diffstat at the end of the merge
13 summary (synonym to --stat)
14 no-summary (synonym to --no-stat)
15 log add list of one-line log to merge commit message
16 no-log don't add list of one-line log to merge commit message
17 squash create a single commit instead of doing a merge
18 commit perform a commit if the merge sucesses (default)
19 ff allow fast forward (default)
20 s,strategy= merge strategy to use
21 m,message= message to be used for the merge commit (if any)
29 test -z "$(git ls-files -u)" ||
30 die "You are in the middle of a conflicted merge."
35 all_strategies='recur recursive octopus resolve stupid ours subtree'
36 default_twohead_strategies='recursive'
37 default_octopus_strategies='octopus'
38 no_fast_forward_strategies='subtree ours'
39 no_trivial_strategies='recursive recur subtree ours'
44 squash= no_commit= log_arg=
47 rm -f -- "$GIT_DIR/MERGE_HEAD" "$GIT_DIR/MERGE_MSG" \
48 "$GIT_DIR/MERGE_STASH" || exit 1
52 # Stash away any local modifications.
53 git stash create >"$GIT_DIR/MERGE_STASH"
57 if test -f "$GIT_DIR/MERGE_STASH"
59 git reset --hard $head >/dev/null
60 git stash apply $(cat "$GIT_DIR/MERGE_STASH")
61 git update-index --refresh >/dev/null
65 finish_up_to_date () {
68 echo "$1 (nothing to squash)" ;;
76 echo Squashed commit of the following:
78 git log --no-merges --pretty=medium ^"$head" $remoteheads
84 rlogm="$GIT_REFLOG_ACTION"
87 rlogm="$GIT_REFLOG_ACTION: $2"
91 echo "Squash commit -- not updating HEAD"
92 squash_message >"$GIT_DIR/SQUASH_MSG"
97 echo "No merge message -- not updating HEAD"
100 git update-ref -m "$rlogm" HEAD "$1" "$head" || exit 1
110 if test "$show_diffstat" = t
112 # We want color (if set), but no pager
113 GIT_PAGER='' git diff --stat --summary -M "$head" "$1"
118 # Run a post-merge hook
119 if test -x "$GIT_DIR"/hooks/post-merge
123 "$GIT_DIR"/hooks/post-merge 1
126 "$GIT_DIR"/hooks/post-merge 0
134 rh=$(git rev-parse --verify "$remote^0" 2>/dev/null) || return
135 bh=$(git show-ref -s --verify "refs/heads/$remote" 2>/dev/null)
136 if test "$rh" = "$bh"
138 echo "$rh branch '$remote' of ."
139 elif truname=$(expr "$remote" : '\(.*\)~[1-9][0-9]*$') &&
140 git show-ref -q --verify "refs/heads/$truname" 2>/dev/null
142 echo "$rh branch '$truname' (early part) of ."
143 elif test "$remote" = "FETCH_HEAD" -a -r "$GIT_DIR/FETCH_HEAD"
145 sed -e 's/ not-for-merge / /' -e 1q \
146 "$GIT_DIR/FETCH_HEAD"
148 echo "$rh commit '$remote'"
153 while test $# != 0; do
155 -n|--no-stat|--no-summary)
156 show_diffstat=false ;;
162 test "$allow_fast_forward" = t ||
163 die "You cannot combine --squash with --no-ff."
164 squash=t no_commit=t ;;
166 squash= no_commit= ;;
172 allow_fast_forward=t ;;
174 test "$squash" != t ||
175 die "You cannot combine --squash with --no-ff."
176 allow_fast_forward=f ;;
179 case " $all_strategies " in
181 use_strategies="$use_strategies$1 " ;;
183 die "available strategies are: $all_strategies" ;;
201 test $# != 0 || usage
205 if branch=$(git-symbolic-ref -q HEAD)
207 mergeopts=$(git config "branch.${branch#refs/heads/}.mergeoptions")
208 if test -n "$mergeopts"
210 parse_config $mergeopts --
215 while test $args_left -lt $#; do shift; done
217 if test -z "$show_diffstat"; then
218 test "$(git config --bool merge.diffstat)" = false && show_diffstat=false
219 test "$(git config --bool merge.stat)" = false && show_diffstat=false
220 test -z "$show_diffstat" && show_diffstat=t
223 # This could be traditional "merge <msg> HEAD <commit>..." and the
224 # way we can tell it is to see if the second token is HEAD, but some
225 # people might have misused the interface and used a committish that
226 # is the same as HEAD there instead. Traditional format never would
227 # have "-m" so it is an additional safety measure to check for it.
229 if test -z "$have_message" &&
230 second_token=$(git rev-parse --verify "$2^0" 2>/dev/null) &&
231 head_commit=$(git rev-parse --verify "HEAD" 2>/dev/null) &&
232 test "$second_token" = "$head_commit"
238 elif ! git rev-parse --verify HEAD >/dev/null 2>&1
240 # If the merged head is a valid one there is no reason to
241 # forbid "git merge" into a branch yet to be born. We do
242 # the same for "git pull".
245 echo >&2 "Can merge only exactly one commit into empty head"
249 rh=$(git rev-parse --verify "$1^0") ||
250 die "$1 - not something we can merge"
252 git update-ref -m "initial pull" HEAD "$rh" "" &&
253 git read-tree --reset -u HEAD
257 # We are invoked directly as the first-class UI.
260 # All the rest are the commits being merged; prepare
261 # the standard merge summary message to be appended to
262 # the given message. If remote is invalid we will die
263 # later in the common codepath so we discard the error
265 merge_name=$(for remote
268 done | git fmt-merge-msg $log_arg
270 merge_msg="${merge_msg:+$merge_msg$LF$LF}$merge_name"
272 head=$(git rev-parse --verify "$head_arg"^0) || usage
274 # All the rest are remote heads
275 test "$#" = 0 && usage ;# we need at least one remote head.
276 set_reflog_action "merge $*"
281 remotehead=$(git rev-parse --verify "$remote"^0 2>/dev/null) ||
282 die "$remote - not something we can merge"
283 remoteheads="${remoteheads}$remotehead "
284 eval GITHEAD_$remotehead='"$remote"'
285 export GITHEAD_$remotehead
287 set x $remoteheads ; shift
289 case "$use_strategies" in
293 var="`git config --get pull.twohead`"
296 use_strategies="$var"
298 use_strategies="$default_twohead_strategies"
301 var="`git config --get pull.octopus`"
304 use_strategies="$var"
306 use_strategies="$default_octopus_strategies"
312 for s in $use_strategies
314 for ss in $no_fast_forward_strategies
323 for ss in $no_trivial_strategies
327 allow_trivial_merge=f
336 common=$(git merge-base --all $head "$@")
339 common=$(git show-branch --merge-base $head "$@")
342 echo "$head" >"$GIT_DIR/ORIG_HEAD"
344 case "$allow_fast_forward,$#,$common,$no_commit" in
346 # No common ancestors found. We need a real merge.
349 # If head can reach all the merge then we are up to date.
350 # but first the most common case of merging one remote.
351 finish_up_to_date "Already up-to-date."
355 # Again the most common case of merging one remote.
356 echo "Updating $(git rev-parse --short $head)..$(git rev-parse --short $1)"
357 git update-index --refresh 2>/dev/null
359 if test -n "$have_message"
361 msg="$msg (no commit created; -m option ignored)"
363 new_head=$(git rev-parse --verify "$1^0") &&
364 git read-tree -v -m -u --exclude-per-directory=.gitignore $head "$new_head" &&
365 finish "$new_head" "$msg" || exit
370 # We are not doing octopus and not fast forward. Need a
374 # We are not doing octopus, not fast forward, and have only
376 git update-index --refresh 2>/dev/null
377 case "$allow_trivial_merge" in
379 # See if it is really trivial.
380 git var GIT_COMMITTER_IDENT >/dev/null || exit
381 echo "Trying really trivial in-index merge..."
382 if git read-tree --trivial -m -u -v $common $head "$1" &&
383 result_tree=$(git write-tree)
387 printf '%s\n' "$merge_msg" |
388 git commit-tree $result_tree -p HEAD -p "$1"
390 finish "$result_commit" "In-index merge"
398 # An octopus. If we can reach all the remote we are up to date.
402 common_one=$(git merge-base --all $head $remote)
403 if test "$common_one" != "$remote"
409 if test "$up_to_date" = t
411 finish_up_to_date "Already up-to-date. Yeeah!"
417 # We are going to make a new commit.
418 git var GIT_COMMITTER_IDENT >/dev/null || exit
420 # At this point, we need a real merge. No matter what strategy
421 # we use, it would operate on the index, possibly affecting the
422 # working tree, and when resolved cleanly, have the desired tree
423 # in the index -- this means that the index must be in sync with
424 # the $head commit. The strategies are responsible to ensure this.
426 case "$use_strategies" in
428 # Stash away the local changes so that we can try more than one.
433 rm -f "$GIT_DIR/MERGE_STASH"
438 result_tree= best_cnt=-1 best_strategy= wt_strategy=
440 for strategy in $use_strategies
442 test "$wt_strategy" = '' || {
443 echo "Rewinding the tree to pristine..."
446 case "$single_strategy" in
448 echo "Trying merge strategy $strategy..."
452 # Remember which strategy left the state in the working tree
453 wt_strategy=$strategy
455 git-merge-$strategy $common -- "$head_arg" "$@"
457 if test "$no_commit" = t && test "$exit" = 0
460 exit=1 ;# pretend it left conflicts.
463 test "$exit" = 0 || {
465 # The backend exits with 1 when conflicts are left to be resolved,
466 # with 2 when it does not handle the given merge at all.
468 if test "$exit" -eq 1
471 git diff-files --name-only
472 git ls-files --unmerged
474 if test $best_cnt -le 0 -o $cnt -le $best_cnt
476 best_strategy=$strategy
483 # Automerge succeeded.
484 result_tree=$(git write-tree) && break
487 # If we have a resulting tree, that means the strategy module
488 # auto resolved the merge cleanly.
489 if test '' != "$result_tree"
491 if test "$allow_fast_forward" = "t"
493 parents=$(git show-branch --independent "$head" "$@")
495 parents=$(git rev-parse "$head" "$@")
497 parents=$(echo "$parents" | sed -e 's/^/-p /')
498 result_commit=$(printf '%s\n' "$merge_msg" | git commit-tree $result_tree $parents) || exit
499 finish "$result_commit" "Merge made by $wt_strategy."
504 # Pick the result from the best strategy and have the user fix it up.
505 case "$best_strategy" in
508 case "$use_strategies" in
510 echo >&2 "No merge strategy handled the merge."
513 echo >&2 "Merge with strategy $use_strategies failed."
519 # We already have its result in the working tree.
522 echo "Rewinding the tree to pristine..."
524 echo "Using the $best_strategy to prepare resolving by hand."
525 git-merge-$best_strategy $common -- "$head_arg" "$@"
529 if test "$squash" = t
536 done >"$GIT_DIR/MERGE_HEAD"
537 printf '%s\n' "$merge_msg" >"$GIT_DIR/MERGE_MSG"
540 if test "$merge_was_ok" = t
543 "Automatic merge went well; stopped before committing as requested"
550 git ls-files --unmerged |
551 sed -e 's/^[^ ]* / /' |
553 } >>"$GIT_DIR/MERGE_MSG"
555 die "Automatic merge failed; fix conflicts and then commit the result."