3

私はEclipse 3.4.1を使用しています。

これは奇妙に聞こえるかもしれませんが、Eclipse プロジェクトの同じ JAR に複数の JavaDoc の場所をアタッチできるようにしたいと考えています。この特定の JAR には、2 セットの JavaDoc からのクラスがあります。これは、サードパーティの JAR と、OSGi で動作させるためにその JAR の上にあるその他のサードパーティのコードで構成される OSGi バンドルであるためです。

両方のパッケージのソース コードがあり、そのソース コードが Eclipse プロジェクトにある場合、問題なく動作します。しかし、JAR と JavaDoc しか持っていない場合でも、これを機能させたいと考えています。

4

1 に答える 1

1

javadoc に関する情報はプロジェクトclasspathentry.classpathファイルに保存され、1 つの値 (ディレクトリまたはアーカイブ) で構成されているため、簡単なことではありません。

解決策は、現在の両方の javadoc を含む単一の javadoc を構築し、そのアーカイブを jar に添付することです。


別の解決策(Eclipseによって正しく解釈されない可能性があります:テスト中)は、外部ドキュメントへのリンクです

外部ドキュメントへの相対リンクを使用した例:

Javadoc ツールの異なる実行でドキュメントが生成された 2 つのパッケージがあり、それらのドキュメントが相対パスで区切られているとします。
この例では、パッケージはcom.apipackage、API、およびcom.spipackage、SPI (Service Provider Interface) です。
ドキュメントを と に保存しdocs/api/com/apipackageますdocs/spi/com/spipackage
API パッケージ ドキュメントが既に生成されており、docs が現在のディレクトリであると仮定すると、次のコマンドを実行して API ドキュメントへのリンクを含む SPI パッケージをドキュメント化します。

C:> javadoc -d ./spi -link ../api com.spipackage

-link 引数は、宛先ディレクトリ (docs/spi) に対して相対的であることに注意してください。

2 番目の javadoc だけを jar にアタッチすると、最初の javadoc に記載されているクラスが選択される可能性がありますが、私はそれを疑ってい ますhttp://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#linkrelativeexample

于 2009-02-11T16:43:41.793 に答える