builtin-notes: Add "append" subcommand for appending to note objects
[git] / git-rebase.sh
1 #!/bin/sh
2 #
3 # Copyright (c) 2005 Junio C Hamano.
4 #
5
6 USAGE='[--interactive | -i] [-v] [--force-rebase | -f] [--onto <newbase>] [<upstream>|--root] [<branch>] [--quiet | -q]'
7 LONG_USAGE='git-rebase replaces <branch> with a new branch of the
8 same name.  When the --onto option is provided the new branch starts
9 out with a HEAD equal to <newbase>, otherwise it is equal to <upstream>
10 It then attempts to create a new commit for each commit from the original
11 <branch> that does not exist in the <upstream> branch.
12
13 It is possible that a merge failure will prevent this process from being
14 completely automatic.  You will have to resolve any such merge failure
15 and run git rebase --continue.  Another option is to bypass the commit
16 that caused the merge failure with git rebase --skip.  To restore the
17 original <branch> and remove the .git/rebase-apply working files, use the
18 command git rebase --abort instead.
19
20 Note that if <branch> is not specified on the command line, the
21 currently checked out branch is used.
22
23 Example:       git-rebase master~1 topic
24
25         A---B---C topic                   A'\''--B'\''--C'\'' topic
26        /                   -->           /
27   D---E---F---G master          D---E---F---G master
28 '
29
30 SUBDIRECTORY_OK=Yes
31 OPTIONS_SPEC=
32 . git-sh-setup
33 set_reflog_action rebase
34 require_work_tree
35 cd_to_toplevel
36
37 LF='
38 '
39 OK_TO_SKIP_PRE_REBASE=
40 RESOLVEMSG="
41 When you have resolved this problem run \"git rebase --continue\".
42 If you would prefer to skip this patch, instead run \"git rebase --skip\".
43 To restore the original branch and stop rebasing run \"git rebase --abort\".
44 "
45 unset newbase
46 strategy=recursive
47 do_merge=
48 dotest="$GIT_DIR"/rebase-merge
49 prec=4
50 verbose=
51 diffstat=$(git config --bool rebase.stat)
52 git_am_opt=
53 rebase_root=
54 force_rebase=
55 allow_rerere_autoupdate=
56
57 continue_merge () {
58         test -n "$prev_head" || die "prev_head must be defined"
59         test -d "$dotest" || die "$dotest directory does not exist"
60
61         unmerged=$(git ls-files -u)
62         if test -n "$unmerged"
63         then
64                 echo "You still have unmerged paths in your index"
65                 echo "did you forget to use git add?"
66                 die "$RESOLVEMSG"
67         fi
68
69         cmt=`cat "$dotest/current"`
70         if ! git diff-index --quiet --ignore-submodules HEAD --
71         then
72                 if ! git commit --no-verify -C "$cmt"
73                 then
74                         echo "Commit failed, please do not call \"git commit\""
75                         echo "directly, but instead do one of the following: "
76                         die "$RESOLVEMSG"
77                 fi
78                 if test -z "$GIT_QUIET"
79                 then
80                         printf "Committed: %0${prec}d " $msgnum
81                 fi
82         else
83                 if test -z "$GIT_QUIET"
84                 then
85                         printf "Already applied: %0${prec}d " $msgnum
86                 fi
87         fi
88         if test -z "$GIT_QUIET"
89         then
90                 git rev-list --pretty=oneline -1 "$cmt" | sed -e 's/^[^ ]* //'
91         fi
92
93         prev_head=`git rev-parse HEAD^0`
94         # save the resulting commit so we can read-tree on it later
95         echo "$prev_head" > "$dotest/prev_head"
96
97         # onto the next patch:
98         msgnum=$(($msgnum + 1))
99         echo "$msgnum" >"$dotest/msgnum"
100 }
101
102 call_merge () {
103         cmt="$(cat "$dotest/cmt.$1")"
104         echo "$cmt" > "$dotest/current"
105         hd=$(git rev-parse --verify HEAD)
106         cmt_name=$(git symbolic-ref HEAD 2> /dev/null || echo HEAD)
107         msgnum=$(cat "$dotest/msgnum")
108         end=$(cat "$dotest/end")
109         eval GITHEAD_$cmt='"${cmt_name##refs/heads/}~$(($end - $msgnum))"'
110         eval GITHEAD_$hd='$(cat "$dotest/onto_name")'
111         export GITHEAD_$cmt GITHEAD_$hd
112         if test -n "$GIT_QUIET"
113         then
114                 export GIT_MERGE_VERBOSITY=1
115         fi
116         git-merge-$strategy "$cmt^" -- "$hd" "$cmt"
117         rv=$?
118         case "$rv" in
119         0)
120                 unset GITHEAD_$cmt GITHEAD_$hd
121                 return
122                 ;;
123         1)
124                 git rerere $allow_rerere_autoupdate
125                 die "$RESOLVEMSG"
126                 ;;
127         2)
128                 echo "Strategy: $rv $strategy failed, try another" 1>&2
129                 die "$RESOLVEMSG"
130                 ;;
131         *)
132                 die "Unknown exit code ($rv) from command:" \
133                         "git-merge-$strategy $cmt^ -- HEAD $cmt"
134                 ;;
135         esac
136 }
137
138 move_to_original_branch () {
139         test -z "$head_name" &&
140                 head_name="$(cat "$dotest"/head-name)" &&
141                 onto="$(cat "$dotest"/onto)" &&
142                 orig_head="$(cat "$dotest"/orig-head)"
143         case "$head_name" in
144         refs/*)
145                 message="rebase finished: $head_name onto $onto"
146                 git update-ref -m "$message" \
147                         $head_name $(git rev-parse HEAD) $orig_head &&
148                 git symbolic-ref HEAD $head_name ||
149                 die "Could not move back to $head_name"
150                 ;;
151         esac
152 }
153
154 finish_rb_merge () {
155         move_to_original_branch
156         rm -r "$dotest"
157         say All done.
158 }
159
160 is_interactive () {
161         while test $# != 0
162         do
163                 case "$1" in
164                         -i|--interactive)
165                                 interactive_rebase=explicit
166                                 break
167                         ;;
168                         -p|--preserve-merges)
169                                 interactive_rebase=implied
170                         ;;
171                 esac
172                 shift
173         done
174
175         if [ "$interactive_rebase" = implied ]; then
176                 GIT_EDITOR=:
177                 export GIT_EDITOR
178         fi
179
180         test -n "$interactive_rebase" || test -f "$dotest"/interactive
181 }
182
183 run_pre_rebase_hook () {
184         if test -z "$OK_TO_SKIP_PRE_REBASE" &&
185            test -x "$GIT_DIR/hooks/pre-rebase"
186         then
187                 "$GIT_DIR/hooks/pre-rebase" ${1+"$@"} ||
188                 die "The pre-rebase hook refused to rebase."
189         fi
190 }
191
192 test -f "$GIT_DIR"/rebase-apply/applying &&
193         die 'It looks like git-am is in progress. Cannot rebase.'
194
195 is_interactive "$@" && exec git-rebase--interactive "$@"
196
197 if test $# -eq 0
198 then
199         test -d "$dotest" -o -d "$GIT_DIR"/rebase-apply || usage
200         test -d "$dotest" -o -f "$GIT_DIR"/rebase-apply/rebasing &&
201                 die 'A rebase is in progress, try --continue, --skip or --abort.'
202         die "No arguments given and $GIT_DIR/rebase-apply already exists."
203 fi
204
205 while test $# != 0
206 do
207         case "$1" in
208         --no-verify)
209                 OK_TO_SKIP_PRE_REBASE=yes
210                 ;;
211         --continue)
212                 test -d "$dotest" -o -d "$GIT_DIR"/rebase-apply ||
213                         die "No rebase in progress?"
214
215                 git diff-files --quiet --ignore-submodules || {
216                         echo "You must edit all merge conflicts and then"
217                         echo "mark them as resolved using git add"
218                         exit 1
219                 }
220                 if test -d "$dotest"
221                 then
222                         prev_head=$(cat "$dotest/prev_head")
223                         end=$(cat "$dotest/end")
224                         msgnum=$(cat "$dotest/msgnum")
225                         onto=$(cat "$dotest/onto")
226                         GIT_QUIET=$(cat "$dotest/quiet")
227                         continue_merge
228                         while test "$msgnum" -le "$end"
229                         do
230                                 call_merge "$msgnum"
231                                 continue_merge
232                         done
233                         finish_rb_merge
234                         exit
235                 fi
236                 head_name=$(cat "$GIT_DIR"/rebase-apply/head-name) &&
237                 onto=$(cat "$GIT_DIR"/rebase-apply/onto) &&
238                 orig_head=$(cat "$GIT_DIR"/rebase-apply/orig-head) &&
239                 GIT_QUIET=$(cat "$GIT_DIR"/rebase-apply/quiet)
240                 git am --resolved --3way --resolvemsg="$RESOLVEMSG" &&
241                 move_to_original_branch
242                 exit
243                 ;;
244         --skip)
245                 test -d "$dotest" -o -d "$GIT_DIR"/rebase-apply ||
246                         die "No rebase in progress?"
247
248                 git reset --hard HEAD || exit $?
249                 if test -d "$dotest"
250                 then
251                         git rerere clear
252                         prev_head=$(cat "$dotest/prev_head")
253                         end=$(cat "$dotest/end")
254                         msgnum=$(cat "$dotest/msgnum")
255                         msgnum=$(($msgnum + 1))
256                         onto=$(cat "$dotest/onto")
257                         GIT_QUIET=$(cat "$dotest/quiet")
258                         while test "$msgnum" -le "$end"
259                         do
260                                 call_merge "$msgnum"
261                                 continue_merge
262                         done
263                         finish_rb_merge
264                         exit
265                 fi
266                 head_name=$(cat "$GIT_DIR"/rebase-apply/head-name) &&
267                 onto=$(cat "$GIT_DIR"/rebase-apply/onto) &&
268                 orig_head=$(cat "$GIT_DIR"/rebase-apply/orig-head) &&
269                 GIT_QUIET=$(cat "$GIT_DIR"/rebase-apply/quiet)
270                 git am -3 --skip --resolvemsg="$RESOLVEMSG" &&
271                 move_to_original_branch
272                 exit
273                 ;;
274         --abort)
275                 test -d "$dotest" -o -d "$GIT_DIR"/rebase-apply ||
276                         die "No rebase in progress?"
277
278                 git rerere clear
279                 if test -d "$dotest"
280                 then
281                         GIT_QUIET=$(cat "$dotest/quiet")
282                         move_to_original_branch
283                 else
284                         dotest="$GIT_DIR"/rebase-apply
285                         GIT_QUIET=$(cat "$dotest/quiet")
286                         move_to_original_branch
287                 fi
288                 git reset --hard $(cat "$dotest/orig-head")
289                 rm -r "$dotest"
290                 exit
291                 ;;
292         --onto)
293                 test 2 -le "$#" || usage
294                 newbase="$2"
295                 shift
296                 ;;
297         -M|-m|--m|--me|--mer|--merg|--merge)
298                 do_merge=t
299                 ;;
300         -s=*|--s=*|--st=*|--str=*|--stra=*|--strat=*|--strate=*|\
301                 --strateg=*|--strategy=*|\
302         -s|--s|--st|--str|--stra|--strat|--strate|--strateg|--strategy)
303                 case "$#,$1" in
304                 *,*=*)
305                         strategy=`expr "z$1" : 'z-[^=]*=\(.*\)'` ;;
306                 1,*)
307                         usage ;;
308                 *)
309                         strategy="$2"
310                         shift ;;
311                 esac
312                 do_merge=t
313                 ;;
314         -n|--no-stat)
315                 diffstat=
316                 ;;
317         --stat)
318                 diffstat=t
319                 ;;
320         -v|--verbose)
321                 verbose=t
322                 diffstat=t
323                 GIT_QUIET=
324                 ;;
325         -q|--quiet)
326                 GIT_QUIET=t
327                 git_am_opt="$git_am_opt -q"
328                 verbose=
329                 diffstat=
330                 ;;
331         --whitespace=*)
332                 git_am_opt="$git_am_opt $1"
333                 case "$1" in
334                 --whitespace=fix|--whitespace=strip)
335                         force_rebase=t
336                         ;;
337                 esac
338                 ;;
339         --ignore-whitespace)
340                 git_am_opt="$git_am_opt $1"
341                 ;;
342         --committer-date-is-author-date|--ignore-date)
343                 git_am_opt="$git_am_opt $1"
344                 force_rebase=t
345                 ;;
346         -C*)
347                 git_am_opt="$git_am_opt $1"
348                 ;;
349         --root)
350                 rebase_root=t
351                 ;;
352         -f|--f|--fo|--for|--forc|force|--force-r|--force-re|--force-reb|--force-reba|--force-rebas|--force-rebase)
353                 force_rebase=t
354                 ;;
355         --rerere-autoupdate|--no-rerere-autoupdate)
356                 allow_rerere_autoupdate="$1"
357                 ;;
358         -*)
359                 usage
360                 ;;
361         *)
362                 break
363                 ;;
364         esac
365         shift
366 done
367 test $# -gt 2 && usage
368
369 # Make sure we do not have $GIT_DIR/rebase-apply
370 if test -z "$do_merge"
371 then
372         if mkdir "$GIT_DIR"/rebase-apply 2>/dev/null
373         then
374                 rmdir "$GIT_DIR"/rebase-apply
375         else
376                 echo >&2 '
377 It seems that I cannot create a rebase-apply directory, and
378 I wonder if you are in the middle of patch application or another
379 rebase.  If that is not the case, please
380         rm -fr '"$GIT_DIR"'/rebase-apply
381 and run me again.  I am stopping in case you still have something
382 valuable there.'
383                 exit 1
384         fi
385 else
386         if test -d "$dotest"
387         then
388                 die "previous rebase directory $dotest still exists." \
389                         'Try git rebase (--continue | --abort | --skip)'
390         fi
391 fi
392
393 # The tree must be really really clean.
394 if ! git update-index --ignore-submodules --refresh > /dev/null; then
395         echo >&2 "cannot rebase: you have unstaged changes"
396         git diff-files --name-status -r --ignore-submodules -- >&2
397         exit 1
398 fi
399 diff=$(git diff-index --cached --name-status -r --ignore-submodules HEAD --)
400 case "$diff" in
401 ?*)     echo >&2 "cannot rebase: your index contains uncommitted changes"
402         echo >&2 "$diff"
403         exit 1
404         ;;
405 esac
406
407 if test -z "$rebase_root"
408 then
409         # The upstream head must be given.  Make sure it is valid.
410         upstream_name="$1"
411         shift
412         upstream=`git rev-parse --verify "${upstream_name}^0"` ||
413         die "invalid upstream $upstream_name"
414         unset root_flag
415         upstream_arg="$upstream_name"
416 else
417         test -z "$newbase" && die "--root must be used with --onto"
418         unset upstream_name
419         unset upstream
420         root_flag="--root"
421         upstream_arg="$root_flag"
422 fi
423
424 # Make sure the branch to rebase onto is valid.
425 onto_name=${newbase-"$upstream_name"}
426 case "$onto_name" in
427 *...*)
428         if      left=${onto_name%...*} right=${onto_name#*...} &&
429                 onto=$(git merge-base --all ${left:-HEAD} ${right:-HEAD})
430         then
431                 case "$onto" in
432                 ?*"$LF"?*)
433                         die "$onto_name: there are more than one merge bases"
434                         ;;
435                 '')
436                         die "$onto_name: there is no merge base"
437                         ;;
438                 esac
439         else
440                 die "$onto_name: there is no merge base"
441         fi
442         ;;
443 *)
444         onto=$(git rev-parse --verify "${onto_name}^0") || exit
445         ;;
446 esac
447
448 # If a hook exists, give it a chance to interrupt
449 run_pre_rebase_hook "$upstream_arg" "$@"
450
451 # If the branch to rebase is given, that is the branch we will rebase
452 # $branch_name -- branch being rebased, or HEAD (already detached)
453 # $orig_head -- commit object name of tip of the branch before rebasing
454 # $head_name -- refs/heads/<that-branch> or "detached HEAD"
455 switch_to=
456 case "$#" in
457 1)
458         # Is it "rebase other $branchname" or "rebase other $commit"?
459         branch_name="$1"
460         switch_to="$1"
461
462         if git show-ref --verify --quiet -- "refs/heads/$1" &&
463            branch=$(git rev-parse -q --verify "refs/heads/$1")
464         then
465                 head_name="refs/heads/$1"
466         elif branch=$(git rev-parse -q --verify "$1")
467         then
468                 head_name="detached HEAD"
469         else
470                 usage
471         fi
472         ;;
473 *)
474         # Do not need to switch branches, we are already on it.
475         if branch_name=`git symbolic-ref -q HEAD`
476         then
477                 head_name=$branch_name
478                 branch_name=`expr "z$branch_name" : 'zrefs/heads/\(.*\)'`
479         else
480                 head_name="detached HEAD"
481                 branch_name=HEAD ;# detached
482         fi
483         branch=$(git rev-parse --verify "${branch_name}^0") || exit
484         ;;
485 esac
486 orig_head=$branch
487
488 # Now we are rebasing commits $upstream..$branch (or with --root,
489 # everything leading up to $branch) on top of $onto
490
491 # Check if we are already based on $onto with linear history,
492 # but this should be done only when upstream and onto are the same.
493 mb=$(git merge-base "$onto" "$branch")
494 if test "$upstream" = "$onto" && test "$mb" = "$onto" &&
495         # linear history?
496         ! (git rev-list --parents "$onto".."$branch" | sane_grep " .* ") > /dev/null
497 then
498         if test -z "$force_rebase"
499         then
500                 # Lazily switch to the target branch if needed...
501                 test -z "$switch_to" || git checkout "$switch_to"
502                 say "Current branch $branch_name is up to date."
503                 exit 0
504         else
505                 say "Current branch $branch_name is up to date, rebase forced."
506         fi
507 fi
508
509 # Detach HEAD and reset the tree
510 say "First, rewinding head to replay your work on top of it..."
511 git checkout -q "$onto^0" || die "could not detach HEAD"
512 git update-ref ORIG_HEAD $branch
513
514 if test -n "$diffstat"
515 then
516         if test -n "$verbose"
517         then
518                 echo "Changes from $mb to $onto:"
519         fi
520         # We want color (if set), but no pager
521         GIT_PAGER='' git diff --stat --summary "$mb" "$onto"
522 fi
523
524 # If the $onto is a proper descendant of the tip of the branch, then
525 # we just fast-forwarded.
526 if test "$mb" = "$branch"
527 then
528         say "Fast-forwarded $branch_name to $onto_name."
529         move_to_original_branch
530         exit 0
531 fi
532
533 if test -n "$rebase_root"
534 then
535         revisions="$onto..$orig_head"
536 else
537         revisions="$upstream..$orig_head"
538 fi
539
540 if test -z "$do_merge"
541 then
542         git format-patch -k --stdout --full-index --ignore-if-in-upstream \
543                 $root_flag "$revisions" |
544         git am $git_am_opt --rebasing --resolvemsg="$RESOLVEMSG" &&
545         move_to_original_branch
546         ret=$?
547         test 0 != $ret -a -d "$GIT_DIR"/rebase-apply &&
548                 echo $head_name > "$GIT_DIR"/rebase-apply/head-name &&
549                 echo $onto > "$GIT_DIR"/rebase-apply/onto &&
550                 echo $orig_head > "$GIT_DIR"/rebase-apply/orig-head &&
551                 echo "$GIT_QUIET" > "$GIT_DIR"/rebase-apply/quiet
552         exit $ret
553 fi
554
555 # start doing a rebase with git-merge
556 # this is rename-aware if the recursive (default) strategy is used
557
558 mkdir -p "$dotest"
559 echo "$onto" > "$dotest/onto"
560 echo "$onto_name" > "$dotest/onto_name"
561 prev_head=$orig_head
562 echo "$prev_head" > "$dotest/prev_head"
563 echo "$orig_head" > "$dotest/orig-head"
564 echo "$head_name" > "$dotest/head-name"
565 echo "$GIT_QUIET" > "$dotest/quiet"
566
567 msgnum=0
568 for cmt in `git rev-list --reverse --no-merges "$revisions"`
569 do
570         msgnum=$(($msgnum + 1))
571         echo "$cmt" > "$dotest/cmt.$msgnum"
572 done
573
574 echo 1 >"$dotest/msgnum"
575 echo $msgnum >"$dotest/end"
576
577 end=$msgnum
578 msgnum=1
579
580 while test "$msgnum" -le "$end"
581 do
582         call_merge "$msgnum"
583         continue_merge
584 done
585
586 finish_rb_merge