2011-06-29 37 views
6

Groovy的1.8文檔有3種類型的JavaDoc的:Groovy 1.8的3種類型的JavaDocs是什麼?

API/ GAPI/ JDK/

的JDK/Javadoc中顯示的方法是Groovy中增加了Java類。這很容易理解。

api /和gapi /中的JavaDocs令人困惑。它們是類似的,除了api /具有所有類的大小寫不敏感顯示,而gapi /具有區分大小寫的所有類的顯示。 (區分大小寫的顯示屏很難找到東西。)

gapi/All Classes列表在列表末尾有四個genXXX條目(這是區分大小寫的排序),它似乎不在api /列表。

有沒有人知道api /和gapi/JavaDocs有什麼不同?

謝謝。

回答

3

Paul King on the Groovy User郵件列表

引用了 「API」 是在所有的Java文件運行的javadoc 的結果。

「gapi」是在所有Java和 Groovy文件中運行 groovydoc的結果。 (歷史上,這是 只是Groovy的文件,但它現在運行在兩個 。如果GroovyDoc的結束 我們可以刪除「API」一共但 至少截至目前,javadoc的在它有更多的 信息,以便我們保留兩個。)

「Groovy的JDK」跨只是 「類別」文件運行像 DefaultGroovyMethods和替代 報告跨 源文件的Javadoc對面的類別擴展 類報告它們。 如:

DGM#加入(收集自我,字符串 分離器)作爲

將報告:

java.util.Collection中加入#(字符串 分離器)

這是怎麼它看起來是 語言用戶。

+1

呃。我們需要一套全面的文檔。 GroovyDoc gapi應該是最好的,但是區分大小寫的顯示是一個問題。 –