hg: lambda/lambda/jdk: 8009736: Comparator to allow narrowing type on combinator APIs

[henry.jen at oracle.com]

Changeset: fb7b7275d220
Author:    henryjen
Date:      2013-03-08 21:54 -0800
URL:       http://hg.openjdk.java.net/lambda/lambda/jdk/rev/fb7b7275d220

8009736: Comparator to allow narrowing type on combinator APIs
Reviewed-by:
Summary: Allow to narrow return type, add javadoc return tag
Allow key extract not limited to Comparable, but use a Comparator of key type.

! src/share/classes/java/util/Comparator.java
! src/share/classes/java/util/Comparators.java