Add missing @since tags to mark API added in 2.0

Change-Id: I0a86ce0e393dfde9bb27f0b29e036e76c856396e
Signed-off-by: Matthias Sohn <matthias.sohn@sap.com>
Signed-off-by: Chris Aniszczyk <zx@twitter.com>

org.eclipse.jgit/src/org/eclipse/jgit/api/ApplyCommand.java

@@ -68,6 +68,7 @@ import org.eclipse.jgit.util.IO;
  *
  * @see <a href="http://www.kernel.org/pub/software/scm/git/docs/git-apply.html"
  *      >Git documentation about apply</a>
+ * @since 2.0
  */
 public class ApplyCommand extends GitCommand<ApplyResult> {
 

org.eclipse.jgit/src/org/eclipse/jgit/api/ApplyResult.java

@@ -48,6 +48,8 @@ import java.util.List;
 
 /**
  * Encapsulates the result of a {@link ApplyCommand}
+ *
+ * @since 2.0
  */
 public class ApplyResult {
 

org.eclipse.jgit/src/org/eclipse/jgit/api/CheckoutCommand.java

@@ -253,6 +253,7 @@ public class CheckoutCommand extends GitCommand<Ref> {
 	 * @param all
 	 *            true to checkout all paths, false otherwise
 	 * @return {@code this}
+	 * @since 2.0
 	 */
 	public CheckoutCommand setAllPaths(boolean all) {
 		checkoutAllPaths = all;

org.eclipse.jgit/src/org/eclipse/jgit/api/Git.java

@@ -576,6 +576,7 @@ public class Git {
 	 * Returns a command object used to create a stashed commit
 	 *
 	 * @return a {@link StashCreateCommand}
+	 * @since 2.0
 	 */
 	public StashCreateCommand stashCreate() {
 		return new StashCreateCommand(repo);
@@ -585,6 +586,7 @@ public class Git {
 	 * Returns a command object used to apply a stashed commit
 	 *
 	 * @return a {@link StashApplyCommand}
+	 * @since 2.0
 	 */
 	public StashApplyCommand stashApply() {
 		return new StashApplyCommand(repo);
@@ -594,6 +596,7 @@ public class Git {
 	 * Returns a command object used to drop a stashed commit
 	 *
 	 * @return a {@link StashDropCommand}
+	 * @since 2.0
 	 */
 	public StashDropCommand stashDrop() {
 		return new StashDropCommand(repo);
@@ -608,6 +611,7 @@ public class Git {
 	 *
 	 * @return a {@link ApplyCommand} used to collect all optional parameters
 	 *         and to finally execute the {@code apply} command
+	 * @since 2.0
 	 */
 	public ApplyCommand apply() {
 		return new ApplyCommand(repo);

org.eclipse.jgit/src/org/eclipse/jgit/api/RebaseResult.java

@@ -113,6 +113,8 @@ public class RebaseResult {
 
 		/**
 		 * Continue with nothing left to commit (possibly want skip).
+		 *
+		 * @since 2.0
 		 */
 		NOTHING_TO_COMMIT {
 			@Override

org.eclipse.jgit/src/org/eclipse/jgit/api/StashCreateCommand.java

@@ -85,6 +85,7 @@ import org.eclipse.jgit.treewalk.filter.SkipWorkTreeFilter;
  *
  * @see <a href="http://www.kernel.org/pub/software/scm/git/docs/git-stash.html"
  *      >Git documentation about Stash</a>
+ * @since 2.0
  */
 public class StashCreateCommand extends GitCommand<RevCommit> {
 

org.eclipse.jgit/src/org/eclipse/jgit/api/StashDropCommand.java

@@ -69,6 +69,7 @@ import org.eclipse.jgit.util.FileUtils;
  *
  * @see <a href="http://www.kernel.org/pub/software/scm/git/docs/git-stash.html"
  *      >Git documentation about Stash</a>
+ * @since 2.0
  */
 public class StashDropCommand extends GitCommand<ObjectId> {
 

org.eclipse.jgit/src/org/eclipse/jgit/api/TagCommand.java

@@ -105,6 +105,7 @@ public class TagCommand extends GitCommand<Ref> {
 	 *             exception can be retrieved by calling
 	 *             {@link Exception#getCause()}. Expect only
 	 *             {@code IOException's} to be wrapped.
+	 * @since 2.0
 	 */
 	public Ref call() throws JGitInternalException,
 			ConcurrentRefUpdateException, InvalidTagNameException, NoHeadException {

org.eclipse.jgit/src/org/eclipse/jgit/diff/DiffFormatter.java

@@ -278,6 +278,7 @@ public class DiffFormatter {
 	 * Get the prefix applied in front of old file paths.
 	 *
 	 * @return the prefix
+	 * @since 2.0
 	 */
 	public String getOldPrefix() {
 		return this.oldPrefix;
@@ -300,6 +301,7 @@ public class DiffFormatter {
 	 * Get the prefix applied in front of new file paths.
 	 * 
 	 * @return the prefix
+	 * @since 2.0
 	 */
 	public String getNewPrefix() {
 		return this.newPrefix;

org.eclipse.jgit/src/org/eclipse/jgit/dircache/InvalidPathException.java

@@ -49,6 +49,8 @@ import org.eclipse.jgit.internal.JGitText;
 
 /**
  * Thrown when JGit detects and refuses to use an invalid path
+ *
+ * @since 2.0
  */
 public class InvalidPathException extends IllegalArgumentException {
 

org.eclipse.jgit/src/org/eclipse/jgit/storage/dfs/InMemoryRepository.java

@@ -35,6 +35,7 @@ public class InMemoryRepository extends DfsRepository {
 	 *
 	 * @param repoDesc
 	 *            description of the repository.
+	 * @since 2.0
 	 */
 	public InMemoryRepository(DfsRepositoryDescription repoDesc) {
 		super(new DfsRepositoryBuilder<DfsRepositoryBuilder, InMemoryRepository>() {

org.eclipse.jgit/src/org/eclipse/jgit/storage/file/ReflogWriter.java

@@ -73,6 +73,8 @@ import org.eclipse.jgit.util.FileUtils;
 
 /**
  * Utility for writing reflog entries
+ *
+ * @since 2.0
  */
 public class ReflogWriter {
 

org.eclipse.jgit/src/org/eclipse/jgit/transport/AbstractAdvertiseRefsHook.java

@@ -53,6 +53,8 @@ import org.eclipse.jgit.revwalk.RevWalk;
 /**
  * Implementation of {@link AdvertiseRefsHook} that advertises the same refs for
  * upload-pack and receive-pack.
+ *
+ * @since 2.0
  */
 public abstract class AbstractAdvertiseRefsHook implements AdvertiseRefsHook {
 	public void advertiseRefs(UploadPack uploadPack)

org.eclipse.jgit/src/org/eclipse/jgit/transport/AdvertiseRefsHook.java

@@ -42,7 +42,11 @@
 
 package org.eclipse.jgit.transport;
 
-/** Hook to allow callers to take over advertising refs to the client. */
+/**
+ * Hook to allow callers to take over advertising refs to the client.
+ *
+ * @since 2.0
+ */
 public interface AdvertiseRefsHook {
 	/**
 	 * A simple hook that advertises the default refs.

org.eclipse.jgit/src/org/eclipse/jgit/transport/BasePackFetchConnection.java

@@ -120,34 +120,64 @@ public abstract class BasePackFetchConnection extends BasePackConnection
 	 */
 	protected static final int MIN_CLIENT_BUFFER = 2 * 32 * 46 + 8;
 
-	/** Include tags if we are also including the referenced objects. */
+	/**
+	 * Include tags if we are also including the referenced objects.
+	 * @since 2.0
+	 */
 	public static final String OPTION_INCLUDE_TAG = "include-tag";
 
-	/** Mutli-ACK support for improved negotiation. */
+	/**
+	 * Mutli-ACK support for improved negotiation.
+	 * @since 2.0
+	 */
 	public static final String OPTION_MULTI_ACK = "multi_ack";
 
-	/** Mutli-ACK detailed support for improved negotiation. */
+	/**
+	 * Mutli-ACK detailed support for improved negotiation.
+	 * @since 2.0
+	 */
 	public static final String OPTION_MULTI_ACK_DETAILED = "multi_ack_detailed";
 
-	/** The client supports packs with deltas but not their bases. */
+	/**
+	 * The client supports packs with deltas but not their bases.
+	 * @since 2.0
+	 */
 	public static final String OPTION_THIN_PACK = "thin-pack";
 
-	/** The client supports using the side-band for progress messages. */
+	/**
+	 * The client supports using the side-band for progress messages.
+	 * @since 2.0
+	 */
 	public static final String OPTION_SIDE_BAND = "side-band";
 
-	/** The client supports using the 64K side-band for progress messages. */
+	/**
+	 * The client supports using the 64K side-band for progress messages.
+	 * @since 2.0
+	 */
 	public static final String OPTION_SIDE_BAND_64K = "side-band-64k";
 
-	/** The client supports packs with OFS deltas. */
+	/**
+	 * The client supports packs with OFS deltas.
+	 * @since 2.0
+	 */
 	public static final String OPTION_OFS_DELTA = "ofs-delta";
 
-	/** The client supports shallow fetches. */
+	/**
+	 * The client supports shallow fetches.
+	 * @since 2.0
+	 */
 	public static final String OPTION_SHALLOW = "shallow";
 
-	/** The client does not want progress messages and will ignore them. */
+	/**
+	 * The client does not want progress messages and will ignore them.
+	 * @since 2.0
+	 */
 	public static final String OPTION_NO_PROGRESS = "no-progress";
 
-	/** The client supports receiving a pack before it has sent "done". */
+	/**
+	 * The client supports receiving a pack before it has sent "done".
+	 * @since 2.0
+	 */
 	public static final String OPTION_NO_DONE = "no-done";
 
 	static enum MultiAck {
@@ -695,6 +725,8 @@ public abstract class BasePackFetchConnection extends BasePackConnection
 	 * Notification event delivered just before the pack is received from the
 	 * network. This event can be used by RPC such as {@link TransportHttp} to
 	 * disable its request magic and ensure the pack stream is read correctly.
+	 *
+	 * @since 2.0
 	 */
 	protected void onReceivePack() {
 		// By default do nothing for TCP based protocols.

org.eclipse.jgit/src/org/eclipse/jgit/transport/BasePackPushConnection.java

@@ -83,16 +83,28 @@ import org.eclipse.jgit.transport.RemoteRefUpdate.Status;
  */
 public abstract class BasePackPushConnection extends BasePackConnection implements
 		PushConnection {
-	/** The client expects a status report after the server processes the pack. */
+	/**
+	 * The client expects a status report after the server processes the pack.
+	 * @since 2.0
+	 */
 	public static final String CAPABILITY_REPORT_STATUS = "report-status";
 
-	/** The server supports deleting refs. */
+	/**
+	 * The server supports deleting refs.
+	 * @since 2.0
+	 */
 	public static final String CAPABILITY_DELETE_REFS = "delete-refs";
 
-	/** The server supports packs with OFS deltas. */
+	/**
+	 * The server supports packs with OFS deltas.
+	 * @since 2.0
+	 */
 	public static final String CAPABILITY_OFS_DELTA = "ofs-delta";
 
-	/** The client supports using the 64K side-band for progress messages. */
+	/**
+	 * The client supports using the 64K side-band for progress messages.
+	 * @since 2.0
+	 */
 	public static final String CAPABILITY_SIDE_BAND_64K = "side-band-64k";
 
 	private final boolean thinPack;

org.eclipse.jgit/src/org/eclipse/jgit/transport/ReceiveCommand.java

@@ -129,8 +129,9 @@ public class ReceiveCommand {
 	 *            commands to filter.
 	 * @param want
 	 *            desired status to filter by.
-	 * @return a copy of the command list containing only those commands with the
+	 * @return a copy of the command list containing only those commands with
-	 *         desired status.
+	 *         the desired status.
+	 * @since 2.0
 	 */
 	public static List<ReceiveCommand> filter(List<ReceiveCommand> commands,
 			final Result want) {
@@ -195,6 +196,7 @@ public class ReceiveCommand {
 	 *            name of the ref being affected.
 	 * @param type
 	 *            type of the command.
+	 * @since 2.0
 	 */
 	public ReceiveCommand(final ObjectId oldId, final ObjectId newId,
 			final String name, final Type type) {
@@ -269,6 +271,7 @@ public class ReceiveCommand {
 	 *
 	 * @param rp
 	 *            receive-pack session.
+	 * @since 2.0
 	 */
 	public void execute(final ReceivePack rp) {
 		try {

org.eclipse.jgit/src/org/eclipse/jgit/transport/RequestNotYetReadException.java

@@ -43,7 +43,11 @@
 
 package org.eclipse.jgit.transport;
 
-/** Indicates that a client request has not yet been read from the wire. */
+/**
+ * Indicates that a client request has not yet been read from the wire.
+ *
+ * @since 2.0
+ */
 public class RequestNotYetReadException extends IllegalStateException {
 	private static final long serialVersionUID = 1L;
 

org.eclipse.jgit/src/org/eclipse/jgit/transport/ServiceMayNotContinueException.java

@@ -45,7 +45,11 @@ package org.eclipse.jgit.transport;
 
 import java.io.IOException;
 
-/** Indicates a transport service may not continue execution. */
+/**
+ * Indicates a transport service may not continue execution.
+ *
+ * @since 2.0
+ */
 public class ServiceMayNotContinueException extends IOException {
 	private static final long serialVersionUID = 1L;
 

org.eclipse.jgit/src/org/eclipse/jgit/transport/SideBandOutputStream.java

@@ -54,6 +54,8 @@ import org.eclipse.jgit.internal.JGitText;
  * <p>
  * This stream is buffered at packet sizes, so the caller doesn't need to wrap
  * it in yet another buffered stream.
+ *
+ * @since 2.0
  */
 public class SideBandOutputStream extends OutputStream {
 	/** Channel used for pack data. */

org.eclipse.jgit/src/org/eclipse/jgit/treewalk/AbstractTreeIterator.java

@@ -651,6 +651,7 @@ public abstract class AbstractTreeIterator {
 	 * JGit internal API for use by {@link DirCacheCheckout}
 	 *
 	 * @return start of name component part within {@link #getEntryPathBuffer()}
+	 * @since 2.0
 	 */
 	public int getNameOffset() {
 		return pathOffset;

org.eclipse.jgit/src/org/eclipse/jgit/util/FileUtils.java

@@ -79,6 +79,7 @@ public class FileUtils {
 
 	/**
 	 * Option not to throw exceptions when a deletion finally doesn't succeed.
+	 * @since 2.0
 	 */
 	public static final int IGNORE_ERRORS = 8;
 

org.eclipse.jgit/src/org/eclipse/jgit/util/IO.java

@@ -339,6 +339,7 @@ public class IO {
 	 * @param s
 	 *            the string to read
 	 * @return the string divided into lines
+	 * @since 2.0
 	 */
 	public static List<String> readLines(final String s) {
 		List<String> l = new ArrayList<String>();

org.eclipse.jgit/src/org/eclipse/jgit/util/StringUtils.java

@@ -132,6 +132,7 @@ public final class StringUtils {
 	 *            second string to compare.
 	 * @return negative, zero or positive if a sorts before, is equal to, or
 	 *         sorts after b.
+	 * @since 2.0
 	 */
 	public static int compareIgnoreCase(String a, String b) {
 		for (int i = 0; i < a.length() && i < b.length(); i++) {
@@ -154,6 +155,7 @@ public final class StringUtils {
 	 *            second string to compare.
 	 * @return negative, zero or positive if a sorts before, is equal to, or
 	 *         sorts after b.
+	 * @since 2.0
 	 */
 	public static int compareWithCase(String a, String b) {
 		for (int i = 0; i < a.length() && i < b.length(); i++) {

org.eclipse.jgit/src/org/eclipse/jgit/util/io/EolCanonicalizingInputStream.java

@@ -77,6 +77,7 @@ public class EolCanonicalizingInputStream extends InputStream {
 	 *            raw input stream
 	 * @param detectBinary
 	 *            whether binaries should be detected
+	 * @since 2.0
 	 */
 	public EolCanonicalizingInputStream(InputStream in, boolean detectBinary) {
 		this.in = in;