Update comment on gitweb_check/get_feature
[git/ericb.git] / git-mergetool.sh
blob94187c306ccb05d977f2bb35e81828130ab49a61
1 #!/bin/sh
3 # This program resolves merge conflicts in git
5 # Copyright (c) 2006 Theodore Y. Ts'o
7 # This file is licensed under the GPL v2, or a later version
8 # at the discretion of Junio C Hamano.
11 USAGE='[--tool=tool] [file to merge] ...'
12 SUBDIRECTORY_OK=Yes
13 OPTIONS_SPEC=
14 . git-sh-setup
15 require_work_tree
16 prefix=$(git rev-parse --show-prefix)
18 # Returns true if the mode reflects a symlink
19 is_symlink () {
20 test "$1" = 120000
23 local_present () {
24 test -n "$local_mode"
27 remote_present () {
28 test -n "$remote_mode"
31 base_present () {
32 test -n "$base_mode"
35 cleanup_temp_files () {
36 if test "$1" = --save-backup ; then
37 mv -- "$BACKUP" "$MERGED.orig"
38 rm -f -- "$LOCAL" "$REMOTE" "$BASE"
39 else
40 rm -f -- "$LOCAL" "$REMOTE" "$BASE" "$BACKUP"
44 describe_file () {
45 mode="$1"
46 branch="$2"
47 file="$3"
49 printf " {%s}: " "$branch"
50 if test -z "$mode"; then
51 echo "deleted"
52 elif is_symlink "$mode" ; then
53 echo "a symbolic link -> '$(cat "$file")'"
54 else
55 if base_present; then
56 echo "modified"
57 else
58 echo "created"
64 resolve_symlink_merge () {
65 while true; do
66 printf "Use (l)ocal or (r)emote, or (a)bort? "
67 read ans
68 case "$ans" in
69 [lL]*)
70 git checkout-index -f --stage=2 -- "$MERGED"
71 git add -- "$MERGED"
72 cleanup_temp_files --save-backup
73 return
75 [rR]*)
76 git checkout-index -f --stage=3 -- "$MERGED"
77 git add -- "$MERGED"
78 cleanup_temp_files --save-backup
79 return
81 [aA]*)
82 exit 1
84 esac
85 done
88 resolve_deleted_merge () {
89 while true; do
90 if base_present; then
91 printf "Use (m)odified or (d)eleted file, or (a)bort? "
92 else
93 printf "Use (c)reated or (d)eleted file, or (a)bort? "
95 read ans
96 case "$ans" in
97 [mMcC]*)
98 git add -- "$MERGED"
99 cleanup_temp_files --save-backup
100 return
102 [dD]*)
103 git rm -- "$MERGED" > /dev/null
104 cleanup_temp_files
105 return
107 [aA]*)
108 exit 1
110 esac
111 done
114 check_unchanged () {
115 if test "$MERGED" -nt "$BACKUP" ; then
116 status=0;
117 else
118 while true; do
119 echo "$MERGED seems unchanged."
120 printf "Was the merge successful? [y/n] "
121 read answer < /dev/tty
122 case "$answer" in
123 y*|Y*) status=0; break ;;
124 n*|N*) status=1; break ;;
125 esac
126 done
130 merge_file () {
131 MERGED="$1"
133 f=`git ls-files -u -- "$MERGED"`
134 if test -z "$f" ; then
135 if test ! -f "$MERGED" ; then
136 echo "$MERGED: file not found"
137 else
138 echo "$MERGED: file does not need merging"
140 exit 1
143 ext="$$$(expr "$MERGED" : '.*\(\.[^/]*\)$')"
144 BACKUP="./$MERGED.BACKUP.$ext"
145 LOCAL="./$MERGED.LOCAL.$ext"
146 REMOTE="./$MERGED.REMOTE.$ext"
147 BASE="./$MERGED.BASE.$ext"
149 mv -- "$MERGED" "$BACKUP"
150 cp -- "$BACKUP" "$MERGED"
152 base_mode=`git ls-files -u -- "$MERGED" | awk '{if ($3==1) print $1;}'`
153 local_mode=`git ls-files -u -- "$MERGED" | awk '{if ($3==2) print $1;}'`
154 remote_mode=`git ls-files -u -- "$MERGED" | awk '{if ($3==3) print $1;}'`
156 base_present && git cat-file blob ":1:$prefix$MERGED" >"$BASE" 2>/dev/null
157 local_present && git cat-file blob ":2:$prefix$MERGED" >"$LOCAL" 2>/dev/null
158 remote_present && git cat-file blob ":3:$prefix$MERGED" >"$REMOTE" 2>/dev/null
160 if test -z "$local_mode" -o -z "$remote_mode"; then
161 echo "Deleted merge conflict for '$MERGED':"
162 describe_file "$local_mode" "local" "$LOCAL"
163 describe_file "$remote_mode" "remote" "$REMOTE"
164 resolve_deleted_merge
165 return
168 if is_symlink "$local_mode" || is_symlink "$remote_mode"; then
169 echo "Symbolic link merge conflict for '$MERGED':"
170 describe_file "$local_mode" "local" "$LOCAL"
171 describe_file "$remote_mode" "remote" "$REMOTE"
172 resolve_symlink_merge
173 return
176 echo "Normal merge conflict for '$MERGED':"
177 describe_file "$local_mode" "local" "$LOCAL"
178 describe_file "$remote_mode" "remote" "$REMOTE"
179 printf "Hit return to start merge resolution tool (%s): " "$merge_tool"
180 read ans
182 case "$merge_tool" in
183 kdiff3)
184 if base_present ; then
185 ("$merge_tool_path" --auto --L1 "$MERGED (Base)" --L2 "$MERGED (Local)" --L3 "$MERGED (Remote)" \
186 -o "$MERGED" "$BASE" "$LOCAL" "$REMOTE" > /dev/null 2>&1)
187 else
188 ("$merge_tool_path" --auto --L1 "$MERGED (Local)" --L2 "$MERGED (Remote)" \
189 -o "$MERGED" "$LOCAL" "$REMOTE" > /dev/null 2>&1)
191 status=$?
193 tkdiff)
194 if base_present ; then
195 "$merge_tool_path" -a "$BASE" -o "$MERGED" "$LOCAL" "$REMOTE"
196 else
197 "$merge_tool_path" -o "$MERGED" "$LOCAL" "$REMOTE"
199 status=$?
201 meld|vimdiff)
202 touch "$BACKUP"
203 "$merge_tool_path" "$LOCAL" "$MERGED" "$REMOTE"
204 check_unchanged
206 gvimdiff)
207 touch "$BACKUP"
208 "$merge_tool_path" -f "$LOCAL" "$MERGED" "$REMOTE"
209 check_unchanged
211 xxdiff)
212 touch "$BACKUP"
213 if base_present ; then
214 "$merge_tool_path" -X --show-merged-pane \
215 -R 'Accel.SaveAsMerged: "Ctrl-S"' \
216 -R 'Accel.Search: "Ctrl+F"' \
217 -R 'Accel.SearchForward: "Ctrl-G"' \
218 --merged-file "$MERGED" "$LOCAL" "$BASE" "$REMOTE"
219 else
220 "$merge_tool_path" -X --show-merged-pane \
221 -R 'Accel.SaveAsMerged: "Ctrl-S"' \
222 -R 'Accel.Search: "Ctrl+F"' \
223 -R 'Accel.SearchForward: "Ctrl-G"' \
224 --merged-file "$MERGED" "$LOCAL" "$REMOTE"
226 check_unchanged
228 opendiff)
229 touch "$BACKUP"
230 if base_present; then
231 "$merge_tool_path" "$LOCAL" "$REMOTE" -ancestor "$BASE" -merge "$MERGED" | cat
232 else
233 "$merge_tool_path" "$LOCAL" "$REMOTE" -merge "$MERGED" | cat
235 check_unchanged
237 ecmerge)
238 touch "$BACKUP"
239 if base_present; then
240 "$merge_tool_path" "$BASE" "$LOCAL" "$REMOTE" --default --mode=merge3 --to="$MERGED"
241 else
242 "$merge_tool_path" "$LOCAL" "$REMOTE" --default --mode=merge2 --to="$MERGED"
244 check_unchanged
246 emerge)
247 if base_present ; then
248 "$merge_tool_path" -f emerge-files-with-ancestor-command "$LOCAL" "$REMOTE" "$BASE" "$(basename "$MERGED")"
249 else
250 "$merge_tool_path" -f emerge-files-command "$LOCAL" "$REMOTE" "$(basename "$MERGED")"
252 status=$?
255 if test -n "$merge_tool_cmd"; then
256 if test "$merge_tool_trust_exit_code" = "false"; then
257 touch "$BACKUP"
258 ( eval $merge_tool_cmd )
259 check_unchanged
260 else
261 ( eval $merge_tool_cmd )
262 status=$?
266 esac
267 if test "$status" -ne 0; then
268 echo "merge of $MERGED failed" 1>&2
269 mv -- "$BACKUP" "$MERGED"
270 exit 1
273 if test "$merge_keep_backup" = "true"; then
274 mv -- "$BACKUP" "$MERGED.orig"
275 else
276 rm -- "$BACKUP"
279 git add -- "$MERGED"
280 cleanup_temp_files
283 while test $# != 0
285 case "$1" in
286 -t|--tool*)
287 case "$#,$1" in
288 *,*=*)
289 merge_tool=`expr "z$1" : 'z-[^=]*=\(.*\)'`
291 1,*)
292 usage ;;
294 merge_tool="$2"
295 shift ;;
296 esac
299 break
302 usage
305 break
307 esac
308 shift
309 done
311 valid_custom_tool()
313 merge_tool_cmd="$(git config mergetool.$1.cmd)"
314 test -n "$merge_tool_cmd"
317 valid_tool() {
318 case "$1" in
319 kdiff3 | tkdiff | xxdiff | meld | opendiff | emerge | vimdiff | gvimdiff | ecmerge)
320 ;; # happy
322 if ! valid_custom_tool "$1"; then
323 return 1
326 esac
329 init_merge_tool_path() {
330 merge_tool_path=`git config mergetool.$1.path`
331 if test -z "$merge_tool_path" ; then
332 case "$1" in
333 emerge)
334 merge_tool_path=emacs
337 merge_tool_path=$1
339 esac
344 if test -z "$merge_tool"; then
345 merge_tool=`git config merge.tool`
346 if test -n "$merge_tool" && ! valid_tool "$merge_tool"; then
347 echo >&2 "git config option merge.tool set to unknown tool: $merge_tool"
348 echo >&2 "Resetting to default..."
349 unset merge_tool
353 if test -z "$merge_tool" ; then
354 if test -n "$DISPLAY"; then
355 merge_tool_candidates="kdiff3 tkdiff xxdiff meld gvimdiff"
356 if test -n "$GNOME_DESKTOP_SESSION_ID" ; then
357 merge_tool_candidates="meld $merge_tool_candidates"
359 if test "$KDE_FULL_SESSION" = "true"; then
360 merge_tool_candidates="kdiff3 $merge_tool_candidates"
363 if echo "${VISUAL:-$EDITOR}" | grep 'emacs' > /dev/null 2>&1; then
364 merge_tool_candidates="$merge_tool_candidates emerge"
366 if echo "${VISUAL:-$EDITOR}" | grep 'vim' > /dev/null 2>&1; then
367 merge_tool_candidates="$merge_tool_candidates vimdiff"
369 merge_tool_candidates="$merge_tool_candidates opendiff emerge vimdiff"
370 echo "merge tool candidates: $merge_tool_candidates"
371 for i in $merge_tool_candidates; do
372 init_merge_tool_path $i
373 if type "$merge_tool_path" > /dev/null 2>&1; then
374 merge_tool=$i
375 break
377 done
378 if test -z "$merge_tool" ; then
379 echo "No known merge resolution program available."
380 exit 1
382 else
383 if ! valid_tool "$merge_tool"; then
384 echo >&2 "Unknown merge_tool $merge_tool"
385 exit 1
388 init_merge_tool_path "$merge_tool"
390 merge_keep_backup="$(git config --bool merge.keepBackup || echo true)"
392 if test -z "$merge_tool_cmd" && ! type "$merge_tool_path" > /dev/null 2>&1; then
393 echo "The merge tool $merge_tool is not available as '$merge_tool_path'"
394 exit 1
397 if ! test -z "$merge_tool_cmd"; then
398 merge_tool_trust_exit_code="$(git config --bool mergetool.$merge_tool.trustExitCode || echo false)"
403 if test $# -eq 0 ; then
404 files=`git ls-files -u | sed -e 's/^[^ ]* //' | sort -u`
405 if test -z "$files" ; then
406 echo "No files need merging"
407 exit 0
409 echo Merging the files: "$files"
410 git ls-files -u |
411 sed -e 's/^[^ ]* //' |
412 sort -u |
413 while IFS= read i
415 printf "\n"
416 merge_file "$i" < /dev/tty > /dev/tty
417 done
418 else
419 while test $# -gt 0; do
420 printf "\n"
421 merge_file "$1"
422 shift
423 done
425 exit 0