Java 8 RFR 8020539: Clean up doclint problems in java.util package, part 2

[Chris Hegarty]

> .....
>> http://cr.openjdk.java.net/~bpb/8020539/

Brian,

Looks fine ( I did not go through the Scanner changes ).

Some minor comments:

1) List
    Trivially I wonder why you decided to go with '< '>', rather
    than <pre>{@code ... }</pre>, which I think is more readable.

2) Map
    Trivially, I would keep the @param's order the same as the actual
    method parameters order.

3) Optional
    Strangely, there doesn't appear to be a '@param' for the class level
    type T. doclint is not warning about this either.

-Chris.