名前
javadoc - Javaソース・ファイルからのAPIドキュメントのHTMLページの生成
シノプシス
javadoc
[options] [packagenames] [sourcefiles] [@
files]
- options
- 空白で区切られたコマンド行オプションを指定します。 javadocのオプション、拡張オプション、標準ドックレットのオプションおよび標準ドックレットが提供する追加オプションを参照してください。
- packagenames
ドキュメント化するパッケージの名前をスペースで区切って指定します(例:
java.lang java.lang.reflect java.awt
)。 サブパッケージもドキュメント化する場合は、-subpackages
オプションを使用してパッケージを指定します。デフォルトでは、
javadoc
は指定されたパッケージを現在のディレクトリおよびそのサブディレクトリで検索します。 パッケージを検索するディレクトリのリストを指定するには、-sourcepath
オプションを使用します。- sourcefiles
- ドキュメント化するJavaソース・ファイルの名前を空白で区切って指定します(例:
Class.java Object.java Button.java
)。 デフォルトでは、javadoc
は指定されたクラスを現在のディレクトリで検索します。 ただし、クラス・ファイルのフル・パスを指定し、ワイルドカード文字を使用することができます。たとえば、/home/src/java/awt/Graphics*.java
のように指定します。 現在のディレクトリからの相対パスを指定することもできます。 @
filesjavadoc
ツール・オプション、パッケージ名、およびソース・ファイル名のリストを任意の順序で含むファイルの名前を指定します。
説明
javadoc
ツールは、Javaソース・ファイルのセット内の宣言およびドキュメント・コメントを解析し、(デフォルトで)のpublicクラスおよびprotectedクラス、ネストされたクラス(匿名の内部クラスではありません)、インタフェース、コンストラクタ、メソッドおよびフィールドを記述する対応するHTMLページを生成します。 javadoc
ツールを使用して、一連のソース・ファイルのAPIドキュメントまたは実装ドキュメントを生成できます。
javadoc
ツールは、パッケージ全体、個々のソース・ファイル、またはその両方に対して実行できます。 パッケージ全体をドキュメント化する場合、-subpackages
オプションを使用すると、ディレクトリとそのサブディレクトリを再帰的にトラバースしたり、パッケージ名の明示的なリストを渡したりできます。 個々のソース・ファイルをドキュメント化する場合は、Javaソース・ファイル名のリストを渡します。 javadoc
ツールの使用方法の詳細は、Java Platform, Standard Edition Javadocガイドの「javadocの概要」を参照してください。
適合性
標準ドックレットではドキュメンテーション・コメントの内容の適合性が検証されることはなく、ドキュメンテーション・コメントのエラーを修正しようとすることもありません。 javadocを実行するユーザーは、整合性のない出力やJavaScriptなどの実行可能コンテンツを含む出力を生成する際に生じる可能性のある問題について認識しておく必要があります。 標準ドックレットには、開発者がドキュメント・コメントで一般的な問題を検出できるようにdoclint
機能が用意されていますが、生成された出力を適切な適合およびその他のチェック・ツールでチェックすることもお薦めします。
HTML5ドキュメントの適合性要件の詳細は、HTML5仕様のConformance requirementsを参照してください。 Webページに関連したセキュリティ問題の詳細は、Open Web Application Security Project (OWASP)のページを参照してください。
javadocのオプション
次のコアjavadoc
オプションは、対応するjavac
オプションと同等です。 これらのオプションの使用方法の詳細は、javacの「標準オプション」を参照してください:
--add-modules
-bootclasspath
--class-path
、-classpath
または-cp
--enable-preview
-encoding
-extdirs
--limit-modules
--module
--module-path
または-p
--module-source-path
--release
--source
または-source
--source-path
または-sourcepath
--system
--upgrade-module-path
次のオプションは、対応するjavac
オプションと等しくないコアjavadoc
オプションです:
ノート:
--
スタイル・オプションをサポートするツールでは、GNUスタイル・オプションでは、空白のかわりに等号(=)を使用して、オプションの名前をその値から分離できます。
-breakiterator
BreakIterator
を使用して最初の文を計算します。 最初の文は、パッケージ、クラス、またはメンバーのサマリーにコピーされ、アルファベット順のインデックスにコピーされます。BreakIterator
クラスは、英語を除くすべての言語の文の終了を決定するために使用されます。英語のデフォルトの文-オンライン・アルゴリズム---ピリオドに停止し、その後に空白またはHTMLブロック・タグを付加します(例:
<P>
)。Breakiterator文ブレーク・アルゴリズム --- 次の単語が大文字で始まるときに、ピリオド、疑問符、または感嘆符が後に続くスペースで停止します。 このアルゴリズムでは、ほとんどの省略表記が処理されます(「The serial no. is valid」は処理されるが「Mr. Smith」は処理されない)。
-breakiterator
オプションは、数値または記号で始まるHTMLタグや文では停止しません。 アルゴリズムは、HTMLタグに埋め込まれている場合でも、../filename
の最後のピリオドで停止します。
-doclet
class- 代替ドックレットを使用して出力を生成します。 完全修飾名を使用してください。 このドックレットにより、出力の内容と形式が定義されます。
-doclet
オプションを使用しない場合、javadoc
ツールは標準ドックレットを使用してデフォルトのHTML形式を生成します。 このクラスには、start(Root)
メソッドが含まれていなければなりません。 この起動クラスへのパスは、-docletpath
オプションによって定義されます。 -docletpath
path- ドックレット・クラス・ファイル(
-doclet
オプションで指定した)および依存するすべてのJARファイルを検索する場所を指定します。 開始クラス・ファイルがJARファイル内にある場合、このオプションではそのJARファイルへのパスが指定されます。 絶対パスまたは現在のディレクトリからの相対パスを指定できます。classpathlist
に複数のパスまたはJARファイルが含まれている場合は、Linuxではコロン(:
)、Windowsではセミコロン(;
)で区切る必要があります。doclet
開始クラスがすでに検索パスにある場合は、このオプションは必要ありません。 -exclude
pkglist-subpackages
で形成されるリストから、指定されたパッケージとそのサブパッケージを無条件に除外します。 過去の-subpackages
オプションの指定によって組み込まれたパッケージ、または将来組み込まれるパッケージも除外の対象となります。次の例では、
java.io
、java.util
、java.math
などは組み込まれますが、java.net
とjava.lang
以下のパッケージは除外されます。 これらの例では、java.lang
のサブパッケージであるjava.lang.ref
を除外しています。LinuxおよびOS X:
javadoc -sourcepath /home/user/src -subpackages java -exclude java.net:java.lang
Windows:
javadoc -sourcepath \user\src -subpackages java -exclude java.net:java.lang
--expand-requires
valuejavadocツールに、ドキュメント化するモジュールのセットを展開するように指示します。 デフォルトでは、コマンドラインで明示的に与えられたモジュールだけが文書化されています。 次の値をサポートします:
transitive
: さらに、これらのモジュールに必要なすべての推移的依存関係が含まれます。all
: すべての依存関係が含まれます。
--help
、-help
、-h
または-?
- 標準オプションのシノプシスを表示します。
--help-extra
または-X
- その他の一連のオプションのシノプシスを出力します。
-J
flagflagを、
javadoc
ツールを実行するJava Runtime Environment (JRE)に直接渡します。 たとえば、生成ドキュメントを処理するためにシステムで32Mバイトのメモリーを確保しておく必要がある場合は、-Xmx
オプションをjavadoc -J-Xmx32m -J-Xms32m com.mypackage
のように呼び出します。 ただし、-Xms
は初期メモリーのサイズを設定するだけなので、オプションです。これは、必要なメモリーの最小サイズがわかっている場合に便利です。J
とflag
の間には空白を入れません。-version
オプションを使用して、javadoc
ツールの実行に使用されているJREのバージョンを報告します。javadoc -J-version java version "10-ea" 2018-03-20 Java(TM) SE Runtime Environment 18.3 (build 10-ea+36) Java HotSpot(TM) 64-Bit Server VM 18.3 (build 10-ea+36, mixed mode)
-locale
namejavadoc
ツールがドキュメントを生成するときに使用するロケールを指定します。 この引数は、en_US
(英語、アメリカ合衆国)やen_US_WIN
(Windowsの変形)のように、java.util.Locale
ドキュメントで説明されているロケールの名前です。ノート:
-locale
オプションは、標準ドックレットまたはその他のドックレットで提供されるオプションの(左に)の前に配置する必要があります。 そうしないと、ナビゲーション・バーが英語で表示されます。 このコマンド行オプションだけは、指定する順序に依存します。ロケールを指定すると、
javadoc
ツールは、ナビゲーション・バーの文字列、リストと表の見出し、ヘルプ・ファイルの内容、stylesheet.css
ファイル内のコメントなど、メッセージに対してそのロケールのリソース・ファイルを選択します。 また、アルファベット順にソートされるリストのソート順、および最初の文の末尾を判別するための文の区切り文字も、指定したロケールによって決まります。-locale
オプションは、ドキュメント化されたクラスのソース・ファイルで指定されているドキュメントのコメント・テキストのロケールを決定しません。-package
- package、protected、およびpublicのクラスとメンバーだけを表示します。
-private
- すべてのクラスとメンバーを表示します。
-protected
- protectedおよびpublicのクラスとメンバーだけを表示します。 これはデフォルトです。
-public
- publicのクラスおよびメンバーのみを表示します。
-quiet
- メッセージを抑制し、警告とエラーだけが表示されるようにして、これらを特定しやすくします。
version
文字列も抑制します。 --show-members
value(フィールドまたはメソッド)をドキュメント化するメンバーを指定します。ここで、valueは次のいずれかになります:
protected
: デフォルト値はprotectedです。public
: public値のみを表示します。package
: public、protected、およびpackageメンバーを表示します。private
: すべてのメンバーを表示します。
--show-module-contents
value- モジュール宣言のドキュメント粒度を指定します。valueには、
api
またはall
を指定できます。 --show-packages
value- ドキュメント化するモジュール・パッケージを指定します。valueは、
exported
またはall
パッケージです。 --show-types
value(classes, interfaces, etc.)がドキュメント化されているタイプを指定します。valueは次のいずれかです:
protected
: デフォルト値。 公開型と保護型を示します。public
: public値のみを表示します。package
: public、protected、およびpackageタイプを表示します。private
: すべてのタイプを表示します。
-subpackages
subpkglistソース・ファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。 このオプションは、ソース・コードに新しいサブパッケージを追加する際に便利です。新しいサブパッケージは自動的に組み込まれます。 各パッケージ引数は、ソース・ファイルを含める必要がない最上位のサブパッケージ(such as
java
)または完全修飾パッケージ(javax.swing
など)です。 どのオペレーティング・システムでも、引数はコロンで区切られます。 ワイルドカードは使用できません。 パッケージの検索場所を指定するには、-sourcepath
を使用します。 このオプションは、ソース・ツリーにあるがパッケージには属していないソース・ファイルを処理しません。たとえば、次のコマンドは、
java
およびjavax.swing
という名前のパッケージおよびそのすべてのサブパッケージに関するドキュメントを生成します。LinuxおよびOS X:
javadoc -d docs -sourcepath /home/user/src -subpackages java:javax.swing
Windows:
javadoc -d docs -sourcepath \user\src -subpackages java:javax.swing
-verbose
javadoc
ツールの実行中に、より詳細なメッセージを提供します。-verbose
オプションを指定しない場合、ソース・ファイルのロード、ドキュメントの生成、(ソース・ファイルごとに1つのメッセージ)およびソートについてのメッセージが表示されます。-verbose
オプションを指定すると、各Javaソース・ファイルを解析するミリ秒数を指定する追加メッセージが出力されます。--version
- バージョン情報を出力します。
-Werror
- 警告が発生した場合にエラーを報告します。
拡張オプション
ノート:
javadoc
の拡張オプションは、予告なしに変更される可能性があります。
次の拡張javadoc
オプションは、対応するjavac
オプションと同等です。 これらのオプションの使用方法の詳細は、javacの「追加オプション」を参照してください:
--add-exports
--add-reads
--patch-module
-Xmaxerrs
-Xmaxwarns
標準ドックレット・オプション
次のオプションは、標準ドックレットによって提供されます。
--add-stylesheet
file生成されたドキュメントのスタイルシート・ファイルを追加します。 このオプションは、ドキュメントに含まれる追加のスタイルシートを指定するために、1回以上使用できます。
コマンド行の例:
javadoc --add-stylesheet new_stylesheet_1.css --add-stylesheet new_stylesheet_2.css pkg_foo
--allow-script-in-comments
- オプションおよびコメントでJavaScriptを許可します
-author
- 生成ドキュメントに、
@author
のテキストを組み込みます。 -bottom
html-code- 各出力ファイルの最下部に配置するテキストを指定します。 このテキストは、下部ナビゲーション・バーより下の、ページの最下部に配置されます。 テキストには、HTMLタグと空白を含めることができますが、これらを含める場合は、テキストを引用符で囲まなければなりません。 テキスト内の内部引用符には、エスケープ文字を使用してください。
-charset
nameこのドキュメント用のHTML文字セットを指定します。 名前は、「IANAレジストリ、文字セット」で指定された優先MIME名でなければなりません。
たとえば:
javadoc -charset "iso-8859-1" mypackage
このコマンドにより、生成されるすべてのページの先頭に次の行が挿入されます。
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
META
タグについては、「HTML標準(4197265および4137321)、HTMLドキュメント表現」で説明します。-d
directoryjavadoc
ツールによって生成されたHTMLファイルが保存される宛先ディレクトリを指定します。-d
オプションを省略すると、ファイルは現在のディレクトリに保存されます。directory
の値には、絶対ディレクトリ、または現在の作業ディレクトリからの相対ディレクトリを指定できます。 宛先ディレクトリは、javadoc
ツールの実行時に自動的に作成されます。LinuxおよびOS X: たとえば、次のコマンドでは、パッケージ
com.mypackage
のドキュメントが生成され、結果が/user/doc/
ディレクトリに保存されます:javadoc -d /user/doc/ com.mypackage
Windows: たとえば、次のコマンドでは、パッケージ
com.mypackage
のドキュメントが生成され、結果が\user\doc\
ディレクトリに保存されます:javadoc -d \user\doc\ com.mypackage
-docencoding
name生成されるHTMLファイルのエンコーディングを指定します。 名前は、「IANAレジストリ、文字セット」で指定された優先MIME名でなければなりません。
javadoc
エンコーディング・コマンドでは、3つのオプションを使用できます。-encoding
オプションは、javadoc
ツールによって読み取られるファイルのエンコーディングに使用されますが、-docencoding
および-charset
オプションは、ツールによって書き込まれるファイルのエンコーディングに使用されます。 使用可能な3つのオプションのうち、1つのエンコーディング・コマンドで使用できるのは、最大でも入力エンコーディング・オプションと1つの出力エンコーディング・オプションのみです。 入力エンコーディング・オプションと出力エンコーディング・オプションの両方を1つのコマンドで指定する場合は、それらを同じ値にする必要があります。 いずれの出力オプションも指定しなかった場合、ツールによってデフォルトで入力エンコーディングに設定されます。たとえば:
javadoc -docencoding "iso-8859-1" mypackage
-docfilessubdirs
doc-files
サブディレクトリを再帰的にコピーします。 doc-filesディレクトリの深いコピーを有効にします。 コピー先には、サブディレクトリとすべての内容が再帰的にコピーされます。 たとえば、ディレクトリdoc-files/example/images
とそのすべての内容がコピーされます。-excludedocfilessubdir
オプションを使用すると、特定のサブディレクトリを除外できます。-doctitle
html-code- 概要ファイルの最上部の近くに配置するタイトルを指定します。
title
タグに指定されたテキストは中央揃えになり、レベル1の見出しとして、上部ナビゲーション・バーのすぐ下に置かれます。title
タグには、HTMLタグと空白を含めることができますが、これらを含める場合は、タイトルを引用符で囲まなければなりません。title
タグ内に追加の引用符をエスケープする必要があります。 例:javadoc -doctitle "<b>My Library</b><br>v1.0" com.mypackage.
-excludedocfilessubdir
name1,name2doc-files
サブディレクトリを再帰的にコピーするときに、指定された名前のサブディレクトリをすべて除外します。-docfilessubdirs
を参照してください。 過去の理由から、:
は、,
ではなくセパレータとして引数の任意の場所で使用できます。-footer
html-code- 各出力ファイルの下端に配置するフッター・テキストを指定します。
html-code
値は、下部のナビゲーション・バーの右側に配置されます。html-code
値にはHTMLタグと空白を含めることができますが、使用する場合は、html-code
値を引用符で囲む必要があります。 フッター内の内部引用符には、エスケープ文字を使用してください。 -group
namep1:
p2- 概要ページで、指定したパッケージをグループ化します。
-header
html-code- 各出力ファイルの上端に配置するヘッダー・テキストを指定します。 ヘッダーは、上部ナビゲーション・バーの右側に配置されます。
header
には、HTMLタグと空白を含めることができますが、これらを含める場合は、header
を引用符で囲まなければなりません。 ヘッダー内の内部引用符には、エスケープ文字を使用してください。 例:javadoc -header "<b>My Library</b><br>v1.0" com.mypackage.
-helpfile
filename上部および下部のナビゲーション・バーの「ヘルプ」リンクのリンク先となるファイルを組み込みます。 このオプションを指定しない場合、
javadoc
ツールは、javadoc
ツールでハードコードされたヘルプ・ファイルhelp-doc.html
を作成します。 このオプションを使うと、そのデフォルトの動作をオーバーライドできます。 filenameには任意の名前を指定でき、help-doc.html
には制限されません。javadoc
ツールは、ナビゲーション・バー内のリンクを適宜調整します。 たとえば:LinuxおよびOS X:
javadoc -helpfile /home/user/myhelp.html java.awt.
Windows:
javadoc -helpfile C:\user\myhelp.html java.awt.
-html5
- このオプションはno-opで、下位互換性のために保持されています。
--javafx
または-javafx
- JavaFX機能を有効にします。
-keywords
各クラスの生成されたファイルにHTMLキーワード
<META>
タグを追加します。 これらのタグは、<META>
タグを検索する検索エンジンがページを見つけるのに役立ちます。 インターネット全体を検索するほとんどの検索エンジンは、<META>
タグを参照しません。ページが誤用される可能性があるためです。 検索を自社のwebサイトに絞り込む企業が提供する検索エンジンは、<META>
タグを見るとメリットがあります。<META>
タグには、クラスの完全修飾名、およびフィールドとメソッドの修飾されていない名前が含まれます。 コンストラクタは、クラス名と同じであるため含まれません。 たとえば、クラスString
は次のキーワードで開始します。<META NAME="keywords" CONTENT="java.lang.String class"> <META NAME="keywords" CONTENT="CASE_INSENSITIVE_ORDER"> <META NAME="keywords" CONTENT="length()"> <META NAME="keywords" CONTENT="charAt()">
-link
url外部参照クラスの既存の
javadoc
生成ドキュメントへのリンクを作成します。 url引数は、外部javadoc
で生成されたドキュメントを含むディレクトリの絶対URLまたは相対URLです。 指定したjavadoc
ツール実行で複数の-link
オプションを指定して、複数のドキュメントにリンクできます。このurlディレクトリ(それ以外の場合は、
-linkoffline
オプションを使用)には、package-list
またはelement-list
ファイルのいずれかが必要です。ノート:
package-list
およびelement-list
ファイルは、APIドキュメントを生成するときにjavadoc
ツールによって生成されるため、ユーザーが変更しないでください。javadoc
ツールを使用してパッケージをドキュメント化すると、package-list
ファイルを使用してAPIで宣言されたパッケージが判別されます。 モジュールのAPIドキュメントを生成すると、javadoc
ツールはelement-list
ファイルを使用して、APIで宣言されているモジュールおよびパッケージを判別します。javadoc
ツールは、適切なリスト・ファイルから名前を読み取り、そのURLにあるパッケージまたはモジュールにリンクします。javadoc
ツールを実行すると、作成される<A HREF>
リンクにurl値がコピーされます。 したがって、urlは、ファイルではなくディレクトリへのURLである必要があります。urlの絶対リンクを使用して、ドキュメントがwebサイトのドキュメントにリンクされるようにしたり、相対的なロケーションのみにリンクするために相対リンクを使用できます。 相対リンクを使用する場合、渡す値は、リンク先のディレクトリ(
-d
オプションで指定した)から、リンク先のパッケージを含むディレクトリへの相対パスである必要があります。 絶対リンクを指定すると、通常はHTTPリンクが使用されます。 Webサーバーを持たないファイル・システムにリンクする場合は、ファイル・リンクを使用できます。 生成されたドキュメントにアクセスするすべてのユーザーが同じファイル・システムを共有する場合にのみ、ファイル・リンクを使用します。 すべての場合、およびすべてのオペレーティング・システムでは、URLが絶対か相対かに関係なく、区切り文字としてスラッシュを使用し、URLメモ : ユニ・フォーム・リソース・ロケータで指定されているhttps:
、http:
またはfile:
を使用します。-link https://<host>/<directory>/<directory>/.../<name> -link http://<host>/<directory>/<directory>/.../<name> -link file://<host>/<directory>/<directory>/.../<name> -link <directory>/<directory>/.../<name>
-linkoffline
url1 url2このオプションは、
-link
オプションのバリエーションです。 どちらも、外部参照クラスのjavadoc
生成ドキュメントへのリンクを作成します。 指定したjavadoc
ツール実行で、複数の-linkoffline
オプションを指定できます。次の場合に
-linkoffline
オプションを使用します:javadoc
ツールがweb接続を介してアクセスできないWeb上のドキュメントへのリンク外部ドキュメントの
package-list
またはelement-list
ファイルは、アクセスできないか、URLの場所に存在しませんが、別の場所に存在し、package-list
またはelement-list
ファイル(通常はローカル)で指定できます。
ノート:
package-list
およびelement-list
ファイルは、APIドキュメントを生成するときにjavadoc
ツールによって生成されるため、ユーザーが変更しないでください。url1がWorld Wide Webでのみアクセス可能な場合、
-linkoffline
オプションは、ドキュメントを生成するためにjavadoc
ツールにWeb接続が必要であるという制約を削除します。-linkoffline
オプションのもう1つの使用法は、ドキュメントを更新するための回避策です。 パッケージまたはモジュールの完全なセットに対してjavadoc
ツールを実行した後、変更されたパッケージまたはモジュールの小さいセットに対してjavadoc
ツールを再度実行して、更新されたファイルを元のセットに戻すことができます。たとえば、
-linkoffline
オプションは2つの引数を取ります。 1つ目は<a href>
リンクに埋め込まれる文字列で、2つ目はjavadoc
ツールにpackage-list
またはelement-list
ファイルのいずれかの場所を示します。url1またはurl2値は、リンク先の外部
javadoc
生成ドキュメントを含むディレクトリの絶対URLまたは相対URLです。 相対値の場合、-d
オプションで指定される生成先ディレクトリを基準にした、リンクされるパッケージのルートの相対パスを指定する必要があります。-link
オプションのurlを参照してください。-linksource
各ソース・ファイル(行番号付き)のHTMLバージョンを作成し、標準HTMLドキュメントからソース・ファイルへのリンクを追加します。 リンクは、ソース・ファイル内に宣言されているクラス、インタフェース、コンストラクタ、メソッド、フィールドに対して作成されます。 そうでない場合、たとえばデフォルト・コンストラクタや生成されたクラスに対しては、リンクは作成されません。
このオプションは、
-public
、-package
、-protected
、-private
の各オプションとは関係なく、privateクラス、privateフィールド、privateメソッドの本体を始めとする組み込まれたソース・ファイル内のすべての非公開実装の詳細を公開します。-private
オプションを指定しないかぎり、privateクラスやprivateインタフェースの一部には、リンクを介してアクセスできないことがあります。各リンクは、その宣言内の識別子名の上に作成されます。 たとえば、
Button
クラスのソース・コードへのリンクは、「Button
」という語の上に作成されます。public class Button extends Component implements Accessible
Button
クラスのgetLabel
メソッドのソース・コードへのリンクは、「getLabel
」という語の上に作成されます。public String getLabel()
--main-stylesheet
fileまたは-stylesheetfile
file生成されたドキュメントで使用されるCSSスタイルの定義を含む代替スタイルシート・ファイルのパスを指定します。 このオプションを使うと、そのデフォルトの動作をオーバーライドできます。 このオプションを指定しない場合、
javadoc
ツールによってデフォルトのスタイル・シートが作成され、使用されます。 ファイル名には任意の名前を指定でき、stylesheet.css
に制限されません。--main-stylesheet
オプションが優先される形式です。コマンド行の例:
javadoc --main-stylesheet main_stylesheet.css pkg_foo
-nocomment
- 主説明およびすべてのタグを含むコメント本文全体を抑制し、宣言だけを生成します。 このオプションを使用すると、最初は新しい目的のために意図されたソース・ファイルを再利用できるため、新しいプロジェクトの初期段階でスケルトンHTMLドキュメントを作成できます。
-nodeprecated
- 非推奨APIをドキュメントに生成しないようにします。 これは、
-nodeprecatedlist
オプションが実行するものであり、残りのドキュメントでは非推奨のAPIは生成されません。 このオプションは、コードを記述しているとき、非推奨のコードによって気を散らされたくない場合に便利です。 -nodeprecatedlist
- 非推奨APIのリストを含むファイル(
deprecated-list.html
)、およびナビゲーション・バーのそのページへのリンクが生成されないようにします。javadoc
ツールは、ドキュメントの他の部分で非推奨のAPIを引き続き生成します。 このオプションは、非推奨APIがソース・コードに含まれておらず、ナビゲーション・バーをすっきりと見せたい場合に便利です。 --no-frames
- このオプションはno-opで、下位互換性のために保持されています。
-nohelp
- 出力の各ページの最上部と最下部にあるナビゲーション・バーから「ヘルプ」リンクを省略します。
-noindex
- 生成ドキュメントから、索引を省略します。 デフォルトでは、索引が生成されます。
-nonavbar
- 通常は生成されるページの最上部と最下部に表示されるナビゲーション・バー、ヘッダー、およびフッターを生成しないようにします。
-nonavbar
オプションは、-bottom
オプションには影響を与えません。-nonavbar
オプションは、印刷するためだけにファイルをPostScriptまたはPDFに変換する場合など、内容だけが重要で、ナビゲーションの必要がない場合に便利です。 -noqualifier
name1:
name2...修飾子のリストを出力から除外します。 クラスまたはインタフェースの名前が表示される場所からパッケージ名が削除されます。
次の例では、すべてのパッケージ修飾子を省略します。
-noqualifier all
次の例では、パッケージ修飾子
java.lang
およびjava.io
を省略します。-noqualifier java.lang:java.io
次の例では、
java
およびcom.sun
サブパッケージで始まるパッケージ修飾子は省略しますが、javax: -noqualifier java.*:com.sun.*
は省略します。パッケージ修飾子が上記の動作に従って表示される場合、名前は適切に短縮されます。 この規則は、
-noqualifier
オプションを使用したかどうかにかかわらず有効です。-nosince
- 生成ドキュメントから、
@since
タグに対応する「導入されたバージョン
」セクションを省略します。 -notimestamp
- タイムスタンプが抑制されます。各ページ先頭近くにある、生成されたHTML内のHTMLコメントにタイムスタンプが隠されます。
-notimestamp
オプションは、javadoc
ツールを2つのソース・ベースで実行し、diff
間の差異を取得する場合に便利です。これは、タイムスタンプによってdiff
(そうでない場合は、すべてのページのdiff
になります)が発生しないようにするためです。 タイムスタンプには、javadoc
ツールのリリース番号が含まれます。 -notree
- 生成された文書からクラスおよびインタフェースの階層ページを除外します。 これらのページには、ナビゲーション・バーの「ツリー」ボタンからアクセスできます。 デフォルトでは、階層が生成されます。
--override-methods
(detail
|summary
)- 詳細または要約セクション内のオーバーライドされるメソッドをドキュメント化します。
-overview
filenamejavadoc
ツールで、filename
で指定されたソース・ファイルから概要ドキュメントのテキストを取得し、概要ページ(overview-summary.html
)に配置するように指定します。 ファイル名で指定された相対パスは、現在の作業ディレクトリからの相対パスです。filename
値には任意の名前を使用し、パスに必要な任意の場所に配置できますが、通常、overview.html
という名前を付けて、最上位のパッケージ・ディレクトリを含むディレクトリにあるソース・ツリーに配置します。 この場所に配置すると、-sourcepath
オプションによってこのファイルが指し示されるので、パッケージをドキュメント化する際にpathが不要になります。LinuxおよびOS X: たとえば、
java.lang
パッケージのソース・ツリーが/src/classes/java/lang/
の場合、概要ファイルを/src/classes/overview.htmlに配置できます。Windows: たとえば、
java.lang
パッケージのソース・ツリーが\src\classes\java\lang\
の場合、概要ファイルを\src\classes\overview.html
に配置できます
概要ページは、2つ以上のパッケージ名を
javadoc
ツールに渡す場合にのみ作成されます。 概要ページのタイトルは、-doctitle
によって設定されます。-serialwarn
@serial
タグがない場合は、コンパイル時に警告を生成します。 デフォルトでは、Javadocはシリアル警告を生成しません。 このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドとwriteExternal
メソッドを適切にドキュメント化するのに役立ちます。-sourcetab
tablength- ソース内の各タブが使用する空白文字の数を指定します。
-splitindex
- 索引ファイルをアルファベットごとに複数のファイルに分割し、文字ごとに1つのファイルと、アルファベット以外の記号で始まる索引エントリ用に1つのファイルを作成します。
-tag
name:locations:header- 単一引数のカスタム・タグを指定します。
javadoc
ツールでタグ名をスペル・チェックするには、ソース・コードに存在するカスタム・タグごとに-tag
オプションを含めることが重要です。(withX
)は、現在の実行で出力されていないタグを無効化します。 コロン(:
)は常にセパレータです。-tag
オプションは、タグ見出しheaderを太字で出力し、次の行に1つの引数からのテキストを出力します。 ブロック・タグと同様、この引数のテキストにはインライン・タグを含めることができます。このインライン・タグも解釈されます。 出力は、引数を1つ取る標準のタグ(@return
、@author
など)の出力とよく似ています。 header値を省略すると、nameが見出しになります。 -taglet
classそのタグのドキュメントの生成に使用されるタグ・レットの完全修飾名を指定します。 class値の完全修飾名を使用します。 このタグレットは、カスタム・タグのテキスト引数の数も定義します。 タグレットは、これらの引数を受け付け、処理し、出力を生成します。
タグレットは、ブロック・タグまたはインライン・タグで便利です。 タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。 タグレットで指定できるのは、タグの配置場所と配置形式のみです。 その他のすべての決定は、ドックレットによって行われます。 タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。 ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。 タグレットのパスを指定するには、
-tagletpath
オプションを使用します。 以下は、生成されるページの「Parameter」と「Throws」の間に「To Do」タグレットを挿入する例です。-taglet com.sun.tools.doclets.ToDoTaglet -tagletpath /home/taglets -tag return -tag param -tag todo -tag throws -tag see
-tag
オプションのかわりに-taglet
オプションを使用することもできますが、読みにくくなる場合があります。-tagletpath
tagletpathlist- タグレットのクラス・ファイルの検索パスを指定します。 tagletpathlistには、プラットフォーム・パス・セパレータ(Windowsでは
;
、他のプラットフォームでは:
。)と分離することで、複数のパスを含めることができますjavadoc
ツールは、指定されたパスのすべてのサブディレクトリを検索します。 -top
html-code- 各出力ファイルの最上部に配置するテキストを指定します。
-use
- クラスとパッケージの使用ページを作成します。 ドキュメント化されるクラスおよびパッケージごとに1つの「使用」ページを組み込みます。 このページには、その特定のクラスまたはパッケージのAPIを使っているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドが記述されます。 たとえば、クラスCを例にとると、クラスCを使っているものとしては、Cのサブクラス、Cとして宣言されているフィールド、Cを返すメソッド、および、型Cのパラメータを持つメソッドとコンストラクタがあります。 たとえば、
String
型の「使用」ページを見てみましょう。java.awt.Font
クラスのgetName
メソッドはString
型を返すため、getName
メソッドはString
を使用するため、getName
メソッドはString
のUseページに表示されます。 これは、実装ではなく、APIの使用のみを示しています。 メソッドが実装でString
を使用していても、引数として文字列を取らないか、文字列を戻さない場合、これはString
の使用とはみなされません。生成された「使用」ページにアクセスするには、クラスまたはパッケージに移動し、ナビゲーション・バーの「使用」リンクをクリックします。 -version
- 生成されたドキュメントにバージョン・テキストを含めます。 このテキストは、デフォルトでは省略されます。 使用している
javadoc
ツールのバージョンを確認するには、-J-version
オプションを使用します。 -windowtitle
title- HTMLの
<title>
タグに配置するタイトルを指定します。title
タグに指定されたテキストは、ウィンドウのタイトルや、このページに対して作成されたブラウザのブックマーク(お気に入り)に表示されます。 このタイトルにはHTMLタグを含めないでください。タイトルにHTMLタグが含まれていると、ブラウザがタグを正しく解釈できません。title
タグ内の内部引用符には、エスケープ文字を使用してください。-windowtitle
オプションを省略すると、javadoc
ツールは-windowtitle
オプションに-doctitle
オプションの値を使用します。 たとえば、javadoc -windowtitle "My Library" com.mypackage
です。
標準ドックレットで提供される追加オプション
次に示すのは、標準ドックレットによって提供される追加オプションであり、予告なく変更される可能性があります。 追加のオプションはあまり使用されないか、拡張とみなされます。
-Xdoclint
- ドキュメンテーション・コメントの問題の推奨チェックを有効にします。
-Xdoclint:
(all
|none
|[-
]group)不正な参照、アクセシビリティの問題、ドキュメンテーション・コメントの欠落、ドキュメンテーション・コメント構文のエラーおよびHTMLタグの欠落について、特定のチェックを有効または無効にします。
このオプションを使用すると、
javadoc
ツールは、生成された出力に含まれるすべてのドキュメント・コメントをチェックできます。 標準オプション-public
,-protected
,-package
および-private
を使用して、生成された出力に含めるアイテムを選択できます。-Xdoclint
オプションを有効にすると、javac
コマンドに類似したメッセージの問題が報告されます。javadoc
ツールは、メッセージ、ソース行のコピー、およびエラーが検出された正確な位置を示すキャレットを出力します。 メッセージは、重大度および生成されたドキュメントがバリデータを介して実行される場合にエラーが発生する可能性に応じて、警告またはエラーのいずれかになります。 例えば: ドキュメンテーション・コメント、重複情報および余分なコメントがないと、javadoc
ツールで無効なHTMLが生成されないため、これらの問題は警告として報告されます。構文エラー、必要なHTML終了タグの欠落、および欠落またはスペル・ミスのある要素への参照によって、javadoc
ツールで無効な出力が生成されるため、これらの問題はエラーとして報告されます。-Xdoclint
オプションは、リクエストされたマークアップに基づいて入力コメントを検証します。デフォルトでは、
-Xdoclint
オプションは有効になっています。 無効にするには、-Xdoclint:none
オプションを使用します。次のオプションは、
-Xdoclint
オプションが報告する内容を変更します:-Xdoclint none
:-Xdoclint
オプションを無効にします。-Xdoclint
group: groupチェックを有効にします-Xdoclint all
: すべてのチェック・グループを有効にします-Xdoclint all,-
group: groupチェックを除くすべてのチェックを有効にします。
group変数には、次のいずれかの値があります:
accessibility
: アクセシビリティ・チェッカで検出されるような問題をチェックします(たとえば、<table>
タグにキャプション属性やサマリー属性が指定されていない場合)。html
: ブロック要素をインライン要素内に配置したり、終了タグを必要とする要素をクローズしないなど、高レベルのHTMLの問題を検出します。 ルールは、選択した標準ドックレットhtml
出力生成に基づいて、「HTML 4仕様」または「HTML 5の仕様」から導出されます。 このタイプのチェックでは、一部のブラウザが意図したとおりに解釈しない可能性があるHTMLの問題をjavadoc
ツールで検出できます。missing
: 欠落しているドキュメンテーション・コメントまたはタグ(たとえば、欠落しているコメントやクラス、欠落している@return
タグ、またはメソッドの類似タグなどです。)をチェックします。reference
: ドキュメンテーション・コメント・タグからのJava API要素への参照に関連する問題(たとえば、@see
で見つからないアイテムや、@param)
の後の不正な名前)をチェックします。syntax
: アンエスケープされた山カッコ(<
および>
)、アンパサンド(&
)および無効なドキュメンテーション・コメント・タグなどの低レベルの問題をチェックします。
-Xdoclint
オプションは複数回指定できるため、複数のカテゴリのエラーと警告をチェックできます。 または、前述のオプションを使用して、エラーと警告のカテゴリを複数指定することもできます。 たとえば、次のコマンドのいずれかを使用して、filenameファイル内のHTML、構文およびアクセシビリティの問題をチェックします。javadoc -Xdoclint:html -Xdoclint:syntax -Xdoclint:accessibility
filenamejavadoc -Xdoclint:html,syntax,accessibility
filenameノート:
javadoc
ツールでは、これらのチェックの完全性は保証されません。 具体的に言うと、これは完全なHTMLコンプライアンス・チェッカではありません。 その目的は -Xdoclint
オプションは、javadoc
ツールが一般的なエラーの大部分を報告できるようにすることです。javadoc
ツールは、無効な入力を修正しようとせず、レポートするだけです。-Xdoclint/package:
[-
]packages- 特定のパッケージ内のチェックを有効または無効にします。packagesは、パッケージ指定子のコンマ区切りのリストです。 パッケージ指定子は、パッケージの修飾名、またはパッケージ名のプレフィクスの後に
*
が続き、指定されたパッケージのすべてのサブパッケージに展開されます。 指定されたパッケージのチェックを無効にするには、パッケージ指定子の先頭に-
を付けます。 -Xdocrootparent
url- Javadocコメントのすべての
@docRoot
アイテムに続けて/..
をurlに置き換えます。