9

Groovy 1.8ドキュメントには、次の3種類のJavaDocがあります。

api / gapi / jdk /

jdk / Javadocsは、GroovyがJavaクラスに追加するメソッドを示しています。それは理解しやすいです。

api/とgapi/のJavaDocsは混乱を招きます。api /では大文字と小文字が区別されないすべてのクラスが表示され、gapi /では大文字と小文字が区別されるすべてのクラスが表示されることを除いて、これらは似ています。(大文字と小文字が区別される表示では、物を見つけるのが難しくなります。)

gapi / All Classesリストには、リストの最後に4つのgenXXXエントリがあり(大文字と小文字が区別されます)、api/リストにはないようです。

api/とgapi/JavaDocsの違いを知っている人はいますか?

ありがとう。

4

1 に答える 1

6

Groovy Userメーリング リストの Paul Kingから引用

「api」は、すべての Java ファイルで javadoc を実行した結果です。

「gapi」は、すべての Java ファイルと Groovy ファイルに対して groovydoc を実行した結果です。(歴史的には、これは Groovy ファイルだけでしたが、現在は両方で実行されます。Groovydoc が終了したら、「api」を完全に削除できますが、少なくとも現時点では、javadoc にはより多くの情報が含まれているため、両方を保持します。)

「groovy-jdk」は、DefaultGroovyMethods のような「カテゴリ」ファイルだけで実行され、ソース ファイル全体で Javadoc を報告する代わりに、カテゴリが拡張するクラス全体でそれらを報告します。例えば:

DGM#join(コレクション自身、文字列区切り)

次のように報告されます。

java.util.Collection#join(文字列区切り)

これは、言語ユーザーにはどのように表示されるかです。

于 2011-06-29T18:58:32.540 に答える