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