java - Doxygen：如何在文档中引用 java 泛型接口

Question

我有一些带有 doxygen 文档的 Java 接口

public interface Service< T , U > {
    ...
}

Doxygen 正在为 class 创建文档Service< T, U >。当我尝试使用 @ref 标记从其他页面引用此文档页面时@ref Service< T , U>，会生成警告：

warning: unable to resolve reference to 'Service' for \ref command

看起来@ref 对名称中的“<”不友好。

有谁知道一些解决方法来引用名称中带有“<”的类？

Answer 1

我尝试使用以下示例重现您的问题：

/** A service */
public interface Service< T , U > {
}


/** @mainpage
 *  See @ref Service<T,U> "the service interface" for details.
 */

但它工作得很好（正如我所料）。