RFR of JDK-8176563: @since value errors in apis of java.base/java.logging module

Martin Buchholz martinrb at google.com
Tue Mar 14 07:06:02 UTC 2017

I wouldn't put a blank line between javadoc tags.

I'm not sure whether @since is justified for new specialized
implementations like ArrayDeque.removeAll.  It is somewhat misleading to
add the @since because that method has worked just fine in past releases
with no substantive spec change.

The most important use case for @since is for developers who need to decide
whether they can afford to use an API when targeting older platforms.  For
this reason ... I think using @since for pre-existing inherited methods is
a mistake (implementation detail).

I don't remember which way I went 10 years ago - you might investigate.

On Mon, Mar 13, 2017 at 11:40 PM, Hamlin Li <huaming.li at oracle.com> wrote:

> Would you please review the below patch?
> bug: https://bugs.openjdk.java.net/browse/JDK-8176563
> webrev: http://cr.openjdk.java.net/~mli/8176563/webrev.00/
> Thank you
> -Hamlin

More information about the core-libs-dev mailing list