RFR: JDK-8300357: Use generalized see and link tags in java.management

[Joe Darcy]

On Wed, 18 Jan 2023 07:32:15 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> Use new javadoc capabilities courtesy JDK-8200337 to have more-readable-in-javadoc-source links to anchors in several management types. Analogous change is out for review in core libs, JDK-8300133.
>
> src/java.management/share/classes/java/lang/management/ThreadMXBean.java line 38:
> 
>> 36:  * typically mapped to kernel threads scheduled by the operating system.
>> 37:  * {@code ThreadMXBean} does not support monitoring or management of
>> 38:  * {@linkplain Thread##virtual-threads virtual threads}.
> 
> The use of ## looks fine but would you mind re-flowing the javadoc in this paragraph as the line break after platform-threads looks accidental. This paragraph is mostly new text since Java 19.

Sure; I opted to not re-flow the paragraphs in the initial review to make seeing the diffs easier.

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

PR: https://git.openjdk.org/jdk/pull/12058