On Thu, 23 May 2024 13:59:19 GMT, Hannes Wallnöfer <hann...@openjdk.org> wrote:
>> Please review a simple patch to exclude preview visitor classes meant to >> support future preview features from the Preview API page. >> >> The test adds an sample element annotated with the new >> `PreviewFeature.Feature.LANGUAGE_MODEL` constant (which does not have a >> `@JEP` annotation) to make sure it is not listed in the Preview API page. >> The test itself does not have to be modified, as it would fail without the >> change in `PreviewAPIListBuilder.java`. > > Hannes Wallnöfer has updated the pull request with a new target base due to a > merge or a rebase. The pull request now contains three commits: > > - Merge branch 'master' of https://git.openjdk.org/jdk into JDK-8331947 > - Only include preview features with a JEP > - JDK-8331947: Preview creates checkbox for JEP-less preview feature src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/util/PreviewAPIListBuilder.java line 88: > 86: return new JEP(number, title, status); > 87: } > 88: return null; I think we can create a `NULL_SENTINEL` special constant JEP object to indicate a feature has no JEP (like how many collection implementations use a sentinel for null) src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/util/SummaryAPIListBuilder.java line 70: > 68: * @param configuration the current configuration of the doclet > 69: */ > 70: public SummaryAPIListBuilder(BaseConfiguration configuration) { Suggestion: protected SummaryAPIListBuilder(BaseConfiguration configuration) { Nit: abstract classes. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/19344#discussion_r1620691115 PR Review Comment: https://git.openjdk.org/jdk/pull/19344#discussion_r1620685264