--- jsr166/src/jsr166y/Phaser.java	2009/08/19 18:00:55	1.33
+++ jsr166/src/jsr166y/Phaser.java	2009/08/19 23:05:32	1.34
@@ -540,7 +540,9 @@ public class Phaser {
      * is terminated.
      *
      * @param phase the phase on entry to this method
-     * @return the phase on exit from this method
+     * @return the current barrier phase number upon exit of
+     * this method, or a negative value if terminated or
+     * argument is negative
      */
     public int awaitAdvance(int phase) {
         if (phase < 0)
@@ -563,7 +565,9 @@ public class Phaser {
      * is terminated.
      *
      * @param phase the phase on entry to this method
-     * @return the phase on exit from this method
+     * @return the current barrier phase number upon exit of
+     * this method, or a negative value if terminated or
+     * argument is negative
      * @throws InterruptedException if thread interrupted while waiting
      */
     public int awaitAdvanceInterruptibly(int phase)
@@ -591,7 +595,9 @@ public class Phaser {
      *        {@code unit}
      * @param unit a {@code TimeUnit} determining how to interpret the
      *        {@code timeout} parameter
-     * @return the phase on exit from this method
+     * @return the current barrier phase number upon exit of
+     * this method, or a negative value if terminated or
+     * argument is negative
      * @throws InterruptedException if thread interrupted while waiting
      * @throws TimeoutException if timed out while waiting
      */