On Tue, 16 Jun 2026 14:45:44 GMT, Chen Liang <[email protected]> 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? This can happen if the user writes `/// @see [String]`, it's parsed as markdown then the Markdown transformer converts the unresolved link to a `DocTree.LINK`. This form needs to be rejected, as described by the CSR. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/31532#discussion_r3434916014
