Alan,
I've updated the CSR with the @apiNote tag:
https://bugs.openjdk.java.net/browse/JDK-8223740
Thanks,
Serguei
On 5/14/19 03:46, Alan Bateman wrote:
On 14/05/2019 03:36, [email protected] wrote:
:
Java SE 9 added two abstract module-aware methods to the interface
java.lang.instrument.Instrumentation. The assumption at the time was
that the Instrumentation implementation is tightly coupled to the VM
implementation and it seemed unlikely there would be other
implementations
(this follows similar additions of abstract methods in Java SE 6).
Right, Instrumentation wants to be a sealed type but doesn't have a
way to express this yet. Adding a statement to the javadoc seems okay
for now, I'm just wondering if it should use one of the javadoc tags
created for documenting API notes [1]. Joe Darcy (cc'ed) may have
input into this. It can probably be @apiNote as the statement is it
documenting intention.
-Alan
[1] https://openjdk.java.net/jeps/8068562
