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

2021-06-15 Thread Pavel Rappo
On Tue, 15 Jun 2021 18:05:18 GMT, Joe Darcy 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

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

2021-06-15 Thread Naoto Sato
On Tue, 15 Jun 2021 18:05:18 GMT, Joe Darcy 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. Marked as reviewed by naoto

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

2021-06-15 Thread Brian Burkhalter
On Tue, 15 Jun 2021 18:05:18 GMT, Joe Darcy 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. Marked as reviewed by bpb

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

2021-06-15 Thread 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