問題タブ [javadoc]

Javadoc のない大きなコードベースがあり、プログラムを実行して基本的な Javadoc 情報 (たとえば、各メソッドのパラメーター write @param...) を含むスケルトンを作成したいので、残っているギャップを埋める必要があります。

これに対する良い解決策を知っている人はいますか？

編集：

JAutodoc は私が探していたものです。Eclipse プラグインである Ant タスクがあり、テンプレート定義に Velocity を使用します。

私は長年のemacsユーザーであり、現在Javaで約1/2時間働いています。

のための最高のemacsライブラリは何ですか

1. Javaのデバッグ
2. コード補完/インテリセンス
3. Javadocブラウジング

？

Ant を使用して Javadoc を生成していますが、この例外が何度も発生します - なぜですか?

JDK バージョン1.6.0_06を使用しています。

私は Eclipse 3.4 を使用しており、 [コメント] タブのすべてのオプションを有効にして Java コード フォーマッタを構成しました。問題は、次を含むドキュメント コメントをフォーマットするときです。

コード フォーマッタは HTML の終わりにスペースを挿入し、それを分割します。

なんで？これを止めるにはどうすればよいですか？

[ HTML タグの書式設定] などの [コメント] タブのオプションを無効にしても、これは修正されません。私が見つけた唯一の回避策は、 Javadoc コメントの書式設定を有効にするオプションとブロック コメントの書式設定を有効にするオプションの両方を無効にして、Javadoc 書式設定を完全に無効にすることです。つまり、コメント ブロックを手動で書式設定する必要があります。

今、私のアリの仕事は次のようになります。

そして、私はこの警告を受けています：

javadoc を API に適切にリンクするにはどうすればよいですか? 私はプロキシの背後にいます。

デフォルトのIntelliJデフォルトクラスのjavadocコメントが非標準の構文を使用するのはなぜですか？「User：jstauffer」で行を作成する代わりに、「@authorjstauffer」で行を作成できます。作成される他の行（日付と時刻）には、使用するjavadoc構文がない可能性がありますが、使用可能な場合はjavadoc構文を使用しないのはなぜですか？

参考までに、ここに例を示します。

JavaDocs を読むためにどのツールや Web サイトを使用していますか?

私は現在、J2EE プロジェクトに取り組んでいるときに 20 個以上のタブを開いた状態で Firefox を使用しています。

このようなツール/ウェブサイトに期待すること:

• さまざまな場所から JavaDoc を集約する
• Eclipse の Ctrl+T などのタイプへの直接アクセス
• 全文検索
• 選択したすべての Java ライブラリ間の相互参照
• ツールの場合: オフライン サポート
• スピード

必須ではありません:

• 物事に注釈を付ける可能性
• ライブラリの異なるバージョンのサポート (+ diffing ?)
• IDE 統合

編集：

回答ありがとうございます。ほとんどのサイトは知っていましたが、もう一度試してみました。ここに私の判断があります：

• 組み込みの Eclipse/IDE 機能
  • 緊密に統合された
  • オフライン/オンライン サポート
• javadoconline.com (もはや維持されていません)
  • 作品
  • きれいなルックス
  • API の複数のバージョンで一致を検出し、簡単に切り替えることができます
  • シンプルだが機能する
  • 速い
• jdocs (オフライン)
  • とても洗練されているようです
  • 時々遅い
  • 一部の最近のバージョンのライブラリが見つからないようです (Seam 2.0.0、Hibernate Validators) が、自分で追加できるようです。
  • IDE 統合 (未テスト)
  • 各項目への wiki 形式のコメント
• docjar.com
  • 作品
  • 速い
  • 雑然とした UI
• javadoc_isearch
  • javadoc のナビゲートを容易にする firefox 用のグリースモンキー スクリプト
  • スムーズかつ完璧に動作します

j2ee クラスまたは IDEA の注釈でドキュメントのクイック検索 (Ctrl+Q) を使用すると、空の javadoc しか表示されません。クラス名などの基本のみが含まれています。

IDEA が提供するライブラリに javadoc を追加するにはどうすればよいですか?

NetBeans 6.1 エディタはコメントをラップするのを好まないようで、コード フォーマッタはコメントを無視するようです。JavaDoc コメントの場合、手動で段落をリフローするために多くの無駄な時間を費やすことになる可能性があるため、この動作は不適切に思えます。

組み込みのコードフォーマッタを取得するための魔法の設定や、javadocコメントをラップ/リフローするためのエディタがあるかどうか疑問に思っていましたか?

コードに javaDoc コメントを追加し、返す XML ドキュメントの構造を概説している場合、属性を表す最良の方法は何ですか? これに対するベストプラクティスはありますか?

私の javaDoc コメントの一般的な構造は次のようになります。