带有泛型的未知Javadoc标记类型

Question

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

}

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

Answer 1

理想的解决方案是将文档更改为

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

也就是说，完全删除 ，就像标准库一样，除非它对代码有重要意义。

如果确实需要显示角括号，可以使用{@literal}

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