revision.con commit rev-list: expose and document --single-worktree (32619f9)
   1#include "cache.h"
   2#include "tag.h"
   3#include "blob.h"
   4#include "tree.h"
   5#include "commit.h"
   6#include "diff.h"
   7#include "refs.h"
   8#include "revision.h"
   9#include "graph.h"
  10#include "grep.h"
  11#include "reflog-walk.h"
  12#include "patch-ids.h"
  13#include "decorate.h"
  14#include "log-tree.h"
  15#include "string-list.h"
  16#include "line-log.h"
  17#include "mailmap.h"
  18#include "commit-slab.h"
  19#include "dir.h"
  20#include "cache-tree.h"
  21#include "bisect.h"
  22#include "worktree.h"
  23
  24volatile show_early_output_fn_t show_early_output;
  25
  26static const char *term_bad;
  27static const char *term_good;
  28
  29void show_object_with_name(FILE *out, struct object *obj, const char *name)
  30{
  31        const char *p;
  32
  33        fprintf(out, "%s ", oid_to_hex(&obj->oid));
  34        for (p = name; *p && *p != '\n'; p++)
  35                fputc(*p, out);
  36        fputc('\n', out);
  37}
  38
  39static void mark_blob_uninteresting(struct blob *blob)
  40{
  41        if (!blob)
  42                return;
  43        if (blob->object.flags & UNINTERESTING)
  44                return;
  45        blob->object.flags |= UNINTERESTING;
  46}
  47
  48static void mark_tree_contents_uninteresting(struct tree *tree)
  49{
  50        struct tree_desc desc;
  51        struct name_entry entry;
  52        struct object *obj = &tree->object;
  53
  54        if (!has_object_file(&obj->oid))
  55                return;
  56        if (parse_tree(tree) < 0)
  57                die("bad tree %s", oid_to_hex(&obj->oid));
  58
  59        init_tree_desc(&desc, tree->buffer, tree->size);
  60        while (tree_entry(&desc, &entry)) {
  61                switch (object_type(entry.mode)) {
  62                case OBJ_TREE:
  63                        mark_tree_uninteresting(lookup_tree(entry.oid));
  64                        break;
  65                case OBJ_BLOB:
  66                        mark_blob_uninteresting(lookup_blob(entry.oid));
  67                        break;
  68                default:
  69                        /* Subproject commit - not in this repository */
  70                        break;
  71                }
  72        }
  73
  74        /*
  75         * We don't care about the tree any more
  76         * after it has been marked uninteresting.
  77         */
  78        free_tree_buffer(tree);
  79}
  80
  81void mark_tree_uninteresting(struct tree *tree)
  82{
  83        struct object *obj;
  84
  85        if (!tree)
  86                return;
  87
  88        obj = &tree->object;
  89        if (obj->flags & UNINTERESTING)
  90                return;
  91        obj->flags |= UNINTERESTING;
  92        mark_tree_contents_uninteresting(tree);
  93}
  94
  95void mark_parents_uninteresting(struct commit *commit)
  96{
  97        struct commit_list *parents = NULL, *l;
  98
  99        for (l = commit->parents; l; l = l->next)
 100                commit_list_insert(l->item, &parents);
 101
 102        while (parents) {
 103                struct commit *commit = pop_commit(&parents);
 104
 105                while (commit) {
 106                        /*
 107                         * A missing commit is ok iff its parent is marked
 108                         * uninteresting.
 109                         *
 110                         * We just mark such a thing parsed, so that when
 111                         * it is popped next time around, we won't be trying
 112                         * to parse it and get an error.
 113                         */
 114                        if (!has_object_file(&commit->object.oid))
 115                                commit->object.parsed = 1;
 116
 117                        if (commit->object.flags & UNINTERESTING)
 118                                break;
 119
 120                        commit->object.flags |= UNINTERESTING;
 121
 122                        /*
 123                         * Normally we haven't parsed the parent
 124                         * yet, so we won't have a parent of a parent
 125                         * here. However, it may turn out that we've
 126                         * reached this commit some other way (where it
 127                         * wasn't uninteresting), in which case we need
 128                         * to mark its parents recursively too..
 129                         */
 130                        if (!commit->parents)
 131                                break;
 132
 133                        for (l = commit->parents->next; l; l = l->next)
 134                                commit_list_insert(l->item, &parents);
 135                        commit = commit->parents->item;
 136                }
 137        }
 138}
 139
 140static void add_pending_object_with_path(struct rev_info *revs,
 141                                         struct object *obj,
 142                                         const char *name, unsigned mode,
 143                                         const char *path)
 144{
 145        if (!obj)
 146                return;
 147        if (revs->no_walk && (obj->flags & UNINTERESTING))
 148                revs->no_walk = 0;
 149        if (revs->reflog_info && obj->type == OBJ_COMMIT) {
 150                struct strbuf buf = STRBUF_INIT;
 151                int len = interpret_branch_name(name, 0, &buf, 0);
 152
 153                if (0 < len && name[len] && buf.len)
 154                        strbuf_addstr(&buf, name + len);
 155                add_reflog_for_walk(revs->reflog_info,
 156                                    (struct commit *)obj,
 157                                    buf.buf[0] ? buf.buf: name);
 158                strbuf_release(&buf);
 159                return; /* do not add the commit itself */
 160        }
 161        add_object_array_with_path(obj, name, &revs->pending, mode, path);
 162}
 163
 164static void add_pending_object_with_mode(struct rev_info *revs,
 165                                         struct object *obj,
 166                                         const char *name, unsigned mode)
 167{
 168        add_pending_object_with_path(revs, obj, name, mode, NULL);
 169}
 170
 171void add_pending_object(struct rev_info *revs,
 172                        struct object *obj, const char *name)
 173{
 174        add_pending_object_with_mode(revs, obj, name, S_IFINVALID);
 175}
 176
 177void add_head_to_pending(struct rev_info *revs)
 178{
 179        struct object_id oid;
 180        struct object *obj;
 181        if (get_oid("HEAD", &oid))
 182                return;
 183        obj = parse_object(&oid);
 184        if (!obj)
 185                return;
 186        add_pending_object(revs, obj, "HEAD");
 187}
 188
 189static struct object *get_reference(struct rev_info *revs, const char *name,
 190                                    const struct object_id *oid,
 191                                    unsigned int flags)
 192{
 193        struct object *object;
 194
 195        object = parse_object(oid);
 196        if (!object) {
 197                if (revs->ignore_missing)
 198                        return object;
 199                die("bad object %s", name);
 200        }
 201        object->flags |= flags;
 202        return object;
 203}
 204
 205void add_pending_oid(struct rev_info *revs, const char *name,
 206                      const struct object_id *oid, unsigned int flags)
 207{
 208        struct object *object = get_reference(revs, name, oid, flags);
 209        add_pending_object(revs, object, name);
 210}
 211
 212static struct commit *handle_commit(struct rev_info *revs,
 213                                    struct object_array_entry *entry)
 214{
 215        struct object *object = entry->item;
 216        const char *name = entry->name;
 217        const char *path = entry->path;
 218        unsigned int mode = entry->mode;
 219        unsigned long flags = object->flags;
 220
 221        /*
 222         * Tag object? Look what it points to..
 223         */
 224        while (object->type == OBJ_TAG) {
 225                struct tag *tag = (struct tag *) object;
 226                if (revs->tag_objects && !(flags & UNINTERESTING))
 227                        add_pending_object(revs, object, tag->tag);
 228                if (!tag->tagged)
 229                        die("bad tag");
 230                object = parse_object(&tag->tagged->oid);
 231                if (!object) {
 232                        if (revs->ignore_missing_links || (flags & UNINTERESTING))
 233                                return NULL;
 234                        die("bad object %s", oid_to_hex(&tag->tagged->oid));
 235                }
 236                object->flags |= flags;
 237                /*
 238                 * We'll handle the tagged object by looping or dropping
 239                 * through to the non-tag handlers below. Do not
 240                 * propagate path data from the tag's pending entry.
 241                 */
 242                path = NULL;
 243                mode = 0;
 244        }
 245
 246        /*
 247         * Commit object? Just return it, we'll do all the complex
 248         * reachability crud.
 249         */
 250        if (object->type == OBJ_COMMIT) {
 251                struct commit *commit = (struct commit *)object;
 252                if (parse_commit(commit) < 0)
 253                        die("unable to parse commit %s", name);
 254                if (flags & UNINTERESTING) {
 255                        mark_parents_uninteresting(commit);
 256                        revs->limited = 1;
 257                }
 258                if (revs->show_source && !commit->util)
 259                        commit->util = xstrdup(name);
 260                return commit;
 261        }
 262
 263        /*
 264         * Tree object? Either mark it uninteresting, or add it
 265         * to the list of objects to look at later..
 266         */
 267        if (object->type == OBJ_TREE) {
 268                struct tree *tree = (struct tree *)object;
 269                if (!revs->tree_objects)
 270                        return NULL;
 271                if (flags & UNINTERESTING) {
 272                        mark_tree_contents_uninteresting(tree);
 273                        return NULL;
 274                }
 275                add_pending_object_with_path(revs, object, name, mode, path);
 276                return NULL;
 277        }
 278
 279        /*
 280         * Blob object? You know the drill by now..
 281         */
 282        if (object->type == OBJ_BLOB) {
 283                if (!revs->blob_objects)
 284                        return NULL;
 285                if (flags & UNINTERESTING)
 286                        return NULL;
 287                add_pending_object_with_path(revs, object, name, mode, path);
 288                return NULL;
 289        }
 290        die("%s is unknown object", name);
 291}
 292
 293static int everybody_uninteresting(struct commit_list *orig,
 294                                   struct commit **interesting_cache)
 295{
 296        struct commit_list *list = orig;
 297
 298        if (*interesting_cache) {
 299                struct commit *commit = *interesting_cache;
 300                if (!(commit->object.flags & UNINTERESTING))
 301                        return 0;
 302        }
 303
 304        while (list) {
 305                struct commit *commit = list->item;
 306                list = list->next;
 307                if (commit->object.flags & UNINTERESTING)
 308                        continue;
 309
 310                *interesting_cache = commit;
 311                return 0;
 312        }
 313        return 1;
 314}
 315
 316/*
 317 * A definition of "relevant" commit that we can use to simplify limited graphs
 318 * by eliminating side branches.
 319 *
 320 * A "relevant" commit is one that is !UNINTERESTING (ie we are including it
 321 * in our list), or that is a specified BOTTOM commit. Then after computing
 322 * a limited list, during processing we can generally ignore boundary merges
 323 * coming from outside the graph, (ie from irrelevant parents), and treat
 324 * those merges as if they were single-parent. TREESAME is defined to consider
 325 * only relevant parents, if any. If we are TREESAME to our on-graph parents,
 326 * we don't care if we were !TREESAME to non-graph parents.
 327 *
 328 * Treating bottom commits as relevant ensures that a limited graph's
 329 * connection to the actual bottom commit is not viewed as a side branch, but
 330 * treated as part of the graph. For example:
 331 *
 332 *   ....Z...A---X---o---o---B
 333 *        .     /
 334 *         W---Y
 335 *
 336 * When computing "A..B", the A-X connection is at least as important as
 337 * Y-X, despite A being flagged UNINTERESTING.
 338 *
 339 * And when computing --ancestry-path "A..B", the A-X connection is more
 340 * important than Y-X, despite both A and Y being flagged UNINTERESTING.
 341 */
 342static inline int relevant_commit(struct commit *commit)
 343{
 344        return (commit->object.flags & (UNINTERESTING | BOTTOM)) != UNINTERESTING;
 345}
 346
 347/*
 348 * Return a single relevant commit from a parent list. If we are a TREESAME
 349 * commit, and this selects one of our parents, then we can safely simplify to
 350 * that parent.
 351 */
 352static struct commit *one_relevant_parent(const struct rev_info *revs,
 353                                          struct commit_list *orig)
 354{
 355        struct commit_list *list = orig;
 356        struct commit *relevant = NULL;
 357
 358        if (!orig)
 359                return NULL;
 360
 361        /*
 362         * For 1-parent commits, or if first-parent-only, then return that
 363         * first parent (even if not "relevant" by the above definition).
 364         * TREESAME will have been set purely on that parent.
 365         */
 366        if (revs->first_parent_only || !orig->next)
 367                return orig->item;
 368
 369        /*
 370         * For multi-parent commits, identify a sole relevant parent, if any.
 371         * If we have only one relevant parent, then TREESAME will be set purely
 372         * with regard to that parent, and we can simplify accordingly.
 373         *
 374         * If we have more than one relevant parent, or no relevant parents
 375         * (and multiple irrelevant ones), then we can't select a parent here
 376         * and return NULL.
 377         */
 378        while (list) {
 379                struct commit *commit = list->item;
 380                list = list->next;
 381                if (relevant_commit(commit)) {
 382                        if (relevant)
 383                                return NULL;
 384                        relevant = commit;
 385                }
 386        }
 387        return relevant;
 388}
 389
 390/*
 391 * The goal is to get REV_TREE_NEW as the result only if the
 392 * diff consists of all '+' (and no other changes), REV_TREE_OLD
 393 * if the whole diff is removal of old data, and otherwise
 394 * REV_TREE_DIFFERENT (of course if the trees are the same we
 395 * want REV_TREE_SAME).
 396 * That means that once we get to REV_TREE_DIFFERENT, we do not
 397 * have to look any further.
 398 */
 399static int tree_difference = REV_TREE_SAME;
 400
 401static void file_add_remove(struct diff_options *options,
 402                    int addremove, unsigned mode,
 403                    const struct object_id *oid,
 404                    int oid_valid,
 405                    const char *fullpath, unsigned dirty_submodule)
 406{
 407        int diff = addremove == '+' ? REV_TREE_NEW : REV_TREE_OLD;
 408
 409        tree_difference |= diff;
 410        if (tree_difference == REV_TREE_DIFFERENT)
 411                DIFF_OPT_SET(options, HAS_CHANGES);
 412}
 413
 414static void file_change(struct diff_options *options,
 415                 unsigned old_mode, unsigned new_mode,
 416                 const struct object_id *old_oid,
 417                 const struct object_id *new_oid,
 418                 int old_oid_valid, int new_oid_valid,
 419                 const char *fullpath,
 420                 unsigned old_dirty_submodule, unsigned new_dirty_submodule)
 421{
 422        tree_difference = REV_TREE_DIFFERENT;
 423        DIFF_OPT_SET(options, HAS_CHANGES);
 424}
 425
 426static int rev_compare_tree(struct rev_info *revs,
 427                            struct commit *parent, struct commit *commit)
 428{
 429        struct tree *t1 = parent->tree;
 430        struct tree *t2 = commit->tree;
 431
 432        if (!t1)
 433                return REV_TREE_NEW;
 434        if (!t2)
 435                return REV_TREE_OLD;
 436
 437        if (revs->simplify_by_decoration) {
 438                /*
 439                 * If we are simplifying by decoration, then the commit
 440                 * is worth showing if it has a tag pointing at it.
 441                 */
 442                if (get_name_decoration(&commit->object))
 443                        return REV_TREE_DIFFERENT;
 444                /*
 445                 * A commit that is not pointed by a tag is uninteresting
 446                 * if we are not limited by path.  This means that you will
 447                 * see the usual "commits that touch the paths" plus any
 448                 * tagged commit by specifying both --simplify-by-decoration
 449                 * and pathspec.
 450                 */
 451                if (!revs->prune_data.nr)
 452                        return REV_TREE_SAME;
 453        }
 454
 455        tree_difference = REV_TREE_SAME;
 456        DIFF_OPT_CLR(&revs->pruning, HAS_CHANGES);
 457        if (diff_tree_oid(&t1->object.oid, &t2->object.oid, "",
 458                           &revs->pruning) < 0)
 459                return REV_TREE_DIFFERENT;
 460        return tree_difference;
 461}
 462
 463static int rev_same_tree_as_empty(struct rev_info *revs, struct commit *commit)
 464{
 465        int retval;
 466        struct tree *t1 = commit->tree;
 467
 468        if (!t1)
 469                return 0;
 470
 471        tree_difference = REV_TREE_SAME;
 472        DIFF_OPT_CLR(&revs->pruning, HAS_CHANGES);
 473        retval = diff_tree_oid(NULL, &t1->object.oid, "", &revs->pruning);
 474
 475        return retval >= 0 && (tree_difference == REV_TREE_SAME);
 476}
 477
 478struct treesame_state {
 479        unsigned int nparents;
 480        unsigned char treesame[FLEX_ARRAY];
 481};
 482
 483static struct treesame_state *initialise_treesame(struct rev_info *revs, struct commit *commit)
 484{
 485        unsigned n = commit_list_count(commit->parents);
 486        struct treesame_state *st = xcalloc(1, st_add(sizeof(*st), n));
 487        st->nparents = n;
 488        add_decoration(&revs->treesame, &commit->object, st);
 489        return st;
 490}
 491
 492/*
 493 * Must be called immediately after removing the nth_parent from a commit's
 494 * parent list, if we are maintaining the per-parent treesame[] decoration.
 495 * This does not recalculate the master TREESAME flag - update_treesame()
 496 * should be called to update it after a sequence of treesame[] modifications
 497 * that may have affected it.
 498 */
 499static int compact_treesame(struct rev_info *revs, struct commit *commit, unsigned nth_parent)
 500{
 501        struct treesame_state *st;
 502        int old_same;
 503
 504        if (!commit->parents) {
 505                /*
 506                 * Have just removed the only parent from a non-merge.
 507                 * Different handling, as we lack decoration.
 508                 */
 509                if (nth_parent != 0)
 510                        die("compact_treesame %u", nth_parent);
 511                old_same = !!(commit->object.flags & TREESAME);
 512                if (rev_same_tree_as_empty(revs, commit))
 513                        commit->object.flags |= TREESAME;
 514                else
 515                        commit->object.flags &= ~TREESAME;
 516                return old_same;
 517        }
 518
 519        st = lookup_decoration(&revs->treesame, &commit->object);
 520        if (!st || nth_parent >= st->nparents)
 521                die("compact_treesame %u", nth_parent);
 522
 523        old_same = st->treesame[nth_parent];
 524        memmove(st->treesame + nth_parent,
 525                st->treesame + nth_parent + 1,
 526                st->nparents - nth_parent - 1);
 527
 528        /*
 529         * If we've just become a non-merge commit, update TREESAME
 530         * immediately, and remove the no-longer-needed decoration.
 531         * If still a merge, defer update until update_treesame().
 532         */
 533        if (--st->nparents == 1) {
 534                if (commit->parents->next)
 535                        die("compact_treesame parents mismatch");
 536                if (st->treesame[0] && revs->dense)
 537                        commit->object.flags |= TREESAME;
 538                else
 539                        commit->object.flags &= ~TREESAME;
 540                free(add_decoration(&revs->treesame, &commit->object, NULL));
 541        }
 542
 543        return old_same;
 544}
 545
 546static unsigned update_treesame(struct rev_info *revs, struct commit *commit)
 547{
 548        if (commit->parents && commit->parents->next) {
 549                unsigned n;
 550                struct treesame_state *st;
 551                struct commit_list *p;
 552                unsigned relevant_parents;
 553                unsigned relevant_change, irrelevant_change;
 554
 555                st = lookup_decoration(&revs->treesame, &commit->object);
 556                if (!st)
 557                        die("update_treesame %s", oid_to_hex(&commit->object.oid));
 558                relevant_parents = 0;
 559                relevant_change = irrelevant_change = 0;
 560                for (p = commit->parents, n = 0; p; n++, p = p->next) {
 561                        if (relevant_commit(p->item)) {
 562                                relevant_change |= !st->treesame[n];
 563                                relevant_parents++;
 564                        } else
 565                                irrelevant_change |= !st->treesame[n];
 566                }
 567                if (relevant_parents ? relevant_change : irrelevant_change)
 568                        commit->object.flags &= ~TREESAME;
 569                else
 570                        commit->object.flags |= TREESAME;
 571        }
 572
 573        return commit->object.flags & TREESAME;
 574}
 575
 576static inline int limiting_can_increase_treesame(const struct rev_info *revs)
 577{
 578        /*
 579         * TREESAME is irrelevant unless prune && dense;
 580         * if simplify_history is set, we can't have a mixture of TREESAME and
 581         *    !TREESAME INTERESTING parents (and we don't have treesame[]
 582         *    decoration anyway);
 583         * if first_parent_only is set, then the TREESAME flag is locked
 584         *    against the first parent (and again we lack treesame[] decoration).
 585         */
 586        return revs->prune && revs->dense &&
 587               !revs->simplify_history &&
 588               !revs->first_parent_only;
 589}
 590
 591static void try_to_simplify_commit(struct rev_info *revs, struct commit *commit)
 592{
 593        struct commit_list **pp, *parent;
 594        struct treesame_state *ts = NULL;
 595        int relevant_change = 0, irrelevant_change = 0;
 596        int relevant_parents, nth_parent;
 597
 598        /*
 599         * If we don't do pruning, everything is interesting
 600         */
 601        if (!revs->prune)
 602                return;
 603
 604        if (!commit->tree)
 605                return;
 606
 607        if (!commit->parents) {
 608                if (rev_same_tree_as_empty(revs, commit))
 609                        commit->object.flags |= TREESAME;
 610                return;
 611        }
 612
 613        /*
 614         * Normal non-merge commit? If we don't want to make the
 615         * history dense, we consider it always to be a change..
 616         */
 617        if (!revs->dense && !commit->parents->next)
 618                return;
 619
 620        for (pp = &commit->parents, nth_parent = 0, relevant_parents = 0;
 621             (parent = *pp) != NULL;
 622             pp = &parent->next, nth_parent++) {
 623                struct commit *p = parent->item;
 624                if (relevant_commit(p))
 625                        relevant_parents++;
 626
 627                if (nth_parent == 1) {
 628                        /*
 629                         * This our second loop iteration - so we now know
 630                         * we're dealing with a merge.
 631                         *
 632                         * Do not compare with later parents when we care only about
 633                         * the first parent chain, in order to avoid derailing the
 634                         * traversal to follow a side branch that brought everything
 635                         * in the path we are limited to by the pathspec.
 636                         */
 637                        if (revs->first_parent_only)
 638                                break;
 639                        /*
 640                         * If this will remain a potentially-simplifiable
 641                         * merge, remember per-parent treesame if needed.
 642                         * Initialise the array with the comparison from our
 643                         * first iteration.
 644                         */
 645                        if (revs->treesame.name &&
 646                            !revs->simplify_history &&
 647                            !(commit->object.flags & UNINTERESTING)) {
 648                                ts = initialise_treesame(revs, commit);
 649                                if (!(irrelevant_change || relevant_change))
 650                                        ts->treesame[0] = 1;
 651                        }
 652                }
 653                if (parse_commit(p) < 0)
 654                        die("cannot simplify commit %s (because of %s)",
 655                            oid_to_hex(&commit->object.oid),
 656                            oid_to_hex(&p->object.oid));
 657                switch (rev_compare_tree(revs, p, commit)) {
 658                case REV_TREE_SAME:
 659                        if (!revs->simplify_history || !relevant_commit(p)) {
 660                                /* Even if a merge with an uninteresting
 661                                 * side branch brought the entire change
 662                                 * we are interested in, we do not want
 663                                 * to lose the other branches of this
 664                                 * merge, so we just keep going.
 665                                 */
 666                                if (ts)
 667                                        ts->treesame[nth_parent] = 1;
 668                                continue;
 669                        }
 670                        parent->next = NULL;
 671                        commit->parents = parent;
 672                        commit->object.flags |= TREESAME;
 673                        return;
 674
 675                case REV_TREE_NEW:
 676                        if (revs->remove_empty_trees &&
 677                            rev_same_tree_as_empty(revs, p)) {
 678                                /* We are adding all the specified
 679                                 * paths from this parent, so the
 680                                 * history beyond this parent is not
 681                                 * interesting.  Remove its parents
 682                                 * (they are grandparents for us).
 683                                 * IOW, we pretend this parent is a
 684                                 * "root" commit.
 685                                 */
 686                                if (parse_commit(p) < 0)
 687                                        die("cannot simplify commit %s (invalid %s)",
 688                                            oid_to_hex(&commit->object.oid),
 689                                            oid_to_hex(&p->object.oid));
 690                                p->parents = NULL;
 691                        }
 692                /* fallthrough */
 693                case REV_TREE_OLD:
 694                case REV_TREE_DIFFERENT:
 695                        if (relevant_commit(p))
 696                                relevant_change = 1;
 697                        else
 698                                irrelevant_change = 1;
 699                        continue;
 700                }
 701                die("bad tree compare for commit %s", oid_to_hex(&commit->object.oid));
 702        }
 703
 704        /*
 705         * TREESAME is straightforward for single-parent commits. For merge
 706         * commits, it is most useful to define it so that "irrelevant"
 707         * parents cannot make us !TREESAME - if we have any relevant
 708         * parents, then we only consider TREESAMEness with respect to them,
 709         * allowing irrelevant merges from uninteresting branches to be
 710         * simplified away. Only if we have only irrelevant parents do we
 711         * base TREESAME on them. Note that this logic is replicated in
 712         * update_treesame, which should be kept in sync.
 713         */
 714        if (relevant_parents ? !relevant_change : !irrelevant_change)
 715                commit->object.flags |= TREESAME;
 716}
 717
 718static void commit_list_insert_by_date_cached(struct commit *p, struct commit_list **head,
 719                    struct commit_list *cached_base, struct commit_list **cache)
 720{
 721        struct commit_list *new_entry;
 722
 723        if (cached_base && p->date < cached_base->item->date)
 724                new_entry = commit_list_insert_by_date(p, &cached_base->next);
 725        else
 726                new_entry = commit_list_insert_by_date(p, head);
 727
 728        if (cache && (!*cache || p->date < (*cache)->item->date))
 729                *cache = new_entry;
 730}
 731
 732static int add_parents_to_list(struct rev_info *revs, struct commit *commit,
 733                    struct commit_list **list, struct commit_list **cache_ptr)
 734{
 735        struct commit_list *parent = commit->parents;
 736        unsigned left_flag;
 737        struct commit_list *cached_base = cache_ptr ? *cache_ptr : NULL;
 738
 739        if (commit->object.flags & ADDED)
 740                return 0;
 741        commit->object.flags |= ADDED;
 742
 743        if (revs->include_check &&
 744            !revs->include_check(commit, revs->include_check_data))
 745                return 0;
 746
 747        /*
 748         * If the commit is uninteresting, don't try to
 749         * prune parents - we want the maximal uninteresting
 750         * set.
 751         *
 752         * Normally we haven't parsed the parent
 753         * yet, so we won't have a parent of a parent
 754         * here. However, it may turn out that we've
 755         * reached this commit some other way (where it
 756         * wasn't uninteresting), in which case we need
 757         * to mark its parents recursively too..
 758         */
 759        if (commit->object.flags & UNINTERESTING) {
 760                while (parent) {
 761                        struct commit *p = parent->item;
 762                        parent = parent->next;
 763                        if (p)
 764                                p->object.flags |= UNINTERESTING;
 765                        if (parse_commit_gently(p, 1) < 0)
 766                                continue;
 767                        if (p->parents)
 768                                mark_parents_uninteresting(p);
 769                        if (p->object.flags & SEEN)
 770                                continue;
 771                        p->object.flags |= SEEN;
 772                        commit_list_insert_by_date_cached(p, list, cached_base, cache_ptr);
 773                }
 774                return 0;
 775        }
 776
 777        /*
 778         * Ok, the commit wasn't uninteresting. Try to
 779         * simplify the commit history and find the parent
 780         * that has no differences in the path set if one exists.
 781         */
 782        try_to_simplify_commit(revs, commit);
 783
 784        if (revs->no_walk)
 785                return 0;
 786
 787        left_flag = (commit->object.flags & SYMMETRIC_LEFT);
 788
 789        for (parent = commit->parents; parent; parent = parent->next) {
 790                struct commit *p = parent->item;
 791
 792                if (parse_commit_gently(p, revs->ignore_missing_links) < 0)
 793                        return -1;
 794                if (revs->show_source && !p->util)
 795                        p->util = commit->util;
 796                p->object.flags |= left_flag;
 797                if (!(p->object.flags & SEEN)) {
 798                        p->object.flags |= SEEN;
 799                        commit_list_insert_by_date_cached(p, list, cached_base, cache_ptr);
 800                }
 801                if (revs->first_parent_only)
 802                        break;
 803        }
 804        return 0;
 805}
 806
 807static void cherry_pick_list(struct commit_list *list, struct rev_info *revs)
 808{
 809        struct commit_list *p;
 810        int left_count = 0, right_count = 0;
 811        int left_first;
 812        struct patch_ids ids;
 813        unsigned cherry_flag;
 814
 815        /* First count the commits on the left and on the right */
 816        for (p = list; p; p = p->next) {
 817                struct commit *commit = p->item;
 818                unsigned flags = commit->object.flags;
 819                if (flags & BOUNDARY)
 820                        ;
 821                else if (flags & SYMMETRIC_LEFT)
 822                        left_count++;
 823                else
 824                        right_count++;
 825        }
 826
 827        if (!left_count || !right_count)
 828                return;
 829
 830        left_first = left_count < right_count;
 831        init_patch_ids(&ids);
 832        ids.diffopts.pathspec = revs->diffopt.pathspec;
 833
 834        /* Compute patch-ids for one side */
 835        for (p = list; p; p = p->next) {
 836                struct commit *commit = p->item;
 837                unsigned flags = commit->object.flags;
 838
 839                if (flags & BOUNDARY)
 840                        continue;
 841                /*
 842                 * If we have fewer left, left_first is set and we omit
 843                 * commits on the right branch in this loop.  If we have
 844                 * fewer right, we skip the left ones.
 845                 */
 846                if (left_first != !!(flags & SYMMETRIC_LEFT))
 847                        continue;
 848                add_commit_patch_id(commit, &ids);
 849        }
 850
 851        /* either cherry_mark or cherry_pick are true */
 852        cherry_flag = revs->cherry_mark ? PATCHSAME : SHOWN;
 853
 854        /* Check the other side */
 855        for (p = list; p; p = p->next) {
 856                struct commit *commit = p->item;
 857                struct patch_id *id;
 858                unsigned flags = commit->object.flags;
 859
 860                if (flags & BOUNDARY)
 861                        continue;
 862                /*
 863                 * If we have fewer left, left_first is set and we omit
 864                 * commits on the left branch in this loop.
 865                 */
 866                if (left_first == !!(flags & SYMMETRIC_LEFT))
 867                        continue;
 868
 869                /*
 870                 * Have we seen the same patch id?
 871                 */
 872                id = has_commit_patch_id(commit, &ids);
 873                if (!id)
 874                        continue;
 875
 876                commit->object.flags |= cherry_flag;
 877                id->commit->object.flags |= cherry_flag;
 878        }
 879
 880        free_patch_ids(&ids);
 881}
 882
 883/* How many extra uninteresting commits we want to see.. */
 884#define SLOP 5
 885
 886static int still_interesting(struct commit_list *src, timestamp_t date, int slop,
 887                             struct commit **interesting_cache)
 888{
 889        /*
 890         * No source list at all? We're definitely done..
 891         */
 892        if (!src)
 893                return 0;
 894
 895        /*
 896         * Does the destination list contain entries with a date
 897         * before the source list? Definitely _not_ done.
 898         */
 899        if (date <= src->item->date)
 900                return SLOP;
 901
 902        /*
 903         * Does the source list still have interesting commits in
 904         * it? Definitely not done..
 905         */
 906        if (!everybody_uninteresting(src, interesting_cache))
 907                return SLOP;
 908
 909        /* Ok, we're closing in.. */
 910        return slop-1;
 911}
 912
 913/*
 914 * "rev-list --ancestry-path A..B" computes commits that are ancestors
 915 * of B but not ancestors of A but further limits the result to those
 916 * that are descendants of A.  This takes the list of bottom commits and
 917 * the result of "A..B" without --ancestry-path, and limits the latter
 918 * further to the ones that can reach one of the commits in "bottom".
 919 */
 920static void limit_to_ancestry(struct commit_list *bottom, struct commit_list *list)
 921{
 922        struct commit_list *p;
 923        struct commit_list *rlist = NULL;
 924        int made_progress;
 925
 926        /*
 927         * Reverse the list so that it will be likely that we would
 928         * process parents before children.
 929         */
 930        for (p = list; p; p = p->next)
 931                commit_list_insert(p->item, &rlist);
 932
 933        for (p = bottom; p; p = p->next)
 934                p->item->object.flags |= TMP_MARK;
 935
 936        /*
 937         * Mark the ones that can reach bottom commits in "list",
 938         * in a bottom-up fashion.
 939         */
 940        do {
 941                made_progress = 0;
 942                for (p = rlist; p; p = p->next) {
 943                        struct commit *c = p->item;
 944                        struct commit_list *parents;
 945                        if (c->object.flags & (TMP_MARK | UNINTERESTING))
 946                                continue;
 947                        for (parents = c->parents;
 948                             parents;
 949                             parents = parents->next) {
 950                                if (!(parents->item->object.flags & TMP_MARK))
 951                                        continue;
 952                                c->object.flags |= TMP_MARK;
 953                                made_progress = 1;
 954                                break;
 955                        }
 956                }
 957        } while (made_progress);
 958
 959        /*
 960         * NEEDSWORK: decide if we want to remove parents that are
 961         * not marked with TMP_MARK from commit->parents for commits
 962         * in the resulting list.  We may not want to do that, though.
 963         */
 964
 965        /*
 966         * The ones that are not marked with TMP_MARK are uninteresting
 967         */
 968        for (p = list; p; p = p->next) {
 969                struct commit *c = p->item;
 970                if (c->object.flags & TMP_MARK)
 971                        continue;
 972                c->object.flags |= UNINTERESTING;
 973        }
 974
 975        /* We are done with the TMP_MARK */
 976        for (p = list; p; p = p->next)
 977                p->item->object.flags &= ~TMP_MARK;
 978        for (p = bottom; p; p = p->next)
 979                p->item->object.flags &= ~TMP_MARK;
 980        free_commit_list(rlist);
 981}
 982
 983/*
 984 * Before walking the history, keep the set of "negative" refs the
 985 * caller has asked to exclude.
 986 *
 987 * This is used to compute "rev-list --ancestry-path A..B", as we need
 988 * to filter the result of "A..B" further to the ones that can actually
 989 * reach A.
 990 */
 991static struct commit_list *collect_bottom_commits(struct commit_list *list)
 992{
 993        struct commit_list *elem, *bottom = NULL;
 994        for (elem = list; elem; elem = elem->next)
 995                if (elem->item->object.flags & BOTTOM)
 996                        commit_list_insert(elem->item, &bottom);
 997        return bottom;
 998}
 999
