On Thu, 18 Jun 2026 10:03:22 GMT, Nizar Benalla <[email protected]> wrote:
>> 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.
Can you add a comment with an example for this one? Other cases have example
text in comments.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/31532#discussion_r3437143214
