From 62dd4d71db1408ae03ca7d4d4d2c48f7874a41d9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Carlos=20Mart=C3=ADn=20Nieto?= Date: Sat, 7 Mar 2015 00:06:02 +0100 Subject: annotated_commit: provide a constructor from a revspec This extra constructor will be useful for the annotated versions of ref-modifying functions, as it allows us to create a commit with the extended sha syntax which was used to retrieve it. --- include/git2/annotated_commit.h | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'include/git2/annotated_commit.h') diff --git a/include/git2/annotated_commit.h b/include/git2/annotated_commit.h index e842d2032..7fb896a5f 100644 --- a/include/git2/annotated_commit.h +++ b/include/git2/annotated_commit.h @@ -77,6 +77,23 @@ GIT_EXTERN(int) git_annotated_commit_lookup( git_repository *repo, const git_oid *id); +/** + * Creates a `git_annotated_comit` from a revision string. + * + * See `man gitrevisions`, or + * http://git-scm.com/docs/git-rev-parse.html#_specifying_revisions for + * information on the syntax accepted. + * + * @param out pointer to store the git_annotated_commit result in + * @param repo repository that contains the given commit + * @param revspec the extended sha syntax string to use to lookup the commit + * @return 0 on success or error code + */ +GIT_EXTERN(int) git_annotated_commit_from_revspec( + git_annotated_commit **out, + git_repository *repo, + const char *revspec); + /** * Gets the commit ID that the given `git_annotated_commit` refers to. * -- cgit v1.2.1