2005-04-19 03:15:10 +08:00
|
|
|
#!/bin/sh
|
|
|
|
|
#
|
2005-08-23 12:57:59 +08:00
|
|
|
# Copyright (c) 2005 Junio C Hamano
|
|
|
|
|
#
|
|
|
|
|
# Fetch one or more remote refs and merge it/them into the current HEAD.
|
|
|
|
|
|
2008-04-06 09:23:43 +08:00
|
|
|
USAGE='[-n | --no-stat] [--[no-]commit] [--[no-]squash] [--[no-]ff] [-s strategy]... [<fetch-options>] <repo> <head>...'
|
2005-12-14 06:30:31 +08:00
|
|
|
LONG_USAGE='Fetch one or more remote refs and merge it/them into the current HEAD.'
|
2007-01-13 04:52:03 +08:00
|
|
|
SUBDIRECTORY_OK=Yes
|
2007-11-06 17:50:02 +08:00
|
|
|
OPTIONS_SPEC=
|
2005-11-24 16:12:11 +08:00
|
|
|
. git-sh-setup
|
2006-12-28 15:34:48 +08:00
|
|
|
set_reflog_action "pull $*"
|
2006-12-31 12:32:38 +08:00
|
|
|
require_work_tree
|
2007-01-13 04:52:03 +08:00
|
|
|
cd_to_toplevel
|
2005-08-26 09:15:32 +08:00
|
|
|
|
2007-01-01 15:21:50 +08:00
|
|
|
test -z "$(git ls-files -u)" ||
|
2007-01-13 04:52:03 +08:00
|
|
|
die "You are in the middle of a conflicted merge."
|
2007-01-01 15:21:50 +08:00
|
|
|
|
2009-10-30 06:08:31 +08:00
|
|
|
strategy_args= diffstat= no_commit= squash= no_ff= ff_only=
|
|
|
|
|
log_arg= verbosity=
|
2007-11-28 21:11:07 +08:00
|
|
|
curr_branch=$(git symbolic-ref -q HEAD)
|
|
|
|
|
curr_branch_short=$(echo "$curr_branch" | sed "s|refs/heads/||")
|
|
|
|
|
rebase=$(git config --bool branch.$curr_branch_short.rebase)
|
2007-09-24 04:42:08 +08:00
|
|
|
while :
|
2005-09-26 10:43:51 +08:00
|
|
|
do
|
|
|
|
|
case "$1" in
|
2008-11-15 08:14:24 +08:00
|
|
|
-q|--quiet)
|
2008-11-18 06:09:30 +08:00
|
|
|
verbosity="$verbosity -q" ;;
|
2008-11-15 08:14:24 +08:00
|
|
|
-v|--verbose)
|
2008-11-18 06:09:30 +08:00
|
|
|
verbosity="$verbosity -v" ;;
|
2008-04-06 09:23:43 +08:00
|
|
|
-n|--no-stat|--no-summary)
|
2009-03-02 05:28:28 +08:00
|
|
|
diffstat=--no-stat ;;
|
2008-04-06 09:23:43 +08:00
|
|
|
--stat|--summary)
|
2009-03-02 05:28:28 +08:00
|
|
|
diffstat=--stat ;;
|
2008-04-06 09:23:46 +08:00
|
|
|
--log|--no-log)
|
|
|
|
|
log_arg=$1 ;;
|
2005-11-02 11:30:11 +08:00
|
|
|
--no-c|--no-co|--no-com|--no-comm|--no-commi|--no-commit)
|
|
|
|
|
no_commit=--no-commit ;;
|
2007-10-29 16:41:18 +08:00
|
|
|
--c|--co|--com|--comm|--commi|--commit)
|
|
|
|
|
no_commit=--commit ;;
|
git-merge --squash
Some people tend to do many little commits on a topic branch,
recording all the trials and errors, and when the topic is
reasonably cooked well, would want to record the net effect of
the series as one commit on top of the mainline, removing the
cruft from the history. The topic is then abandoned or forked
off again from that point at the mainline.
The barebone porcelainish that comes with core git tools does
not officially support such operation, but you can fake it by
using "git pull --no-merge" when such a topic branch is not a
strict superset of the mainline, like this:
git checkout mainline
git pull --no-commit . that-topic-branch
: fix conflicts if any
rm -f .git/MERGE_HEAD
git commit -a -m 'consolidated commit log message'
git branch -f that-topic-branch ;# now fully merged
This however does not work when the topic branch is a fast
forward of the mainline, because normal "git pull" will never
create a merge commit in such a case, and there is nothing
special --no-commit could do to begin with.
This patch introduces a new option, --squash, to support such a
workflow officially in both fast-forward case and true merge
case. The user-level operation would be the same in both cases:
git checkout mainline
git pull --squash . that-topic-branch
: fix conflicts if any -- naturally, there would be
: no conflict if fast forward.
git commit -a -m 'consolidated commit log message'
git branch -f that-topic-branch ;# now fully merged
When the current branch is already up-to-date with respect to
the other branch, there truly is nothing to do, so the new
option does not have any effect.
This was brought up in #git IRC channel recently.
Signed-off-by: Junio C Hamano <junkio@cox.net>
2006-06-23 16:37:02 +08:00
|
|
|
--sq|--squ|--squa|--squas|--squash)
|
|
|
|
|
squash=--squash ;;
|
2007-10-29 16:41:18 +08:00
|
|
|
--no-sq|--no-squ|--no-squa|--no-squas|--no-squash)
|
|
|
|
|
squash=--no-squash ;;
|
|
|
|
|
--ff)
|
|
|
|
|
no_ff=--ff ;;
|
|
|
|
|
--no-ff)
|
|
|
|
|
no_ff=--no-ff ;;
|
2009-10-30 06:08:31 +08:00
|
|
|
--ff-only)
|
|
|
|
|
ff_only=--ff-only ;;
|
2005-09-26 10:43:51 +08:00
|
|
|
-s=*|--s=*|--st=*|--str=*|--stra=*|--strat=*|--strate=*|\
|
|
|
|
|
--strateg=*|--strategy=*|\
|
|
|
|
|
-s|--s|--st|--str|--stra|--strat|--strate|--strateg|--strategy)
|
|
|
|
|
case "$#,$1" in
|
|
|
|
|
*,*=*)
|
2006-06-28 00:54:26 +08:00
|
|
|
strategy=`expr "z$1" : 'z-[^=]*=\(.*\)'` ;;
|
2005-09-26 10:43:51 +08:00
|
|
|
1,*)
|
|
|
|
|
usage ;;
|
|
|
|
|
*)
|
|
|
|
|
strategy="$2"
|
|
|
|
|
shift ;;
|
|
|
|
|
esac
|
|
|
|
|
strategy_args="${strategy_args}-s $strategy "
|
|
|
|
|
;;
|
2007-11-28 21:11:07 +08:00
|
|
|
-r|--r|--re|--reb|--reba|--rebas|--rebase)
|
|
|
|
|
rebase=true
|
|
|
|
|
;;
|
|
|
|
|
--no-r|--no-re|--no-reb|--no-reba|--no-rebas|--no-rebase)
|
|
|
|
|
rebase=false
|
|
|
|
|
;;
|
2005-11-07 13:30:56 +08:00
|
|
|
-h|--h|--he|--hel|--help)
|
|
|
|
|
usage
|
|
|
|
|
;;
|
2007-09-24 04:42:08 +08:00
|
|
|
*)
|
|
|
|
|
# Pass thru anything that may be meant for fetch.
|
2005-10-04 06:45:44 +08:00
|
|
|
break
|
2005-09-26 10:43:51 +08:00
|
|
|
;;
|
|
|
|
|
esac
|
|
|
|
|
shift
|
|
|
|
|
done
|
|
|
|
|
|
2007-12-29 05:58:43 +08:00
|
|
|
error_on_no_merge_candidates () {
|
|
|
|
|
exec >&2
|
|
|
|
|
for opt
|
|
|
|
|
do
|
|
|
|
|
case "$opt" in
|
|
|
|
|
-t|--t|--ta|--tag|--tags)
|
|
|
|
|
echo "Fetching tags only, you probably meant:"
|
|
|
|
|
echo " git fetch --tags"
|
|
|
|
|
exit 1
|
|
|
|
|
esac
|
|
|
|
|
done
|
|
|
|
|
|
2009-11-27 22:17:05 +08:00
|
|
|
if test true = "$rebase"
|
|
|
|
|
then
|
|
|
|
|
op_type=rebase
|
|
|
|
|
op_prep=against
|
|
|
|
|
else
|
|
|
|
|
op_type=merge
|
|
|
|
|
op_prep=with
|
|
|
|
|
fi
|
|
|
|
|
|
2007-12-29 05:58:43 +08:00
|
|
|
curr_branch=${curr_branch#refs/heads/}
|
2009-09-14 04:38:48 +08:00
|
|
|
upstream=$(git config "branch.$curr_branch.merge")
|
pull: improve advice for unconfigured error case
There are several reasons a git-pull invocation might not
have anything marked for merge:
1. We're not on a branch, so there is no branch
configuration.
2. We're on a branch, but there is no configuration for
this branch.
3. We fetched from the configured remote, but the
configured branch to merge didn't get fetched (either
it doesn't exist, or wasn't part of the fetch refspec).
4. We fetched from the non-default remote, but didn't
specify a branch to merge. We can't use the configured
one because it applies to the default remote.
5. We fetched from a specified remote, and a refspec was
given, but it ended up not fetching anything (this is
actually hard to do; if the refspec points to a remote
branch and it doesn't exist, then fetch will fail and
we never make it to this code path. But if you provide
a wildcard refspec like
refs/bogus/*:refs/remotes/origin/*
then you can see this failure).
We have handled (1) and (2) for some time. Recently, commit
a6dbf88 added code to handle case (3).
This patch handles cases (4) and (5), which previously just
fell under other cases, producing a confusing message.
While we're at it, let's rewrap the text for case (3), which
looks terribly ugly as it is.
Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2009-10-06 03:35:16 +08:00
|
|
|
remote=$(git config "branch.$curr_branch.remote")
|
2007-12-29 05:58:43 +08:00
|
|
|
|
pull: improve advice for unconfigured error case
There are several reasons a git-pull invocation might not
have anything marked for merge:
1. We're not on a branch, so there is no branch
configuration.
2. We're on a branch, but there is no configuration for
this branch.
3. We fetched from the configured remote, but the
configured branch to merge didn't get fetched (either
it doesn't exist, or wasn't part of the fetch refspec).
4. We fetched from the non-default remote, but didn't
specify a branch to merge. We can't use the configured
one because it applies to the default remote.
5. We fetched from a specified remote, and a refspec was
given, but it ended up not fetching anything (this is
actually hard to do; if the refspec points to a remote
branch and it doesn't exist, then fetch will fail and
we never make it to this code path. But if you provide
a wildcard refspec like
refs/bogus/*:refs/remotes/origin/*
then you can see this failure).
We have handled (1) and (2) for some time. Recently, commit
a6dbf88 added code to handle case (3).
This patch handles cases (4) and (5), which previously just
fell under other cases, producing a confusing message.
While we're at it, let's rewrap the text for case (3), which
looks terribly ugly as it is.
Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2009-10-06 03:35:16 +08:00
|
|
|
if [ $# -gt 1 ]; then
|
2009-11-27 22:17:05 +08:00
|
|
|
if [ "$rebase" = true ]; then
|
|
|
|
|
printf "There is no candidate for rebasing against "
|
|
|
|
|
else
|
|
|
|
|
printf "There are no candidates for merging "
|
|
|
|
|
fi
|
|
|
|
|
echo "among the refs that you just fetched."
|
pull: improve advice for unconfigured error case
There are several reasons a git-pull invocation might not
have anything marked for merge:
1. We're not on a branch, so there is no branch
configuration.
2. We're on a branch, but there is no configuration for
this branch.
3. We fetched from the configured remote, but the
configured branch to merge didn't get fetched (either
it doesn't exist, or wasn't part of the fetch refspec).
4. We fetched from the non-default remote, but didn't
specify a branch to merge. We can't use the configured
one because it applies to the default remote.
5. We fetched from a specified remote, and a refspec was
given, but it ended up not fetching anything (this is
actually hard to do; if the refspec points to a remote
branch and it doesn't exist, then fetch will fail and
we never make it to this code path. But if you provide
a wildcard refspec like
refs/bogus/*:refs/remotes/origin/*
then you can see this failure).
We have handled (1) and (2) for some time. Recently, commit
a6dbf88 added code to handle case (3).
This patch handles cases (4) and (5), which previously just
fell under other cases, producing a confusing message.
While we're at it, let's rewrap the text for case (3), which
looks terribly ugly as it is.
Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2009-10-06 03:35:16 +08:00
|
|
|
echo "Generally this means that you provided a wildcard refspec which had no"
|
|
|
|
|
echo "matches on the remote end."
|
|
|
|
|
elif [ $# -gt 0 ] && [ "$1" != "$remote" ]; then
|
|
|
|
|
echo "You asked to pull from the remote '$1', but did not specify"
|
2009-11-27 22:17:05 +08:00
|
|
|
echo "a branch. Because this is not the default configured remote"
|
pull: improve advice for unconfigured error case
There are several reasons a git-pull invocation might not
have anything marked for merge:
1. We're not on a branch, so there is no branch
configuration.
2. We're on a branch, but there is no configuration for
this branch.
3. We fetched from the configured remote, but the
configured branch to merge didn't get fetched (either
it doesn't exist, or wasn't part of the fetch refspec).
4. We fetched from the non-default remote, but didn't
specify a branch to merge. We can't use the configured
one because it applies to the default remote.
5. We fetched from a specified remote, and a refspec was
given, but it ended up not fetching anything (this is
actually hard to do; if the refspec points to a remote
branch and it doesn't exist, then fetch will fail and
we never make it to this code path. But if you provide
a wildcard refspec like
refs/bogus/*:refs/remotes/origin/*
then you can see this failure).
We have handled (1) and (2) for some time. Recently, commit
a6dbf88 added code to handle case (3).
This patch handles cases (4) and (5), which previously just
fell under other cases, producing a confusing message.
While we're at it, let's rewrap the text for case (3), which
looks terribly ugly as it is.
Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2009-10-06 03:35:16 +08:00
|
|
|
echo "for your current branch, you must specify a branch on the command line."
|
|
|
|
|
elif [ -z "$curr_branch" ]; then
|
2009-04-08 15:24:03 +08:00
|
|
|
echo "You are not currently on a branch, so I cannot use any"
|
|
|
|
|
echo "'branch.<branchname>.merge' in your configuration file."
|
2009-11-27 22:17:05 +08:00
|
|
|
echo "Please specify which remote branch you want to use on the command"
|
2009-04-08 15:24:03 +08:00
|
|
|
echo "line and try again (e.g. 'git pull <repository> <refspec>')."
|
|
|
|
|
echo "See git-pull(1) for details."
|
2009-09-14 04:38:48 +08:00
|
|
|
elif [ -z "$upstream" ]; then
|
2009-04-08 15:24:03 +08:00
|
|
|
echo "You asked me to pull without telling me which branch you"
|
2009-11-27 22:17:05 +08:00
|
|
|
echo "want to $op_type $op_prep, and 'branch.${curr_branch}.merge' in"
|
|
|
|
|
echo "your configuration file does not tell me, either. Please"
|
|
|
|
|
echo "specify which branch you want to use on the command line and"
|
2009-04-08 15:24:03 +08:00
|
|
|
echo "try again (e.g. 'git pull <repository> <refspec>')."
|
|
|
|
|
echo "See git-pull(1) for details."
|
|
|
|
|
echo
|
2009-11-27 22:17:05 +08:00
|
|
|
echo "If you often $op_type $op_prep the same branch, you may want to"
|
|
|
|
|
echo "use something like the following in your configuration file:"
|
|
|
|
|
echo
|
|
|
|
|
echo " [branch \"${curr_branch}\"]"
|
|
|
|
|
echo " remote = <nickname>"
|
|
|
|
|
echo " merge = <remote-ref>"
|
|
|
|
|
test rebase = "$op_type" &&
|
|
|
|
|
echo " rebase = true"
|
2009-04-08 15:24:03 +08:00
|
|
|
echo
|
2009-11-27 22:17:05 +08:00
|
|
|
echo " [remote \"<nickname>\"]"
|
|
|
|
|
echo " url = <url>"
|
|
|
|
|
echo " fetch = <refspec>"
|
2009-04-08 15:24:03 +08:00
|
|
|
echo
|
|
|
|
|
echo "See git-config(1) for details."
|
2009-09-14 04:38:48 +08:00
|
|
|
else
|
2009-11-27 22:17:05 +08:00
|
|
|
echo "Your configuration specifies to $op_type $op_prep the ref '${upstream#refs/heads/}'"
|
|
|
|
|
echo "from the remote, but no such ref was fetched."
|
2009-04-08 15:24:03 +08:00
|
|
|
fi
|
2007-12-29 05:58:43 +08:00
|
|
|
exit 1
|
|
|
|
|
}
|
|
|
|
|
|
2008-01-27 02:04:37 +08:00
|
|
|
test true = "$rebase" && {
|
2009-08-12 11:27:40 +08:00
|
|
|
if ! git rev-parse -q --verify HEAD >/dev/null
|
|
|
|
|
then
|
|
|
|
|
# On an unborn branch
|
|
|
|
|
if test -f "$GIT_DIR/index"
|
|
|
|
|
then
|
|
|
|
|
die "updating an unborn branch with changes added to the index"
|
|
|
|
|
fi
|
|
|
|
|
else
|
|
|
|
|
git update-index --ignore-submodules --refresh &&
|
|
|
|
|
git diff-files --ignore-submodules --quiet &&
|
|
|
|
|
git diff-index --ignore-submodules --cached --quiet HEAD -- ||
|
|
|
|
|
die "refusing to pull with rebase: your working tree is not up-to-date"
|
|
|
|
|
fi
|
2009-07-19 15:45:16 +08:00
|
|
|
oldremoteref= &&
|
2008-01-27 02:04:37 +08:00
|
|
|
. git-parse-remote &&
|
2009-07-19 15:45:16 +08:00
|
|
|
remoteref="$(get_remote_merge_branch "$@" 2>/dev/null)" &&
|
|
|
|
|
oldremoteref="$(git rev-parse -q --verify "$remoteref")" &&
|
|
|
|
|
for reflog in $(git rev-list -g $remoteref 2>/dev/null)
|
|
|
|
|
do
|
|
|
|
|
if test "$reflog" = "$(git merge-base $reflog $curr_branch)"
|
|
|
|
|
then
|
|
|
|
|
oldremoteref="$reflog"
|
|
|
|
|
break
|
|
|
|
|
fi
|
|
|
|
|
done
|
2008-01-27 02:04:37 +08:00
|
|
|
}
|
2008-12-03 21:26:50 +08:00
|
|
|
orig_head=$(git rev-parse -q --verify HEAD)
|
2008-11-15 08:14:24 +08:00
|
|
|
git fetch $verbosity --update-head-ok "$@" || exit 1
|
2005-08-26 09:15:32 +08:00
|
|
|
|
2008-12-03 21:26:50 +08:00
|
|
|
curr_head=$(git rev-parse -q --verify HEAD)
|
2008-10-15 06:32:20 +08:00
|
|
|
if test -n "$orig_head" && test "$curr_head" != "$orig_head"
|
2005-08-26 09:15:32 +08:00
|
|
|
then
|
|
|
|
|
# The fetch involved updating the current branch.
|
|
|
|
|
|
|
|
|
|
# The working tree and the index file is still based on the
|
|
|
|
|
# $orig_head commit, but we are merging into $curr_head.
|
|
|
|
|
# First update the working tree to match $curr_head.
|
|
|
|
|
|
|
|
|
|
echo >&2 "Warning: fetch updated the current branch head."
|
2009-10-24 16:31:32 +08:00
|
|
|
echo >&2 "Warning: fast-forwarding your working tree from"
|
2006-10-11 14:00:29 +08:00
|
|
|
echo >&2 "Warning: commit $orig_head."
|
2009-04-23 09:46:02 +08:00
|
|
|
git update-index -q --refresh
|
2007-07-03 13:52:14 +08:00
|
|
|
git read-tree -u -m "$orig_head" "$curr_head" ||
|
2006-03-22 17:57:11 +08:00
|
|
|
die 'Cannot fast-forward your working tree.
|
|
|
|
|
After making sure that you saved anything precious from
|
|
|
|
|
$ git diff '$orig_head'
|
|
|
|
|
output, run
|
|
|
|
|
$ git reset --hard
|
|
|
|
|
to recover.'
|
|
|
|
|
|
2005-08-26 09:15:32 +08:00
|
|
|
fi
|
|
|
|
|
|
2005-09-26 13:54:23 +08:00
|
|
|
merge_head=$(sed -e '/ not-for-merge /d' \
|
|
|
|
|
-e 's/ .*//' "$GIT_DIR"/FETCH_HEAD | \
|
|
|
|
|
tr '\012' ' ')
|
2005-08-20 17:57:26 +08:00
|
|
|
|
|
|
|
|
case "$merge_head" in
|
2005-08-23 12:57:59 +08:00
|
|
|
'')
|
2009-10-06 03:03:25 +08:00
|
|
|
error_on_no_merge_candidates "$@"
|
2005-08-23 12:57:59 +08:00
|
|
|
;;
|
2005-09-26 10:43:51 +08:00
|
|
|
?*' '?*)
|
2006-11-17 03:47:22 +08:00
|
|
|
if test -z "$orig_head"
|
|
|
|
|
then
|
2009-06-15 07:08:56 +08:00
|
|
|
die "Cannot merge multiple branches into empty head"
|
2006-11-17 03:47:22 +08:00
|
|
|
fi
|
2009-02-18 21:44:02 +08:00
|
|
|
if test true = "$rebase"
|
|
|
|
|
then
|
2009-06-15 07:08:56 +08:00
|
|
|
die "Cannot rebase onto multiple branches"
|
2009-02-18 21:44:02 +08:00
|
|
|
fi
|
2005-09-26 10:43:51 +08:00
|
|
|
;;
|
|
|
|
|
esac
|
|
|
|
|
|
2006-11-17 03:47:22 +08:00
|
|
|
if test -z "$orig_head"
|
|
|
|
|
then
|
2008-10-15 06:32:20 +08:00
|
|
|
git update-ref -m "initial pull" HEAD $merge_head "$curr_head" &&
|
2007-07-03 13:52:14 +08:00
|
|
|
git read-tree --reset -u HEAD || exit 1
|
2006-11-17 03:47:22 +08:00
|
|
|
exit
|
|
|
|
|
fi
|
|
|
|
|
|
2008-04-06 09:23:46 +08:00
|
|
|
merge_name=$(git fmt-merge-msg $log_arg <"$GIT_DIR/FETCH_HEAD") || exit
|
2008-01-27 02:04:37 +08:00
|
|
|
test true = "$rebase" &&
|
2009-12-09 07:21:02 +08:00
|
|
|
exec git-rebase $diffstat $strategy_args --onto $merge_head \
|
2008-02-23 08:52:29 +08:00
|
|
|
${oldremoteref:-$merge_head}
|
2009-12-09 07:21:02 +08:00
|
|
|
exec git-merge $diffstat $no_commit $squash $no_ff $ff_only $log_arg $strategy_args \
|
|
|
|
|
"$merge_name" HEAD $merge_head $verbosity
|
