completion: also complete git-log's --left-right and --cherry-pick option
[git] / git-commit.sh
1 #!/bin/sh
2 #
3 # Copyright (c) 2005 Linus Torvalds
4 # Copyright (c) 2006 Junio C Hamano
5
6 USAGE='[-a | --interactive] [-s] [-v] [--no-verify] [-m <message> | -F <logfile> | (-C|-c) <commit> | --amend] [-u] [-e] [--author <author>] [--template <file>] [[-i | -o] <path>...]'
7 SUBDIRECTORY_OK=Yes
8 . git-sh-setup
9 require_work_tree
10
11 git rev-parse --verify HEAD >/dev/null 2>&1 || initial_commit=t
12
13 case "$0" in
14 *status)
15         status_only=t
16         ;;
17 *commit)
18         status_only=
19         ;;
20 esac
21
22 refuse_partial () {
23         echo >&2 "$1"
24         echo >&2 "You might have meant to say 'git commit -i paths...', perhaps?"
25         exit 1
26 }
27
28 THIS_INDEX="$GIT_DIR/index"
29 NEXT_INDEX="$GIT_DIR/next-index$$"
30 rm -f "$NEXT_INDEX"
31 save_index () {
32         cp -p "$THIS_INDEX" "$NEXT_INDEX"
33 }
34
35 run_status () {
36         # If TMP_INDEX is defined, that means we are doing
37         # "--only" partial commit, and that index file is used
38         # to build the tree for the commit.  Otherwise, if
39         # NEXT_INDEX exists, that is the index file used to
40         # make the commit.  Otherwise we are using as-is commit
41         # so the regular index file is what we use to compare.
42         if test '' != "$TMP_INDEX"
43         then
44                 GIT_INDEX_FILE="$TMP_INDEX"
45                 export GIT_INDEX_FILE
46         elif test -f "$NEXT_INDEX"
47         then
48                 GIT_INDEX_FILE="$NEXT_INDEX"
49                 export GIT_INDEX_FILE
50         fi
51
52         if test "$status_only" = "t" -o "$use_status_color" = "t"; then
53                 color=
54         else
55                 color=--nocolor
56         fi
57         git runstatus ${color} \
58                 ${verbose:+--verbose} \
59                 ${amend:+--amend} \
60                 ${untracked_files:+--untracked}
61 }
62
63 trap '
64         test -z "$TMP_INDEX" || {
65                 test -f "$TMP_INDEX" && rm -f "$TMP_INDEX"
66         }
67         rm -f "$NEXT_INDEX"
68 ' 0
69
70 ################################################################
71 # Command line argument parsing and sanity checking
72
73 all=
74 also=
75 interactive=
76 only=
77 logfile=
78 use_commit=
79 amend=
80 edit_flag=
81 no_edit=
82 log_given=
83 log_message=
84 verify=t
85 quiet=
86 verbose=
87 signoff=
88 force_author=
89 only_include_assumed=
90 untracked_files=
91 templatefile="`git config commit.template`"
92 while case "$#" in 0) break;; esac
93 do
94         case "$1" in
95         -F|--F|-f|--f|--fi|--fil|--file)
96                 case "$#" in 1) usage ;; esac
97                 shift
98                 no_edit=t
99                 log_given=t$log_given
100                 logfile="$1"
101                 shift
102                 ;;
103         -F*|-f*)
104                 no_edit=t
105                 log_given=t$log_given
106                 logfile=`expr "z$1" : 'z-[Ff]\(.*\)'`
107                 shift
108                 ;;
109         --F=*|--f=*|--fi=*|--fil=*|--file=*)
110                 no_edit=t
111                 log_given=t$log_given
112                 logfile=`expr "z$1" : 'z-[^=]*=\(.*\)'`
113                 shift
114                 ;;
115         -a|--a|--al|--all)
116                 all=t
117                 shift
118                 ;;
119         --au=*|--aut=*|--auth=*|--autho=*|--author=*)
120                 force_author=`expr "z$1" : 'z-[^=]*=\(.*\)'`
121                 shift
122                 ;;
123         --au|--aut|--auth|--autho|--author)
124                 case "$#" in 1) usage ;; esac
125                 shift
126                 force_author="$1"
127                 shift
128                 ;;
129         -e|--e|--ed|--edi|--edit)
130                 edit_flag=t
131                 shift
132                 ;;
133         -i|--i|--in|--inc|--incl|--inclu|--includ|--include)
134                 also=t
135                 shift
136                 ;;
137         --int|--inte|--inter|--intera|--interac|--interact|--interacti|\
138         --interactiv|--interactive)
139                 interactive=t
140                 shift
141                 ;;
142         -o|--o|--on|--onl|--only)
143                 only=t
144                 shift
145                 ;;
146         -m|--m|--me|--mes|--mess|--messa|--messag|--message)
147                 case "$#" in 1) usage ;; esac
148                 shift
149                 log_given=m$log_given
150                 if test "$log_message" = ''
151                 then
152                     log_message="$1"
153                 else
154                     log_message="$log_message
155
156 $1"
157                 fi
158                 no_edit=t
159                 shift
160                 ;;
161         -m*)
162                 log_given=m$log_given
163                 if test "$log_message" = ''
164                 then
165                     log_message=`expr "z$1" : 'z-m\(.*\)'`
166                 else
167                     log_message="$log_message
168
169 `expr "z$1" : 'z-m\(.*\)'`"
170                 fi
171                 no_edit=t
172                 shift
173                 ;;
174         --m=*|--me=*|--mes=*|--mess=*|--messa=*|--messag=*|--message=*)
175                 log_given=m$log_given
176                 if test "$log_message" = ''
177                 then
178                     log_message=`expr "z$1" : 'z-[^=]*=\(.*\)'`
179                 else
180                     log_message="$log_message
181
182 `expr "z$1" : 'zq-[^=]*=\(.*\)'`"
183                 fi
184                 no_edit=t
185                 shift
186                 ;;
187         -n|--n|--no|--no-|--no-v|--no-ve|--no-ver|--no-veri|--no-verif|\
188         --no-verify)
189                 verify=
190                 shift
191                 ;;
192         --a|--am|--ame|--amen|--amend)
193                 amend=t
194                 use_commit=HEAD
195                 shift
196                 ;;
197         -c)
198                 case "$#" in 1) usage ;; esac
199                 shift
200                 log_given=t$log_given
201                 use_commit="$1"
202                 no_edit=
203                 shift
204                 ;;
205         --ree=*|--reed=*|--reedi=*|--reedit=*|--reedit-=*|--reedit-m=*|\
206         --reedit-me=*|--reedit-mes=*|--reedit-mess=*|--reedit-messa=*|\
207         --reedit-messag=*|--reedit-message=*)
208                 log_given=t$log_given
209                 use_commit=`expr "z$1" : 'z-[^=]*=\(.*\)'`
210                 no_edit=
211                 shift
212                 ;;
213         --ree|--reed|--reedi|--reedit|--reedit-|--reedit-m|--reedit-me|\
214         --reedit-mes|--reedit-mess|--reedit-messa|--reedit-messag|\
215         --reedit-message)
216                 case "$#" in 1) usage ;; esac
217                 shift
218                 log_given=t$log_given
219                 use_commit="$1"
220                 no_edit=
221                 shift
222                 ;;
223         -C)
224                 case "$#" in 1) usage ;; esac
225                 shift
226                 log_given=t$log_given
227                 use_commit="$1"
228                 no_edit=t
229                 shift
230                 ;;
231         --reu=*|--reus=*|--reuse=*|--reuse-=*|--reuse-m=*|--reuse-me=*|\
232         --reuse-mes=*|--reuse-mess=*|--reuse-messa=*|--reuse-messag=*|\
233         --reuse-message=*)
234                 log_given=t$log_given
235                 use_commit=`expr "z$1" : 'z-[^=]*=\(.*\)'`
236                 no_edit=t
237                 shift
238                 ;;
239         --reu|--reus|--reuse|--reuse-|--reuse-m|--reuse-me|--reuse-mes|\
240         --reuse-mess|--reuse-messa|--reuse-messag|--reuse-message)
241                 case "$#" in 1) usage ;; esac
242                 shift
243                 log_given=t$log_given
244                 use_commit="$1"
245                 no_edit=t
246                 shift
247                 ;;
248         -s|--s|--si|--sig|--sign|--signo|--signof|--signoff)
249                 signoff=t
250                 shift
251                 ;;
252         -t|--t|--te|--tem|--temp|--templ|--templa|--templat|--template)
253                 case "$#" in 1) usage ;; esac
254                 shift
255                 templatefile="$1"
256                 no_edit=
257                 shift
258                 ;;
259         -q|--q|--qu|--qui|--quie|--quiet)
260                 quiet=t
261                 shift
262                 ;;
263         -v|--v|--ve|--ver|--verb|--verbo|--verbos|--verbose)
264                 verbose=t
265                 shift
266                 ;;
267         -u|--u|--un|--unt|--untr|--untra|--untrac|--untrack|--untracke|\
268         --untracked|--untracked-|--untracked-f|--untracked-fi|--untracked-fil|\
269         --untracked-file|--untracked-files)
270                 untracked_files=t
271                 shift
272                 ;;
273         --)
274                 shift
275                 break
276                 ;;
277         -*)
278                 usage
279                 ;;
280         *)
281                 break
282                 ;;
283         esac
284 done
285 case "$edit_flag" in t) no_edit= ;; esac
286
287 ################################################################
288 # Sanity check options
289
290 case "$amend,$initial_commit" in
291 t,t)
292         die "You do not have anything to amend." ;;
293 t,)
294         if [ -f "$GIT_DIR/MERGE_HEAD" ]; then
295                 die "You are in the middle of a merge -- cannot amend."
296         fi ;;
297 esac
298
299 case "$log_given" in
300 tt*)
301         die "Only one of -c/-C/-F can be used." ;;
302 *tm*|*mt*)
303         die "Option -m cannot be combined with -c/-C/-F." ;;
304 esac
305
306 case "$#,$also,$only,$amend" in
307 *,t,t,*)
308         die "Only one of --include/--only can be used." ;;
309 0,t,,* | 0,,t,)
310         die "No paths with --include/--only does not make sense." ;;
311 0,,t,t)
312         only_include_assumed="# Clever... amending the last one with dirty index." ;;
313 0,,,*)
314         ;;
315 *,,,*)
316         only_include_assumed="# Explicit paths specified without -i nor -o; assuming --only paths..."
317         also=
318         ;;
319 esac
320 unset only
321 case "$all,$interactive,$also,$#" in
322 *t,*t,*)
323         die "Cannot use -a, --interactive or -i at the same time." ;;
324 t,,[1-9]*)
325         die "Paths with -a does not make sense." ;;
326 ,t,[1-9]*)
327         die "Paths with --interactive does not make sense." ;;
328 ,,t,0)
329         die "No paths with -i does not make sense." ;;
330 esac
331
332 if test ! -z "$templatefile" -a -z "$log_given"
333 then
334         if test ! -f "$templatefile"
335         then
336                 die "Commit template file does not exist."
337         fi
338 fi
339
340 ################################################################
341 # Prepare index to have a tree to be committed
342
343 case "$all,$also" in
344 t,)
345         if test ! -f "$THIS_INDEX"
346         then
347                 die 'nothing to commit (use "git add file1 file2" to include for commit)'
348         fi
349         save_index &&
350         (
351                 cd_to_toplevel &&
352                 GIT_INDEX_FILE="$NEXT_INDEX" &&
353                 export GIT_INDEX_FILE &&
354                 git diff-files --name-only -z |
355                 git update-index --remove -z --stdin
356         ) || exit
357         ;;
358 ,t)
359         save_index &&
360         git ls-files --error-unmatch -- "$@" >/dev/null || exit
361
362         git diff-files --name-only -z -- "$@"  |
363         (
364                 cd_to_toplevel &&
365                 GIT_INDEX_FILE="$NEXT_INDEX" &&
366                 export GIT_INDEX_FILE &&
367                 git update-index --remove -z --stdin
368         ) || exit
369         ;;
370 ,)
371         if test "$interactive" = t; then
372                 git add --interactive || exit
373         fi
374         case "$#" in
375         0)
376                 ;; # commit as-is
377         *)
378                 if test -f "$GIT_DIR/MERGE_HEAD"
379                 then
380                         refuse_partial "Cannot do a partial commit during a merge."
381                 fi
382                 TMP_INDEX="$GIT_DIR/tmp-index$$"
383                 commit_only=`git ls-files --error-unmatch -- "$@"` || exit
384
385                 # Build a temporary index and update the real index
386                 # the same way.
387                 if test -z "$initial_commit"
388                 then
389                         GIT_INDEX_FILE="$THIS_INDEX" \
390                         git read-tree --index-output="$TMP_INDEX" -i -m HEAD
391                 else
392                         rm -f "$TMP_INDEX"
393                 fi || exit
394
395                 printf '%s\n' "$commit_only" |
396                 GIT_INDEX_FILE="$TMP_INDEX" \
397                 git update-index --add --remove --stdin &&
398
399                 save_index &&
400                 printf '%s\n' "$commit_only" |
401                 (
402                         GIT_INDEX_FILE="$NEXT_INDEX"
403                         export GIT_INDEX_FILE
404                         git update-index --remove --stdin
405                 ) || exit
406                 ;;
407         esac
408         ;;
409 esac
410
411 ################################################################
412 # If we do as-is commit, the index file will be THIS_INDEX,
413 # otherwise NEXT_INDEX after we make this commit.  We leave
414 # the index as is if we abort.
415
416 if test -f "$NEXT_INDEX"
417 then
418         USE_INDEX="$NEXT_INDEX"
419 else
420         USE_INDEX="$THIS_INDEX"
421 fi
422
423 case "$status_only" in
424 t)
425         # This will silently fail in a read-only repository, which is
426         # what we want.
427         GIT_INDEX_FILE="$USE_INDEX" git update-index -q --unmerged --refresh
428         run_status
429         exit $?
430         ;;
431 '')
432         GIT_INDEX_FILE="$USE_INDEX" git update-index -q --refresh || exit
433         ;;
434 esac
435
436 ################################################################
437 # Grab commit message, write out tree and make commit.
438
439 if test t = "$verify" && test -x "$GIT_DIR"/hooks/pre-commit
440 then
441         if test "$TMP_INDEX"
442         then
443                 GIT_INDEX_FILE="$TMP_INDEX" "$GIT_DIR"/hooks/pre-commit
444         else
445                 GIT_INDEX_FILE="$USE_INDEX" "$GIT_DIR"/hooks/pre-commit
446         fi || exit
447 fi
448
449 if test "$log_message" != ''
450 then
451         printf '%s\n' "$log_message"
452 elif test "$logfile" != ""
453 then
454         if test "$logfile" = -
455         then
456                 test -t 0 &&
457                 echo >&2 "(reading log message from standard input)"
458                 cat
459         else
460                 cat <"$logfile"
461         fi
462 elif test "$use_commit" != ""
463 then
464         encoding=$(git config i18n.commitencoding || echo UTF-8)
465         git show -s --pretty=raw --encoding="$encoding" "$use_commit" |
466         sed -e '1,/^$/d' -e 's/^    //'
467 elif test -f "$GIT_DIR/MERGE_MSG"
468 then
469         cat "$GIT_DIR/MERGE_MSG"
470 elif test -f "$GIT_DIR/SQUASH_MSG"
471 then
472         cat "$GIT_DIR/SQUASH_MSG"
473 elif test "$templatefile" != ""
474 then
475         cat "$templatefile"
476 fi | git stripspace >"$GIT_DIR"/COMMIT_EDITMSG
477
478 case "$signoff" in
479 t)
480         sign=$(git-var GIT_COMMITTER_IDENT | sed -e '
481                 s/>.*/>/
482                 s/^/Signed-off-by: /
483                 ')
484         blank_before_signoff=
485         tail -n 1 "$GIT_DIR"/COMMIT_EDITMSG |
486         grep 'Signed-off-by:' >/dev/null || blank_before_signoff='
487 '
488         tail -n 1 "$GIT_DIR"/COMMIT_EDITMSG |
489         grep "$sign"$ >/dev/null ||
490         printf '%s%s\n' "$blank_before_signoff" "$sign" \
491                 >>"$GIT_DIR"/COMMIT_EDITMSG
492         ;;
493 esac
494
495 if test -f "$GIT_DIR/MERGE_HEAD" && test -z "$no_edit"; then
496         echo "#"
497         echo "# It looks like you may be committing a MERGE."
498         echo "# If this is not correct, please remove the file"
499         printf '%s\n' "#        $GIT_DIR/MERGE_HEAD"
500         echo "# and try again"
501         echo "#"
502 fi >>"$GIT_DIR"/COMMIT_EDITMSG
503
504 # Author
505 if test '' != "$use_commit"
506 then
507         eval "$(get_author_ident_from_commit "$use_commit")"
508         export GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL GIT_AUTHOR_DATE
509 fi
510 if test '' != "$force_author"
511 then
512         GIT_AUTHOR_NAME=`expr "z$force_author" : 'z\(.*[^ ]\) *<.*'` &&
513         GIT_AUTHOR_EMAIL=`expr "z$force_author" : '.*\(<.*\)'` &&
514         test '' != "$GIT_AUTHOR_NAME" &&
515         test '' != "$GIT_AUTHOR_EMAIL" ||
516         die "malformed --author parameter"
517         export GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL
518 fi
519
520 PARENTS="-p HEAD"
521 if test -z "$initial_commit"
522 then
523         rloga='commit'
524         if [ -f "$GIT_DIR/MERGE_HEAD" ]; then
525                 rloga='commit (merge)'
526                 PARENTS="-p HEAD "`sed -e 's/^/-p /' "$GIT_DIR/MERGE_HEAD"`
527         elif test -n "$amend"; then
528                 rloga='commit (amend)'
529                 PARENTS=$(git cat-file commit HEAD |
530                         sed -n -e '/^$/q' -e 's/^parent /-p /p')
531         fi
532         current="$(git rev-parse --verify HEAD)"
533 else
534         if [ -z "$(git ls-files)" ]; then
535                 echo >&2 'nothing to commit (use "git add file1 file2" to include for commit)'
536                 exit 1
537         fi
538         PARENTS=""
539         rloga='commit (initial)'
540         current=''
541 fi
542 set_reflog_action "$rloga"
543
544 if test -z "$no_edit"
545 then
546         {
547                 echo ""
548                 echo "# Please enter the commit message for your changes."
549                 echo "# (Comment lines starting with '#' will not be included)"
550                 test -z "$only_include_assumed" || echo "$only_include_assumed"
551                 run_status
552         } >>"$GIT_DIR"/COMMIT_EDITMSG
553 else
554         # we need to check if there is anything to commit
555         run_status >/dev/null
556 fi
557 if [ "$?" != "0" -a ! -f "$GIT_DIR/MERGE_HEAD" -a -z "$amend" ]
558 then
559         rm -f "$GIT_DIR/COMMIT_EDITMSG" "$GIT_DIR/SQUASH_MSG"
560         use_status_color=t
561         run_status
562         exit 1
563 fi
564
565 case "$no_edit" in
566 '')
567         git-var GIT_AUTHOR_IDENT > /dev/null  || die
568         git-var GIT_COMMITTER_IDENT > /dev/null  || die
569         git_editor "$GIT_DIR/COMMIT_EDITMSG"
570         ;;
571 esac
572
573 case "$verify" in
574 t)
575         if test -x "$GIT_DIR"/hooks/commit-msg
576         then
577                 "$GIT_DIR"/hooks/commit-msg "$GIT_DIR"/COMMIT_EDITMSG || exit
578         fi
579 esac
580
581 if test -z "$no_edit"
582 then
583     sed -e '
584         /^diff --git a\/.*/{
585             s///
586             q
587         }
588         /^#/d
589     ' "$GIT_DIR"/COMMIT_EDITMSG
590 else
591     cat "$GIT_DIR"/COMMIT_EDITMSG
592 fi |
593 git stripspace >"$GIT_DIR"/COMMIT_MSG
594
595 # Test whether the commit message has any content we didn't supply.
596 have_commitmsg=
597 grep -v -i '^Signed-off-by' "$GIT_DIR"/COMMIT_MSG |
598         git stripspace > "$GIT_DIR"/COMMIT_BAREMSG
599
600 # Is the commit message totally empty?
601 if test -s "$GIT_DIR"/COMMIT_BAREMSG
602 then
603         if test "$templatefile" != ""
604         then
605                 # Test whether this is just the unaltered template.
606                 if cnt=`sed -e '/^#/d' < "$templatefile" |
607                         git stripspace |
608                         diff "$GIT_DIR"/COMMIT_BAREMSG - |
609                         wc -l` &&
610                    test 0 -lt $cnt
611                 then
612                         have_commitmsg=t
613                 fi
614         else
615                 # No template, so the content in the commit message must
616                 # have come from the user.
617                 have_commitmsg=t
618         fi
619 fi
620
621 rm -f "$GIT_DIR"/COMMIT_BAREMSG
622
623 if test "$have_commitmsg" = "t"
624 then
625         if test -z "$TMP_INDEX"
626         then
627                 tree=$(GIT_INDEX_FILE="$USE_INDEX" git write-tree)
628         else
629                 tree=$(GIT_INDEX_FILE="$TMP_INDEX" git write-tree) &&
630                 rm -f "$TMP_INDEX"
631         fi &&
632         commit=$(git commit-tree $tree $PARENTS <"$GIT_DIR/COMMIT_MSG") &&
633         rlogm=$(sed -e 1q "$GIT_DIR"/COMMIT_MSG) &&
634         git update-ref -m "$GIT_REFLOG_ACTION: $rlogm" HEAD $commit "$current" &&
635         rm -f -- "$GIT_DIR/MERGE_HEAD" "$GIT_DIR/MERGE_MSG" &&
636         if test -f "$NEXT_INDEX"
637         then
638                 mv "$NEXT_INDEX" "$THIS_INDEX"
639         else
640                 : ;# happy
641         fi
642 else
643         echo >&2 "* no commit message?  aborting commit."
644         false
645 fi
646 ret="$?"
647 rm -f "$GIT_DIR/COMMIT_MSG" "$GIT_DIR/COMMIT_EDITMSG" "$GIT_DIR/SQUASH_MSG"
648
649 cd_to_toplevel
650
651 git rerere
652
653 if test "$ret" = 0
654 then
655         if test -x "$GIT_DIR"/hooks/post-commit
656         then
657                 "$GIT_DIR"/hooks/post-commit
658         fi
659         if test -z "$quiet"
660         then
661                 commit=`git diff-tree --always --shortstat --pretty="format:%h: %s"\
662                        --summary --root HEAD --`
663                 echo "Created${initial_commit:+ initial} commit $commit"
664         fi
665 fi
666
667 exit "$ret"