Add since annotations

Author: jack-berg

common/src/main/java/io/opentelemetry/common/impl/ApiUsageLogger.java

@@ -25,6 +25,8 @@
  *
  * <p>This class is not intended for use by application developers. Its API is stable and will not
  * be changed or removed in a backwards-incompatible manner.
+ *
+ * @since 1.62.0
  */
 public final class ApiUsageLogger {
 

sdk/testing/src/main/java/io/opentelemetry/sdk/testing/assertj/DoubleGaugeAssert.java

@@ -50,6 +50,8 @@ public DoubleGaugeAssert hasPointsSatisfying(
    * Asserts that for each given assertion, at least one point in the gauge satisfies it. Extra
    * points that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   @SafeVarargs
   @SuppressWarnings("varargs")
@@ -62,6 +64,8 @@ public final DoubleGaugeAssert containsPointsSatisfying(
    * Asserts that for each given assertion, at least one point in the gauge satisfies it. Extra
    * points that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   public DoubleGaugeAssert containsPointsSatisfying(
       Iterable<? extends Consumer<DoublePointAssert>> assertions) {

sdk/testing/src/main/java/io/opentelemetry/sdk/testing/assertj/DoublePointAssert.java

@@ -34,7 +34,11 @@ public DoublePointAssert hasValue(double expected) {
     return this;
   }
 
-  /** Asserts the point's value satisfies the given assertion. */
+  /**
+   * Asserts the point's value satisfies the given assertion.
+   *
+   * @since 1.62.0
+   */
   public DoublePointAssert hasValueSatisfying(Consumer<AbstractDoubleAssert<?>> valueAssertion) {
     isNotNull();
     valueAssertion.accept(Assertions.assertThat(actual.getValue()).as("value"));

sdk/testing/src/main/java/io/opentelemetry/sdk/testing/assertj/DoubleSumAssert.java

@@ -93,6 +93,8 @@ public DoubleSumAssert hasPointsSatisfying(
    * Asserts that for each given assertion, at least one point in the sum satisfies it. Extra points
    * that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   @SafeVarargs
   @SuppressWarnings("varargs")
@@ -104,6 +106,8 @@ public final DoubleSumAssert containsPointsSatisfying(Consumer<DoublePointAssert
    * Asserts that for each given assertion, at least one point in the sum satisfies it. Extra points
    * that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   public DoubleSumAssert containsPointsSatisfying(
       Iterable<? extends Consumer<DoublePointAssert>> assertions) {

sdk/testing/src/main/java/io/opentelemetry/sdk/testing/assertj/ExponentialHistogramAssert.java

@@ -79,6 +79,8 @@ public ExponentialHistogramAssert hasPointsSatisfying(
    * Asserts that for each given assertion, at least one point in the exponential histogram
    * satisfies it. Extra points that match none of the assertions are allowed, and a single point
    * may satisfy multiple assertions.
+   *
+   * @since 1.62.0
    */
   @SafeVarargs
   @SuppressWarnings("varargs")
@@ -91,6 +93,8 @@ public final ExponentialHistogramAssert containsPointsSatisfying(
    * Asserts that for each given assertion, at least one point in the exponential histogram
    * satisfies it. Extra points that match none of the assertions are allowed, and a single point
    * may satisfy multiple assertions.
+   *
+   * @since 1.62.0
    */
   public ExponentialHistogramAssert containsPointsSatisfying(
       Iterable<? extends Consumer<ExponentialHistogramPointAssert>> assertions) {

sdk/testing/src/main/java/io/opentelemetry/sdk/testing/assertj/HistogramAssert.java

@@ -77,6 +77,8 @@ public HistogramAssert hasPointsSatisfying(
    * Asserts that for each given assertion, at least one point in the histogram satisfies it. Extra
    * points that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   @SafeVarargs
   @SuppressWarnings("varargs")
@@ -89,6 +91,8 @@ public final HistogramAssert containsPointsSatisfying(
    * Asserts that for each given assertion, at least one point in the histogram satisfies it. Extra
    * points that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   public HistogramAssert containsPointsSatisfying(
       Iterable<? extends Consumer<HistogramPointAssert>> assertions) {

sdk/testing/src/main/java/io/opentelemetry/sdk/testing/assertj/LongGaugeAssert.java

@@ -49,6 +49,8 @@ public LongGaugeAssert hasPointsSatisfying(
    * Asserts that for each given assertion, at least one point in the gauge satisfies it. Extra
    * points that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   @SafeVarargs
   @SuppressWarnings("varargs")
@@ -60,6 +62,8 @@ public final LongGaugeAssert containsPointsSatisfying(Consumer<LongPointAssert>.
    * Asserts that for each given assertion, at least one point in the gauge satisfies it. Extra
    * points that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   public LongGaugeAssert containsPointsSatisfying(
       Iterable<? extends Consumer<LongPointAssert>> assertions) {

sdk/testing/src/main/java/io/opentelemetry/sdk/testing/assertj/LongPointAssert.java

@@ -32,7 +32,11 @@ public LongPointAssert hasValue(long expected) {
     return this;
   }
 
-  /** Asserts the point's value satisfies the given assertion. */
+  /**
+   * Asserts the point's value satisfies the given assertion.
+   *
+   * @since 1.62.0
+   */
   public LongPointAssert hasValueSatisfying(Consumer<AbstractLongAssert<?>> valueAssertion) {
     isNotNull();
     valueAssertion.accept(assertThat(actual.getValue()).as("value"));

sdk/testing/src/main/java/io/opentelemetry/sdk/testing/assertj/LongSumAssert.java

@@ -92,6 +92,8 @@ public LongSumAssert hasPointsSatisfying(
    * Asserts that for each given assertion, at least one point in the sum satisfies it. Extra points
    * that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   @SafeVarargs
   @SuppressWarnings("varargs")
@@ -103,6 +105,8 @@ public final LongSumAssert containsPointsSatisfying(Consumer<LongPointAssert>...
    * Asserts that for each given assertion, at least one point in the sum satisfies it. Extra points
    * that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   public LongSumAssert containsPointsSatisfying(
       Iterable<? extends Consumer<LongPointAssert>> assertions) {

sdk/testing/src/main/java/io/opentelemetry/sdk/testing/assertj/SummaryAssert.java

@@ -57,6 +57,8 @@ public SummaryAssert hasPointsSatisfying(
    * Asserts that for each given assertion, at least one point in the summary satisfies it. Extra
    * points that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   @SafeVarargs
   @SuppressWarnings("varargs")
@@ -68,6 +70,8 @@ public final SummaryAssert containsPointsSatisfying(Consumer<SummaryPointAssert>
    * Asserts that for each given assertion, at least one point in the summary satisfies it. Extra
    * points that match none of the assertions are allowed, and a single point may satisfy multiple
    * assertions.
+   *
+   * @since 1.62.0
    */
   public SummaryAssert containsPointsSatisfying(
       Iterable<? extends Consumer<SummaryPointAssert>> assertions) {