Add @since tags for the first batch of Java-8-related APIs.

cpovirk · Google Java Core Libraries · commit 93b4d93721ae · 2024-01-19T13:05:59.000-08:00
(Those are the ones from cl/597243015, cl/598637400, and cl/598664192.)

RELNOTES=n/a
PiperOrigin-RevId: 599916105
diff --git a/core/src/main/java/com/google/common/truth/IntStreamSubject.java b/core/src/main/java/com/google/common/truth/IntStreamSubject.java
@@ -39,6 +39,7 @@
  * stream before asserting on it.
  *
  * @author Kurt Alfred Kluever
+ * @since 1.3.0 (previously part of {@code truth-java8-extension})
  */
 @SuppressWarnings({
   "deprecation", // TODO(b/134064106): design an alternative to no-arg check()
diff --git a/core/src/main/java/com/google/common/truth/LongStreamSubject.java b/core/src/main/java/com/google/common/truth/LongStreamSubject.java
@@ -39,6 +39,7 @@
  * stream before asserting on it.
  *
  * @author Kurt Alfred Kluever
+ * @since 1.3.0 (previously part of {@code truth-java8-extension})
  */
 @SuppressWarnings({
   "deprecation", // TODO(b/134064106): design an alternative to no-arg check()
diff --git a/core/src/main/java/com/google/common/truth/OptionalDoubleSubject.java b/core/src/main/java/com/google/common/truth/OptionalDoubleSubject.java
@@ -25,6 +25,7 @@
  * Propositions for Java 8 {@link OptionalDouble} subjects.
  *
  * @author Ben Douglass
+ * @since 1.3.0 (previously part of {@code truth-java8-extension})
  */
 @SuppressWarnings("Java7ApiChecker") // used only from APIs with Java 8 in their signatures
 @IgnoreJRERequirement
diff --git a/core/src/main/java/com/google/common/truth/OptionalIntSubject.java b/core/src/main/java/com/google/common/truth/OptionalIntSubject.java
@@ -25,6 +25,7 @@
  * Propositions for Java 8 {@link OptionalInt} subjects.
  *
  * @author Ben Douglass
+ * @since 1.3.0 (previously part of {@code truth-java8-extension})
  */
 @SuppressWarnings("Java7ApiChecker") // used only from APIs with Java 8 in their signatures
 @IgnoreJRERequirement
diff --git a/core/src/main/java/com/google/common/truth/OptionalLongSubject.java b/core/src/main/java/com/google/common/truth/OptionalLongSubject.java
@@ -25,6 +25,7 @@
  * Propositions for Java 8 {@link OptionalLong} subjects.
  *
  * @author Ben Douglass
+ * @since 1.3.0 (previously part of {@code truth-java8-extension})
  */
 @SuppressWarnings("Java7ApiChecker") // used only from APIs with Java 8 in their signatures
 @IgnoreJRERequirement
diff --git a/core/src/main/java/com/google/common/truth/OptionalSubject.java b/core/src/main/java/com/google/common/truth/OptionalSubject.java
@@ -25,6 +25,7 @@
  * Propositions for Java 8 {@link Optional} subjects.
  *
  * @author Christian Gruber
+ * @since 1.3.0 (previously part of {@code truth-java8-extension})
  */
 @SuppressWarnings("Java7ApiChecker") // used only from APIs with Java 8 in their signatures
 @IgnoreJRERequirement
diff --git a/core/src/main/java/com/google/common/truth/PathSubject.java b/core/src/main/java/com/google/common/truth/PathSubject.java
@@ -19,7 +19,11 @@
 import com.google.j2objc.annotations.J2ObjCIncompatible;
 import java.nio.file.Path;
 
-/** Assertions for {@link Path} instances. */
+/**
+ * Assertions for {@link Path} instances.
+ *
+ * @since 1.3.0 (previously part of {@code truth-java8-extension})
+ */
 @GwtIncompatible
 @J2ObjCIncompatible
 @J2ktIncompatible
diff --git a/core/src/main/java/com/google/common/truth/StandardSubjectBuilder.java b/core/src/main/java/com/google/common/truth/StandardSubjectBuilder.java
@@ -170,6 +170,10 @@ public final TableSubject that(@Nullable Table<?, ?, ?> actual) {
     return new TableSubject(metadata(), actual);
   }
 
+  /**
+   * @since 1.3.0 (with access to {@link OptionalSubject} previously part of {@code
+   *     truth-java8-extension})
+   */
   @SuppressWarnings({
     "Java7ApiChecker", // no more dangerous that wherever the user got the Optional
     "NullableOptional", // Truth always accepts nulls, no matter the type
@@ -178,6 +182,10 @@ public final OptionalSubject that(@Nullable Optional<?> actual) {
     return new OptionalSubject(metadata(), actual, "optional");
   }
 
+  /**
+   * @since 1.3.0 (with access to {@link StreamSubject} previously part of {@code
+   *     truth-java8-extension})
+   */
   @SuppressWarnings("Java7ApiChecker") // no more dangerous that wherever the user got the Stream
   public final StreamSubject that(@Nullable Stream<?> actual) {
     return new StreamSubject(metadata(), actual);
diff --git a/core/src/main/java/com/google/common/truth/StreamSubject.java b/core/src/main/java/com/google/common/truth/StreamSubject.java
@@ -43,6 +43,7 @@
  * stream before asserting on it.
  *
  * @author Kurt Alfred Kluever
+ * @since 1.3.0 (previously part of {@code truth-java8-extension})
  */
 @SuppressWarnings("Java7ApiChecker") // used only from APIs with Java 8 in their signatures
 @IgnoreJRERequirement
diff --git a/core/src/main/java/com/google/common/truth/Truth.java b/core/src/main/java/com/google/common/truth/Truth.java
@@ -253,12 +253,18 @@ public static TableSubject assertThat(@Nullable Table<?, ?, ?> actual) {
 
   @SuppressWarnings("Java7ApiChecker") // no more dangerous that wherever the user got the Optional
   @GwtIncompatible // creates ambiguities (Eclipse bug 577808 or similar?)
+  /**
+   * @since 1.3.0 (present in {@link Truth8} since before 1.0)
+   */
   public static <T> OptionalSubject assertThat(@Nullable Optional<T> actual) {
     return assert_().that(actual);
   }
 
   @SuppressWarnings("Java7ApiChecker") // no more dangerous that wherever the user got the Stream
   @GwtIncompatible // creates ambiguities (Eclipse bug 577808 or similar?)
+  /**
+   * @since 1.3.0 (present in {@link Truth8} since before 1.0)
+   */
   public static <T extends @Nullable Object> StreamSubject assertThat(@Nullable Stream<T> actual) {
     return assert_().that(actual);
   }

Original file line number	Diff line number	Diff line change
`@@ -39,6 +39,7 @@`
`39`	`39`	`* stream before asserting on it.`
`40`	`40`	`*`
`41`	`41`	`* @author Kurt Alfred Kluever`
	`42`	`+ * @since 1.3.0 (previously part of {@code truth-java8-extension})`
`42`	`43`	`*/`
`43`	`44`	`@SuppressWarnings({`
`44`	`45`	`"deprecation", // TODO(b/134064106): design an alternative to no-arg check()`
Original file line number	Diff line number	Diff line change
`@@ -25,6 +25,7 @@`
`25`	`25`	`* Propositions for Java 8 {@link OptionalDouble} subjects.`
`26`	`26`	`*`
`27`	`27`	`* @author Ben Douglass`
	`28`	`+ * @since 1.3.0 (previously part of {@code truth-java8-extension})`
`28`	`29`	`*/`
`29`	`30`	`@SuppressWarnings("Java7ApiChecker") // used only from APIs with Java 8 in their signatures`
`30`	`31`	`@IgnoreJRERequirement`
Original file line number	Diff line number	Diff line change
`@@ -43,6 +43,7 @@`
`43`	`43`	`* stream before asserting on it.`
`44`	`44`	`*`
`45`	`45`	`* @author Kurt Alfred Kluever`
	`46`	`+ * @since 1.3.0 (previously part of {@code truth-java8-extension})`
`46`	`47`	`*/`
`47`	`48`	`@SuppressWarnings("Java7ApiChecker") // used only from APIs with Java 8 in their signatures`
`48`	`49`	`@IgnoreJRERequirement`