RFR JDK-8010096 : Initial java.util.Spliterator putback (original) (raw)

Joe Darcy joe.darcy at oracle.com
Tue Apr 2 17:33:46 UTC 2013

On 04/02/2013 06:34 AM, Paul Sandoz wrote:

On Apr 2, 2013, at 2:37 PM, Chris Hegarty <chris.hegarty at oracle.com> wrote:

Nice work Paul, some small comments.

- new javadocs tags, @implSpec, @apiNote, etc. I really like the use of implSpec to define the behavior of this implementations default methods. There is probably a separate thread, but any idea when these will be generated in the javadoc, not just the lambda docs? I do not know, Mike is the one who is very likely to know more. - Iterator.remove @since 1.8? I see there is a conflict here between when the method was originally added and its default Right, that is most likely a mistake. How can we express that the default method is there since 1.8?

That cannot the expressed in @since tags, but it is duly recorded by the JCK signature tests.

There are other kinds of evolutions the @since tags cannot capture, such as a class being retrofitted to implement an interface in a release after the interface was added.

-Joe

More information about the core-libs-dev mailing list