thodg/libgit2/include/git2/tag.h

• Show log

  Commit

• Hash : 6b2a1941
  Author :
  Date : 2011-03-12T23:09:16
  

  Fix the retarded object interdependency system It's no longer retarded. All object interdependencies are stored as OIDs instead of actual objects. This should be hundreds of times faster, specially on big repositories. Heck, who knows, maye it doesn't even segfault -- wouldn't that be awesome? What has changed on the API? `git_commit_parent`, `git_commit_tree`, `git_tag_target` now return their values through a pointer-to-pointer, and have an error code. `git_commit_set_tree` and `git_tag_set_target` now return an error code and may fail. `git_repository_free__no_gc` has been deprecated because it's stupid. Since there are no longer any interdependencies between objects, we don't need internal reference counting, and GC never fails or double-free's pointers. `git_object_close` now does a very sane thing: marks an object as unused. Closed objects will be eventually free'd from the object cache based on LRU. Please use `git_object_close` from the garbage collector `destroy` method on your bindings. It's 100% safe. `git_repository_gc` is a new method that forces a garbage collector pass through the repo, to free as many LRU objects as possible. This is useful if we are running out of memory.

Download

• include/git2/tag.h

• /*
   * This file is free software; you can redistribute it and/or modify
   * it under the terms of the GNU General Public License, version 2,
   * as published by the Free Software Foundation.
   *
   * In addition to the permissions in the GNU General Public License,
   * the authors give you unlimited permission to link the compiled
   * version of this file into combinations with other programs,
   * and to distribute those combinations without any restriction
   * coming from the use of this file.  (The General Public License
   * restrictions do apply in other respects; for example, they cover
   * modification of the file, and distribution when not linked into
   * a combined executable.)
   *
   * This file is distributed in the hope that it will be useful, but
   * WITHOUT ANY WARRANTY; without even the implied warranty of
   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   * General Public License for more details.
   *
   * You should have received a copy of the GNU General Public License
   * along with this program; see the file COPYING.  If not, write to
   * the Free Software Foundation, 51 Franklin Street, Fifth Floor,
   * Boston, MA 02110-1301, USA.
   */
  #ifndef INCLUDE_git_tag_h__
  #define INCLUDE_git_tag_h__
  
  #include "common.h"
  #include "types.h"
  #include "oid.h"
  #include "object.h"
  
  /**
   * @file git2/tag.h
   * @brief Git tag parsing routines
   * @defgroup git_tag Git tag management
   * @ingroup Git
   * @{
   */
  GIT_BEGIN_DECL
  
  /**
   * 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_INLINE(int) git_tag_lookup(git_tag **tag, git_repository *repo, const git_oid *id)
  {
  	return git_object_lookup((git_object **)tag, repo, id, (git_otype)GIT_OBJ_TAG);
  }
  
  /**
   * 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_INLINE(int) git_tag_new(git_tag **tag, git_repository *repo)
  {
  	return git_object_new((git_object **)tag, repo, (git_otype)GIT_OBJ_TAG);
  }
  
  /**
   * 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 target pointer where to store the target
   * @param tag a previously loaded tag.
   * @return 0 on success; error code otherwise
   */
  GIT_EXTERN(int) git_tag_target(git_object **target, git_tag *t);
  
  /**
   * Get the OID of the tagged object of a tag
   * @param tag a previously loaded tag.
   * @return pointer to the OID
   */
  GIT_EXTERN(const git_oid *) git_tag_target_oid(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_signature *) 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(int) 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 tagger_sig signature of the tagging action
   * @return 0 on success; error code otherwise
   */
  GIT_EXTERN(void) git_tag_set_tagger(git_tag *tag, const git_signature *tagger_sig);
  
  /**
   * 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