On Mon, 29 Aug 2022 21:03:34 GMT, John Neffenger <[email protected]> wrote:
> Please review these changes to the Javadoc index builders. This pull request > adds 423 missing entries to the index of the JDK API Specification, corrects > their package names in the member search index, and makes their descriptions > deterministic. I'll follow up with more information in a separate comment. _“The sins of the father are to be laid upon the children.”_ I see this arises from `ZipConstants`, authored in JDK 1.1, before the availability of `import static` in JDK 5 onwards. Early on, the use was eventually seen as something of an anti-pattern, with unappreciated implications for compatibility, meaning that once in the API, it is hard to remove them. While the approach in this PR is probably correct and for the best, it is depressing to see the exact same constants being defined multiple times in the documentation. ------------- PR: https://git.openjdk.org/jdk/pull/10070
