Groovy 1.8的3种JavaDocs是什么？

发布时间：2020-12-14 16:32:06 所属栏目：大数据来源：网络整理

导读：Groovy 1.8文档有3种类型的 JavaDoc： API / ??GAPI / ??JDK / jdk / Javadocs显示了Groovy添加到Java类的方法.这很容易理解. api /和gapi /中的JavaDocs令人困惑.它们是相似的,除了api /具有不区分大小写的All Classes显示,而gapi /具有所有类的区分大小写

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之间有什么区别？

谢谢.

解决方法

引自 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.

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!