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

Question

I'm trying to generate a Javadoc for my project, but I can't seem to find how to create a link to a precise Method :

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

I tried :

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

But there are no link created at all ... I get the error error: unexpected text on the link tag.

Am I missing something?

EDIT : I already know how to form a valid {@link}, but for some reason, it doesn't work here ...

Answer 1

In java-8 (possibly due to a regression of a very old javadoc bug) a @link declaration does not render link properly when the fragment part of the link URL uses ellipsis "..." to denote the varargs parameter. Instead the array syntax should be used. So your link declaration

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

should be changed this way:

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

Also note, that in java-9 the bug is not reproducable.