doc: describe git svn init --ignore-refs
[git/git-svn.git] / builtin / commit.c
blobda1ba4c86205ca55ae1880cb768b093b101bd85a
1 /*
2 * Builtin "git commit"
4 * Copyright (c) 2007 Kristian Høgsberg <krh@redhat.com>
5 * Based on git-commit.sh by Junio C Hamano and Linus Torvalds
6 */
8 #include "cache.h"
9 #include "lockfile.h"
10 #include "cache-tree.h"
11 #include "color.h"
12 #include "dir.h"
13 #include "builtin.h"
14 #include "diff.h"
15 #include "diffcore.h"
16 #include "commit.h"
17 #include "revision.h"
18 #include "wt-status.h"
19 #include "run-command.h"
20 #include "refs.h"
21 #include "log-tree.h"
22 #include "strbuf.h"
23 #include "utf8.h"
24 #include "parse-options.h"
25 #include "string-list.h"
26 #include "rerere.h"
27 #include "unpack-trees.h"
28 #include "quote.h"
29 #include "submodule.h"
30 #include "gpg-interface.h"
31 #include "column.h"
32 #include "sequencer.h"
33 #include "notes-utils.h"
34 #include "mailmap.h"
35 #include "sigchain.h"
37 static const char * const builtin_commit_usage[] = {
38 N_("git commit [<options>] [--] <pathspec>..."),
39 NULL
42 static const char * const builtin_status_usage[] = {
43 N_("git status [<options>] [--] <pathspec>..."),
44 NULL
47 static const char implicit_ident_advice_noconfig[] =
48 N_("Your name and email address were configured automatically based\n"
49 "on your username and hostname. Please check that they are accurate.\n"
50 "You can suppress this message by setting them explicitly. Run the\n"
51 "following command and follow the instructions in your editor to edit\n"
52 "your configuration file:\n"
53 "\n"
54 " git config --global --edit\n"
55 "\n"
56 "After doing this, you may fix the identity used for this commit with:\n"
57 "\n"
58 " git commit --amend --reset-author\n");
60 static const char implicit_ident_advice_config[] =
61 N_("Your name and email address were configured automatically based\n"
62 "on your username and hostname. Please check that they are accurate.\n"
63 "You can suppress this message by setting them explicitly:\n"
64 "\n"
65 " git config --global user.name \"Your Name\"\n"
66 " git config --global user.email you@example.com\n"
67 "\n"
68 "After doing this, you may fix the identity used for this commit with:\n"
69 "\n"
70 " git commit --amend --reset-author\n");
72 static const char empty_amend_advice[] =
73 N_("You asked to amend the most recent commit, but doing so would make\n"
74 "it empty. You can repeat your command with --allow-empty, or you can\n"
75 "remove the commit entirely with \"git reset HEAD^\".\n");
77 static const char empty_cherry_pick_advice[] =
78 N_("The previous cherry-pick is now empty, possibly due to conflict resolution.\n"
79 "If you wish to commit it anyway, use:\n"
80 "\n"
81 " git commit --allow-empty\n"
82 "\n");
84 static const char empty_cherry_pick_advice_single[] =
85 N_("Otherwise, please use 'git reset'\n");
87 static const char empty_cherry_pick_advice_multi[] =
88 N_("If you wish to skip this commit, use:\n"
89 "\n"
90 " git reset\n"
91 "\n"
92 "Then \"git cherry-pick --continue\" will resume cherry-picking\n"
93 "the remaining commits.\n");
95 static GIT_PATH_FUNC(git_path_commit_editmsg, "COMMIT_EDITMSG")
97 static const char *use_message_buffer;
98 static struct lock_file index_lock; /* real index */
99 static struct lock_file false_lock; /* used only for partial commits */
100 static enum {
101 COMMIT_AS_IS = 1,
102 COMMIT_NORMAL,
103 COMMIT_PARTIAL
104 } commit_style;
106 static const char *logfile, *force_author;
107 static const char *template_file;
109 * The _message variables are commit names from which to take
110 * the commit message and/or authorship.
112 static const char *author_message, *author_message_buffer;
113 static char *edit_message, *use_message;
114 static char *fixup_message, *squash_message;
115 static int all, also, interactive, patch_interactive, only, amend, signoff;
116 static int edit_flag = -1; /* unspecified */
117 static int quiet, verbose, no_verify, allow_empty, dry_run, renew_authorship;
118 static int config_commit_verbose = -1; /* unspecified */
119 static int no_post_rewrite, allow_empty_message;
120 static char *untracked_files_arg, *force_date, *ignore_submodule_arg;
121 static char *sign_commit;
124 * The default commit message cleanup mode will remove the lines
125 * beginning with # (shell comments) and leading and trailing
126 * whitespaces (empty lines or containing only whitespaces)
127 * if editor is used, and only the whitespaces if the message
128 * is specified explicitly.
130 static enum {
131 CLEANUP_SPACE,
132 CLEANUP_NONE,
133 CLEANUP_SCISSORS,
134 CLEANUP_ALL
135 } cleanup_mode;
136 static const char *cleanup_arg;
138 static enum commit_whence whence;
139 static int sequencer_in_use;
140 static int use_editor = 1, include_status = 1;
141 static int show_ignored_in_status, have_option_m;
142 static const char *only_include_assumed;
143 static struct strbuf message = STRBUF_INIT;
145 static enum wt_status_format status_format = STATUS_FORMAT_UNSPECIFIED;
147 static int opt_parse_porcelain(const struct option *opt, const char *arg, int unset)
149 enum wt_status_format *value = (enum wt_status_format *)opt->value;
150 if (unset)
151 *value = STATUS_FORMAT_NONE;
152 else if (!arg)
153 *value = STATUS_FORMAT_PORCELAIN;
154 else if (!strcmp(arg, "v1") || !strcmp(arg, "1"))
155 *value = STATUS_FORMAT_PORCELAIN;
156 else if (!strcmp(arg, "v2") || !strcmp(arg, "2"))
157 *value = STATUS_FORMAT_PORCELAIN_V2;
158 else
159 die("unsupported porcelain version '%s'", arg);
161 return 0;
164 static int opt_parse_m(const struct option *opt, const char *arg, int unset)
166 struct strbuf *buf = opt->value;
167 if (unset) {
168 have_option_m = 0;
169 strbuf_setlen(buf, 0);
170 } else {
171 have_option_m = 1;
172 if (buf->len)
173 strbuf_addch(buf, '\n');
174 strbuf_addstr(buf, arg);
175 strbuf_complete_line(buf);
177 return 0;
180 static void determine_whence(struct wt_status *s)
182 if (file_exists(git_path_merge_head()))
183 whence = FROM_MERGE;
184 else if (file_exists(git_path_cherry_pick_head())) {
185 whence = FROM_CHERRY_PICK;
186 if (file_exists(git_path_seq_dir()))
187 sequencer_in_use = 1;
189 else
190 whence = FROM_COMMIT;
191 if (s)
192 s->whence = whence;
195 static void status_init_config(struct wt_status *s, config_fn_t fn)
197 wt_status_prepare(s);
198 gitmodules_config();
199 git_config(fn, s);
200 determine_whence(s);
201 init_diff_ui_defaults();
202 s->hints = advice_status_hints; /* must come after git_config() */
205 static void rollback_index_files(void)
207 switch (commit_style) {
208 case COMMIT_AS_IS:
209 break; /* nothing to do */
210 case COMMIT_NORMAL:
211 rollback_lock_file(&index_lock);
212 break;
213 case COMMIT_PARTIAL:
214 rollback_lock_file(&index_lock);
215 rollback_lock_file(&false_lock);
216 break;
220 static int commit_index_files(void)
222 int err = 0;
224 switch (commit_style) {
225 case COMMIT_AS_IS:
226 break; /* nothing to do */
227 case COMMIT_NORMAL:
228 err = commit_lock_file(&index_lock);
229 break;
230 case COMMIT_PARTIAL:
231 err = commit_lock_file(&index_lock);
232 rollback_lock_file(&false_lock);
233 break;
236 return err;
240 * Take a union of paths in the index and the named tree (typically, "HEAD"),
241 * and return the paths that match the given pattern in list.
243 static int list_paths(struct string_list *list, const char *with_tree,
244 const char *prefix, const struct pathspec *pattern)
246 int i, ret;
247 char *m;
249 if (!pattern->nr)
250 return 0;
252 m = xcalloc(1, pattern->nr);
254 if (with_tree) {
255 char *max_prefix = common_prefix(pattern);
256 overlay_tree_on_cache(with_tree, max_prefix ? max_prefix : prefix);
257 free(max_prefix);
260 for (i = 0; i < active_nr; i++) {
261 const struct cache_entry *ce = active_cache[i];
262 struct string_list_item *item;
264 if (ce->ce_flags & CE_UPDATE)
265 continue;
266 if (!ce_path_match(ce, pattern, m))
267 continue;
268 item = string_list_insert(list, ce->name);
269 if (ce_skip_worktree(ce))
270 item->util = item; /* better a valid pointer than a fake one */
273 ret = report_path_error(m, pattern, prefix);
274 free(m);
275 return ret;
278 static void add_remove_files(struct string_list *list)
280 int i;
281 for (i = 0; i < list->nr; i++) {
282 struct stat st;
283 struct string_list_item *p = &(list->items[i]);
285 /* p->util is skip-worktree */
286 if (p->util)
287 continue;
289 if (!lstat(p->string, &st)) {
290 if (add_to_cache(p->string, &st, 0))
291 die(_("updating files failed"));
292 } else
293 remove_file_from_cache(p->string);
297 static void create_base_index(const struct commit *current_head)
299 struct tree *tree;
300 struct unpack_trees_options opts;
301 struct tree_desc t;
303 if (!current_head) {
304 discard_cache();
305 return;
308 memset(&opts, 0, sizeof(opts));
309 opts.head_idx = 1;
310 opts.index_only = 1;
311 opts.merge = 1;
312 opts.src_index = &the_index;
313 opts.dst_index = &the_index;
315 opts.fn = oneway_merge;
316 tree = parse_tree_indirect(&current_head->object.oid);
317 if (!tree)
318 die(_("failed to unpack HEAD tree object"));
319 parse_tree(tree);
320 init_tree_desc(&t, tree->buffer, tree->size);
321 if (unpack_trees(1, &t, &opts))
322 exit(128); /* We've already reported the error, finish dying */
325 static void refresh_cache_or_die(int refresh_flags)
328 * refresh_flags contains REFRESH_QUIET, so the only errors
329 * are for unmerged entries.
331 if (refresh_cache(refresh_flags | REFRESH_IN_PORCELAIN))
332 die_resolve_conflict("commit");
335 static const char *prepare_index(int argc, const char **argv, const char *prefix,
336 const struct commit *current_head, int is_status)
338 struct string_list partial;
339 struct pathspec pathspec;
340 int refresh_flags = REFRESH_QUIET;
341 const char *ret;
343 if (is_status)
344 refresh_flags |= REFRESH_UNMERGED;
345 parse_pathspec(&pathspec, 0,
346 PATHSPEC_PREFER_FULL,
347 prefix, argv);
349 if (read_cache_preload(&pathspec) < 0)
350 die(_("index file corrupt"));
352 if (interactive) {
353 char *old_index_env = NULL;
354 hold_locked_index(&index_lock, LOCK_DIE_ON_ERROR);
356 refresh_cache_or_die(refresh_flags);
358 if (write_locked_index(&the_index, &index_lock, CLOSE_LOCK))
359 die(_("unable to create temporary index"));
361 old_index_env = getenv(INDEX_ENVIRONMENT);
362 setenv(INDEX_ENVIRONMENT, get_lock_file_path(&index_lock), 1);
364 if (interactive_add(argc, argv, prefix, patch_interactive) != 0)
365 die(_("interactive add failed"));
367 if (old_index_env && *old_index_env)
368 setenv(INDEX_ENVIRONMENT, old_index_env, 1);
369 else
370 unsetenv(INDEX_ENVIRONMENT);
372 discard_cache();
373 read_cache_from(get_lock_file_path(&index_lock));
374 if (update_main_cache_tree(WRITE_TREE_SILENT) == 0) {
375 if (reopen_lock_file(&index_lock) < 0)
376 die(_("unable to write index file"));
377 if (write_locked_index(&the_index, &index_lock, CLOSE_LOCK))
378 die(_("unable to update temporary index"));
379 } else
380 warning(_("Failed to update main cache tree"));
382 commit_style = COMMIT_NORMAL;
383 return get_lock_file_path(&index_lock);
387 * Non partial, non as-is commit.
389 * (1) get the real index;
390 * (2) update the_index as necessary;
391 * (3) write the_index out to the real index (still locked);
392 * (4) return the name of the locked index file.
394 * The caller should run hooks on the locked real index, and
395 * (A) if all goes well, commit the real index;
396 * (B) on failure, rollback the real index.
398 if (all || (also && pathspec.nr)) {
399 hold_locked_index(&index_lock, LOCK_DIE_ON_ERROR);
400 add_files_to_cache(also ? prefix : NULL, &pathspec, 0);
401 refresh_cache_or_die(refresh_flags);
402 update_main_cache_tree(WRITE_TREE_SILENT);
403 if (write_locked_index(&the_index, &index_lock, CLOSE_LOCK))
404 die(_("unable to write new_index file"));
405 commit_style = COMMIT_NORMAL;
406 return get_lock_file_path(&index_lock);
410 * As-is commit.
412 * (1) return the name of the real index file.
414 * The caller should run hooks on the real index,
415 * and create commit from the_index.
416 * We still need to refresh the index here.
418 if (!only && !pathspec.nr) {
419 hold_locked_index(&index_lock, LOCK_DIE_ON_ERROR);
420 refresh_cache_or_die(refresh_flags);
421 if (active_cache_changed
422 || !cache_tree_fully_valid(active_cache_tree))
423 update_main_cache_tree(WRITE_TREE_SILENT);
424 if (active_cache_changed) {
425 if (write_locked_index(&the_index, &index_lock,
426 COMMIT_LOCK))
427 die(_("unable to write new_index file"));
428 } else {
429 rollback_lock_file(&index_lock);
431 commit_style = COMMIT_AS_IS;
432 return get_index_file();
436 * A partial commit.
438 * (0) find the set of affected paths;
439 * (1) get lock on the real index file;
440 * (2) update the_index with the given paths;
441 * (3) write the_index out to the real index (still locked);
442 * (4) get lock on the false index file;
443 * (5) reset the_index from HEAD;
444 * (6) update the_index the same way as (2);
445 * (7) write the_index out to the false index file;
446 * (8) return the name of the false index file (still locked);
448 * The caller should run hooks on the locked false index, and
449 * create commit from it. Then
450 * (A) if all goes well, commit the real index;
451 * (B) on failure, rollback the real index;
452 * In either case, rollback the false index.
454 commit_style = COMMIT_PARTIAL;
456 if (whence != FROM_COMMIT) {
457 if (whence == FROM_MERGE)
458 die(_("cannot do a partial commit during a merge."));
459 else if (whence == FROM_CHERRY_PICK)
460 die(_("cannot do a partial commit during a cherry-pick."));
463 string_list_init(&partial, 1);
464 if (list_paths(&partial, !current_head ? NULL : "HEAD", prefix, &pathspec))
465 exit(1);
467 discard_cache();
468 if (read_cache() < 0)
469 die(_("cannot read the index"));
471 hold_locked_index(&index_lock, LOCK_DIE_ON_ERROR);
472 add_remove_files(&partial);
473 refresh_cache(REFRESH_QUIET);
474 update_main_cache_tree(WRITE_TREE_SILENT);
475 if (write_locked_index(&the_index, &index_lock, CLOSE_LOCK))
476 die(_("unable to write new_index file"));
478 hold_lock_file_for_update(&false_lock,
479 git_path("next-index-%"PRIuMAX,
480 (uintmax_t) getpid()),
481 LOCK_DIE_ON_ERROR);
483 create_base_index(current_head);
484 add_remove_files(&partial);
485 refresh_cache(REFRESH_QUIET);
487 if (write_locked_index(&the_index, &false_lock, CLOSE_LOCK))
488 die(_("unable to write temporary index file"));
490 discard_cache();
491 ret = get_lock_file_path(&false_lock);
492 read_cache_from(ret);
493 return ret;
496 static int run_status(FILE *fp, const char *index_file, const char *prefix, int nowarn,
497 struct wt_status *s)
499 struct object_id oid;
501 if (s->relative_paths)
502 s->prefix = prefix;
504 if (amend) {
505 s->amend = 1;
506 s->reference = "HEAD^1";
508 s->verbose = verbose;
509 s->index_file = index_file;
510 s->fp = fp;
511 s->nowarn = nowarn;
512 s->is_initial = get_sha1(s->reference, oid.hash) ? 1 : 0;
513 if (!s->is_initial)
514 hashcpy(s->sha1_commit, oid.hash);
515 s->status_format = status_format;
516 s->ignore_submodule_arg = ignore_submodule_arg;
518 wt_status_collect(s);
519 wt_status_print(s);
521 return s->commitable;
524 static int is_a_merge(const struct commit *current_head)
526 return !!(current_head->parents && current_head->parents->next);
529 static void assert_split_ident(struct ident_split *id, const struct strbuf *buf)
531 if (split_ident_line(id, buf->buf, buf->len) || !id->date_begin)
532 die("BUG: unable to parse our own ident: %s", buf->buf);
535 static void export_one(const char *var, const char *s, const char *e, int hack)
537 struct strbuf buf = STRBUF_INIT;
538 if (hack)
539 strbuf_addch(&buf, hack);
540 strbuf_addf(&buf, "%.*s", (int)(e - s), s);
541 setenv(var, buf.buf, 1);
542 strbuf_release(&buf);
545 static int parse_force_date(const char *in, struct strbuf *out)
547 strbuf_addch(out, '@');
549 if (parse_date(in, out) < 0) {
550 int errors = 0;
551 unsigned long t = approxidate_careful(in, &errors);
552 if (errors)
553 return -1;
554 strbuf_addf(out, "%lu", t);
557 return 0;
560 static void set_ident_var(char **buf, char *val)
562 free(*buf);
563 *buf = val;
566 static void determine_author_info(struct strbuf *author_ident)
568 char *name, *email, *date;
569 struct ident_split author;
571 name = xstrdup_or_null(getenv("GIT_AUTHOR_NAME"));
572 email = xstrdup_or_null(getenv("GIT_AUTHOR_EMAIL"));
573 date = xstrdup_or_null(getenv("GIT_AUTHOR_DATE"));
575 if (author_message) {
576 struct ident_split ident;
577 size_t len;
578 const char *a;
580 a = find_commit_header(author_message_buffer, "author", &len);
581 if (!a)
582 die(_("commit '%s' lacks author header"), author_message);
583 if (split_ident_line(&ident, a, len) < 0)
584 die(_("commit '%s' has malformed author line"), author_message);
586 set_ident_var(&name, xmemdupz(ident.name_begin, ident.name_end - ident.name_begin));
587 set_ident_var(&email, xmemdupz(ident.mail_begin, ident.mail_end - ident.mail_begin));
589 if (ident.date_begin) {
590 struct strbuf date_buf = STRBUF_INIT;
591 strbuf_addch(&date_buf, '@');
592 strbuf_add(&date_buf, ident.date_begin, ident.date_end - ident.date_begin);
593 strbuf_addch(&date_buf, ' ');
594 strbuf_add(&date_buf, ident.tz_begin, ident.tz_end - ident.tz_begin);
595 set_ident_var(&date, strbuf_detach(&date_buf, NULL));
599 if (force_author) {
600 struct ident_split ident;
602 if (split_ident_line(&ident, force_author, strlen(force_author)) < 0)
603 die(_("malformed --author parameter"));
604 set_ident_var(&name, xmemdupz(ident.name_begin, ident.name_end - ident.name_begin));
605 set_ident_var(&email, xmemdupz(ident.mail_begin, ident.mail_end - ident.mail_begin));
608 if (force_date) {
609 struct strbuf date_buf = STRBUF_INIT;
610 if (parse_force_date(force_date, &date_buf))
611 die(_("invalid date format: %s"), force_date);
612 set_ident_var(&date, strbuf_detach(&date_buf, NULL));
615 strbuf_addstr(author_ident, fmt_ident(name, email, date, IDENT_STRICT));
616 assert_split_ident(&author, author_ident);
617 export_one("GIT_AUTHOR_NAME", author.name_begin, author.name_end, 0);
618 export_one("GIT_AUTHOR_EMAIL", author.mail_begin, author.mail_end, 0);
619 export_one("GIT_AUTHOR_DATE", author.date_begin, author.tz_end, '@');
620 free(name);
621 free(email);
622 free(date);
625 static int author_date_is_interesting(void)
627 return author_message || force_date;
630 static void adjust_comment_line_char(const struct strbuf *sb)
632 char candidates[] = "#;@!$%^&|:";
633 char *candidate;
634 const char *p;
636 comment_line_char = candidates[0];
637 if (!memchr(sb->buf, comment_line_char, sb->len))
638 return;
640 p = sb->buf;
641 candidate = strchr(candidates, *p);
642 if (candidate)
643 *candidate = ' ';
644 for (p = sb->buf; *p; p++) {
645 if ((p[0] == '\n' || p[0] == '\r') && p[1]) {
646 candidate = strchr(candidates, p[1]);
647 if (candidate)
648 *candidate = ' ';
652 for (p = candidates; *p == ' '; p++)
654 if (!*p)
655 die(_("unable to select a comment character that is not used\n"
656 "in the current commit message"));
657 comment_line_char = *p;
660 static int prepare_to_commit(const char *index_file, const char *prefix,
661 struct commit *current_head,
662 struct wt_status *s,
663 struct strbuf *author_ident)
665 struct stat statbuf;
666 struct strbuf committer_ident = STRBUF_INIT;
667 int commitable;
668 struct strbuf sb = STRBUF_INIT;
669 const char *hook_arg1 = NULL;
670 const char *hook_arg2 = NULL;
671 int clean_message_contents = (cleanup_mode != CLEANUP_NONE);
672 int old_display_comment_prefix;
674 /* This checks and barfs if author is badly specified */
675 determine_author_info(author_ident);
677 if (!no_verify && run_commit_hook(use_editor, index_file, "pre-commit", NULL))
678 return 0;
680 if (squash_message) {
682 * Insert the proper subject line before other commit
683 * message options add their content.
685 if (use_message && !strcmp(use_message, squash_message))
686 strbuf_addstr(&sb, "squash! ");
687 else {
688 struct pretty_print_context ctx = {0};
689 struct commit *c;
690 c = lookup_commit_reference_by_name(squash_message);
691 if (!c)
692 die(_("could not lookup commit %s"), squash_message);
693 ctx.output_encoding = get_commit_output_encoding();
694 format_commit_message(c, "squash! %s\n\n", &sb,
695 &ctx);
699 if (have_option_m) {
700 strbuf_addbuf(&sb, &message);
701 hook_arg1 = "message";
702 } else if (logfile && !strcmp(logfile, "-")) {
703 if (isatty(0))
704 fprintf(stderr, _("(reading log message from standard input)\n"));
705 if (strbuf_read(&sb, 0, 0) < 0)
706 die_errno(_("could not read log from standard input"));
707 hook_arg1 = "message";
708 } else if (logfile) {
709 if (strbuf_read_file(&sb, logfile, 0) < 0)
710 die_errno(_("could not read log file '%s'"),
711 logfile);
712 hook_arg1 = "message";
713 } else if (use_message) {
714 char *buffer;
715 buffer = strstr(use_message_buffer, "\n\n");
716 if (buffer)
717 strbuf_addstr(&sb, skip_blank_lines(buffer + 2));
718 hook_arg1 = "commit";
719 hook_arg2 = use_message;
720 } else if (fixup_message) {
721 struct pretty_print_context ctx = {0};
722 struct commit *commit;
723 commit = lookup_commit_reference_by_name(fixup_message);
724 if (!commit)
725 die(_("could not lookup commit %s"), fixup_message);
726 ctx.output_encoding = get_commit_output_encoding();
727 format_commit_message(commit, "fixup! %s\n\n",
728 &sb, &ctx);
729 hook_arg1 = "message";
730 } else if (!stat(git_path_merge_msg(), &statbuf)) {
732 * prepend SQUASH_MSG here if it exists and a
733 * "merge --squash" was originally performed
735 if (!stat(git_path_squash_msg(), &statbuf)) {
736 if (strbuf_read_file(&sb, git_path_squash_msg(), 0) < 0)
737 die_errno(_("could not read SQUASH_MSG"));
738 hook_arg1 = "squash";
739 } else
740 hook_arg1 = "merge";
741 if (strbuf_read_file(&sb, git_path_merge_msg(), 0) < 0)
742 die_errno(_("could not read MERGE_MSG"));
743 } else if (!stat(git_path_squash_msg(), &statbuf)) {
744 if (strbuf_read_file(&sb, git_path_squash_msg(), 0) < 0)
745 die_errno(_("could not read SQUASH_MSG"));
746 hook_arg1 = "squash";
747 } else if (template_file) {
748 if (strbuf_read_file(&sb, template_file, 0) < 0)
749 die_errno(_("could not read '%s'"), template_file);
750 hook_arg1 = "template";
751 clean_message_contents = 0;
755 * The remaining cases don't modify the template message, but
756 * just set the argument(s) to the prepare-commit-msg hook.
758 else if (whence == FROM_MERGE)
759 hook_arg1 = "merge";
760 else if (whence == FROM_CHERRY_PICK) {
761 hook_arg1 = "commit";
762 hook_arg2 = "CHERRY_PICK_HEAD";
765 if (squash_message) {
767 * If squash_commit was used for the commit subject,
768 * then we're possibly hijacking other commit log options.
769 * Reset the hook args to tell the real story.
771 hook_arg1 = "message";
772 hook_arg2 = "";
775 s->fp = fopen_for_writing(git_path_commit_editmsg());
776 if (s->fp == NULL)
777 die_errno(_("could not open '%s'"), git_path_commit_editmsg());
779 /* Ignore status.displayCommentPrefix: we do need comments in COMMIT_EDITMSG. */
780 old_display_comment_prefix = s->display_comment_prefix;
781 s->display_comment_prefix = 1;
784 * Most hints are counter-productive when the commit has
785 * already started.
787 s->hints = 0;
789 if (clean_message_contents)
790 strbuf_stripspace(&sb, 0);
792 if (signoff)
793 append_signoff(&sb, ignore_non_trailer(sb.buf, sb.len), 0);
795 if (fwrite(sb.buf, 1, sb.len, s->fp) < sb.len)
796 die_errno(_("could not write commit template"));
798 if (auto_comment_line_char)
799 adjust_comment_line_char(&sb);
800 strbuf_release(&sb);
802 /* This checks if committer ident is explicitly given */
803 strbuf_addstr(&committer_ident, git_committer_info(IDENT_STRICT));
804 if (use_editor && include_status) {
805 int ident_shown = 0;
806 int saved_color_setting;
807 struct ident_split ci, ai;
809 if (whence != FROM_COMMIT) {
810 if (cleanup_mode == CLEANUP_SCISSORS)
811 wt_status_add_cut_line(s->fp);
812 status_printf_ln(s, GIT_COLOR_NORMAL,
813 whence == FROM_MERGE
814 ? _("\n"
815 "It looks like you may be committing a merge.\n"
816 "If this is not correct, please remove the file\n"
817 " %s\n"
818 "and try again.\n")
819 : _("\n"
820 "It looks like you may be committing a cherry-pick.\n"
821 "If this is not correct, please remove the file\n"
822 " %s\n"
823 "and try again.\n"),
824 whence == FROM_MERGE ?
825 git_path_merge_head() :
826 git_path_cherry_pick_head());
829 fprintf(s->fp, "\n");
830 if (cleanup_mode == CLEANUP_ALL)
831 status_printf(s, GIT_COLOR_NORMAL,
832 _("Please enter the commit message for your changes."
833 " Lines starting\nwith '%c' will be ignored, and an empty"
834 " message aborts the commit.\n"), comment_line_char);
835 else if (cleanup_mode == CLEANUP_SCISSORS && whence == FROM_COMMIT)
836 wt_status_add_cut_line(s->fp);
837 else /* CLEANUP_SPACE, that is. */
838 status_printf(s, GIT_COLOR_NORMAL,
839 _("Please enter the commit message for your changes."
840 " Lines starting\n"
841 "with '%c' will be kept; you may remove them"
842 " yourself if you want to.\n"
843 "An empty message aborts the commit.\n"), comment_line_char);
844 if (only_include_assumed)
845 status_printf_ln(s, GIT_COLOR_NORMAL,
846 "%s", only_include_assumed);
849 * These should never fail because they come from our own
850 * fmt_ident. They may fail the sane_ident test, but we know
851 * that the name and mail pointers will at least be valid,
852 * which is enough for our tests and printing here.
854 assert_split_ident(&ai, author_ident);
855 assert_split_ident(&ci, &committer_ident);
857 if (ident_cmp(&ai, &ci))
858 status_printf_ln(s, GIT_COLOR_NORMAL,
859 _("%s"
860 "Author: %.*s <%.*s>"),
861 ident_shown++ ? "" : "\n",
862 (int)(ai.name_end - ai.name_begin), ai.name_begin,
863 (int)(ai.mail_end - ai.mail_begin), ai.mail_begin);
865 if (author_date_is_interesting())
866 status_printf_ln(s, GIT_COLOR_NORMAL,
867 _("%s"
868 "Date: %s"),
869 ident_shown++ ? "" : "\n",
870 show_ident_date(&ai, DATE_MODE(NORMAL)));
872 if (!committer_ident_sufficiently_given())
873 status_printf_ln(s, GIT_COLOR_NORMAL,
874 _("%s"
875 "Committer: %.*s <%.*s>"),
876 ident_shown++ ? "" : "\n",
877 (int)(ci.name_end - ci.name_begin), ci.name_begin,
878 (int)(ci.mail_end - ci.mail_begin), ci.mail_begin);
880 if (ident_shown)
881 status_printf_ln(s, GIT_COLOR_NORMAL, "%s", "");
883 saved_color_setting = s->use_color;
884 s->use_color = 0;
885 commitable = run_status(s->fp, index_file, prefix, 1, s);
886 s->use_color = saved_color_setting;
887 } else {
888 struct object_id oid;
889 const char *parent = "HEAD";
891 if (!active_nr && read_cache() < 0)
892 die(_("Cannot read index"));
894 if (amend)
895 parent = "HEAD^1";
897 if (get_sha1(parent, oid.hash)) {
898 int i, ita_nr = 0;
900 for (i = 0; i < active_nr; i++)
901 if (ce_intent_to_add(active_cache[i]))
902 ita_nr++;
903 commitable = active_nr - ita_nr > 0;
904 } else {
906 * Unless the user did explicitly request a submodule
907 * ignore mode by passing a command line option we do
908 * not ignore any changed submodule SHA-1s when
909 * comparing index and parent, no matter what is
910 * configured. Otherwise we won't commit any
911 * submodules which were manually staged, which would
912 * be really confusing.
914 int diff_flags = DIFF_OPT_OVERRIDE_SUBMODULE_CONFIG;
915 if (ignore_submodule_arg &&
916 !strcmp(ignore_submodule_arg, "all"))
917 diff_flags |= DIFF_OPT_IGNORE_SUBMODULES;
918 commitable = index_differs_from(parent, diff_flags, 1);
921 strbuf_release(&committer_ident);
923 fclose(s->fp);
926 * Reject an attempt to record a non-merge empty commit without
927 * explicit --allow-empty. In the cherry-pick case, it may be
928 * empty due to conflict resolution, which the user should okay.
930 if (!commitable && whence != FROM_MERGE && !allow_empty &&
931 !(amend && is_a_merge(current_head))) {
932 s->display_comment_prefix = old_display_comment_prefix;
933 run_status(stdout, index_file, prefix, 0, s);
934 if (amend)
935 fputs(_(empty_amend_advice), stderr);
936 else if (whence == FROM_CHERRY_PICK) {
937 fputs(_(empty_cherry_pick_advice), stderr);
938 if (!sequencer_in_use)
939 fputs(_(empty_cherry_pick_advice_single), stderr);
940 else
941 fputs(_(empty_cherry_pick_advice_multi), stderr);
943 return 0;
947 * Re-read the index as pre-commit hook could have updated it,
948 * and write it out as a tree. We must do this before we invoke
949 * the editor and after we invoke run_status above.
951 discard_cache();
952 read_cache_from(index_file);
953 if (update_main_cache_tree(0)) {
954 error(_("Error building trees"));
955 return 0;
958 if (run_commit_hook(use_editor, index_file, "prepare-commit-msg",
959 git_path_commit_editmsg(), hook_arg1, hook_arg2, NULL))
960 return 0;
962 if (use_editor) {
963 struct argv_array env = ARGV_ARRAY_INIT;
965 argv_array_pushf(&env, "GIT_INDEX_FILE=%s", index_file);
966 if (launch_editor(git_path_commit_editmsg(), NULL, env.argv)) {
967 fprintf(stderr,
968 _("Please supply the message using either -m or -F option.\n"));
969 exit(1);
971 argv_array_clear(&env);
974 if (!no_verify &&
975 run_commit_hook(use_editor, index_file, "commit-msg", git_path_commit_editmsg(), NULL)) {
976 return 0;
979 return 1;
982 static int rest_is_empty(struct strbuf *sb, int start)
984 int i, eol;
985 const char *nl;
987 /* Check if the rest is just whitespace and Signed-of-by's. */
988 for (i = start; i < sb->len; i++) {
989 nl = memchr(sb->buf + i, '\n', sb->len - i);
990 if (nl)
991 eol = nl - sb->buf;
992 else
993 eol = sb->len;
995 if (strlen(sign_off_header) <= eol - i &&
996 starts_with(sb->buf + i, sign_off_header)) {
997 i = eol;
998 continue;
1000 while (i < eol)
1001 if (!isspace(sb->buf[i++]))
1002 return 0;
1005 return 1;
1009 * Find out if the message in the strbuf contains only whitespace and
1010 * Signed-off-by lines.
1012 static int message_is_empty(struct strbuf *sb)
1014 if (cleanup_mode == CLEANUP_NONE && sb->len)
1015 return 0;
1016 return rest_is_empty(sb, 0);
1020 * See if the user edited the message in the editor or left what
1021 * was in the template intact
1023 static int template_untouched(struct strbuf *sb)
1025 struct strbuf tmpl = STRBUF_INIT;
1026 const char *start;
1028 if (cleanup_mode == CLEANUP_NONE && sb->len)
1029 return 0;
1031 if (!template_file || strbuf_read_file(&tmpl, template_file, 0) <= 0)
1032 return 0;
1034 strbuf_stripspace(&tmpl, cleanup_mode == CLEANUP_ALL);
1035 if (!skip_prefix(sb->buf, tmpl.buf, &start))
1036 start = sb->buf;
1037 strbuf_release(&tmpl);
1038 return rest_is_empty(sb, start - sb->buf);
1041 static const char *find_author_by_nickname(const char *name)
1043 struct rev_info revs;
1044 struct commit *commit;
1045 struct strbuf buf = STRBUF_INIT;
1046 struct string_list mailmap = STRING_LIST_INIT_NODUP;
1047 const char *av[20];
1048 int ac = 0;
1050 init_revisions(&revs, NULL);
1051 strbuf_addf(&buf, "--author=%s", name);
1052 av[++ac] = "--all";
1053 av[++ac] = "-i";
1054 av[++ac] = buf.buf;
1055 av[++ac] = NULL;
1056 setup_revisions(ac, av, &revs, NULL);
1057 revs.mailmap = &mailmap;
1058 read_mailmap(revs.mailmap, NULL);
1060 if (prepare_revision_walk(&revs))
1061 die(_("revision walk setup failed"));
1062 commit = get_revision(&revs);
1063 if (commit) {
1064 struct pretty_print_context ctx = {0};
1065 ctx.date_mode.type = DATE_NORMAL;
1066 strbuf_release(&buf);
1067 format_commit_message(commit, "%aN <%aE>", &buf, &ctx);
1068 clear_mailmap(&mailmap);
1069 return strbuf_detach(&buf, NULL);
1071 die(_("--author '%s' is not 'Name <email>' and matches no existing author"), name);
1075 static void handle_untracked_files_arg(struct wt_status *s)
1077 if (!untracked_files_arg)
1078 ; /* default already initialized */
1079 else if (!strcmp(untracked_files_arg, "no"))
1080 s->show_untracked_files = SHOW_NO_UNTRACKED_FILES;
1081 else if (!strcmp(untracked_files_arg, "normal"))
1082 s->show_untracked_files = SHOW_NORMAL_UNTRACKED_FILES;
1083 else if (!strcmp(untracked_files_arg, "all"))
1084 s->show_untracked_files = SHOW_ALL_UNTRACKED_FILES;
1085 else
1086 die(_("Invalid untracked files mode '%s'"), untracked_files_arg);
1089 static const char *read_commit_message(const char *name)
1091 const char *out_enc;
1092 struct commit *commit;
1094 commit = lookup_commit_reference_by_name(name);
1095 if (!commit)
1096 die(_("could not lookup commit %s"), name);
1097 out_enc = get_commit_output_encoding();
1098 return logmsg_reencode(commit, NULL, out_enc);
1102 * Enumerate what needs to be propagated when --porcelain
1103 * is not in effect here.
1105 static struct status_deferred_config {
1106 enum wt_status_format status_format;
1107 int show_branch;
1108 } status_deferred_config = {
1109 STATUS_FORMAT_UNSPECIFIED,
1110 -1 /* unspecified */
1113 static void finalize_deferred_config(struct wt_status *s)
1115 int use_deferred_config = (status_format != STATUS_FORMAT_PORCELAIN &&
1116 status_format != STATUS_FORMAT_PORCELAIN_V2 &&
1117 !s->null_termination);
1119 if (s->null_termination) {
1120 if (status_format == STATUS_FORMAT_NONE ||
1121 status_format == STATUS_FORMAT_UNSPECIFIED)
1122 status_format = STATUS_FORMAT_PORCELAIN;
1123 else if (status_format == STATUS_FORMAT_LONG)
1124 die(_("--long and -z are incompatible"));
1127 if (use_deferred_config && status_format == STATUS_FORMAT_UNSPECIFIED)
1128 status_format = status_deferred_config.status_format;
1129 if (status_format == STATUS_FORMAT_UNSPECIFIED)
1130 status_format = STATUS_FORMAT_NONE;
1132 if (use_deferred_config && s->show_branch < 0)
1133 s->show_branch = status_deferred_config.show_branch;
1134 if (s->show_branch < 0)
1135 s->show_branch = 0;
1138 static int parse_and_validate_options(int argc, const char *argv[],
1139 const struct option *options,
1140 const char * const usage[],
1141 const char *prefix,
1142 struct commit *current_head,
1143 struct wt_status *s)
1145 int f = 0;
1147 argc = parse_options(argc, argv, prefix, options, usage, 0);
1148 finalize_deferred_config(s);
1150 if (force_author && !strchr(force_author, '>'))
1151 force_author = find_author_by_nickname(force_author);
1153 if (force_author && renew_authorship)
1154 die(_("Using both --reset-author and --author does not make sense"));
1156 if (logfile || have_option_m || use_message || fixup_message)
1157 use_editor = 0;
1158 if (0 <= edit_flag)
1159 use_editor = edit_flag;
1161 /* Sanity check options */
1162 if (amend && !current_head)
1163 die(_("You have nothing to amend."));
1164 if (amend && whence != FROM_COMMIT) {
1165 if (whence == FROM_MERGE)
1166 die(_("You are in the middle of a merge -- cannot amend."));
1167 else if (whence == FROM_CHERRY_PICK)
1168 die(_("You are in the middle of a cherry-pick -- cannot amend."));
1170 if (fixup_message && squash_message)
1171 die(_("Options --squash and --fixup cannot be used together"));
1172 if (use_message)
1173 f++;
1174 if (edit_message)
1175 f++;
1176 if (fixup_message)
1177 f++;
1178 if (logfile)
1179 f++;
1180 if (f > 1)
1181 die(_("Only one of -c/-C/-F/--fixup can be used."));
1182 if (have_option_m && f > 0)
1183 die((_("Option -m cannot be combined with -c/-C/-F/--fixup.")));
1184 if (f || have_option_m)
1185 template_file = NULL;
1186 if (edit_message)
1187 use_message = edit_message;
1188 if (amend && !use_message && !fixup_message)
1189 use_message = "HEAD";
1190 if (!use_message && whence != FROM_CHERRY_PICK && renew_authorship)
1191 die(_("--reset-author can be used only with -C, -c or --amend."));
1192 if (use_message) {
1193 use_message_buffer = read_commit_message(use_message);
1194 if (!renew_authorship) {
1195 author_message = use_message;
1196 author_message_buffer = use_message_buffer;
1199 if (whence == FROM_CHERRY_PICK && !renew_authorship) {
1200 author_message = "CHERRY_PICK_HEAD";
1201 author_message_buffer = read_commit_message(author_message);
1204 if (patch_interactive)
1205 interactive = 1;
1207 if (also + only + all + interactive > 1)
1208 die(_("Only one of --include/--only/--all/--interactive/--patch can be used."));
1209 if (argc == 0 && (also || (only && !amend && !allow_empty)))
1210 die(_("No paths with --include/--only does not make sense."));
1211 if (argc > 0 && !also && !only)
1212 only_include_assumed = _("Explicit paths specified without -i or -o; assuming --only paths...");
1213 if (!cleanup_arg || !strcmp(cleanup_arg, "default"))
1214 cleanup_mode = use_editor ? CLEANUP_ALL : CLEANUP_SPACE;
1215 else if (!strcmp(cleanup_arg, "verbatim"))
1216 cleanup_mode = CLEANUP_NONE;
1217 else if (!strcmp(cleanup_arg, "whitespace"))
1218 cleanup_mode = CLEANUP_SPACE;
1219 else if (!strcmp(cleanup_arg, "strip"))
1220 cleanup_mode = CLEANUP_ALL;
1221 else if (!strcmp(cleanup_arg, "scissors"))
1222 cleanup_mode = use_editor ? CLEANUP_SCISSORS : CLEANUP_SPACE;
1223 else
1224 die(_("Invalid cleanup mode %s"), cleanup_arg);
1226 handle_untracked_files_arg(s);
1228 if (all && argc > 0)
1229 die(_("Paths with -a does not make sense."));
1231 if (status_format != STATUS_FORMAT_NONE)
1232 dry_run = 1;
1234 return argc;
1237 static int dry_run_commit(int argc, const char **argv, const char *prefix,
1238 const struct commit *current_head, struct wt_status *s)
1240 int commitable;
1241 const char *index_file;
1243 index_file = prepare_index(argc, argv, prefix, current_head, 1);
1244 commitable = run_status(stdout, index_file, prefix, 0, s);
1245 rollback_index_files();
1247 return commitable ? 0 : 1;
1250 static int parse_status_slot(const char *slot)
1252 if (!strcasecmp(slot, "header"))
1253 return WT_STATUS_HEADER;
1254 if (!strcasecmp(slot, "branch"))
1255 return WT_STATUS_ONBRANCH;
1256 if (!strcasecmp(slot, "updated") || !strcasecmp(slot, "added"))
1257 return WT_STATUS_UPDATED;
1258 if (!strcasecmp(slot, "changed"))
1259 return WT_STATUS_CHANGED;
1260 if (!strcasecmp(slot, "untracked"))
1261 return WT_STATUS_UNTRACKED;
1262 if (!strcasecmp(slot, "nobranch"))
1263 return WT_STATUS_NOBRANCH;
1264 if (!strcasecmp(slot, "unmerged"))
1265 return WT_STATUS_UNMERGED;
1266 if (!strcasecmp(slot, "localBranch"))
1267 return WT_STATUS_LOCAL_BRANCH;
1268 if (!strcasecmp(slot, "remoteBranch"))
1269 return WT_STATUS_REMOTE_BRANCH;
1270 return -1;
1273 static int git_status_config(const char *k, const char *v, void *cb)
1275 struct wt_status *s = cb;
1276 const char *slot_name;
1278 if (starts_with(k, "column."))
1279 return git_column_config(k, v, "status", &s->colopts);
1280 if (!strcmp(k, "status.submodulesummary")) {
1281 int is_bool;
1282 s->submodule_summary = git_config_bool_or_int(k, v, &is_bool);
1283 if (is_bool && s->submodule_summary)
1284 s->submodule_summary = -1;
1285 return 0;
1287 if (!strcmp(k, "status.short")) {
1288 if (git_config_bool(k, v))
1289 status_deferred_config.status_format = STATUS_FORMAT_SHORT;
1290 else
1291 status_deferred_config.status_format = STATUS_FORMAT_NONE;
1292 return 0;
1294 if (!strcmp(k, "status.branch")) {
1295 status_deferred_config.show_branch = git_config_bool(k, v);
1296 return 0;
1298 if (!strcmp(k, "status.color") || !strcmp(k, "color.status")) {
1299 s->use_color = git_config_colorbool(k, v);
1300 return 0;
1302 if (!strcmp(k, "status.displaycommentprefix")) {
1303 s->display_comment_prefix = git_config_bool(k, v);
1304 return 0;
1306 if (skip_prefix(k, "status.color.", &slot_name) ||
1307 skip_prefix(k, "color.status.", &slot_name)) {
1308 int slot = parse_status_slot(slot_name);
1309 if (slot < 0)
1310 return 0;
1311 if (!v)
1312 return config_error_nonbool(k);
1313 return color_parse(v, s->color_palette[slot]);
1315 if (!strcmp(k, "status.relativepaths")) {
1316 s->relative_paths = git_config_bool(k, v);
1317 return 0;
1319 if (!strcmp(k, "status.showuntrackedfiles")) {
1320 if (!v)
1321 return config_error_nonbool(k);
1322 else if (!strcmp(v, "no"))
1323 s->show_untracked_files = SHOW_NO_UNTRACKED_FILES;
1324 else if (!strcmp(v, "normal"))
1325 s->show_untracked_files = SHOW_NORMAL_UNTRACKED_FILES;
1326 else if (!strcmp(v, "all"))
1327 s->show_untracked_files = SHOW_ALL_UNTRACKED_FILES;
1328 else
1329 return error(_("Invalid untracked files mode '%s'"), v);
1330 return 0;
1332 return git_diff_ui_config(k, v, NULL);
1335 int cmd_status(int argc, const char **argv, const char *prefix)
1337 static struct wt_status s;
1338 int fd;
1339 struct object_id oid;
1340 static struct option builtin_status_options[] = {
1341 OPT__VERBOSE(&verbose, N_("be verbose")),
1342 OPT_SET_INT('s', "short", &status_format,
1343 N_("show status concisely"), STATUS_FORMAT_SHORT),
1344 OPT_BOOL('b', "branch", &s.show_branch,
1345 N_("show branch information")),
1346 { OPTION_CALLBACK, 0, "porcelain", &status_format,
1347 N_("version"), N_("machine-readable output"),
1348 PARSE_OPT_OPTARG, opt_parse_porcelain },
1349 OPT_SET_INT(0, "long", &status_format,
1350 N_("show status in long format (default)"),
1351 STATUS_FORMAT_LONG),
1352 OPT_BOOL('z', "null", &s.null_termination,
1353 N_("terminate entries with NUL")),
1354 { OPTION_STRING, 'u', "untracked-files", &untracked_files_arg,
1355 N_("mode"),
1356 N_("show untracked files, optional modes: all, normal, no. (Default: all)"),
1357 PARSE_OPT_OPTARG, NULL, (intptr_t)"all" },
1358 OPT_BOOL(0, "ignored", &show_ignored_in_status,
1359 N_("show ignored files")),
1360 { OPTION_STRING, 0, "ignore-submodules", &ignore_submodule_arg, N_("when"),
1361 N_("ignore changes to submodules, optional when: all, dirty, untracked. (Default: all)"),
1362 PARSE_OPT_OPTARG, NULL, (intptr_t)"all" },
1363 OPT_COLUMN(0, "column", &s.colopts, N_("list untracked files in columns")),
1364 OPT_END(),
1367 if (argc == 2 && !strcmp(argv[1], "-h"))
1368 usage_with_options(builtin_status_usage, builtin_status_options);
1370 status_init_config(&s, git_status_config);
1371 argc = parse_options(argc, argv, prefix,
1372 builtin_status_options,
1373 builtin_status_usage, 0);
1374 finalize_colopts(&s.colopts, -1);
1375 finalize_deferred_config(&s);
1377 handle_untracked_files_arg(&s);
1378 if (show_ignored_in_status)
1379 s.show_ignored_files = 1;
1380 parse_pathspec(&s.pathspec, 0,
1381 PATHSPEC_PREFER_FULL,
1382 prefix, argv);
1384 read_cache_preload(&s.pathspec);
1385 refresh_index(&the_index, REFRESH_QUIET|REFRESH_UNMERGED, &s.pathspec, NULL, NULL);
1387 fd = hold_locked_index(&index_lock, 0);
1389 s.is_initial = get_sha1(s.reference, oid.hash) ? 1 : 0;
1390 if (!s.is_initial)
1391 hashcpy(s.sha1_commit, oid.hash);
1393 s.ignore_submodule_arg = ignore_submodule_arg;
1394 s.status_format = status_format;
1395 s.verbose = verbose;
1397 wt_status_collect(&s);
1399 if (0 <= fd)
1400 update_index_if_able(&the_index, &index_lock);
1402 if (s.relative_paths)
1403 s.prefix = prefix;
1405 wt_status_print(&s);
1406 return 0;
1409 static const char *implicit_ident_advice(void)
1411 char *user_config = expand_user_path("~/.gitconfig", 0);
1412 char *xdg_config = xdg_config_home("config");
1413 int config_exists = file_exists(user_config) || file_exists(xdg_config);
1415 free(user_config);
1416 free(xdg_config);
1418 if (config_exists)
1419 return _(implicit_ident_advice_config);
1420 else
1421 return _(implicit_ident_advice_noconfig);
1425 static void print_summary(const char *prefix, const struct object_id *oid,
1426 int initial_commit)
1428 struct rev_info rev;
1429 struct commit *commit;
1430 struct strbuf format = STRBUF_INIT;
1431 struct object_id junk_oid;
1432 const char *head;
1433 struct pretty_print_context pctx = {0};
1434 struct strbuf author_ident = STRBUF_INIT;
1435 struct strbuf committer_ident = STRBUF_INIT;
1437 commit = lookup_commit(oid);
1438 if (!commit)
1439 die(_("couldn't look up newly created commit"));
1440 if (parse_commit(commit))
1441 die(_("could not parse newly created commit"));
1443 strbuf_addstr(&format, "format:%h] %s");
1445 format_commit_message(commit, "%an <%ae>", &author_ident, &pctx);
1446 format_commit_message(commit, "%cn <%ce>", &committer_ident, &pctx);
1447 if (strbuf_cmp(&author_ident, &committer_ident)) {
1448 strbuf_addstr(&format, "\n Author: ");
1449 strbuf_addbuf_percentquote(&format, &author_ident);
1451 if (author_date_is_interesting()) {
1452 struct strbuf date = STRBUF_INIT;
1453 format_commit_message(commit, "%ad", &date, &pctx);
1454 strbuf_addstr(&format, "\n Date: ");
1455 strbuf_addbuf_percentquote(&format, &date);
1456 strbuf_release(&date);
1458 if (!committer_ident_sufficiently_given()) {
1459 strbuf_addstr(&format, "\n Committer: ");
1460 strbuf_addbuf_percentquote(&format, &committer_ident);
1461 if (advice_implicit_identity) {
1462 strbuf_addch(&format, '\n');
1463 strbuf_addstr(&format, implicit_ident_advice());
1466 strbuf_release(&author_ident);
1467 strbuf_release(&committer_ident);
1469 init_revisions(&rev, prefix);
1470 setup_revisions(0, NULL, &rev, NULL);
1472 rev.diff = 1;
1473 rev.diffopt.output_format =
1474 DIFF_FORMAT_SHORTSTAT | DIFF_FORMAT_SUMMARY;
1476 rev.verbose_header = 1;
1477 rev.show_root_diff = 1;
1478 get_commit_format(format.buf, &rev);
1479 rev.always_show_header = 0;
1480 rev.diffopt.detect_rename = 1;
1481 rev.diffopt.break_opt = 0;
1482 diff_setup_done(&rev.diffopt);
1484 head = resolve_ref_unsafe("HEAD", 0, junk_oid.hash, NULL);
1485 if (!strcmp(head, "HEAD"))
1486 head = _("detached HEAD");
1487 else
1488 skip_prefix(head, "refs/heads/", &head);
1489 printf("[%s%s ", head, initial_commit ? _(" (root-commit)") : "");
1491 if (!log_tree_commit(&rev, commit)) {
1492 rev.always_show_header = 1;
1493 rev.use_terminator = 1;
1494 log_tree_commit(&rev, commit);
1497 strbuf_release(&format);
1500 static int git_commit_config(const char *k, const char *v, void *cb)
1502 struct wt_status *s = cb;
1503 int status;
1505 if (!strcmp(k, "commit.template"))
1506 return git_config_pathname(&template_file, k, v);
1507 if (!strcmp(k, "commit.status")) {
1508 include_status = git_config_bool(k, v);
1509 return 0;
1511 if (!strcmp(k, "commit.cleanup"))
1512 return git_config_string(&cleanup_arg, k, v);
1513 if (!strcmp(k, "commit.gpgsign")) {
1514 sign_commit = git_config_bool(k, v) ? "" : NULL;
1515 return 0;
1517 if (!strcmp(k, "commit.verbose")) {
1518 int is_bool;
1519 config_commit_verbose = git_config_bool_or_int(k, v, &is_bool);
1520 return 0;
1523 status = git_gpg_config(k, v, NULL);
1524 if (status)
1525 return status;
1526 return git_status_config(k, v, s);
1529 static int run_rewrite_hook(const struct object_id *oldoid,
1530 const struct object_id *newoid)
1532 struct child_process proc = CHILD_PROCESS_INIT;
1533 const char *argv[3];
1534 int code;
1535 struct strbuf sb = STRBUF_INIT;
1537 argv[0] = find_hook("post-rewrite");
1538 if (!argv[0])
1539 return 0;
1541 argv[1] = "amend";
1542 argv[2] = NULL;
1544 proc.argv = argv;
1545 proc.in = -1;
1546 proc.stdout_to_stderr = 1;
1548 code = start_command(&proc);
1549 if (code)
1550 return code;
1551 strbuf_addf(&sb, "%s %s\n", oid_to_hex(oldoid), oid_to_hex(newoid));
1552 sigchain_push(SIGPIPE, SIG_IGN);
1553 write_in_full(proc.in, sb.buf, sb.len);
1554 close(proc.in);
1555 strbuf_release(&sb);
1556 sigchain_pop(SIGPIPE);
1557 return finish_command(&proc);
1560 int run_commit_hook(int editor_is_used, const char *index_file, const char *name, ...)
1562 struct argv_array hook_env = ARGV_ARRAY_INIT;
1563 va_list args;
1564 int ret;
1566 argv_array_pushf(&hook_env, "GIT_INDEX_FILE=%s", index_file);
1569 * Let the hook know that no editor will be launched.
1571 if (!editor_is_used)
1572 argv_array_push(&hook_env, "GIT_EDITOR=:");
1574 va_start(args, name);
1575 ret = run_hook_ve(hook_env.argv,name, args);
1576 va_end(args);
1577 argv_array_clear(&hook_env);
1579 return ret;
1582 int cmd_commit(int argc, const char **argv, const char *prefix)
1584 static struct wt_status s;
1585 static struct option builtin_commit_options[] = {
1586 OPT__QUIET(&quiet, N_("suppress summary after successful commit")),
1587 OPT__VERBOSE(&verbose, N_("show diff in commit message template")),
1589 OPT_GROUP(N_("Commit message options")),
1590 OPT_FILENAME('F', "file", &logfile, N_("read message from file")),
1591 OPT_STRING(0, "author", &force_author, N_("author"), N_("override author for commit")),
1592 OPT_STRING(0, "date", &force_date, N_("date"), N_("override date for commit")),
1593 OPT_CALLBACK('m', "message", &message, N_("message"), N_("commit message"), opt_parse_m),
1594 OPT_STRING('c', "reedit-message", &edit_message, N_("commit"), N_("reuse and edit message from specified commit")),
1595 OPT_STRING('C', "reuse-message", &use_message, N_("commit"), N_("reuse message from specified commit")),
1596 OPT_STRING(0, "fixup", &fixup_message, N_("commit"), N_("use autosquash formatted message to fixup specified commit")),
1597 OPT_STRING(0, "squash", &squash_message, N_("commit"), N_("use autosquash formatted message to squash specified commit")),
1598 OPT_BOOL(0, "reset-author", &renew_authorship, N_("the commit is authored by me now (used with -C/-c/--amend)")),
1599 OPT_BOOL('s', "signoff", &signoff, N_("add Signed-off-by:")),
1600 OPT_FILENAME('t', "template", &template_file, N_("use specified template file")),
1601 OPT_BOOL('e', "edit", &edit_flag, N_("force edit of commit")),
1602 OPT_STRING(0, "cleanup", &cleanup_arg, N_("default"), N_("how to strip spaces and #comments from message")),
1603 OPT_BOOL(0, "status", &include_status, N_("include status in commit message template")),
1604 { OPTION_STRING, 'S', "gpg-sign", &sign_commit, N_("key-id"),
1605 N_("GPG sign commit"), PARSE_OPT_OPTARG, NULL, (intptr_t) "" },
1606 /* end commit message options */
1608 OPT_GROUP(N_("Commit contents options")),
1609 OPT_BOOL('a', "all", &all, N_("commit all changed files")),
1610 OPT_BOOL('i', "include", &also, N_("add specified files to index for commit")),
1611 OPT_BOOL(0, "interactive", &interactive, N_("interactively add files")),
1612 OPT_BOOL('p', "patch", &patch_interactive, N_("interactively add changes")),
1613 OPT_BOOL('o', "only", &only, N_("commit only specified files")),
1614 OPT_BOOL('n', "no-verify", &no_verify, N_("bypass pre-commit and commit-msg hooks")),
1615 OPT_BOOL(0, "dry-run", &dry_run, N_("show what would be committed")),
1616 OPT_SET_INT(0, "short", &status_format, N_("show status concisely"),
1617 STATUS_FORMAT_SHORT),
1618 OPT_BOOL(0, "branch", &s.show_branch, N_("show branch information")),
1619 OPT_SET_INT(0, "porcelain", &status_format,
1620 N_("machine-readable output"), STATUS_FORMAT_PORCELAIN),
1621 OPT_SET_INT(0, "long", &status_format,
1622 N_("show status in long format (default)"),
1623 STATUS_FORMAT_LONG),
1624 OPT_BOOL('z', "null", &s.null_termination,
1625 N_("terminate entries with NUL")),
1626 OPT_BOOL(0, "amend", &amend, N_("amend previous commit")),
1627 OPT_BOOL(0, "no-post-rewrite", &no_post_rewrite, N_("bypass post-rewrite hook")),
1628 { OPTION_STRING, 'u', "untracked-files", &untracked_files_arg, N_("mode"), N_("show untracked files, optional modes: all, normal, no. (Default: all)"), PARSE_OPT_OPTARG, NULL, (intptr_t)"all" },
1629 /* end commit contents options */
1631 OPT_HIDDEN_BOOL(0, "allow-empty", &allow_empty,
1632 N_("ok to record an empty change")),
1633 OPT_HIDDEN_BOOL(0, "allow-empty-message", &allow_empty_message,
1634 N_("ok to record a change with an empty message")),
1636 OPT_END()
1639 struct strbuf sb = STRBUF_INIT;
1640 struct strbuf author_ident = STRBUF_INIT;
1641 const char *index_file, *reflog_msg;
1642 char *nl;
1643 struct object_id oid;
1644 struct commit_list *parents = NULL;
1645 struct stat statbuf;
1646 struct commit *current_head = NULL;
1647 struct commit_extra_header *extra = NULL;
1648 struct ref_transaction *transaction;
1649 struct strbuf err = STRBUF_INIT;
1651 if (argc == 2 && !strcmp(argv[1], "-h"))
1652 usage_with_options(builtin_commit_usage, builtin_commit_options);
1654 status_init_config(&s, git_commit_config);
1655 status_format = STATUS_FORMAT_NONE; /* Ignore status.short */
1656 s.colopts = 0;
1658 if (get_sha1("HEAD", oid.hash))
1659 current_head = NULL;
1660 else {
1661 current_head = lookup_commit_or_die(&oid, "HEAD");
1662 if (parse_commit(current_head))
1663 die(_("could not parse HEAD commit"));
1665 verbose = -1; /* unspecified */
1666 argc = parse_and_validate_options(argc, argv, builtin_commit_options,
1667 builtin_commit_usage,
1668 prefix, current_head, &s);
1669 if (verbose == -1)
1670 verbose = (config_commit_verbose < 0) ? 0 : config_commit_verbose;
1672 if (dry_run)
1673 return dry_run_commit(argc, argv, prefix, current_head, &s);
1674 index_file = prepare_index(argc, argv, prefix, current_head, 0);
1676 /* Set up everything for writing the commit object. This includes
1677 running hooks, writing the trees, and interacting with the user. */
1678 if (!prepare_to_commit(index_file, prefix,
1679 current_head, &s, &author_ident)) {
1680 rollback_index_files();
1681 return 1;
1684 /* Determine parents */
1685 reflog_msg = getenv("GIT_REFLOG_ACTION");
1686 if (!current_head) {
1687 if (!reflog_msg)
1688 reflog_msg = "commit (initial)";
1689 } else if (amend) {
1690 if (!reflog_msg)
1691 reflog_msg = "commit (amend)";
1692 parents = copy_commit_list(current_head->parents);
1693 } else if (whence == FROM_MERGE) {
1694 struct strbuf m = STRBUF_INIT;
1695 FILE *fp;
1696 int allow_fast_forward = 1;
1697 struct commit_list **pptr = &parents;
1699 if (!reflog_msg)
1700 reflog_msg = "commit (merge)";
1701 pptr = commit_list_append(current_head, pptr);
1702 fp = fopen(git_path_merge_head(), "r");
1703 if (fp == NULL)
1704 die_errno(_("could not open '%s' for reading"),
1705 git_path_merge_head());
1706 while (strbuf_getline_lf(&m, fp) != EOF) {
1707 struct commit *parent;
1709 parent = get_merge_parent(m.buf);
1710 if (!parent)
1711 die(_("Corrupt MERGE_HEAD file (%s)"), m.buf);
1712 pptr = commit_list_append(parent, pptr);
1714 fclose(fp);
1715 strbuf_release(&m);
1716 if (!stat(git_path_merge_mode(), &statbuf)) {
1717 if (strbuf_read_file(&sb, git_path_merge_mode(), 0) < 0)
1718 die_errno(_("could not read MERGE_MODE"));
1719 if (!strcmp(sb.buf, "no-ff"))
1720 allow_fast_forward = 0;
1722 if (allow_fast_forward)
1723 parents = reduce_heads(parents);
1724 } else {
1725 if (!reflog_msg)
1726 reflog_msg = (whence == FROM_CHERRY_PICK)
1727 ? "commit (cherry-pick)"
1728 : "commit";
1729 commit_list_insert(current_head, &parents);
1732 /* Finally, get the commit message */
1733 strbuf_reset(&sb);
1734 if (strbuf_read_file(&sb, git_path_commit_editmsg(), 0) < 0) {
1735 int saved_errno = errno;
1736 rollback_index_files();
1737 die(_("could not read commit message: %s"), strerror(saved_errno));
1740 if (verbose || /* Truncate the message just before the diff, if any. */
1741 cleanup_mode == CLEANUP_SCISSORS)
1742 strbuf_setlen(&sb, wt_status_locate_end(sb.buf, sb.len));
1744 if (cleanup_mode != CLEANUP_NONE)
1745 strbuf_stripspace(&sb, cleanup_mode == CLEANUP_ALL);
1746 if (template_untouched(&sb) && !allow_empty_message) {
1747 rollback_index_files();
1748 fprintf(stderr, _("Aborting commit; you did not edit the message.\n"));
1749 exit(1);
1751 if (message_is_empty(&sb) && !allow_empty_message) {
1752 rollback_index_files();
1753 fprintf(stderr, _("Aborting commit due to empty commit message.\n"));
1754 exit(1);
1757 if (amend) {
1758 const char *exclude_gpgsig[2] = { "gpgsig", NULL };
1759 extra = read_commit_extra_headers(current_head, exclude_gpgsig);
1760 } else {
1761 struct commit_extra_header **tail = &extra;
1762 append_merge_tag_headers(parents, &tail);
1765 if (commit_tree_extended(sb.buf, sb.len, active_cache_tree->oid.hash,
1766 parents, oid.hash, author_ident.buf, sign_commit, extra)) {
1767 rollback_index_files();
1768 die(_("failed to write commit object"));
1770 strbuf_release(&author_ident);
1771 free_commit_extra_headers(extra);
1773 nl = strchr(sb.buf, '\n');
1774 if (nl)
1775 strbuf_setlen(&sb, nl + 1 - sb.buf);
1776 else
1777 strbuf_addch(&sb, '\n');
1778 strbuf_insert(&sb, 0, reflog_msg, strlen(reflog_msg));
1779 strbuf_insert(&sb, strlen(reflog_msg), ": ", 2);
1781 transaction = ref_transaction_begin(&err);
1782 if (!transaction ||
1783 ref_transaction_update(transaction, "HEAD", oid.hash,
1784 current_head
1785 ? current_head->object.oid.hash : null_sha1,
1786 0, sb.buf, &err) ||
1787 ref_transaction_commit(transaction, &err)) {
1788 rollback_index_files();
1789 die("%s", err.buf);
1791 ref_transaction_free(transaction);
1793 unlink(git_path_cherry_pick_head());
1794 unlink(git_path_revert_head());
1795 unlink(git_path_merge_head());
1796 unlink(git_path_merge_msg());
1797 unlink(git_path_merge_mode());
1798 unlink(git_path_squash_msg());
1800 if (commit_index_files())
1801 die (_("Repository has been updated, but unable to write\n"
1802 "new_index file. Check that disk is not full and quota is\n"
1803 "not exceeded, and then \"git reset HEAD\" to recover."));
1805 rerere(0);
1806 run_commit_hook(use_editor, get_index_file(), "post-commit", NULL);
1807 if (amend && !no_post_rewrite) {
1808 struct notes_rewrite_cfg *cfg;
1809 cfg = init_copy_notes_for_rewrite("amend");
1810 if (cfg) {
1811 /* we are amending, so current_head is not NULL */
1812 copy_note_for_rewrite(cfg, current_head->object.oid.hash, oid.hash);
1813 finish_copy_notes_for_rewrite(cfg, "Notes added by 'git commit --amend'");
1815 run_rewrite_hook(&current_head->object.oid, &oid);
1817 if (!quiet)
1818 print_summary(prefix, &oid, !current_head);
1820 strbuf_release(&err);
1821 return 0;