根据 Javadoc 的 'noqualifier' 选项,有什么方法可以让 Groovydoc 删除(选定的)包限定符?
Any way to make Groovydoc remove (selected) package qualifiers as per Javadoc's 'noqualifier' option?
我刚刚开始为我正在处理的库生成 Groovydoc。然而,方法签名中 java.lang
和 java.util
以及其他常见包前缀的优势掩盖了这些方法的真正意图。我希望能够在没有这些的情况下生成 Groovydoc。如(编造的)示例所示:
List flatMap(Iterable itr, f)
而不是:
java.util.List flatMap(java.lang.Iterable itr, f)
(我的一些真实示例更糟糕,有三个或四个 something.entirely.Obvious
个参数加上 return 个值。)
在 Javadoc 中,我将使用 -noqualifier
选项实现此目的。但是 groovydoc --help
没有列出类似的选项。
有没有办法用 Groovydoc 做到这一点?如果没有,有没有人想出任何其他可靠的方法来做到这一点? (我的后备方案,我还没有机会尝试,它尝试 post- 使用 Ant 的 replace
任务处理生成的文档 - 但我想知道是否有更好的方法。)
以下 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。然而,方法签名中 java.lang
和 java.util
以及其他常见包前缀的优势掩盖了这些方法的真正意图。我希望能够在没有这些的情况下生成 Groovydoc。如(编造的)示例所示:
List flatMap(Iterable itr, f)
而不是:
java.util.List flatMap(java.lang.Iterable itr, f)
(我的一些真实示例更糟糕,有三个或四个 something.entirely.Obvious
个参数加上 return 个值。)
在 Javadoc 中,我将使用 -noqualifier
选项实现此目的。但是 groovydoc --help
没有列出类似的选项。
有没有办法用 Groovydoc 做到这一点?如果没有,有没有人想出任何其他可靠的方法来做到这一点? (我的后备方案,我还没有机会尝试,它尝试 post- 使用 Ant 的 replace
任务处理生成的文档 - 但我想知道是否有更好的方法。)
以下 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>
还在想有没有更好的办法