Please review this change to drastically reduce the number of enum values in 
`HtmlLinkInfo.Kind` used to describe the format of a JavaDoc link. Previously 
the enum values were specific to the context in which a link was used. The new 
values describe the link format, such as whether to include preview information 
or type parameters or bounds. Other link properties that previously depended on 
this enum were moved into separate boolean flags as they are orthogonal to the 
link format and would have needlessly inflated the enum class. In some other 
cases the calling code had to be adapted slightly to generate the desired 
output. 

Apart from passing the tests, I made sure the new code generates the exact same 
output for the JDK documentation as the old code. Doing so I noticed that some 
generated links were not previously covered by tests. I added tests for these 
in the existing `TestInterface.java`.

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

Commit messages:
 - Update copyright header dates
 - JDK-8299896: Reduce enum values of HtmlLinkInfo.Kind

Changes: https://git.openjdk.org/jdk/pull/11972/files
 Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=11972&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8299896
  Stats: 502 lines in 26 files changed: 117 ins; 221 del; 164 mod
  Patch: https://git.openjdk.org/jdk/pull/11972.diff
  Fetch: git fetch https://git.openjdk.org/jdk pull/11972/head:pull/11972

PR: https://git.openjdk.org/jdk/pull/11972

Reply via email to