On Thu, 27 May 2021 12:52:34 GMT, Erik Joelsson <er...@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
