[jdk17] RFR: 8268736: Use apiNote in AutoCloseable.close javadoc

[Joe Darcy]

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.

-------------

Commit messages:
 - 8268736: Use apiNote in AutoCloseable.close javadoc

Changes: https://git.openjdk.java.net/jdk17/pull/63/files
 Webrev: https://webrevs.openjdk.java.net/?repo=jdk17&pr=63&range=00
  Issue: https://bugs.openjdk.java.net/browse/JDK-8268736
  Stats: 3 lines in 1 file changed: 1 ins; 0 del; 2 mod
  Patch: https://git.openjdk.java.net/jdk17/pull/63.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk17 pull/63/head:pull/63

PR: https://git.openjdk.java.net/jdk17/pull/63