--- old/src/share/classes/java/util/zip/Deflater.java	2013-09-15 11:21:32.000000000 -0700
+++ new/src/share/classes/java/util/zip/Deflater.java	2013-09-15 11:21:32.000000000 -0700
@@ -261,6 +261,12 @@
 
     /**
      * Sets the compression strategy to the specified value.
+     *
+     * <p> If the compression strategy is changed, the next invocation
+     * of {@code deflate} methods will compress the input available
+     * so far with the old strategy (and may be flushed); the new strategy
+     * will take effect only after that invocation.
+     *
      * @param strategy the new compression strategy
      * @exception IllegalArgumentException if the compression strategy is
      *                                     invalid
@@ -283,7 +289,13 @@
     }
 
     /**
-     * Sets the current compression level to the specified value.
+     * Sets the compression level to the specified value.
+     *
+     * <p> If the compression level is changed, the next invocation
+     * of {@code deflate} methods will compress the input available
+     * so far with the old level (and may be flushed); the new level
+     * will take effect only after that invocation.
+     *
      * @param level the new compression level (0-9)
      * @exception IllegalArgumentException if the compression level is invalid
      */