summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRobin Stocker <robin@nibor.org>2013-04-22 15:35:10 +0200
committerRobin Stocker <robin@nibor.org>2013-04-22 15:35:26 +0200
commit60f0eb748ca7fa0efd28018b9fa30b95deac29f8 (patch)
tree18ce6ebc31903ece0bab6375f742bfd2f8c209d9
parent1b4320f1fa46169ad08a1d3d40ca00a4224881cd (diff)
downloadjgit-60f0eb748ca7fa0efd28018b9fa30b95deac29f8.tar.gz
jgit-60f0eb748ca7fa0efd28018b9fa30b95deac29f8.zip
Improve class documentation of TagCommand
Change-Id: I9c636b927fa2d7cfbe1eb5535a9e702b2209f51d
-rw-r--r--org.eclipse.jgit/src/org/eclipse/jgit/api/TagCommand.java17
1 files changed, 13 insertions, 4 deletions
diff --git a/org.eclipse.jgit/src/org/eclipse/jgit/api/TagCommand.java b/org.eclipse.jgit/src/org/eclipse/jgit/api/TagCommand.java
index 1784acd79b..3b1fe88409 100644
--- a/org.eclipse.jgit/src/org/eclipse/jgit/api/TagCommand.java
+++ b/org.eclipse.jgit/src/org/eclipse/jgit/api/TagCommand.java
@@ -1,5 +1,5 @@
/*
- * Copyright (C) 2010, Chris Aniszczyk <caniszczyk@gmail.com>
+ * Copyright (C) 2010, 2013 Chris Aniszczyk <caniszczyk@gmail.com>
* and other copyright owners as documented in the project's IP log.
*
* This program and the accompanying materials are made available
@@ -66,9 +66,18 @@ import org.eclipse.jgit.revwalk.RevObject;
import org.eclipse.jgit.revwalk.RevWalk;
/**
- * A class used to execute a {@code Tag} command. It has setters for all
- * supported options and arguments of this command and a {@link #call()} method
- * to finally execute the command.
+ * Create/update an annotated tag object.
+ * <p>
+ * Examples (<code>git</code> is a {@link Git} instance):
+ * <p>
+ * Create a new annotated tag for the current commit:
+ *
+ * <pre>
+ * git.tag().setName(&quot;v1.0&quot;).setMessage(&quot;First stable release&quot;).call();
+ * </pre>
+ * <p>
+ * Use {@link Repository#updateRef(String)} to create a lightweight tag (just a
+ * named reference to a commit).
*
* @see <a href="http://www.kernel.org/pub/software/scm/git/docs/git-tag.html"
* >Git documentation about Tag</a>