RFR: 8339631: Fix block @jls and @jvms tags [v2]

[Jonathan Gibbons]

On Fri, 6 Sep 2024 12:09:16 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

> Thoughts?

My initial thought is, at least we're working with specific tags (`@jls` and `@jvms`) rather than generic HTML links (`<a href=...>...</a>`), since that permits the kind of detailed analysis and checking you are doing.

Preview-ness is a pervasive feature of JDK these days, on the command-line and in APIs. Perhaps the tags here can be augmented to indicate that a feature is a preview feature, for example, `@jls preview 5.7.2 Unconditionally Exact Testing Conversions`. This could be used not only to affect the generated output, perhaps with <sup>PREVIEW</sup>, but could be used to help both determine the target for such links, and to review such links in subsequent releases. Such management should be part of the responsibilities of the preview-feature owner.

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

PR Comment: https://git.openjdk.org/jdk/pull/20879#issuecomment-2334271942