diff --git a/android/guava/src/com/google/common/io/ByteArrayDataInput.java b/android/guava/src/com/google/common/io/ByteArrayDataInput.java index 375f07cd67f4..2ed24b6dc8b3 100644 --- a/android/guava/src/com/google/common/io/ByteArrayDataInput.java +++ b/android/guava/src/com/google/common/io/ByteArrayDataInput.java @@ -25,6 +25,9 @@ * An extension of {@code DataInput} for reading from in-memory byte arrays; its methods offer * identical functionality but do not throw {@link IOException}. * + *
To create an instance, use {@link ByteStreams#newDataInput(byte[])} or another overload of + * that method. + * *
Warning: The caller is responsible for not attempting to read past the end of the * array. If any method encounters the end of the array prematurely, it throws {@link * IllegalStateException} to signify programmer error. This behavior is a technical violation diff --git a/android/guava/src/com/google/common/io/ByteArrayDataOutput.java b/android/guava/src/com/google/common/io/ByteArrayDataOutput.java index 32c9e2fca9bc..5fd51ceb4ebe 100644 --- a/android/guava/src/com/google/common/io/ByteArrayDataOutput.java +++ b/android/guava/src/com/google/common/io/ByteArrayDataOutput.java @@ -23,6 +23,9 @@ * An extension of {@code DataOutput} for writing to in-memory byte arrays; its methods offer * identical functionality but do not throw {@link IOException}. * + *
To create an instance, use {@link ByteStreams#newDataOutput()} or the other overload of that + * method. + * * @author Jayaprabhakar Kadarkarai * @since 1.0 */ diff --git a/guava/src/com/google/common/io/ByteArrayDataInput.java b/guava/src/com/google/common/io/ByteArrayDataInput.java index 375f07cd67f4..2ed24b6dc8b3 100644 --- a/guava/src/com/google/common/io/ByteArrayDataInput.java +++ b/guava/src/com/google/common/io/ByteArrayDataInput.java @@ -25,6 +25,9 @@ * An extension of {@code DataInput} for reading from in-memory byte arrays; its methods offer * identical functionality but do not throw {@link IOException}. * + *
To create an instance, use {@link ByteStreams#newDataInput(byte[])} or another overload of + * that method. + * *
Warning: The caller is responsible for not attempting to read past the end of the * array. If any method encounters the end of the array prematurely, it throws {@link * IllegalStateException} to signify programmer error. This behavior is a technical violation diff --git a/guava/src/com/google/common/io/ByteArrayDataOutput.java b/guava/src/com/google/common/io/ByteArrayDataOutput.java index 32c9e2fca9bc..5fd51ceb4ebe 100644 --- a/guava/src/com/google/common/io/ByteArrayDataOutput.java +++ b/guava/src/com/google/common/io/ByteArrayDataOutput.java @@ -23,6 +23,9 @@ * An extension of {@code DataOutput} for writing to in-memory byte arrays; its methods offer * identical functionality but do not throw {@link IOException}. * + *
To create an instance, use {@link ByteStreams#newDataOutput()} or the other overload of that + * method. + * * @author Jayaprabhakar Kadarkarai * @since 1.0 */