Unknown Javadoc tag TYPE with generics

Viewed 287

I have method with javadoc:

/**
 * Supplier interface mixed with {@link ServiceCast}.
 * @param <R> is <TYPE> of supplier.
 */
public interface ServiceCastSupplier<R> extends ServiceCast, Supplier<R> {

}

in pipeline I'm getting error:

error: unknown tag: TYPE
[ERROR]      * @param <R> is <TYPE> of supplier

r.

why it doesn't like <R>, what's wrong with it?

1 Answers

The ideal solution would be to change the documentation to

/**
 * Supplier interface mixed with {@link ServiceCast}.
 * @param <R> is the type of supplier.
 */

i.e., remove <TYPE> entirely, just like the standard library does, unless it has an important meaning to your code.

If you really need to show the angular brackets, you can use {@literal}

/**
 * Supplier interface mixed with {@link ServiceCast}.
 * @param <R> is {@literal <TYPE>} of supplier.
 */
Related