log-tree.con commit log-tree: show_log: make commentary block delimiting reusable (3fcc7a2)
   1#include "cache.h"
   2#include "config.h"
   3#include "diff.h"
   4#include "object-store.h"
   5#include "commit.h"
   6#include "tag.h"
   7#include "graph.h"
   8#include "log-tree.h"
   9#include "reflog-walk.h"
  10#include "refs.h"
  11#include "string-list.h"
  12#include "color.h"
  13#include "gpg-interface.h"
  14#include "sequencer.h"
  15#include "line-log.h"
  16#include "help.h"
  17
  18static struct decoration name_decoration = { "object names" };
  19static int decoration_loaded;
  20static int decoration_flags;
  21
  22static char decoration_colors[][COLOR_MAXLEN] = {
  23        GIT_COLOR_RESET,
  24        GIT_COLOR_BOLD_GREEN,   /* REF_LOCAL */
  25        GIT_COLOR_BOLD_RED,     /* REF_REMOTE */
  26        GIT_COLOR_BOLD_YELLOW,  /* REF_TAG */
  27        GIT_COLOR_BOLD_MAGENTA, /* REF_STASH */
  28        GIT_COLOR_BOLD_CYAN,    /* REF_HEAD */
  29        GIT_COLOR_BOLD_BLUE,    /* GRAFTED */
  30};
  31
  32static const char *color_decorate_slots[] = {
  33        [DECORATION_REF_LOCAL]  = "branch",
  34        [DECORATION_REF_REMOTE] = "remoteBranch",
  35        [DECORATION_REF_TAG]    = "tag",
  36        [DECORATION_REF_STASH]  = "stash",
  37        [DECORATION_REF_HEAD]   = "HEAD",
  38        [DECORATION_GRAFTED]    = "grafted",
  39};
  40
  41static const char *decorate_get_color(int decorate_use_color, enum decoration_type ix)
  42{
  43        if (want_color(decorate_use_color))
  44                return decoration_colors[ix];
  45        return "";
  46}
  47
  48define_list_config_array(color_decorate_slots);
  49
  50int parse_decorate_color_config(const char *var, const char *slot_name, const char *value)
  51{
  52        int slot = LOOKUP_CONFIG(color_decorate_slots, slot_name);
  53        if (slot < 0)
  54                return 0;
  55        if (!value)
  56                return config_error_nonbool(var);
  57        return color_parse(value, decoration_colors[slot]);
  58}
  59
  60/*
  61 * log-tree.c uses DIFF_OPT_TST for determining whether to use color
  62 * for showing the commit sha1, use the same check for --decorate
  63 */
  64#define decorate_get_color_opt(o, ix) \
  65        decorate_get_color((o)->use_color, ix)
  66
  67void add_name_decoration(enum decoration_type type, const char *name, struct object *obj)
  68{
  69        struct name_decoration *res;
  70        FLEX_ALLOC_STR(res, name, name);
  71        res->type = type;
  72        res->next = add_decoration(&name_decoration, obj, res);
  73}
  74
  75const struct name_decoration *get_name_decoration(const struct object *obj)
  76{
  77        return lookup_decoration(&name_decoration, obj);
  78}
  79
  80static int add_ref_decoration(const char *refname, const struct object_id *oid,
  81                              int flags, void *cb_data)
  82{
  83        struct object *obj;
  84        enum decoration_type type = DECORATION_NONE;
  85        struct decoration_filter *filter = (struct decoration_filter *)cb_data;
  86
  87        if (filter && !ref_filter_match(refname,
  88                              filter->include_ref_pattern,
  89                              filter->exclude_ref_pattern))
  90                return 0;
  91
  92        if (starts_with(refname, git_replace_ref_base)) {
  93                struct object_id original_oid;
  94                if (!check_replace_refs)
  95                        return 0;
  96                if (get_oid_hex(refname + strlen(git_replace_ref_base),
  97                                &original_oid)) {
  98                        warning("invalid replace ref %s", refname);
  99                        return 0;
 100                }
 101                obj = parse_object(&original_oid);
 102                if (obj)
 103                        add_name_decoration(DECORATION_GRAFTED, "replaced", obj);
 104                return 0;
 105        }
 106
 107        obj = parse_object(oid);
 108        if (!obj)
 109                return 0;
 110
 111        if (starts_with(refname, "refs/heads/"))
 112                type = DECORATION_REF_LOCAL;
 113        else if (starts_with(refname, "refs/remotes/"))
 114                type = DECORATION_REF_REMOTE;
 115        else if (starts_with(refname, "refs/tags/"))
 116                type = DECORATION_REF_TAG;
 117        else if (!strcmp(refname, "refs/stash"))
 118                type = DECORATION_REF_STASH;
 119        else if (!strcmp(refname, "HEAD"))
 120                type = DECORATION_REF_HEAD;
 121
 122        add_name_decoration(type, refname, obj);
 123        while (obj->type == OBJ_TAG) {
 124                obj = ((struct tag *)obj)->tagged;
 125                if (!obj)
 126                        break;
 127                if (!obj->parsed)
 128                        parse_object(&obj->oid);
 129                add_name_decoration(DECORATION_REF_TAG, refname, obj);
 130        }
 131        return 0;
 132}
 133
 134static int add_graft_decoration(const struct commit_graft *graft, void *cb_data)
 135{
 136        struct commit *commit = lookup_commit(&graft->oid);
 137        if (!commit)
 138                return 0;
 139        add_name_decoration(DECORATION_GRAFTED, "grafted", &commit->object);
 140        return 0;
 141}
 142
 143void load_ref_decorations(struct decoration_filter *filter, int flags)
 144{
 145        if (!decoration_loaded) {
 146                if (filter) {
 147                        struct string_list_item *item;
 148                        for_each_string_list_item(item, filter->exclude_ref_pattern) {
 149                                normalize_glob_ref(item, NULL, item->string);
 150                        }
 151                        for_each_string_list_item(item, filter->include_ref_pattern) {
 152                                normalize_glob_ref(item, NULL, item->string);
 153                        }
 154                }
 155                decoration_loaded = 1;
 156                decoration_flags = flags;
 157                for_each_ref(add_ref_decoration, filter);
 158                head_ref(add_ref_decoration, filter);
 159                for_each_commit_graft(add_graft_decoration, filter);
 160        }
 161}
 162
 163static void show_parents(struct commit *commit, int abbrev, FILE *file)
 164{
 165        struct commit_list *p;
 166        for (p = commit->parents; p ; p = p->next) {
 167                struct commit *parent = p->item;
 168                fprintf(file, " %s", find_unique_abbrev(&parent->object.oid, abbrev));
 169        }
 170}
 171
 172static void show_children(struct rev_info *opt, struct commit *commit, int abbrev)
 173{
 174        struct commit_list *p = lookup_decoration(&opt->children, &commit->object);
 175        for ( ; p; p = p->next) {
 176                fprintf(opt->diffopt.file, " %s", find_unique_abbrev(&p->item->object.oid, abbrev));
 177        }
 178}
 179
 180/*
 181 * Do we have HEAD in the output, and also the branch it points at?
 182 * If so, find that decoration entry for that current branch.
 183 */
 184static const struct name_decoration *current_pointed_by_HEAD(const struct name_decoration *decoration)
 185{
 186        const struct name_decoration *list, *head = NULL;
 187        const char *branch_name = NULL;
 188        int rru_flags;
 189
 190        /* First find HEAD */
 191        for (list = decoration; list; list = list->next)
 192                if (list->type == DECORATION_REF_HEAD) {
 193                        head = list;
 194                        break;
 195                }
 196        if (!head)
 197                return NULL;
 198
 199        /* Now resolve and find the matching current branch */
 200        branch_name = resolve_ref_unsafe("HEAD", 0, NULL, &rru_flags);
 201        if (!branch_name || !(rru_flags & REF_ISSYMREF))
 202                return NULL;
 203
 204        if (!starts_with(branch_name, "refs/"))
 205                return NULL;
 206
 207        /* OK, do we have that ref in the list? */
 208        for (list = decoration; list; list = list->next)
 209                if ((list->type == DECORATION_REF_LOCAL) &&
 210                    !strcmp(branch_name, list->name)) {
 211                        return list;
 212                }
 213
 214        return NULL;
 215}
 216
 217static void show_name(struct strbuf *sb, const struct name_decoration *decoration)
 218{
 219        if (decoration_flags == DECORATE_SHORT_REFS)
 220                strbuf_addstr(sb, prettify_refname(decoration->name));
 221        else
 222                strbuf_addstr(sb, decoration->name);
 223}
 224
 225/*
 226 * The caller makes sure there is no funny color before calling.
 227 * format_decorations_extended makes sure the same after return.
 228 */
 229void format_decorations_extended(struct strbuf *sb,
 230                        const struct commit *commit,
 231                        int use_color,
 232                        const char *prefix,
 233                        const char *separator,
 234                        const char *suffix)
 235{
 236        const struct name_decoration *decoration;
 237        const struct name_decoration *current_and_HEAD;
 238        const char *color_commit =
 239                diff_get_color(use_color, DIFF_COMMIT);
 240        const char *color_reset =
 241                decorate_get_color(use_color, DECORATION_NONE);
 242
 243        decoration = get_name_decoration(&commit->object);
 244        if (!decoration)
 245                return;
 246
 247        current_and_HEAD = current_pointed_by_HEAD(decoration);
 248        while (decoration) {
 249                /*
 250                 * When both current and HEAD are there, only
 251                 * show HEAD->current where HEAD would have
 252                 * appeared, skipping the entry for current.
 253                 */
 254                if (decoration != current_and_HEAD) {
 255                        strbuf_addstr(sb, color_commit);
 256                        strbuf_addstr(sb, prefix);
 257                        strbuf_addstr(sb, color_reset);
 258                        strbuf_addstr(sb, decorate_get_color(use_color, decoration->type));
 259                        if (decoration->type == DECORATION_REF_TAG)
 260                                strbuf_addstr(sb, "tag: ");
 261
 262                        show_name(sb, decoration);
 263
 264                        if (current_and_HEAD &&
 265                            decoration->type == DECORATION_REF_HEAD) {
 266                                strbuf_addstr(sb, " -> ");
 267                                strbuf_addstr(sb, color_reset);
 268                                strbuf_addstr(sb, decorate_get_color(use_color, current_and_HEAD->type));
 269                                show_name(sb, current_and_HEAD);
 270                        }
 271                        strbuf_addstr(sb, color_reset);
 272
 273                        prefix = separator;
 274                }
 275                decoration = decoration->next;
 276        }
 277        strbuf_addstr(sb, color_commit);
 278        strbuf_addstr(sb, suffix);
 279        strbuf_addstr(sb, color_reset);
 280}
 281
 282void show_decorations(struct rev_info *opt, struct commit *commit)
 283{
 284        struct strbuf sb = STRBUF_INIT;
 285
 286        if (opt->sources) {
 287                char **slot = revision_sources_peek(opt->sources, commit);
 288
 289                if (slot && *slot)
 290                        fprintf(opt->diffopt.file, "\t%s", *slot);
 291        }
 292        if (!opt->show_decorations)
 293                return;
 294        format_decorations(&sb, commit, opt->diffopt.use_color);
 295        fputs(sb.buf, opt->diffopt.file);
 296        strbuf_release(&sb);
 297}
 298
 299static unsigned int digits_in_number(unsigned int number)
 300{
 301        unsigned int i = 10, result = 1;
 302        while (i <= number) {
 303                i *= 10;
 304                result++;
 305        }
 306        return result;
 307}
 308
 309void fmt_output_subject(struct strbuf *filename,
 310                        const char *subject,
 311                        struct rev_info *info)
 312{
 313        const char *suffix = info->patch_suffix;
 314        int nr = info->nr;
 315        int start_len = filename->len;
 316        int max_len = start_len + FORMAT_PATCH_NAME_MAX - (strlen(suffix) + 1);
 317
 318        if (0 < info->reroll_count)
 319                strbuf_addf(filename, "v%d-", info->reroll_count);
 320        strbuf_addf(filename, "%04d-%s", nr, subject);
 321
 322        if (max_len < filename->len)
 323                strbuf_setlen(filename, max_len);
 324        strbuf_addstr(filename, suffix);
 325}
 326
 327void fmt_output_commit(struct strbuf *filename,
 328                       struct commit *commit,
 329                       struct rev_info *info)
 330{
 331        struct pretty_print_context ctx = {0};
 332        struct strbuf subject = STRBUF_INIT;
 333
 334        format_commit_message(commit, "%f", &subject, &ctx);
 335        fmt_output_subject(filename, subject.buf, info);
 336        strbuf_release(&subject);
 337}
 338
 339void fmt_output_email_subject(struct strbuf *sb, struct rev_info *opt)
 340{
 341        if (opt->total > 0) {
 342                strbuf_addf(sb, "Subject: [%s%s%0*d/%d] ",
 343                            opt->subject_prefix,
 344                            *opt->subject_prefix ? " " : "",
 345                            digits_in_number(opt->total),
 346                            opt->nr, opt->total);
 347        } else if (opt->total == 0 && opt->subject_prefix && *opt->subject_prefix) {
 348                strbuf_addf(sb, "Subject: [%s] ",
 349                            opt->subject_prefix);
 350        } else {
 351                strbuf_addstr(sb, "Subject: ");
 352        }
 353}
 354
 355void log_write_email_headers(struct rev_info *opt, struct commit *commit,
 356                             const char **extra_headers_p,
 357                             int *need_8bit_cte_p,
 358                             int maybe_multipart)
 359{
 360        const char *extra_headers = opt->extra_headers;
 361        const char *name = oid_to_hex(opt->zero_commit ?
 362                                      &null_oid : &commit->object.oid);
 363
 364        *need_8bit_cte_p = 0; /* unknown */
 365
 366        fprintf(opt->diffopt.file, "From %s Mon Sep 17 00:00:00 2001\n", name);
 367        graph_show_oneline(opt->graph);
 368        if (opt->message_id) {
 369                fprintf(opt->diffopt.file, "Message-Id: <%s>\n", opt->message_id);
 370                graph_show_oneline(opt->graph);
 371        }
 372        if (opt->ref_message_ids && opt->ref_message_ids->nr > 0) {
 373                int i, n;
 374                n = opt->ref_message_ids->nr;
 375                fprintf(opt->diffopt.file, "In-Reply-To: <%s>\n", opt->ref_message_ids->items[n-1].string);
 376                for (i = 0; i < n; i++)
 377                        fprintf(opt->diffopt.file, "%s<%s>\n", (i > 0 ? "\t" : "References: "),
 378                               opt->ref_message_ids->items[i].string);
 379                graph_show_oneline(opt->graph);
 380        }
 381        if (opt->mime_boundary && maybe_multipart) {
 382                static struct strbuf subject_buffer = STRBUF_INIT;
 383                static struct strbuf buffer = STRBUF_INIT;
 384                struct strbuf filename =  STRBUF_INIT;
 385                *need_8bit_cte_p = -1; /* NEVER */
 386
 387                strbuf_reset(&subject_buffer);
 388                strbuf_reset(&buffer);
 389
 390                strbuf_addf(&subject_buffer,
 391                         "%s"
 392                         "MIME-Version: 1.0\n"
 393                         "Content-Type: multipart/mixed;"
 394                         " boundary=\"%s%s\"\n"
 395                         "\n"
 396                         "This is a multi-part message in MIME "
 397                         "format.\n"
 398                         "--%s%s\n"
 399                         "Content-Type: text/plain; "
 400                         "charset=UTF-8; format=fixed\n"
 401                         "Content-Transfer-Encoding: 8bit\n\n",
 402                         extra_headers ? extra_headers : "",
 403                         mime_boundary_leader, opt->mime_boundary,
 404                         mime_boundary_leader, opt->mime_boundary);
 405                extra_headers = subject_buffer.buf;
 406
 407                if (opt->numbered_files)
 408                        strbuf_addf(&filename, "%d", opt->nr);
 409                else
 410                        fmt_output_commit(&filename, commit, opt);
 411                strbuf_addf(&buffer,
 412                         "\n--%s%s\n"
 413                         "Content-Type: text/x-patch;"
 414                         " name=\"%s\"\n"
 415                         "Content-Transfer-Encoding: 8bit\n"
 416                         "Content-Disposition: %s;"
 417                         " filename=\"%s\"\n\n",
 418                         mime_boundary_leader, opt->mime_boundary,
 419                         filename.buf,
 420                         opt->no_inline ? "attachment" : "inline",
 421                         filename.buf);
 422                opt->diffopt.stat_sep = buffer.buf;
 423                strbuf_release(&filename);
 424        }
 425        *extra_headers_p = extra_headers;
 426}
 427
 428static void show_sig_lines(struct rev_info *opt, int status, const char *bol)
 429{
 430        const char *color, *reset, *eol;
 431
 432        color = diff_get_color_opt(&opt->diffopt,
 433                                   status ? DIFF_WHITESPACE : DIFF_FRAGINFO);
 434        reset = diff_get_color_opt(&opt->diffopt, DIFF_RESET);
 435        while (*bol) {
 436                eol = strchrnul(bol, '\n');
 437                fprintf(opt->diffopt.file, "%s%.*s%s%s", color, (int)(eol - bol), bol, reset,
 438                       *eol ? "\n" : "");
 439                graph_show_oneline(opt->graph);
 440                bol = (*eol) ? (eol + 1) : eol;
 441        }
 442}
 443
 444static void show_signature(struct rev_info *opt, struct commit *commit)
 445{
 446        struct strbuf payload = STRBUF_INIT;
 447        struct strbuf signature = STRBUF_INIT;
 448        struct strbuf gpg_output = STRBUF_INIT;
 449        int status;
 450
 451        if (parse_signed_commit(commit, &payload, &signature) <= 0)
 452                goto out;
 453
 454        status = verify_signed_buffer(payload.buf, payload.len,
 455                                      signature.buf, signature.len,
 456                                      &gpg_output, NULL);
 457        if (status && !gpg_output.len)
 458                strbuf_addstr(&gpg_output, "No signature\n");
 459
 460        show_sig_lines(opt, status, gpg_output.buf);
 461
 462 out:
 463        strbuf_release(&gpg_output);
 464        strbuf_release(&payload);
 465        strbuf_release(&signature);
 466}
 467
 468static int which_parent(const struct object_id *oid, const struct commit *commit)
 469{
 470        int nth;
 471        const struct commit_list *parent;
 472
 473        for (nth = 0, parent = commit->parents; parent; parent = parent->next) {
 474                if (!oidcmp(&parent->item->object.oid, oid))
 475                        return nth;
 476                nth++;
 477        }
 478        return -1;
 479}
 480
 481static int is_common_merge(const struct commit *commit)
 482{
 483        return (commit->parents
 484                && commit->parents->next
 485                && !commit->parents->next->next);
 486}
 487
 488static int show_one_mergetag(struct commit *commit,
 489                             struct commit_extra_header *extra,
 490                             void *data)
 491{
 492        struct rev_info *opt = (struct rev_info *)data;
 493        struct object_id oid;
 494        struct tag *tag;
 495        struct strbuf verify_message;
 496        int status, nth;
 497        size_t payload_size, gpg_message_offset;
 498
 499        hash_object_file(extra->value, extra->len, type_name(OBJ_TAG), &oid);
 500        tag = lookup_tag(&oid);
 501        if (!tag)
 502                return -1; /* error message already given */
 503
 504        strbuf_init(&verify_message, 256);
 505        if (parse_tag_buffer(tag, extra->value, extra->len))
 506                strbuf_addstr(&verify_message, "malformed mergetag\n");
 507        else if (is_common_merge(commit) &&
 508                 !oidcmp(&tag->tagged->oid,
 509                          &commit->parents->next->item->object.oid))
 510                strbuf_addf(&verify_message,
 511                            "merged tag '%s'\n", tag->tag);
 512        else if ((nth = which_parent(&tag->tagged->oid, commit)) < 0)
 513                strbuf_addf(&verify_message, "tag %s names a non-parent %s\n",
 514                                    tag->tag, tag->tagged->oid.hash);
 515        else
 516                strbuf_addf(&verify_message,
 517                            "parent #%d, tagged '%s'\n", nth + 1, tag->tag);
 518        gpg_message_offset = verify_message.len;
 519
 520        payload_size = parse_signature(extra->value, extra->len);
 521        status = -1;
 522        if (extra->len > payload_size) {
 523                /* could have a good signature */
 524                if (!verify_signed_buffer(extra->value, payload_size,
 525                                          extra->value + payload_size,
 526                                          extra->len - payload_size,
 527                                          &verify_message, NULL))
 528                        status = 0; /* good */
 529                else if (verify_message.len <= gpg_message_offset)
 530                        strbuf_addstr(&verify_message, "No signature\n");
 531                /* otherwise we couldn't verify, which is shown as bad */
 532        }
 533
 534        show_sig_lines(opt, status, verify_message.buf);
 535        strbuf_release(&verify_message);
 536        return 0;
 537}
 538
 539static int show_mergetag(struct rev_info *opt, struct commit *commit)
 540{
 541        return for_each_mergetag(show_one_mergetag, commit, opt);
 542}
 543
 544static void next_commentary_block(struct rev_info *opt, struct strbuf *sb)
 545{
 546        const char *x = opt->shown_dashes ? "\n" : "---\n";
 547        if (sb)
 548                strbuf_addstr(sb, x);
 549        else
 550                fputs(x, opt->diffopt.file);
 551        opt->shown_dashes = 1;
 552}
 553
 554void show_log(struct rev_info *opt)
 555{
 556        struct strbuf msgbuf = STRBUF_INIT;
 557        struct log_info *log = opt->loginfo;
 558        struct commit *commit = log->commit, *parent = log->parent;
 559        int abbrev_commit = opt->abbrev_commit ? opt->abbrev : GIT_SHA1_HEXSZ;
 560        const char *extra_headers = opt->extra_headers;
 561        struct pretty_print_context ctx = {0};
 562
 563        opt->loginfo = NULL;
 564        if (!opt->verbose_header) {
 565                graph_show_commit(opt->graph);
 566
 567                if (!opt->graph)
 568                        put_revision_mark(opt, commit);
 569                fputs(find_unique_abbrev(&commit->object.oid, abbrev_commit), opt->diffopt.file);
 570                if (opt->print_parents)
 571                        show_parents(commit, abbrev_commit, opt->diffopt.file);
 572                if (opt->children.name)
 573                        show_children(opt, commit, abbrev_commit);
 574                show_decorations(opt, commit);
 575                if (opt->graph && !graph_is_commit_finished(opt->graph)) {
 576                        putc('\n', opt->diffopt.file);
 577                        graph_show_remainder(opt->graph);
 578                }
 579                putc(opt->diffopt.line_termination, opt->diffopt.file);
 580                return;
 581        }
 582
 583        /*
 584         * If use_terminator is set, we already handled any record termination
 585         * at the end of the last record.
 586         * Otherwise, add a diffopt.line_termination character before all
 587         * entries but the first.  (IOW, as a separator between entries)
 588         */
 589        if (opt->shown_one && !opt->use_terminator) {
 590                /*
 591                 * If entries are separated by a newline, the output
 592                 * should look human-readable.  If the last entry ended
 593                 * with a newline, print the graph output before this
 594                 * newline.  Otherwise it will end up as a completely blank
 595                 * line and will look like a gap in the graph.
 596                 *
 597                 * If the entry separator is not a newline, the output is
 598                 * primarily intended for programmatic consumption, and we
 599                 * never want the extra graph output before the entry
 600                 * separator.
 601                 */
 602                if (opt->diffopt.line_termination == '\n' &&
 603                    !opt->missing_newline)
 604                        graph_show_padding(opt->graph);
 605                putc(opt->diffopt.line_termination, opt->diffopt.file);
 606        }
 607        opt->shown_one = 1;
 608
 609        /*
 610         * If the history graph was requested,
 611         * print the graph, up to this commit's line
 612         */
 613        graph_show_commit(opt->graph);
 614
 615        /*
 616         * Print header line of header..
 617         */
 618
 619        if (cmit_fmt_is_mail(opt->commit_format)) {
 620                log_write_email_headers(opt, commit, &extra_headers,
 621                                        &ctx.need_8bit_cte, 1);
 622                ctx.rev = opt;
 623                ctx.print_email_subject = 1;
 624        } else if (opt->commit_format != CMIT_FMT_USERFORMAT) {
 625                fputs(diff_get_color_opt(&opt->diffopt, DIFF_COMMIT), opt->diffopt.file);
 626                if (opt->commit_format != CMIT_FMT_ONELINE)
 627                        fputs("commit ", opt->diffopt.file);
 628
 629                if (!opt->graph)
 630                        put_revision_mark(opt, commit);
 631                fputs(find_unique_abbrev(&commit->object.oid,
 632                                         abbrev_commit),
 633                      opt->diffopt.file);
 634                if (opt->print_parents)
 635                        show_parents(commit, abbrev_commit, opt->diffopt.file);
 636                if (opt->children.name)
 637                        show_children(opt, commit, abbrev_commit);
 638                if (parent)
 639                        fprintf(opt->diffopt.file, " (from %s)",
 640                               find_unique_abbrev(&parent->object.oid, abbrev_commit));
 641                fputs(diff_get_color_opt(&opt->diffopt, DIFF_RESET), opt->diffopt.file);
 642                show_decorations(opt, commit);
 643                if (opt->commit_format == CMIT_FMT_ONELINE) {
 644                        putc(' ', opt->diffopt.file);
 645                } else {
 646                        putc('\n', opt->diffopt.file);
 647                        graph_show_oneline(opt->graph);
 648                }
 649                if (opt->reflog_info) {
 650                        /*
 651                         * setup_revisions() ensures that opt->reflog_info
 652                         * and opt->graph cannot both be set,
 653                         * so we don't need to worry about printing the
 654                         * graph info here.
 655                         */
 656                        show_reflog_message(opt->reflog_info,
 657                                            opt->commit_format == CMIT_FMT_ONELINE,
 658                                            &opt->date_mode,
 659                                            opt->date_mode_explicit);
 660                        if (opt->commit_format == CMIT_FMT_ONELINE)
 661                                return;
 662                }
 663        }
 664
 665        if (opt->show_signature) {
 666                show_signature(opt, commit);
 667                show_mergetag(opt, commit);
 668        }
 669
 670        if (opt->show_notes) {
 671                int raw;
 672                struct strbuf notebuf = STRBUF_INIT;
 673
 674                raw = (opt->commit_format == CMIT_FMT_USERFORMAT);
 675                format_display_notes(&commit->object.oid, &notebuf,
 676                                     get_log_output_encoding(), raw);
 677                ctx.notes_message = notebuf.len
 678                        ? strbuf_detach(&notebuf, NULL)
 679                        : xcalloc(1, 1);
 680        }
 681
 682        /*
 683         * And then the pretty-printed message itself
 684         */
 685        if (ctx.need_8bit_cte >= 0 && opt->add_signoff)
 686                ctx.need_8bit_cte =
 687                        has_non_ascii(fmt_name(getenv("GIT_COMMITTER_NAME"),
 688                                               getenv("GIT_COMMITTER_EMAIL")));
 689        ctx.date_mode = opt->date_mode;
 690        ctx.date_mode_explicit = opt->date_mode_explicit;
 691        ctx.abbrev = opt->diffopt.abbrev;
 692        ctx.after_subject = extra_headers;
 693        ctx.preserve_subject = opt->preserve_subject;
 694        ctx.reflog_info = opt->reflog_info;
 695        ctx.fmt = opt->commit_format;
 696        ctx.mailmap = opt->mailmap;
 697        ctx.color = opt->diffopt.use_color;
 698        ctx.expand_tabs_in_log = opt->expand_tabs_in_log;
 699        ctx.output_encoding = get_log_output_encoding();
 700        if (opt->from_ident.mail_begin && opt->from_ident.name_begin)
 701                ctx.from_ident = &opt->from_ident;
 702        if (opt->graph)
 703                ctx.graph_width = graph_width(opt->graph);
 704        pretty_print_commit(&ctx, commit, &msgbuf);
 705
 706        if (opt->add_signoff)
 707                append_signoff(&msgbuf, 0, APPEND_SIGNOFF_DEDUP);
 708
 709        if ((ctx.fmt != CMIT_FMT_USERFORMAT) &&
 710            ctx.notes_message && *ctx.notes_message) {
 711                if (cmit_fmt_is_mail(ctx.fmt))
 712                        next_commentary_block(opt, &msgbuf);
 713                strbuf_addstr(&msgbuf, ctx.notes_message);
 714        }
 715
 716        if (opt->show_log_size) {
 717                fprintf(opt->diffopt.file, "log size %i\n", (int)msgbuf.len);
 718                graph_show_oneline(opt->graph);
 719        }
 720
 721        /*
 722         * Set opt->missing_newline if msgbuf doesn't
 723         * end in a newline (including if it is empty)
 724         */
 725        if (!msgbuf.len || msgbuf.buf[msgbuf.len - 1] != '\n')
 726                opt->missing_newline = 1;
 727        else
 728                opt->missing_newline = 0;
 729
 730        graph_show_commit_msg(opt->graph, opt->diffopt.file, &msgbuf);
 731        if (opt->use_terminator && !commit_format_is_empty(opt->commit_format)) {
 732                if (!opt->missing_newline)
 733                        graph_show_padding(opt->graph);
 734                putc(opt->diffopt.line_termination, opt->diffopt.file);
 735        }
 736
 737        strbuf_release(&msgbuf);
 738        free(ctx.notes_message);
 739}
 740
 741int log_tree_diff_flush(struct rev_info *opt)
 742{
 743        opt->shown_dashes = 0;
 744        diffcore_std(&opt->diffopt);
 745
 746        if (diff_queue_is_empty()) {
 747                int saved_fmt = opt->diffopt.output_format;
 748                opt->diffopt.output_format = DIFF_FORMAT_NO_OUTPUT;
 749                diff_flush(&opt->diffopt);
 750                opt->diffopt.output_format = saved_fmt;
 751                return 0;
 752        }
 753
 754        if (opt->loginfo && !opt->no_commit_id) {
 755                show_log(opt);
 756                if ((opt->diffopt.output_format & ~DIFF_FORMAT_NO_OUTPUT) &&
 757                    opt->verbose_header &&
 758                    opt->commit_format != CMIT_FMT_ONELINE &&
 759                    !commit_format_is_empty(opt->commit_format)) {
 760                        /*
 761                         * When showing a verbose header (i.e. log message),
 762                         * and not in --pretty=oneline format, we would want
 763                         * an extra newline between the end of log and the
 764                         * diff/diffstat output for readability.
 765                         */
 766                        int pch = DIFF_FORMAT_DIFFSTAT | DIFF_FORMAT_PATCH;
 767                        if (opt->diffopt.output_prefix) {
 768                                struct strbuf *msg = NULL;
 769                                msg = opt->diffopt.output_prefix(&opt->diffopt,
 770                                        opt->diffopt.output_prefix_data);
 771                                fwrite(msg->buf, msg->len, 1, opt->diffopt.file);
 772                        }
 773
 774                        /*
 775                         * We may have shown three-dashes line early
 776                         * between generated commentary (notes, etc.)
 777                         * and the log message, in which case we only
 778                         * want a blank line after the commentary
 779                         * without (an extra) three-dashes line.
 780                         * Otherwise, we show the three-dashes line if
 781                         * we are showing the patch with diffstat, but
 782                         * in that case, there is no extra blank line
 783                         * after the three-dashes line.
 784                         */
 785                        if (!opt->shown_dashes &&
 786                            (pch & opt->diffopt.output_format) == pch)
 787                                fprintf(opt->diffopt.file, "---");
 788                        putc('\n', opt->diffopt.file);
 789                }
 790        }
 791        diff_flush(&opt->diffopt);
 792        return 1;
 793}
 794
 795static int do_diff_combined(struct rev_info *opt, struct commit *commit)
 796{
 797        diff_tree_combined_merge(commit, opt->dense_combined_merges, opt);
 798        return !opt->loginfo;
 799}
 800
 801/*
 802 * Show the diff of a commit.
 803 *
 804 * Return true if we printed any log info messages
 805 */
 806static int log_tree_diff(struct rev_info *opt, struct commit *commit, struct log_info *log)
 807{
 808        int showed_log;
 809        struct commit_list *parents;
 810        struct object_id *oid;
 811
 812        if (!opt->diff && !opt->diffopt.flags.exit_with_status)
 813                return 0;
 814
 815        parse_commit_or_die(commit);
 816        oid = get_commit_tree_oid(commit);
 817
 818        /* Root commit? */
 819        parents = get_saved_parents(opt, commit);
 820        if (!parents) {
 821                if (opt->show_root_diff) {
 822                        diff_root_tree_oid(oid, "", &opt->diffopt);
 823                        log_tree_diff_flush(opt);
 824                }
 825                return !opt->loginfo;
 826        }
 827
 828        /* More than one parent? */
 829        if (parents && parents->next) {
 830                if (opt->ignore_merges)
 831                        return 0;
 832                else if (opt->combine_merges)
 833                        return do_diff_combined(opt, commit);
 834                else if (opt->first_parent_only) {
 835                        /*
 836                         * Generate merge log entry only for the first
 837                         * parent, showing summary diff of the others
 838                         * we merged _in_.
 839                         */
 840                        parse_commit_or_die(parents->item);
 841                        diff_tree_oid(get_commit_tree_oid(parents->item),
 842                                      oid, "", &opt->diffopt);
 843                        log_tree_diff_flush(opt);
 844                        return !opt->loginfo;
 845                }
 846
 847                /* If we show individual diffs, show the parent info */
 848                log->parent = parents->item;
 849        }
 850
 851        showed_log = 0;
 852        for (;;) {
 853                struct commit *parent = parents->item;
 854
 855                parse_commit_or_die(parent);
 856                diff_tree_oid(get_commit_tree_oid(parent),
 857                              oid, "", &opt->diffopt);
 858                log_tree_diff_flush(opt);
 859
 860                showed_log |= !opt->loginfo;
 861
 862                /* Set up the log info for the next parent, if any.. */
 863                parents = parents->next;
 864                if (!parents)
 865                        break;
 866                log->parent = parents->item;
 867                opt->loginfo = log;
 868        }
 869        return showed_log;
 870}
 871
 872int log_tree_commit(struct rev_info *opt, struct commit *commit)
 873{
 874        struct log_info log;
 875        int shown, close_file = opt->diffopt.close_file;
 876
 877        log.commit = commit;
 878        log.parent = NULL;
 879        opt->loginfo = &log;
 880        opt->diffopt.close_file = 0;
 881
 882        if (opt->line_level_traverse)
 883                return line_log_print(opt, commit);
 884
 885        if (opt->track_linear && !opt->linear && !opt->reverse_output_stage)
 886                fprintf(opt->diffopt.file, "\n%s\n", opt->break_bar);
 887        shown = log_tree_diff(opt, commit, &log);
 888        if (!shown && opt->loginfo && opt->always_show_header) {
 889                log.parent = NULL;
 890                show_log(opt);
 891                shown = 1;
 892        }
 893        if (opt->track_linear && !opt->linear && opt->reverse_output_stage)
 894                fprintf(opt->diffopt.file, "\n%s\n", opt->break_bar);
 895        opt->loginfo = NULL;
 896        maybe_flush_or_die(opt->diffopt.file, "stdout");
 897        if (close_file)
 898                fclose(opt->diffopt.file);
 899        return shown;
 900}