On 04/02/2013 06:34 AM, Paul Sandoz wrote:
On Apr 2, 2013, at 2:37 PM, Chris Hegarty <[email protected]> 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
