so that git-describe searches first-parent history only when looking for a named commit. This is useful for describing commits by tags on their "main" (first-parent) branch. git describe --contains --first-parent is forbidden because git name-rev (which is called by that) favors first-parent transversal already, although not strictly so. Signed-off-by: Michael J Gruber <git@xxxxxxxxxxxxxxxxxxxx> --- Notes: Is this considered useful? RFC because of lack of doc and test. I consider it easier than (and different from) --match in some cases. builtin/describe.c | 8 +++++++- 1 files changed, 7 insertions(+), 1 deletions(-) diff --git a/builtin/describe.c b/builtin/describe.c index 43caff2..6b2b599 100644 --- a/builtin/describe.c +++ b/builtin/describe.c @@ -22,6 +22,7 @@ static int tags; /* Allow lightweight tags */ static int longformat; static int abbrev = DEFAULT_ABBREV; static int max_candidates = 10; +static int first_parent; static int found_names; static const char *pattern; static int always; @@ -302,7 +303,7 @@ static void describe(const char *arg, int last_one) if (!(p->object.flags & SEEN)) insert_by_date(p, &list); p->object.flags |= c->object.flags; - parents = parents->next; + parents = first_parent ? NULL : parents->next; } } @@ -380,6 +381,8 @@ int cmd_describe(int argc, const char **argv, const char *prefix) "only consider tags matching <pattern>"), OPT_BOOLEAN(0, "always", &always, "show abbreviated commit object as fallback"), + OPT_BOOLEAN(0, "first-parent", &first_parent, + "follow first parents only"), {OPTION_STRING, 0, "dirty", &dirty, "mark", "append <mark> on dirty working tree (default: \"-dirty\")", PARSE_OPT_OPTARG, NULL, (intptr_t) "-dirty"}, @@ -397,6 +400,9 @@ int cmd_describe(int argc, const char **argv, const char *prefix) if (longformat && abbrev == 0) die("--long is incompatible with --abbrev=0"); + if (contains && first-parent) + die("--contains is incompatible with --first-parent"); + if (contains) { const char **args = xmalloc((7 + argc) * sizeof(char *)); int i = 0; -- 1.7.3.234.g7bba3 -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html