【问题标题】:Doxygen losing non-static Java generic methodsDoxygen 丢失非静态 Java 泛型方法
【发布时间】:2014-04-17 01:20:39
【问题描述】:

我遇到了一个问题,即 Doxygen 在文档中不包含非静态 Java 泛型方法。未找到使用以下语法的方法:

public <T> ReturnType<T> methodName(ArgType1 arg1, ArgType2<T> arg2) throws Exception{}

但是,在文档中可以找到并包含以下方法声明:

public static <T> ReturnType<T> methodName(ArgType1 arg1, ArgType2<T> arg2) throws Exception{}

public ReturnType<T> methodName(ArgType1 arg1, ArgType2<T> arg2) throws Exception{}

还有其他人遇到过这个问题吗?

【问题讨论】:

  • 我很好奇:您为什么使用 Doxygen 而不是 Javadocs for Java?
  • 我们正在将 Doxygen 用于不同的平台,如果可能,我们希望使用相同的工具。

标签: java doxygen


【解决方案1】:

我也遇到过。在我看来,Doxygen 不支持 Java 通用方法(至少在这个特定版本中 - 我使用 1.8.8-5),因此被忽略了。 static 覆盖了这种行为,因为它显然使 Doxygen 接受任意字符串作为返回类型修饰符。

将第一个 &lt;T&gt;/*! @cond x *//*! @endcond */ 包围起来,因此 Doxygen 会忽略它,尽管它很丑,但也有帮助(x 可以是任何字符串,只要它没有标记启用的条件) .

【讨论】:

    猜你喜欢
    • 1970-01-01
    • 2021-06-28
    • 2011-12-20
    • 1970-01-01
    • 1970-01-01
    • 2019-05-26
    • 1970-01-01
    • 2011-01-19
    • 1970-01-01
    相关资源
    最近更新 更多