Groovy 1.8的3种JavaDocs是什么？

Question

Groovy 1.8文档有3种类型的JavaDoc:

api/gapi/jdk /

jdk/Javadocs显示了Groovy添加到Java类的方法.这很容易理解.

api /和gapi /中的JavaDocs令人困惑.它们是相似的,除了api /具有不区分大小写的All Classes显示,而gapi /具有所有类的区分大小写的显示.(区分大小写的显示器很难找到东西.)

gapi/All Classes列表在列表末尾有四个genXXX条目(再次区分大小写),它们似乎不在api/list中.

有谁知道api /和gapi/JavaDocs之间有什么区别？

谢谢.

Answer 1

引用自Paul King 在 Groovy 用户邮件列表中

“api”是在所有 Java 文件中运行 javadoc 的结果。

“gapi”是在所有 Java 和 Groovy 文件中运行 groovydoc 的结果。（从历史上看，这只是 Groovy 文件，但现在两者都运行。如果 Groovydoc 完成，我们可以完全删除“api”，但至少到目前为止，javadoc 中有更多信息，因此我们保留两者。）

“groovy-jdk”仅在“类别”文件中运行，如 DefaultGroovyMethods，而不是跨源文件报告 Javadoc，跨类别扩展的类报告它们。例如：

DGM#join(集合自身，字符串分隔符)

将报告为：

java.util.Collection#join(字符串分隔符)

这就是它在语言用户面前的样子。