2005-06-21 16:47:37 +00:00
|
|
|
#!/bin/sh
|
2005-07-08 17:57:21 +00:00
|
|
|
|
2007-11-04 10:31:00 +00:00
|
|
|
OPTIONS_KEEPDASHDASH=t
|
|
|
|
OPTIONS_SPEC="\
|
|
|
|
git-branch [options] [<branch>] [<paths>...]
|
|
|
|
--
|
|
|
|
b= create a new branch started at <branch>
|
|
|
|
l create the new branchs reflog
|
|
|
|
track tells if the new branch should track the remote branch
|
|
|
|
f proceed even if the index or working tree is not HEAD
|
|
|
|
m performa three-way merge on local modifications if needed
|
|
|
|
q,quiet be quiet
|
|
|
|
"
|
2005-12-23 06:37:50 +00:00
|
|
|
SUBDIRECTORY_OK=Sometimes
|
2005-12-13 22:30:31 +00:00
|
|
|
. git-sh-setup
|
2006-12-31 04:32:38 +00:00
|
|
|
require_work_tree
|
2005-10-29 21:46:41 +00:00
|
|
|
|
2006-05-19 09:17:16 +00:00
|
|
|
old_name=HEAD
|
2007-07-03 05:52:14 +00:00
|
|
|
old=$(git rev-parse --verify $old_name 2>/dev/null)
|
|
|
|
oldbranch=$(git symbolic-ref $old_name 2>/dev/null)
|
2005-06-21 18:03:11 +00:00
|
|
|
new=
|
2006-05-19 09:17:16 +00:00
|
|
|
new_name=
|
2005-06-21 16:59:26 +00:00
|
|
|
force=
|
2005-06-21 18:03:11 +00:00
|
|
|
branch=
|
2007-03-08 09:58:35 +00:00
|
|
|
track=
|
2005-07-12 03:44:20 +00:00
|
|
|
newbranch=
|
2006-05-19 09:17:16 +00:00
|
|
|
newbranch_log=
|
2006-01-12 22:04:36 +00:00
|
|
|
merge=
|
2007-02-01 17:31:26 +00:00
|
|
|
quiet=
|
2007-04-23 17:17:19 +00:00
|
|
|
v=-v
|
2007-01-08 10:42:30 +00:00
|
|
|
LF='
|
|
|
|
'
|
2007-11-04 10:31:00 +00:00
|
|
|
|
|
|
|
while test $# != 0; do
|
|
|
|
case "$1" in
|
|
|
|
-b)
|
2005-07-12 03:44:20 +00:00
|
|
|
shift
|
2007-11-04 10:31:00 +00:00
|
|
|
newbranch="$1"
|
2005-07-12 03:44:20 +00:00
|
|
|
[ -z "$newbranch" ] &&
|
|
|
|
die "git checkout: -b needs a branch name"
|
2007-07-03 05:52:14 +00:00
|
|
|
git show-ref --verify --quiet -- "refs/heads/$newbranch" &&
|
2005-07-12 03:44:20 +00:00
|
|
|
die "git checkout: branch $newbranch already exists"
|
2007-07-03 05:52:14 +00:00
|
|
|
git check-ref-format "heads/$newbranch" ||
|
2006-02-15 19:22:11 +00:00
|
|
|
die "git checkout: we do not like '$newbranch' as a branch name."
|
2005-07-12 03:44:20 +00:00
|
|
|
;;
|
2007-11-04 10:31:00 +00:00
|
|
|
-l)
|
2007-03-08 09:58:35 +00:00
|
|
|
newbranch_log=-l
|
|
|
|
;;
|
2007-11-04 10:31:00 +00:00
|
|
|
--track|--no-track)
|
|
|
|
track="$1"
|
2006-05-19 09:17:16 +00:00
|
|
|
;;
|
2007-11-04 10:31:00 +00:00
|
|
|
-f)
|
2005-06-21 18:03:11 +00:00
|
|
|
force=1
|
2005-06-21 16:47:37 +00:00
|
|
|
;;
|
2006-01-12 22:04:36 +00:00
|
|
|
-m)
|
|
|
|
merge=1
|
|
|
|
;;
|
2007-11-04 10:31:00 +00:00
|
|
|
-q|--quiet)
|
2007-02-01 17:31:26 +00:00
|
|
|
quiet=1
|
2007-04-23 17:17:19 +00:00
|
|
|
v=
|
2007-02-01 17:31:26 +00:00
|
|
|
;;
|
2005-10-18 08:29:27 +00:00
|
|
|
--)
|
2007-11-04 10:31:00 +00:00
|
|
|
shift
|
2005-10-18 08:29:27 +00:00
|
|
|
break
|
|
|
|
;;
|
2005-06-21 16:47:37 +00:00
|
|
|
*)
|
2007-11-04 10:31:00 +00:00
|
|
|
usage
|
2005-06-21 18:03:11 +00:00
|
|
|
;;
|
2007-11-04 10:31:00 +00:00
|
|
|
esac
|
|
|
|
shift
|
2005-06-21 16:47:37 +00:00
|
|
|
done
|
|
|
|
|
2007-11-04 10:31:00 +00:00
|
|
|
arg="$1"
|
|
|
|
if rev=$(git rev-parse --verify "$arg^0" 2>/dev/null)
|
|
|
|
then
|
|
|
|
[ -z "$rev" ] && die "unknown flag $arg"
|
|
|
|
new_name="$arg"
|
|
|
|
if git show-ref --verify --quiet -- "refs/heads/$arg"
|
|
|
|
then
|
|
|
|
rev=$(git rev-parse --verify "refs/heads/$arg^0")
|
|
|
|
branch="$arg"
|
|
|
|
fi
|
|
|
|
new="$rev"
|
|
|
|
shift
|
|
|
|
elif rev=$(git rev-parse --verify "$arg^{tree}" 2>/dev/null)
|
|
|
|
then
|
|
|
|
# checking out selected paths from a tree-ish.
|
|
|
|
new="$rev"
|
|
|
|
new_name="$arg^{tree}"
|
|
|
|
shift
|
|
|
|
fi
|
|
|
|
[ "$1" = "--" ] && shift
|
|
|
|
|
git-fetch, git-branch: Support local --track via a special remote '.'
This patch adds support for a dummy remote '.' to avoid having
to declare a fake remote like
[remote "local"]
url = .
fetch = refs/heads/*:refs/heads/*
Such a builtin remote simplifies the operation of "git-fetch",
which will populate FETCH_HEAD but will not pretend that two
repositories are in use, will not create a thin pack, and will
not perform any useless remapping of names. The speed
improvement is around 20%, and it should improve more if
"git-fetch" is converted to a builtin.
To this end, git-parse-remote is grown with a new kind of
remote, 'builtin'. In git-fetch.sh, we treat the builtin remote
specially in that it needs no pack/store operations. In fact,
doing git-fetch on a builtin remote will simply populate
FETCH_HEAD appropriately.
The patch also improves of the --track/--no-track support,
extending it so that branch.<name>.remote items referring '.'
can be created. Finally, it fixes a typo in git-checkout.sh.
Signed-off-by: Paolo Bonzini <bonzini@gnu.org>
Signed-off-by: Junio C Hamano <junkio@cox.net>
2007-03-15 08:23:20 +00:00
|
|
|
case "$newbranch,$track" in
|
2007-03-08 09:58:35 +00:00
|
|
|
,--*)
|
|
|
|
die "git checkout: --track and --no-track require -b"
|
|
|
|
esac
|
|
|
|
|
2006-11-15 18:46:10 +00:00
|
|
|
case "$force$merge" in
|
|
|
|
11)
|
|
|
|
die "git checkout: -f and -m are incompatible"
|
|
|
|
esac
|
|
|
|
|
2005-10-18 08:29:27 +00:00
|
|
|
# The behaviour of the command with and without explicit path
|
|
|
|
# parameters is quite different.
|
|
|
|
#
|
|
|
|
# Without paths, we are checking out everything in the work tree,
|
|
|
|
# possibly switching branches. This is the traditional behaviour.
|
2005-07-12 03:44:20 +00:00
|
|
|
#
|
2005-10-18 08:29:27 +00:00
|
|
|
# With paths, we are _never_ switching branch, but checking out
|
|
|
|
# the named paths from either index (when no rev is given),
|
|
|
|
# or the named tree-ish (when rev is given).
|
|
|
|
|
|
|
|
if test "$#" -ge 1
|
|
|
|
then
|
2006-02-15 19:22:11 +00:00
|
|
|
hint=
|
|
|
|
if test "$#" -eq 1
|
|
|
|
then
|
|
|
|
hint="
|
|
|
|
Did you intend to checkout '$@' which can not be resolved as commit?"
|
|
|
|
fi
|
2006-01-12 22:04:36 +00:00
|
|
|
if test '' != "$newbranch$force$merge"
|
2005-10-18 08:29:27 +00:00
|
|
|
then
|
2006-02-15 19:22:11 +00:00
|
|
|
die "git checkout: updating paths is incompatible with switching branches/forcing$hint"
|
2005-10-18 08:29:27 +00:00
|
|
|
fi
|
|
|
|
if test '' != "$new"
|
|
|
|
then
|
|
|
|
# from a specific tree-ish; note that this is for
|
|
|
|
# rescuing paths and is never meant to remove what
|
|
|
|
# is not in the named tree-ish.
|
2007-07-03 05:52:14 +00:00
|
|
|
git ls-tree --full-name -r "$new" "$@" |
|
|
|
|
git update-index --index-info || exit $?
|
2005-10-18 08:29:27 +00:00
|
|
|
fi
|
2006-11-15 18:54:10 +00:00
|
|
|
|
|
|
|
# Make sure the request is about existing paths.
|
2007-11-09 00:36:06 +00:00
|
|
|
git ls-files --full-name --error-unmatch -- "$@" >/dev/null || exit
|
|
|
|
git ls-files --full-name -- "$@" |
|
|
|
|
(cd_to_toplevel && git checkout-index -f -u --stdin)
|
2007-09-26 21:31:01 +00:00
|
|
|
|
2007-11-04 10:31:00 +00:00
|
|
|
# Run a post-checkout hook -- the HEAD does not change so the
|
|
|
|
# current HEAD is passed in for both args
|
2007-09-26 21:31:01 +00:00
|
|
|
if test -x "$GIT_DIR"/hooks/post-checkout; then
|
|
|
|
"$GIT_DIR"/hooks/post-checkout $old $old 0
|
|
|
|
fi
|
|
|
|
|
2005-10-18 08:29:27 +00:00
|
|
|
exit $?
|
|
|
|
else
|
|
|
|
# Make sure we did not fall back on $arg^{tree} codepath
|
|
|
|
# since we are not checking out from an arbitrary tree-ish,
|
|
|
|
# but switching branches.
|
|
|
|
if test '' != "$new"
|
|
|
|
then
|
2007-07-03 05:52:14 +00:00
|
|
|
git rev-parse --verify "$new^{commit}" >/dev/null 2>&1 ||
|
2005-10-18 08:29:27 +00:00
|
|
|
die "Cannot switch branch to a non-commit."
|
|
|
|
fi
|
|
|
|
fi
|
|
|
|
|
2005-12-23 06:37:50 +00:00
|
|
|
# We are switching branches and checking out trees, so
|
|
|
|
# we *NEED* to be at the toplevel.
|
2007-01-12 20:49:05 +00:00
|
|
|
cd_to_toplevel
|
2005-12-23 06:37:50 +00:00
|
|
|
|
2006-05-19 09:17:16 +00:00
|
|
|
[ -z "$new" ] && new=$old && new_name="$old_name"
|
2005-10-18 08:29:27 +00:00
|
|
|
|
2007-01-08 10:08:47 +00:00
|
|
|
# If we don't have an existing branch that we're switching to,
|
2005-07-12 03:44:20 +00:00
|
|
|
# and we don't have a new branch name for the target we
|
2007-01-08 10:08:47 +00:00
|
|
|
# are switching to, then we are detaching our HEAD from any
|
|
|
|
# branch. However, if "git checkout HEAD" detaches the HEAD
|
|
|
|
# from the current branch, even though that may be logically
|
|
|
|
# correct, it feels somewhat funny. More importantly, we do not
|
|
|
|
# want "git checkout" nor "git checkout -f" to detach HEAD.
|
2005-10-18 08:29:27 +00:00
|
|
|
|
2007-01-10 04:39:09 +00:00
|
|
|
detached=
|
|
|
|
detach_warn=
|
|
|
|
|
2007-03-23 09:37:19 +00:00
|
|
|
describe_detached_head () {
|
|
|
|
test -n "$quiet" || {
|
|
|
|
printf >&2 "$1 "
|
2007-11-25 18:34:27 +00:00
|
|
|
GIT_PAGER= git log >&2 -1 --pretty=oneline --abbrev-commit "$2" --
|
2007-03-23 09:37:19 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2007-03-29 08:02:50 +00:00
|
|
|
if test -z "$branch$newbranch" && test "$new_name" != "$old_name"
|
2007-01-02 07:31:08 +00:00
|
|
|
then
|
2007-01-10 04:39:09 +00:00
|
|
|
detached="$new"
|
2007-02-01 17:31:26 +00:00
|
|
|
if test -n "$oldbranch" && test -z "$quiet"
|
2007-01-08 10:19:38 +00:00
|
|
|
then
|
2007-02-01 17:30:28 +00:00
|
|
|
detach_warn="Note: moving to \"$new_name\" which isn't a local branch
|
2007-01-31 19:10:37 +00:00
|
|
|
If you want to create a new branch from this checkout, you may do so
|
|
|
|
(now or later) by using -b with the checkout command again. Example:
|
2007-01-26 16:50:06 +00:00
|
|
|
git checkout -b <new_branch_name>"
|
2007-01-08 10:19:38 +00:00
|
|
|
fi
|
2007-03-29 08:02:50 +00:00
|
|
|
elif test -z "$oldbranch" && test "$new" != "$old"
|
2007-01-08 10:42:30 +00:00
|
|
|
then
|
2007-03-23 09:37:19 +00:00
|
|
|
describe_detached_head 'Previous HEAD position was' "$old"
|
2007-01-02 07:31:08 +00:00
|
|
|
fi
|
2005-07-12 03:44:20 +00:00
|
|
|
|
2006-09-25 05:24:38 +00:00
|
|
|
if [ "X$old" = X ]
|
|
|
|
then
|
2007-02-01 17:31:26 +00:00
|
|
|
if test -z "$quiet"
|
|
|
|
then
|
|
|
|
echo >&2 "warning: You appear to be on a branch yet to be born."
|
|
|
|
echo >&2 "warning: Forcing checkout of $new_name."
|
|
|
|
fi
|
2006-09-25 05:24:38 +00:00
|
|
|
force=1
|
|
|
|
fi
|
|
|
|
|
2005-06-21 16:59:26 +00:00
|
|
|
if [ "$force" ]
|
2005-06-21 16:47:37 +00:00
|
|
|
then
|
2007-07-03 05:52:14 +00:00
|
|
|
git read-tree $v --reset -u $new
|
2005-06-21 16:47:37 +00:00
|
|
|
else
|
2007-07-03 05:52:14 +00:00
|
|
|
git update-index --refresh >/dev/null
|
|
|
|
merge_error=$(git read-tree -m -u --exclude-per-directory=.gitignore $old $new 2>&1) || (
|
2006-01-12 22:04:36 +00:00
|
|
|
case "$merge" in
|
|
|
|
'')
|
|
|
|
echo >&2 "$merge_error"
|
|
|
|
exit 1 ;;
|
2006-01-12 07:07:27 +00:00
|
|
|
esac
|
|
|
|
|
2006-01-12 22:04:36 +00:00
|
|
|
# Match the index to the working tree, and do a three-way.
|
2007-06-07 07:04:01 +00:00
|
|
|
git diff-files --name-only | git update-index --remove --stdin &&
|
2006-01-12 07:07:27 +00:00
|
|
|
work=`git write-tree` &&
|
2007-04-23 17:17:19 +00:00
|
|
|
git read-tree $v --reset -u $new || exit
|
2006-01-12 22:04:36 +00:00
|
|
|
|
2007-03-14 16:48:13 +00:00
|
|
|
eval GITHEAD_$new='${new_name:-${branch:-$new}}' &&
|
2007-01-24 00:51:22 +00:00
|
|
|
eval GITHEAD_$work=local &&
|
|
|
|
export GITHEAD_$new GITHEAD_$work &&
|
|
|
|
git merge-recursive $old -- $new $work
|
2006-01-12 22:04:36 +00:00
|
|
|
|
|
|
|
# Do not register the cleanly merged paths in the index yet.
|
|
|
|
# this is not a real merge before committing, but just carrying
|
|
|
|
# the working tree changes along.
|
|
|
|
unmerged=`git ls-files -u`
|
2007-04-23 17:17:19 +00:00
|
|
|
git read-tree $v --reset $new
|
2006-01-12 22:04:36 +00:00
|
|
|
case "$unmerged" in
|
|
|
|
'') ;;
|
|
|
|
*)
|
|
|
|
(
|
|
|
|
z40=0000000000000000000000000000000000000000
|
|
|
|
echo "$unmerged" |
|
|
|
|
sed -e 's/^[0-7]* [0-9a-f]* /'"0 $z40 /"
|
|
|
|
echo "$unmerged"
|
|
|
|
) | git update-index --index-info
|
|
|
|
;;
|
|
|
|
esac
|
|
|
|
exit 0
|
2006-01-12 07:07:27 +00:00
|
|
|
)
|
2006-01-14 20:31:18 +00:00
|
|
|
saved_err=$?
|
2007-02-01 17:31:26 +00:00
|
|
|
if test "$saved_err" = 0 && test -z "$quiet"
|
2006-02-15 00:05:57 +00:00
|
|
|
then
|
2007-02-01 09:08:41 +00:00
|
|
|
git diff-index --name-status "$new"
|
2006-02-15 00:05:57 +00:00
|
|
|
fi
|
2006-01-14 20:31:18 +00:00
|
|
|
(exit $saved_err)
|
2005-06-21 22:40:00 +00:00
|
|
|
fi
|
|
|
|
|
2007-06-07 07:04:01 +00:00
|
|
|
#
|
2005-12-17 07:12:33 +00:00
|
|
|
# Switch the HEAD pointer to the new branch if we
|
2005-06-21 22:40:00 +00:00
|
|
|
# checked out a branch head, and remove any potential
|
|
|
|
# old MERGE_HEAD's (subsequent commits will clearly not
|
|
|
|
# be based on them, since we re-set the index)
|
|
|
|
#
|
|
|
|
if [ "$?" -eq 0 ]; then
|
2005-07-12 03:44:20 +00:00
|
|
|
if [ "$newbranch" ]; then
|
2007-07-03 05:52:14 +00:00
|
|
|
git branch $track $newbranch_log "$newbranch" "$new_name" || exit
|
2005-07-12 03:44:20 +00:00
|
|
|
branch="$newbranch"
|
|
|
|
fi
|
2007-01-10 04:39:09 +00:00
|
|
|
if test -n "$branch"
|
|
|
|
then
|
2007-07-04 08:33:36 +00:00
|
|
|
old_branch_name=`expr "z$oldbranch" : 'zrefs/heads/\(.*\)'`
|
|
|
|
GIT_DIR="$GIT_DIR" git symbolic-ref -m "checkout: moving from $old_branch_name to $branch" HEAD "refs/heads/$branch"
|
2007-03-21 02:26:47 +00:00
|
|
|
if test -n "$quiet"
|
2007-02-01 09:08:41 +00:00
|
|
|
then
|
2007-03-21 02:26:47 +00:00
|
|
|
true # nothing
|
|
|
|
elif test "refs/heads/$branch" = "$oldbranch"
|
|
|
|
then
|
|
|
|
echo >&2 "Already on branch \"$branch\""
|
|
|
|
else
|
2007-02-01 17:31:26 +00:00
|
|
|
echo >&2 "Switched to${newbranch:+ a new} branch \"$branch\""
|
2007-02-01 09:08:41 +00:00
|
|
|
fi
|
2007-01-10 04:39:09 +00:00
|
|
|
elif test -n "$detached"
|
|
|
|
then
|
2007-07-03 05:52:14 +00:00
|
|
|
git update-ref --no-deref -m "checkout: moving to $arg" HEAD "$detached" ||
|
2007-01-10 04:39:09 +00:00
|
|
|
die "Cannot detach HEAD"
|
|
|
|
if test -n "$detach_warn"
|
|
|
|
then
|
|
|
|
echo >&2 "$detach_warn"
|
|
|
|
fi
|
2007-03-23 09:37:19 +00:00
|
|
|
describe_detached_head 'HEAD is now at' HEAD
|
2007-01-10 04:39:09 +00:00
|
|
|
fi
|
2005-06-21 22:40:00 +00:00
|
|
|
rm -f "$GIT_DIR/MERGE_HEAD"
|
2005-08-23 21:03:14 +00:00
|
|
|
else
|
|
|
|
exit 1
|
2005-06-21 22:40:00 +00:00
|
|
|
fi
|
2007-09-26 21:31:01 +00:00
|
|
|
|
|
|
|
# Run a post-checkout hook
|
|
|
|
if test -x "$GIT_DIR"/hooks/post-checkout; then
|
2007-11-04 10:31:00 +00:00
|
|
|
"$GIT_DIR"/hooks/post-checkout $old $new 1
|
2007-09-26 21:31:01 +00:00
|
|
|
fi
|