RFR(L): 8151179: address issues raised by JCK team on JEP 274 API

[Claes Redestad]

On 2016-08-12 02:27, Michael Haupt wrote:
> Dear all,
>
> please review this change.
> Bug: https://bugs.openjdk.java.net/browse/JDK-8151179
> Webrev: http://cr.openjdk.java.net/~mhaupt/8151179/webrev.00/

Looks good to me.

/Claes

>
> The change addresses concerns about the JEP 274 API that were raised by the JCK team. One consequence is that the convenience wrappers for the generic loop combinator are now somewhat restrictive about the handles passed to them as arguments. They have to be created with the appropriate matching signatures. This minor inconvenience is easily overcome by utilising available API such as MethodHandles.constant(), .empty(), or .dropToMatch(). In case the full handle signature inference power is desired, the generic loop combinator, MethodHandles.loop(), still provides this.
>
> Most of the changes affect the API documentation, but the behavioural changes in some of the methods also reflect on the pertaining tests.
>
> Thanks,
>
> Michael
>