diff options
author | Vicent Marti <tanoku@gmail.com> | 2013-04-15 23:54:28 +0200 |
---|---|---|
committer | Vicent Marti <tanoku@gmail.com> | 2013-04-15 23:54:28 +0200 |
commit | e13a0647a062073fee9ec26f0f3101b50b620c8b (patch) | |
tree | 43e66cf9746eefaa57d884e6b2a03bdb807fa708 | |
parent | cbda09d00bb2aa703f90251b231c74d7acc6d21c (diff) | |
download | libgit2-e13a0647a062073fee9ec26f0f3101b50b620c8b.tar.gz |
Update docs
-rw-r--r-- | include/git2/revparse.h | 16 |
1 files changed, 7 insertions, 9 deletions
diff --git a/include/git2/revparse.h b/include/git2/revparse.h index c0479c353..e155c7012 100644 --- a/include/git2/revparse.h +++ b/include/git2/revparse.h @@ -47,26 +47,24 @@ typedef enum { } git_revparse_mode_t; /** - * Git Revision: output of a `git_revparse` operation + * Git Revision Spec: output of a `git_revparse` operation */ typedef struct { + /** The left element of the revspec; must be freed by the user */ git_object *from; + /** The right element of the revspec; must be freed by the user */ git_object *to; + /** The intent of the revspec */ unsigned int flags; } git_revspec; /** - * Parse a revision string for left, right, and intent. See `man gitrevisions` or + * Parse a revision string for `from`, `to`, and intent. See `man gitrevisions` or * http://git-scm.com/docs/git-rev-parse.html#_specifying_revisions for information * on the syntax accepted. * - * @param left buffer that receives the target of the left side of a range operator. If - * there is no range operator, this buffer receives the single target. - * @param right buffer that receives the target of the right side of a range operator. - * This is only filled in if `spec` specifies a range of commits. May - * be NULL. - * @param flags buffer that receives a bitwise combination of `git_revparse_flag_t` values. - * May be NULL. + * @param revspec Pointer to an user-allocated git_revspec struct where the result + * of the rev-parse will be stored * @param repo the repository to search in * @param spec the rev-parse spec to parse * @return 0 on success, GIT_INVALIDSPEC, GIT_ENOTFOUND, GIT_EAMBIGUOUS or an error code |