--- old/src/java.base/share/classes/java/util/jar/JarFile.java 2015-05-21 22:48:08.000000000 -0700 +++ new/src/java.base/share/classes/java/util/jar/JarFile.java 2015-05-21 22:48:08.000000000 -0700 @@ -268,13 +268,25 @@ } /** - * Returns an enumeration of the zip file entries. + * Returns an enumeration of the jar file entries. + * + * @return an enumeration of the jar file entries + * @throws IllegalStateException + * may be thrown if the jar file has been closed */ public Enumeration entries() { return new JarEntryIterator(); } - @Override + /** + * Returns an ordered {@code Stream} over the jar file entries. + * Entries appear in the {@code Stream} in the order they appear in + * the central directory of the jar file. + * + * @return an ordered {@code Stream} of entries in this jar file + * @throws IllegalStateException if the jar file has been closed + * @since 1.8 + */ public Stream stream() { return StreamSupport.stream(Spliterators.spliterator( new JarEntryIterator(), size(), --- old/src/java.base/share/classes/java/util/zip/ZipFile.java 2015-05-21 22:48:09.000000000 -0700 +++ new/src/java.base/share/classes/java/util/zip/ZipFile.java 2015-05-21 22:48:09.000000000 -0700 @@ -538,7 +538,7 @@ } /** - * Return an ordered {@code Stream} over the ZIP file entries. + * Returns an ordered {@code Stream} over the ZIP file entries. * Entries appear in the {@code Stream} in the order they appear in * the central directory of the ZIP file. *