Describe alternative for ByteStreams#copy.

kofemann · Google Java Core Libraries · commit c9efc479950e · 2023-06-26T09:43:12.000-07:00
Fixes #5706 RELNOTES=n/a PiperOrigin-RevId: 543462774
diff --git a/android/guava/src/com/google/common/io/ByteStreams.java b/android/guava/src/com/google/common/io/ByteStreams.java
@@ -100,6 +100,9 @@ private ByteStreams() {}
    * Copies all bytes from the input stream to the output stream. Does not close or flush either
    * stream.
    *
+   * <p><b>Java 9 users and later:</b> this method should be treated as deprecated; use the
+   * equivalent {@link InputStream#transferTo} method instead.
+   *
    * @param from the input stream to read from
    * @param to the output stream to write to
    * @return the number of bytes copied
diff --git a/guava/src/com/google/common/io/ByteStreams.java b/guava/src/com/google/common/io/ByteStreams.java
@@ -100,6 +100,9 @@ private ByteStreams() {}
    * Copies all bytes from the input stream to the output stream. Does not close or flush either
    * stream.
    *
+   * <p><b>Java 9 users and later:</b> this method should be treated as deprecated; use the
+   * equivalent {@link InputStream#transferTo} method instead.
+   *
    * @param from the input stream to read from
    * @param to the output stream to write to
    * @return the number of bytes copied
