groovy - Groovy 1.8 的 JavaDoc 有哪 3 种类型？

Question

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

API/ 加皮/ jdk/

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

api/和gapi/中的JavaDocs令人困惑。它们很相似，只是 api/对所有类的显示不区分大小写，而gapi/对所有类的显示区分大小写。 (区分大小写的显示使查找内容变得困难。)

gapi/所有类列表在列表末尾有四个 genXXX 条目(再次区分大小写排序)，它们似乎不在 api/列表中。

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

谢谢。

Answer 1

引自Paul King on the Groovy User邮件列表

"api" is the result of running javadoc across all of the Java files.

"gapi" is the result of running groovydoc across all of the Java and Groovy files. (Historically this was just the Groovy files but it now runs across both. If Groovydoc was finished we could remove "api" altogether but at least as of now, javadoc has more information in it so we keep both.)

"groovy-jdk" is run across just the "category" files like DefaultGroovyMethods and instead of reporting the Javadoc across the source file reports them across the classes which the category extends. E.g.:

DGM#join(Collection self, String separator)

will be reported as:

java.util.Collection#join(String separator)

which is how it appears to the language user.