On Fri, 31 Jan 2025 16:19:17 GMT, Hannes Wallnöfer <hann...@openjdk.org> wrote:
> Please review a patch to add a JavaDoc Taglet to the JDK build system that
> allows to add preview-related notes to non-preview API elements, as well as a
> hidden javadoc option to add elements with preview notes to the preview
> summary page.
>
> The {@previewNote} tag uses the following syntax:
>
>
> {@previewNote <jep-number> [preview note title]}
> preview note text
> {@previewNote}
> ```
>
> Elements with preview notes are listed in a separate table titled "Elements
> containing Preview Notes" in the preview summary page.
>
> To support the feature, the algorithm in `PreviewAPIListBuilder.java` was
> changed to retrieve the preview JEP info in advance before looping through
> API elements. While this is not strictly necessary, it makes the code a bit
> nicer, and it also allows us to avoid checking for preview API elements when
> processing non-JDK code.
This pull request has now been integrated.
Changeset: 2321722a
Author: Hannes Wallnöfer <hann...@openjdk.org>
URL:
https://git.openjdk.org/jdk/commit/2321722a45c0ae8a2fd0aabfa2aa01d3b801c832
Stats: 357 lines in 8 files changed: 297 ins; 39 del; 21 mod
8346109: Create JDK taglet for additional preview notes
Reviewed-by: ihse, liach, rriggs
-------------
PR: https://git.openjdk.org/jdk/pull/23395
