Javadoc complexity

Peter Levart peter.levart at gmail.com
Tue Aug 27 07:30:34 PDT 2013


On 08/27/2013 12:57 PM, Stephen Colebourne wrote:
> The Javadoc of JDK8 is starting to show some unecessary complexity
> folowing the library changes for lambda. This needs combatting to
> avoid scaring developers. This is therefore a request for a minor
> tweak to Javadoc.
>
> See
> http://download.java.net/jdk8/docs/api/java/util/package-summary.html
>
> Note in particular that there is some immediate "in your face" type
> parameter complexity:
>
> Spliterator.OfPrimitive<T,T_CONS,T_SPLITR extends
> Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>
Hi Stephen and list,

I don't know if that still holds now, but a couple of months ago I 
noticed that T_SPLITR generic parameter seems to be redundant. All 
current JDK code can be modified to cope without it:

http://cr.openjdk.java.net/~plevart/lambda/Spliterator.OfPrimitive/webrev.01/

I can check if that still holds now. Even if it does, a question remains 
if the parameter was introduced for some other reason...

Regards, Peter



More information about the lambda-dev mailing list