使用した場合のものです。]引数を指定する順序は任意です。.javaファイルを決定する方法の詳細については、「ソースファイルの処理」を参照してください。このドキュメントで説明されているコマンド行オプションです。オプションの標準的な使用法については、「使用例」を参照してください。スペースで区切られた一連のパッケージ名です。java.awtのように指定します。ドキュメント化するパッケージを個別に指定する必要があります。ワイルドカードは使用できません。ツールは、-sourcepathを使ってこれらのパッケージ名を検索します。「1つ以上のパッケージのドキュメント化」の例を参照してください。スペースで区切られた一連のソースファイル名です。各ファイルは、パスで始まります。(*)などのワイルドカードを含めることができます。(「Identifiers」を参照)。)や、その他の無効な文字を含む名前を付けることによって、それらのファイルをドキュメント化の対象から除外できます。これは、テスト用ファイルとテンプレートファイルに便利です。そのファイルを検索する場所が決まります。-sourcepathは使いません。相対パスはカレントディレクトリを起点とします。渡すことは、./Button.javaを渡すことと同じです。ソースファイル名を絶対パスとワイルドカードで指定すると、/home/src/java/awt/Graphics*.javaのようになります。以上のクラスのドキュメント化」の例を参照してください。「パッケージとクラスのドキュメント化」の例のように、パッケージ名とソースファイル名を混在させることもできます。pkg1:pkg2:...ソースファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。パッケージ名またはソースファイル名を指定する必要はありません。1つ以上のファイルです。オプションは指定できません。Interface)ドキュメントまたは一連のソースファイルの実装ドキュメントを生成できます。ツールは、パッケージ全体、個々のソースファイル、またはその両方に対して実行できます。パッケージ全体をドキュメント化する場合は、-subpackagesを使用して最上位ディレクトリから再帰的に処理していくか、パッケージ名の明示的なリストを渡します。ファイル名のリストを渡します。具体的な例は、このドキュメントの最後に紹介します。よるソースファイルの処理について説明します。付いたファイル以外に、ソースファイルで説明する他のファイルも処理します。ツールを実行する場合、.javaファイルを処理するかを正確に指定できます。多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。つの方法で実行できます。(*.java)という方法です。ツールは、.javaファイルが次のすべての要件を満たしている場合にかぎり、このファイルを処理します。Javadocツールは、処理の実行中に、その実行でドキュメント化されるパッケージ、クラス、およびメンバの名前に対して、自動的に相互参照リンクを追加します。このようなリンクは、次のような場所に追加されます。-linkofflineオプションを利用できます。つの完全なドキュメントを作成します。ドキュメントを追加生成することはできません。Javadocツールの以前の実行結果を修正したり、その内容を直接組み入れたりすることはできません。前述のように、以前の実行結果に対してリンクを追加することはできます。コンパイラを必要とし、javaコンパイラに依存しています。javacの一部を呼び出すことにより、宣言をコンパイルし、メンバの実装は無視します。Javadocツールは、ソースコードのドキュメンテーションコメントから、ユーザの提供したドキュメントも取得します。.javaソースファイルに対しても、実行することができます。ツールを実行できます。コンパイラに依存することによって、HTML出力は、実際の実装に正確に対応します。実際の実装は、明示的なソースコードにではなく、暗黙のソースコードに依存する場合があります。ドキュメント化します。通常、Javadocツールでは、ソースファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。このため、デバッグやトラブルシューティングを完了する前にドキュメントを生成できます。Java言語仕様によると、抽象メソッドを含むクラスは、それ自体抽象として宣言されなければなりません。ツールは警告を出さずに処理を続行します。Javadocツールはドキュメンテーションコメントの基本的なチェックを行います。ドックレットを使用してください。ツールは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、Javadocツールは、ブートストラップクラス、拡張機能、またはユーザクラスにかかわらず、すべての参照クラスを検索できなければなりません。詳細は、「クラスの検索方法」を参照してください。ツールのクラスパス内に置く必要があります。ツールの出力の内容と形式は、ドックレットを使ってカスタマイズできます。Javadocツールには、標準ドックレットと呼ばれるデフォルトの「組み込み」ドックレットがあります。APIドキュメントを生成します。標準ドックレットを修正またはサブクラス化することや、HTML、XML、MIF、RTFなどの好みの出力形式を生成する独自のドックレットを記述することも可能です。ドックレットとその使用法については、次の項目を参照してください。コマンド行オプションでカスタムドックレットが指定されていない場合、Javadocツールは、デフォルトの標準ドックレットを使用します。javadocツールには、使用されているドックレットに関係なく使用できるコマンド行オプションがあります。標準ドックレットでは、これらのほかに、いくつかのコマンド行オプションが追加されます。どちらのオプションについても、このあとの「オプション」で説明します。API仕様を記述する場合にも、その他の形式で記述する場合にも役立ちます。検証可能なアサーションを満たすパッケージ、クラス、インタフェース、フィールド、およびメソッドについての要件を定めています。Comments」を参照してください。版では削除されました。ソースファイル内のドキュメンテーションコメントをチェックし、検出されたエラーや不正のレポートを生成します。Checkユーティリティの一部です。ドキュメントを自動生成します。FrameMakerの交換書式です。タグ」、「ブロックタグ」、および「インラインタグ」の用語については、「ドキュメンテーションコメント」で説明します。ツールのコンテキストで特定の意味を持ちます。Javaソースコード内のドキュメンテーションコメントから生成したドキュメントのことです。HTML形式で、標準ドックレットによって作成されます。Java言語で書かれたプログラム要素の名前、つまりパッケージ、クラス、インタフェース、フィールド、コンストラクタ、またはメソッドの名前のことです。ように完全修飾することも、equals(Object)のように部分修飾することもできます。javadocツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。コマンドに渡す必要があります。よるフィルタで除外されないようにする必要があります。ドキュメント化されるクラスは、javadocツールの出力に組み込まれるクラス、つまり「包含クラス」とも呼ばれます。Javadocツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。「ドキュメント化されるクラス」と同じです。ツールの実行によって詳細なドキュメントが生成されないクラスおよびインタフェースのことです。(実装)またはドキュメンテーションコメントの中で明示的に参照されているクラスおよびインタフェースのことです。1.3から変更されています。ツールを実行するときは、Javadocのブートクラスパスおよびクラスパス内にあるすべての参照クラスをメモリにロードする必要があります。参照クラスが見つからない場合は、「クラスが見つかりません」という警告が表示されます。ファイルから引き出すことができます。参照クラスのうち、javadocツールの実行中にドキュメントが生成されないクラスのことです。Javadocツールに渡されていません。生成ドキュメント内でこれらのクラスにリンクしている箇所は、「外部参照」または「外部リンク」と呼ばれます。java.lang内のすべてのクラスが外部参照クラスになります。-linkofflineオプションを使用します。javadocツールの実行で利用できないという重要な特徴があります。承することはできません。種類の異なるソースファイルから出力結果を生成します。(.java)、パッケージコメントファイル、概要コメントファイル、およびその他の処理されないファイルです。この節では、ソースツリーに置かれたテスト用ファイルとテンプレートファイルも扱っていますが、これはドキュメント化する必要はありません。.javaファイル内に保持します。ドキュメンテーションコメントの詳細は、「ドキュメンテーションコメント」を参照してください。パッケージコメントファイルそれぞれのパッケージは、独自のドキュメンテーションコメントを持つことができ、それを専用の「ソース」ファイルに保持します。その内容は、Javadocツールによって生成される概要ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。して、.javaファイルとともにソースツリー内のパッケージディレクトリに置く必要があります。Javadocツールは、この場所にあるこのファイル名を自動的に検索します。ファイル名は、どのパッケージについても同じです。例を参照してください。1つの大きなドキュメンテーションコメントです。*/、および行頭のアスタリスクを含めてはならない、ということです。コメントを書く場合は、最初の文をパッケージの概要とし、<body>と最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージタグを含めることはできますが、ほかのドキュメンテーションコメントと同様、{@link}以外のすべてのタグは、説明のあとに置かなければなりません。@seeタグを追加する場合は、完全指定の名前を使用する必要があります。ツールは、実行時にこのファイルを自動的に検索し、このファイルを見つけると次の処理を行います。パッケージの概要ページの先頭に、パッケージコメントの最初の文をコピーする。概要コメントファイルドキュメント化する各アプリケーションまたはパッケージセットは、独自の概要ドキュメンテーションコメントを持つことができ、それは専用の「ソース」ファイルに保持されます。その内容は、Javadocツールによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージセット全体に当てはまるドキュメントを記述します。概要コメントファイルを作成する場合は、ファイルに任意の名前を付け、任意の場所に置くことができます。overview.htmlにして、ソースツリーの最上位レベルに置きます。1つのソースファイルのセットに対して複数の概要コメントファイルを作成できます。/home/user/src/java/appletディレクトリに含まれている場合は、/home/user/src/overview.htmlに概要コメントファイルを作成できます。1つの大きなドキュメンテーションコメントです。詳細は、前述の説明を参照してください。要点を繰り返すと、このコメントを記述する場合は、最初の文をアプリケーションまたはパッケージセットの要約とし、<body>と最初の文の間にタイトルその他のテキストを含めないようにします。)以外のすべてのタグは、主説明のあとに置く必要があります。@seeタグを追加する場合は、完全指定の名前を使用しなければなりません。ツールの実行時に、-overviewオプションを使って概要コメントファイル名を指定します。このファイルは、パッケージコメントファイルと同じように処理されます。その他の未処理のファイルソースには、Javadocツールによって生成先のディレクトリにコピーされる、その他の任意のファイルを含めることができます。ファイルなどがあります。doc-filesというディレクトリに置きます。このディレクトリは、ソースファイルがある任意のパッケージディレクトリの下に作成できます。HTMLファイルをこのディレクトリに格納できます。/home/user/src/java/awt/doc-files/ディレクトリに置きます。/home/user/src/java/doc-filesに置くことはできません。これは、javaはパッケージではなく、そのディレクトリそのものにソースファイルが入っていないからです。これらの未処理のファイルへのリンクは、すべて明示的に記述する必要があります。これは、Javadocツールがそれらのファイルを見ずに、単にディレクトリとその内容を生成先にコピーするだけだからです。Button.javaのドキュメンテーションコメント内のリンクは、次のようになります。*/テスト用ファイルとテンプレートファイル開発者によっては、テスト用ファイルとテンプレートファイルを、対応するソースファイルに近いソースツリーに格納しようと考える場合があります。テスト用ファイルとテンプレートファイルをソースファイルと同じディレクトリまたはサブディレクトリに置くことになります。Javadocツールを実行する場合、テスト用およびテンプレートファイルを慎重に除外して、これらのファイルの処理を回避できます。パッケージ名またはワイルドカードを渡す場合は、特定のルールに従って、テスト用ファイルとテンプレートファイルの処理を確実に回避する必要があります。テスト用ファイルとテンプレートファイルとは、テスト用ファイルが有効でコンパイル可能なソースファイルであるのに対し、テンプレートファイルはそうではなく末尾に「.java」が付けられている点で異なっています。-開発者は、所定のパッケージ用のコンパイルおよび実行可能なテスト用ファイルを、そのパッケージのソースファイルと「同じ」ディレクトリに置きたいと考える場合があります。(名前のないパッケージなど)にテスト用ファイルを所属させたいと考えることもあります。このため、テスト用ファイルにはパッケージ文がなかったり、ソースとは異なるパッケージ文が含まれたりします。この場合、コマンド行で指定したパッケージ名を指定してソースをドキュメント化しているときに、テスト用ファイルによって警告やエラーが発生します。このようなテスト用ファイルは、サブディレクトリに置く必要があります。com.package1のソースファイル用のテスト用ファイルを追加する場合、次のようにハイフンを含んだ無効なパッケージ名のサブディレクトリに、これらのテスト用ファイルを置きます。ツールはテスト用ディレクトリをスキップし、警告は発生しません。ツールをもう一度実行してテスト用ファイルのドキュメントを生成するように設定できます。-テンプレートファイルは、たいてい末尾が「.java」である名前が付けられ、コンパイル可能ではありません。文字を含んだ名前を、テンプレートに付けることによって、テンプレートの処理を回避できます。これは、Javadocツールが、「.java」の接尾辞を取り除くと実際に有効なクラス名になる名前のソースファイル以外を処理しないためです。「identifiers」を参照してください。ツールは、HTML形式のドキュメントを生成する標準ドックレットを使います。このドックレットは、以下の種類のファイルを生成します。HTMLページは、個々のファイルに相当します。後者のグループのファイル名には、前者のグループとファイル名が競合しないように、ハイフンが含まれています。(package-summary.html)。テキストをこのページに組み入れます。(overview-summary.html)。これは、生成ドキュメントの先頭ページになります。テキストをこのページに組み入れます。このページのファイルは、javadocに複数のパッケージ名を渡した場合にだけ作成されます。フレーム」を参照してください。(overview-tree.html)。このページを表示するには、ナビゲーションバーの「概要」をクリックしてから、「階層ツリー」をクリックします。(package-tree.html)。特定のパッケージ、クラス、またはインタフェースのページを表示してから、「階層ツリー」をクリックすると、そのパッケージのクラス階層が表示されます。(class-use/classname.html)。このページには、特定のクラス、インタフェース、またはパッケージの一部を使っているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドについて記述されます。返すメソッド、A型のパラメータを持つメソッドおよびコンストラクタが表示されます。このページを表示するには、まず、パッケージ、クラス、またはインタフェースのページに移動してから、ナビゲーションバーの「使用」リンクをクリックします。(deprecated-list.html)。推奨されないすべての名前が一覧表示されます。APIの名前であり、通常、それに置き換わる名前が提示されています。将来の実装では削除される可能性があります。(constant-values.html)。staticフィールドの値用です。(serialized-form.html)。部化可能なクラスです。これらの各クラスには、直列化フィールドおよびメソッドに関する説明があります。これらの情報は、APIを使う開発者ではなく、再実装を行う開発者に必要な情報です。ナビゲーションバーにこのページへのリンクはありませんが、直列化されたクラスに移動して、そのクラスのコメントにある「関連項目」セクションで「直列化された形式」をクリックすると、この情報を取得できます。標準ドックレットは、直列化された形式のページを自動的に生成します。タグ、@serialDataタグからのドキュメンテーションコメントが組み込まれています。excludeタグで指定します。クラスの完全に直列化されたクラスを生成できます。(index-*.html)。すべてのクラス名、インタフェース名、コンストラクタ名、フィールド名、およびメソッド名が、アルファベット順に並んでいます。扱えるように国際化されています。ごとに別々のファイルとして生成することもできます。(help-doc.html)。ナビゲーションバーや前述の各ページに関する説明が記載されています。-helpfileを使うと、デフォルトのヘルプファイルに代わる独自のカスタムヘルプファイルを提供することもできます。このファイルは、フレーム付きの先頭ページを表示する場合にロードします。このファイル自体には、テキスト内容は含まれていません。(*-frame.html)。パッケージ、クラス、およびインタフェースのリストが含まれています。フレームを表示するときに使用されます。(package-list)。オプションで使用されます。これは、HTMLファイルではなくテキストファイルであり、どのリンクからもアクセスできません。(stylesheet.css)。生成されるページ上のいくつかの要素について、色、フォントファミリ、フォントサイズ、フォントのスタイル、および配置を制御します。doc-filesディレクトリ。生成先ディレクトリにコピーするイメージ、サンプルコード、ソースコードなどのファイルがすべて格納されます。javadocタグがあっても無視されます。このディレクトリは、ソースツリーの中にある場合にのみ生成されます。フレームを生成します。1つだけまたはパッケージがない場合には、パッケージのリストを省略することによって、最低限必要な数のフレームを作成します。(P)が作成されます。この概要ページのファイル名は、overview-summary.htmlです。したがって、このファイルは、2つ以上のパッケージ名を渡した場合にだけ作成されます。「フレームなし」リンクをクリックするか、overview-summary.htmlを最初に表示すると、フレームを省略できます。HTMLフレームに慣れていない場合は、特定のフレームを印刷およびスクロールするには、そのフレームに「フォーカス」がなければならないことに注意してください。フレームにフォーカスを与えるには、そのフレームをクリックします。このようにすると、多くのブラウザでは、矢印キーやページキーを使ってそのフレームをスクロールしたり、「印刷」メニューコマンドを使ってそのフレームを印刷したりできます。フレームが必要かどうかによって、次のどちらかのファイルを開始ページとしてロードします。生成されるクラスファイルおよびインタフェースファイルは、Javaソースファイルおよびクラスファイルと同じディレクトリ階層に編成されます。1つのディレクトリ、という構造になります。クラスに対して生成されるドキュメントは、java/applet/Applet.htmlに格納されます。すると、java.appletパッケージのファイル構造は、その下に構築されます。ファイルは、すべて右側のフレームに表示されます。(*.java)である場合に省略されるファイルおよびディレクトリを示しています。引数がソースファイル名の場合は、package-listは作成されますが、内容は空です。ディレクトリは、ソースツリー内に存在する場合にのみ、生成先に作成されます。全パッケージのリスト。全パッケージのリスト。全パッケージの全クラスのリスト。パッケージ名のリスト。このパッケージのクラスのリスト。このパッケージのクラスのリスト。API項目について、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの説明の最初に、宣言を生成します。Booleanクラスの宣言は、次のようになります。メソッドの宣言は、次のようになります。nativeを組み込むことができません。仕様には含まれません。synchronizedに依存するのではなく、コメントによる主説明としてドキュメント化する必要があります。Enumerationを複数のスレッドから並行して使用することはできない」などのコメントを記述します。ドキュメントには、これらのセマンティクスを実現する方法を記述するべきではありません。Hashtableはスレッドに対して安全である必要がありますが、「エクスポートされるすべてのメソッドを同期化すればそれを実現できる」のようには指定する根拠はありません。バケットレベルで内部的に同期化する権利を残しておく必要があります。すれば、より高度な並行性が提供されます。ドキュメンテーションコメントオリジナルの「ドキュメンテーションコメントの仕様」は、「関連項目」を参照してください。記述することができます。各パッケージにドキュメンテーションコメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーションコメントを作成できます。ドキュメンテーションコメントは、非公式に「Javadocコメント」とも呼ばれています。これは商標の侵害に当たります。間にある文字で構成されます。行の先頭のアスタリスクは、各行に記述できます。詳細は、以下で説明します。コメントのテキストは、複数行にわたって記述できます。行に記述すると、スペースを節約できます。-ドキュメンテーションコメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの宣言の直前に置かれているときにだけ認識されます。クラスの例、メソッドの例、およびフィールドの例を参照してください。メソッドの本体に置かれているドキュメンテーションコメントは無視されます。つのドキュメンテーションコメントだけが認識されます。import文を置いてしまうことです。このような記述はしないでください。このようなクラスコメントは無視されます。/**の後ろからタグセクションまでが、主説明になります。タグセクションは、最初のブロックタグから始まります。@文字で指定されます。主説明を記述せず、タグセクションだけのコメントを記述することもできます。主説明は、タグセクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1回しか記述できないタグがあります。タグセクションが始まります。「タグ」は、Javadocツールが処理できる、ドキュメンテーションコメント内の特別なキーワードです。種類のタグがあります。{@tag}のように中括弧で囲んで記述します。(/**)を除いて、行の先頭に置かなければなりません。@文字を使用しても、タグの開始としては解釈されないことを意味しています。&#064;を使用してください。それぞれのブロックタグには、対応付けられたテキストがあります。(タグやコメント区切り文字を除く)です。この関連テキストは複数行にわたって記述できます。インラインタグは、テキストを記述できる場所であればどこにでも置くことができ、正しく解釈されます。{@link}が含まれています。形式で記述しなければなりません。タグを使用できることを意味します。HTMLのバージョンとしては、使用するブラウザがサポートする任意のバージョンを使用できます。3.2に準拠したコードを生成するように作成されています。フレームセット対応のため、生成される各ファイルには「HTML4.0」と記述されます。して記述する必要があります。記述する必要があります。<b>を使っています。次に、ドキュメンテーションコメントを示します。(*)をすべて破棄します。前の空白とタブも破棄します。1.4からは、行の先頭のアスタリスクを省略しても、先頭の空白文字は削除されなくなりました。<PRE>タグ内にペーストしても、インデントが保持されます。通常、ブラウザは、空白文字をタブよりも一律に解釈します。タグよりも左寄りになります。-各ドキュメンテーションコメントの最初の文は、宣言されているエンティティに関する簡潔かつ完全な要約文である必要があります。(ロケールが英語に設定されている場合)、または最初のブロックタグがある位置で終わります。HTMLページの最初にあるメンバの概要の部分にコピーされます。つの文で複数のフィールドを宣言できます。この文には、1つのドキュメンテーションコメントしか記述できません。そのコメントが、すべてのフィールドに対してコピーされます。したがって、フィールドごとにドキュメンテーションコメントを記述する必要がある場合は、各フィールドを別々の文で宣言しなければなりません。つの宣言として記述すると不適切です。つに分けることをお勧めします。上記のコードからは、次のようなドキュメントが生成されます。見出しタグは、なるべく使わないでください。Javadocツールは、完全に構造化されたドキュメントを作成するので、このような構造化タグが使われていると、生成ドキュメントの形式が悪影響を受けることがあります。クラスやパッケージのコメントでは、これらの見出しタグを使って独自の構造を組み立ててかまいません。2つの場合に、クラスおよびインタフェースのメソッドコメントをコピーまたは「継承」する機能があります。コンストラクタ、フィールド、および入れ子のクラスは、ドキュメンテーションコメントを継承しません。主説明または、@return、@param、@throwsタグが、メソッドコメントで見つからないる場合、Javadocツールは、オーバーライドしたメソッドまたは実装している場合はそのメソッドから、対応する主説明およびタグコメントを、次のアルゴリズムに従ってコピーします。@paramタグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。タグがコピーされます。1.3以前の動作とは対照的です。これまでのバージョンでは、主説明またはタグが存在すれば、コメントは一切継承されませんでした。@return、@param、@throwsタグコメントに挿入します。継承した対応する主説明またはタグコメントは、その箇所にコピーされます。-sourcepathで指定したパスだけに置かれていることが必要になります。コマンド行で、クラスもパッケージも渡す必要はありません。1.3.x以前のリリースと異なります。3つの場合に、コメントの継承が行われます。Javadocツールは、コメントが継承されているかどうかにかかわらず、オーバーライドしているメソッドのドキュメント内に「オーバーライド」という小見出しを生成し、オーバーライドされているメソッドへのリンクを書き込みます。Javadocツールは、実装しているメソッドのドキュメント内に「定義」という小見出しを生成し、実装されているメソッドへのリンクを書き込みます。これは、コメントが継承されているかどうかにかかわらず行われます。{@inheritDoc}タグが記述されている場合、Javadocツールは、次のようなアルゴリズムを使用して適切なコメントを検索します。このアルゴリズムは、もっとも適切なドキュメンテーションコメントを検索できるように設計されており、スーパークラスよりもインタフェースが優先されるようになっています。キーワードのあとに登場する順序で、1つずつ調べる。ツールは、Javaのドキュメンテーションコメント内に埋め込まれた特別なタグを解析します。APIドキュメントをソースコードから自動的に生成できます。(@)で始まり、大文字と小文字が区別されます。これらのタグは、定められたとおりの大文字と小文字を使用して記述する必要があります。置かなければなりません。1か所にまとめて記述するようにします。1か所にまとめて記述します。つのタイプがあります。主説明に続くタグセクション内にのみ記述可能。主説明内またはブロックタグのコメント内に記述可能。Tags」を参照してください。現時点で有効なタグは、次のとおりです。オプションを参照してください。name-textを書き込みます。タグを含めることができます。つの名前を指定することも、1つのタグに複数の名前を指定することもできます。(,)とスペースが挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。つのタグに複数の名前を指定できます。@authorタグのドキュメントを参照してください。使用するべきではないことを示すコメントを追加します。ツールは、deprecated-textを主説明の前に移動してイタリックにし、その前に警告文としてボールドの「推奨されない」を追加します。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。読者に提示する必要があります。Javadocツールは、この最初の文だけを、概要セクションと索引にコピーします。APIが推奨されない理由を説明することもできます。含める必要があります。次のように記述します。詳細については、@deprecatedタグのドキュメントを参照してください。以降では、{@link}タグを使用します。これにより、必要な場所にインラインでリンクを作成できます。記述するのが標準の形式です。推奨されないタグについての詳細は、@deprecatedタグのドキュメントを参照してください。