【问题标题】:Doxygen: how to reference java generic interface in documentationDoxygen:如何在文档中引用 java 泛型接口
【发布时间】:2013-08-11 03:12:15
【问题描述】:

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

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

Doxygen 正在为 Service&lt; T, U &gt; 类创建文档。当我尝试使用@ref 标签@ref Service&lt; T , U&gt; 从其他页面引用此文档页面时,会生成警告:

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

@ref 似乎对名称中的“

有人知道一些解决方法来引用名称中带有“

【问题讨论】:

  • 您尝试过@ref 服务吗?
  • 是的,当然。结果是一样的——警告。很清楚为什么 - 文档是为 Service 创建的,所以我应该以某种方式引用它...

标签: java doxygen


【解决方案1】:

我尝试通过以下示例重现您的问题:

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


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

但效果很好(如我所料)。

【讨论】:

  • 从 doxygen 版本 1.7.6.1 迁移到 1.8.4 后问题解决。感谢您的帮助
猜你喜欢
  • 1970-01-01
  • 2014-05-18
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2010-10-15
  • 1970-01-01
  • 2021-10-09
相关资源
最近更新 更多