RFR: 8292892: Javadoc index descriptions are not deterministic

[Jonathan Gibbons]

On Mon, 29 Aug 2022 21:03:34 GMT, John Neffenger <jgneff at openjdk.org> 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