--- a/jdk/src/java.base/share/classes/java/util/zip/Deflater.java Thu Jul 07 18:35:29 2016 +0000
+++ b/jdk/src/java.base/share/classes/java/util/zip/Deflater.java Thu Jul 07 14:16:58 2016 -0700
@@ -417,7 +417,10 @@
* <p>In the case of {@link #FULL_FLUSH} or {@link #SYNC_FLUSH}, if
* the return value is {@code len}, the space available in output
* buffer {@code b}, this method should be invoked again with the same
- * {@code flush} parameter and more output space.
+ * {@code flush} parameter and more output space. Make sure that
+ * {@code len} is greater than 6 to avoid flush marker (5 bytes) being
+ * repeatedly output to the output buffer every time this method is
+ * invoked.
*
* @param b the buffer for the compressed data
* @param off the start offset of the data