Groovy 1.8 文档有 3 种 JavaDocs：
api/gapi/jdk/
jdk/Javadocs 展示了 Groovy 添加到 Java 类的方法。这很容易理解。
api/ 和 gapi/ 中的 JavaDocs 令人困惑。它们是相似的，只是 api/ 具有所有类的不区分大小写显示，而 gapi/ 具有所有类的区分大小写显示。（区分大小写的显示让人很难找到东西。）
gapi/ 所有类列表在列表末尾有四个 genXXX 条目（再次区分大小写排序），它们似乎不在 api/ 列表中。
有谁知道 api/ 和 gapi/ JavaDocs 之间有什么区别？
谢谢。
引用自Groovy 用户邮件列表中的 Paul King
“api”是在所有 Java 文件中运行 javadoc 的结果。
“gapi”是在所有 Java 和 Groovy 文件中运行 groovydoc 的结果。（从历史上看，这只是 Groovy 文件，但现在两者都运行。如果 Groovydoc 完成，我们可以完全删除“api”，但至少到目前为止，javadoc 中有更多信息，所以我们保留两者。）
“groovy-jdk”仅在“类别”文件（如 DefaultGroovyMethods）中运行，而不是在源文件中报告 Javadoc，而是在类别扩展的类中报告它们。例如：
DGM#join（集合自身，字符串分隔符）
将被报告为：
java.util.Collection#join(字符串分隔符)
这就是它对语言用户的看法。