Re: RFR: 8371504: Support Markdown link syntax in Markdown @see tags

[Chen Liang]

On Tue, 16 Jun 2026 12:40:23 GMT, Nizar Benalla <nbena...@openjdk.org> wrote:

> Please review this patch to support markdown link syntax in `@see`tags.
> 
> ---------
> - [x] I confirm that I make this contribution in accordance with the [OpenJDK 
> Interim AI Policy](https://openjdk.org/legal/ai).

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/taglets/SeeTaglet.java
 line 188:

> 186:             case LINK, LINK_PLAIN -> {
> 187:                 // Markdown reference links to program elements are 
> covered by @see reference label form.
> 188:                 return invalidSeeTagOutput(element, seeTag);

Before this is a javadoc tool internal error, and now this is repurposed to a 
user error. How can this happen to any parsed `@see` label?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/31532#discussion_r3421679957