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.
Hmmmm.... 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...@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 > >
