Index: oak-core/src/main/java/org/apache/jackrabbit/oak/api/Blob.java IDEA additional info: Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP <+>UTF-8 =================================================================== --- oak-core/src/main/java/org/apache/jackrabbit/oak/api/Blob.java (revision 97d5b535bf617bfa048cded6ff554dbf3d71ba2a) +++ oak-core/src/main/java/org/apache/jackrabbit/oak/api/Blob.java (revision ) @@ -38,9 +38,13 @@ public interface Blob { /** - * Returns a new stream for this value object. Multiple calls to this - * methods return equal instances: {@code getNewStream().equals(getNewStream())}. - * @return a new stream for this value based on an internal conversion. + * Returns a new stream for this blob. The streams returned from + * multiple calls to this method are byte wise equals. That is, + * subsequent calls to {@link java.io.InputStream#read() read} + * return the same sequence of bytes as long as neither call throws + * an exception. + * + * @return a new stream for this blob */ @Nonnull InputStream getNewStream();