mirror of
https://github.com/git/git.git
synced 2024-06-08 08:56:10 +02:00
6468784dd2
Just went through the docs looking for anything inaccurate or that can be improved. In the '-h' text, in the man page synopsis, and in the man page description: Normalize the ordering of the list of sub-commands: 'add', 'merge', 'split', 'pull', 'push'. This allows us to kinda separate the lower-level add/merge/split from the higher-level pull/push. '-h' text: - correction: Indicate that split's arg is optional. - clarity: Emphasize that 'pull' takes the 'add'/'merge' flags. man page: - correction: State that all subcommands take options (it seemed to indicate that only 'split' takes any options other than '-P'). - correction: 'split' only guarantees that the results are identical if the flags are identical. - correction: The flag is named '--ignore-joins', not '--ignore-join'. - completeness: Clarify that 'push' always operates on HEAD, and that 'split' operates on HEAD if no local commit is given. - clarity: In the description, when listing commands, repeat what their arguments are. This way the reader doesn't need to flip back and forth between the command description and the synopsis and the full description to understand what's being said. - clarity: In the <variables> used to give command arguments, give slightly longer, descriptive names. Like <local-commit> instead of just <commit>. - clarity: Emphasize that 'pull' takes the 'add'/'merge' flags. - style: In the synopsis, list options before the subcommand. This makes things line up and be much more readable when shown non-monospace (such as in `make html`), and also more closely matches other man pages (like `git-submodule.txt`). - style: Use the correct syntax for indicating the options ([<options>] instead of [OPTIONS]). - style: In the synopsis, separate 'pull' and 'push' from the other lower-level commands. I think this helps readability. - style: Code-quote things in prose that seem like they should be code-quoted, like '.gitmodules', flags, or full commands. - style: Minor wording improvements, like more consistent mood (many of the command descriptions start in the imperative mood and switch to the indicative mode by the end). That sort of thing. - style: Capitalize "ID". - style: Remove the "This option is only valid for XXX command" remarks from each option, and instead rely on the section headings. - style: Since that line is getting edited anyway, switch "behaviour" to American "behavior". - style: Trim trailing whitespace. `todo`: - style: Trim trailing whitespace. Signed-off-by: Luke Shumaker <lukeshu@datawire.io> Signed-off-by: Junio C Hamano <gitster@pobox.com>
954 lines
20 KiB
Bash
Executable File
954 lines
20 KiB
Bash
Executable File
#!/bin/sh
|
|
#
|
|
# git-subtree.sh: split/join git repositories in subdirectories of this one
|
|
#
|
|
# Copyright (C) 2009 Avery Pennarun <apenwarr@gmail.com>
|
|
#
|
|
|
|
if test -z "$GIT_EXEC_PATH" || test "${PATH#"${GIT_EXEC_PATH}:"}" = "$PATH" || ! test -f "$GIT_EXEC_PATH/git-sh-setup"
|
|
then
|
|
echo >&2 'It looks like either your git installation or your'
|
|
echo >&2 'git-subtree installation is broken.'
|
|
echo >&2
|
|
echo >&2 "Tips:"
|
|
echo >&2 " - If \`git --exec-path\` does not print the correct path to"
|
|
echo >&2 " your git install directory, then set the GIT_EXEC_PATH"
|
|
echo >&2 " environment variable to the correct directory."
|
|
echo >&2 " - Make sure that your \`${0##*/}\` file is either in your"
|
|
echo >&2 " PATH or in your git exec path (\`$(git --exec-path)\`)."
|
|
echo >&2 " - You should run git-subtree as \`git ${0##*/git-}\`,"
|
|
echo >&2 " not as \`${0##*/}\`." >&2
|
|
exit 126
|
|
fi
|
|
|
|
OPTS_SPEC="\
|
|
git subtree add --prefix=<prefix> <commit>
|
|
git subtree add --prefix=<prefix> <repository> <ref>
|
|
git subtree merge --prefix=<prefix> <commit>
|
|
git subtree split --prefix=<prefix> [<commit>]
|
|
git subtree pull --prefix=<prefix> <repository> <ref>
|
|
git subtree push --prefix=<prefix> <repository> <ref>
|
|
--
|
|
h,help show the help
|
|
q quiet
|
|
d show debug messages
|
|
P,prefix= the name of the subdir to split out
|
|
m,message= use the given message as the commit message for the merge commit
|
|
options for 'split'
|
|
annotate= add a prefix to commit message of new commits
|
|
b,branch= create a new branch from the split subtree
|
|
ignore-joins ignore prior --rejoin commits
|
|
onto= try connecting new tree to an existing one
|
|
rejoin merge the new branch back into HEAD
|
|
options for 'add' and 'merge' (also: 'pull')
|
|
squash merge subtree changes as a single commit
|
|
"
|
|
|
|
arg_debug=
|
|
arg_command=
|
|
arg_prefix=
|
|
arg_split_branch=
|
|
arg_split_onto=
|
|
arg_split_rejoin=
|
|
arg_split_ignore_joins=
|
|
arg_split_annotate=
|
|
arg_addmerge_squash=
|
|
arg_addmerge_message=
|
|
|
|
indent=0
|
|
|
|
# Usage: debug [MSG...]
|
|
debug () {
|
|
if test -n "$arg_debug"
|
|
then
|
|
printf "%$(($indent * 2))s%s\n" '' "$*" >&2
|
|
fi
|
|
}
|
|
|
|
# Usage: progress [MSG...]
|
|
progress () {
|
|
if test -z "$GIT_QUIET"
|
|
then
|
|
if test -z "$arg_debug"
|
|
then
|
|
# Debug mode is off.
|
|
#
|
|
# Print one progress line that we keep updating (use
|
|
# "\r" to return to the beginning of the line, rather
|
|
# than "\n" to start a new line). This only really
|
|
# works when stderr is a terminal.
|
|
printf "%s\r" "$*" >&2
|
|
else
|
|
# Debug mode is on. The `debug` function is regularly
|
|
# printing to stderr.
|
|
#
|
|
# Don't do the one-line-with-"\r" thing, because on a
|
|
# terminal the debug output would overwrite and hide the
|
|
# progress output. Add a "progress:" prefix to make the
|
|
# progress output and the debug output easy to
|
|
# distinguish. This ensures maximum readability whether
|
|
# stderr is a terminal or a file.
|
|
printf "progress: %s\n" "$*" >&2
|
|
fi
|
|
fi
|
|
}
|
|
|
|
# Usage: assert CMD...
|
|
assert () {
|
|
if ! "$@"
|
|
then
|
|
die "assertion failed: $*"
|
|
fi
|
|
}
|
|
|
|
main () {
|
|
if test $# -eq 0
|
|
then
|
|
set -- -h
|
|
fi
|
|
eval "$(echo "$OPTS_SPEC" | git rev-parse --parseopt -- "$@" || echo exit $?)"
|
|
. git-sh-setup
|
|
require_work_tree
|
|
|
|
while test $# -gt 0
|
|
do
|
|
opt="$1"
|
|
shift
|
|
|
|
case "$opt" in
|
|
-q)
|
|
GIT_QUIET=1
|
|
;;
|
|
-d)
|
|
arg_debug=1
|
|
;;
|
|
--annotate)
|
|
arg_split_annotate="$1"
|
|
shift
|
|
;;
|
|
--no-annotate)
|
|
arg_split_annotate=
|
|
;;
|
|
-b)
|
|
arg_split_branch="$1"
|
|
shift
|
|
;;
|
|
-P)
|
|
arg_prefix="${1%/}"
|
|
shift
|
|
;;
|
|
-m)
|
|
arg_addmerge_message="$1"
|
|
shift
|
|
;;
|
|
--no-prefix)
|
|
arg_prefix=
|
|
;;
|
|
--onto)
|
|
arg_split_onto="$1"
|
|
shift
|
|
;;
|
|
--no-onto)
|
|
arg_split_onto=
|
|
;;
|
|
--rejoin)
|
|
arg_split_rejoin=1
|
|
;;
|
|
--no-rejoin)
|
|
arg_split_rejoin=
|
|
;;
|
|
--ignore-joins)
|
|
arg_split_ignore_joins=1
|
|
;;
|
|
--no-ignore-joins)
|
|
arg_split_ignore_joins=
|
|
;;
|
|
--squash)
|
|
arg_addmerge_squash=1
|
|
;;
|
|
--no-squash)
|
|
arg_addmerge_squash=
|
|
;;
|
|
--)
|
|
break
|
|
;;
|
|
*)
|
|
die "Unexpected option: $opt"
|
|
;;
|
|
esac
|
|
done
|
|
|
|
arg_command="$1"
|
|
shift
|
|
|
|
case "$arg_command" in
|
|
add|merge|pull|split|push)
|
|
:
|
|
;;
|
|
*)
|
|
die "Unknown command '$arg_command'"
|
|
;;
|
|
esac
|
|
|
|
if test -z "$arg_prefix"
|
|
then
|
|
die "You must provide the --prefix option."
|
|
fi
|
|
|
|
case "$arg_command" in
|
|
add)
|
|
test -e "$arg_prefix" &&
|
|
die "prefix '$arg_prefix' already exists."
|
|
;;
|
|
*)
|
|
test -e "$arg_prefix" ||
|
|
die "'$arg_prefix' does not exist; use 'git subtree add'"
|
|
;;
|
|
esac
|
|
|
|
dir="$(dirname "$arg_prefix/.")"
|
|
|
|
debug "command: {$arg_command}"
|
|
debug "quiet: {$GIT_QUIET}"
|
|
debug "dir: {$dir}"
|
|
debug "opts: {$*}"
|
|
debug
|
|
|
|
"cmd_$arg_command" "$@"
|
|
}
|
|
|
|
# Usage: cache_setup
|
|
cache_setup () {
|
|
assert test $# = 0
|
|
cachedir="$GIT_DIR/subtree-cache/$$"
|
|
rm -rf "$cachedir" ||
|
|
die "Can't delete old cachedir: $cachedir"
|
|
mkdir -p "$cachedir" ||
|
|
die "Can't create new cachedir: $cachedir"
|
|
mkdir -p "$cachedir/notree" ||
|
|
die "Can't create new cachedir: $cachedir/notree"
|
|
debug "Using cachedir: $cachedir" >&2
|
|
}
|
|
|
|
# Usage: cache_get [REVS...]
|
|
cache_get () {
|
|
for oldrev in "$@"
|
|
do
|
|
if test -r "$cachedir/$oldrev"
|
|
then
|
|
read newrev <"$cachedir/$oldrev"
|
|
echo $newrev
|
|
fi
|
|
done
|
|
}
|
|
|
|
# Usage: cache_miss [REVS...]
|
|
cache_miss () {
|
|
for oldrev in "$@"
|
|
do
|
|
if ! test -r "$cachedir/$oldrev"
|
|
then
|
|
echo $oldrev
|
|
fi
|
|
done
|
|
}
|
|
|
|
# Usage: check_parents PARENTS_EXPR
|
|
check_parents () {
|
|
assert test $# = 1
|
|
missed=$(cache_miss "$1") || exit $?
|
|
local indent=$(($indent + 1))
|
|
for miss in $missed
|
|
do
|
|
if ! test -r "$cachedir/notree/$miss"
|
|
then
|
|
debug "incorrect order: $miss"
|
|
process_split_commit "$miss" ""
|
|
fi
|
|
done
|
|
}
|
|
|
|
# Usage: set_notree REV
|
|
set_notree () {
|
|
assert test $# = 1
|
|
echo "1" > "$cachedir/notree/$1"
|
|
}
|
|
|
|
# Usage: cache_set OLDREV NEWREV
|
|
cache_set () {
|
|
assert test $# = 2
|
|
oldrev="$1"
|
|
newrev="$2"
|
|
if test "$oldrev" != "latest_old" &&
|
|
test "$oldrev" != "latest_new" &&
|
|
test -e "$cachedir/$oldrev"
|
|
then
|
|
die "cache for $oldrev already exists!"
|
|
fi
|
|
echo "$newrev" >"$cachedir/$oldrev"
|
|
}
|
|
|
|
# Usage: rev_exists REV
|
|
rev_exists () {
|
|
assert test $# = 1
|
|
if git rev-parse "$1" >/dev/null 2>&1
|
|
then
|
|
return 0
|
|
else
|
|
return 1
|
|
fi
|
|
}
|
|
|
|
# Usage: try_remove_previous REV
|
|
#
|
|
# If a commit doesn't have a parent, this might not work. But we only want
|
|
# to remove the parent from the rev-list, and since it doesn't exist, it won't
|
|
# be there anyway, so do nothing in that case.
|
|
try_remove_previous () {
|
|
assert test $# = 1
|
|
if rev_exists "$1^"
|
|
then
|
|
echo "^$1^"
|
|
fi
|
|
}
|
|
|
|
# Usage: find_latest_squash DIR
|
|
find_latest_squash () {
|
|
assert test $# = 1
|
|
debug "Looking for latest squash ($dir)..."
|
|
local indent=$(($indent + 1))
|
|
|
|
dir="$1"
|
|
sq=
|
|
main=
|
|
sub=
|
|
git log --grep="^git-subtree-dir: $dir/*\$" \
|
|
--no-show-signature --pretty=format:'START %H%n%s%n%n%b%nEND%n' HEAD |
|
|
while read a b junk
|
|
do
|
|
debug "$a $b $junk"
|
|
debug "{{$sq/$main/$sub}}"
|
|
case "$a" in
|
|
START)
|
|
sq="$b"
|
|
;;
|
|
git-subtree-mainline:)
|
|
main="$b"
|
|
;;
|
|
git-subtree-split:)
|
|
sub="$(git rev-parse "$b^{commit}")" ||
|
|
die "could not rev-parse split hash $b from commit $sq"
|
|
;;
|
|
END)
|
|
if test -n "$sub"
|
|
then
|
|
if test -n "$main"
|
|
then
|
|
# a rejoin commit?
|
|
# Pretend its sub was a squash.
|
|
sq="$sub"
|
|
fi
|
|
debug "Squash found: $sq $sub"
|
|
echo "$sq" "$sub"
|
|
break
|
|
fi
|
|
sq=
|
|
main=
|
|
sub=
|
|
;;
|
|
esac
|
|
done || exit $?
|
|
}
|
|
|
|
# Usage: find_existing_splits DIR REV
|
|
find_existing_splits () {
|
|
assert test $# = 2
|
|
debug "Looking for prior splits..."
|
|
local indent=$(($indent + 1))
|
|
|
|
dir="$1"
|
|
rev="$2"
|
|
main=
|
|
sub=
|
|
local grep_format="^git-subtree-dir: $dir/*\$"
|
|
if test -n "$arg_split_ignore_joins"
|
|
then
|
|
grep_format="^Add '$dir/' from commit '"
|
|
fi
|
|
git log --grep="$grep_format" \
|
|
--no-show-signature --pretty=format:'START %H%n%s%n%n%b%nEND%n' "$rev" |
|
|
while read a b junk
|
|
do
|
|
case "$a" in
|
|
START)
|
|
sq="$b"
|
|
;;
|
|
git-subtree-mainline:)
|
|
main="$b"
|
|
;;
|
|
git-subtree-split:)
|
|
sub="$(git rev-parse "$b^{commit}")" ||
|
|
die "could not rev-parse split hash $b from commit $sq"
|
|
;;
|
|
END)
|
|
debug "Main is: '$main'"
|
|
if test -z "$main" -a -n "$sub"
|
|
then
|
|
# squash commits refer to a subtree
|
|
debug " Squash: $sq from $sub"
|
|
cache_set "$sq" "$sub"
|
|
fi
|
|
if test -n "$main" -a -n "$sub"
|
|
then
|
|
debug " Prior: $main -> $sub"
|
|
cache_set $main $sub
|
|
cache_set $sub $sub
|
|
try_remove_previous "$main"
|
|
try_remove_previous "$sub"
|
|
fi
|
|
main=
|
|
sub=
|
|
;;
|
|
esac
|
|
done || exit $?
|
|
}
|
|
|
|
# Usage: copy_commit REV TREE FLAGS_STR
|
|
copy_commit () {
|
|
assert test $# = 3
|
|
# We're going to set some environment vars here, so
|
|
# do it in a subshell to get rid of them safely later
|
|
debug copy_commit "{$1}" "{$2}" "{$3}"
|
|
git log -1 --no-show-signature --pretty=format:'%an%n%ae%n%aD%n%cn%n%ce%n%cD%n%B' "$1" |
|
|
(
|
|
read GIT_AUTHOR_NAME
|
|
read GIT_AUTHOR_EMAIL
|
|
read GIT_AUTHOR_DATE
|
|
read GIT_COMMITTER_NAME
|
|
read GIT_COMMITTER_EMAIL
|
|
read GIT_COMMITTER_DATE
|
|
export GIT_AUTHOR_NAME \
|
|
GIT_AUTHOR_EMAIL \
|
|
GIT_AUTHOR_DATE \
|
|
GIT_COMMITTER_NAME \
|
|
GIT_COMMITTER_EMAIL \
|
|
GIT_COMMITTER_DATE
|
|
(
|
|
printf "%s" "$arg_split_annotate"
|
|
cat
|
|
) |
|
|
git commit-tree "$2" $3 # reads the rest of stdin
|
|
) || die "Can't copy commit $1"
|
|
}
|
|
|
|
# Usage: add_msg DIR LATEST_OLD LATEST_NEW
|
|
add_msg () {
|
|
assert test $# = 3
|
|
dir="$1"
|
|
latest_old="$2"
|
|
latest_new="$3"
|
|
if test -n "$arg_addmerge_message"
|
|
then
|
|
commit_message="$arg_addmerge_message"
|
|
else
|
|
commit_message="Add '$dir/' from commit '$latest_new'"
|
|
fi
|
|
cat <<-EOF
|
|
$commit_message
|
|
|
|
git-subtree-dir: $dir
|
|
git-subtree-mainline: $latest_old
|
|
git-subtree-split: $latest_new
|
|
EOF
|
|
}
|
|
|
|
# Usage: add_squashed_msg REV DIR
|
|
add_squashed_msg () {
|
|
assert test $# = 2
|
|
if test -n "$arg_addmerge_message"
|
|
then
|
|
echo "$arg_addmerge_message"
|
|
else
|
|
echo "Merge commit '$1' as '$2'"
|
|
fi
|
|
}
|
|
|
|
# Usage: rejoin_msg DIR LATEST_OLD LATEST_NEW
|
|
rejoin_msg () {
|
|
assert test $# = 3
|
|
dir="$1"
|
|
latest_old="$2"
|
|
latest_new="$3"
|
|
if test -n "$arg_addmerge_message"
|
|
then
|
|
commit_message="$arg_addmerge_message"
|
|
else
|
|
commit_message="Split '$dir/' into commit '$latest_new'"
|
|
fi
|
|
cat <<-EOF
|
|
$commit_message
|
|
|
|
git-subtree-dir: $dir
|
|
git-subtree-mainline: $latest_old
|
|
git-subtree-split: $latest_new
|
|
EOF
|
|
}
|
|
|
|
# Usage: squash_msg DIR OLD_SUBTREE_COMMIT NEW_SUBTREE_COMMIT
|
|
squash_msg () {
|
|
assert test $# = 3
|
|
dir="$1"
|
|
oldsub="$2"
|
|
newsub="$3"
|
|
newsub_short=$(git rev-parse --short "$newsub")
|
|
|
|
if test -n "$oldsub"
|
|
then
|
|
oldsub_short=$(git rev-parse --short "$oldsub")
|
|
echo "Squashed '$dir/' changes from $oldsub_short..$newsub_short"
|
|
echo
|
|
git log --no-show-signature --pretty=tformat:'%h %s' "$oldsub..$newsub"
|
|
git log --no-show-signature --pretty=tformat:'REVERT: %h %s' "$newsub..$oldsub"
|
|
else
|
|
echo "Squashed '$dir/' content from commit $newsub_short"
|
|
fi
|
|
|
|
echo
|
|
echo "git-subtree-dir: $dir"
|
|
echo "git-subtree-split: $newsub"
|
|
}
|
|
|
|
# Usage: toptree_for_commit COMMIT
|
|
toptree_for_commit () {
|
|
assert test $# = 1
|
|
commit="$1"
|
|
git rev-parse --verify "$commit^{tree}" || exit $?
|
|
}
|
|
|
|
# Usage: subtree_for_commit COMMIT DIR
|
|
subtree_for_commit () {
|
|
assert test $# = 2
|
|
commit="$1"
|
|
dir="$2"
|
|
git ls-tree "$commit" -- "$dir" |
|
|
while read mode type tree name
|
|
do
|
|
assert test "$name" = "$dir"
|
|
assert test "$type" = "tree" -o "$type" = "commit"
|
|
test "$type" = "commit" && continue # ignore submodules
|
|
echo $tree
|
|
break
|
|
done || exit $?
|
|
}
|
|
|
|
# Usage: tree_changed TREE [PARENTS...]
|
|
tree_changed () {
|
|
assert test $# -gt 0
|
|
tree=$1
|
|
shift
|
|
if test $# -ne 1
|
|
then
|
|
return 0 # weird parents, consider it changed
|
|
else
|
|
ptree=$(toptree_for_commit $1) || exit $?
|
|
if test "$ptree" != "$tree"
|
|
then
|
|
return 0 # changed
|
|
else
|
|
return 1 # not changed
|
|
fi
|
|
fi
|
|
}
|
|
|
|
# Usage: new_squash_commit OLD_SQUASHED_COMMIT OLD_NONSQUASHED_COMMIT NEW_NONSQUASHED_COMMIT
|
|
new_squash_commit () {
|
|
assert test $# = 3
|
|
old="$1"
|
|
oldsub="$2"
|
|
newsub="$3"
|
|
tree=$(toptree_for_commit $newsub) || exit $?
|
|
if test -n "$old"
|
|
then
|
|
squash_msg "$dir" "$oldsub" "$newsub" |
|
|
git commit-tree "$tree" -p "$old" || exit $?
|
|
else
|
|
squash_msg "$dir" "" "$newsub" |
|
|
git commit-tree "$tree" || exit $?
|
|
fi
|
|
}
|
|
|
|
# Usage: copy_or_skip REV TREE NEWPARENTS
|
|
copy_or_skip () {
|
|
assert test $# = 3
|
|
rev="$1"
|
|
tree="$2"
|
|
newparents="$3"
|
|
assert test -n "$tree"
|
|
|
|
identical=
|
|
nonidentical=
|
|
p=
|
|
gotparents=
|
|
copycommit=
|
|
for parent in $newparents
|
|
do
|
|
ptree=$(toptree_for_commit $parent) || exit $?
|
|
test -z "$ptree" && continue
|
|
if test "$ptree" = "$tree"
|
|
then
|
|
# an identical parent could be used in place of this rev.
|
|
if test -n "$identical"
|
|
then
|
|
# if a previous identical parent was found, check whether
|
|
# one is already an ancestor of the other
|
|
mergebase=$(git merge-base $identical $parent)
|
|
if test "$identical" = "$mergebase"
|
|
then
|
|
# current identical commit is an ancestor of parent
|
|
identical="$parent"
|
|
elif test "$parent" != "$mergebase"
|
|
then
|
|
# no common history; commit must be copied
|
|
copycommit=1
|
|
fi
|
|
else
|
|
# first identical parent detected
|
|
identical="$parent"
|
|
fi
|
|
else
|
|
nonidentical="$parent"
|
|
fi
|
|
|
|
# sometimes both old parents map to the same newparent;
|
|
# eliminate duplicates
|
|
is_new=1
|
|
for gp in $gotparents
|
|
do
|
|
if test "$gp" = "$parent"
|
|
then
|
|
is_new=
|
|
break
|
|
fi
|
|
done
|
|
if test -n "$is_new"
|
|
then
|
|
gotparents="$gotparents $parent"
|
|
p="$p -p $parent"
|
|
fi
|
|
done
|
|
|
|
if test -n "$identical" && test -n "$nonidentical"
|
|
then
|
|
extras=$(git rev-list --count $identical..$nonidentical)
|
|
if test "$extras" -ne 0
|
|
then
|
|
# we need to preserve history along the other branch
|
|
copycommit=1
|
|
fi
|
|
fi
|
|
if test -n "$identical" && test -z "$copycommit"
|
|
then
|
|
echo $identical
|
|
else
|
|
copy_commit "$rev" "$tree" "$p" || exit $?
|
|
fi
|
|
}
|
|
|
|
# Usage: ensure_clean
|
|
ensure_clean () {
|
|
assert test $# = 0
|
|
if ! git diff-index HEAD --exit-code --quiet 2>&1
|
|
then
|
|
die "Working tree has modifications. Cannot add."
|
|
fi
|
|
if ! git diff-index --cached HEAD --exit-code --quiet 2>&1
|
|
then
|
|
die "Index has modifications. Cannot add."
|
|
fi
|
|
}
|
|
|
|
# Usage: ensure_valid_ref_format REF
|
|
ensure_valid_ref_format () {
|
|
assert test $# = 1
|
|
git check-ref-format "refs/heads/$1" ||
|
|
die "'$1' does not look like a ref"
|
|
}
|
|
|
|
# Usage: process_split_commit REV PARENTS
|
|
process_split_commit () {
|
|
assert test $# = 2
|
|
local rev="$1"
|
|
local parents="$2"
|
|
|
|
if test $indent -eq 0
|
|
then
|
|
revcount=$(($revcount + 1))
|
|
else
|
|
# processing commit without normal parent information;
|
|
# fetch from repo
|
|
parents=$(git rev-parse "$rev^@")
|
|
extracount=$(($extracount + 1))
|
|
fi
|
|
|
|
progress "$revcount/$revmax ($createcount) [$extracount]"
|
|
|
|
debug "Processing commit: $rev"
|
|
local indent=$(($indent + 1))
|
|
exists=$(cache_get "$rev") || exit $?
|
|
if test -n "$exists"
|
|
then
|
|
debug "prior: $exists"
|
|
return
|
|
fi
|
|
createcount=$(($createcount + 1))
|
|
debug "parents: $parents"
|
|
check_parents "$parents"
|
|
newparents=$(cache_get $parents) || exit $?
|
|
debug "newparents: $newparents"
|
|
|
|
tree=$(subtree_for_commit "$rev" "$dir") || exit $?
|
|
debug "tree is: $tree"
|
|
|
|
# ugly. is there no better way to tell if this is a subtree
|
|
# vs. a mainline commit? Does it matter?
|
|
if test -z "$tree"
|
|
then
|
|
set_notree "$rev"
|
|
if test -n "$newparents"
|
|
then
|
|
cache_set "$rev" "$rev"
|
|
fi
|
|
return
|
|
fi
|
|
|
|
newrev=$(copy_or_skip "$rev" "$tree" "$newparents") || exit $?
|
|
debug "newrev is: $newrev"
|
|
cache_set "$rev" "$newrev"
|
|
cache_set latest_new "$newrev"
|
|
cache_set latest_old "$rev"
|
|
}
|
|
|
|
# Usage: cmd_add REV
|
|
# Or: cmd_add REPOSITORY REF
|
|
cmd_add () {
|
|
|
|
ensure_clean
|
|
|
|
if test $# -eq 1
|
|
then
|
|
git rev-parse -q --verify "$1^{commit}" >/dev/null ||
|
|
die "'$1' does not refer to a commit"
|
|
|
|
cmd_add_commit "$@"
|
|
|
|
elif test $# -eq 2
|
|
then
|
|
# Technically we could accept a refspec here but we're
|
|
# just going to turn around and add FETCH_HEAD under the
|
|
# specified directory. Allowing a refspec might be
|
|
# misleading because we won't do anything with any other
|
|
# branches fetched via the refspec.
|
|
ensure_valid_ref_format "$2"
|
|
|
|
cmd_add_repository "$@"
|
|
else
|
|
say >&2 "error: parameters were '$*'"
|
|
die "Provide either a commit or a repository and commit."
|
|
fi
|
|
}
|
|
|
|
# Usage: cmd_add_repository REPOSITORY REFSPEC
|
|
cmd_add_repository () {
|
|
assert test $# = 2
|
|
echo "git fetch" "$@"
|
|
repository=$1
|
|
refspec=$2
|
|
git fetch "$@" || exit $?
|
|
cmd_add_commit FETCH_HEAD
|
|
}
|
|
|
|
# Usage: cmd_add_commit REV
|
|
cmd_add_commit () {
|
|
# The rev has already been validated by cmd_add(), we just
|
|
# need to normalize it.
|
|
assert test $# = 1
|
|
rev=$(git rev-parse --verify "$1^{commit}") || exit $?
|
|
|
|
debug "Adding $dir as '$rev'..."
|
|
git read-tree --prefix="$dir" $rev || exit $?
|
|
git checkout -- "$dir" || exit $?
|
|
tree=$(git write-tree) || exit $?
|
|
|
|
headrev=$(git rev-parse HEAD) || exit $?
|
|
if test -n "$headrev" && test "$headrev" != "$rev"
|
|
then
|
|
headp="-p $headrev"
|
|
else
|
|
headp=
|
|
fi
|
|
|
|
if test -n "$arg_addmerge_squash"
|
|
then
|
|
rev=$(new_squash_commit "" "" "$rev") || exit $?
|
|
commit=$(add_squashed_msg "$rev" "$dir" |
|
|
git commit-tree "$tree" $headp -p "$rev") || exit $?
|
|
else
|
|
revp=$(peel_committish "$rev") || exit $?
|
|
commit=$(add_msg "$dir" $headrev "$rev" |
|
|
git commit-tree "$tree" $headp -p "$revp") || exit $?
|
|
fi
|
|
git reset "$commit" || exit $?
|
|
|
|
say >&2 "Added dir '$dir'"
|
|
}
|
|
|
|
# Usage: cmd_split [REV]
|
|
cmd_split () {
|
|
if test $# -eq 0
|
|
then
|
|
rev=$(git rev-parse HEAD)
|
|
elif test $# -eq 1
|
|
then
|
|
rev=$(git rev-parse -q --verify "$1^{commit}") ||
|
|
die "'$1' does not refer to a commit"
|
|
else
|
|
die "You must provide exactly one revision. Got: '$*'"
|
|
fi
|
|
|
|
debug "Splitting $dir..."
|
|
cache_setup || exit $?
|
|
|
|
if test -n "$arg_split_onto"
|
|
then
|
|
debug "Reading history for --onto=$arg_split_onto..."
|
|
git rev-list $arg_split_onto |
|
|
while read rev
|
|
do
|
|
# the 'onto' history is already just the subdir, so
|
|
# any parent we find there can be used verbatim
|
|
debug "cache: $rev"
|
|
cache_set "$rev" "$rev"
|
|
done || exit $?
|
|
fi
|
|
|
|
unrevs="$(find_existing_splits "$dir" "$rev")" || exit $?
|
|
|
|
# We can't restrict rev-list to only $dir here, because some of our
|
|
# parents have the $dir contents the root, and those won't match.
|
|
# (and rev-list --follow doesn't seem to solve this)
|
|
grl='git rev-list --topo-order --reverse --parents $rev $unrevs'
|
|
revmax=$(eval "$grl" | wc -l)
|
|
revcount=0
|
|
createcount=0
|
|
extracount=0
|
|
eval "$grl" |
|
|
while read rev parents
|
|
do
|
|
process_split_commit "$rev" "$parents"
|
|
done || exit $?
|
|
|
|
latest_new=$(cache_get latest_new) || exit $?
|
|
if test -z "$latest_new"
|
|
then
|
|
die "No new revisions were found"
|
|
fi
|
|
|
|
if test -n "$arg_split_rejoin"
|
|
then
|
|
debug "Merging split branch into HEAD..."
|
|
latest_old=$(cache_get latest_old) || exit $?
|
|
git merge -s ours \
|
|
--allow-unrelated-histories \
|
|
-m "$(rejoin_msg "$dir" "$latest_old" "$latest_new")" \
|
|
"$latest_new" >&2 || exit $?
|
|
fi
|
|
if test -n "$arg_split_branch"
|
|
then
|
|
if rev_exists "refs/heads/$arg_split_branch"
|
|
then
|
|
if ! git merge-base --is-ancestor "$arg_split_branch" "$latest_new"
|
|
then
|
|
die "Branch '$arg_split_branch' is not an ancestor of commit '$latest_new'."
|
|
fi
|
|
action='Updated'
|
|
else
|
|
action='Created'
|
|
fi
|
|
git update-ref -m 'subtree split' \
|
|
"refs/heads/$arg_split_branch" "$latest_new" || exit $?
|
|
say >&2 "$action branch '$arg_split_branch'"
|
|
fi
|
|
echo "$latest_new"
|
|
exit 0
|
|
}
|
|
|
|
# Usage: cmd_merge REV
|
|
cmd_merge () {
|
|
test $# -eq 1 ||
|
|
die "You must provide exactly one revision. Got: '$*'"
|
|
rev=$(git rev-parse -q --verify "$1^{commit}") ||
|
|
die "'$1' does not refer to a commit"
|
|
ensure_clean
|
|
|
|
if test -n "$arg_addmerge_squash"
|
|
then
|
|
first_split="$(find_latest_squash "$dir")" || exit $?
|
|
if test -z "$first_split"
|
|
then
|
|
die "Can't squash-merge: '$dir' was never added."
|
|
fi
|
|
set $first_split
|
|
old=$1
|
|
sub=$2
|
|
if test "$sub" = "$rev"
|
|
then
|
|
say >&2 "Subtree is already at commit $rev."
|
|
exit 0
|
|
fi
|
|
new=$(new_squash_commit "$old" "$sub" "$rev") || exit $?
|
|
debug "New squash commit: $new"
|
|
rev="$new"
|
|
fi
|
|
|
|
if test -n "$arg_addmerge_message"
|
|
then
|
|
git merge -Xsubtree="$arg_prefix" \
|
|
--message="$arg_addmerge_message" "$rev"
|
|
else
|
|
git merge -Xsubtree="$arg_prefix" $rev
|
|
fi
|
|
}
|
|
|
|
# Usage: cmd_pull REPOSITORY REMOTEREF
|
|
cmd_pull () {
|
|
if test $# -ne 2
|
|
then
|
|
die "You must provide <repository> <ref>"
|
|
fi
|
|
ensure_clean
|
|
ensure_valid_ref_format "$2"
|
|
git fetch "$@" || exit $?
|
|
cmd_merge FETCH_HEAD
|
|
}
|
|
|
|
# Usage: cmd_push REPOSITORY REMOTEREF
|
|
cmd_push () {
|
|
if test $# -ne 2
|
|
then
|
|
die "You must provide <repository> <ref>"
|
|
fi
|
|
ensure_valid_ref_format "$2"
|
|
if test -e "$dir"
|
|
then
|
|
repository=$1
|
|
refspec=$2
|
|
echo "git push using: " "$repository" "$refspec"
|
|
localrev=$(git subtree split --prefix="$arg_prefix") || die
|
|
git push "$repository" "$localrev":"refs/heads/$refspec"
|
|
else
|
|
die "'$dir' must already exist. Try 'git subtree add'."
|
|
fi
|
|
}
|
|
|
|
main "$@"
|