summaryrefslogtreecommitdiff
path: root/refs.h
diff options
context:
space:
mode:
authorRené Scharfe <l.s.r@web.de>2017-09-23 11:41:45 +0200
committerJunio C Hamano <gitster@pobox.com>2017-09-24 10:18:18 +0900
commit54fad6614fc6b61ee6eb4a5b3daa7a2239019b49 (patch)
treea92e973eb56be4876524c2fdae0239bf1afff1f1 /refs.h
parent59c0ea183ad1c5c2b3790caa5046e4ecfa839247 (diff)
downloadgit-54fad6614fc6b61ee6eb4a5b3daa7a2239019b49.tar.gz
refs: make sha1 output parameter of refs_resolve_ref_unsafe() optional
Allow callers of refs_resolve_ref_unsafe() to pass NULL if they don't need the resolved hash value. We already allow the same for the flags parameter. This new leniency is inherited by the various wrappers like resolve_ref_unsafe(). Signed-off-by: Rene Scharfe <l.s.r@web.de> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'refs.h')
-rw-r--r--refs.h9
1 files changed, 5 insertions, 4 deletions
diff --git a/refs.h b/refs.h
index 78a26400b6..996d4ea54d 100644
--- a/refs.h
+++ b/refs.h
@@ -10,10 +10,11 @@ struct worktree;
/*
* Resolve a reference, recursively following symbolic refererences.
*
- * Store the referred-to object's name in sha1 and return the name of
- * the non-symbolic reference that ultimately pointed at it. The
- * return value, if not NULL, is a pointer into either a static buffer
- * or the input ref.
+ * Return the name of the non-symbolic reference that ultimately pointed
+ * at the resolved object name. The return value, if not NULL, is a
+ * pointer into either a static buffer or the input ref.
+ *
+ * If sha1 is non-NULL, store the referred-to object's name in it.
*
* If the reference cannot be resolved to an object, the behavior
* depends on the RESOLVE_REF_READING flag: