From: Michael Haggerty <mhagger@alum.mit.edu>
Date: Sun, 14 Apr 2013 12:54:17 +0000 (+0200)
Subject: refs: document the fields of struct ref_value
X-Git-Tag: v1.8.4-rc0~251^2~31
X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=6c6f58dfd26c0643e38d7ea754b6d4173573a1f6;p=git-core%2Fgit.git

refs: document the fields of struct ref_value

Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
---

diff --git a/refs.c b/refs.c
index 6b3511ee0..ed1b4cf9b 100644
--- a/refs.c
+++ b/refs.c
@@ -108,7 +108,19 @@ struct ref_entry;
  * (ref_entry->flag & REF_DIR) is zero.
  */
 struct ref_value {
+	/*
+	 * The name of the object to which this reference resolves
+	 * (which may be a tag object).  If REF_ISBROKEN, this is
+	 * null.  If REF_ISSYMREF, then this is the name of the object
+	 * referred to by the last reference in the symlink chain.
+	 */
 	unsigned char sha1[20];
+
+	/*
+	 * If REF_KNOWS_PEELED, then this field holds the peeled value
+	 * of this reference, or null if the reference is known not to
+	 * be peelable.
+	 */
 	unsigned char peeled[20];
 };