git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2] git-describe: Die early if there are no possible descriptions

From
Björn Steinbrink <b.steinbrink@gmx.de>
Date
Aug 6, 2009, 12:15 UTC
Message-ID
<20090806121514.GA1701@atjola.homenet>
In-Reply-To
<20090805154205.GA17792@atjola.homenet>

If we find no refs that may be used for git-describe with the current options, then die early instead of pointlessly walking the whole history.

In git.git with all the tags dropped, this makes "git describe" go down from 0.244 to 0.003 seconds for me. This is especially noticeable with "git submodule status" which calls describe with increasing levels of allowed refs to be matched. For a submodule without tags, this means that it walks the whole history in the submodule twice (first annotated, then plain tags), just to find out that it can't describe the commit anyway.

Signed-off-by: Björn Steinbrink <B.Steinbrink@gmx.de>
---
v2 improved the commit message and turned found_names into a boolean,
instead of a counter for the found names.
 builtin-describe.c |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
diff --git a/builtin-describe.c b/builtin-describe.c
index 7a66298..75feb11 100644
--- a/builtin-describe.c
+++ b/builtin-describe.c
@@ -20,6 +20,7 @@ static int tags;	/* Allow lightweight tags */
 static int longformat;
 static int abbrev = DEFAULT_ABBREV;
 static int max_candidates = 10;
+static int found_names = 0;
 static const char *pattern;
 static int always;
 
@@ -49,6 +50,7 @@ static void add_to_known_names(const char *path,
 		memcpy(e->path, path, len);
 		commit->util = e;
 	}
+	found_names = 1;
 }
 
 static int get_name(const char *path, const unsigned char *sha1, int flag, void *cb_data)
@@ -195,6 +197,9 @@ static void describe(const char *arg, int last_one)
 		for_each_ref(get_name, NULL);
 	}
 
+	if (!found_names)
+		die("cannot describe '%s'", sha1_to_hex(sha1));
+
 	n = cmit->util;
 	if (n) {
 		/*
-- 
1.6.4.20.gd25bb.dirty
Previous: Björn Steinbrink
Message 4 of 4 in “git-describe: Die early if there are no possible descriptions”
  1. git-describe: Die early if there are no possible descriptionsBjörn Steinbrink, Aug 5, 2009
  2. Shawn O. PearceAug 5, 2009
  3. Björn SteinbrinkAug 5, 2009
  4. git-describe: Die early if there are no possible descriptionsBjörn Steinbrink, Aug 6, 2009

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.