diff options
author | Jakob Pfender <jpfender@elegosoft.com> | 2011-04-11 12:38:50 +0200 |
---|---|---|
committer | Jakob Pfender <jpfender@elegosoft.com> | 2011-04-11 12:38:50 +0200 |
commit | 1eb0f68ec7735bd3df8f9cb49fed232d1bbfae3d (patch) | |
tree | a649cb025892f8f3947ba4cbd0fa98ff3ae9b368 /include/git2 | |
parent | fd279b262df31c9a5d88db78e9e9a6de07e62979 (diff) | |
parent | fdd0cc9e8948bb65c9a461c58e5094a3613bd975 (diff) | |
download | libgit2-1eb0f68ec7735bd3df8f9cb49fed232d1bbfae3d.tar.gz |
merge branch development
Diffstat (limited to 'include/git2')
-rw-r--r-- | include/git2/commit.h | 20 | ||||
-rw-r--r-- | include/git2/common.h | 6 | ||||
-rw-r--r-- | include/git2/repository.h | 30 | ||||
-rw-r--r-- | include/git2/signature.h | 23 |
4 files changed, 73 insertions, 6 deletions
diff --git a/include/git2/commit.h b/include/git2/commit.h index c09b34843..3687d9460 100644 --- a/include/git2/commit.h +++ b/include/git2/commit.h @@ -136,6 +136,16 @@ GIT_EXTERN(const git_signature *) git_commit_author(git_commit *commit); GIT_EXTERN(int) git_commit_tree(git_tree **tree_out, git_commit *commit); /** + * Get the id of the tree pointed to by a commit. This differs from + * `git_commit_tree` in that no attempts are made to fetch an object + * from the ODB. + * + * @param commit a previously loaded commit. + * @return the id of tree pointed to by commit. + */ +GIT_EXTERN(const git_oid *) git_commit_tree_oid(git_commit *commit); + +/** * Get the number of parents of this commit * * @param commit a previously loaded commit. @@ -153,6 +163,16 @@ GIT_EXTERN(unsigned int) git_commit_parentcount(git_commit *commit); */ GIT_EXTERN(int) git_commit_parent(git_commit **parent, git_commit *commit, unsigned int n); +/** + * Get the oid of a specified parent for a commit. This is different from + * `git_commit_parent`, which will attempt to load the parent commit from + * the ODB. + * + * @param commit a previously loaded commit. + * @param n the position of the parent (from 0 to `parentcount`) + * @return the id of the parent, NULL on error. + */ +GIT_EXTERN(const git_oid *) git_commit_parent_oid(git_commit *commit, unsigned int n); /** * Create a new commit in the repository diff --git a/include/git2/common.h b/include/git2/common.h index e0c6bc542..22c7cc466 100644 --- a/include/git2/common.h +++ b/include/git2/common.h @@ -164,6 +164,12 @@ /** A reference with this name already exists */ #define GIT_EEXISTS (GIT_ERROR - 23) +/** The given integer literal is too large to be parsed */ +#define GIT_EOVERFLOW (GIT_ERROR - 24) + +/** The given literal is not a valid number */ +#define GIT_ENOTNUM (GIT_ERROR - 25) + GIT_BEGIN_DECL typedef struct { diff --git a/include/git2/repository.h b/include/git2/repository.h index 00c1f20d0..c47fcfc9a 100644 --- a/include/git2/repository.h +++ b/include/git2/repository.h @@ -182,6 +182,36 @@ GIT_EXTERN(void) git_repository_free(git_repository *repo); */ GIT_EXTERN(int) git_repository_init(git_repository **repo_out, const char *path, unsigned is_bare); +/** + * Check if a repository is empty + * + * An empty repository has just been initialized and contains + * no commits. + * + * @param repo Repo to test + * @return 1 if the repository is empty, 0 if it isn't, error code + * if the repository is corrupted + */ +GIT_EXTERN(int) git_repository_is_empty(git_repository *repo); + +/** + * Get the normalized path to the git repository. + * + * @param repo a repository object + * @return absolute path to the git directory + */ +GIT_EXTERN(const char *) git_repository_path(git_repository *repo); + +/** + * Get the normalized path to the working directory of the repository. + * + * If the repository is bare, there is no working directory and NULL we be returned. + * + * @param repo a repository object + * @return NULL if the repository is bare; absolute path to the working directory otherwise. + */ +GIT_EXTERN(const char *) git_repository_workdir(git_repository *repo); + /** @} */ GIT_END_DECL #endif diff --git a/include/git2/signature.h b/include/git2/signature.h index 40412a45f..44d1f285e 100644 --- a/include/git2/signature.h +++ b/include/git2/signature.h @@ -41,19 +41,30 @@ GIT_BEGIN_DECL * Create a new action signature. The signature must be freed * manually or using git_signature_free * - * @name name of the person - * @email email of the person - * @time time when the action happened - * @offset timezone offset in minutes for the time + * @param name name of the person + * @param mail email of the person + * @param time time when the action happened + * @param offset timezone offset in minutes for the time * @return the new sig, NULL on out of memory */ GIT_EXTERN(git_signature *) git_signature_new(const char *name, const char *email, git_time_t time, int offset); /** + * Create a new action signature with a timestamp of 'now'. The + * signature must be freed manually or using git_signature_free + * + * @param name name of the person + * @param email email of the person + * @return the new sig, NULL on out of memory + */ +GIT_EXTERN(git_signature *) git_signature_now(const char *name, const char *email); + + +/** * Create a copy of an existing signature. * * All internal strings are also duplicated. - * @sig signature to duplicated + * @param sig signature to duplicated * @return a copy of sig, NULL on out of memory */ GIT_EXTERN(git_signature *) git_signature_dup(const git_signature *sig); @@ -61,7 +72,7 @@ GIT_EXTERN(git_signature *) git_signature_dup(const git_signature *sig); /** * Free an existing signature * - * @sig signature to free + * @param sig signature to free */ GIT_EXTERN(void) git_signature_free(git_signature *sig); |