RFR: jsr166 jdk9 integration wave 12

[Doug Lea]

> On Thu, Nov 17, 2016 at 12:03 PM, Paul Sandoz <Paul.Sandoz at oracle.com
> <mailto:Paul.Sandoz at oracle.com>> wrote:
>
>
>     Semaphore
>     —
>
>      633     /**
>      634      * Acquires and returns all permits that are immediately
>     available.
>      635      * Upon return, zero permits are available.
>      636      *
>      637      * @return the number of permits acquired
>      638      */
>      639     public int drainPermits() {
>      640         return sync.drainPermits();
>      641     }
>
>     Arguably, if positive acquires all permits, otherwise releases all
>     permits. Perhaps:

Thank! That's a better way to phrase intent. Reworded to:

     /**
      * Acquires and returns all permits that are immediately
      * available, or if negative permits are available, releases them.
      * Upon return, zero permits are available.
      *
      * @return the number of permits acquired or, if negative, the
      * number released
      */

>
>     Probably requires a CCC which i can manage.
>

Really? If so, please do.

-Doug