Ant 根据Javadoc',使Groovydoc删除(选定)包限定符的任何方法;s';无限定符';选项
我刚刚开始为正在开发的库生成Groovydoc。然而,Ant 根据Javadoc',使Groovydoc删除(选定)包限定符的任何方法;s';无限定符';选项,ant,groovy,javadoc,groovydoc,Ant,Groovy,Javadoc,Groovydoc,我刚刚开始为正在开发的库生成Groovydoc。然而,java.lang和java.util以及方法签名中的其他常见包前缀的优势掩盖了方法的真正意图。我希望能够在没有这些的情况下生成Groovydoc。如(合成)示例中所示: 而不是: java.util.List flatMap(java.lang.Iterable itr, f) (我的一些真实示例更糟糕,有三个或四个参数加上返回值。) 在Javadoc中,我将通过-noqualifier选项实现这一点。但是,groovydoc--help
java.lang
和java.util
以及方法签名中的其他常见包前缀的优势掩盖了方法的真正意图。我希望能够在没有这些的情况下生成Groovydoc。如(合成)示例中所示:
而不是:
java.util.List flatMap(java.lang.Iterable itr, f)
(我的一些真实示例更糟糕,有三个或四个参数加上返回值。)
在Javadoc中,我将通过-noqualifier
选项实现这一点。但是,groovydoc--help
没有列出类似的选项
有没有办法用Groovydoc做到这一点?如果没有,有没有人想出其他可靠的方法来做到这一点?(我的退路,我还没有尝试过,它试图用Ant的replace
任务对生成的文档进行后处理,但我想知道是否有更好的方法。)下面的Ant任务黑客似乎为Groovy 2.4.3的Groovydoc输出产生了合理的结果。(至少我还没找到它坏了的东西。)
仍然在想是否有更好的方法。似乎没有其他方法,所以这是目前最好的解决方案。
java.util.List flatMap(java.lang.Iterable itr, f)
<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>