From 3699ea648ef900ce845af61ab29f8225c530b60b Mon Sep 17 00:00:00 2001
From: Robin Stocker <robin@nibor.org>
Date: Mon, 22 Apr 2013 18:22:18 +0200
Subject: [PATCH] Document RevTag#getObject() that returned object is unparsed

Change-Id: I238d388e40362721eecf37f64ad7d48a399ff129
---
 .../src/org/eclipse/jgit/revwalk/RevTag.java           | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/revwalk/RevTag.java b/org.eclipse.jgit/src/org/eclipse/jgit/revwalk/RevTag.java
index 269b6c104..12693a03e 100644
--- a/org.eclipse.jgit/src/org/eclipse/jgit/revwalk/RevTag.java
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/revwalk/RevTag.java
@@ -240,8 +240,16 @@ public final String getShortMessage() {
 
 	/**
 	 * Get a reference to the object this tag was placed on.
+	 * <p>
+	 * Note that the returned object has only been looked up (see
+	 * {@link RevWalk#lookupAny(AnyObjectId, int)}. To access the contents it
+	 * needs to be parsed, see {@link RevWalk#parseHeaders(RevObject)} and
+	 * {@link RevWalk#parseBody(RevObject)}.
+	 * <p>
+	 * As an alternative, use {@link RevWalk#peel(RevObject)} and pass this
+	 * {@link RevTag} to peel it until the first non-tag object.
 	 *
-	 * @return object this tag refers to.
+	 * @return object this tag refers to (only looked up, not parsed)
 	 */
 	public final RevObject getObject() {
 		return object;