1

我刚刚开始为我正在开发的库生成 Groovydoc。然而，方法签名中的java.langandjava.util和其他常见包前缀的优势掩盖了方法的真正意图。我希望能够在没有这些的情况下生成 Groovydoc。如（组成）示例：

List flatMap(Iterable itr, f)

而不是：

java.util.List flatMap(java.lang.Iterable itr, f)

（我的一些真实例子更糟糕，有三四个something.entirely.Obvious参数加上返回值。）

在 Javadoc 中，我会使用该-noqualifier选项来实现这一点。但是，没有列出类似的选项groovydoc --help。

有没有办法用 Groovydoc 做到这一点？如果没有，有没有人想出任何其他可靠的方法来做到这一点？（我的后备方案，我还没有机会尝试，它尝试使用 Ant 的replace任务对生成的文档进行后处理 - 但我想知道是否有更好的方法。）

4

1 回答 1

1

以下 Ant 任务 hack 似乎为 Groovy 2.4.3 的 Groovydoc 输出产生了合理的结果。（至少我还没有发现它坏了。）

<replace dir="build/doc/groovy/api">
    <replacefilter token="(java.lang.Object " value="("/>
    <replacefilter token=", java.lang.Object" value=", "/>
    <replacefilter token="java.lang." value=""/>
    <replacefilter token="java.util." value=""/>
    <!-- ... add more here ... -->
</replace>

还在想有没有更好的办法。

于 2015-06-08T22:18:19.200 回答