src/java.base/share/classes/java/util/concurrent/Phaser.java

8234131: Miscellaneous changes imported from jsr166 CVS 2020-12
Reviewed-by: martin

*** 243,253 ****
   * The best value of {@code TASKS_PER_PHASER} depends mainly on
   * expected synchronization rates. A value as low as four may
   * be appropriate for extremely small per-phase task bodies (thus
   * high rates), or up to hundreds for extremely large ones.
   *
!  * <p><b>Implementation notes</b>: This implementation restricts the
   * maximum number of parties to 65535. Attempts to register additional
   * parties result in {@code IllegalStateException}. However, you can and
   * should create tiered phasers to accommodate arbitrarily large sets
   * of participants.
   *
--- 243,253 ----
   * The best value of {@code TASKS_PER_PHASER} depends mainly on
   * expected synchronization rates. A value as low as four may
   * be appropriate for extremely small per-phase task bodies (thus
   * high rates), or up to hundreds for extremely large ones.
   *
!  * <p><b>Implementation notes:</b> This implementation restricts the
   * maximum number of parties to 65535. Attempts to register additional
   * parties result in {@code IllegalStateException}. However, you can and
   * should create tiered phasers to accommodate arbitrarily large sets
   * of participants.
   *
*** 917,927 ****
       * {@code false}:
       *
       * <pre> {@code
       * Phaser phaser = new Phaser() {
       *   protected boolean onAdvance(int phase, int parties) { return false; }
!      * }}</pre>
       *
       * @param phase the current phase number on entry to this method,
       * before this phaser is advanced
       * @param registeredParties the current number of registered parties
       * @return {@code true} if this phaser should terminate
--- 917,927 ----
       * {@code false}:
       *
       * <pre> {@code
       * Phaser phaser = new Phaser() {
       *   protected boolean onAdvance(int phase, int parties) { return false; }
!      * };}</pre>
       *
       * @param phase the current phase number on entry to this method,
       * before this phaser is advanced
       * @param registeredParties the current number of registered parties
       * @return {@code true} if this phaser should terminate