問題タブ [javadoc]

私はホワイトペーパーを書いていますが、定義の宣言の前にコメントブロックとして配置する内部ドキュメントの種類の正式な用語が何であるかわからないことに気付きました。

最終的にJavaDocメンバーのドキュメントになるのと同じこと。

これは単なる内部ドキュメントではなく、「ヘッダードキュメント」が適切な用語であるかどうかはわかりません。

特定の言語（Java / Perlなど）に固有の用語ではなく、一般的な用語を探していることに注意してください。

私は年をとって怠け者になりました。私の C# 作業では、Roland Weigelt の優れたVisual Studio 用のGhostDocプラグインにかなり依存するようになりました。

IntelliJ IDEA で動作する Java 用の同様のプラグインを知っている人はいますか?

私は checkstyle を使ってコードを分析しています。有用なルールは、パッケージに Javadoc の説明が含まれているかどうかをチェックする PackageHtml です。ただし、新しい Java バージョンでは、package.html の代わりに package-info.java を使用することをお勧めします。問題は、checkstyle が package-info.java を無視し、ルール違反を報告することです。package-documentation をチェックし、package.htmlとpackage-info.javaを受け入れるように checkstyle を構成するにはどうすればよいですか?

自分のプロジェクトで Java の列挙型を使い始めたばかりで (仕事で JDK 1.4 を使用する必要があります)、列挙型に JavaDoc を使用するベスト プラクティスについて混乱しています。

この方法は機能することがわかりましたが、結果のコードは少し洗練されていません。

列挙型宣言をコンマで連鎖せずに独自の行で分割する方法はありますか、またはこれが列挙型に JavaDoc を使用するための最良の方法ですか?

すべてのJavaメソッドのドキュメントコメントを書く必要がありますか？

たとえば、C# または JavaScript ドキュメントで。
そうでない場合、ASP.NET プログラミングでJavadocコメントを使用する意味はありますか?

NetBeans IDE を初めて使用します。たとえば、Java API (Systemクラスなど) のドキュメントを見ようとすると、javadoc がインストールされていないと表示されます。ドキュメントのインストール方法を教えてください。

Delphi コード用の javadoc または c# xml doc に似たコード ドキュメント ツールが必要です。最適なツールは何ですか? 私は、Microsoft のサンドキャッスル プロジェクトと将来的に互換性のあるテクノロジを好みます。

メソッドやクラスなどを文書化するときに、いくつかのパラメーターや例外スロー (またはその他のもの) を誤って説明するのを忘れる場合があります。

欠落しているドキュメント項目について警告するように javadoc を実行することは可能ですか?

(ドキュメントの生成には ant スクリプトを使用します)

クラスのメソッドを javadoc にグループ化したいと考えています。例えば：

javadocでこれを達成する方法を知っていますか? これを行うために利用できるドックレットはありますか?

ありがとう、カルム