Merge branch 'cn/maint-rev-list-doc' into maint-1.7.8
[git/jrn.git] / log-tree.c
blobe7694a3a4ca2e6de7fe8f3b5458eb2b65591373a
1 #include "cache.h"
2 #include "diff.h"
3 #include "commit.h"
4 #include "tag.h"
5 #include "graph.h"
6 #include "log-tree.h"
7 #include "reflog-walk.h"
8 #include "refs.h"
9 #include "string-list.h"
10 #include "color.h"
12 struct decoration name_decoration = { "object names" };
14 enum decoration_type {
15 DECORATION_NONE = 0,
16 DECORATION_REF_LOCAL,
17 DECORATION_REF_REMOTE,
18 DECORATION_REF_TAG,
19 DECORATION_REF_STASH,
20 DECORATION_REF_HEAD,
21 DECORATION_GRAFTED,
24 static char decoration_colors[][COLOR_MAXLEN] = {
25 GIT_COLOR_RESET,
26 GIT_COLOR_BOLD_GREEN, /* REF_LOCAL */
27 GIT_COLOR_BOLD_RED, /* REF_REMOTE */
28 GIT_COLOR_BOLD_YELLOW, /* REF_TAG */
29 GIT_COLOR_BOLD_MAGENTA, /* REF_STASH */
30 GIT_COLOR_BOLD_CYAN, /* REF_HEAD */
31 GIT_COLOR_BOLD_BLUE, /* GRAFTED */
34 static const char *decorate_get_color(int decorate_use_color, enum decoration_type ix)
36 if (want_color(decorate_use_color))
37 return decoration_colors[ix];
38 return "";
41 static int parse_decorate_color_slot(const char *slot)
44 * We're comparing with 'ignore-case' on
45 * (because config.c sets them all tolower),
46 * but let's match the letters in the literal
47 * string values here with how they are
48 * documented in Documentation/config.txt, for
49 * consistency.
51 * We love being consistent, don't we?
53 if (!strcasecmp(slot, "branch"))
54 return DECORATION_REF_LOCAL;
55 if (!strcasecmp(slot, "remoteBranch"))
56 return DECORATION_REF_REMOTE;
57 if (!strcasecmp(slot, "tag"))
58 return DECORATION_REF_TAG;
59 if (!strcasecmp(slot, "stash"))
60 return DECORATION_REF_STASH;
61 if (!strcasecmp(slot, "HEAD"))
62 return DECORATION_REF_HEAD;
63 return -1;
66 int parse_decorate_color_config(const char *var, const int ofs, const char *value)
68 int slot = parse_decorate_color_slot(var + ofs);
69 if (slot < 0)
70 return 0;
71 if (!value)
72 return config_error_nonbool(var);
73 color_parse(value, var, decoration_colors[slot]);
74 return 0;
78 * log-tree.c uses DIFF_OPT_TST for determining whether to use color
79 * for showing the commit sha1, use the same check for --decorate
81 #define decorate_get_color_opt(o, ix) \
82 decorate_get_color((o)->use_color, ix)
84 static void add_name_decoration(enum decoration_type type, const char *name, struct object *obj)
86 int nlen = strlen(name);
87 struct name_decoration *res = xmalloc(sizeof(struct name_decoration) + nlen);
88 memcpy(res->name, name, nlen + 1);
89 res->type = type;
90 res->next = add_decoration(&name_decoration, obj, res);
93 static int add_ref_decoration(const char *refname, const unsigned char *sha1, int flags, void *cb_data)
95 struct object *obj;
96 enum decoration_type type = DECORATION_NONE;
98 if (!prefixcmp(refname, "refs/replace/")) {
99 unsigned char original_sha1[20];
100 if (!read_replace_refs)
101 return 0;
102 if (get_sha1_hex(refname + 13, original_sha1)) {
103 warning("invalid replace ref %s", refname);
104 return 0;
106 obj = parse_object(original_sha1);
107 if (obj)
108 add_name_decoration(DECORATION_GRAFTED, "replaced", obj);
109 return 0;
112 obj = parse_object(sha1);
113 if (!obj)
114 return 0;
116 if (!prefixcmp(refname, "refs/heads/"))
117 type = DECORATION_REF_LOCAL;
118 else if (!prefixcmp(refname, "refs/remotes/"))
119 type = DECORATION_REF_REMOTE;
120 else if (!prefixcmp(refname, "refs/tags/"))
121 type = DECORATION_REF_TAG;
122 else if (!prefixcmp(refname, "refs/stash"))
123 type = DECORATION_REF_STASH;
124 else if (!prefixcmp(refname, "HEAD"))
125 type = DECORATION_REF_HEAD;
127 if (!cb_data || *(int *)cb_data == DECORATE_SHORT_REFS)
128 refname = prettify_refname(refname);
129 add_name_decoration(type, refname, obj);
130 while (obj->type == OBJ_TAG) {
131 obj = ((struct tag *)obj)->tagged;
132 if (!obj)
133 break;
134 add_name_decoration(DECORATION_REF_TAG, refname, obj);
136 return 0;
139 static int add_graft_decoration(const struct commit_graft *graft, void *cb_data)
141 struct commit *commit = lookup_commit(graft->sha1);
142 if (!commit)
143 return 0;
144 add_name_decoration(DECORATION_GRAFTED, "grafted", &commit->object);
145 return 0;
148 void load_ref_decorations(int flags)
150 static int loaded;
151 if (!loaded) {
152 loaded = 1;
153 for_each_ref(add_ref_decoration, &flags);
154 head_ref(add_ref_decoration, &flags);
155 for_each_commit_graft(add_graft_decoration, NULL);
159 static void show_parents(struct commit *commit, int abbrev)
161 struct commit_list *p;
162 for (p = commit->parents; p ; p = p->next) {
163 struct commit *parent = p->item;
164 printf(" %s", find_unique_abbrev(parent->object.sha1, abbrev));
168 static void show_children(struct rev_info *opt, struct commit *commit, int abbrev)
170 struct commit_list *p = lookup_decoration(&opt->children, &commit->object);
171 for ( ; p; p = p->next) {
172 printf(" %s", find_unique_abbrev(p->item->object.sha1, abbrev));
176 void show_decorations(struct rev_info *opt, struct commit *commit)
178 const char *prefix;
179 struct name_decoration *decoration;
180 const char *color_commit =
181 diff_get_color_opt(&opt->diffopt, DIFF_COMMIT);
182 const char *color_reset =
183 decorate_get_color_opt(&opt->diffopt, DECORATION_NONE);
185 if (opt->show_source && commit->util)
186 printf("\t%s", (char *) commit->util);
187 if (!opt->show_decorations)
188 return;
189 decoration = lookup_decoration(&name_decoration, &commit->object);
190 if (!decoration)
191 return;
192 prefix = " (";
193 while (decoration) {
194 printf("%s", prefix);
195 fputs(decorate_get_color_opt(&opt->diffopt, decoration->type),
196 stdout);
197 if (decoration->type == DECORATION_REF_TAG)
198 fputs("tag: ", stdout);
199 printf("%s", decoration->name);
200 fputs(color_reset, stdout);
201 fputs(color_commit, stdout);
202 prefix = ", ";
203 decoration = decoration->next;
205 putchar(')');
209 * Search for "^[-A-Za-z]+: [^@]+@" pattern. It usually matches
210 * Signed-off-by: and Acked-by: lines.
212 static int detect_any_signoff(char *letter, int size)
214 char *cp;
215 int seen_colon = 0;
216 int seen_at = 0;
217 int seen_name = 0;
218 int seen_head = 0;
220 cp = letter + size;
221 while (letter <= --cp && *cp == '\n')
222 continue;
224 while (letter <= cp) {
225 char ch = *cp--;
226 if (ch == '\n')
227 break;
229 if (!seen_at) {
230 if (ch == '@')
231 seen_at = 1;
232 continue;
234 if (!seen_colon) {
235 if (ch == '@')
236 return 0;
237 else if (ch == ':')
238 seen_colon = 1;
239 else
240 seen_name = 1;
241 continue;
243 if (('A' <= ch && ch <= 'Z') ||
244 ('a' <= ch && ch <= 'z') ||
245 ch == '-') {
246 seen_head = 1;
247 continue;
249 /* no empty last line doesn't match */
250 return 0;
252 return seen_head && seen_name;
255 static void append_signoff(struct strbuf *sb, const char *signoff)
257 static const char signed_off_by[] = "Signed-off-by: ";
258 size_t signoff_len = strlen(signoff);
259 int has_signoff = 0;
260 char *cp;
262 cp = sb->buf;
264 /* First see if we already have the sign-off by the signer */
265 while ((cp = strstr(cp, signed_off_by))) {
267 has_signoff = 1;
269 cp += strlen(signed_off_by);
270 if (cp + signoff_len >= sb->buf + sb->len)
271 break;
272 if (strncmp(cp, signoff, signoff_len))
273 continue;
274 if (!isspace(cp[signoff_len]))
275 continue;
276 /* we already have him */
277 return;
280 if (!has_signoff)
281 has_signoff = detect_any_signoff(sb->buf, sb->len);
283 if (!has_signoff)
284 strbuf_addch(sb, '\n');
286 strbuf_addstr(sb, signed_off_by);
287 strbuf_add(sb, signoff, signoff_len);
288 strbuf_addch(sb, '\n');
291 static unsigned int digits_in_number(unsigned int number)
293 unsigned int i = 10, result = 1;
294 while (i <= number) {
295 i *= 10;
296 result++;
298 return result;
301 void get_patch_filename(struct commit *commit, int nr, const char *suffix,
302 struct strbuf *buf)
304 int suffix_len = strlen(suffix) + 1;
305 int start_len = buf->len;
307 strbuf_addf(buf, commit ? "%04d-" : "%d", nr);
308 if (commit) {
309 int max_len = start_len + FORMAT_PATCH_NAME_MAX - suffix_len;
310 struct pretty_print_context ctx = {0};
311 ctx.date_mode = DATE_NORMAL;
313 format_commit_message(commit, "%f", buf, &ctx);
314 if (max_len < buf->len)
315 strbuf_setlen(buf, max_len);
316 strbuf_addstr(buf, suffix);
320 void log_write_email_headers(struct rev_info *opt, struct commit *commit,
321 const char **subject_p,
322 const char **extra_headers_p,
323 int *need_8bit_cte_p)
325 const char *subject = NULL;
326 const char *extra_headers = opt->extra_headers;
327 const char *name = sha1_to_hex(commit->object.sha1);
329 *need_8bit_cte_p = 0; /* unknown */
330 if (opt->total > 0) {
331 static char buffer[64];
332 snprintf(buffer, sizeof(buffer),
333 "Subject: [%s%s%0*d/%d] ",
334 opt->subject_prefix,
335 *opt->subject_prefix ? " " : "",
336 digits_in_number(opt->total),
337 opt->nr, opt->total);
338 subject = buffer;
339 } else if (opt->total == 0 && opt->subject_prefix && *opt->subject_prefix) {
340 static char buffer[256];
341 snprintf(buffer, sizeof(buffer),
342 "Subject: [%s] ",
343 opt->subject_prefix);
344 subject = buffer;
345 } else {
346 subject = "Subject: ";
349 printf("From %s Mon Sep 17 00:00:00 2001\n", name);
350 graph_show_oneline(opt->graph);
351 if (opt->message_id) {
352 printf("Message-Id: <%s>\n", opt->message_id);
353 graph_show_oneline(opt->graph);
355 if (opt->ref_message_ids && opt->ref_message_ids->nr > 0) {
356 int i, n;
357 n = opt->ref_message_ids->nr;
358 printf("In-Reply-To: <%s>\n", opt->ref_message_ids->items[n-1].string);
359 for (i = 0; i < n; i++)
360 printf("%s<%s>\n", (i > 0 ? "\t" : "References: "),
361 opt->ref_message_ids->items[i].string);
362 graph_show_oneline(opt->graph);
364 if (opt->mime_boundary) {
365 static char subject_buffer[1024];
366 static char buffer[1024];
367 struct strbuf filename = STRBUF_INIT;
368 *need_8bit_cte_p = -1; /* NEVER */
369 snprintf(subject_buffer, sizeof(subject_buffer) - 1,
370 "%s"
371 "MIME-Version: 1.0\n"
372 "Content-Type: multipart/mixed;"
373 " boundary=\"%s%s\"\n"
374 "\n"
375 "This is a multi-part message in MIME "
376 "format.\n"
377 "--%s%s\n"
378 "Content-Type: text/plain; "
379 "charset=UTF-8; format=fixed\n"
380 "Content-Transfer-Encoding: 8bit\n\n",
381 extra_headers ? extra_headers : "",
382 mime_boundary_leader, opt->mime_boundary,
383 mime_boundary_leader, opt->mime_boundary);
384 extra_headers = subject_buffer;
386 get_patch_filename(opt->numbered_files ? NULL : commit, opt->nr,
387 opt->patch_suffix, &filename);
388 snprintf(buffer, sizeof(buffer) - 1,
389 "\n--%s%s\n"
390 "Content-Type: text/x-patch;"
391 " name=\"%s\"\n"
392 "Content-Transfer-Encoding: 8bit\n"
393 "Content-Disposition: %s;"
394 " filename=\"%s\"\n\n",
395 mime_boundary_leader, opt->mime_boundary,
396 filename.buf,
397 opt->no_inline ? "attachment" : "inline",
398 filename.buf);
399 opt->diffopt.stat_sep = buffer;
400 strbuf_release(&filename);
402 *subject_p = subject;
403 *extra_headers_p = extra_headers;
406 void show_log(struct rev_info *opt)
408 struct strbuf msgbuf = STRBUF_INIT;
409 struct log_info *log = opt->loginfo;
410 struct commit *commit = log->commit, *parent = log->parent;
411 int abbrev_commit = opt->abbrev_commit ? opt->abbrev : 40;
412 const char *extra_headers = opt->extra_headers;
413 struct pretty_print_context ctx = {0};
415 opt->loginfo = NULL;
416 ctx.show_notes = opt->show_notes;
417 if (!opt->verbose_header) {
418 graph_show_commit(opt->graph);
420 if (!opt->graph)
421 put_revision_mark(opt, commit);
422 fputs(find_unique_abbrev(commit->object.sha1, abbrev_commit), stdout);
423 if (opt->print_parents)
424 show_parents(commit, abbrev_commit);
425 if (opt->children.name)
426 show_children(opt, commit, abbrev_commit);
427 show_decorations(opt, commit);
428 if (opt->graph && !graph_is_commit_finished(opt->graph)) {
429 putchar('\n');
430 graph_show_remainder(opt->graph);
432 putchar(opt->diffopt.line_termination);
433 return;
437 * If use_terminator is set, we already handled any record termination
438 * at the end of the last record.
439 * Otherwise, add a diffopt.line_termination character before all
440 * entries but the first. (IOW, as a separator between entries)
442 if (opt->shown_one && !opt->use_terminator) {
444 * If entries are separated by a newline, the output
445 * should look human-readable. If the last entry ended
446 * with a newline, print the graph output before this
447 * newline. Otherwise it will end up as a completely blank
448 * line and will look like a gap in the graph.
450 * If the entry separator is not a newline, the output is
451 * primarily intended for programmatic consumption, and we
452 * never want the extra graph output before the entry
453 * separator.
455 if (opt->diffopt.line_termination == '\n' &&
456 !opt->missing_newline)
457 graph_show_padding(opt->graph);
458 putchar(opt->diffopt.line_termination);
460 opt->shown_one = 1;
463 * If the history graph was requested,
464 * print the graph, up to this commit's line
466 graph_show_commit(opt->graph);
469 * Print header line of header..
472 if (opt->commit_format == CMIT_FMT_EMAIL) {
473 log_write_email_headers(opt, commit, &ctx.subject, &extra_headers,
474 &ctx.need_8bit_cte);
475 } else if (opt->commit_format != CMIT_FMT_USERFORMAT) {
476 fputs(diff_get_color_opt(&opt->diffopt, DIFF_COMMIT), stdout);
477 if (opt->commit_format != CMIT_FMT_ONELINE)
478 fputs("commit ", stdout);
480 if (!opt->graph)
481 put_revision_mark(opt, commit);
482 fputs(find_unique_abbrev(commit->object.sha1, abbrev_commit),
483 stdout);
484 if (opt->print_parents)
485 show_parents(commit, abbrev_commit);
486 if (opt->children.name)
487 show_children(opt, commit, abbrev_commit);
488 if (parent)
489 printf(" (from %s)",
490 find_unique_abbrev(parent->object.sha1,
491 abbrev_commit));
492 show_decorations(opt, commit);
493 printf("%s", diff_get_color_opt(&opt->diffopt, DIFF_RESET));
494 if (opt->commit_format == CMIT_FMT_ONELINE) {
495 putchar(' ');
496 } else {
497 putchar('\n');
498 graph_show_oneline(opt->graph);
500 if (opt->reflog_info) {
502 * setup_revisions() ensures that opt->reflog_info
503 * and opt->graph cannot both be set,
504 * so we don't need to worry about printing the
505 * graph info here.
507 show_reflog_message(opt->reflog_info,
508 opt->commit_format == CMIT_FMT_ONELINE,
509 opt->date_mode_explicit ?
510 opt->date_mode :
511 DATE_NORMAL);
512 if (opt->commit_format == CMIT_FMT_ONELINE)
513 return;
517 if (!commit->buffer)
518 return;
521 * And then the pretty-printed message itself
523 if (ctx.need_8bit_cte >= 0)
524 ctx.need_8bit_cte = has_non_ascii(opt->add_signoff);
525 ctx.date_mode = opt->date_mode;
526 ctx.abbrev = opt->diffopt.abbrev;
527 ctx.after_subject = extra_headers;
528 ctx.preserve_subject = opt->preserve_subject;
529 ctx.reflog_info = opt->reflog_info;
530 ctx.fmt = opt->commit_format;
531 pretty_print_commit(&ctx, commit, &msgbuf);
533 if (opt->add_signoff)
534 append_signoff(&msgbuf, opt->add_signoff);
535 if (opt->show_log_size) {
536 printf("log size %i\n", (int)msgbuf.len);
537 graph_show_oneline(opt->graph);
541 * Set opt->missing_newline if msgbuf doesn't
542 * end in a newline (including if it is empty)
544 if (!msgbuf.len || msgbuf.buf[msgbuf.len - 1] != '\n')
545 opt->missing_newline = 1;
546 else
547 opt->missing_newline = 0;
549 if (opt->graph)
550 graph_show_commit_msg(opt->graph, &msgbuf);
551 else
552 fwrite(msgbuf.buf, sizeof(char), msgbuf.len, stdout);
553 if (opt->use_terminator) {
554 if (!opt->missing_newline)
555 graph_show_padding(opt->graph);
556 putchar('\n');
559 strbuf_release(&msgbuf);
562 int log_tree_diff_flush(struct rev_info *opt)
564 diffcore_std(&opt->diffopt);
566 if (diff_queue_is_empty()) {
567 int saved_fmt = opt->diffopt.output_format;
568 opt->diffopt.output_format = DIFF_FORMAT_NO_OUTPUT;
569 diff_flush(&opt->diffopt);
570 opt->diffopt.output_format = saved_fmt;
571 return 0;
574 if (opt->loginfo && !opt->no_commit_id) {
575 /* When showing a verbose header (i.e. log message),
576 * and not in --pretty=oneline format, we would want
577 * an extra newline between the end of log and the
578 * output for readability.
580 show_log(opt);
581 if ((opt->diffopt.output_format & ~DIFF_FORMAT_NO_OUTPUT) &&
582 opt->verbose_header &&
583 opt->commit_format != CMIT_FMT_ONELINE) {
584 int pch = DIFF_FORMAT_DIFFSTAT | DIFF_FORMAT_PATCH;
585 if ((pch & opt->diffopt.output_format) == pch)
586 printf("---");
587 if (opt->diffopt.output_prefix) {
588 struct strbuf *msg = NULL;
589 msg = opt->diffopt.output_prefix(&opt->diffopt,
590 opt->diffopt.output_prefix_data);
591 fwrite(msg->buf, msg->len, 1, stdout);
593 putchar('\n');
596 diff_flush(&opt->diffopt);
597 return 1;
600 static int do_diff_combined(struct rev_info *opt, struct commit *commit)
602 unsigned const char *sha1 = commit->object.sha1;
604 diff_tree_combined_merge(sha1, opt->dense_combined_merges, opt);
605 return !opt->loginfo;
609 * Show the diff of a commit.
611 * Return true if we printed any log info messages
613 static int log_tree_diff(struct rev_info *opt, struct commit *commit, struct log_info *log)
615 int showed_log;
616 struct commit_list *parents;
617 unsigned const char *sha1 = commit->object.sha1;
619 if (!opt->diff && !DIFF_OPT_TST(&opt->diffopt, EXIT_WITH_STATUS))
620 return 0;
622 /* Root commit? */
623 parents = commit->parents;
624 if (!parents) {
625 if (opt->show_root_diff) {
626 diff_root_tree_sha1(sha1, "", &opt->diffopt);
627 log_tree_diff_flush(opt);
629 return !opt->loginfo;
632 /* More than one parent? */
633 if (parents && parents->next) {
634 if (opt->ignore_merges)
635 return 0;
636 else if (opt->combine_merges)
637 return do_diff_combined(opt, commit);
638 else if (opt->first_parent_only) {
640 * Generate merge log entry only for the first
641 * parent, showing summary diff of the others
642 * we merged _in_.
644 diff_tree_sha1(parents->item->object.sha1, sha1, "", &opt->diffopt);
645 log_tree_diff_flush(opt);
646 return !opt->loginfo;
649 /* If we show individual diffs, show the parent info */
650 log->parent = parents->item;
653 showed_log = 0;
654 for (;;) {
655 struct commit *parent = parents->item;
657 diff_tree_sha1(parent->object.sha1, sha1, "", &opt->diffopt);
658 log_tree_diff_flush(opt);
660 showed_log |= !opt->loginfo;
662 /* Set up the log info for the next parent, if any.. */
663 parents = parents->next;
664 if (!parents)
665 break;
666 log->parent = parents->item;
667 opt->loginfo = log;
669 return showed_log;
672 int log_tree_commit(struct rev_info *opt, struct commit *commit)
674 struct log_info log;
675 int shown;
677 log.commit = commit;
678 log.parent = NULL;
679 opt->loginfo = &log;
681 shown = log_tree_diff(opt, commit, &log);
682 if (!shown && opt->loginfo && opt->always_show_header) {
683 log.parent = NULL;
684 show_log(opt);
685 shown = 1;
687 opt->loginfo = NULL;
688 maybe_flush_or_die(stdout, "stdout");
689 return shown;