Javadoc @link 在引用 vararg (String[]...) 时不起作用

Question

我正在尝试为我的项目生成 Javadoc，但我似乎找不到如何创建 link 到精确方法的方法：

public static Html select(Buffer<String> contentBuffer, String id, String name, String classes, boolean isMultiple, String[]... attributeList)

我试过了：

{@link #select(Buffer, String, String, String, boolean, String:A...) select()}
{@link #select(Buffer, String, String, String, boolean, String[]...) select()}

但是根本没有创建 link ...我在 link 标签上收到错误 error: unexpected text。

我是不是漏掉了什么？

编辑：我已经知道如何形成有效的 {@link}，但由于某种原因，它在这里不起作用...

Answer 1

不应该是{@link #select(Buffer, String, String, String, boolean, String[]...) select}吗？

Answer 2

在 java-8 中（可能是由于 very old javadoc bug 的回归）当 @link 的片段部分 link URL 使用省略号 "..." 来表示可变参数。相反，应该使用数组语法。所以你的link声明

{@link #select(Buffer, String, String, String, boolean, String[]...) select()}

应该这样改：

{@link #select(Buffer, String, String, String, boolean, String[][]) select()}

另请注意，在 java-9 中，该错误不可重现。

Javadoc @link 在引用 vararg (String[]...) 时不起作用

Javadoc @link not working when referencing a vararg (String[]...)

java

javadoc