Question

我刚刚开始为我正在开发的库生成Groovydoc。但是，方法签名中d.pluck(:per_day_average_interest)和java.lang以及其他常见包前缀的优势正在模糊方法的真实意图。我希望能够在没有这些的情况下生成Groovydoc。如（组成）示例所示：

java.util

而不是：

List flatMap(Iterable itr, f)

（我的一些真实例子更糟糕，有三个或四个java.util.List flatMap(java.lang.Iterable itr, f)参数加上返回值。）

在Javadoc中，我使用something.entirely.Obvious选项实现此目的。但是，-noqualifier没有列出类似的选项。

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

Answer 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>

仍然想知道是否有更好的方法。

任何使Groovydoc按照Javadoc＆＃39; noqualifier＆＃39;删除（选择）包限定符的方法。选项？

1 个答案: