Note: This is the same PR as the valhalla PR
https://github.com/openjdk/valhalla/pull/2658, which was deferred until after
valhalla integration. I've made one change to it, which is to get rid of the
(useless) "class=preview-mark" references, which you can see in the 2nd
changeset.
Rather saying "if preview is enabled", instead the text can just refer to the
specific preview feature and then a link to a related preview API. This will
result in a PREVIEW superscript being part of the link, clearly designating the
feature as preview. For example:
- * If preview features are enabled in the target VM, this method does not
prevent a
- * strictly-initialized field from being read before it has been
initialized.
+ * This method does not prevent a
+ * {@linkplain java.lang.reflect.Field#isStrictInit() strictly-initialized
field}
+ * from being read before it has been initialized.
Also, [JDK-8388113](https://bugs.openjdk.org/browse/JDK-8388113) was suppose to
include some JDWP spec clarifying comments about strict field initialization
behavior, but it was accidentally not included in the PR. That content is being
added here.
---------
- [x] I confirm that I make this contribution in accordance with the [OpenJDK
Interim AI Policy](https://openjdk.org/legal/ai).
-------------
Commit messages:
- get rid of class=preview-mark in jdwp.spec since it doesn't do anything
- improve preview related comments
Changes: https://git.openjdk.org/jdk/pull/32220/files
Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=32220&range=00
Issue: https://bugs.openjdk.org/browse/JDK-8388530
Stats: 51 lines in 5 files changed: 27 ins; 1 del; 23 mod
Patch: https://git.openjdk.org/jdk/pull/32220.diff
Fetch: git fetch https://git.openjdk.org/jdk.git pull/32220/head:pull/32220
PR: https://git.openjdk.org/jdk/pull/32220
