thodg/libgit2/src/git/tag.h

• Show log

  Commit

• Hash : 1795f879
  Author :
  Date : 2010-11-05T03:20:17
  

  Improve error handling
  
  All initialization functions now return error codes instead of pointers.
  Error codes are now properly propagated on most functions. Several new
  and more specific error codes have been added in common.h
  
  Signed-off-by: Vicent Marti <tanoku@gmail.com>
  

Download

• src/git/tag.h

• #ifndef INCLUDE_git_tag_h__
  #define INCLUDE_git_tag_h__
  
  #include "common.h"
  #include "oid.h"
  #include "tree.h"
  #include "repository.h"
  
  /**
   * @file git/tag.h
   * @brief Git tag parsing routines
   * @defgroup git_tag Git tag management
   * @ingroup Git
   * @{
   */
  GIT_BEGIN_DECL
  
  /** Parsed representation of a tag object. */
  typedef struct git_tag git_tag;
  
  /**
   * Lookup a tag object from the repository.
   * The generated tag object is owned by the revision
   * repo and shall not be freed by the user.
   *
   * @param tag pointer to the looked up tag
   * @param repo the repo to use when locating the tag.
   * @param id identity of the tag to locate.
   * @return 0 on success; error code otherwise
   */
  GIT_EXTERN(int) git_tag_lookup(git_tag **tag, git_repository *repo, const git_oid *id);
  
  /**
   * Create a new in-memory git_tag.
   *
   * The tag object must be manually filled using
   * setter methods before it can be written to its
   * repository.
   *
   * @param tag pointer to the new tag
   * @param repo The repository where the object will reside
   * @return 0 on success; error code otherwise
   */
  GIT_EXTERN(int) git_tag_new(git_tag **tag, git_repository *repo);
  
  /**
   * Get the id of a tag.
   * @param tag a previously loaded tag.
   * @return object identity for the tag.
   */
  GIT_EXTERN(const git_oid *) git_tag_id(git_tag *tag);
  
  /**
   * Get the tagged object of a tag
   * @param tag a previously loaded tag.
   * @return reference to a repository object
   */
  GIT_EXTERN(const git_object *) git_tag_target(git_tag *t);
  
  /**
   * Get the type of a tag's tagged object
   * @param tag a previously loaded tag.
   * @return type of the tagged object
   */
  GIT_EXTERN(git_otype) git_tag_type(git_tag *t);
  
  /**
   * Get the name of a tag
   * @param tag a previously loaded tag.
   * @return name of the tag
   */
  GIT_EXTERN(const char *) git_tag_name(git_tag *t);
  
  /**
   * Get the tagger (author) of a tag
   * @param tag a previously loaded tag.
   * @return reference to the tag's author
   */
  GIT_EXTERN(const git_person *) git_tag_tagger(git_tag *t);
  
  /**
   * Get the message of a tag
   * @param tag a previously loaded tag.
   * @return message of the tag
   */
  GIT_EXTERN(const char *) git_tag_message(git_tag *t);
  
  /**
   * Set the target of a tag (i.e. the object that the tag points to)
   * @param tag The tag to modify
   * @param target the new tagged target
   */
  GIT_EXTERN(void) git_tag_set_target(git_tag *tag, git_object *target);
  
  /**
   * Set the name of a tag
   * @param tag The tag to modify
   * @param name the new name for the tag
   */
  GIT_EXTERN(void) git_tag_set_name(git_tag *tag, const char *name);
  
  /**
   * Set the tagger of a tag
   * @param tag The tag to modify
   * @param name the name of the new tagger
   * @param email the email of the new tagger
   * @param time the time when the tag was created
   */
  GIT_EXTERN(void) git_tag_set_tagger(git_tag *tag, const char *name, const char *email, time_t time);
  
  /**
   * Set the message of a tag
   * @param tag The tag to modify
   * @param message the new tagger for the tag
   */
  GIT_EXTERN(void) git_tag_set_message(git_tag *tag, const char *message);
  
  /** @} */
  GIT_END_DECL
  #endif
  

Download