From f3969651967ae5edf4e4c49a9d4544a942c9d726 Mon Sep 17 00:00:00 2001
From: John Watson <jkwatson@gmail.com>
Date: Thu, 6 May 2021 16:26:55 -0700
Subject: [PATCH] Add @since tags for new public methods. (#3209)

* Add @since tags for new public methods.

* remove errant since tags
---
 api/all/src/main/java/io/opentelemetry/api/trace/Span.java      | 1 +
 .../src/main/java/io/opentelemetry/api/trace/SpanBuilder.java   | 1 +
 .../exporter/zipkin/ZipkinSpanExporterBuilder.java              | 2 ++
 .../opentelemetry/sdk/metrics/aggregator/AggregatorFactory.java | 1 +
 4 files changed, 5 insertions(+)

diff --git a/api/all/src/main/java/io/opentelemetry/api/trace/Span.java b/api/all/src/main/java/io/opentelemetry/api/trace/Span.java
index 033f561f8e..ecc9f2a446 100644
--- a/api/all/src/main/java/io/opentelemetry/api/trace/Span.java
+++ b/api/all/src/main/java/io/opentelemetry/api/trace/Span.java
@@ -173,6 +173,7 @@ public interface Span extends ImplicitContextKeyed {
    *
    * @param attributes the attributes
    * @return this.
+   * @since 1.2.0
    */
   @SuppressWarnings("unchecked")
   default Span setAllAttributes(Attributes attributes) {
diff --git a/api/all/src/main/java/io/opentelemetry/api/trace/SpanBuilder.java b/api/all/src/main/java/io/opentelemetry/api/trace/SpanBuilder.java
index e0af5f2d85..ba91857830 100644
--- a/api/all/src/main/java/io/opentelemetry/api/trace/SpanBuilder.java
+++ b/api/all/src/main/java/io/opentelemetry/api/trace/SpanBuilder.java
@@ -234,6 +234,7 @@ public interface SpanBuilder {
    *
    * @param attributes the attributes
    * @return this.
+   * @since 1.2.0
    */
   @SuppressWarnings("unchecked")
   default SpanBuilder setAllAttributes(Attributes attributes) {
diff --git a/exporters/zipkin/src/main/java/io/opentelemetry/exporter/zipkin/ZipkinSpanExporterBuilder.java b/exporters/zipkin/src/main/java/io/opentelemetry/exporter/zipkin/ZipkinSpanExporterBuilder.java
index 051b6baef4..211c2e599f 100644
--- a/exporters/zipkin/src/main/java/io/opentelemetry/exporter/zipkin/ZipkinSpanExporterBuilder.java
+++ b/exporters/zipkin/src/main/java/io/opentelemetry/exporter/zipkin/ZipkinSpanExporterBuilder.java
@@ -70,6 +70,7 @@ public final class ZipkinSpanExporterBuilder {
    * Sets the maximum time to wait for the export of a batch of spans. If unset, defaults to 10s.
    *
    * @return this.
+   * @since 1.2.0
    */
   public ZipkinSpanExporterBuilder setReadTimeout(long timeout, TimeUnit unit) {
     requireNonNull(unit, "unit");
@@ -82,6 +83,7 @@ public final class ZipkinSpanExporterBuilder {
    * Sets the maximum time to wait for the export of a batch of spans. If unset, defaults to 10s.
    *
    * @return this.
+   * @since 1.2.0
    */
   public ZipkinSpanExporterBuilder setReadTimeout(Duration timeout) {
     requireNonNull(timeout, "timeout");
diff --git a/sdk/metrics/src/main/java/io/opentelemetry/sdk/metrics/aggregator/AggregatorFactory.java b/sdk/metrics/src/main/java/io/opentelemetry/sdk/metrics/aggregator/AggregatorFactory.java
index 6714cd4378..d66711e496 100644
--- a/sdk/metrics/src/main/java/io/opentelemetry/sdk/metrics/aggregator/AggregatorFactory.java
+++ b/sdk/metrics/src/main/java/io/opentelemetry/sdk/metrics/aggregator/AggregatorFactory.java
@@ -43,6 +43,7 @@ public interface AggregatorFactory {
    *
    * @param temporality configures what temporality to be produced for the Sum metrics.
    * @return an {@code AggregationFactory} that calculates sum of recorded measurements.
+   * @since 1.2.0
    */
   static AggregatorFactory sum(AggregationTemporality temporality) {
     return new SumAggregatorFactory(temporality);