Documentation: expand 'git diff' SEE ALSO section
[git/mjg.git] / log-tree.c
blobb46ed3baef7d9d9971a3886d700059217fbe974a
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,
23 static char decoration_colors[][COLOR_MAXLEN] = {
24 GIT_COLOR_RESET,
25 GIT_COLOR_BOLD_GREEN, /* REF_LOCAL */
26 GIT_COLOR_BOLD_RED, /* REF_REMOTE */
27 GIT_COLOR_BOLD_YELLOW, /* REF_TAG */
28 GIT_COLOR_BOLD_MAGENTA, /* REF_STASH */
29 GIT_COLOR_BOLD_CYAN, /* REF_HEAD */
32 static const char *decorate_get_color(int decorate_use_color, enum decoration_type ix)
34 if (decorate_use_color)
35 return decoration_colors[ix];
36 return "";
39 static int parse_decorate_color_slot(const char *slot)
42 * We're comparing with 'ignore-case' on
43 * (because config.c sets them all tolower),
44 * but let's match the letters in the literal
45 * string values here with how they are
46 * documented in Documentation/config.txt, for
47 * consistency.
49 * We love being consistent, don't we?
51 if (!strcasecmp(slot, "branch"))
52 return DECORATION_REF_LOCAL;
53 if (!strcasecmp(slot, "remoteBranch"))
54 return DECORATION_REF_REMOTE;
55 if (!strcasecmp(slot, "tag"))
56 return DECORATION_REF_TAG;
57 if (!strcasecmp(slot, "stash"))
58 return DECORATION_REF_STASH;
59 if (!strcasecmp(slot, "HEAD"))
60 return DECORATION_REF_HEAD;
61 return -1;
64 int parse_decorate_color_config(const char *var, const int ofs, const char *value)
66 int slot = parse_decorate_color_slot(var + ofs);
67 if (slot < 0)
68 return 0;
69 if (!value)
70 return config_error_nonbool(var);
71 color_parse(value, var, decoration_colors[slot]);
72 return 0;
76 * log-tree.c uses DIFF_OPT_TST for determining whether to use color
77 * for showing the commit sha1, use the same check for --decorate
79 #define decorate_get_color_opt(o, ix) \
80 decorate_get_color(DIFF_OPT_TST((o), COLOR_DIFF), ix)
82 static void add_name_decoration(enum decoration_type type, const char *name, struct object *obj)
84 int nlen = strlen(name);
85 struct name_decoration *res = xmalloc(sizeof(struct name_decoration) + nlen);
86 memcpy(res->name, name, nlen + 1);
87 res->type = type;
88 res->next = add_decoration(&name_decoration, obj, res);
91 static int add_ref_decoration(const char *refname, const unsigned char *sha1, int flags, void *cb_data)
93 struct object *obj = parse_object(sha1);
94 enum decoration_type type = DECORATION_NONE;
95 if (!obj)
96 return 0;
98 if (!prefixcmp(refname, "refs/heads"))
99 type = DECORATION_REF_LOCAL;
100 else if (!prefixcmp(refname, "refs/remotes"))
101 type = DECORATION_REF_REMOTE;
102 else if (!prefixcmp(refname, "refs/tags"))
103 type = DECORATION_REF_TAG;
104 else if (!prefixcmp(refname, "refs/stash"))
105 type = DECORATION_REF_STASH;
106 else if (!prefixcmp(refname, "HEAD"))
107 type = DECORATION_REF_HEAD;
109 if (!cb_data || *(int *)cb_data == DECORATE_SHORT_REFS)
110 refname = prettify_refname(refname);
111 add_name_decoration(type, refname, obj);
112 while (obj->type == OBJ_TAG) {
113 obj = ((struct tag *)obj)->tagged;
114 if (!obj)
115 break;
116 add_name_decoration(DECORATION_REF_TAG, refname, obj);
118 return 0;
121 void load_ref_decorations(int flags)
123 static int loaded;
124 if (!loaded) {
125 loaded = 1;
126 for_each_ref(add_ref_decoration, &flags);
127 head_ref(add_ref_decoration, &flags);
131 static void show_parents(struct commit *commit, int abbrev)
133 struct commit_list *p;
134 for (p = commit->parents; p ; p = p->next) {
135 struct commit *parent = p->item;
136 printf(" %s", find_unique_abbrev(parent->object.sha1, abbrev));
140 void show_decorations(struct rev_info *opt, struct commit *commit)
142 const char *prefix;
143 struct name_decoration *decoration;
144 const char *color_commit =
145 diff_get_color_opt(&opt->diffopt, DIFF_COMMIT);
146 const char *color_reset =
147 decorate_get_color_opt(&opt->diffopt, DECORATION_NONE);
149 if (opt->show_source && commit->util)
150 printf("\t%s", (char *) commit->util);
151 if (!opt->show_decorations)
152 return;
153 decoration = lookup_decoration(&name_decoration, &commit->object);
154 if (!decoration)
155 return;
156 prefix = " (";
157 while (decoration) {
158 printf("%s", prefix);
159 fputs(decorate_get_color_opt(&opt->diffopt, decoration->type),
160 stdout);
161 if (decoration->type == DECORATION_REF_TAG)
162 fputs("tag: ", stdout);
163 printf("%s", decoration->name);
164 fputs(color_reset, stdout);
165 fputs(color_commit, stdout);
166 prefix = ", ";
167 decoration = decoration->next;
169 putchar(')');
173 * Search for "^[-A-Za-z]+: [^@]+@" pattern. It usually matches
174 * Signed-off-by: and Acked-by: lines.
176 static int detect_any_signoff(char *letter, int size)
178 char *cp;
179 int seen_colon = 0;
180 int seen_at = 0;
181 int seen_name = 0;
182 int seen_head = 0;
184 cp = letter + size;
185 while (letter <= --cp && *cp == '\n')
186 continue;
188 while (letter <= cp) {
189 char ch = *cp--;
190 if (ch == '\n')
191 break;
193 if (!seen_at) {
194 if (ch == '@')
195 seen_at = 1;
196 continue;
198 if (!seen_colon) {
199 if (ch == '@')
200 return 0;
201 else if (ch == ':')
202 seen_colon = 1;
203 else
204 seen_name = 1;
205 continue;
207 if (('A' <= ch && ch <= 'Z') ||
208 ('a' <= ch && ch <= 'z') ||
209 ch == '-') {
210 seen_head = 1;
211 continue;
213 /* no empty last line doesn't match */
214 return 0;
216 return seen_head && seen_name;
219 static void append_signoff(struct strbuf *sb, const char *signoff)
221 static const char signed_off_by[] = "Signed-off-by: ";
222 size_t signoff_len = strlen(signoff);
223 int has_signoff = 0;
224 char *cp;
226 cp = sb->buf;
228 /* First see if we already have the sign-off by the signer */
229 while ((cp = strstr(cp, signed_off_by))) {
231 has_signoff = 1;
233 cp += strlen(signed_off_by);
234 if (cp + signoff_len >= sb->buf + sb->len)
235 break;
236 if (strncmp(cp, signoff, signoff_len))
237 continue;
238 if (!isspace(cp[signoff_len]))
239 continue;
240 /* we already have him */
241 return;
244 if (!has_signoff)
245 has_signoff = detect_any_signoff(sb->buf, sb->len);
247 if (!has_signoff)
248 strbuf_addch(sb, '\n');
250 strbuf_addstr(sb, signed_off_by);
251 strbuf_add(sb, signoff, signoff_len);
252 strbuf_addch(sb, '\n');
255 static unsigned int digits_in_number(unsigned int number)
257 unsigned int i = 10, result = 1;
258 while (i <= number) {
259 i *= 10;
260 result++;
262 return result;
265 void get_patch_filename(struct commit *commit, int nr, const char *suffix,
266 struct strbuf *buf)
268 int suffix_len = strlen(suffix) + 1;
269 int start_len = buf->len;
271 strbuf_addf(buf, commit ? "%04d-" : "%d", nr);
272 if (commit) {
273 int max_len = start_len + FORMAT_PATCH_NAME_MAX - suffix_len;
274 struct pretty_print_context ctx = {0};
275 ctx.date_mode = DATE_NORMAL;
277 format_commit_message(commit, "%f", buf, &ctx);
278 if (max_len < buf->len)
279 strbuf_setlen(buf, max_len);
280 strbuf_addstr(buf, suffix);
284 void log_write_email_headers(struct rev_info *opt, struct commit *commit,
285 const char **subject_p,
286 const char **extra_headers_p,
287 int *need_8bit_cte_p)
289 const char *subject = NULL;
290 const char *extra_headers = opt->extra_headers;
291 const char *name = sha1_to_hex(commit->object.sha1);
293 *need_8bit_cte_p = 0; /* unknown */
294 if (opt->total > 0) {
295 static char buffer[64];
296 snprintf(buffer, sizeof(buffer),
297 "Subject: [%s %0*d/%d] ",
298 opt->subject_prefix,
299 digits_in_number(opt->total),
300 opt->nr, opt->total);
301 subject = buffer;
302 } else if (opt->total == 0 && opt->subject_prefix && *opt->subject_prefix) {
303 static char buffer[256];
304 snprintf(buffer, sizeof(buffer),
305 "Subject: [%s] ",
306 opt->subject_prefix);
307 subject = buffer;
308 } else {
309 subject = "Subject: ";
312 printf("From %s Mon Sep 17 00:00:00 2001\n", name);
313 graph_show_oneline(opt->graph);
314 if (opt->message_id) {
315 printf("Message-Id: <%s>\n", opt->message_id);
316 graph_show_oneline(opt->graph);
318 if (opt->ref_message_ids && opt->ref_message_ids->nr > 0) {
319 int i, n;
320 n = opt->ref_message_ids->nr;
321 printf("In-Reply-To: <%s>\n", opt->ref_message_ids->items[n-1].string);
322 for (i = 0; i < n; i++)
323 printf("%s<%s>\n", (i > 0 ? "\t" : "References: "),
324 opt->ref_message_ids->items[i].string);
325 graph_show_oneline(opt->graph);
327 if (opt->mime_boundary) {
328 static char subject_buffer[1024];
329 static char buffer[1024];
330 struct strbuf filename = STRBUF_INIT;
331 *need_8bit_cte_p = -1; /* NEVER */
332 snprintf(subject_buffer, sizeof(subject_buffer) - 1,
333 "%s"
334 "MIME-Version: 1.0\n"
335 "Content-Type: multipart/mixed;"
336 " boundary=\"%s%s\"\n"
337 "\n"
338 "This is a multi-part message in MIME "
339 "format.\n"
340 "--%s%s\n"
341 "Content-Type: text/plain; "
342 "charset=UTF-8; format=fixed\n"
343 "Content-Transfer-Encoding: 8bit\n\n",
344 extra_headers ? extra_headers : "",
345 mime_boundary_leader, opt->mime_boundary,
346 mime_boundary_leader, opt->mime_boundary);
347 extra_headers = subject_buffer;
349 get_patch_filename(opt->numbered_files ? NULL : commit, opt->nr,
350 opt->patch_suffix, &filename);
351 snprintf(buffer, sizeof(buffer) - 1,
352 "\n--%s%s\n"
353 "Content-Type: text/x-patch;"
354 " name=\"%s\"\n"
355 "Content-Transfer-Encoding: 8bit\n"
356 "Content-Disposition: %s;"
357 " filename=\"%s\"\n\n",
358 mime_boundary_leader, opt->mime_boundary,
359 filename.buf,
360 opt->no_inline ? "attachment" : "inline",
361 filename.buf);
362 opt->diffopt.stat_sep = buffer;
363 strbuf_release(&filename);
365 *subject_p = subject;
366 *extra_headers_p = extra_headers;
369 void show_log(struct rev_info *opt)
371 struct strbuf msgbuf = STRBUF_INIT;
372 struct log_info *log = opt->loginfo;
373 struct commit *commit = log->commit, *parent = log->parent;
374 int abbrev_commit = opt->abbrev_commit ? opt->abbrev : 40;
375 const char *extra_headers = opt->extra_headers;
376 struct pretty_print_context ctx = {0};
378 opt->loginfo = NULL;
379 ctx.show_notes = opt->show_notes;
380 if (!opt->verbose_header) {
381 graph_show_commit(opt->graph);
383 if (!opt->graph) {
384 if (commit->object.flags & BOUNDARY)
385 putchar('-');
386 else if (commit->object.flags & UNINTERESTING)
387 putchar('^');
388 else if (opt->left_right) {
389 if (commit->object.flags & SYMMETRIC_LEFT)
390 putchar('<');
391 else
392 putchar('>');
395 fputs(find_unique_abbrev(commit->object.sha1, abbrev_commit), stdout);
396 if (opt->print_parents)
397 show_parents(commit, abbrev_commit);
398 show_decorations(opt, commit);
399 if (opt->graph && !graph_is_commit_finished(opt->graph)) {
400 putchar('\n');
401 graph_show_remainder(opt->graph);
403 putchar(opt->diffopt.line_termination);
404 return;
408 * If use_terminator is set, we already handled any record termination
409 * at the end of the last record.
410 * Otherwise, add a diffopt.line_termination character before all
411 * entries but the first. (IOW, as a separator between entries)
413 if (opt->shown_one && !opt->use_terminator) {
415 * If entries are separated by a newline, the output
416 * should look human-readable. If the last entry ended
417 * with a newline, print the graph output before this
418 * newline. Otherwise it will end up as a completely blank
419 * line and will look like a gap in the graph.
421 * If the entry separator is not a newline, the output is
422 * primarily intended for programmatic consumption, and we
423 * never want the extra graph output before the entry
424 * separator.
426 if (opt->diffopt.line_termination == '\n' &&
427 !opt->missing_newline)
428 graph_show_padding(opt->graph);
429 putchar(opt->diffopt.line_termination);
431 opt->shown_one = 1;
434 * If the history graph was requested,
435 * print the graph, up to this commit's line
437 graph_show_commit(opt->graph);
440 * Print header line of header..
443 if (opt->commit_format == CMIT_FMT_EMAIL) {
444 log_write_email_headers(opt, commit, &ctx.subject, &extra_headers,
445 &ctx.need_8bit_cte);
446 } else if (opt->commit_format != CMIT_FMT_USERFORMAT) {
447 fputs(diff_get_color_opt(&opt->diffopt, DIFF_COMMIT), stdout);
448 if (opt->commit_format != CMIT_FMT_ONELINE)
449 fputs("commit ", stdout);
451 if (!opt->graph) {
452 if (commit->object.flags & BOUNDARY)
453 putchar('-');
454 else if (commit->object.flags & UNINTERESTING)
455 putchar('^');
456 else if (opt->left_right) {
457 if (commit->object.flags & SYMMETRIC_LEFT)
458 putchar('<');
459 else
460 putchar('>');
463 fputs(find_unique_abbrev(commit->object.sha1, abbrev_commit),
464 stdout);
465 if (opt->print_parents)
466 show_parents(commit, abbrev_commit);
467 if (parent)
468 printf(" (from %s)",
469 find_unique_abbrev(parent->object.sha1,
470 abbrev_commit));
471 show_decorations(opt, commit);
472 printf("%s", diff_get_color_opt(&opt->diffopt, DIFF_RESET));
473 if (opt->commit_format == CMIT_FMT_ONELINE) {
474 putchar(' ');
475 } else {
476 putchar('\n');
477 graph_show_oneline(opt->graph);
479 if (opt->reflog_info) {
481 * setup_revisions() ensures that opt->reflog_info
482 * and opt->graph cannot both be set,
483 * so we don't need to worry about printing the
484 * graph info here.
486 show_reflog_message(opt->reflog_info,
487 opt->commit_format == CMIT_FMT_ONELINE,
488 opt->date_mode_explicit ?
489 opt->date_mode :
490 DATE_NORMAL);
491 if (opt->commit_format == CMIT_FMT_ONELINE)
492 return;
496 if (!commit->buffer)
497 return;
500 * And then the pretty-printed message itself
502 if (ctx.need_8bit_cte >= 0)
503 ctx.need_8bit_cte = has_non_ascii(opt->add_signoff);
504 ctx.date_mode = opt->date_mode;
505 ctx.abbrev = opt->diffopt.abbrev;
506 ctx.after_subject = extra_headers;
507 ctx.reflog_info = opt->reflog_info;
508 pretty_print_commit(opt->commit_format, commit, &msgbuf, &ctx);
510 if (opt->add_signoff)
511 append_signoff(&msgbuf, opt->add_signoff);
512 if (opt->show_log_size) {
513 printf("log size %i\n", (int)msgbuf.len);
514 graph_show_oneline(opt->graph);
518 * Set opt->missing_newline if msgbuf doesn't
519 * end in a newline (including if it is empty)
521 if (!msgbuf.len || msgbuf.buf[msgbuf.len - 1] != '\n')
522 opt->missing_newline = 1;
523 else
524 opt->missing_newline = 0;
526 if (opt->graph)
527 graph_show_commit_msg(opt->graph, &msgbuf);
528 else
529 fwrite(msgbuf.buf, sizeof(char), msgbuf.len, stdout);
530 if (opt->use_terminator) {
531 if (!opt->missing_newline)
532 graph_show_padding(opt->graph);
533 putchar('\n');
536 strbuf_release(&msgbuf);
539 int log_tree_diff_flush(struct rev_info *opt)
541 diffcore_std(&opt->diffopt);
543 if (diff_queue_is_empty()) {
544 int saved_fmt = opt->diffopt.output_format;
545 opt->diffopt.output_format = DIFF_FORMAT_NO_OUTPUT;
546 diff_flush(&opt->diffopt);
547 opt->diffopt.output_format = saved_fmt;
548 return 0;
551 if (opt->loginfo && !opt->no_commit_id) {
552 /* When showing a verbose header (i.e. log message),
553 * and not in --pretty=oneline format, we would want
554 * an extra newline between the end of log and the
555 * output for readability.
557 show_log(opt);
558 if ((opt->diffopt.output_format & ~DIFF_FORMAT_NO_OUTPUT) &&
559 opt->verbose_header &&
560 opt->commit_format != CMIT_FMT_ONELINE) {
561 int pch = DIFF_FORMAT_DIFFSTAT | DIFF_FORMAT_PATCH;
562 if ((pch & opt->diffopt.output_format) == pch)
563 printf("---");
564 if (opt->diffopt.output_prefix) {
565 struct strbuf *msg = NULL;
566 msg = opt->diffopt.output_prefix(&opt->diffopt,
567 opt->diffopt.output_prefix_data);
568 fwrite(msg->buf, msg->len, 1, stdout);
570 putchar('\n');
573 diff_flush(&opt->diffopt);
574 return 1;
577 static int do_diff_combined(struct rev_info *opt, struct commit *commit)
579 unsigned const char *sha1 = commit->object.sha1;
581 diff_tree_combined_merge(sha1, opt->dense_combined_merges, opt);
582 return !opt->loginfo;
586 * Show the diff of a commit.
588 * Return true if we printed any log info messages
590 static int log_tree_diff(struct rev_info *opt, struct commit *commit, struct log_info *log)
592 int showed_log;
593 struct commit_list *parents;
594 unsigned const char *sha1 = commit->object.sha1;
596 if (!opt->diff && !DIFF_OPT_TST(&opt->diffopt, EXIT_WITH_STATUS))
597 return 0;
599 /* Root commit? */
600 parents = commit->parents;
601 if (!parents) {
602 if (opt->show_root_diff) {
603 diff_root_tree_sha1(sha1, "", &opt->diffopt);
604 log_tree_diff_flush(opt);
606 return !opt->loginfo;
609 /* More than one parent? */
610 if (parents && parents->next) {
611 if (opt->ignore_merges)
612 return 0;
613 else if (opt->combine_merges)
614 return do_diff_combined(opt, commit);
615 else if (opt->first_parent_only) {
617 * Generate merge log entry only for the first
618 * parent, showing summary diff of the others
619 * we merged _in_.
621 diff_tree_sha1(parents->item->object.sha1, sha1, "", &opt->diffopt);
622 log_tree_diff_flush(opt);
623 return !opt->loginfo;
626 /* If we show individual diffs, show the parent info */
627 log->parent = parents->item;
630 showed_log = 0;
631 for (;;) {
632 struct commit *parent = parents->item;
634 diff_tree_sha1(parent->object.sha1, sha1, "", &opt->diffopt);
635 log_tree_diff_flush(opt);
637 showed_log |= !opt->loginfo;
639 /* Set up the log info for the next parent, if any.. */
640 parents = parents->next;
641 if (!parents)
642 break;
643 log->parent = parents->item;
644 opt->loginfo = log;
646 return showed_log;
649 int log_tree_commit(struct rev_info *opt, struct commit *commit)
651 struct log_info log;
652 int shown;
654 log.commit = commit;
655 log.parent = NULL;
656 opt->loginfo = &log;
658 shown = log_tree_diff(opt, commit, &log);
659 if (!shown && opt->loginfo && opt->always_show_header) {
660 log.parent = NULL;
661 show_log(opt);
662 shown = 1;
664 opt->loginfo = NULL;
665 maybe_flush_or_die(stdout, "stdout");
666 return shown;