RFR: JDK-8263468: New page for "recent" new API

[Hannes Wallnöfer]

On Thu, 27 May 2021 12:52:34 GMT, Erik Joelsson <erikj at openjdk.org> wrote:

>> This adds a new kind of summary list for new API added in specific releases, and adds information to the deprecated API list about elements that were deprecated in the given releases.
>> 
>> The changes to the code are relatively minor thanks to the existing infrastructure for summary list pages, which was extended by adding the `getTableCaption` and `addTableTabs` methods to `SummaryListWriter.java` in order to generate tabbed tables. 
>> 
>> One important area that needs to be reviewed is the addition of resources in `standard.properties`. A relatively big share of discussion and effort went into shaping the UI messages.
>> 
>> The build system change adds options to generate API changes for all releases after JDK 11, with "New API since JDK 11" as page title for the new API page. I uploaded the generated documentation here:
>> 
>> http://cr.openjdk.java.net/~hannesw/8263468/api-pr.00/new-list.html
>> http://cr.openjdk.java.net/~hannesw/8263468/api-pr.00/deprecated-list.html
>
> make/Docs.gmk line 336:
> 
>> 334: 
>> 335:   # Add summary pages for new/deprecated APIs in recent releases
>> 336:   $1_OPTIONS += --since 12,13,14,15,16,17 --since-label "New API since JDK 11"
> 
> How do you expect this to change as the JDK version is bumped? If there is an expected pattern, then maybe we should try to generate the list instead, so we don't need to manually update twice a year.

I don't have a solution for this problem. AFAIK there are a few things that have to be "bumped" manually between releases, and this would be yet another. Obviously not a great solution.

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

PR: https://git.openjdk.java.net/jdk/pull/4209