From: Michael Haggerty Date: Mon, 12 Dec 2011 05:38:18 +0000 (+0100) Subject: resolve_gitlink_ref(): improve docstring X-Git-Tag: v1.7.9-rc0~35^2~5 X-Git-Url: https://git.lorimer.id.au/gitweb.git/diff_plain/7f820bd92008a366f391e243fbd51e076d75e3a6 resolve_gitlink_ref(): improve docstring Signed-off-by: Michael Haggerty Signed-off-by: Junio C Hamano --- diff --git a/refs.h b/refs.h index 4c5d570639..d4982915c5 100644 --- a/refs.h +++ b/refs.h @@ -133,8 +133,12 @@ extern char *shorten_unambiguous_ref(const char *refname, int strict); /** rename ref, return 0 on success **/ extern int rename_ref(const char *oldref, const char *newref, const char *logmsg); -/** resolve ref in nested "gitlink" repository */ -extern int resolve_gitlink_ref(const char *name, const char *refname, unsigned char *sha1); +/** + * Resolve refname in the nested "gitlink" repository that is located + * at path. If the resolution is successful, return 0 and set sha1 to + * the name of the object; otherwise, return a non-zero value. + */ +extern int resolve_gitlink_ref(const char *path, const char *refname, unsigned char *sha1); /** lock a ref and then write its file */ enum action_on_err { MSG_ON_ERR, DIE_ON_ERR, QUIET_ON_ERR };