builtin / merge.con commit Merge branch 'rd/p4-doc-markup-env' (c45505d)
   1/*
   2 * Builtin "git merge"
   3 *
   4 * Copyright (c) 2008 Miklos Vajna <vmiklos@frugalware.org>
   5 *
   6 * Based on git-merge.sh by Junio C Hamano.
   7 */
   8
   9#include "cache.h"
  10#include "config.h"
  11#include "parse-options.h"
  12#include "builtin.h"
  13#include "lockfile.h"
  14#include "run-command.h"
  15#include "diff.h"
  16#include "refs.h"
  17#include "refspec.h"
  18#include "commit.h"
  19#include "diffcore.h"
  20#include "revision.h"
  21#include "unpack-trees.h"
  22#include "cache-tree.h"
  23#include "dir.h"
  24#include "utf8.h"
  25#include "log-tree.h"
  26#include "color.h"
  27#include "rerere.h"
  28#include "help.h"
  29#include "merge-recursive.h"
  30#include "resolve-undo.h"
  31#include "remote.h"
  32#include "fmt-merge-msg.h"
  33#include "gpg-interface.h"
  34#include "sequencer.h"
  35#include "string-list.h"
  36#include "packfile.h"
  37#include "tag.h"
  38#include "alias.h"
  39
  40#define DEFAULT_TWOHEAD (1<<0)
  41#define DEFAULT_OCTOPUS (1<<1)
  42#define NO_FAST_FORWARD (1<<2)
  43#define NO_TRIVIAL      (1<<3)
  44
  45struct strategy {
  46        const char *name;
  47        unsigned attr;
  48};
  49
  50static const char * const builtin_merge_usage[] = {
  51        N_("git merge [<options>] [<commit>...]"),
  52        N_("git merge --abort"),
  53        N_("git merge --continue"),
  54        NULL
  55};
  56
  57static int show_diffstat = 1, shortlog_len = -1, squash;
  58static int option_commit = 1;
  59static int option_edit = -1;
  60static int allow_trivial = 1, have_message, verify_signatures;
  61static int overwrite_ignore = 1;
  62static struct strbuf merge_msg = STRBUF_INIT;
  63static struct strategy **use_strategies;
  64static size_t use_strategies_nr, use_strategies_alloc;
  65static const char **xopts;
  66static size_t xopts_nr, xopts_alloc;
  67static const char *branch;
  68static char *branch_mergeoptions;
  69static int option_renormalize;
  70static int verbosity;
  71static int allow_rerere_auto;
  72static int abort_current_merge;
  73static int continue_current_merge;
  74static int allow_unrelated_histories;
  75static int show_progress = -1;
  76static int default_to_upstream = 1;
  77static int signoff;
  78static const char *sign_commit;
  79static int verify_msg = 1;
  80
  81static struct strategy all_strategy[] = {
  82        { "recursive",  DEFAULT_TWOHEAD | NO_TRIVIAL },
  83        { "octopus",    DEFAULT_OCTOPUS },
  84        { "resolve",    0 },
  85        { "ours",       NO_FAST_FORWARD | NO_TRIVIAL },
  86        { "subtree",    NO_FAST_FORWARD | NO_TRIVIAL },
  87};
  88
  89static const char *pull_twohead, *pull_octopus;
  90
  91enum ff_type {
  92        FF_NO,
  93        FF_ALLOW,
  94        FF_ONLY
  95};
  96
  97static enum ff_type fast_forward = FF_ALLOW;
  98
  99static int option_parse_message(const struct option *opt,
 100                                const char *arg, int unset)
 101{
 102        struct strbuf *buf = opt->value;
 103
 104        if (unset)
 105                strbuf_setlen(buf, 0);
 106        else if (arg) {
 107                strbuf_addf(buf, "%s%s", buf->len ? "\n\n" : "", arg);
 108                have_message = 1;
 109        } else
 110                return error(_("switch `m' requires a value"));
 111        return 0;
 112}
 113
 114static struct strategy *get_strategy(const char *name)
 115{
 116        int i;
 117        struct strategy *ret;
 118        static struct cmdnames main_cmds, other_cmds;
 119        static int loaded;
 120
 121        if (!name)
 122                return NULL;
 123
 124        for (i = 0; i < ARRAY_SIZE(all_strategy); i++)
 125                if (!strcmp(name, all_strategy[i].name))
 126                        return &all_strategy[i];
 127
 128        if (!loaded) {
 129                struct cmdnames not_strategies;
 130                loaded = 1;
 131
 132                memset(&not_strategies, 0, sizeof(struct cmdnames));
 133                load_command_list("git-merge-", &main_cmds, &other_cmds);
 134                for (i = 0; i < main_cmds.cnt; i++) {
 135                        int j, found = 0;
 136                        struct cmdname *ent = main_cmds.names[i];
 137                        for (j = 0; j < ARRAY_SIZE(all_strategy); j++)
 138                                if (!strncmp(ent->name, all_strategy[j].name, ent->len)
 139                                                && !all_strategy[j].name[ent->len])
 140                                        found = 1;
 141                        if (!found)
 142                                add_cmdname(&not_strategies, ent->name, ent->len);
 143                }
 144                exclude_cmds(&main_cmds, &not_strategies);
 145        }
 146        if (!is_in_cmdlist(&main_cmds, name) && !is_in_cmdlist(&other_cmds, name)) {
 147                fprintf(stderr, _("Could not find merge strategy '%s'.\n"), name);
 148                fprintf(stderr, _("Available strategies are:"));
 149                for (i = 0; i < main_cmds.cnt; i++)
 150                        fprintf(stderr, " %s", main_cmds.names[i]->name);
 151                fprintf(stderr, ".\n");
 152                if (other_cmds.cnt) {
 153                        fprintf(stderr, _("Available custom strategies are:"));
 154                        for (i = 0; i < other_cmds.cnt; i++)
 155                                fprintf(stderr, " %s", other_cmds.names[i]->name);
 156                        fprintf(stderr, ".\n");
 157                }
 158                exit(1);
 159        }
 160
 161        ret = xcalloc(1, sizeof(struct strategy));
 162        ret->name = xstrdup(name);
 163        ret->attr = NO_TRIVIAL;
 164        return ret;
 165}
 166
 167static void append_strategy(struct strategy *s)
 168{
 169        ALLOC_GROW(use_strategies, use_strategies_nr + 1, use_strategies_alloc);
 170        use_strategies[use_strategies_nr++] = s;
 171}
 172
 173static int option_parse_strategy(const struct option *opt,
 174                                 const char *name, int unset)
 175{
 176        if (unset)
 177                return 0;
 178
 179        append_strategy(get_strategy(name));
 180        return 0;
 181}
 182
 183static int option_parse_x(const struct option *opt,
 184                          const char *arg, int unset)
 185{
 186        if (unset)
 187                return 0;
 188
 189        ALLOC_GROW(xopts, xopts_nr + 1, xopts_alloc);
 190        xopts[xopts_nr++] = xstrdup(arg);
 191        return 0;
 192}
 193
 194static int option_parse_n(const struct option *opt,
 195                          const char *arg, int unset)
 196{
 197        show_diffstat = unset;
 198        return 0;
 199}
 200
 201static struct option builtin_merge_options[] = {
 202        { OPTION_CALLBACK, 'n', NULL, NULL, NULL,
 203                N_("do not show a diffstat at the end of the merge"),
 204                PARSE_OPT_NOARG, option_parse_n },
 205        OPT_BOOL(0, "stat", &show_diffstat,
 206                N_("show a diffstat at the end of the merge")),
 207        OPT_BOOL(0, "summary", &show_diffstat, N_("(synonym to --stat)")),
 208        { OPTION_INTEGER, 0, "log", &shortlog_len, N_("n"),
 209          N_("add (at most <n>) entries from shortlog to merge commit message"),
 210          PARSE_OPT_OPTARG, NULL, DEFAULT_MERGE_LOG_LEN },
 211        OPT_BOOL(0, "squash", &squash,
 212                N_("create a single commit instead of doing a merge")),
 213        OPT_BOOL(0, "commit", &option_commit,
 214                N_("perform a commit if the merge succeeds (default)")),
 215        OPT_BOOL('e', "edit", &option_edit,
 216                N_("edit message before committing")),
 217        OPT_SET_INT(0, "ff", &fast_forward, N_("allow fast-forward (default)"), FF_ALLOW),
 218        OPT_SET_INT_F(0, "ff-only", &fast_forward,
 219                      N_("abort if fast-forward is not possible"),
 220                      FF_ONLY, PARSE_OPT_NONEG),
 221        OPT_RERERE_AUTOUPDATE(&allow_rerere_auto),
 222        OPT_BOOL(0, "verify-signatures", &verify_signatures,
 223                N_("verify that the named commit has a valid GPG signature")),
 224        OPT_CALLBACK('s', "strategy", &use_strategies, N_("strategy"),
 225                N_("merge strategy to use"), option_parse_strategy),
 226        OPT_CALLBACK('X', "strategy-option", &xopts, N_("option=value"),
 227                N_("option for selected merge strategy"), option_parse_x),
 228        OPT_CALLBACK('m', "message", &merge_msg, N_("message"),
 229                N_("merge commit message (for a non-fast-forward merge)"),
 230                option_parse_message),
 231        OPT__VERBOSITY(&verbosity),
 232        OPT_BOOL(0, "abort", &abort_current_merge,
 233                N_("abort the current in-progress merge")),
 234        OPT_BOOL(0, "continue", &continue_current_merge,
 235                N_("continue the current in-progress merge")),
 236        OPT_BOOL(0, "allow-unrelated-histories", &allow_unrelated_histories,
 237                 N_("allow merging unrelated histories")),
 238        OPT_SET_INT(0, "progress", &show_progress, N_("force progress reporting"), 1),
 239        { OPTION_STRING, 'S', "gpg-sign", &sign_commit, N_("key-id"),
 240          N_("GPG sign commit"), PARSE_OPT_OPTARG, NULL, (intptr_t) "" },
 241        OPT_BOOL(0, "overwrite-ignore", &overwrite_ignore, N_("update ignored files (default)")),
 242        OPT_BOOL(0, "signoff", &signoff, N_("add Signed-off-by:")),
 243        OPT_BOOL(0, "verify", &verify_msg, N_("verify commit-msg hook")),
 244        OPT_END()
 245};
 246
 247/* Cleans up metadata that is uninteresting after a succeeded merge. */
 248static void drop_save(void)
 249{
 250        unlink(git_path_merge_head());
 251        unlink(git_path_merge_msg());
 252        unlink(git_path_merge_mode());
 253}
 254
 255static int save_state(struct object_id *stash)
 256{
 257        int len;
 258        struct child_process cp = CHILD_PROCESS_INIT;
 259        struct strbuf buffer = STRBUF_INIT;
 260        const char *argv[] = {"stash", "create", NULL};
 261        int rc = -1;
 262
 263        cp.argv = argv;
 264        cp.out = -1;
 265        cp.git_cmd = 1;
 266
 267        if (start_command(&cp))
 268                die(_("could not run stash."));
 269        len = strbuf_read(&buffer, cp.out, 1024);
 270        close(cp.out);
 271
 272        if (finish_command(&cp) || len < 0)
 273                die(_("stash failed"));
 274        else if (!len)          /* no changes */
 275                goto out;
 276        strbuf_setlen(&buffer, buffer.len-1);
 277        if (get_oid(buffer.buf, stash))
 278                die(_("not a valid object: %s"), buffer.buf);
 279        rc = 0;
 280out:
 281        strbuf_release(&buffer);
 282        return rc;
 283}
 284
 285static void read_empty(const struct object_id *oid, int verbose)
 286{
 287        int i = 0;
 288        const char *args[7];
 289
 290        args[i++] = "read-tree";
 291        if (verbose)
 292                args[i++] = "-v";
 293        args[i++] = "-m";
 294        args[i++] = "-u";
 295        args[i++] = empty_tree_oid_hex();
 296        args[i++] = oid_to_hex(oid);
 297        args[i] = NULL;
 298
 299        if (run_command_v_opt(args, RUN_GIT_CMD))
 300                die(_("read-tree failed"));
 301}
 302
 303static void reset_hard(const struct object_id *oid, int verbose)
 304{
 305        int i = 0;
 306        const char *args[6];
 307
 308        args[i++] = "read-tree";
 309        if (verbose)
 310                args[i++] = "-v";
 311        args[i++] = "--reset";
 312        args[i++] = "-u";
 313        args[i++] = oid_to_hex(oid);
 314        args[i] = NULL;
 315
 316        if (run_command_v_opt(args, RUN_GIT_CMD))
 317                die(_("read-tree failed"));
 318}
 319
 320static void restore_state(const struct object_id *head,
 321                          const struct object_id *stash)
 322{
 323        struct strbuf sb = STRBUF_INIT;
 324        const char *args[] = { "stash", "apply", NULL, NULL };
 325
 326        if (is_null_oid(stash))
 327                return;
 328
 329        reset_hard(head, 1);
 330
 331        args[2] = oid_to_hex(stash);
 332
 333        /*
 334         * It is OK to ignore error here, for example when there was
 335         * nothing to restore.
 336         */
 337        run_command_v_opt(args, RUN_GIT_CMD);
 338
 339        strbuf_release(&sb);
 340        refresh_cache(REFRESH_QUIET);
 341}
 342
 343/* This is called when no merge was necessary. */
 344static void finish_up_to_date(const char *msg)
 345{
 346        if (verbosity >= 0)
 347                printf("%s%s\n", squash ? _(" (nothing to squash)") : "", msg);
 348        drop_save();
 349}
 350
 351static void squash_message(struct commit *commit, struct commit_list *remoteheads)
 352{
 353        struct rev_info rev;
 354        struct strbuf out = STRBUF_INIT;
 355        struct commit_list *j;
 356        struct pretty_print_context ctx = {0};
 357
 358        printf(_("Squash commit -- not updating HEAD\n"));
 359
 360        init_revisions(&rev, NULL);
 361        rev.ignore_merges = 1;
 362        rev.commit_format = CMIT_FMT_MEDIUM;
 363
 364        commit->object.flags |= UNINTERESTING;
 365        add_pending_object(&rev, &commit->object, NULL);
 366
 367        for (j = remoteheads; j; j = j->next)
 368                add_pending_object(&rev, &j->item->object, NULL);
 369
 370        setup_revisions(0, NULL, &rev, NULL);
 371        if (prepare_revision_walk(&rev))
 372                die(_("revision walk setup failed"));
 373
 374        ctx.abbrev = rev.abbrev;
 375        ctx.date_mode = rev.date_mode;
 376        ctx.fmt = rev.commit_format;
 377
 378        strbuf_addstr(&out, "Squashed commit of the following:\n");
 379        while ((commit = get_revision(&rev)) != NULL) {
 380                strbuf_addch(&out, '\n');
 381                strbuf_addf(&out, "commit %s\n",
 382                        oid_to_hex(&commit->object.oid));
 383                pretty_print_commit(&ctx, commit, &out);
 384        }
 385        write_file_buf(git_path_squash_msg(), out.buf, out.len);
 386        strbuf_release(&out);
 387}
 388
 389static void finish(struct commit *head_commit,
 390                   struct commit_list *remoteheads,
 391                   const struct object_id *new_head, const char *msg)
 392{
 393        struct strbuf reflog_message = STRBUF_INIT;
 394        const struct object_id *head = &head_commit->object.oid;
 395
 396        if (!msg)
 397                strbuf_addstr(&reflog_message, getenv("GIT_REFLOG_ACTION"));
 398        else {
 399                if (verbosity >= 0)
 400                        printf("%s\n", msg);
 401                strbuf_addf(&reflog_message, "%s: %s",
 402                        getenv("GIT_REFLOG_ACTION"), msg);
 403        }
 404        if (squash) {
 405                squash_message(head_commit, remoteheads);
 406        } else {
 407                if (verbosity >= 0 && !merge_msg.len)
 408                        printf(_("No merge message -- not updating HEAD\n"));
 409                else {
 410                        const char *argv_gc_auto[] = { "gc", "--auto", NULL };
 411                        update_ref(reflog_message.buf, "HEAD", new_head, head,
 412                                   0, UPDATE_REFS_DIE_ON_ERR);
 413                        /*
 414                         * We ignore errors in 'gc --auto', since the
 415                         * user should see them.
 416                         */
 417                        close_all_packs(the_repository->objects);
 418                        run_command_v_opt(argv_gc_auto, RUN_GIT_CMD);
 419                }
 420        }
 421        if (new_head && show_diffstat) {
 422                struct diff_options opts;
 423                diff_setup(&opts);
 424                opts.stat_width = -1; /* use full terminal width */
 425                opts.stat_graph_width = -1; /* respect statGraphWidth config */
 426                opts.output_format |=
 427                        DIFF_FORMAT_SUMMARY | DIFF_FORMAT_DIFFSTAT;
 428                opts.detect_rename = DIFF_DETECT_RENAME;
 429                diff_setup_done(&opts);
 430                diff_tree_oid(head, new_head, "", &opts);
 431                diffcore_std(&opts);
 432                diff_flush(&opts);
 433        }
 434
 435        /* Run a post-merge hook */
 436        run_hook_le(NULL, "post-merge", squash ? "1" : "0", NULL);
 437
 438        strbuf_release(&reflog_message);
 439}
 440
 441/* Get the name for the merge commit's message. */
 442static void merge_name(const char *remote, struct strbuf *msg)
 443{
 444        struct commit *remote_head;
 445        struct object_id branch_head;
 446        struct strbuf buf = STRBUF_INIT;
 447        struct strbuf bname = STRBUF_INIT;
 448        const char *ptr;
 449        char *found_ref;
 450        int len, early;
 451
 452        strbuf_branchname(&bname, remote, 0);
 453        remote = bname.buf;
 454
 455        oidclr(&branch_head);
 456        remote_head = get_merge_parent(remote);
 457        if (!remote_head)
 458                die(_("'%s' does not point to a commit"), remote);
 459
 460        if (dwim_ref(remote, strlen(remote), &branch_head, &found_ref) > 0) {
 461                if (starts_with(found_ref, "refs/heads/")) {
 462                        strbuf_addf(msg, "%s\t\tbranch '%s' of .\n",
 463                                    oid_to_hex(&branch_head), remote);
 464                        goto cleanup;
 465                }
 466                if (starts_with(found_ref, "refs/tags/")) {
 467                        strbuf_addf(msg, "%s\t\ttag '%s' of .\n",
 468                                    oid_to_hex(&branch_head), remote);
 469                        goto cleanup;
 470                }
 471                if (starts_with(found_ref, "refs/remotes/")) {
 472                        strbuf_addf(msg, "%s\t\tremote-tracking branch '%s' of .\n",
 473                                    oid_to_hex(&branch_head), remote);
 474                        goto cleanup;
 475                }
 476        }
 477
 478        /* See if remote matches <name>^^^.. or <name>~<number> */
 479        for (len = 0, ptr = remote + strlen(remote);
 480             remote < ptr && ptr[-1] == '^';
 481             ptr--)
 482                len++;
 483        if (len)
 484                early = 1;
 485        else {
 486                early = 0;
 487                ptr = strrchr(remote, '~');
 488                if (ptr) {
 489                        int seen_nonzero = 0;
 490
 491                        len++; /* count ~ */
 492                        while (*++ptr && isdigit(*ptr)) {
 493                                seen_nonzero |= (*ptr != '0');
 494                                len++;
 495                        }
 496                        if (*ptr)
 497                                len = 0; /* not ...~<number> */
 498                        else if (seen_nonzero)
 499                                early = 1;
 500                        else if (len == 1)
 501                                early = 1; /* "name~" is "name~1"! */
 502                }
 503        }
 504        if (len) {
 505                struct strbuf truname = STRBUF_INIT;
 506                strbuf_addf(&truname, "refs/heads/%s", remote);
 507                strbuf_setlen(&truname, truname.len - len);
 508                if (ref_exists(truname.buf)) {
 509                        strbuf_addf(msg,
 510                                    "%s\t\tbranch '%s'%s of .\n",
 511                                    oid_to_hex(&remote_head->object.oid),
 512                                    truname.buf + 11,
 513                                    (early ? " (early part)" : ""));
 514                        strbuf_release(&truname);
 515                        goto cleanup;
 516                }
 517                strbuf_release(&truname);
 518        }
 519
 520        if (remote_head->util) {
 521                struct merge_remote_desc *desc;
 522                desc = merge_remote_util(remote_head);
 523                if (desc && desc->obj && desc->obj->type == OBJ_TAG) {
 524                        strbuf_addf(msg, "%s\t\t%s '%s'\n",
 525                                    oid_to_hex(&desc->obj->oid),
 526                                    type_name(desc->obj->type),
 527                                    remote);
 528                        goto cleanup;
 529                }
 530        }
 531
 532        strbuf_addf(msg, "%s\t\tcommit '%s'\n",
 533                oid_to_hex(&remote_head->object.oid), remote);
 534cleanup:
 535        strbuf_release(&buf);
 536        strbuf_release(&bname);
 537}
 538
 539static void parse_branch_merge_options(char *bmo)
 540{
 541        const char **argv;
 542        int argc;
 543
 544        if (!bmo)
 545                return;
 546        argc = split_cmdline(bmo, &argv);
 547        if (argc < 0)
 548                die(_("Bad branch.%s.mergeoptions string: %s"), branch,
 549                    split_cmdline_strerror(argc));
 550        REALLOC_ARRAY(argv, argc + 2);
 551        MOVE_ARRAY(argv + 1, argv, argc + 1);
 552        argc++;
 553        argv[0] = "branch.*.mergeoptions";
 554        parse_options(argc, argv, NULL, builtin_merge_options,
 555                      builtin_merge_usage, 0);
 556        free(argv);
 557}
 558
 559static int git_merge_config(const char *k, const char *v, void *cb)
 560{
 561        int status;
 562
 563        if (branch && starts_with(k, "branch.") &&
 564                starts_with(k + 7, branch) &&
 565                !strcmp(k + 7 + strlen(branch), ".mergeoptions")) {
 566                free(branch_mergeoptions);
 567                branch_mergeoptions = xstrdup(v);
 568                return 0;
 569        }
 570
 571        if (!strcmp(k, "merge.diffstat") || !strcmp(k, "merge.stat"))
 572                show_diffstat = git_config_bool(k, v);
 573        else if (!strcmp(k, "merge.verifysignatures"))
 574                verify_signatures = git_config_bool(k, v);
 575        else if (!strcmp(k, "pull.twohead"))
 576                return git_config_string(&pull_twohead, k, v);
 577        else if (!strcmp(k, "pull.octopus"))
 578                return git_config_string(&pull_octopus, k, v);
 579        else if (!strcmp(k, "merge.renormalize"))
 580                option_renormalize = git_config_bool(k, v);
 581        else if (!strcmp(k, "merge.ff")) {
 582                int boolval = git_parse_maybe_bool(v);
 583                if (0 <= boolval) {
 584                        fast_forward = boolval ? FF_ALLOW : FF_NO;
 585                } else if (v && !strcmp(v, "only")) {
 586                        fast_forward = FF_ONLY;
 587                } /* do not barf on values from future versions of git */
 588                return 0;
 589        } else if (!strcmp(k, "merge.defaulttoupstream")) {
 590                default_to_upstream = git_config_bool(k, v);
 591                return 0;
 592        } else if (!strcmp(k, "commit.gpgsign")) {
 593                sign_commit = git_config_bool(k, v) ? "" : NULL;
 594                return 0;
 595        }
 596
 597        status = fmt_merge_msg_config(k, v, cb);
 598        if (status)
 599                return status;
 600        status = git_gpg_config(k, v, NULL);
 601        if (status)
 602                return status;
 603        return git_diff_ui_config(k, v, cb);
 604}
 605
 606static int read_tree_trivial(struct object_id *common, struct object_id *head,
 607                             struct object_id *one)
 608{
 609        int i, nr_trees = 0;
 610        struct tree *trees[MAX_UNPACK_TREES];
 611        struct tree_desc t[MAX_UNPACK_TREES];
 612        struct unpack_trees_options opts;
 613
 614        memset(&opts, 0, sizeof(opts));
 615        opts.head_idx = 2;
 616        opts.src_index = &the_index;
 617        opts.dst_index = &the_index;
 618        opts.update = 1;
 619        opts.verbose_update = 1;
 620        opts.trivial_merges_only = 1;
 621        opts.merge = 1;
 622        trees[nr_trees] = parse_tree_indirect(common);
 623        if (!trees[nr_trees++])
 624                return -1;
 625        trees[nr_trees] = parse_tree_indirect(head);
 626        if (!trees[nr_trees++])
 627                return -1;
 628        trees[nr_trees] = parse_tree_indirect(one);
 629        if (!trees[nr_trees++])
 630                return -1;
 631        opts.fn = threeway_merge;
 632        cache_tree_free(&active_cache_tree);
 633        for (i = 0; i < nr_trees; i++) {
 634                parse_tree(trees[i]);
 635                init_tree_desc(t+i, trees[i]->buffer, trees[i]->size);
 636        }
 637        if (unpack_trees(nr_trees, t, &opts))
 638                return -1;
 639        return 0;
 640}
 641
 642static void write_tree_trivial(struct object_id *oid)
 643{
 644        if (write_cache_as_tree(oid, 0, NULL))
 645                die(_("git write-tree failed to write a tree"));
 646}
 647
 648static int try_merge_strategy(const char *strategy, struct commit_list *common,
 649                              struct commit_list *remoteheads,
 650                              struct commit *head)
 651{
 652        struct lock_file lock = LOCK_INIT;
 653        const char *head_arg = "HEAD";
 654
 655        hold_locked_index(&lock, LOCK_DIE_ON_ERROR);
 656        refresh_cache(REFRESH_QUIET);
 657        if (write_locked_index(&the_index, &lock,
 658                               COMMIT_LOCK | SKIP_IF_UNCHANGED))
 659                return error(_("Unable to write index."));
 660
 661        if (!strcmp(strategy, "recursive") || !strcmp(strategy, "subtree")) {
 662                int clean, x;
 663                struct commit *result;
 664                struct commit_list *reversed = NULL;
 665                struct merge_options o;
 666                struct commit_list *j;
 667
 668                if (remoteheads->next) {
 669                        error(_("Not handling anything other than two heads merge."));
 670                        return 2;
 671                }
 672
 673                init_merge_options(&o);
 674                if (!strcmp(strategy, "subtree"))
 675                        o.subtree_shift = "";
 676
 677                o.renormalize = option_renormalize;
 678                o.show_rename_progress =
 679                        show_progress == -1 ? isatty(2) : show_progress;
 680
 681                for (x = 0; x < xopts_nr; x++)
 682                        if (parse_merge_opt(&o, xopts[x]))
 683                                die(_("Unknown option for merge-recursive: -X%s"), xopts[x]);
 684
 685                o.branch1 = head_arg;
 686                o.branch2 = merge_remote_util(remoteheads->item)->name;
 687
 688                for (j = common; j; j = j->next)
 689                        commit_list_insert(j->item, &reversed);
 690
 691                hold_locked_index(&lock, LOCK_DIE_ON_ERROR);
 692                clean = merge_recursive(&o, head,
 693                                remoteheads->item, reversed, &result);
 694                if (clean < 0)
 695                        exit(128);
 696                if (write_locked_index(&the_index, &lock,
 697                                       COMMIT_LOCK | SKIP_IF_UNCHANGED))
 698                        die (_("unable to write %s"), get_index_file());
 699                return clean ? 0 : 1;
 700        } else {
 701                return try_merge_command(strategy, xopts_nr, xopts,
 702                                                common, head_arg, remoteheads);
 703        }
 704}
 705
 706static void count_diff_files(struct diff_queue_struct *q,
 707                             struct diff_options *opt, void *data)
 708{
 709        int *count = data;
 710
 711        (*count) += q->nr;
 712}
 713
 714static int count_unmerged_entries(void)
 715{
 716        int i, ret = 0;
 717
 718        for (i = 0; i < active_nr; i++)
 719                if (ce_stage(active_cache[i]))
 720                        ret++;
 721
 722        return ret;
 723}
 724
 725static void add_strategies(const char *string, unsigned attr)
 726{
 727        int i;
 728
 729        if (string) {
 730                struct string_list list = STRING_LIST_INIT_DUP;
 731                struct string_list_item *item;
 732                string_list_split(&list, string, ' ', -1);
 733                for_each_string_list_item(item, &list)
 734                        append_strategy(get_strategy(item->string));
 735                string_list_clear(&list, 0);
 736                return;
 737        }
 738        for (i = 0; i < ARRAY_SIZE(all_strategy); i++)
 739                if (all_strategy[i].attr & attr)
 740                        append_strategy(&all_strategy[i]);
 741
 742}
 743
 744static void read_merge_msg(struct strbuf *msg)
 745{
 746        const char *filename = git_path_merge_msg();
 747        strbuf_reset(msg);
 748        if (strbuf_read_file(msg, filename, 0) < 0)
 749                die_errno(_("Could not read from '%s'"), filename);
 750}
 751
 752static void write_merge_state(struct commit_list *);
 753static void abort_commit(struct commit_list *remoteheads, const char *err_msg)
 754{
 755        if (err_msg)
 756                error("%s", err_msg);
 757        fprintf(stderr,
 758                _("Not committing merge; use 'git commit' to complete the merge.\n"));
 759        write_merge_state(remoteheads);
 760        exit(1);
 761}
 762
 763static const char merge_editor_comment[] =
 764N_("Please enter a commit message to explain why this merge is necessary,\n"
 765   "especially if it merges an updated upstream into a topic branch.\n"
 766   "\n"
 767   "Lines starting with '%c' will be ignored, and an empty message aborts\n"
 768   "the commit.\n");
 769
 770static void write_merge_heads(struct commit_list *);
 771static void prepare_to_commit(struct commit_list *remoteheads)
 772{
 773        struct strbuf msg = STRBUF_INIT;
 774        strbuf_addbuf(&msg, &merge_msg);
 775        strbuf_addch(&msg, '\n');
 776        if (squash)
 777                BUG("the control must not reach here under --squash");
 778        if (0 < option_edit)
 779                strbuf_commented_addf(&msg, _(merge_editor_comment), comment_line_char);
 780        if (signoff)
 781                append_signoff(&msg, ignore_non_trailer(msg.buf, msg.len), 0);
 782        write_merge_heads(remoteheads);
 783        write_file_buf(git_path_merge_msg(), msg.buf, msg.len);
 784        if (run_commit_hook(0 < option_edit, get_index_file(), "prepare-commit-msg",
 785                            git_path_merge_msg(), "merge", NULL))
 786                abort_commit(remoteheads, NULL);
 787        if (0 < option_edit) {
 788                if (launch_editor(git_path_merge_msg(), NULL, NULL))
 789                        abort_commit(remoteheads, NULL);
 790        }
 791
 792        if (verify_msg && run_commit_hook(0 < option_edit, get_index_file(),
 793                                          "commit-msg",
 794                                          git_path_merge_msg(), NULL))
 795                abort_commit(remoteheads, NULL);
 796
 797        read_merge_msg(&msg);
 798        strbuf_stripspace(&msg, 0 < option_edit);
 799        if (!msg.len)
 800                abort_commit(remoteheads, _("Empty commit message."));
 801        strbuf_release(&merge_msg);
 802        strbuf_addbuf(&merge_msg, &msg);
 803        strbuf_release(&msg);
 804}
 805
 806static int merge_trivial(struct commit *head, struct commit_list *remoteheads)
 807{
 808        struct object_id result_tree, result_commit;
 809        struct commit_list *parents, **pptr = &parents;
 810        struct lock_file lock = LOCK_INIT;
 811
 812        hold_locked_index(&lock, LOCK_DIE_ON_ERROR);
 813        refresh_cache(REFRESH_QUIET);
 814        if (write_locked_index(&the_index, &lock,
 815                               COMMIT_LOCK | SKIP_IF_UNCHANGED))
 816                return error(_("Unable to write index."));
 817
 818        write_tree_trivial(&result_tree);
 819        printf(_("Wonderful.\n"));
 820        pptr = commit_list_append(head, pptr);
 821        pptr = commit_list_append(remoteheads->item, pptr);
 822        prepare_to_commit(remoteheads);
 823        if (commit_tree(merge_msg.buf, merge_msg.len, &result_tree, parents,
 824                        &result_commit, NULL, sign_commit))
 825                die(_("failed to write commit object"));
 826        finish(head, remoteheads, &result_commit, "In-index merge");
 827        drop_save();
 828        return 0;
 829}
 830
 831static int finish_automerge(struct commit *head,
 832                            int head_subsumed,
 833                            struct commit_list *common,
 834                            struct commit_list *remoteheads,
 835                            struct object_id *result_tree,
 836                            const char *wt_strategy)
 837{
 838        struct commit_list *parents = NULL;
 839        struct strbuf buf = STRBUF_INIT;
 840        struct object_id result_commit;
 841
 842        free_commit_list(common);
 843        parents = remoteheads;
 844        if (!head_subsumed || fast_forward == FF_NO)
 845                commit_list_insert(head, &parents);
 846        strbuf_addch(&merge_msg, '\n');
 847        prepare_to_commit(remoteheads);
 848        if (commit_tree(merge_msg.buf, merge_msg.len, result_tree, parents,
 849                        &result_commit, NULL, sign_commit))
 850                die(_("failed to write commit object"));
 851        strbuf_addf(&buf, "Merge made by the '%s' strategy.", wt_strategy);
 852        finish(head, remoteheads, &result_commit, buf.buf);
 853        strbuf_release(&buf);
 854        drop_save();
 855        return 0;
 856}
 857
 858static int suggest_conflicts(void)
 859{
 860        const char *filename;
 861        FILE *fp;
 862        struct strbuf msgbuf = STRBUF_INIT;
 863
 864        filename = git_path_merge_msg();
 865        fp = xfopen(filename, "a");
 866
 867        append_conflicts_hint(&msgbuf);
 868        fputs(msgbuf.buf, fp);
 869        strbuf_release(&msgbuf);
 870        fclose(fp);
 871        rerere(allow_rerere_auto);
 872        printf(_("Automatic merge failed; "
 873                        "fix conflicts and then commit the result.\n"));
 874        return 1;
 875}
 876
 877static int evaluate_result(void)
 878{
 879        int cnt = 0;
 880        struct rev_info rev;
 881
 882        /* Check how many files differ. */
 883        init_revisions(&rev, "");
 884        setup_revisions(0, NULL, &rev, NULL);
 885        rev.diffopt.output_format |=
 886                DIFF_FORMAT_CALLBACK;
 887        rev.diffopt.format_callback = count_diff_files;
 888        rev.diffopt.format_callback_data = &cnt;
 889        run_diff_files(&rev, 0);
 890
 891        /*
 892         * Check how many unmerged entries are
 893         * there.
 894         */
 895        cnt += count_unmerged_entries();
 896
 897        return cnt;
 898}
 899
 900/*
 901 * Pretend as if the user told us to merge with the remote-tracking
 902 * branch we have for the upstream of the current branch
 903 */
 904static int setup_with_upstream(const char ***argv)
 905{
 906        struct branch *branch = branch_get(NULL);
 907        int i;
 908        const char **args;
 909
 910        if (!branch)
 911                die(_("No current branch."));
 912        if (!branch->remote_name)
 913                die(_("No remote for the current branch."));
 914        if (!branch->merge_nr)
 915                die(_("No default upstream defined for the current branch."));
 916
 917        args = xcalloc(st_add(branch->merge_nr, 1), sizeof(char *));
 918        for (i = 0; i < branch->merge_nr; i++) {
 919                if (!branch->merge[i]->dst)
 920                        die(_("No remote-tracking branch for %s from %s"),
 921                            branch->merge[i]->src, branch->remote_name);
 922                args[i] = branch->merge[i]->dst;
 923        }
 924        args[i] = NULL;
 925        *argv = args;
 926        return i;
 927}
 928
 929static void write_merge_heads(struct commit_list *remoteheads)
 930{
 931        struct commit_list *j;
 932        struct strbuf buf = STRBUF_INIT;
 933
 934        for (j = remoteheads; j; j = j->next) {
 935                struct object_id *oid;
 936                struct commit *c = j->item;
 937                if (c->util && merge_remote_util(c)->obj) {
 938                        oid = &merge_remote_util(c)->obj->oid;
 939                } else {
 940                        oid = &c->object.oid;
 941                }
 942                strbuf_addf(&buf, "%s\n", oid_to_hex(oid));
 943        }
 944        write_file_buf(git_path_merge_head(), buf.buf, buf.len);
 945
 946        strbuf_reset(&buf);
 947        if (fast_forward == FF_NO)
 948                strbuf_addstr(&buf, "no-ff");
 949        write_file_buf(git_path_merge_mode(), buf.buf, buf.len);
 950        strbuf_release(&buf);
 951}
 952
 953static void write_merge_state(struct commit_list *remoteheads)
 954{
 955        write_merge_heads(remoteheads);
 956        strbuf_addch(&merge_msg, '\n');
 957        write_file_buf(git_path_merge_msg(), merge_msg.buf, merge_msg.len);
 958}
 959
 960static int default_edit_option(void)
 961{
 962        static const char name[] = "GIT_MERGE_AUTOEDIT";
 963        const char *e = getenv(name);
 964        struct stat st_stdin, st_stdout;
 965
 966        if (have_message)
 967                /* an explicit -m msg without --[no-]edit */
 968                return 0;
 969
 970        if (e) {
 971                int v = git_parse_maybe_bool(e);
 972                if (v < 0)
 973                        die(_("Bad value '%s' in environment '%s'"), e, name);
 974                return v;
 975        }
 976
 977        /* Use editor if stdin and stdout are the same and is a tty */
 978        return (!fstat(0, &st_stdin) &&
 979                !fstat(1, &st_stdout) &&
 980                isatty(0) && isatty(1) &&
 981                st_stdin.st_dev == st_stdout.st_dev &&
 982                st_stdin.st_ino == st_stdout.st_ino &&
 983                st_stdin.st_mode == st_stdout.st_mode);
 984}
 985
 986static struct commit_list *reduce_parents(struct commit *head_commit,
 987                                          int *head_subsumed,
 988                                          struct commit_list *remoteheads)
 989{
 990        struct commit_list *parents, **remotes;
 991
 992        /*
 993         * Is the current HEAD reachable from another commit being
 994         * merged?  If so we do not want to record it as a parent of
 995         * the resulting merge, unless --no-ff is given.  We will flip
 996         * this variable to 0 when we find HEAD among the independent
 997         * tips being merged.
 998         */
 999        *head_subsumed = 1;
1000
1001        /* Find what parents to record by checking independent ones. */
1002        parents = reduce_heads(remoteheads);
1003        free_commit_list(remoteheads);
1004
1005        remoteheads = NULL;
1006        remotes = &remoteheads;
1007        while (parents) {
1008                struct commit *commit = pop_commit(&parents);
1009                if (commit == head_commit)
1010                        *head_subsumed = 0;
1011                else
1012                        remotes = &commit_list_insert(commit, remotes)->next;
1013        }
1014        return remoteheads;
1015}
1016
1017static void prepare_merge_message(struct strbuf *merge_names, struct strbuf *merge_msg)
1018{
1019        struct fmt_merge_msg_opts opts;
1020
1021        memset(&opts, 0, sizeof(opts));
1022        opts.add_title = !have_message;
1023        opts.shortlog_len = shortlog_len;
1024        opts.credit_people = (0 < option_edit);
1025
1026        fmt_merge_msg(merge_names, merge_msg, &opts);
1027        if (merge_msg->len)
1028                strbuf_setlen(merge_msg, merge_msg->len - 1);
1029}
1030
1031static void handle_fetch_head(struct commit_list **remotes, struct strbuf *merge_names)
1032{
1033        const char *filename;
1034        int fd, pos, npos;
1035        struct strbuf fetch_head_file = STRBUF_INIT;
1036
1037        if (!merge_names)
1038                merge_names = &fetch_head_file;
1039
1040        filename = git_path_fetch_head();
1041        fd = open(filename, O_RDONLY);
1042        if (fd < 0)
1043                die_errno(_("could not open '%s' for reading"), filename);
1044
1045        if (strbuf_read(merge_names, fd, 0) < 0)
1046                die_errno(_("could not read '%s'"), filename);
1047        if (close(fd) < 0)
1048                die_errno(_("could not close '%s'"), filename);
1049
1050        for (pos = 0; pos < merge_names->len; pos = npos) {
1051                struct object_id oid;
1052                char *ptr;
1053                struct commit *commit;
1054
1055                ptr = strchr(merge_names->buf + pos, '\n');
1056                if (ptr)
1057                        npos = ptr - merge_names->buf + 1;
1058                else
1059                        npos = merge_names->len;
1060
1061                if (npos - pos < GIT_SHA1_HEXSZ + 2 ||
1062                    get_oid_hex(merge_names->buf + pos, &oid))
1063                        commit = NULL; /* bad */
1064                else if (memcmp(merge_names->buf + pos + GIT_SHA1_HEXSZ, "\t\t", 2))
1065                        continue; /* not-for-merge */
1066                else {
1067                        char saved = merge_names->buf[pos + GIT_SHA1_HEXSZ];
1068                        merge_names->buf[pos + GIT_SHA1_HEXSZ] = '\0';
1069                        commit = get_merge_parent(merge_names->buf + pos);
1070                        merge_names->buf[pos + GIT_SHA1_HEXSZ] = saved;
1071                }
1072                if (!commit) {
1073                        if (ptr)
1074                                *ptr = '\0';
1075                        die(_("not something we can merge in %s: %s"),
1076                            filename, merge_names->buf + pos);
1077                }
1078                remotes = &commit_list_insert(commit, remotes)->next;
1079        }
1080
1081        if (merge_names == &fetch_head_file)
1082                strbuf_release(&fetch_head_file);
1083}
1084
1085static struct commit_list *collect_parents(struct commit *head_commit,
1086                                           int *head_subsumed,
1087                                           int argc, const char **argv,
1088                                           struct strbuf *merge_msg)
1089{
1090        int i;
1091        struct commit_list *remoteheads = NULL;
1092        struct commit_list **remotes = &remoteheads;
1093        struct strbuf merge_names = STRBUF_INIT, *autogen = NULL;
1094
1095        if (merge_msg && (!have_message || shortlog_len))
1096                autogen = &merge_names;
1097
1098        if (head_commit)
1099                remotes = &commit_list_insert(head_commit, remotes)->next;
1100
1101        if (argc == 1 && !strcmp(argv[0], "FETCH_HEAD")) {
1102                handle_fetch_head(remotes, autogen);
1103                remoteheads = reduce_parents(head_commit, head_subsumed, remoteheads);
1104        } else {
1105                for (i = 0; i < argc; i++) {
1106                        struct commit *commit = get_merge_parent(argv[i]);
1107                        if (!commit)
1108                                help_unknown_ref(argv[i], "merge",
1109                                                 _("not something we can merge"));
1110                        remotes = &commit_list_insert(commit, remotes)->next;
1111                }
1112                remoteheads = reduce_parents(head_commit, head_subsumed, remoteheads);
1113                if (autogen) {
1114                        struct commit_list *p;
1115                        for (p = remoteheads; p; p = p->next)
1116                                merge_name(merge_remote_util(p->item)->name, autogen);
1117                }
1118        }
1119
1120        if (autogen) {
1121                prepare_merge_message(autogen, merge_msg);
1122                strbuf_release(autogen);
1123        }
1124
1125        return remoteheads;
1126}
1127
1128static int merging_a_throwaway_tag(struct commit *commit)
1129{
1130        char *tag_ref;
1131        struct object_id oid;
1132        int is_throwaway_tag = 0;
1133
1134        /* Are we merging a tag? */
1135        if (!merge_remote_util(commit) ||
1136            !merge_remote_util(commit)->obj ||
1137            merge_remote_util(commit)->obj->type != OBJ_TAG)
1138                return is_throwaway_tag;
1139
1140        /*
1141         * Now we know we are merging a tag object.  Are we downstream
1142         * and following the tags from upstream?  If so, we must have
1143         * the tag object pointed at by "refs/tags/$T" where $T is the
1144         * tagname recorded in the tag object.  We want to allow such
1145         * a "just to catch up" merge to fast-forward.
1146         *
1147         * Otherwise, we are playing an integrator's role, making a
1148         * merge with a throw-away tag from a contributor with
1149         * something like "git pull $contributor $signed_tag".
1150         * We want to forbid such a merge from fast-forwarding
1151         * by default; otherwise we would not keep the signature
1152         * anywhere.
1153         */
1154        tag_ref = xstrfmt("refs/tags/%s",
1155                          ((struct tag *)merge_remote_util(commit)->obj)->tag);
1156        if (!read_ref(tag_ref, &oid) &&
1157            !oidcmp(&oid, &merge_remote_util(commit)->obj->oid))
1158                is_throwaway_tag = 0;
1159        else
1160                is_throwaway_tag = 1;
1161        free(tag_ref);
1162        return is_throwaway_tag;
1163}
1164
1165int cmd_merge(int argc, const char **argv, const char *prefix)
1166{
1167        struct object_id result_tree, stash, head_oid;
1168        struct commit *head_commit;
1169        struct strbuf buf = STRBUF_INIT;
1170        int i, ret = 0, head_subsumed;
1171        int best_cnt = -1, merge_was_ok = 0, automerge_was_ok = 0;
1172        struct commit_list *common = NULL;
1173        const char *best_strategy = NULL, *wt_strategy = NULL;
1174        struct commit_list *remoteheads, *p;
1175        void *branch_to_free;
1176        int orig_argc = argc;
1177
1178        if (argc == 2 && !strcmp(argv[1], "-h"))
1179                usage_with_options(builtin_merge_usage, builtin_merge_options);
1180
1181        /*
1182         * Check if we are _not_ on a detached HEAD, i.e. if there is a
1183         * current branch.
1184         */
1185        branch = branch_to_free = resolve_refdup("HEAD", 0, &head_oid, NULL);
1186        if (branch)
1187                skip_prefix(branch, "refs/heads/", &branch);
1188        if (!branch || is_null_oid(&head_oid))
1189                head_commit = NULL;
1190        else
1191                head_commit = lookup_commit_or_die(&head_oid, "HEAD");
1192
1193        init_diff_ui_defaults();
1194        git_config(git_merge_config, NULL);
1195
1196        if (branch_mergeoptions)
1197                parse_branch_merge_options(branch_mergeoptions);
1198        argc = parse_options(argc, argv, prefix, builtin_merge_options,
1199                        builtin_merge_usage, 0);
1200        if (shortlog_len < 0)
1201                shortlog_len = (merge_log_config > 0) ? merge_log_config : 0;
1202
1203        if (verbosity < 0 && show_progress == -1)
1204                show_progress = 0;
1205
1206        if (abort_current_merge) {
1207                int nargc = 2;
1208                const char *nargv[] = {"reset", "--merge", NULL};
1209
1210                if (orig_argc != 2)
1211                        usage_msg_opt(_("--abort expects no arguments"),
1212                              builtin_merge_usage, builtin_merge_options);
1213
1214                if (!file_exists(git_path_merge_head()))
1215                        die(_("There is no merge to abort (MERGE_HEAD missing)."));
1216
1217                /* Invoke 'git reset --merge' */
1218                ret = cmd_reset(nargc, nargv, prefix);
1219                goto done;
1220        }
1221
1222        if (continue_current_merge) {
1223                int nargc = 1;
1224                const char *nargv[] = {"commit", NULL};
1225
1226                if (orig_argc != 2)
1227                        usage_msg_opt(_("--continue expects no arguments"),
1228                              builtin_merge_usage, builtin_merge_options);
1229
1230                if (!file_exists(git_path_merge_head()))
1231                        die(_("There is no merge in progress (MERGE_HEAD missing)."));
1232
1233                /* Invoke 'git commit' */
1234                ret = cmd_commit(nargc, nargv, prefix);
1235                goto done;
1236        }
1237
1238        if (read_cache_unmerged())
1239                die_resolve_conflict("merge");
1240
1241        if (file_exists(git_path_merge_head())) {
1242                /*
1243                 * There is no unmerged entry, don't advise 'git
1244                 * add/rm <file>', just 'git commit'.
1245                 */
1246                if (advice_resolve_conflict)
1247                        die(_("You have not concluded your merge (MERGE_HEAD exists).\n"
1248                                  "Please, commit your changes before you merge."));
1249                else
1250                        die(_("You have not concluded your merge (MERGE_HEAD exists)."));
1251        }
1252        if (file_exists(git_path_cherry_pick_head())) {
1253                if (advice_resolve_conflict)
1254                        die(_("You have not concluded your cherry-pick (CHERRY_PICK_HEAD exists).\n"
1255                            "Please, commit your changes before you merge."));
1256                else
1257                        die(_("You have not concluded your cherry-pick (CHERRY_PICK_HEAD exists)."));
1258        }
1259        resolve_undo_clear();
1260
1261        if (verbosity < 0)
1262                show_diffstat = 0;
1263
1264        if (squash) {
1265                if (fast_forward == FF_NO)
1266                        die(_("You cannot combine --squash with --no-ff."));
1267                option_commit = 0;
1268        }
1269
1270        if (!argc) {
1271                if (default_to_upstream)
1272                        argc = setup_with_upstream(&argv);
1273                else
1274                        die(_("No commit specified and merge.defaultToUpstream not set."));
1275        } else if (argc == 1 && !strcmp(argv[0], "-")) {
1276                argv[0] = "@{-1}";
1277        }
1278
1279        if (!argc)
1280                usage_with_options(builtin_merge_usage,
1281                        builtin_merge_options);
1282
1283        if (!head_commit) {
1284                /*
1285                 * If the merged head is a valid one there is no reason
1286                 * to forbid "git merge" into a branch yet to be born.
1287                 * We do the same for "git pull".
1288                 */
1289                struct object_id *remote_head_oid;
1290                if (squash)
1291                        die(_("Squash commit into empty head not supported yet"));
1292                if (fast_forward == FF_NO)
1293                        die(_("Non-fast-forward commit does not make sense into "
1294                            "an empty head"));
1295                remoteheads = collect_parents(head_commit, &head_subsumed,
1296                                              argc, argv, NULL);
1297                if (!remoteheads)
1298                        die(_("%s - not something we can merge"), argv[0]);
1299                if (remoteheads->next)
1300                        die(_("Can merge only exactly one commit into empty head"));
1301                remote_head_oid = &remoteheads->item->object.oid;
1302                read_empty(remote_head_oid, 0);
1303                update_ref("initial pull", "HEAD", remote_head_oid, NULL, 0,
1304                           UPDATE_REFS_DIE_ON_ERR);
1305                goto done;
1306        }
1307
1308        /*
1309         * All the rest are the commits being merged; prepare
1310         * the standard merge summary message to be appended
1311         * to the given message.
1312         */
1313        remoteheads = collect_parents(head_commit, &head_subsumed,
1314                                      argc, argv, &merge_msg);
1315
1316        if (!head_commit || !argc)
1317                usage_with_options(builtin_merge_usage,
1318                        builtin_merge_options);
1319
1320        if (verify_signatures) {
1321                for (p = remoteheads; p; p = p->next) {
1322                        struct commit *commit = p->item;
1323                        char hex[GIT_MAX_HEXSZ + 1];
1324                        struct signature_check signature_check;
1325                        memset(&signature_check, 0, sizeof(signature_check));
1326
1327                        check_commit_signature(commit, &signature_check);
1328
1329                        find_unique_abbrev_r(hex, &commit->object.oid, DEFAULT_ABBREV);
1330                        switch (signature_check.result) {
1331                        case 'G':
1332                                break;
1333                        case 'U':
1334                                die(_("Commit %s has an untrusted GPG signature, "
1335                                      "allegedly by %s."), hex, signature_check.signer);
1336                        case 'B':
1337                                die(_("Commit %s has a bad GPG signature "
1338                                      "allegedly by %s."), hex, signature_check.signer);
1339                        default: /* 'N' */
1340                                die(_("Commit %s does not have a GPG signature."), hex);
1341                        }
1342                        if (verbosity >= 0 && signature_check.result == 'G')
1343                                printf(_("Commit %s has a good GPG signature by %s\n"),
1344                                       hex, signature_check.signer);
1345
1346                        signature_check_clear(&signature_check);
1347                }
1348        }
1349
1350        strbuf_addstr(&buf, "merge");
1351        for (p = remoteheads; p; p = p->next)
1352                strbuf_addf(&buf, " %s", merge_remote_util(p->item)->name);
1353        setenv("GIT_REFLOG_ACTION", buf.buf, 0);
1354        strbuf_reset(&buf);
1355
1356        for (p = remoteheads; p; p = p->next) {
1357                struct commit *commit = p->item;
1358                strbuf_addf(&buf, "GITHEAD_%s",
1359                            oid_to_hex(&commit->object.oid));
1360                setenv(buf.buf, merge_remote_util(commit)->name, 1);
1361                strbuf_reset(&buf);
1362                if (fast_forward != FF_ONLY && merging_a_throwaway_tag(commit))
1363                        fast_forward = FF_NO;
1364        }
1365
1366        if (option_edit < 0)
1367                option_edit = default_edit_option();
1368
1369        if (!use_strategies) {
1370                if (!remoteheads)
1371                        ; /* already up-to-date */
1372                else if (!remoteheads->next)
1373                        add_strategies(pull_twohead, DEFAULT_TWOHEAD);
1374                else
1375                        add_strategies(pull_octopus, DEFAULT_OCTOPUS);
1376        }
1377
1378        for (i = 0; i < use_strategies_nr; i++) {
1379                if (use_strategies[i]->attr & NO_FAST_FORWARD)
1380                        fast_forward = FF_NO;
1381                if (use_strategies[i]->attr & NO_TRIVIAL)
1382                        allow_trivial = 0;
1383        }
1384
1385        if (!remoteheads)
1386                ; /* already up-to-date */
1387        else if (!remoteheads->next)
1388                common = get_merge_bases(head_commit, remoteheads->item);
1389        else {
1390                struct commit_list *list = remoteheads;
1391                commit_list_insert(head_commit, &list);
1392                common = get_octopus_merge_bases(list);
1393                free(list);
1394        }
1395
1396        update_ref("updating ORIG_HEAD", "ORIG_HEAD",
1397                   &head_commit->object.oid, NULL, 0, UPDATE_REFS_DIE_ON_ERR);
1398
1399        if (remoteheads && !common) {
1400                /* No common ancestors found. */
1401                if (!allow_unrelated_histories)
1402                        die(_("refusing to merge unrelated histories"));
1403                /* otherwise, we need a real merge. */
1404        } else if (!remoteheads ||
1405                 (!remoteheads->next && !common->next &&
1406                  common->item == remoteheads->item)) {
1407                /*
1408                 * If head can reach all the merge then we are up to date.
1409                 * but first the most common case of merging one remote.
1410                 */
1411                finish_up_to_date(_("Already up to date."));
1412                goto done;
1413        } else if (fast_forward != FF_NO && !remoteheads->next &&
1414                        !common->next &&
1415                        !oidcmp(&common->item->object.oid, &head_commit->object.oid)) {
1416                /* Again the most common case of merging one remote. */
1417                struct strbuf msg = STRBUF_INIT;
1418                struct commit *commit;
1419
1420                if (verbosity >= 0) {
1421                        printf(_("Updating %s..%s\n"),
1422                               find_unique_abbrev(&head_commit->object.oid,
1423                                                  DEFAULT_ABBREV),
1424                               find_unique_abbrev(&remoteheads->item->object.oid,
1425                                                  DEFAULT_ABBREV));
1426                }
1427                strbuf_addstr(&msg, "Fast-forward");
1428                if (have_message)
1429                        strbuf_addstr(&msg,
1430                                " (no commit created; -m option ignored)");
1431                commit = remoteheads->item;
1432                if (!commit) {
1433                        ret = 1;
1434                        goto done;
1435                }
1436
1437                if (checkout_fast_forward(&head_commit->object.oid,
1438                                          &commit->object.oid,
1439                                          overwrite_ignore)) {
1440                        ret = 1;
1441                        goto done;
1442                }
1443
1444                finish(head_commit, remoteheads, &commit->object.oid, msg.buf);
1445                drop_save();
1446                goto done;
1447        } else if (!remoteheads->next && common->next)
1448                ;
1449                /*
1450                 * We are not doing octopus and not fast-forward.  Need
1451                 * a real merge.
1452                 */
1453        else if (!remoteheads->next && !common->next && option_commit) {
1454                /*
1455                 * We are not doing octopus, not fast-forward, and have
1456                 * only one common.
1457                 */
1458                refresh_cache(REFRESH_QUIET);
1459                if (allow_trivial && fast_forward != FF_ONLY) {
1460                        /* See if it is really trivial. */
1461                        git_committer_info(IDENT_STRICT);
1462                        printf(_("Trying really trivial in-index merge...\n"));
1463                        if (!read_tree_trivial(&common->item->object.oid,
1464                                               &head_commit->object.oid,
1465                                               &remoteheads->item->object.oid)) {
1466                                ret = merge_trivial(head_commit, remoteheads);
1467                                goto done;
1468                        }
1469                        printf(_("Nope.\n"));
1470                }
1471        } else {
1472                /*
1473                 * An octopus.  If we can reach all the remote we are up
1474                 * to date.
1475                 */
1476                int up_to_date = 1;
1477                struct commit_list *j;
1478
1479                for (j = remoteheads; j; j = j->next) {
1480                        struct commit_list *common_one;
1481
1482                        /*
1483                         * Here we *have* to calculate the individual
1484                         * merge_bases again, otherwise "git merge HEAD^
1485                         * HEAD^^" would be missed.
1486                         */
1487                        common_one = get_merge_bases(head_commit, j->item);
1488                        if (oidcmp(&common_one->item->object.oid, &j->item->object.oid)) {
1489                                up_to_date = 0;
1490                                break;
1491                        }
1492                }
1493                if (up_to_date) {
1494                        finish_up_to_date(_("Already up to date. Yeeah!"));
1495                        goto done;
1496                }
1497        }
1498
1499        if (fast_forward == FF_ONLY)
1500                die(_("Not possible to fast-forward, aborting."));
1501
1502        /* We are going to make a new commit. */
1503        git_committer_info(IDENT_STRICT);
1504
1505        /*
1506         * At this point, we need a real merge.  No matter what strategy
1507         * we use, it would operate on the index, possibly affecting the
1508         * working tree, and when resolved cleanly, have the desired
1509         * tree in the index -- this means that the index must be in
1510         * sync with the head commit.  The strategies are responsible
1511         * to ensure this.
1512         */
1513        if (use_strategies_nr == 1 ||
1514            /*
1515             * Stash away the local changes so that we can try more than one.
1516             */
1517            save_state(&stash))
1518                oidclr(&stash);
1519
1520        for (i = 0; i < use_strategies_nr; i++) {
1521                int ret;
1522                if (i) {
1523                        printf(_("Rewinding the tree to pristine...\n"));
1524                        restore_state(&head_commit->object.oid, &stash);
1525                }
1526                if (use_strategies_nr != 1)
1527                        printf(_("Trying merge strategy %s...\n"),
1528                                use_strategies[i]->name);
1529                /*
1530                 * Remember which strategy left the state in the working
1531                 * tree.
1532                 */
1533                wt_strategy = use_strategies[i]->name;
1534
1535                ret = try_merge_strategy(use_strategies[i]->name,
1536                                         common, remoteheads,
1537                                         head_commit);
1538                if (!option_commit && !ret) {
1539                        merge_was_ok = 1;
1540                        /*
1541                         * This is necessary here just to avoid writing
1542                         * the tree, but later we will *not* exit with
1543                         * status code 1 because merge_was_ok is set.
1544                         */
1545                        ret = 1;
1546                }
1547
1548                if (ret) {
1549                        /*
1550                         * The backend exits with 1 when conflicts are
1551                         * left to be resolved, with 2 when it does not
1552                         * handle the given merge at all.
1553                         */
1554                        if (ret == 1) {
1555                                int cnt = evaluate_result();
1556
1557                                if (best_cnt <= 0 || cnt <= best_cnt) {
1558                                        best_strategy = use_strategies[i]->name;
1559                                        best_cnt = cnt;
1560                                }
1561                        }
1562                        if (merge_was_ok)
1563                                break;
1564                        else
1565                                continue;
1566                }
1567
1568                /* Automerge succeeded. */
1569                write_tree_trivial(&result_tree);
1570                automerge_was_ok = 1;
1571                break;
1572        }
1573
1574        /*
1575         * If we have a resulting tree, that means the strategy module
1576         * auto resolved the merge cleanly.
1577         */
1578        if (automerge_was_ok) {
1579                ret = finish_automerge(head_commit, head_subsumed,
1580                                       common, remoteheads,
1581                                       &result_tree, wt_strategy);
1582                goto done;
1583        }
1584
1585        /*
1586         * Pick the result from the best strategy and have the user fix
1587         * it up.
1588         */
1589        if (!best_strategy) {
1590                restore_state(&head_commit->object.oid, &stash);
1591                if (use_strategies_nr > 1)
1592                        fprintf(stderr,
1593                                _("No merge strategy handled the merge.\n"));
1594                else
1595                        fprintf(stderr, _("Merge with strategy %s failed.\n"),
1596                                use_strategies[0]->name);
1597                ret = 2;
1598                goto done;
1599        } else if (best_strategy == wt_strategy)
1600                ; /* We already have its result in the working tree. */
1601        else {
1602                printf(_("Rewinding the tree to pristine...\n"));
1603                restore_state(&head_commit->object.oid, &stash);
1604                printf(_("Using the %s to prepare resolving by hand.\n"),
1605                        best_strategy);
1606                try_merge_strategy(best_strategy, common, remoteheads,
1607                                   head_commit);
1608        }
1609
1610        if (squash)
1611                finish(head_commit, remoteheads, NULL, NULL);
1612        else
1613                write_merge_state(remoteheads);
1614
1615        if (merge_was_ok)
1616                fprintf(stderr, _("Automatic merge went well; "
1617                        "stopped before committing as requested\n"));
1618        else
1619                ret = suggest_conflicts();
1620
1621done:
1622        free(branch_to_free);
1623        return ret;
1624}