[jdk19] RFR: 8281969: Bad result for the snippet @link tag if substring/regex consists of whitespace [v4]

Pavel Rappo prappo at openjdk.org
Thu Jul 14 21:33:04 UTC 2022


On Thu, 14 Jul 2022 21:22:38 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> I'm torn between wanting consistency between the different forms of `link` (doc comment tags and snippet markup tags) and consistency between the examples given in the bug report for highlight and link markup tags.

One thing to consider is that the snippet's markup `@link` tag is somewhat more powerful than the Standard doclet's `{@link}` tag. The former can be applied to regions that span multiple lines. In that case, we need to decide whether it's going to be a single link or multiple links, one per line.

The simpler, the better.

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

PR: https://git.openjdk.org/jdk19/pull/142


More information about the javadoc-dev mailing list