Add `@since` tags for the first batch of Java-8-related APIs.
(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
index 95270b6..bf53434 100644
--- 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
index 70213a5..85cbbd1 100644
--- 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
index 7265fca..207a03a 100644
--- 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
index cafdd5a..63b8285 100644
--- 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
index ab770a3..0e5c6a8 100644
--- 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
index 8fa39ad..c999329 100644
--- 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
index f98c600..51699bf 100644
--- 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
index dae053d..f7aa087 100644
--- 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 @@
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 @@
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
index 88c2437..0ecf042 100644
--- 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
index 7ca25d6..f49b846 100644
--- 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 @@
@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);
}
