On Wed, 9 Feb 2022 16:04:06 GMT, Jan Lahoda <jlah...@openjdk.org> wrote:
>> This is a patch that tweaks a bit the PREVIEW superscript which is marking >> preview APIs in javadoc. This is based on the experience with the Loom's >> fibers javadoc. >> >> Namely, the changes are: >> >> * for methods inside a preview class: >> * show the PREVIEW superscript, unless: >> * the reference is inside the enclosing (preview) class, in which case >> skip the PREVIEW superscript >> * ensure the PREVIEW superscript refers to the class' Preview note, not >> to the non-existing method's Preview note >> * for preview classes nested inside preview classes, ensure these are >> considered preview by themselves, not only as referring to a preview class >> * avoid the PREVIEW superscript inside code snippets. >> >> A sample javadoc with these changes is here: >> http://cr.openjdk.java.net/~jlahoda/8277300/fibers-docs.00/api/java.base/java/util/concurrent/StructuredExecutor.html >> http://cr.openjdk.java.net/~jlahoda/8277300/fibers-docs.00/api/java.base/java/util/concurrent/StructuredExecutor.CompletionHandler.html > > Jan Lahoda has updated the pull request with a new target base due to a merge > or a rebase. The incremental webrev excludes the unrelated changes brought in > by the merge/rebase. The pull request contains six additional commits since > the last revision: > > - Cleanup. > - Merge branch 'master' into JDK-8277300 > - Merge branch 'master' into JDK-8277300 > - Cleanup > - Cleanup > - 8277300: Issues with javadoc support for preview features Marked as reviewed by jjg (Reviewer). ------------- PR: https://git.openjdk.java.net/jdk/pull/6848