1000/* Assumes either left_only or right_only is set */
1001static void limit_left_right(struct commit_list *list, struct rev_info *revs)
1002{
1003        struct commit_list *p;
1004
1005        for (p = list; p; p = p->next) {
1006                struct commit *commit = p->item;
1007
1008                if (revs->right_only) {
1009                        if (commit->object.flags & SYMMETRIC_LEFT)
1010                                commit->object.flags |= SHOWN;
1011                } else  /* revs->left_only is set */
1012                        if (!(commit->object.flags & SYMMETRIC_LEFT))
1013                                commit->object.flags |= SHOWN;
1014        }
1015}
1016
1017static int limit_list(struct rev_info *revs)
1018{
1019        int slop = SLOP;
1020        timestamp_t date = TIME_MAX;
1021        struct commit_list *list = revs->commits;
1022        struct commit_list *newlist = NULL;
1023        struct commit_list **p = &newlist;
1024        struct commit_list *bottom = NULL;
1025        struct commit *interesting_cache = NULL;
1026
1027        if (revs->ancestry_path) {
1028                bottom = collect_bottom_commits(list);
1029                if (!bottom)
1030                        die("--ancestry-path given but there are no bottom commits");
1031        }
1032
1033        while (list) {
1034                struct commit *commit = pop_commit(&list);
1035                struct object *obj = &commit->object;
1036                show_early_output_fn_t show;
1037
1038                if (commit == interesting_cache)
1039                        interesting_cache = NULL;
1040
1041                if (revs->max_age != -1 && (commit->date < revs->max_age))
1042                        obj->flags |= UNINTERESTING;
1043                if (add_parents_to_list(revs, commit, &list, NULL) < 0)
1044                        return -1;
1045                if (obj->flags & UNINTERESTING) {
1046                        mark_parents_uninteresting(commit);
1047                        if (revs->show_all)
1048                                p = &commit_list_insert(commit, p)->next;
1049                        slop = still_interesting(list, date, slop, &interesting_cache);
1050                        if (slop)
1051                                continue;
1052                        /* If showing all, add the whole pending list to the end */
1053                        if (revs->show_all)
1054                                *p = list;
1055                        break;
1056                }
1057                if (revs->min_age != -1 && (commit->date > revs->min_age))
1058                        continue;
1059                date = commit->date;
1060                p = &commit_list_insert(commit, p)->next;
1061
1062                show = show_early_output;
1063                if (!show)
1064                        continue;
1065
1066                show(revs, newlist);
1067                show_early_output = NULL;
1068        }
1069        if (revs->cherry_pick || revs->cherry_mark)
1070                cherry_pick_list(newlist, revs);
1071
1072        if (revs->left_only || revs->right_only)
1073                limit_left_right(newlist, revs);
1074
1075        if (bottom) {
1076                limit_to_ancestry(bottom, newlist);
1077                free_commit_list(bottom);
1078        }
1079
1080        /*
1081         * Check if any commits have become TREESAME by some of their parents
1082         * becoming UNINTERESTING.
1083         */
1084        if (limiting_can_increase_treesame(revs))
1085                for (list = newlist; list; list = list->next) {
1086                        struct commit *c = list->item;
1087                        if (c->object.flags & (UNINTERESTING | TREESAME))
1088                                continue;
1089                        update_treesame(revs, c);
1090                }
1091
1092        revs->commits = newlist;
1093        return 0;
1094}
1095
1096/*
1097 * Add an entry to refs->cmdline with the specified information.
1098 * *name is copied.
1099 */
1100static void add_rev_cmdline(struct rev_info *revs,
1101                            struct object *item,
1102                            const char *name,
1103                            int whence,
1104                            unsigned flags)
1105{
1106        struct rev_cmdline_info *info = &revs->cmdline;
1107        int nr = info->nr;
1108
1109        ALLOC_GROW(info->rev, nr + 1, info->alloc);
1110        info->rev[nr].item = item;
1111        info->rev[nr].name = xstrdup(name);
1112        info->rev[nr].whence = whence;
1113        info->rev[nr].flags = flags;
1114        info->nr++;
1115}
1116
1117static void add_rev_cmdline_list(struct rev_info *revs,
1118                                 struct commit_list *commit_list,
1119                                 int whence,
1120                                 unsigned flags)
1121{
1122        while (commit_list) {
1123                struct object *object = &commit_list->item->object;
1124                add_rev_cmdline(revs, object, oid_to_hex(&object->oid),
1125                                whence, flags);
1126                commit_list = commit_list->next;
1127        }
1128}
1129
1130struct all_refs_cb {
1131        int all_flags;
1132        int warned_bad_reflog;
1133        struct rev_info *all_revs;
1134        const char *name_for_errormsg;
1135        struct ref_store *refs;
1136};
1137
1138int ref_excluded(struct string_list *ref_excludes, const char *path)
1139{
1140        struct string_list_item *item;
1141
1142        if (!ref_excludes)
1143                return 0;
1144        for_each_string_list_item(item, ref_excludes) {
1145                if (!wildmatch(item->string, path, 0))
1146                        return 1;
1147        }
1148        return 0;
1149}
1150
1151static int handle_one_ref(const char *path, const struct object_id *oid,
1152                          int flag, void *cb_data)
1153{
1154        struct all_refs_cb *cb = cb_data;
1155        struct object *object;
1156
1157        if (ref_excluded(cb->all_revs->ref_excludes, path))
1158            return 0;
1159
1160        object = get_reference(cb->all_revs, path, oid, cb->all_flags);
1161        add_rev_cmdline(cb->all_revs, object, path, REV_CMD_REF, cb->all_flags);
1162        add_pending_oid(cb->all_revs, path, oid, cb->all_flags);
1163        return 0;
1164}
1165
1166static void init_all_refs_cb(struct all_refs_cb *cb, struct rev_info *revs,
1167        unsigned flags)
1168{
1169        cb->all_revs = revs;
1170        cb->all_flags = flags;
1171        revs->rev_input_given = 1;
1172        cb->refs = NULL;
1173}
1174
1175void clear_ref_exclusion(struct string_list **ref_excludes_p)
1176{
1177        if (*ref_excludes_p) {
1178                string_list_clear(*ref_excludes_p, 0);
1179                free(*ref_excludes_p);
1180        }
1181        *ref_excludes_p = NULL;
1182}
1183
1184void add_ref_exclusion(struct string_list **ref_excludes_p, const char *exclude)
1185{
1186        if (!*ref_excludes_p) {
1187                *ref_excludes_p = xcalloc(1, sizeof(**ref_excludes_p));
1188                (*ref_excludes_p)->strdup_strings = 1;
1189        }
1190        string_list_append(*ref_excludes_p, exclude);
1191}
1192
1193static void handle_refs(struct ref_store *refs,
1194                        struct rev_info *revs, unsigned flags,
1195                        int (*for_each)(struct ref_store *, each_ref_fn, void *))
1196{
1197        struct all_refs_cb cb;
1198
1199        if (!refs) {
1200                /* this could happen with uninitialized submodules */
1201                return;
1202        }
1203
1204        init_all_refs_cb(&cb, revs, flags);
1205        for_each(refs, handle_one_ref, &cb);
1206}
1207
1208static void handle_one_reflog_commit(struct object_id *oid, void *cb_data)
1209{
1210        struct all_refs_cb *cb = cb_data;
1211        if (!is_null_oid(oid)) {
1212                struct object *o = parse_object(oid);
1213                if (o) {
1214                        o->flags |= cb->all_flags;
1215                        /* ??? CMDLINEFLAGS ??? */
1216                        add_pending_object(cb->all_revs, o, "");
1217                }
1218                else if (!cb->warned_bad_reflog) {
1219                        warning("reflog of '%s' references pruned commits",
1220                                cb->name_for_errormsg);
1221                        cb->warned_bad_reflog = 1;
1222                }
1223        }
1224}
1225
1226static int handle_one_reflog_ent(struct object_id *ooid, struct object_id *noid,
1227                const char *email, timestamp_t timestamp, int tz,
1228                const char *message, void *cb_data)
1229{
1230        handle_one_reflog_commit(ooid, cb_data);
1231        handle_one_reflog_commit(noid, cb_data);
1232        return 0;
1233}
1234
1235static int handle_one_reflog(const char *path, const struct object_id *oid,
1236                             int flag, void *cb_data)
1237{
1238        struct all_refs_cb *cb = cb_data;
1239        cb->warned_bad_reflog = 0;
1240        cb->name_for_errormsg = path;
1241        refs_for_each_reflog_ent(cb->refs, path,
1242                                 handle_one_reflog_ent, cb_data);
1243        return 0;
1244}
1245
1246static void add_other_reflogs_to_pending(struct all_refs_cb *cb)
1247{
1248        struct worktree **worktrees, **p;
1249
1250        worktrees = get_worktrees(0);
1251        for (p = worktrees; *p; p++) {
1252                struct worktree *wt = *p;
1253
1254                if (wt->is_current)
1255                        continue;
1256
1257                cb->refs = get_worktree_ref_store(wt);
1258                refs_for_each_reflog(cb->refs,
1259                                     handle_one_reflog,
1260                                     cb);
1261        }
1262        free_worktrees(worktrees);
1263}
1264
1265void add_reflogs_to_pending(struct rev_info *revs, unsigned flags)
1266{
1267        struct all_refs_cb cb;
1268
1269        cb.all_revs = revs;
1270        cb.all_flags = flags;
1271        cb.refs = get_main_ref_store();
1272        for_each_reflog(handle_one_reflog, &cb);
1273
1274        if (!revs->single_worktree)
1275                add_other_reflogs_to_pending(&cb);
1276}
1277
1278static void add_cache_tree(struct cache_tree *it, struct rev_info *revs,
1279                           struct strbuf *path)
1280{
1281        size_t baselen = path->len;
1282        int i;
1283
1284        if (it->entry_count >= 0) {
1285                struct tree *tree = lookup_tree(&it->oid);
1286                add_pending_object_with_path(revs, &tree->object, "",
1287                                             040000, path->buf);
1288        }
1289
1290        for (i = 0; i < it->subtree_nr; i++) {
1291                struct cache_tree_sub *sub = it->down[i];
1292                strbuf_addf(path, "%s%s", baselen ? "/" : "", sub->name);
1293                add_cache_tree(sub->cache_tree, revs, path);
1294                strbuf_setlen(path, baselen);
1295        }
1296
1297}
1298
1299static void do_add_index_objects_to_pending(struct rev_info *revs,
1300                                            struct index_state *istate)
1301{
1302        int i;
1303
1304        for (i = 0; i < istate->cache_nr; i++) {
1305                struct cache_entry *ce = istate->cache[i];
1306                struct blob *blob;
1307
1308                if (S_ISGITLINK(ce->ce_mode))
1309                        continue;
1310
1311                blob = lookup_blob(&ce->oid);
1312                if (!blob)
1313                        die("unable to add index blob to traversal");
1314                add_pending_object_with_path(revs, &blob->object, "",
1315                                             ce->ce_mode, ce->name);
1316        }
1317
1318        if (istate->cache_tree) {
1319                struct strbuf path = STRBUF_INIT;
1320                add_cache_tree(istate->cache_tree, revs, &path);
1321                strbuf_release(&path);
1322        }
1323}
1324
1325void add_index_objects_to_pending(struct rev_info *revs, unsigned int flags)
1326{
1327        struct worktree **worktrees, **p;
1328
1329        read_cache();
1330        do_add_index_objects_to_pending(revs, &the_index);
1331
1332        if (revs->single_worktree)
1333                return;
1334
1335        worktrees = get_worktrees(0);
1336        for (p = worktrees; *p; p++) {
1337                struct worktree *wt = *p;
1338                struct index_state istate = { NULL };
1339
1340                if (wt->is_current)
1341                        continue; /* current index already taken care of */
1342
1343                if (read_index_from(&istate,
1344                                    worktree_git_path(wt, "index")) > 0)
1345                        do_add_index_objects_to_pending(revs, &istate);
1346                discard_index(&istate);
1347        }
1348        free_worktrees(worktrees);
1349}
1350
1351static int add_parents_only(struct rev_info *revs, const char *arg_, int flags,
1352                            int exclude_parent)
1353{
1354        struct object_id oid;
1355        struct object *it;
1356        struct commit *commit;
1357        struct commit_list *parents;
1358        int parent_number;
1359        const char *arg = arg_;
1360
1361        if (*arg == '^') {
1362                flags ^= UNINTERESTING | BOTTOM;
1363                arg++;
1364        }
1365        if (get_oid_committish(arg, &oid))
1366                return 0;
1367        while (1) {
1368                it = get_reference(revs, arg, &oid, 0);
1369                if (!it && revs->ignore_missing)
1370                        return 0;
1371                if (it->type != OBJ_TAG)
1372                        break;
1373                if (!((struct tag*)it)->tagged)
1374                        return 0;
1375                oidcpy(&oid, &((struct tag*)it)->tagged->oid);
1376        }
1377        if (it->type != OBJ_COMMIT)
1378                return 0;
1379        commit = (struct commit *)it;
1380        if (exclude_parent &&
1381            exclude_parent > commit_list_count(commit->parents))
1382                return 0;
1383        for (parents = commit->parents, parent_number = 1;
1384             parents;
1385             parents = parents->next, parent_number++) {
1386                if (exclude_parent && parent_number != exclude_parent)
1387                        continue;
1388
1389                it = &parents->item->object;
1390                it->flags |= flags;
1391                add_rev_cmdline(revs, it, arg_, REV_CMD_PARENTS_ONLY, flags);
1392                add_pending_object(revs, it, arg);
1393        }
1394        return 1;
1395}
1396
1397void init_revisions(struct rev_info *revs, const char *prefix)
1398{
1399        memset(revs, 0, sizeof(*revs));
1400
1401        revs->abbrev = DEFAULT_ABBREV;
1402        revs->ignore_merges = 1;
1403        revs->simplify_history = 1;
1404        DIFF_OPT_SET(&revs->pruning, RECURSIVE);
1405        DIFF_OPT_SET(&revs->pruning, QUICK);
1406        revs->pruning.add_remove = file_add_remove;
1407        revs->pruning.change = file_change;
1408        revs->sort_order = REV_SORT_IN_GRAPH_ORDER;
1409        revs->dense = 1;
1410        revs->prefix = prefix;
1411        revs->max_age = -1;
1412        revs->min_age = -1;
1413        revs->skip_count = -1;
1414        revs->max_count = -1;
1415        revs->max_parents = -1;
1416        revs->expand_tabs_in_log = -1;
1417
1418        revs->commit_format = CMIT_FMT_DEFAULT;
1419        revs->expand_tabs_in_log_default = 8;
1420
1421        init_grep_defaults();
1422        grep_init(&revs->grep_filter, prefix);
1423        revs->grep_filter.status_only = 1;
1424
1425        diff_setup(&revs->diffopt);
1426        if (prefix && !revs->diffopt.prefix) {
1427                revs->diffopt.prefix = prefix;
1428                revs->diffopt.prefix_length = strlen(prefix);
1429        }
1430
1431        revs->notes_opt.use_default_notes = -1;
1432}
1433
1434static void add_pending_commit_list(struct rev_info *revs,
1435                                    struct commit_list *commit_list,
1436                                    unsigned int flags)
1437{
1438        while (commit_list) {
1439                struct object *object = &commit_list->item->object;
1440                object->flags |= flags;
1441                add_pending_object(revs, object, oid_to_hex(&object->oid));
1442                commit_list = commit_list->next;
1443        }
1444}
1445
1446static void prepare_show_merge(struct rev_info *revs)
1447{
1448        struct commit_list *bases;
1449        struct commit *head, *other;
1450        struct object_id oid;
1451        const char **prune = NULL;
1452        int i, prune_num = 1; /* counting terminating NULL */
1453
1454        if (get_oid("HEAD", &oid))
1455                die("--merge without HEAD?");
1456        head = lookup_commit_or_die(&oid, "HEAD");
1457        if (get_oid("MERGE_HEAD", &oid))
1458                die("--merge without MERGE_HEAD?");
1459        other = lookup_commit_or_die(&oid, "MERGE_HEAD");
1460        add_pending_object(revs, &head->object, "HEAD");
1461        add_pending_object(revs, &other->object, "MERGE_HEAD");
1462        bases = get_merge_bases(head, other);
1463        add_rev_cmdline_list(revs, bases, REV_CMD_MERGE_BASE, UNINTERESTING | BOTTOM);
1464        add_pending_commit_list(revs, bases, UNINTERESTING | BOTTOM);
1465        free_commit_list(bases);
1466        head->object.flags |= SYMMETRIC_LEFT;
1467
1468        if (!active_nr)
1469                read_cache();
1470        for (i = 0; i < active_nr; i++) {
1471                const struct cache_entry *ce = active_cache[i];
1472                if (!ce_stage(ce))
1473                        continue;
1474                if (ce_path_match(ce, &revs->prune_data, NULL)) {
1475                        prune_num++;
1476                        REALLOC_ARRAY(prune, prune_num);
1477                        prune[prune_num-2] = ce->name;
1478                        prune[prune_num-1] = NULL;
1479                }
1480                while ((i+1 < active_nr) &&
1481                       ce_same_name(ce, active_cache[i+1]))
1482                        i++;
1483        }
1484        clear_pathspec(&revs->prune_data);
1485        parse_pathspec(&revs->prune_data, PATHSPEC_ALL_MAGIC & ~PATHSPEC_LITERAL,
1486                       PATHSPEC_PREFER_FULL | PATHSPEC_LITERAL_PATH, "", prune);
1487        revs->limited = 1;
1488}
1489
1490static int dotdot_missing(const char *arg, char *dotdot,
1491                          struct rev_info *revs, int symmetric)
1492{
1493        if (revs->ignore_missing)
1494                return 0;
1495        /* de-munge so we report the full argument */
1496        *dotdot = '.';
1497        die(symmetric
1498            ? "Invalid symmetric difference expression %s"
1499            : "Invalid revision range %s", arg);
1500}
1501
1502static int handle_dotdot_1(const char *arg, char *dotdot,
1503                           struct rev_info *revs, int flags,
1504                           int cant_be_filename,
1505                           struct object_context *a_oc,
1506                           struct object_context *b_oc)
1507{
1508        const char *a_name, *b_name;
1509        struct object_id a_oid, b_oid;
1510        struct object *a_obj, *b_obj;
1511        unsigned int a_flags, b_flags;
1512        int symmetric = 0;
1513        unsigned int flags_exclude = flags ^ (UNINTERESTING | BOTTOM);
1514        unsigned int oc_flags = GET_OID_COMMITTISH | GET_OID_RECORD_PATH;
1515
1516        a_name = arg;
1517        if (!*a_name)
1518                a_name = "HEAD";
1519
1520        b_name = dotdot + 2;
1521        if (*b_name == '.') {
1522                symmetric = 1;
1523                b_name++;
1524        }
1525        if (!*b_name)
1526                b_name = "HEAD";
1527
1528        if (get_oid_with_context(a_name, oc_flags, &a_oid, a_oc) ||
1529            get_oid_with_context(b_name, oc_flags, &b_oid, b_oc))
1530                return -1;
1531
1532        if (!cant_be_filename) {
1533                *dotdot = '.';
1534                verify_non_filename(revs->prefix, arg);
1535                *dotdot = '\0';
1536        }
1537
1538        a_obj = parse_object(&a_oid);
1539        b_obj = parse_object(&b_oid);
1540        if (!a_obj || !b_obj)
1541                return dotdot_missing(arg, dotdot, revs, symmetric);
1542
1543        if (!symmetric) {
1544                /* just A..B */
1545                b_flags = flags;
1546                a_flags = flags_exclude;
1547        } else {
1548                /* A...B -- find merge bases between the two */
1549                struct commit *a, *b;
1550                struct commit_list *exclude;
1551
1552                a = lookup_commit_reference(&a_obj->oid);
1553                b = lookup_commit_reference(&b_obj->oid);
1554                if (!a || !b)
1555                        return dotdot_missing(arg, dotdot, revs, symmetric);
1556
1557                exclude = get_merge_bases(a, b);
1558                add_rev_cmdline_list(revs, exclude, REV_CMD_MERGE_BASE,
1559                                     flags_exclude);
1560                add_pending_commit_list(revs, exclude, flags_exclude);
1561                free_commit_list(exclude);
1562
1563                b_flags = flags;
1564                a_flags = flags | SYMMETRIC_LEFT;
1565        }
1566
1567        a_obj->flags |= a_flags;
1568        b_obj->flags |= b_flags;
1569        add_rev_cmdline(revs, a_obj, a_name, REV_CMD_LEFT, a_flags);
1570        add_rev_cmdline(revs, b_obj, b_name, REV_CMD_RIGHT, b_flags);
1571        add_pending_object_with_path(revs, a_obj, a_name, a_oc->mode, a_oc->path);
1572        add_pending_object_with_path(revs, b_obj, b_name, b_oc->mode, b_oc->path);
1573        return 0;
1574}
1575
1576static int handle_dotdot(const char *arg,
1577                         struct rev_info *revs, int flags,
1578                         int cant_be_filename)
1579{
1580        struct object_context a_oc, b_oc;
1581        char *dotdot = strstr(arg, "..");
1582        int ret;
1583
1584        if (!dotdot)
1585                return -1;
1586
1587        memset(&a_oc, 0, sizeof(a_oc));
1588        memset(&b_oc, 0, sizeof(b_oc));
1589
1590        *dotdot = '\0';
1591        ret = handle_dotdot_1(arg, dotdot, revs, flags, cant_be_filename,
1592                              &a_oc, &b_oc);
1593        *dotdot = '.';
1594
1595        free(a_oc.path);
1596        free(b_oc.path);
1597
1598        return ret;
1599}
1600
1601int handle_revision_arg(const char *arg_, struct rev_info *revs, int flags, unsigned revarg_opt)
1602{
1603        struct object_context oc;
1604        char *mark;
1605        struct object *object;
1606        struct object_id oid;
1607        int local_flags;
1608        const char *arg = arg_;
1609        int cant_be_filename = revarg_opt & REVARG_CANNOT_BE_FILENAME;
1610        unsigned get_sha1_flags = GET_OID_RECORD_PATH;
1611
1612        flags = flags & UNINTERESTING ? flags | BOTTOM : flags & ~BOTTOM;
1613
1614        if (!cant_be_filename && !strcmp(arg, "..")) {
1615                /*
1616                 * Just ".."?  That is not a range but the
1617                 * pathspec for the parent directory.
1618                 */
1619                return -1;
1620        }
1621
1622        if (!handle_dotdot(arg, revs, flags, revarg_opt))
1623                return 0;
1624
1625        mark = strstr(arg, "^@");
1626        if (mark && !mark[2]) {
1627                *mark = 0;
1628                if (add_parents_only(revs, arg, flags, 0))
1629                        return 0;
1630                *mark = '^';
1631        }
1632        mark = strstr(arg, "^!");
1633        if (mark && !mark[2]) {
1634                *mark = 0;
1635                if (!add_parents_only(revs, arg, flags ^ (UNINTERESTING | BOTTOM), 0))
1636                        *mark = '^';
1637        }
1638        mark = strstr(arg, "^-");
1639        if (mark) {
1640                int exclude_parent = 1;
1641
1642                if (mark[2]) {
1643                        char *end;
1644                        exclude_parent = strtoul(mark + 2, &end, 10);
1645                        if (*end != '\0' || !exclude_parent)
1646                                return -1;
1647                }
1648
1649                *mark = 0;
1650                if (!add_parents_only(revs, arg, flags ^ (UNINTERESTING | BOTTOM), exclude_parent))
1651                        *mark = '^';
1652        }
1653
1654        local_flags = 0;
1655        if (*arg == '^') {
1656                local_flags = UNINTERESTING | BOTTOM;
1657                arg++;
1658        }
1659
1660        if (revarg_opt & REVARG_COMMITTISH)
1661                get_sha1_flags |= GET_OID_COMMITTISH;
1662
1663        if (get_oid_with_context(arg, get_sha1_flags, &oid, &oc))
1664                return revs->ignore_missing ? 0 : -1;
1665        if (!cant_be_filename)
1666                verify_non_filename(revs->prefix, arg);
1667        object = get_reference(revs, arg, &oid, flags ^ local_flags);
1668        add_rev_cmdline(revs, object, arg_, REV_CMD_REV, flags ^ local_flags);
1669        add_pending_object_with_path(revs, object, arg, oc.mode, oc.path);
1670        free(oc.path);
1671        return 0;
1672}
1673
1674struct cmdline_pathspec {
1675        int alloc;
1676        int nr;
1677        const char **path;
1678};
1679
1680static void append_prune_data(struct cmdline_pathspec *prune, const char **av)
1681{
1682        while (*av) {
1683                ALLOC_GROW(prune->path, prune->nr + 1, prune->alloc);
1684                prune->path[prune->nr++] = *(av++);
1685        }
1686}
1687
1688static void read_pathspec_from_stdin(struct rev_info *revs, struct strbuf *sb,
1689                                     struct cmdline_pathspec *prune)
1690{
1691        while (strbuf_getline(sb, stdin) != EOF) {
1692                ALLOC_GROW(prune->path, prune->nr + 1, prune->alloc);
1693                prune->path[prune->nr++] = xstrdup(sb->buf);
1694        }
1695}
1696
1697static void read_revisions_from_stdin(struct rev_info *revs,
1698                                      struct cmdline_pathspec *prune)
1699{
1700        struct strbuf sb;
1701        int seen_dashdash = 0;
1702        int save_warning;
1703
1704        save_warning = warn_on_object_refname_ambiguity;
1705        warn_on_object_refname_ambiguity = 0;
1706
1707        strbuf_init(&sb, 1000);
1708        while (strbuf_getline(&sb, stdin) != EOF) {
1709                int len = sb.len;
1710                if (!len)
1711                        break;
1712                if (sb.buf[0] == '-') {
1713                        if (len == 2 && sb.buf[1] == '-') {
1714                                seen_dashdash = 1;
1715                                break;
1716                        }
1717                        die("options not supported in --stdin mode");
1718                }
1719                if (handle_revision_arg(sb.buf, revs, 0,
1720                                        REVARG_CANNOT_BE_FILENAME))
1721                        die("bad revision '%s'", sb.buf);
1722        }
1723        if (seen_dashdash)
1724                read_pathspec_from_stdin(revs, &sb, prune);
1725
1726        strbuf_release(&sb);
1727        warn_on_object_refname_ambiguity = save_warning;
1728}
1729
1730static void add_grep(struct rev_info *revs, const char *ptn, enum grep_pat_token what)
1731{
1732        append_grep_pattern(&revs->grep_filter, ptn, "command line", 0, what);
1733}
1734
1735static void add_header_grep(struct rev_info *revs, enum grep_header_field field, const char *pattern)
1736{
1737        append_header_grep_pattern(&revs->grep_filter, field, pattern);
1738}
1739
1740static void add_message_grep(struct rev_info *revs, const char *pattern)
1741{
1742        add_grep(revs, pattern, GREP_PATTERN_BODY);
1743}
1744
1745static int handle_revision_opt(struct rev_info *revs, int argc, const char **argv,
1746                               int *unkc, const char **unkv)
1747{
1748        const char *arg = argv[0];
1749        const char *optarg;
1750        int argcount;
1751
1752        /* pseudo revision arguments */
1753        if (!strcmp(arg, "--all") || !strcmp(arg, "--branches") ||
1754            !strcmp(arg, "--tags") || !strcmp(arg, "--remotes") ||
1755            !strcmp(arg, "--reflog") || !strcmp(arg, "--not") ||
1756            !strcmp(arg, "--no-walk") || !strcmp(arg, "--do-walk") ||
1757            !strcmp(arg, "--bisect") || starts_with(arg, "--glob=") ||
1758            !strcmp(arg, "--indexed-objects") ||
1759            starts_with(arg, "--exclude=") ||
1760            starts_with(arg, "--branches=") || starts_with(arg, "--tags=") ||
1761            starts_with(arg, "--remotes=") || starts_with(arg, "--no-walk="))
1762        {
1763                unkv[(*unkc)++] = arg;
1764                return 1;
1765        }
1766
1767        if ((argcount = parse_long_opt("max-count", argv, &optarg))) {
1768                revs->max_count = atoi(optarg);
1769                revs->no_walk = 0;
1770                return argcount;
1771        } else if ((argcount = parse_long_opt("skip", argv, &optarg))) {
1772                revs->skip_count = atoi(optarg);
1773                return argcount;
1774        } else if ((*arg == '-') && isdigit(arg[1])) {
1775                /* accept -<digit>, like traditional "head" */
1776                if (strtol_i(arg + 1, 10, &revs->max_count) < 0 ||
1777                    revs->max_count < 0)
1778                        die("'%s': not a non-negative integer", arg + 1);
1779                revs->no_walk = 0;
1780        } else if (!strcmp(arg, "-n")) {
1781                if (argc <= 1)
1782                        return error("-n requires an argument");
1783                revs->max_count = atoi(argv[1]);
1784                revs->no_walk = 0;
1785                return 2;
1786        } else if (skip_prefix(arg, "-n", &optarg)) {
1787                revs->max_count = atoi(optarg);
1788                revs->no_walk = 0;
1789        } else if ((argcount = parse_long_opt("max-age", argv, &optarg))) {
1790                revs->max_age = atoi(optarg);
1791                return argcount;
1792        } else if ((argcount = parse_long_opt("since", argv, &optarg))) {
1793                revs->max_age = approxidate(optarg);
1794                return argcount;
1795        } else if ((argcount = parse_long_opt("after", argv, &optarg))) {
1796                revs->max_age = approxidate(optarg);
1797                return argcount;
1798        } else if ((argcount = parse_long_opt("min-age", argv, &optarg))) {
1799                revs->min_age = atoi(optarg);
1800                return argcount;
1801        } else if ((argcount = parse_long_opt("before", argv, &optarg))) {
1802                revs->min_age = approxidate(optarg);
1803                return argcount;
1804        } else if ((argcount = parse_long_opt("until", argv, &optarg))) {
1805                revs->min_age = approxidate(optarg);
1806                return argcount;
1807        } else if (!strcmp(arg, "--first-parent")) {
1808                revs->first_parent_only = 1;
1809        } else if (!strcmp(arg, "--ancestry-path")) {
1810                revs->ancestry_path = 1;
1811                revs->simplify_history = 0;
1812                revs->limited = 1;
1813        } else if (!strcmp(arg, "-g") || !strcmp(arg, "--walk-reflogs")) {
1814                init_reflog_walk(&revs->reflog_info);
1815        } else if (!strcmp(arg, "--default")) {
1816                if (argc <= 1)
1817                        return error("bad --default argument");
1818                revs->def = argv[1];
1819                return 2;
1820        } else if (!strcmp(arg, "--merge")) {
1821                revs->show_merge = 1;
1822        } else if (!strcmp(arg, "--topo-order")) {
1823                revs->sort_order = REV_SORT_IN_GRAPH_ORDER;
1824                revs->topo_order = 1;
1825        } else if (!strcmp(arg, "--simplify-merges")) {
1826                revs->simplify_merges = 1;
1827                revs->topo_order = 1;
1828                revs->rewrite_parents = 1;
1829                revs->simplify_history = 0;
1830                revs->limited = 1;
1831        } else if (!strcmp(arg, "--simplify-by-decoration")) {
1832                revs->simplify_merges = 1;
1833                revs->topo_order = 1;
1834                revs->rewrite_parents = 1;
1835                revs->simplify_history = 0;
1836                revs->simplify_by_decoration = 1;
1837                revs->limited = 1;
1838                revs->prune = 1;
1839                load_ref_decorations(DECORATE_SHORT_REFS);
1840        } else if (!strcmp(arg, "--date-order")) {
1841                revs->sort_order = REV_SORT_BY_COMMIT_DATE;
1842                revs->topo_order = 1;
1843        } else if (!strcmp(arg, "--author-date-order")) {
1844                revs->sort_order = REV_SORT_BY_AUTHOR_DATE;
1845                revs->topo_order = 1;
1846        } else if (!strcmp(arg, "--early-output")) {
1847                revs->early_output = 100;
1848                revs->topo_order = 1;
1849        } else if (skip_prefix(arg, "--early-output=", &optarg)) {
1850                if (strtoul_ui(optarg, 10, &revs->early_output) < 0)
1851                        die("'%s': not a non-negative integer", optarg);
1852                revs->topo_order = 1;
1853        } else if (!strcmp(arg, "--parents")) {
1854                revs->rewrite_parents = 1;
1855                revs->print_parents = 1;
1856        } else if (!strcmp(arg, "--dense")) {
1857                revs->dense = 1;
1858        } else if (!strcmp(arg, "--sparse")) {
1859                revs->dense = 0;
1860        } else if (!strcmp(arg, "--show-all")) {
1861                revs->show_all = 1;
1862        } else if (!strcmp(arg, "--remove-empty")) {
1863                revs->remove_empty_trees = 1;
1864        } else if (!strcmp(arg, "--merges")) {
1865                revs->min_parents = 2;
1866        } else if (!strcmp(arg, "--no-merges")) {
1867                revs->max_parents = 1;
1868        } else if (skip_prefix(arg, "--min-parents=", &optarg)) {
1869                revs->min_parents = atoi(optarg);
1870        } else if (!strcmp(arg, "--no-min-parents")) {
1871                revs->min_parents = 0;
1872        } else if (skip_prefix(arg, "--max-parents=", &optarg)) {
1873                revs->max_parents = atoi(optarg);
1874        } else if (!strcmp(arg, "--no-max-parents")) {
1875                revs->max_parents = -1;
1876        } else if (!strcmp(arg, "--boundary")) {
1877                revs->boundary = 1;
1878        } else if (!strcmp(arg, "--left-right")) {
1879                revs->left_right = 1;
1880        } else if (!strcmp(arg, "--left-only")) {
1881                if (revs->right_only)
1882                        die("--left-only is incompatible with --right-only"
1883                            " or --cherry");
1884                revs->left_only = 1;
1885        } else if (!strcmp(arg, "--right-only")) {
1886                if (revs->left_only)
1887                        die("--right-only is incompatible with --left-only");
1888                revs->right_only = 1;
1889        } else if (!strcmp(arg, "--cherry")) {
1890                if (revs->left_only)
1891                        die("--cherry is incompatible with --left-only");
1892                revs->cherry_mark = 1;
1893                revs->right_only = 1;
1894                revs->max_parents = 1;
1895                revs->limited = 1;
1896        } else if (!strcmp(arg, "--count")) {
1897                revs->count = 1;
1898        } else if (!strcmp(arg, "--cherry-mark")) {
1899                if (revs->cherry_pick)
1900                        die("--cherry-mark is incompatible with --cherry-pick");
1901                revs->cherry_mark = 1;
1902                revs->limited = 1; /* needs limit_list() */
1903        } else if (!strcmp(arg, "--cherry-pick")) {
1904                if (revs->cherry_mark)
1905                        die("--cherry-pick is incompatible with --cherry-mark");
1906                revs->cherry_pick = 1;
1907                revs->limited = 1;
1908        } else if (!strcmp(arg, "--objects")) {
1909                revs->tag_objects = 1;
1910                revs->tree_objects = 1;
1911                revs->blob_objects = 1;
1912        } else if (!strcmp(arg, "--objects-edge")) {
1913                revs->tag_objects = 1;
1914                revs->tree_objects = 1;
1915                revs->blob_objects = 1;
1916                revs->edge_hint = 1;
1917        } else if (!strcmp(arg, "--objects-edge-aggressive")) {
1918                revs->tag_objects = 1;
1919                revs->tree_objects = 1;
1920                revs->blob_objects = 1;
1921                revs->edge_hint = 1;
1922                revs->edge_hint_aggressive = 1;
1923        } else if (!strcmp(arg, "--verify-objects")) {
1924                revs->tag_objects = 1;
1925                revs->tree_objects = 1;
1926                revs->blob_objects = 1;
1927                revs->verify_objects = 1;
1928        } else if (!strcmp(arg, "--unpacked")) {
1929                revs->unpacked = 1;
1930        } else if (starts_with(arg, "--unpacked=")) {
1931                die("--unpacked=<packfile> no longer supported.");
1932        } else if (!strcmp(arg, "-r")) {
1933                revs->diff = 1;
1934                DIFF_OPT_SET(&revs->diffopt, RECURSIVE);
1935        } else if (!strcmp(arg, "-t")) {
1936                revs->diff = 1;
1937                DIFF_OPT_SET(&revs->diffopt, RECURSIVE);
1938                DIFF_OPT_SET(&revs->diffopt, TREE_IN_RECURSIVE);
1939        } else if (!strcmp(arg, "-m")) {
1940                revs->ignore_merges = 0;
1941        } else if (!strcmp(arg, "-c")) {
1942                revs->diff = 1;
1943                revs->dense_combined_merges = 0;
1944                revs->combine_merges = 1;
1945        } else if (!strcmp(arg, "--cc")) {
1946                revs->diff = 1;
1947                revs->dense_combined_merges = 1;
1948                revs->combine_merges = 1;
1949        } else if (!strcmp(arg, "-v")) {
1950                revs->verbose_header = 1;
1951        } else if (!strcmp(arg, "--pretty")) {
1952                revs->verbose_header = 1;
1953                revs->pretty_given = 1;
1954                get_commit_format(NULL, revs);
1955        } else if (skip_prefix(arg, "--pretty=", &optarg) ||
1956                   skip_prefix(arg, "--format=", &optarg)) {
1957                /*
1958                 * Detached form ("--pretty X" as opposed to "--pretty=X")
1959                 * not allowed, since the argument is optional.
1960                 */
1961                revs->verbose_header = 1;
1962                revs->pretty_given = 1;
1963                get_commit_format(optarg, revs);
1964        } else if (!strcmp(arg, "--expand-tabs")) {
1965                revs->expand_tabs_in_log = 8;
1966        } else if (!strcmp(arg, "--no-expand-tabs")) {
1967                revs->expand_tabs_in_log = 0;
1968        } else if (skip_prefix(arg, "--expand-tabs=", &arg)) {
1969                int val;
1970                if (strtol_i(arg, 10, &val) < 0 || val < 0)
1971                        die("'%s': not a non-negative integer", arg);
1972                revs->expand_tabs_in_log = val;
1973        } else if (!strcmp(arg, "--show-notes") || !strcmp(arg, "--notes")) {
1974                revs->show_notes = 1;
1975                revs->show_notes_given = 1;
1976                revs->notes_opt.use_default_notes = 1;
1977        } else if (!strcmp(arg, "--show-signature")) {
1978                revs->show_signature = 1;
1979        } else if (!strcmp(arg, "--no-show-signature")) {
1980                revs->show_signature = 0;
1981        } else if (!strcmp(arg, "--show-linear-break")) {
1982                revs->break_bar = "                    ..........";
1983                revs->track_linear = 1;
1984                revs->track_first_time = 1;
1985        } else if (skip_prefix(arg, "--show-linear-break=", &optarg)) {
1986                revs->break_bar = xstrdup(optarg);
1987                revs->track_linear = 1;
1988                revs->track_first_time = 1;
1989        } else if (skip_prefix(arg, "--show-notes=", &optarg) ||
1990                   skip_prefix(arg, "--notes=", &optarg)) {
1991                struct strbuf buf = STRBUF_INIT;
1992                revs->show_notes = 1;
1993                revs->show_notes_given = 1;
1994                if (starts_with(arg, "--show-notes=") &&
1995                    revs->notes_opt.use_default_notes < 0)
1996                        revs->notes_opt.use_default_notes = 1;
1997                strbuf_addstr(&buf, optarg);
1998                expand_notes_ref(&buf);
1999                string_list_append(&revs->notes_opt.extra_notes_refs,
2000                                   strbuf_detach(&buf, NULL));
2001        } else if (!strcmp(arg, "--no-notes")) {
2002                revs->show_notes = 0;
2003                revs->show_notes_given = 1;
2004                revs->notes_opt.use_default_notes = -1;
2005                /* we have been strdup'ing ourselves, so trick
2006                 * string_list into free()ing strings */
2007                revs->notes_opt.extra_notes_refs.strdup_strings = 1;
2008                string_list_clear(&revs->notes_opt.extra_notes_refs, 0);
2009                revs->notes_opt.extra_notes_refs.strdup_strings = 0;
2010        } else if (!strcmp(arg, "--standard-notes")) {
2011                revs->show_notes_given = 1;
2012                revs->notes_opt.use_default_notes = 1;
2013        } else if (!strcmp(arg, "--no-standard-notes")) {
2014                revs->notes_opt.use_default_notes = 0;
2015        } else if (!strcmp(arg, "--oneline")) {
2016                revs->verbose_header = 1;
2017                get_commit_format("oneline", revs);
2018                revs->pretty_given = 1;
2019                revs->abbrev_commit = 1;
2020        } else if (!strcmp(arg, "--graph")) {
2021                revs->topo_order = 1;
2022                revs->rewrite_parents = 1;
2023                revs->graph = graph_init(revs);
2024        } else if (!strcmp(arg, "--root")) {
2025                revs->show_root_diff = 1;
2026        } else if (!strcmp(arg, "--no-commit-id")) {
2027                revs->no_commit_id = 1;
2028        } else if (!strcmp(arg, "--always")) {
2029                revs->always_show_header = 1;
2030        } else if (!strcmp(arg, "--no-abbrev")) {
2031                revs->abbrev = 0;
2032        } else if (!strcmp(arg, "--abbrev")) {
2033                revs->abbrev = DEFAULT_ABBREV;
2034        } else if (skip_prefix(arg, "--abbrev=", &optarg)) {
2035                revs->abbrev = strtoul(optarg, NULL, 10);
2036                if (revs->abbrev < MINIMUM_ABBREV)
2037                        revs->abbrev = MINIMUM_ABBREV;
2038                else if (revs->abbrev > 40)
2039                        revs->abbrev = 40;
2040        } else if (!strcmp(arg, "--abbrev-commit")) {
2041                revs->abbrev_commit = 1;
2042                revs->abbrev_commit_given = 1;
2043        } else if (!strcmp(arg, "--no-abbrev-commit")) {
2044                revs->abbrev_commit = 0;
2045        } else if (!strcmp(arg, "--full-diff")) {
2046                revs->diff = 1;
2047                revs->full_diff = 1;
2048        } else if (!strcmp(arg, "--full-history")) {
2049                revs->simplify_history = 0;
2050        } else if (!strcmp(arg, "--relative-date")) {
2051                revs->date_mode.type = DATE_RELATIVE;
2052                revs->date_mode_explicit = 1;
2053        } else if ((argcount = parse_long_opt("date", argv, &optarg))) {
2054                parse_date_format(optarg, &revs->date_mode);
2055                revs->date_mode_explicit = 1;
2056                return argcount;
2057        } else if (!strcmp(arg, "--log-size")) {
2058                revs->show_log_size = 1;
2059        }
2060        /*
2061         * Grepping the commit log
2062         */
2063        else if ((argcount = parse_long_opt("author", argv, &optarg))) {
2064                add_header_grep(revs, GREP_HEADER_AUTHOR, optarg);
2065                return argcount;
2066        } else if ((argcount = parse_long_opt("committer", argv, &optarg))) {
2067                add_header_grep(revs, GREP_HEADER_COMMITTER, optarg);
2068                return argcount;
2069        } else if ((argcount = parse_long_opt("grep-reflog", argv, &optarg))) {
2070                add_header_grep(revs, GREP_HEADER_REFLOG, optarg);
2071                return argcount;
2072        } else if ((argcount = parse_long_opt("grep", argv, &optarg))) {
2073                add_message_grep(revs, optarg);
2074                return argcount;
2075        } else if (!strcmp(arg, "--grep-debug")) {
2076                revs->grep_filter.debug = 1;
2077        } else if (!strcmp(arg, "--basic-regexp")) {
2078                revs->grep_filter.pattern_type_option = GREP_PATTERN_TYPE_BRE;
2079        } else if (!strcmp(arg, "--extended-regexp") || !strcmp(arg, "-E")) {
2080                revs->grep_filter.pattern_type_option = GREP_PATTERN_TYPE_ERE;
2081        } else if (!strcmp(arg, "--regexp-ignore-case") || !strcmp(arg, "-i")) {
2082                revs->grep_filter.ignore_case = 1;
2083                DIFF_OPT_SET(&revs->diffopt, PICKAXE_IGNORE_CASE);
2084        } else if (!strcmp(arg, "--fixed-strings") || !strcmp(arg, "-F")) {
2085                revs->grep_filter.pattern_type_option = GREP_PATTERN_TYPE_FIXED;
2086        } else if (!strcmp(arg, "--perl-regexp") || !strcmp(arg, "-P")) {
2087                revs->grep_filter.pattern_type_option = GREP_PATTERN_TYPE_PCRE;
2088        } else if (!strcmp(arg, "--all-match")) {
2089                revs->grep_filter.all_match = 1;
2090        } else if (!strcmp(arg, "--invert-grep")) {
2091                revs->invert_grep = 1;
2092        } else if ((argcount = parse_long_opt("encoding", argv, &optarg))) {
2093                if (strcmp(optarg, "none"))
2094                        git_log_output_encoding = xstrdup(optarg);
2095                else
2096                        git_log_output_encoding = "";
2097                return argcount;
2098        } else if (!strcmp(arg, "--reverse")) {
2099                revs->reverse ^= 1;
2100        } else if (!strcmp(arg, "--children")) {
2101                revs->children.name = "children";
2102                revs->limited = 1;
2103        } else if (!strcmp(arg, "--ignore-missing")) {
2104                revs->ignore_missing = 1;
2105        } else {
2106                int opts = diff_opt_parse(&revs->diffopt, argv, argc, revs->prefix);
2107                if (!opts)
2108                        unkv[(*unkc)++] = arg;
2109                return opts;
2110        }
2111        if (revs->graph && revs->track_linear)
2112                die("--show-linear-break and --graph are incompatible");
2113
2114        return 1;
2115}
2116
2117void parse_revision_opt(struct rev_info *revs, struct parse_opt_ctx_t *ctx,
2118                        const struct option *options,
2119                        const char * const usagestr[])
2120{
2121        int n = handle_revision_opt(revs, ctx->argc, ctx->argv,
2122                                    &ctx->cpidx, ctx->out);
2123        if (n <= 0) {
2124                error("unknown option `%s'", ctx->argv[0]);
2125                usage_with_options(usagestr, options);
2126        }
2127        ctx->argv += n;
2128        ctx->argc -= n;
2129}
2130
2131static int for_each_bisect_ref(struct ref_store *refs, each_ref_fn fn,
2132                               void *cb_data, const char *term)
2133{
2134        struct strbuf bisect_refs = STRBUF_INIT;
2135        int status;
2136        strbuf_addf(&bisect_refs, "refs/bisect/%s", term);
2137        status = refs_for_each_fullref_in(refs, bisect_refs.buf, fn, cb_data, 0);
2138        strbuf_release(&bisect_refs);
2139        return status;
2140}
2141
2142static int for_each_bad_bisect_ref(struct ref_store *refs, each_ref_fn fn, void *cb_data)
2143{
2144        return for_each_bisect_ref(refs, fn, cb_data, term_bad);
2145}
2146
2147static int for_each_good_bisect_ref(struct ref_store *refs, each_ref_fn fn, void *cb_data)
2148{
2149        return for_each_bisect_ref(refs, fn, cb_data, term_good);
2150}
2151
2152static int handle_revision_pseudo_opt(const char *submodule,
2153                                struct rev_info *revs,
2154                                int argc, const char **argv, int *flags)
2155{
2156        const char *arg = argv[0];
2157        const char *optarg;
2158        struct ref_store *refs;
2159        int argcount;
2160
2161        if (submodule) {
2162                /*
2163                 * We need some something like get_submodule_worktrees()
2164                 * before we can go through all worktrees of a submodule,
2165                 * .e.g with adding all HEADs from --all, which is not
2166                 * supported right now, so stick to single worktree.
2167                 */
2168                if (!revs->single_worktree)
2169                        die("BUG: --single-worktree cannot be used together with submodule");
2170                refs = get_submodule_ref_store(submodule);
2171        } else
2172                refs = get_main_ref_store();
2173
2174        /*
2175         * NOTE!
2176         *
2177         * Commands like "git shortlog" will not accept the options below
2178         * unless parse_revision_opt queues them (as opposed to erroring
2179         * out).
2180         *
2181         * When implementing your new pseudo-option, remember to
2182         * register it in the list at the top of handle_revision_opt.
2183         */
2184        if (!strcmp(arg, "--all")) {
2185                handle_refs(refs, revs, *flags, refs_for_each_ref);
2186                handle_refs(refs, revs, *flags, refs_head_ref);
2187                if (!revs->single_worktree) {
2188                        struct all_refs_cb cb;
2189
2190                        init_all_refs_cb(&cb, revs, *flags);
2191                        other_head_refs(handle_one_ref, &cb);
2192                }
2193                clear_ref_exclusion(&revs->ref_excludes);
2194        } else if (!strcmp(arg, "--branches")) {
2195                handle_refs(refs, revs, *flags, refs_for_each_branch_ref);
2196                clear_ref_exclusion(&revs->ref_excludes);
2197        } else if (!strcmp(arg, "--bisect")) {
2198                read_bisect_terms(&term_bad, &term_good);
2199                handle_refs(refs, revs, *flags, for_each_bad_bisect_ref);
2200                handle_refs(refs, revs, *flags ^ (UNINTERESTING | BOTTOM),
2201                            for_each_good_bisect_ref);
2202                revs->bisect = 1;
2203        } else if (!strcmp(arg, "--tags")) {
2204                handle_refs(refs, revs, *flags, refs_for_each_tag_ref);
2205                clear_ref_exclusion(&revs->ref_excludes);
2206        } else if (!strcmp(arg, "--remotes")) {
2207                handle_refs(refs, revs, *flags, refs_for_each_remote_ref);
2208                clear_ref_exclusion(&revs->ref_excludes);
2209        } else if ((argcount = parse_long_opt("glob", argv, &optarg))) {
2210                struct all_refs_cb cb;
2211                init_all_refs_cb(&cb, revs, *flags);
2212                for_each_glob_ref(handle_one_ref, optarg, &cb);
2213                clear_ref_exclusion(&revs->ref_excludes);
2214                return argcount;
2215        } else if ((argcount = parse_long_opt("exclude", argv, &optarg))) {
2216                add_ref_exclusion(&revs->ref_excludes, optarg);
2217                return argcount;
2218        } else if (skip_prefix(arg, "--branches=", &optarg)) {
2219                struct all_refs_cb cb;
2220                init_all_refs_cb(&cb, revs, *flags);
2221                for_each_glob_ref_in(handle_one_ref, optarg, "refs/heads/", &cb);
2222                clear_ref_exclusion(&revs->ref_excludes);
2223        } else if (skip_prefix(arg, "--tags=", &optarg)) {
2224                struct all_refs_cb cb;
2225                init_all_refs_cb(&cb, revs, *flags);
2226                for_each_glob_ref_in(handle_one_ref, optarg, "refs/tags/", &cb);
2227                clear_ref_exclusion(&revs->ref_excludes);
2228        } else if (skip_prefix(arg, "--remotes=", &optarg)) {
2229                struct all_refs_cb cb;
2230                init_all_refs_cb(&cb, revs, *flags);
2231                for_each_glob_ref_in(handle_one_ref, optarg, "refs/remotes/", &cb);
2232                clear_ref_exclusion(&revs->ref_excludes);
2233        } else if (!strcmp(arg, "--reflog")) {
2234                add_reflogs_to_pending(revs, *flags);
2235        } else if (!strcmp(arg, "--indexed-objects")) {
2236                add_index_objects_to_pending(revs, *flags);
2237        } else if (!strcmp(arg, "--not")) {
2238                *flags ^= UNINTERESTING | BOTTOM;
2239        } else if (!strcmp(arg, "--no-walk")) {
2240                revs->no_walk = REVISION_WALK_NO_WALK_SORTED;
2241        } else if (skip_prefix(arg, "--no-walk=", &optarg)) {
2242                /*
2243                 * Detached form ("--no-walk X" as opposed to "--no-walk=X")
2244                 * not allowed, since the argument is optional.
2245                 */
2246                if (!strcmp(optarg, "sorted"))
2247                        revs->no_walk = REVISION_WALK_NO_WALK_SORTED;
2248                else if (!strcmp(optarg, "unsorted"))
2249                        revs->no_walk = REVISION_WALK_NO_WALK_UNSORTED;
2250                else
2251                        return error("invalid argument to --no-walk");
2252        } else if (!strcmp(arg, "--do-walk")) {
2253                revs->no_walk = 0;
2254        } else if (!strcmp(arg, "--single-worktree")) {
2255                revs->single_worktree = 1;
2256        } else {
2257                return 0;
2258        }
2259
2260        return 1;
2261}
2262
2263static void NORETURN diagnose_missing_default(const char *def)
2264{
2265        unsigned char sha1[20];
2266        int flags;
2267        const char *refname;
2268
2269        refname = resolve_ref_unsafe(def, 0, sha1, &flags);
2270        if (!refname || !(flags & REF_ISSYMREF) || (flags & REF_ISBROKEN))
2271                die(_("your current branch appears to be broken"));
2272
2273        skip_prefix(refname, "refs/heads/", &refname);
2274        die(_("your current branch '%s' does not have any commits yet"),
2275            refname);
2276}
2277
2278/*
2279 * Parse revision information, filling in the "rev_info" structure,
2280 * and removing the used arguments from the argument list.
2281 *
2282 * Returns the number of arguments left that weren't recognized
2283 * (which are also moved to the head of the argument list)
2284 */
2285int setup_revisions(int argc, const char **argv, struct rev_info *revs, struct setup_revision_opt *opt)
2286{
2287        int i, flags, left, seen_dashdash, read_from_stdin, got_rev_arg = 0, revarg_opt;
2288        struct cmdline_pathspec prune_data;
2289        const char *submodule = NULL;
2290
2291        memset(&prune_data, 0, sizeof(prune_data));
2292        if (opt)
2293                submodule = opt->submodule;
2294
2295        /* First, search for "--" */
2296        if (opt && opt->assume_dashdash) {
2297                seen_dashdash = 1;
2298        } else {
2299                seen_dashdash = 0;
2300                for (i = 1; i < argc; i++) {
2301                        const char *arg = argv[i];
2302                        if (strcmp(arg, "--"))
2303                                continue;
2304                        argv[i] = NULL;
2305                        argc = i;
2306                        if (argv[i + 1])
2307                                append_prune_data(&prune_data, argv + i + 1);
2308                        seen_dashdash = 1;
2309                        break;
2310                }
2311        }
2312
2313        /* Second, deal with arguments and options */
2314        flags = 0;
2315        revarg_opt = opt ? opt->revarg_opt : 0;
2316        if (seen_dashdash)
2317                revarg_opt |= REVARG_CANNOT_BE_FILENAME;
2318        read_from_stdin = 0;
2319        for (left = i = 1; i < argc; i++) {
2320                const char *arg = argv[i];
2321                if (*arg == '-') {
2322                        int opts;
2323
2324                        opts = handle_revision_pseudo_opt(submodule,
2325                                                revs, argc - i, argv + i,
2326                                                &flags);
2327                        if (opts > 0) {
2328                                i += opts - 1;
2329                                continue;
2330                        }
2331
2332                        if (!strcmp(arg, "--stdin")) {
2333                                if (revs->disable_stdin) {
2334                                        argv[left++] = arg;
2335                                        continue;
2336                                }
2337                                if (read_from_stdin++)
2338                                        die("--stdin given twice?");
2339                                read_revisions_from_stdin(revs, &prune_data);
2340                                continue;
2341                        }
2342
2343                        opts = handle_revision_opt(revs, argc - i, argv + i, &left, argv);
2344                        if (opts > 0) {
2345                                i += opts - 1;
2346                                continue;
2347                        }
2348                        if (opts < 0)
2349                                exit(128);
2350                        continue;
2351                }
2352
2353
2354                if (handle_revision_arg(arg, revs, flags, revarg_opt)) {
2355                        int j;
2356                        if (seen_dashdash || *arg == '^')
2357                                die("bad revision '%s'", arg);
2358
2359                        /* If we didn't have a "--":
2360                         * (1) all filenames must exist;
2361                         * (2) all rev-args must not be interpretable
2362                         *     as a valid filename.
2363                         * but the latter we have checked in the main loop.
2364                         */
2365                        for (j = i; j < argc; j++)
2366                                verify_filename(revs->prefix, argv[j], j == i);
2367
2368                        append_prune_data(&prune_data, argv + i);
2369                        break;
2370                }
2371                else
2372                        got_rev_arg = 1;
2373        }
2374
2375        if (prune_data.nr) {
2376                /*
2377                 * If we need to introduce the magic "a lone ':' means no
2378                 * pathspec whatsoever", here is the place to do so.
2379                 *
2380                 * if (prune_data.nr == 1 && !strcmp(prune_data[0], ":")) {
2381                 *      prune_data.nr = 0;
2382                 *      prune_data.alloc = 0;
2383                 *      free(prune_data.path);
2384                 *      prune_data.path = NULL;
2385                 * } else {
2386                 *      terminate prune_data.alloc with NULL and
2387                 *      call init_pathspec() to set revs->prune_data here.
2388                 * }
2389                 */
2390                ALLOC_GROW(prune_data.path, prune_data.nr + 1, prune_data.alloc);
2391                prune_data.path[prune_data.nr++] = NULL;
2392                parse_pathspec(&revs->prune_data, 0, 0,
2393                               revs->prefix, prune_data.path);
2394        }
2395
2396        if (revs->def == NULL)
2397                revs->def = opt ? opt->def : NULL;
2398        if (opt && opt->tweak)
2399                opt->tweak(revs, opt);
2400        if (revs->show_merge)
2401                prepare_show_merge(revs);
2402        if (revs->def && !revs->pending.nr && !revs->rev_input_given && !got_rev_arg) {
2403                struct object_id oid;
2404                struct object *object;
2405                struct object_context oc;
2406                if (get_oid_with_context(revs->def, 0, &oid, &oc))
2407                        diagnose_missing_default(revs->def);
2408                object = get_reference(revs, revs->def, &oid, 0);
2409                add_pending_object_with_mode(revs, object, revs->def, oc.mode);
2410        }
2411
2412        /* Did the user ask for any diff output? Run the diff! */
2413        if (revs->diffopt.output_format & ~DIFF_FORMAT_NO_OUTPUT)
2414                revs->diff = 1;
2415
2416        /* Pickaxe, diff-filter and rename following need diffs */
2417        if (revs->diffopt.pickaxe ||
2418            revs->diffopt.filter ||
2419            DIFF_OPT_TST(&revs->diffopt, FOLLOW_RENAMES))
2420                revs->diff = 1;
2421
2422        if (revs->topo_order)
2423                revs->limited = 1;
2424
2425        if (revs->prune_data.nr) {
2426                copy_pathspec(&revs->pruning.pathspec, &revs->prune_data);
2427                /* Can't prune commits with rename following: the paths change.. */
2428                if (!DIFF_OPT_TST(&revs->diffopt, FOLLOW_RENAMES))
2429                        revs->prune = 1;
2430                if (!revs->full_diff)
2431                        copy_pathspec(&revs->diffopt.pathspec,
2432                                      &revs->prune_data);
2433        }
2434        if (revs->combine_merges)
2435                revs->ignore_merges = 0;
2436        revs->diffopt.abbrev = revs->abbrev;
2437
2438        if (revs->line_level_traverse) {
2439                revs->limited = 1;
2440                revs->topo_order = 1;
2441        }
2442
2443        diff_setup_done(&revs->diffopt);
2444
2445        grep_commit_pattern_type(GREP_PATTERN_TYPE_UNSPECIFIED,
2446                                 &revs->grep_filter);
2447        compile_grep_patterns(&revs->grep_filter);
2448
2449        if (revs->reverse && revs->reflog_info)
2450                die("cannot combine --reverse with --walk-reflogs");
2451        if (revs->reflog_info && revs->limited)
2452                die("cannot combine --walk-reflogs with history-limiting options");
2453        if (revs->rewrite_parents && revs->children.name)
2454                die("cannot combine --parents and --children");
2455
2456        /*
2457         * Limitations on the graph functionality
2458         */
2459        if (revs->reverse && revs->graph)
2460                die("cannot combine --reverse with --graph");
2461
2462        if (revs->reflog_info && revs->graph)
2463                die("cannot combine --walk-reflogs with --graph");
2464        if (revs->no_walk && revs->graph)
2465                die("cannot combine --no-walk with --graph");
2466        if (!revs->reflog_info && revs->grep_filter.use_reflog_filter)
2467                die("cannot use --grep-reflog without --walk-reflogs");
2468
2469        if (revs->first_parent_only && revs->bisect)
2470                die(_("--first-parent is incompatible with --bisect"));
2471
2472        if (revs->expand_tabs_in_log < 0)
2473                revs->expand_tabs_in_log = revs->expand_tabs_in_log_default;
2474
2475        return left;
2476}
2477
2478static void add_child(struct rev_info *revs, struct commit *parent, struct commit *child)
2479{
2480        struct commit_list *l = xcalloc(1, sizeof(*l));
2481
2482        l->item = child;
2483        l->next = add_decoration(&revs->children, &parent->object, l);
2484}
2485
2486static int remove_duplicate_parents(struct rev_info *revs, struct commit *commit)
2487{
2488        struct treesame_state *ts = lookup_decoration(&revs->treesame, &commit->object);
2489        struct commit_list **pp, *p;
2490        int surviving_parents;
2491
2492        /* Examine existing parents while marking ones we have seen... */
2493        pp = &commit->parents;
2494        surviving_parents = 0;
2495        while ((p = *pp) != NULL) {
2496                struct commit *parent = p->item;
2497                if (parent->object.flags & TMP_MARK) {
2498                        *pp = p->next;
2499                        if (ts)
2500                                compact_treesame(revs, commit, surviving_parents);
2501                        continue;
2502                }
2503                parent->object.flags |= TMP_MARK;
2504                surviving_parents++;
2505                pp = &p->next;
2506        }
2507        /* clear the temporary mark */
2508        for (p = commit->parents; p; p = p->next) {
2509                p->item->object.flags &= ~TMP_MARK;
2510        }
2511        /* no update_treesame() - removing duplicates can't affect TREESAME */
2512        return surviving_parents;
2513}
2514
2515struct merge_simplify_state {
2516        struct commit *simplified;
2517};
2518
2519static struct merge_simplify_state *locate_simplify_state(struct rev_info *revs, struct commit *commit)
2520{
2521        struct merge_simplify_state *st;
2522
2523        st = lookup_decoration(&revs->merge_simplification, &commit->object);
2524        if (!st) {
2525                st = xcalloc(1, sizeof(*st));
2526                add_decoration(&revs->merge_simplification, &commit->object, st);
2527        }
2528        return st;
2529}
2530
2531static int mark_redundant_parents(struct rev_info *revs, struct commit *commit)
2532{
2533        struct commit_list *h = reduce_heads(commit->parents);
2534        int i = 0, marked = 0;
2535        struct commit_list *po, *pn;
2536
2537        /* Want these for sanity-checking only */
2538        int orig_cnt = commit_list_count(commit->parents);
2539        int cnt = commit_list_count(h);
2540
2541        /*
2542         * Not ready to remove items yet, just mark them for now, based
2543         * on the output of reduce_heads(). reduce_heads outputs the reduced
2544         * set in its original order, so this isn't too hard.
2545         */
2546        po = commit->parents;
2547        pn = h;
2548        while (po) {
2549                if (pn && po->item == pn->item) {
2550                        pn = pn->next;
2551                        i++;
2552                } else {
2553                        po->item->object.flags |= TMP_MARK;
2554                        marked++;
2555                }
2556                po=po->next;
2557        }
2558
2559        if (i != cnt || cnt+marked != orig_cnt)
2560                die("mark_redundant_parents %d %d %d %d", orig_cnt, cnt, i, marked);
2561
2562        free_commit_list(h);
2563
2564        return marked;
2565}
2566
2567static int mark_treesame_root_parents(struct rev_info *revs, struct commit *commit)
2568{
2569        struct commit_list *p;
2570        int marked = 0;
2571
2572        for (p = commit->parents; p; p = p->next) {
2573                struct commit *parent = p->item;
2574                if (!parent->parents && (parent->object.flags & TREESAME)) {
2575                        parent->object.flags |= TMP_MARK;
2576                        marked++;
2577                }
2578        }
2579
2580        return marked;
2581}
2582
2583/*
2584 * Awkward naming - this means one parent we are TREESAME to.
2585 * cf mark_treesame_root_parents: root parents that are TREESAME (to an
2586 * empty tree). Better name suggestions?
2587 */
2588static int leave_one_treesame_to_parent(struct rev_info *revs, struct commit *commit)
2589{
2590        struct treesame_state *ts = lookup_decoration(&revs->treesame, &commit->object);
2591        struct commit *unmarked = NULL, *marked = NULL;
2592        struct commit_list *p;
2593        unsigned n;
2594
2595        for (p = commit->parents, n = 0; p; p = p->next, n++) {
2596                if (ts->treesame[n]) {
2597                        if (p->item->object.flags & TMP_MARK) {
2598                                if (!marked)
2599                                        marked = p->item;
2600                        } else {
2601                                if (!unmarked) {
2602                                        unmarked = p->item;
2603                                        break;
2604                                }
2605                        }
2606                }
2607        }
2608
2609        /*
2610         * If we are TREESAME to a marked-for-deletion parent, but not to any
2611         * unmarked parents, unmark the first TREESAME parent. This is the
2612         * parent that the default simplify_history==1 scan would have followed,
2613         * and it doesn't make sense to omit that path when asking for a
2614         * simplified full history. Retaining it improves the chances of
2615         * understanding odd missed merges that took an old version of a file.
2616         *
2617         * Example:
2618         *
2619         *   I--------*X       A modified the file, but mainline merge X used
2620         *    \       /        "-s ours", so took the version from I. X is
2621         *     `-*A--'         TREESAME to I and !TREESAME to A.
2622         *
2623         * Default log from X would produce "I". Without this check,
2624         * --full-history --simplify-merges would produce "I-A-X", showing
2625         * the merge commit X and that it changed A, but not making clear that
2626         * it had just taken the I version. With this check, the topology above
2627         * is retained.
2628         *
2629         * Note that it is possible that the simplification chooses a different
2630         * TREESAME parent from the default, in which case this test doesn't
2631         * activate, and we _do_ drop the default parent. Example:
2632         *
2633         *   I------X         A modified the file, but it was reverted in B,
2634         *    \    /          meaning mainline merge X is TREESAME to both
2635         *    *A-*B           parents.
2636         *
2637         * Default log would produce "I" by following the first parent;
2638         * --full-history --simplify-merges will produce "I-A-B". But this is a
2639         * reasonable result - it presents a logical full history leading from
2640         * I to X, and X is not an important merge.
2641         */
2642        if (!unmarked && marked) {
2643                marked->object.flags &= ~TMP_MARK;
2644                return 1;
2645        }
2646
2647        return 0;
2648}
2649
2650static int remove_marked_parents(struct rev_info *revs, struct commit *commit)
2651{
2652        struct commit_list **pp, *p;
2653        int nth_parent, removed = 0;
2654
2655        pp = &commit->parents;
2656        nth_parent = 0;
2657        while ((p = *pp) != NULL) {
2658                struct commit *parent = p->item;
2659                if (parent->object.flags & TMP_MARK) {
2660                        parent->object.flags &= ~TMP_MARK;
2661                        *pp = p->next;
2662                        free(p);
2663                        removed++;
2664                        compact_treesame(revs, commit, nth_parent);
2665                        continue;
2666                }
2667                pp = &p->next;
2668                nth_parent++;
2669        }
2670
2671        /* Removing parents can only increase TREESAMEness */
2672        if (removed && !(commit->object.flags & TREESAME))
2673                update_treesame(revs, commit);
2674
2675        return nth_parent;
2676}
2677
2678static struct commit_list **simplify_one(struct rev_info *revs, struct commit *commit, struct commit_list **tail)
2679{
2680        struct commit_list *p;
2681        struct commit *parent;
2682        struct merge_simplify_state *st, *pst;
2683        int cnt;
2684
2685        st = locate_simplify_state(revs, commit);
2686
2687        /*
2688         * Have we handled this one?
2689         */
2690        if (st->simplified)
2691                return tail;
2692
2693        /*
2694         * An UNINTERESTING commit simplifies to itself, so does a
2695         * root commit.  We do not rewrite parents of such commit
2696         * anyway.
2697         */
2698        if ((commit->object.flags & UNINTERESTING) || !commit->parents) {
2699                st->simplified = commit;
2700                return tail;
2701        }
2702
2703        /*
2704         * Do we know what commit all of our parents that matter
2705         * should be rewritten to?  Otherwise we are not ready to
2706         * rewrite this one yet.
2707         */
2708        for (cnt = 0, p = commit->parents; p; p = p->next) {
2709                pst = locate_simplify_state(revs, p->item);
2710                if (!pst->simplified) {
2711                        tail = &commit_list_insert(p->item, tail)->next;
2712                        cnt++;
2713                }
2714                if (revs->first_parent_only)
2715                        break;
2716        }
2717        if (cnt) {
2718                tail = &commit_list_insert(commit, tail)->next;
2719                return tail;
2720        }
2721
2722        /*
2723         * Rewrite our list of parents. Note that this cannot
2724         * affect our TREESAME flags in any way - a commit is
2725         * always TREESAME to its simplification.
2726         */
2727        for (p = commit->parents; p; p = p->next) {
2728                pst = locate_simplify_state(revs, p->item);
2729                p->item = pst->simplified;
2730                if (revs->first_parent_only)
2731                        break;
2732        }
2733
2734        if (revs->first_parent_only)
2735                cnt = 1;
2736        else
2737                cnt = remove_duplicate_parents(revs, commit);
2738
2739        /*
2740         * It is possible that we are a merge and one side branch
2741         * does not have any commit that touches the given paths;
2742         * in such a case, the immediate parent from that branch
2743         * will be rewritten to be the merge base.
2744         *
2745         *      o----X          X: the commit we are looking at;
2746         *     /    /           o: a commit that touches the paths;
2747         * ---o----'
2748         *
2749         * Further, a merge of an independent branch that doesn't
2750         * touch the path will reduce to a treesame root parent:
2751         *
2752         *  ----o----X          X: the commit we are looking at;
2753         *          /           o: a commit that touches the paths;
2754         *         r            r: a root commit not touching the paths
2755         *
2756         * Detect and simplify both cases.
2757         */
2758        if (1 < cnt) {
2759                int marked = mark_redundant_parents(revs, commit);
2760                marked += mark_treesame_root_parents(revs, commit);
2761                if (marked)
2762                        marked -= leave_one_treesame_to_parent(revs, commit);
2763                if (marked)
2764                        cnt = remove_marked_parents(revs, commit);
2765        }
2766
2767        /*
2768         * A commit simplifies to itself if it is a root, if it is
2769         * UNINTERESTING, if it touches the given paths, or if it is a
2770         * merge and its parents don't simplify to one relevant commit
2771         * (the first two cases are already handled at the beginning of
2772         * this function).
2773         *
2774         * Otherwise, it simplifies to what its sole relevant parent
2775         * simplifies to.
2776         */
2777        if (!cnt ||
2778            (commit->object.flags & UNINTERESTING) ||
2779            !(commit->object.flags & TREESAME) ||
2780            (parent = one_relevant_parent(revs, commit->parents)) == NULL)
2781                st->simplified = commit;
2782        else {
2783                pst = locate_simplify_state(revs, parent);
2784                st->simplified = pst->simplified;
2785        }
2786        return tail;
2787}
2788
2789static void simplify_merges(struct rev_info *revs)
2790{
2791        struct commit_list *list, *next;
2792        struct commit_list *yet_to_do, **tail;
2793        struct commit *commit;
2794
2795        if (!revs->prune)
2796                return;
2797
2798        /* feed the list reversed */
2799        yet_to_do = NULL;
2800        for (list = revs->commits; list; list = next) {
2801                commit = list->item;
2802                next = list->next;
2803                /*
2804                 * Do not free(list) here yet; the original list
2805                 * is used later in this function.
2806                 */
2807                commit_list_insert(commit, &yet_to_do);
2808        }
2809        while (yet_to_do) {
2810                list = yet_to_do;
2811                yet_to_do = NULL;
2812                tail = &yet_to_do;
2813                while (list) {
2814                        commit = pop_commit(&list);
2815                        tail = simplify_one(revs, commit, tail);
2816                }
2817        }
2818
2819        /* clean up the result, removing the simplified ones */
2820        list = revs->commits;
2821        revs->commits = NULL;
2822        tail = &revs->commits;
2823        while (list) {
2824                struct merge_simplify_state *st;
2825
2826                commit = pop_commit(&list);
2827                st = locate_simplify_state(revs, commit);
2828                if (st->simplified == commit)
2829                        tail = &commit_list_insert(commit, tail)->next;
2830        }
2831}
2832
2833static void set_children(struct rev_info *revs)
2834{
2835        struct commit_list *l;
2836        for (l = revs->commits; l; l = l->next) {
2837                struct commit *commit = l->item;
2838                struct commit_list *p;
2839
2840                for (p = commit->parents; p; p = p->next)
2841                        add_child(revs, p->item, commit);
2842        }
2843}
2844
2845void reset_revision_walk(void)
2846{
2847        clear_object_flags(SEEN | ADDED | SHOWN);
2848}
2849
2850int prepare_revision_walk(struct rev_info *revs)
2851{
2852        int i;
2853        struct object_array old_pending;
2854        struct commit_list **next = &revs->commits;
2855
2856        memcpy(&old_pending, &revs->pending, sizeof(old_pending));
2857        revs->pending.nr = 0;
2858        revs->pending.alloc = 0;
2859        revs->pending.objects = NULL;
2860        for (i = 0; i < old_pending.nr; i++) {
2861                struct object_array_entry *e = old_pending.objects + i;
2862                struct commit *commit = handle_commit(revs, e);
2863                if (commit) {
2864                        if (!(commit->object.flags & SEEN)) {
2865                                commit->object.flags |= SEEN;
2866                                next = commit_list_append(commit, next);
2867                        }
2868                }
2869        }
2870        if (!revs->leak_pending)
2871                object_array_clear(&old_pending);
2872
2873        /* Signal whether we need per-parent treesame decoration */
2874        if (revs->simplify_merges ||
2875            (revs->limited && limiting_can_increase_treesame(revs)))
2876                revs->treesame.name = "treesame";
2877
2878        if (revs->no_walk != REVISION_WALK_NO_WALK_UNSORTED)
2879                commit_list_sort_by_date(&revs->commits);
2880        if (revs->no_walk)
2881                return 0;
2882        if (revs->limited)
2883                if (limit_list(revs) < 0)
2884                        return -1;
2885        if (revs->topo_order)
2886                sort_in_topological_order(&revs->commits, revs->sort_order);
2887        if (revs->line_level_traverse)
2888                line_log_filter(revs);
2889        if (revs->simplify_merges)
2890                simplify_merges(revs);
2891        if (revs->children.name)
2892                set_children(revs);
2893        return 0;
2894}
2895
2896static enum rewrite_result rewrite_one(struct rev_info *revs, struct commit **pp)
2897{
2898        struct commit_list *cache = NULL;
2899
2900        for (;;) {
2901                struct commit *p = *pp;
2902                if (!revs->limited)
2903                        if (add_parents_to_list(revs, p, &revs->commits, &cache) < 0)
2904                                return rewrite_one_error;
2905                if (p->object.flags & UNINTERESTING)
2906                        return rewrite_one_ok;
2907                if (!(p->object.flags & TREESAME))
2908                        return rewrite_one_ok;
2909                if (!p->parents)
2910                        return rewrite_one_noparents;
2911                if ((p = one_relevant_parent(revs, p->parents)) == NULL)
2912                        return rewrite_one_ok;
2913                *pp = p;
2914        }
2915}
2916
2917int rewrite_parents(struct rev_info *revs, struct commit *commit,
2918        rewrite_parent_fn_t rewrite_parent)
2919{
2920        struct commit_list **pp = &commit->parents;
2921        while (*pp) {
2922                struct commit_list *parent = *pp;
2923                switch (rewrite_parent(revs, &parent->item)) {
2924                case rewrite_one_ok:
2925                        break;
2926                case rewrite_one_noparents:
2927                        *pp = parent->next;
2928                        continue;
2929                case rewrite_one_error:
2930                        return -1;
2931                }
2932                pp = &parent->next;
2933        }
2934        remove_duplicate_parents(revs, commit);
2935        return 0;
2936}
2937
2938static int commit_rewrite_person(struct strbuf *buf, const char *what, struct string_list *mailmap)
2939{
2940        char *person, *endp;
2941        size_t len, namelen, maillen;
2942        const char *name;
2943        const char *mail;
2944        struct ident_split ident;
2945
2946        person = strstr(buf->buf, what);
2947        if (!person)
2948                return 0;
2949
2950        person += strlen(what);
2951        endp = strchr(person, '\n');
2952        if (!endp)
2953                return 0;
2954
2955        len = endp - person;
2956
2957        if (split_ident_line(&ident, person, len))
2958                return 0;
2959
2960        mail = ident.mail_begin;
2961        maillen = ident.mail_end - ident.mail_begin;
2962        name = ident.name_begin;
2963        namelen = ident.name_end - ident.name_begin;
2964
2965        if (map_user(mailmap, &mail, &maillen, &name, &namelen)) {
2966                struct strbuf namemail = STRBUF_INIT;
2967
2968                strbuf_addf(&namemail, "%.*s <%.*s>",
2969                            (int)namelen, name, (int)maillen, mail);
2970
2971                strbuf_splice(buf, ident.name_begin - buf->buf,
2972                              ident.mail_end - ident.name_begin + 1,
2973                              namemail.buf, namemail.len);
2974
2975                strbuf_release(&namemail);
2976
2977                return 1;
2978        }
2979
2980        return 0;
2981}
2982
2983static int commit_match(struct commit *commit, struct rev_info *opt)
2984{
2985        int retval;
2986        const char *encoding;
2987        const char *message;
2988        struct strbuf buf = STRBUF_INIT;
2989
2990        if (!opt->grep_filter.pattern_list && !opt->grep_filter.header_list)
2991                return 1;
2992
2993        /* Prepend "fake" headers as needed */
2994        if (opt->grep_filter.use_reflog_filter) {
2995                strbuf_addstr(&buf, "reflog ");
2996                get_reflog_message(&buf, opt->reflog_info);
2997                strbuf_addch(&buf, '\n');
2998        }
2999
3000        /*
3001         * We grep in the user's output encoding, under the assumption that it
3002         * is the encoding they are most likely to write their grep pattern
3003         * for. In addition, it means we will match the "notes" encoding below,
3004         * so we will not end up with a buffer that has two different encodings
3005         * in it.
3006         */
3007        encoding = get_log_output_encoding();
3008        message = logmsg_reencode(commit, NULL, encoding);
3009
3010        /* Copy the commit to temporary if we are using "fake" headers */
3011        if (buf.len)
3012                strbuf_addstr(&buf, message);
3013
3014        if (opt->grep_filter.header_list && opt->mailmap) {
3015                if (!buf.len)
3016                        strbuf_addstr(&buf, message);
3017
3018                commit_rewrite_person(&buf, "\nauthor ", opt->mailmap);
3019                commit_rewrite_person(&buf, "\ncommitter ", opt->mailmap);
3020        }
3021
3022        /* Append "fake" message parts as needed */
3023        if (opt->show_notes) {
3024                if (!buf.len)
3025                        strbuf_addstr(&buf, message);
3026                format_display_notes(&commit->object.oid, &buf, encoding, 1);
3027        }
3028
3029        /*
3030         * Find either in the original commit message, or in the temporary.
3031         * Note that we cast away the constness of "message" here. It is
3032         * const because it may come from the cached commit buffer. That's OK,
3033         * because we know that it is modifiable heap memory, and that while
3034         * grep_buffer may modify it for speed, it will restore any
3035         * changes before returning.
3036         */
3037        if (buf.len)
3038                retval = grep_buffer(&opt->grep_filter, buf.buf, buf.len);
3039        else
3040                retval = grep_buffer(&opt->grep_filter,
3041                                     (char *)message, strlen(message));
3042        strbuf_release(&buf);
3043        unuse_commit_buffer(commit, message);
3044        return opt->invert_grep ? !retval : retval;
3045}
3046
3047static inline int want_ancestry(const struct rev_info *revs)
3048{
3049        return (revs->rewrite_parents || revs->children.name);
3050}
3051
3052/*
3053 * Return a timestamp to be used for --since/--until comparisons for this
3054 * commit, based on the revision options.
3055 */
3056static timestamp_t comparison_date(const struct rev_info *revs,
3057                                   struct commit *commit)
3058{
3059        return revs->reflog_info ?
3060                get_reflog_timestamp(revs->reflog_info) :
3061                commit->date;
3062}
3063
3064enum commit_action get_commit_action(struct rev_info *revs, struct commit *commit)
3065{
3066        if (commit->object.flags & SHOWN)
3067                return commit_ignore;
3068        if (revs->unpacked && has_sha1_pack(commit->object.oid.hash))
3069                return commit_ignore;
3070        if (revs->show_all)
3071                return commit_show;
3072        if (commit->object.flags & UNINTERESTING)
3073                return commit_ignore;
3074        if (revs->min_age != -1 &&
3075            comparison_date(revs, commit) > revs->min_age)
3076                        return commit_ignore;
3077        if (revs->min_parents || (revs->max_parents >= 0)) {
3078                int n = commit_list_count(commit->parents);
3079                if ((n < revs->min_parents) ||
3080                    ((revs->max_parents >= 0) && (n > revs->max_parents)))
3081                        return commit_ignore;
3082        }
3083        if (!commit_match(commit, revs))
3084                return commit_ignore;
3085        if (revs->prune && revs->dense) {
3086                /* Commit without changes? */
3087                if (commit->object.flags & TREESAME) {
3088                        int n;
3089                        struct commit_list *p;
3090                        /* drop merges unless we want parenthood */
3091                        if (!want_ancestry(revs))
3092                                return commit_ignore;
3093                        /*
3094                         * If we want ancestry, then need to keep any merges
3095                         * between relevant commits to tie together topology.
3096                         * For consistency with TREESAME and simplification
3097                         * use "relevant" here rather than just INTERESTING,
3098                         * to treat bottom commit(s) as part of the topology.
3099                         */
3100                        for (n = 0, p = commit->parents; p; p = p->next)
3101                                if (relevant_commit(p->item))
3102                                        if (++n >= 2)
3103                                                return commit_show;
3104                        return commit_ignore;
3105                }
3106        }
3107        return commit_show;
3108}
3109
3110define_commit_slab(saved_parents, struct commit_list *);
3111
3112#define EMPTY_PARENT_LIST ((struct commit_list *)-1)
3113
3114/*
3115 * You may only call save_parents() once per commit (this is checked
3116 * for non-root commits).
3117 */
3118static void save_parents(struct rev_info *revs, struct commit *commit)
3119{
3120        struct commit_list **pp;
3121
3122        if (!revs->saved_parents_slab) {
3123                revs->saved_parents_slab = xmalloc(sizeof(struct saved_parents));
3124                init_saved_parents(revs->saved_parents_slab);
3125        }
3126
3127        pp = saved_parents_at(revs->saved_parents_slab, commit);
3128
3129        /*
3130         * When walking with reflogs, we may visit the same commit
3131         * several times: once for each appearance in the reflog.
3132         *
3133         * In this case, save_parents() will be called multiple times.
3134         * We want to keep only the first set of parents.  We need to
3135         * store a sentinel value for an empty (i.e., NULL) parent
3136         * list to distinguish it from a not-yet-saved list, however.
3137         */
3138        if (*pp)
3139                return;
3140        if (commit->parents)
3141                *pp = copy_commit_list(commit->parents);
3142        else
3143                *pp = EMPTY_PARENT_LIST;
3144}
3145
3146static void free_saved_parents(struct rev_info *revs)
3147{
3148        if (revs->saved_parents_slab)
3149                clear_saved_parents(revs->saved_parents_slab);
3150}
3151
3152struct commit_list *get_saved_parents(struct rev_info *revs, const struct commit *commit)
3153{
3154        struct commit_list *parents;
3155
3156        if (!revs->saved_parents_slab)
3157                return commit->parents;
3158
3159        parents = *saved_parents_at(revs->saved_parents_slab, commit);
3160        if (parents == EMPTY_PARENT_LIST)
3161                return NULL;
3162        return parents;
3163}
3164
3165enum commit_action simplify_commit(struct rev_info *revs, struct commit *commit)
3166{
3167        enum commit_action action = get_commit_action(revs, commit);
3168
3169        if (action == commit_show &&
3170            !revs->show_all &&
3171            revs->prune && revs->dense && want_ancestry(revs)) {
3172                /*
3173                 * --full-diff on simplified parents is no good: it
3174                 * will show spurious changes from the commits that
3175                 * were elided.  So we save the parents on the side
3176                 * when --full-diff is in effect.
3177                 */
3178                if (revs->full_diff)
3179                        save_parents(revs, commit);
3180                if (rewrite_parents(revs, commit, rewrite_one) < 0)
3181                        return commit_error;
3182        }
3183        return action;
3184}
3185
3186static void track_linear(struct rev_info *revs, struct commit *commit)
3187{
3188        if (revs->track_first_time) {
3189                revs->linear = 1;
3190                revs->track_first_time = 0;
3191        } else {
3192                struct commit_list *p;
3193                for (p = revs->previous_parents; p; p = p->next)
3194                        if (p->item == NULL || /* first commit */
3195                            !oidcmp(&p->item->object.oid, &commit->object.oid))
3196                                break;
3197                revs->linear = p != NULL;
3198        }
3199        if (revs->reverse) {
3200                if (revs->linear)
3201                        commit->object.flags |= TRACK_LINEAR;
3202        }
3203        free_commit_list(revs->previous_parents);
3204        revs->previous_parents = copy_commit_list(commit->parents);
3205}
3206
3207static struct commit *get_revision_1(struct rev_info *revs)
3208{
3209        while (1) {
3210                struct commit *commit;
3211
3212                if (revs->reflog_info)
3213                        commit = next_reflog_entry(revs->reflog_info);
3214                else
3215                        commit = pop_commit(&revs->commits);
3216
3217                if (!commit)
3218                        return NULL;
3219
3220                if (revs->reflog_info)
3221                        commit->object.flags &= ~(ADDED | SEEN | SHOWN);
3222
3223                /*
3224                 * If we haven't done the list limiting, we need to look at
3225                 * the parents here. We also need to do the date-based limiting
3226                 * that we'd otherwise have done in limit_list().
3227                 */
3228                if (!revs->limited) {
3229                        if (revs->max_age != -1 &&
3230                            comparison_date(revs, commit) < revs->max_age)
3231                                continue;
3232
3233                        if (revs->reflog_info)
3234                                try_to_simplify_commit(revs, commit);
3235                        else if (add_parents_to_list(revs, commit, &revs->commits, NULL) < 0) {
3236                                if (!revs->ignore_missing_links)
3237                                        die("Failed to traverse parents of commit %s",
3238                                                oid_to_hex(&commit->object.oid));
3239                        }
3240                }
3241
3242                switch (simplify_commit(revs, commit)) {
3243                case commit_ignore:
3244                        continue;
3245                case commit_error:
3246                        die("Failed to simplify parents of commit %s",
3247                            oid_to_hex(&commit->object.oid));
3248                default:
3249                        if (revs->track_linear)
3250                                track_linear(revs, commit);
3251                        return commit;
3252                }
3253        }
3254}
3255
3256/*
3257 * Return true for entries that have not yet been shown.  (This is an
3258 * object_array_each_func_t.)
3259 */
3260static int entry_unshown(struct object_array_entry *entry, void *cb_data_unused)
3261{
3262        return !(entry->item->flags & SHOWN);
3263}
3264
3265/*
3266 * If array is on the verge of a realloc, garbage-collect any entries
3267 * that have already been shown to try to free up some space.
3268 */
3269static void gc_boundary(struct object_array *array)
3270{
3271        if (array->nr == array->alloc)
3272                object_array_filter(array, entry_unshown, NULL);
3273}
3274
3275static void create_boundary_commit_list(struct rev_info *revs)
3276{
3277        unsigned i;
3278        struct commit *c;
3279        struct object_array *array = &revs->boundary_commits;
3280        struct object_array_entry *objects = array->objects;
3281
3282        /*
3283         * If revs->commits is non-NULL at this point, an error occurred in
3284         * get_revision_1().  Ignore the error and continue printing the
3285         * boundary commits anyway.  (This is what the code has always
3286         * done.)
3287         */
3288        if (revs->commits) {
3289                free_commit_list(revs->commits);
3290                revs->commits = NULL;
3291        }
3292
3293        /*
3294         * Put all of the actual boundary commits from revs->boundary_commits
3295         * into revs->commits
3296         */
3297        for (i = 0; i < array->nr; i++) {
3298                c = (struct commit *)(objects[i].item);
3299                if (!c)
3300                        continue;
3301                if (!(c->object.flags & CHILD_SHOWN))
3302                        continue;
3303                if (c->object.flags & (SHOWN | BOUNDARY))
3304                        continue;
3305                c->object.flags |= BOUNDARY;
3306                commit_list_insert(c, &revs->commits);
3307        }
3308
3309        /*
3310         * If revs->topo_order is set, sort the boundary commits
3311         * in topological order
3312         */
3313        sort_in_topological_order(&revs->commits, revs->sort_order);
3314}
3315
3316static struct commit *get_revision_internal(struct rev_info *revs)
3317{
3318        struct commit *c = NULL;
3319        struct commit_list *l;
3320
3321        if (revs->boundary == 2) {
3322                /*
3323                 * All of the normal commits have already been returned,
3324                 * and we are now returning boundary commits.
3325                 * create_boundary_commit_list() has populated
3326                 * revs->commits with the remaining commits to return.
3327                 */
3328                c = pop_commit(&revs->commits);
3329                if (c)
3330                        c->object.flags |= SHOWN;
3331                return c;
3332        }
3333
3334        /*
3335         * If our max_count counter has reached zero, then we are done. We
3336         * don't simply return NULL because we still might need to show
3337         * boundary commits. But we want to avoid calling get_revision_1, which
3338         * might do a considerable amount of work finding the next commit only
3339         * for us to throw it away.
3340         *
3341         * If it is non-zero, then either we don't have a max_count at all
3342         * (-1), or it is still counting, in which case we decrement.
3343         */
3344        if (revs->max_count) {
3345                c = get_revision_1(revs);
3346                if (c) {
3347                        while (revs->skip_count > 0) {
3348                                revs->skip_count--;
3349                                c = get_revision_1(revs);
3350                                if (!c)
3351                                        break;
3352                        }
3353                }
3354
3355                if (revs->max_count > 0)
3356                        revs->max_count--;
3357        }
3358
3359        if (c)
3360                c->object.flags |= SHOWN;
3361
3362        if (!revs->boundary)
3363                return c;
3364
3365        if (!c) {
3366                /*
3367                 * get_revision_1() runs out the commits, and
3368                 * we are done computing the boundaries.
3369                 * switch to boundary commits output mode.
3370                 */
3371                revs->boundary = 2;
3372
3373                /*
3374                 * Update revs->commits to contain the list of
3375                 * boundary commits.
3376                 */
3377                create_boundary_commit_list(revs);
3378
3379                return get_revision_internal(revs);
3380        }
3381
3382        /*
3383         * boundary commits are the commits that are parents of the
3384         * ones we got from get_revision_1() but they themselves are
3385         * not returned from get_revision_1().  Before returning
3386         * 'c', we need to mark its parents that they could be boundaries.
3387         */
3388
3389        for (l = c->parents; l; l = l->next) {
3390                struct object *p;
3391                p = &(l->item->object);
3392                if (p->flags & (CHILD_SHOWN | SHOWN))
3393                        continue;
3394                p->flags |= CHILD_SHOWN;
3395                gc_boundary(&revs->boundary_commits);
3396                add_object_array(p, NULL, &revs->boundary_commits);
3397        }
3398
3399        return c;
3400}
3401
3402struct commit *get_revision(struct rev_info *revs)
3403{
3404        struct commit *c;
3405        struct commit_list *reversed;
3406
3407        if (revs->reverse) {
3408                reversed = NULL;
3409                while ((c = get_revision_internal(revs)))
3410                        commit_list_insert(c, &reversed);
3411                revs->commits = reversed;
3412                revs->reverse = 0;
3413                revs->reverse_output_stage = 1;
3414        }
3415
3416        if (revs->reverse_output_stage) {
3417                c = pop_commit(&revs->commits);
3418                if (revs->track_linear)
3419                        revs->linear = !!(c && c->object.flags & TRACK_LINEAR);
3420                return c;
3421        }
3422
3423        c = get_revision_internal(revs);
3424        if (c && revs->graph)
3425                graph_update(revs->graph, c);
3426        if (!c) {
3427                free_saved_parents(revs);
3428                if (revs->previous_parents) {
3429                        free_commit_list(revs->previous_parents);
3430                        revs->previous_parents = NULL;
3431                }
3432        }
3433        return c;
3434}
3435
3436char *get_revision_mark(const struct rev_info *revs, const struct commit *commit)
3437{
3438        if (commit->object.flags & BOUNDARY)
3439                return "-";
3440        else if (commit->object.flags & UNINTERESTING)
3441                return "^";
3442        else if (commit->object.flags & PATCHSAME)
3443                return "=";
3444        else if (!revs || revs->left_right) {
3445                if (commit->object.flags & SYMMETRIC_LEFT)
3446                        return "<";
3447                else
3448                        return ">";
3449        } else if (revs->graph)
3450                return "*";
3451        else if (revs->cherry_mark)
3452                return "+";
3453        return "";
3454}
3455
3456void put_revision_mark(const struct rev_info *revs, const struct commit *commit)
3457{
3458        char *mark = get_revision_mark(revs, commit);
3459        if (!strlen(mark))
3460                return;
3461        fputs(mark, stdout);
3462        putchar(' ');
3463}