我正在尝试为我的项目生成 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}
,但由于某种原因,它在这里不起作用......
最佳答案
在 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 中该错误是不可重现的。
关于引用 vararg (String[]...) 时,Javadoc @link 不起作用,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/48445836/