0

javadoc:javadocMavenを使用して（目標を持って）プロジェクトのJavadocを生成しています。また、プロジェクトのJavadoc Locationプロパティを、maven が Javadoc を生成するフォルダーに設定しました。次に、「Open Attached Javadoc in a Browser」を選択することで、Eclipse Javadoc ビューからクラスの完全な Javadoc を簡単に表示できます。

ただし、ドキュメントに変更を加えるたびに、ブラウザーでドキュメントの更新を確認する前に、maven を使用してドキュメントを明示的に再作成する必要があります。

ファイルの保存時に Javadoc ファイルを自動的に生成するように Eclipse に指示する方法はありますか?

Eclipse の速度が少し遅くなる可能性があるため、ドキュメントの作成に集中していない場合、これはおそらく良い考えではないことはわかっています。ただし、私の主なタスクがドキュメントを書くことである場合、この意味での自動化は高く評価されます。保存されたファイルのみのドキュメントを更新する (そして Javadoc 生成プロセス全体をトリガーしない) ことで正しい解決策が通ると思いますが、そのようなことが可能かどうかはわかりません。

4

1 に答える 1

1

Maven Integration for Eclipse (m2e)を使用している場合は、特定のプラグイン実行を Eclipse でも実行したいことを m2e が認識できるように、プラグイン実行フィルターを設定できます。プラグインをバックグラウンドで実行したい場合:

       <execute >
         <runOnIncremental>true</runOnIncremental>
       </execute >

このすべての裏返しは、何かを保存するたびにJavadoc全体の実行が実行されることです.インクリメンタルはその意味で誤解を招きます. 更新された質問で言うように、「少し」だけでなく、Eclipseが詰まる可能性があります。絶対に些細なこと以上のことを行うすべてのプラグインの実行は、厳重に精査する必要があります。

プロジェクトの一部だけをビルドする必要があるという意味がないため、真にインクリメンタルなソリューションは Maven からは得られません。むしろ、これを直接行うには Eclipse が必要です。Java のコンパイルでも同じことが起こると思います。これは、Eclipse 自体によって段階的に行われます。ただし、Javadoc FAQ によると:

A9. さまざまな Javadoc の実行から文書を段階的に作成できますか?

基本的にありません (...)

これをインクリメンタル ビルドと呼び、将来のリリースで検討しています。

しかし、不可能なことは何もありません:)

于 2013-10-08T15:13:13.577 に答える