--- 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