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

Question

我正在尝试为我的项目生成 Javadoc，但我似乎找不到如何创建指向精确方法的链接:

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}，但由于某种原因，它在这里不起作用......

Answer 1

在 java-8 中(可能是由于 very old javadoc bug 的回归)，当链接 URL 的片段部分使用省略号 "..." 表示 varargs 参数时，@link 声明无法正确呈现链接。相反，应该使用数组语法。所以你的链接声明

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

应该这样改变:

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

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