On Tue, 15 Jun 2021 18:05:18 GMT, Joe Darcy <da...@openjdk.org> wrote:
> The javadoc of AutoCloseable.close is from JDK 7 and thus predates tags like > @apiNote. However, some of the discussion contained in AutoCloseable.close is > more appropriate as an apiNote that normal text. I'm confused: I thought that both https://openjdk.java.net/jeps/8068562 and the actual usages of `@apiNote` in `java.base` accumulated since then are advisory to the API users rather than to API implementors. ------------- PR: https://git.openjdk.java.net/jdk17/pull/63
