Add '@since' Javadoc tag to all testing APIs (issue #864).

2 files changed, 15 insertions, 2 deletions

diff --git a/testing/src/main/java/io/opencensus/testing/common/TestClock.java b/testing/src/main/java/io/opencensus/testing/common/TestClock.java
index 7d88de43..b670cb7f 100644
--- a/testing/src/main/java/io/opencensus/testing/common/TestClock.java
+++ b/testing/src/main/java/io/opencensus/testing/common/TestClock.java
@@ -23,7 +23,11 @@ import io.opencensus.common.Timestamp;
 import javax.annotation.concurrent.GuardedBy;
 import javax.annotation.concurrent.ThreadSafe;
 
-/** A {@link Clock} that allows the time to be set for testing. */
+/**
+ * A {@link Clock} that allows the time to be set for testing.
+ *
+ * @since 0.5
+ */
 @ThreadSafe
 public final class TestClock extends Clock {
   private static final int NUM_NANOS_PER_SECOND = 1000 * 1000 * 1000;
@@ -38,6 +42,7 @@ public final class TestClock extends Clock {
    * a good default, because it represents an invalid time.
    *
    * @return a clock initialized to a constant non-zero time.
+   * @since 0.5
    */
   public static TestClock create() {
     return new TestClock();
@@ -48,6 +53,7 @@ public final class TestClock extends Clock {
    *
    * @param time the initial time.
    * @return a new {@code TestClock} with the given time.
+   * @since 0.5
    */
   public static TestClock create(Timestamp time) {
     TestClock clock = new TestClock();
@@ -59,6 +65,7 @@ public final class TestClock extends Clock {
    * Sets the time.
    *
    * @param time the new time.
+   * @since 0.5
    */
   public synchronized void setTime(Timestamp time) {
     currentTime = validateNanos(time);
@@ -68,6 +75,7 @@ public final class TestClock extends Clock {
    * Advances the time by a duration.
    *
    * @param duration the increase in time.
+   * @since 0.5
    */
   public synchronized void advanceTime(Duration duration) {
     currentTime = validateNanos(currentTime.addDuration(duration));
diff --git a/testing/src/main/java/io/opencensus/testing/export/TestHandler.java b/testing/src/main/java/io/opencensus/testing/export/TestHandler.java
index 8f36b3bd..6d73aff1 100644
--- a/testing/src/main/java/io/opencensus/testing/export/TestHandler.java
+++ b/testing/src/main/java/io/opencensus/testing/export/TestHandler.java
@@ -25,7 +25,11 @@ import java.util.List;
 import javax.annotation.Nullable;
 import javax.annotation.concurrent.GuardedBy;
 
-/** A {@link SpanExporter.Handler} for testing only. */
+/**
+ * A {@link SpanExporter.Handler} for testing only.
+ *
+ * @since 0.9
+ */
 public final class TestHandler extends SpanExporter.Handler {
 
   private final Object monitor = new Object();
@@ -50,6 +54,7 @@ public final class TestHandler extends SpanExporter.Handler {
    * @param numberOfSpans the number of minimum spans to be collected.
    * @return the list of exported {@link SpanData} objects, otherwise {@code null} if the current
    *     thread is interrupted.
+   * @since 0.9
    */
   @Nullable
   public List<SpanData> waitForExport(int numberOfSpans) {