--- a/jdk/src/linux/doc/man/ja/javadoc.1 Mon Apr 18 23:00:53 2011 -0700
+++ b/jdk/src/linux/doc/man/ja/javadoc.1 Tue Apr 19 20:58:46 2011 -0700
@@ -1,4 +1,4 @@
-." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
+." Copyright (c) 1994, 2011, Oracle and/or its affiliates. All rights reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@@ -19,328 +19,244 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
-.TH javadoc 1 "02 Jun 2010"
-.SH "名前"
-javadoc \- Java API ドキュメントジェネレータ
-.RS 3
-
-.LP
-.LP
-Java ソースファイルから、API ドキュメントの HTML ページを生成します。このドキュメントで紹介されている Javadoc の例は、Sun Solaris を使用した場合のものです。
-.LP
-.RE
-.SH "形式"
-.LP
+.TH javadoc 1 "14 Apr 2011"
+.SH "̾"
+javadoc \- Java API ɥȥͥ졼
+.LP
+Java ե뤫顢API ɥȤ HTML ڡޤΥɥȤǾҲ𤵤Ƥ Javadoc ϡ Solaris ѤΤΤǤ
+.SH ""
.LP
\f4javadoc\fP\f2\ [\ \fP\f2options\fP\f2\ ]\ [\ packagenames\ ]\ [\ sourcefilenames\ ]\ [\ \-subpackages\fP\ \f2pkg1:pkg2:...\fP\f2\ ]\ [\ \fP\f2@argfiles\fP\f2\ ]\fP
.LP
-.LP
-引数を指定する順序は任意です。Javadoc ツールでの、処理対象の \f2.java\fP ファイルを決定する方法の詳細については、「ソースファイルの処理」を参照してください。
-.LP
-.RS 3
-
-.LP
+ꤹǤդǤJavadoc ġǤΡоݤ .java եꤹˡξܺ٤ˤĤƤϡ֥եν\f2\fPƤ
.RS 3
.TP 3
options
-このドキュメントで説明されているコマンド行オプションです。Javadoc オプションの標準的な使用法については、「使用例」を参照してください。
+ΥɥȤƤ륳ޥɹԥץǤJavadoc ץɸŪʻˡˤĤƤϡֻפȤƤ
.TP 3
packagenames
-スペースで区切られた一連のパッケージ名です。 たとえば、\f2java.lang\ java.lang.reflect\ java.awt\fP のように指定します。ドキュメント化するパッケージを個別に指定する必要があります。ワイルドカードは使用不可です。 再帰的処理のためには、\-subpackages を使用します。Javadoc ツールは、\f2\-sourcepath\fP を使ってこれらのパッケージ名を検索します。「1 つ以上のパッケージのドキュメント化」の例を参照してください。
+ڡǶڤ줿ϢΥѥå̾ǤȤС \f2java.lang\ java.lang.reflect\ java.awt Τ褦˻ꤷޤ\fPɥȲѥå̤˻ꤹɬפޤ磻ɥɤϻԲĤǤƵŪΤˤϡ\-subpackages ѤޤJavadoc ġϡ\f2\-sourcepath\fP ѤƤΥѥå̾ޤ1 İʾΥѥåΥɥȲפȤƤ
.TP 3
sourcefilenames
-スペースで区切られた一連のソースファイル名です。各ファイルは、パスで始まります。アスタリスク (*) などのワイルドカードを含めることができます。 Javadoc ツールが処理するのは、ファイル名が「.java」という拡張子で終わり、その拡張子を除いた名前が実際に有効なクラス名であるすべてのファイルです (
+ڡǶڤ줿ϢΥե̾Ǥ ƥեϡѥǻϤޤޤꥹ (*) ʤɤΥ磻ɥɤޤ뤳ȤǤޤJavadoc ġ뤬Τϡե̾.javaפȤĥҤǽꡢγĥҤ̾ºݤͭʥ饹̾Ǥ뤹٤ƤΥեǤ (
.na
-\f2「Identifiers」\fP @
+\f2Identifiers\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625を参照)。したがって、ハイフンを含む名前 (\f2X\-Buffer\fP など) や、その他の無効な文字を含む名前を付けることによって、それらのファイルをドキュメント化の対象から除外できます。これは、テスト用のファイルや、テンプレートから生成されたファイルの場合に便利です。 ソースファイル名の前に指定したパスによって、javadoc がそのファイルを検索する場所が決まります。Javadoc ツールは、これらのソースファイル名を検索するときに \f2\-sourcepath\fP は使いません。相対パスは、現在のディレクトリからの相対パスです。 \f2Button.java\fP を渡すことは、\f2./Button.java\fP を渡すことと同じです。ソースファイル名をフルパスで指定すると、\f2/home/src/java/awt/Graphics*.java\fP のようになります。「1 つ以上のクラスのドキュメント化」の例を参照してください。また、「パッケージとクラスのドキュメント化」の例のように、パッケージ名とソースファイル名を混在させることもできます。
+http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)äơϥեޤ̾ ( \f2X\-Buffer\fP ʤ) 䡢¾̵ʸޤ̾դ뤳ȤˤäơΥեɥȲоݤǤޤϡƥѤΥե䡢ƥץ졼Ȥ줿եξǤե̾˻ꤷѥˤäơjavadoc Υե꤬ޤޤJavadoc ġϡΥե̾Ȥˤ \f2\-sourcepath\fP ѤޤХѥϸߤΥǥ쥯ȥȤ뤿ᡢ \f2Button.java\fP ϤȤϡ \f2./Button.java\fP ϤȤƱǤե̾եѥǻꤹȡ \f2/home/src/java/awt/Graphics*.java Τ褦ˤʤޤ\fP 1 İʾΥ饹ΥɥȲפȤƤޤ֥ѥåȥ饹ΥɥȲפΤ褦ˡѥå̾ȥե̾ߤ뤳ȤǤޤ
.TP 3
\-subpackages pkg1:pkg2:...
-ソースファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。パッケージ名またはソースファイル名を指定する必要はありません。
+ե뤫ꤵ줿ѥåӤΥ֥ѥå˺ƵŪ˥ɥȤޤѥå̾ޤϥե̾ꤹɬפϤޤ
.TP 3
@argfiles
-Javadoc オプション、パッケージ名、およびソースファイル名を任意の順序で並べたリストが含まれる 1 つ以上のファイルです。このファイルの中では、ワイルドカード (*) および \f2\-J\fP オプションは指定できません。
-.RE
-
-.LP
+Javadoc ץѥå̾ӥե̾Ǥդν¤٤ꥹȤޤޤ 1 İʾΥեǤ磻ɥ (*) \f2\-J\fP ץϡΥեǤϻǤޤ
.RE
-.SH " 説明"
-.LP
-.LP
-\f3Javadoc\fP ツールは、一連の Java ソースファイルにある宣言およびドキュメンテーションコメントを解析し、デフォルトでは public クラス、protected クラス、入れ子にされたクラス (匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて説明した一連の HTML ページを生成します。また、API (アプリケーションプログラミングインタフェース) ドキュメントの生成や、一連のソースファイルの実装ドキュメントの生成に使用できます。
-.LP
-.LP
-Javadoc ツールは、パッケージ全体、個々のソースファイル、またはその両方に対して実行できます。javadoc ツールをパッケージ全体に対して実行する場合は、最上位ディレクトリから再帰的にたどるために \f2\-subpackages\fP を使用するか、パッケージ名の明示的なリストを渡します。個々ソースファイルに対して javadoc を実行する場合は、一連のソース (\f2.java\fP) ファイル名を渡します。具体的な例は、このドキュメントの最後に紹介します。次に、Javadoc によるソースファイルの処理について説明します。
-.LP
+.SH " "
+.LP
+\f3Javadoc\fP ġϡϢ Java եˤӥɥơȤϤǥեȤǤ public 饹protected 饹Ҥˤ줿饹 (ƿ̾饹Ͻ)եȥ饯åɡӥեɤˤĤϢ HTML ڡޤޤAPI (ץꥱץߥե) ɥȤ䡢ϢΥեμɥȤ˻ѤǤޤ
+.LP
+Javadoc ġϡѥåΡġΥե롢ޤϤξФƼ¹ԤǤޤѥåΤΥɥȲԤˤϡ\f2\-subpackages\fP ѤƺǾ̥ǥ쥯ȥ꤫鲼˺ƵŪˤɤ뤫ѥå̾ŪʥꥹȤϤޤġեФ javadoc ¹ԤϡϢΥ (.\f2.java\fP) ե̾ϤޤŪϡΥɥȤκǸ˾Ҳ𤷤ޤˡJavadoc ˤ륽եνˤĤޤ
.SS
-ソースファイルの処理
-.LP
-.LP
-Javadoc ツールは、末尾に \f2.java\fP の付いたファイル以外に、ソースファイルで説明する他のファイルも処理します。個々のソースファイル名を明示的に渡すことによって Javadoc ツールを実行する場合、どの \f2.java\fP ファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。 パッケージ名を渡すほうが簡単だからです。ソースファイル名を明示的に指定しなくても、Javadoc ツールは 3 つの方法で実行できます。この方法は、(1) パッケージ名を渡す、(2) \f2\-subpackages\fP を使用する、(3) ソースファイル名にワイルドカードを使用する (\f2*.java\fP) という方法です。これらの方法を使用する場合、Javadoc ツールは、\f2.java\fP ファイルが次のすべての要件を満たしている場合にかぎり、このファイルを処理します。
-.LP
+եν
+.LP
+Javadoc ġϡ\f2.java\fPפΥեǤʤ֥եפ뤽¾ΥեޤġΥե̾ŪϤȤˤä Javadoc ġ¹Ԥ硢ɤ \f2.java\fP ե뤫Τ˻Ǥޤ¿γȯԤϤˡǤϺȤޤѥå̾ϤۤñǤե̾Ū˻ꤷʤƤ⡢Javadoc ġ 3 ĤˡǼ¹ԤǤޤˡȤϡ(1) ѥå̾Ϥ(2) \f2\-subpackages\fP Ѥ롢(3) ե̾ǥ磻ɥɤѤ (\f2*.java\fP) 3 ĤǤξ硢Javadoc ġ뤬\f2.java\fPץեνԤΤϡΥե뤬Τ٤ƤǤ
.RS 3
.TP 2
o
-名前から \f2.java\fP の接尾辞を取り除くと、実際に有効なクラス名になっている (有効な文字については、
+̾\f2.java\fPפȼºݤͭʥ饹̾ˤʤäƤ (ͭʸˤĤƤ
.na
-\f2「Identifiers」\fP @
+\f2Identifiers\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625を参照)
+http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)
.TP 2
o
-ソースツリーのルートから相対的なディレクトリパスが、区切り文字をドットに変換すると、実際に有効なパッケージ名になっている
+ĥΥ롼ȤŪʥǥ쥯ȥѥڤʸɥåȤѴȡºݤͭʥѥå̾ˤʤäƤ
.TP 2
o
-パッケージ文には有効なパッケージ名が含まれる (前項目で指定)
+ѥåʸˤͭʥѥå̾ޤޤ (ܤǻ)
.RE
-
-.LP
-.LP
-\f3リンクの処理\fP \- Javadoc ツールは、処理の実行中に、その実行でドキュメント化されるパッケージ、クラス、およびメンバーの名前に対して、自動的に相互参照リンクを追加します。このようなリンクは、次のような場所に追加されます。
-.LP
+.LP
+\f3ν\fP \- Javadoc ġϡμ¹ˡμ¹ԤǥɥȲѥå饹ӥС̾ФơưŪȥɲäޤΤ褦ʥϡΤ褦ʾɲäޤ
.RS 3
.TP 2
o
-宣言 (戻り値の型、引数の型、フィールドの型)
+ (ͤηηեɤη)
.TP 2
o
-\f2@see\fP タグから生成された [関連項目] セクション
+\f2@see\fP 줿 [Ϣ]
.TP 2
o
-\f2{@link}\fP タグから生成されたインラインテキスト
+\f2{@link}\fP 줿饤ƥ
.TP 2
o
-\f2@throws\fP タグから生成された例外の名前
+\f2@throws\fP 줿㳰̾
.TP 2
o
-"インタフェースのメンバーに対する [定義] リンクと、クラスのメンバーに対する [オーバーライド] リンク
+եΥСФץȡ饹ΥСФ֥С饤ɡץ
.TP 2
o
-パッケージ、クラス、およびメンバーを列挙している概要テーブル
+ѥå饹ӥСƤ복ץơ֥
.TP 2
o
-パッケージおよびクラスの継承ツリー
+ѥåӥ饹ηѾĥ
.TP 2
o
-索引
+
.RE
-
-.LP
-.LP
-コマンド行で指定しなかったクラスについての既存のテキスト (別に生成したテキスト) に対してハイパーリンクを追加するには、\f2\-link\fP および \f2\-linkoffline\fP オプションを利用できます。
-.LP
-.LP
-\f3その他の処理についての詳細\fP \- Javadoc ツールは、実行するたびに 1 つの完全なドキュメントを作成します。 ドキュメントを追加生成することはできません。 つまり、Javadoc ツールの以前の実行結果を修正したり、その内容を直接組み入れたりすることはできません。ただし、前述のように、以前の実行結果に対してリンクを追加することはできます。
-.LP
-.LP
-実装上の理由から、Javadoc ツールは、処理を実行するために java コンパイラを必要とし、java コンパイラに依存しています。Javadoc ツールは \f2javac\fP の一部を呼び出すことにより、宣言をコンパイルし、メンバーの実装は無視します。Javadoc ツールは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、その情報から HTML を生成します。さらに、Javadoc ツールは、ソースコードのドキュメンテーションコメントから、ユーザーの提供したドキュメントも取得します。
-.LP
-.LP
-Javadoc ツールは、メソッド本体のない純粋なスタブファイルである \f2.java\fP ソースファイルに対しても、実行することができます。したがって、API の作成時には、実装を記述する前の設計の早い段階で、ドキュメンテーションコメントを記述して javadoc ツールを実行できます。
-.LP
-.LP
-コンパイラに依存することによって、HTML 出力は、実際の実装に正確に対応します。 実際の実装は、明示的なソースコードにではなく、暗黙のソースコードに依存する場合があります。たとえば、Javadoc ツールは、\f2.class\fP ファイル内に存在するが、ソースコード内には存在しない
+.LP
+ޥɹԤǻꤷʤä饹ˤĤƤδ¸Υƥ (̤ƥ) Фƥϥѡɲäˤϡ\f2\-link\fP \f2\-linkoffline\fP ץѤǤޤ
+.LP
+\f3¾νˤĤƤξܺ\fP \- Javadoc ġϡ¹Ԥ뤿Ӥ 1 ĤδʥɥȤޤɥȤɲ뤳ȤϤǤޤĤޤꡢJavadoc ġΰμ¹Է̤ꡢƤľȤ줿ꤹ뤳ȤϤǤޤҤΤ褦ˡμ¹Է̤Фƥɲä뤳ȤϤǤޤ
+.LP
+ͳ顢Javadoc ġϡ¹Ԥ뤿 java ѥɬפȤjava ѥ˰¸ƤޤJavadoc ġϡ \f2javac\fP ΰƤӽФѥ뤷ޤСμ̵뤷ޤJavadoc ġϡ饹ؤޤ९饹˭٤ɽȥ饹Ρֻѡ״طۤξ HTML ޤˡJavadoc ġϡɤΥɥơȤ顢桼ɥȤޤ
+.LP
+ºݤˤϡJavadoc ġϡåΤʤʥ֥եǤ褦 \f2.java\fP եǤưޤäơAPI κˤϡҤ߷פᤤʳǡɥơȤҤ javadoc ġ¹ԤǤޤ
+.LP
+ѥ˰¸뤳ȤˤäơHTML ϤϡºݤμΤбޤºݤμϡŪʥɤˤǤϤʤۤΥɤ˰¸礬ޤȤСJavadoc ġϡ.class եˤ¸ߤ뤬ɤˤ¸ߤʤ
.na
-\f2デフォルトコンストラクタ\fP @
+\f2ǥեȥȥ饯\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154 (Java 言語仕様のセクション 8.6.7) をドキュメント化します。
-.LP
-.LP
-通常、Javadoc ツールでは、ソースファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。このため、デバッグやトラブルシューティングを完了する前にドキュメントを生成できます。たとえば、Java 言語仕様によると、抽象メソッドを含むクラスは、それ自体抽象として宣言されなければなりません。このエラーを検出すると、javac コンパイラは停止しますが、Javadoc ツールは警告を出さずに処理を続行します。Javadoc ツールはドキュメンテーションコメントの基本的なチェックを行います。ドキュメンテーションコメントをより詳しくチェックする必要がある場合は、DocCheck ドックレットを使用してください。
-.LP
-.LP
-Javadoc ツールは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、Javadoc ツールは、ブートストラップクラス、拡張機能、またはユーザークラスにかかわらず、すべての参照クラスを検索できなければなりません。詳細は、
+http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154 (Java ͤΥ 8.6.7) \f2ɥȲ\fP ޤ
+.LP
+̾Javadoc ġǤϡեΥɤԴޤϥ顼ޤǤǤɥȤǤޤΤᡢǥХåȥ֥륷塼ƥλ˥ɥȤǤޤȤСJava ͤˤȡݥåɤޤ९饹ϡ켫ݤȤʤФʤޤΥ顼Фȡjavac ѥߤޤJavadoc ġϷٹФ˽³ԤޤJavadoc ġϥɥơȤδŪʥåԤޤɥơȤܤåɬפϡDocCheck ɥååȤѤƤ
+.LP
+Javadoc ġϡɥȤ¤ۤݡȥ饹٤ƥɤޤΤᡢJavadoc ġϡ֡ȥȥåץ饹ĥǽޤϥ桼饹ˤ餺٤Ƥλȥ饹ǤʤФʤޤܺ٤ϡ
.na
-\f2「クラスの検索方法」\fP @
+\f2֥饹θˡ\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlを参照してください。通常、作成するクラスは、拡張機能としてロードするか、Javadoc ツールのクラスパス内に置く必要があります。
-.LP
+http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlȤƤ̾륯饹ϡĥǽȤƥɤ뤫Javadoc ġΥ饹ѥ֤ɬפޤ
.SS
-Javadoc のドックレット
-.LP
-.LP
-Javadoc ツールの出力の内容と形式は、ドックレットを使ってカスタマイズできます。Javadoc ツールには、標準ドックレットと呼ばれるデフォルトの「組み込み」ドックレットがあります。 標準ドックレットは、HTML 形式の API ドキュメントを生成します。標準ドックレットを修正またはサブクラス化することや、HTML、XML、MIF、RTF などの好みの出力形式を生成する独自のドックレットを記述することも可能です。ドックレットとその使用法については、次の項目を参照してください。
-.LP
+Javadoc Υɥåå
+.LP
+Javadoc ġνϤƤȷϡɥååȤȤäƥޥǤޤJavadoc ġˤϡɸɥååȤȸƤФǥեȤΡȤ߹ߡץɥååȤޤɸɥååȤϡHTML API ɥȤޤɸɥååȤޤϥ֥饹뤳Ȥ䡢HTMLXMLMIFRTF ʤɤιߤνϷȼΥɥååȤҤ뤳ȤǽǤɥååȤȤλˡˤĤƤϡιܤȤƤ
.RS 3
.TP 2
o
.na
-\f2Javadoc のドックレット\fP @
+\f2Javadoc Υɥåå\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html
.TP 2
o
-\f2\-doclet\fP コマンド行オプション
+\f2\-doclet\fP ޥɹԥץ
.RE
-
-.LP
-.LP
-\f2\-doclet\fP コマンド行オプションでカスタムドックレットが指定されていない場合、Javadoc ツールは、デフォルトの標準ドックレットを使用します。javadoc ツールには、使用されているドックレットに関係なく使用できるコマンド行オプションがあります。標準ドックレットでは、これらのほかに、いくつかのコマンド行オプションが追加されます。どちらのオプションについても、このあとの「オプション」で説明します。
-.LP
+.LP
+\f2\-doclet\fP ޥɹԥץǥɥååȤꤵƤʤ硢Javadoc ġϡǥեȤɸɥååȤѤޤjavadoc ġˤϡѤƤɥååȤ˴طʤѤǤ륳ޥɹԥץޤɸɥååȤǤϡΤۤˡĤΥޥɹԥץɲäޤɤΥץˤĤƤ⡢ΤȤΡ֥ץפޤ
.SS
-関連ドキュメントおよびドックレット
-.LP
+ϢɥȤӥɥåå
.RS 3
.TP 2
o
.na
-\f2Javadoc に施された機能強化\fP @
+\f2Javadoc ˻ܤ줿ĥǽ\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html \- Javadoc で追加された改良点の詳細
+http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html \- Javadoc 1.4 ɲä줿ξܺ
.TP 2
o
.na
\f2Javadoc FAQ\fP @
.fi
-http://java.sun.com/j2se/javadoc/faq/index.html \- 頻繁に寄せられる質問に対する回答、Javadoc 関連のツールについての情報、およびバグの回避方法
+http://java.sun.com/j2se/javadoc/faq/index.html \- ˤ˴ФJavadoc ϢΥġˤĤƤξӥХβˡ
.TP 2
o
.na
\f2How to Write Doc Comments for Javadoc\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html \- ドキュメンテーションコメントの記述方法に関する Sun の規約
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html \- ɥơȤεˡ˴ؤ Sun ε
.TP 2
o
.na
\f2Requirements for Writing API Specifications\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Java 2 プラットフォーム仕様を記述する際に使用された標準要件。この情報は、ソースファイルのドキュメンテーションコメント形式で API 仕様を記述する場合にも、その他の形式で記述する場合にも役立ちます。検証可能なアサーションを満たすパッケージ、クラス、インタフェース、フィールド、およびメソッドについての要件を定めています。
+http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Java SE ץåȥեͤҤݤ˻Ѥ줿ɸ盧ξϡեΥɥơȷ API ͤҤˤ⡢¾ηǵҤˤΩޤڲǽʥѥå饹եեɡӥåɤˤĤƤƤޤ
.TP 2
o
.na
-\f2ドキュメンテーションコメントの仕様\fP @
+\f2ɥơȤλ\fP @
.fi
-http://java.sun.com/docs/books/jls/first_edition/html/18.doc.html \- ドキュメンテーションコメントのオリジナル仕様については、『Java Language Specification』 (James Gosling、Bill Joy、Guy Steele 共著) の初版の第 18 章「Documentation Comments」を参照してください。この章は、第 2 版では削除されました。
+http://java.sun.com/docs/books/jls/first_edition/html/18.doc.html \- ɥơȤΥꥸʥͤˤĤƤϡJava Language Specification (James GoslingBill JoyGuy Steele ) νǤ 18 ϡDocumentation CommentsפȤƤξϤϡ 2 ǤǤϺޤ
.TP 2
o
.na
-\f2DocCheck ドックレット\fP @
+\f2DocCheck ɥåå\fP @
.fi
-http://java.sun.com/javadoc/doccheck \- ソースファイル内のドキュメンテーションコメントをチェックし、検出されたエラーや不正のレポートを生成します。Sun Doc Check ユーティリティーの一部です。Sun Doc Check ユーティリティーの一部です。
+http://java.sun.com/javadoc/doccheck \- եΥɥơȤåФ줿顼ΥݡȤޤDoc Check 桼ƥƥΰǤ
.TP 2
o
.na
-\f2MIF ドックレット\fP @
+\f2MIF ɥåå\fP @
.fi
-http://java.sun.com/javadoc/mifdoclet \- MIF、FrameMaker、PDF の書式で API ドキュメントを自動生成します。MIF は Adobe FrameMaker の交換書式です。
+http://java.sun.com/javadoc/mifdoclet \- MIFFrameMakerPDF ν API ɥȤưޤMIF Adobe FrameMaker θǤ
.RE
-
-.LP
.SS
-用語
-.LP
-.LP
-\f2「ドキュメンテーションコメント」\fP、\f2「doc コメント」\fP、\f2「主説明」\fP、\f2「タグ」\fP、\f2「ブロックタグ」\fP、および\f2「インラインタグ」\fPの用語については、「ドキュメンテーションコメント」で説明します。次のその他の用語は、Javadoc ツールのコンテキストで特定の意味を持ちます。
-.LP
+Ѹ
+.LP
+\f2֥ɥơȡ\fP\f2doc ȡ\fP\f2ּ\fP\f2֥\fP\f2֥֥å\fP\f2֥饤\fPѸˤĤƤϡ֥ɥơȡפޤʲΤ¾ѸϡJavadoc ġΥƥȤΰ̣ޤ
.RS 3
.TP 3
-生成ドキュメント (generated document)
-javadoc ツールが Java ソースコード内のドキュメンテーションコメントから生成したドキュメントのことです。デフォルトの生成ドキュメントは HTML 形式で、標準ドックレットによって作成されます。
+ɥ (generated document)
+javadoc ġ뤬 Java ΥɥơȤɥȤΤȤǤǥեȤɥȤ HTML ǡɸɥååȤˤäƺޤ
.LP
.TP 3
-名前 (name)
-Java 言語で書かれたプログラム要素の名前、つまりパッケージ、クラス、インタフェース、フィールド、コンストラクタ、またはメソッドの名前のことです。名前は、\f2java.lang.String.equals(java.lang.Object)\fP のように完全修飾することも、\f2equals(Object)\fP のように部分修飾することもできます。
+̾ (name)
+Java ǽ줿ץǤ̾Ĥޤѥå饹եեɡȥ饯ޤϥåɤ̾ΤȤǤ̾ϡ \f2java.lang.String.equals(java.lang.Object)\fP Τ褦ʴ̾ˤ뤳Ȥ⡢ \f2equals(Object)\fP Τ褦ʬ̾ˤ뤳ȤǤޤ
.LP
.TP 3
-ドキュメント化されるクラス (documented classes)
-javadoc ツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。ドキュメント化するには、ソースファイルが使用可能でなければならず、ソースファイル名またはパッケージ名を javadoc コマンドに渡され、アクセス修飾子 (public、protected、package\-private または private) によってフィルタ処理されないようにしなければなりません。ドキュメント化されるクラスは、javadoc ツールの出力に組み込まれるクラス、つまり「包含クラス」とも呼ばれます。
+ɥȲ륯饹 (documented classes)
+javadoc ġμ¹Ԥˤäƾܺ٤ʥɥȤ륯饹ӥեΤȤǤɥȲˤϡե뤬ѲǽǤʤФʤ餺ե̾ޤϥѥå̾ javadoc ޥɤϤ졢 (publicprotectedpackage\-private ޤ private) ˤäƥե륿ʤ褦ˤʤФʤޤɥȲ륯饹ϡjavadoc ġνϤȤ߹ޤ륯饹Ĥޤޥ饹פȤƤФޤ
.LP
.TP 3
-包含クラス (included classes)
-ツールの実行によって詳細なドキュメントが生成されるクラスおよびインタフェースのことです。「ドキュメント化されるクラス」 と同じ。
+ޥ饹 (included classes)
+ġμ¹Ԥˤäƾܺ٤ʥɥȤ륯饹ӥեΤȤǤ֥ɥȲ륯饹פƱ
.LP
.TP 3
-除外クラス (excluded classes)
-ツールの実行によって詳細なドキュメントが生成されないクラスおよびインタフェースのことです。
+饹 (excluded classes)
+ġμ¹Ԥˤäƾܺ٤ʥɥȤʤ饹ӥեΤȤǤ
.LP
.TP 3
-参照クラス (referenced classes)
-ドキュメント化されるクラスおよびインタフェースの定義 (実装) またはドキュメンテーションコメントの中で明示的に参照されているクラスおよびインタフェースのことです。参照の例としては、戻り値の型、パラメータの型、キャストの型、拡張されたクラス、実装されたインタフェース、インポートされたクラス、メソッド本体で使用されるクラス、@see、{@link}、{@linkplain}、{@inheritDoc} タグなどがあります。この定義は
+ȥ饹 (referenced classes)
+ɥȲ륯饹ӥե () ޤϥɥơȤŪ˻ȤƤ륯饹ӥեΤȤǤȤȤƤϡͤηѥη㥹Ȥηĥ줿饹줿եݡȤ줿饹åΤǻѤ륯饹@see{@link}{@linkplain}{@inheritDoc} ʤɤޤ
.na
\f21.3\fP @
.fi
-http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses から変更されています。javadoc ツールを実行するときは、Javadoc のブートクラスパスおよびクラスパス内にあるすべての参照クラスをメモリーにロードする必要があります。参照クラスが見つからない場合は、「クラスが見つかりません」という警告が表示されます。Javadoc ツールは、クラスの存在とそのメンバーの完全指定の名前を判別するのに必要なすべての情報を、.class ファイルから引き出すことができます。
+http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses ѹƤޤjavadoc ġ¹ԤȤϡJavadoc Υ֡ȥ饹ѥӥ饹ѥˤ뤹٤Ƥλȥ饹˥ɤɬפޤȥ饹Ĥʤϡ֥饹ĤޤפȤٹɽޤJavadoc ġϡ饹¸ߤȤΥСδ̾Ƚ̤Τɬפʤ٤Ƥξ.class ե뤫ФȤǤޤ
.LP
.TP 3
-外部参照クラス (external referenced classes)
-参照クラスのうち、javadoc ツールの実行中にドキュメントが生成されないクラスのことです。つまり、これらのクラスは、コマンド行で Javadoc ツールに渡されていません。生成ドキュメント内でこれらのクラスにリンクしている箇所は、「外部参照」または「外部リンク」と呼ばれます。たとえば、\f2java.awt\fP パッケージに対してだけ Javadoc ツールを実行した場合、\f2Object\fP などの \f2java.lang\fP 内のすべてのクラスが外部参照クラスになります。外部参照クラスにリンクするには、\f2\-link\fP および \f2\-linkoffline\fP オプションを使用します。外部参照クラスには、通常そのソースコメントを javadoc ツールの実行で利用できないという重要な特徴があります。この場合、それらのコメントを継承することはできません。
+ȥ饹 (external referenced classes)
+ȥ饹Τjavadoc ġμ¹˥ɥȤʤ饹ΤȤǤĤޤꡢΥ饹ϡޥɹԤ Javadoc ġϤƤޤɥǤΥ饹˥ƤսϡֳȡפޤϡֳפȸƤФޤȤСJavadoc ġμ¹оݤ \f2java.awt\fP ѥåΤߤǤ硢 \f2java.lang\fP Τ٤ƤΥ饹 ( \f2Object\fPʤ) ȥ饹ˤʤޤȥ饹˥ˤϡ \f2\-link\fP \f2\-linkoffline\fP ץѤޤȥ饹ˤϡ̾綠ΥȤ javadoc ġμ¹ԤѤǤʤȤפħޤξ硢ΥȤѾ뤳ȤϤǤޤ
.RE
-
-.LP
-.SH "ソースファイル"
-.LP
-.LP
-Javadoc ツールは、4 種類の異なるソースファイルから出力結果を生成します。そのファイルは、クラスの Java 言語ソースファイル (\f2.java\fP)、パッケージコメントファイル、概要コメントファイル、およびその他の処理されないファイルです。また、ドキュメント化しないがソースツリーに存在する場合があるテストファイルやテンプレートファイルについても説明します。
-.LP
+.SH "ե"
+.LP
+Javadoc ġ 4 ΰۤʤ֥ץե뤫Ϥޤ 4 Ȥϡ饹 Java 쥽ե (\f2.java\fP)ѥåȥե롢ץȥե롢Ӥ¾νʤեǤޤɥȲʤĥ¸ߤ礬ƥȥեƥץ졼ȥեˤĤƤޤ
.SS
-クラスソースコードファイル
-.LP
-.LP
-それぞれのクラスまたはインタフェース、およびそのメンバーは、独自のドキュメンテーションコメントを持つことができ、それを \f2.java\fP ファイル内に保持します。ドキュメンテーションコメントの詳細は、「ドキュメンテーションコメント」を参照してください。
-.LP
+饹ɥե
+.LP
+줾Υ饹ޤϥեӤΥСϡȼΥɥơȤĤȤǤ \f2.java\fP եݻޤɥơȤξܺ٤ϡ֥ɥơȡפȤƤ
.SS
-パッケージコメントファイル
-.LP
-.LP
-それぞれのパッケージは、独自のドキュメンテーションコメントを持つことができ、それを専用の「ソース」ファイルに保持します。 その内容は、Javadoc ツールによって生成される概要ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。
-.LP
-.LP
-パッケージコメントファイルを作成する場合、コメントの格納先として、次の 2 つのファイルのいずれかを選択できます。
-.LP
+ѥåȥե
+.LP
+줾ΥѥåϡȼΥɥơȤĤȤǤѤΡ֥ץեݻޤƤϡJavadoc ġˤä복ץڡȤ߹ޤޤΥȤˤϡ̾ΥѥåΤƤϤޤɥȤҤޤ
+.LP
+ѥåȥե硢ȤγǼȤơ 2 ĤΥեΤ줫Ǥޤ
.RS 3
.TP 2
o
-\f2package\-info.java\fP \- パッケージ宣言、パッケージ注釈、パッケージコメント、および Javadoc タグを格納できます。このファイルは JDK 5.0 で導入されたものであり、package.html よりも推奨されています。
+\f2package\-info.java\fP \- ѥåѥåᡢѥåȡ Javadoc ǼǤޤΥեϰ̤ˡpackage.html 侩ޤ
.TP 2
o
-\f2package.html\fP \- 格納できるのはパッケージコメントと Javadoc タグだけです。 パッケージ注釈は格納できません。
+\f2package.html\fP \- ǼǤΤϥѥåȤ Javadoc ǤѥåϳǼǤޤ
.RE
-
-.LP
-.LP
-各パッケージは、単一の \f2package.html\fP ファイル、単一の \f2package\-info.java\fP ファイルのいずれかを持つことができますが、両方を持つことはできません。このどちらかのファイルを \f2.java\fP ファイルとともに、ソースツリー内のそのパッケージのディレクトリ内に配置してください。
-.LP
-.LP
-\f4package\-info.java\fP \- このファイルには、次の構造のパッケージコメントを格納できます。 コメントはパッケージ宣言の前に配置します。
-.LP
-.LP
-File:\f2java/applet/package\-info.java\fP
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
+.LP
+ƥѥåǤϡñ \f2package.html\fP ե롢ñ \f2package\-info.java\fP եΤ줫Ǥޤξ뤳ȤϤǤޤΤɤ餫Υե \f2.java\fP եȤȤˡĥΤΥѥåΥǥ쥯ȥ֤Ƥ
+.LP
+\f4package\-info.java\fP \- Υեˤϡι¤ΥѥåȤǼǤޤ Ȥϥѥå֤ޤ
+.LP
+File: \f2java/applet/package\-info.java\fP
.nf
\f3
.fl
/**
.fl
- * Provides the classes necessary to create an
+ * Provides the classes necessary to create an
.fl
* applet and the classes an applet uses
.fl
@@ -372,285 +288,91 @@
.fl
\fP
.fi
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 352 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-42
-
-.LP
-.LP
-コメント区切り文字の \f2/**\fP と \f2/*\fP は記述する必要がありますが、中間行の行頭のアスタリスクは省略してもかまいません。
-.LP
-.LP
-\f4package.html\fP \- このファイルには、次の構造のパッケージコメントを格納できます。 コメントは \f2<body>\fP 要素内に配置します。
-.LP
-.LP
-File:\f2java/applet/package.html\fP
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
+.LP
+ȶڤʸ \f2/**\fP \f2/*\fP ¸ߤƤɬפޤֹԤιƬΥꥹϾάƤ⤫ޤޤ
+.LP
+\f4package.html\fP \- Υեˤϡι¤ΥѥåȤǼǤޤȤ \f2<body>\fP ֤ޤ
+.LP
+File: \f2java/applet/package.html\fP
.nf
\f3
.fl
-<HTML>
-.fl
-<BODY>
-.fl
-Provides the classes necessary to create an applet and the
-.fl
-classes an applet uses to communicate with its applet context.
-.fl
-<p>
+<HTML> <BODY> Provides the classes necessary to create an applet and the classes an applet uses to communicate with its applet context.<p>
.fl
The applet framework involves two entities: the applet
.fl
-and the applet context. An applet is an embeddable
-.fl
-window (see the {@link java.awt.Panel} class) with a
-.fl
-few extra methods that the applet context can use to
-.fl
-initialize, start, and stop the applet.
-.fl
-
-.fl
-@since 1.0
-.fl
-@see java.awt
-.fl
-</BODY>
-.fl
-</HTML>
+and the applet context. An applet is an embeddable window (see the {@link java.awt.Panel} class) with a few extra methods that the applet context can use to initialize, start, and stop the applet.@since 1.0 @see java.awt </BODY> </HTML>
.fl
\fP
.fi
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 405 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-40
-
-.LP
-.LP
-これは単なる通常の HTML ファイルであり、パッケージ宣言を含んでいない点に注意してください。パッケージコメントファイルの内容は、ほかのすべてのコメントと同様に HTML で記述されています。それは、このドキュメンテーションコメントには、コメント区切り文字である \f2/**\fP と \f2*/\fP、および行頭のアスタリスクを含めてはならない、ということです。コメントを書く場合は、最初の文をパッケージの概要とし、\f2<body>\fP と最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージタグを含めることはできますが、ほかのドキュメンテーションコメントと同様、すべてのブロックタグは、主説明のあとに置かなければなりません。パッケージコメントファイルに \f2@see\fP タグを追加する場合は、完全指定の名前を使用する必要があります。詳細は、
+.LP
+ñʤ̾ HTML եǤꡢѥåޤǤʤդƤѥåȥեƤϡۤΤ٤ƤΥȤƱͤ HTML ǵҤޤ1 Ĥ㳰ޤϡΥɥơȤˤϡȶڤʸ Ǥ \f2/**\fP \f2*/\fP ӹƬΥꥹޤƤϤʤʤȤǤȤϡǽʸѥåγפȤ \f2<body>\fP Ⱥǽʸδ֤˥ȥ䤽¾ΥƥȤޤʤ褦ˤޤѥåޤ뤳ȤϤǤޤۤΥɥơȤƱ͡٤ƤΥ֥åϡΤȤ֤ʤФʤޤ \f2@see\fP ѥåȥեɲäˤϡ̾Ѥɬפޤܺ٤ϡ
.na
-\f2package.html\fP の例 @
+\f2package.html\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#packagecommentsを参照してください。
-.LP
-.LP
-\f3パッケージコメントファイルの処理\fP \- Javadoc ツールは、実行時にパッケージコメントファイルを自動的に検索し、このファイルを見つけると次の処理を行います。
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#packagecommentsȤƤ
+.LP
+\f3ѥåȥեν\fP \- Javadoc ġϡ¹Ի˥ѥåȥեưŪ˸ΥեĤȼνԤޤ
.RS 3
.TP 2
o
-処理できるようにコメントをコピーする (\f2package.html\fP の場合であれば、\f2<body>\fP と \f2</body>\fP HTML タグの間にある内容をすべてコピーする。\f2<head>\fP を含め、そこに \f2<title>\fP やソースファイルの著作権記述などの情報を配置することもできるが、生成後のドキュメンテーションにはそれらは一切表示されない)
+Ǥ褦˥Ȥԡ( \f2package.html\fP ξǤС \f2<body>\fP \f2</body>\fP HTML δ֤ˤƤ٤ƥԡ롣 \f2<head>\fP ޤᡢ \f2<title>\fP 䥽եҤʤɤξ֤뤳ȤǤ뤬ΥɥơˤϤϰɽʤ)
.TP 2
o
-パッケージタグがあれば、すべて処理する
+ѥåС٤ƽ
.TP 2
o
-生成したパッケージの概要ページの最後に、処理したテキストを挿入する (例:
+ѥåγץڡκǸˡƥȤ (:
.na
-\f2パッケージの概要\fP @
+\f2ѥåγ\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/applet/package\-summary.html)
.TP 2
o
-パッケージの概要ページの先頭に、パッケージコメントの最初の文をコピーする。さらに、概要ページのパッケージリストに、パッケージ名とパッケージコメントの最初の文を追加する (例:
+ѥåγץڡƬˡѥåȤκǽʸԡ롣ˡץڡΥѥåꥹȤˡѥå̾ȥѥåȤκǽʸɲä (:
.na
-\f2概要の要約\fP @
+\f2פ\fP @
.fi
-http://java.sun.com/javase/6/docs/api/overview\-summary.html)。文の末尾は、クラスやメンバーの主説明の最初の文の末尾と同じ規則によって判断される
+http://java.sun.com/javase/6/docs/api/overview\-summary.html)ʸϡ饹СμκǽʸƱ§ˤäȽǤ
.RE
-
-.LP
.SS
-概要コメントファイル
-.LP
-.LP
-ドキュメント化する各アプリケーションまたはパッケージセットは、独自の概要ドキュメンテーションコメントを持つことができ、それは専用の「ソース」ファイルに保持されます。 その内容は、Javadoc ツールによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージセット全体に当てはまるドキュメントを記述します。
-.LP
-.LP
-概要コメントファイルを作成する場合は、ファイルに任意の名前を付け、任意の場所に置くことができます。ただし、通常は、ファイル名を \f4overview.html\fP にして、ソースツリーの最上位レベルに置きます。たとえば、\f2java.applet\fP パッケージのソースファイルが \f2/home/user/src/java/applet\fP ディレクトリに含まれている場合は、\f2/home/user/src/overview.html\fP に概要コメントファイルを作成できます。
-.LP
-.LP
-異なるパッケージのセットに対して javadoc を複数回実行する場合は、同じ 1 つのソースファイルのセットに対して複数の概要コメントファイルを作成できます。たとえば、内部ドキュメンテーション用に \-private を指定して javadoc を 1 回実行したあと、公開ドキュメンテーション用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメントファイルの 1 文目で、そのドキュメンテーションを公開用または内部用として記述できます。
-.LP
-.LP
-概要コメントファイルの内容は、前述のパッケージコメントファイルと同様、HTML で記述された 1 つの大きなドキュメンテーションコメントです。詳細は、前述の説明を参照してください。要点を繰り返すと、このコメントを記述する場合は、最初の文をアプリケーションまたはパッケージセットの要約とし、\f2<body>\fP と最初の文の間にタイトルその他のテキストを含めないようにします。概要タグを含めることができます。 どのドキュメンテーションコメントについても、インラインタグ (\f2{@link}\fP など) 以外のすべてのタグは、主説明のあとに置く必要があります。\f2@see\fP タグを追加する場合は、完全指定の名前を使用しなければなりません。
-.LP
-.LP
-Javadoc ツールの実行時に、\-overview オプションを使って概要コメントファイル名を指定します。このファイルは、パッケージコメントファイルと同じように処理されます。
-.LP
+ץȥե
+.LP
+ɥȲƥץꥱޤϥѥååȤϡȼγץɥơȤĤȤǤѤΡ֥ץեݻޤƤϡJavadoc ġˤä복ץڡȤ߹ޤޤΥȤˤϡ̾ץꥱޤϥѥååΤƤϤޤɥȤҤޤ
+.LP
+ץȥեˤϡեǤդ̾ (̾ \f4overview.html\fP) դǤդξ (̾ϥĥκǾ) ֤ǤޤȤС \f2java.applet\fP ѥåΥե뤬 \f2/home/user/src/java/applet\fP ǥ쥯ȥ˳ǼƤСץȥե \f2/home/user/src/overview.html ˺Ǥޤ\fP
+.LP
+ۤʤѥåΥåȤФ javadoc ʣ¹ԤϡƱ 1 ĤΥեΥåȤФʣγץȥեǤޤȤСɥơѤ \-private ꤷ javadoc 1 ¹ԤȡɥơѤˤΥץꤷʤǺټ¹Ԥ뤳ȤǤޤξ硢Ƴץȥե 1 ʸܤǡΥɥơѤޤѤȤƵҤǤޤ
+.LP
+ץȥեƤϡҤΥѥåȥեƱ͡HTML ǵҤ줿 1 Ĥ礭ʥɥơȤǤܺ٤ϡҤȤƤ֤ȡΥȤҤϡǽʸץꥱޤϥѥååȤȤ \f2<body>\fP Ⱥǽʸδ֤˥ȥ뤽¾ΥƥȤޤʤ褦ˤޤץޤ뤳ȤǤޤۤΥɥơȤƱ \f2{@link}\fP ʤɤΥ饤٤ƤΥϡΤȤ֤ɬפޤ \f2@see\fP ɲäˤϡ̾Ѥɬפޤ
+.LP
+Javadoc ġμ¹Իˡ\-overview ץȤäƳץȥե̾ꤷޤΥեϡѥåȥեƱ褦˽ޤ
.RS 3
.TP 2
o
-\f2<body>\fP タグと \f2</body>\fP タグの間にあるすべての内容を処理のためにコピーする
+\f2<body>\fP \f2</body>\fP δ֤ˤ뤹٤ƤƤоݤȤƥԡ
.TP 2
o
-概要タグがあればすべて処理する
+ץС٤ƽ
.TP 2
o
-生成した概要ページの最後に、処理したテキストを挿入する (例:
+ץڡκǸˡƥȤ (:
.na
-\f2概要の要約\fP @
+\f2פ\fP @
.fi
http://java.sun.com/javase/6/docs/api/overview\-summary.html)
.TP 2
o
-概要ページの先頭に、概要コメントの最初の文をコピーする
+ץڡƬˡץȤκǽʸԡ
.RE
-
-.LP
.SS
-その他の未処理のファイル
-.LP
-.LP
-ソースには、Javadoc ツールによって生成先のディレクトリにコピーされる、その他の任意のファイルを含めることができます。一般に、このようなファイルには、グラフィックファイル、サンプルの Java ソース (.java) およびクラス (.class) ファイル、内容が通常の Java ソースファイルのドキュメンテーションコメントの影響を受けない独立した HTML ファイルなどがあります。
-.LP
-.LP
-未処理のファイルをソースに含めるには、それらのファイルを \f4doc\-files\fP というディレクトリに置きます。 このディレクトリは、ソースファイルがある任意のパッケージディレクトリの下に作成できます。このようなサブディレクトリは、パッケージごとに 1 つ用意できます。イメージ、サンプルコード、ソースファイル、.class ファイル、アプレット、および HTML ファイルをこのディレクトリに格納できます。たとえば、ボタンのイメージ \f2button.gif\fP を \f2java.awt.Button\fP クラスのドキュメントに含める場合は、そのファイルを \f2/home/user/src/java/awt/doc\-files/\fP ディレクトリに置きます。\f2doc\-files\fP ディレクトリを \f2/home/user/src/java/doc\-files\fP に置くことはできません。 これは、\f2java\fP はパッケージではなく、そのディレクトリそのものにソースファイルが入っていないからです。
-.LP
-.LP
-これらの未処理のファイルへのリンクは、すべて明示的に記述する必要があります。 これは、Javadoc ツールがそれらのファイルを見ずに、単にディレクトリとその内容を生成先にコピーするだけだからです。たとえば、\f2Button.java\fP のドキュメンテーションコメント内のリンクは、次のようになります。
-.LP
+¾̤Υե
+.LP
+ˤϡJavadoc ġˤäΥǥ쥯ȥ˥ԡ롢¾ǤդΥեޤ뤳ȤǤޤ̤ˡΤ褦ʥեˤϡեåե롢ץ Java (.java) ӥ饹 (.class) ե롢Ƥ̾ Java եΥɥơȤαƶʤΩ HTML եʤɤޤ
+.LP
+ʤեޤˤϡ\f4doc\-files\fP Ȥ̾Υǥ쥯ȥˤΥե֤ޤΥǥ쥯ȥϡե뤬Ǽ줿ǤդΥѥåǥ쥯ȥΥ֥ǥ쥯ȥˤޤΤ褦ʥ֥ǥ쥯ȥϡѥåȤ 1 ѰդǤޤץ륳ɡե롢.class ե롢ץåȡ HTML եΥǥ쥯ȥ˳ǼǤޤȤСܥβ \f2button.gif\fP \f2java.awt.Button\fP 饹Υɥơ˴ޤˤϡΥե \f2/home/user/src/java/awt/doc\-files/\fP ǥ쥯ȥ֤ޤʤ \f2doc\-files\fP ǥ쥯ȥ \f2/home/user/src/java/doc\-files\fP ֤뤳ȤϤǤޤʤʤ顢 \f2java\fP ϥѥåǤϤʤǤĤޤꡢjava ľܴޤޤƤ륽ե 1 Ĥ¸ߤƤޤ
+.LP
+̤ΥեؤΥϡ٤Ū˵ҤɬפޤϡJavadoc ġ뤬Υեˡñ˥ǥ쥯ȥȤƤ˥ԡǤȤС \f2Button.java\fP ΥɥơΥϡΤ褦ˤʤޤ
.nf
\f3
.fl
@@ -664,23 +386,16 @@
.fl
\fP
.fi
-
-.LP
.SS
-テストファイルおよびテンプレートファイル
-.LP
-.LP
-一部の開発者から、テストファイルおよびテンプレートファイルを対応するソースファイルの近くのソースツリーに保存したいという要望がありました。つまり、これらのソースファイルと同じディレクトリまたはサブディレクトリに保存したいということです。
-.LP
-.LP
-個別のソースファイル名で明示的に渡して Javadoc ツールを実行する場合は、テストファイルおよびテンプレートファイルを意図的に除外して、処理されないようにすることができます。ただし、パッケージ名またはワイルドカードで渡す場合は、以下のルールに従って、これらのテストファイルおよびテンプレートファイルが処理されないようにする必要があります。
-.LP
-.LP
-テストファイルとテンプレートファイルの違いは、テストファイルは、正当でコンパイル可能なソースファイルであるのに対して、テンプレートファイルは、そうではないという点です。 ただし、テンプレートファイルも「.java」で終わることができます。
-.LP
-.LP
-\f3テストファイル\fP \- 開発者の多くは、あるパッケージのコンパイル可能で実行可能なテストファイルをそのパッケージのソースファイルと同じディレクトリに配置したいと考えています。しかしテストファイルは、名前なしパッケージなど、ソースファイルパッケージとは別のパッケージに属させたいとも考えています (そのため、テストファイルには package ステートメントがないか、またはソースとは別の package ステートメントがある)。このような状況では、コマンド行で指定されているソースのパッケージ名を指定してそのソースがドキュメント化されているときに、テストファイルは警告またはエラーを引き起こします。そのようなテストファイルはサブディレクトリに配置する必要があります。\f2com.package1\fP に追加する場合は、それらのテストファイルを、ハイフンが含まれるためパッケージ名としては無効になるサブディレクトリに配置します。
-.LP
+ƥȥե뤪ӥƥץ졼ȥե
+.LP
+γȯԤ顢ƥȥե뤪ӥƥץ졼ȥեб륽եζΥĥ¸Ȥ˾ޤĤޤꡢΥեƱǥ쥯ȥޤϥ֥ǥ쥯ȥ¸ȤȤǤ
+.LP
+̤Υե̾ŪϤ Javadoc ġ¹Ԥϡƥȥե뤪ӥƥץ졼ȥետŪ˽ơʤ褦ˤ뤳ȤǤޤѥå̾ޤϥ磻ɥɤϤϡʲΥ롼˽äơΥƥȥե뤪ӥƥץ졼ȥե뤬ʤ褦ˤɬפޤ
+.LP
+ƥȥեȥƥץ졼ȥեΰ㤤ϡƥȥեϡǥѥǽʥեǤΤФơƥץ졼ȥեϡǤϤʤȤǤƥץ졼ȥե.javaפǽ뤳ȤǤޤ
+.LP
+\f3ƥȥե\fP \- ȯԤ¿ϡѥåΥѥǽǼ¹ԲǽʥƥȥեΥѥåΥեƱǥ쥯ȥ֤ȹͤƤޤƥȥեϡ̾ʤѥåʤɡեѥåȤ̤Υѥå°ȤͤƤޤ (Τᡢƥȥեˤ package ơȥȤʤޤϥȤ̤ package ơȥȤ)Τ褦ʾǤϡޥɹԤǻꤵƤ륽Υѥå̾ꤷƤΥɥȲƤȤˡƥȥեϷٹޤϥ顼ޤΤ褦ʥƥȥեϥ֥ǥ쥯ȥ֤ɬפޤȤС \f2com.package1\fP ΥեФƥȥեɲäϼΤ褦ˡϥեޤǤ뤿˥ѥå̾ȤƤ̵Ǥ褦ʥ֥ǥ쥯ȥˡΥե֤ޤ
.nf
\f3
.fl
@@ -688,248 +403,189 @@
.fl
\fP
.fi
-
-.LP
-.LP
-こうすると、Javadoc ツールでは警告なしで test ディレクトリをスキップします。
-.LP
-.LP
-テストファイルに doc コメントが含まれる場合、次のようにワイルドカードを含んだテストソースファイル名で渡してテストファイルのドキュメントを生成するように、Javadoc ツールを別個に実行できるように設定できます。 たとえば、\f2com/package1/test\-files/*.java\fP などです。
-.LP
-.LP
-\f3ソースファイルのテンプレート\fP \- テンプレートファイルの名前は「.java」で終わることもありますが、テンプレートファイルはコンパイルできません。ソースディレクトリに保持したいソースファイルのテンプレートがある場合は、このファイル名にハイフン (\f2Buffer\-Template.java\fP など) やその他の不正な Java 文字を使用します。 こうすることで、処理されないようになります。これは、Javadoc ツールが処理するのは、「.java」接尾辞を除いた名前が 正規のクラス名であるソースファイルだけであるためです (
+.LP
+ȡJavadoc ġǤϷٹʤ test ǥ쥯ȥåפޤ
+.LP
+ƥȥե doc Ȥޤޤ硢Τ褦˥磻ɥɤޤƥȥե̾ϤƥƥȥեΥɥȤ褦ˡJavadoc ġ̸Ĥ˼¹ԤǤ褦ǤޤȤС \f2com/package1/test\-files/*.java ʤɤǤ\fP
+.LP
+\f3եΥƥץ졼\fP \- ƥץ졼ȥե̾ϡ.javaפǽ뤳Ȥ⤢ޤƥץ졼ȥեϥѥǤޤǥ쥯ȥݻեΥƥץ졼Ȥϡ \f2Buffer\-Template.java\fP Τ褦˥ϥե䤽¾̵ Java ʸ̾˴ޤ뤳Ȥǡƥץ졼Ȥʤ褦ˤޤϡJavadoc ġ뤬Τϡ.java̾ Υ饹̾Ǥ륽եǤ뤿Ǥ (
.na
-\f2「識別子」\fP @
+\f2Identifiers\fP @
.fi
-http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625参照)。
-.LP
-.SH "生成されるファイル"
-.LP
-.LP
-デフォルトでは、javadoc ツールは、HTML 形式のドキュメントを生成する標準ドックレットを使います。このドックレットは、以下の種類のファイルを生成します。 それぞれの HTML ページは、個々のファイルに相当します。javadoc が生成するファイルの名前には、クラスやインタフェースの名前にちなんだものと、そうでないもの (\f2package\-summary.html\fP など) の 2 種類があります。後者のグループのファイル名には、前者のグループとファイル名が競合しないように、ハイフンが含まれています。
-.LP
-.LP
-\f3基本内容ページ\fP
-.LP
+http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)
+.SH "ե"
+.LP
+ǥեȤǤϡjavadoc ġϡHTML ΥɥȤɸɥååȤȤޤΥɥååȤϡʲμΥեޤ줾 HTML ڡϡġΥեޤjavadoc ե̾ˤϡ饹䥤ե̾ˤʤΤȡǤʤ ( \f2package\-summary.html ʤ\fP) 2 बޤԤΥ롼פΥե̾ˤϡԤΥ롼פȥե̾礷ʤ褦ˡϥեޤޤƤޤ
+.LP
+\f3ƥڡ\fP
.RS 3
.TP 2
o
-ドキュメント化するクラスまたはインタフェースごとに 1 つの\f3クラスページまたはインタフェースページ\fP (\f2クラス名\fP\f2.html\fP)
-.TP 2
-o
-ドキュメント化するパッケージごとに 1 つの\f3パッケージページ\fP (\f2package\-summary.html\fP)。Javadoc ツールは、ソースツリーのパッケージディレクトリ内に \f2package.html\fP または \f2package\-info.java\fP というファイルがあれば、その中の HTML テキストをこのページに組み入れます。
-.TP 2
-o
-パッケージセット全体に対して 1 つの\f3概要ページ\fP (\f2overview\-summary.html\fP)。これは、生成ドキュメントの先頭ページになります。Javadoc ツールは、\f2\-overview\fP オプションで指定されたファイル内の HTML テキストをこのページに組み入れます。このページのファイルは、javadoc に複数のパッケージ名を渡した場合にだけ作成されます。詳細は、「HTML フレーム」を参照してください。
-.RE
-
-.LP
-.LP
-\f3相互参照ページ\fP
-.LP
-.RS 3
-.TP 2
-o
-\f3パッケージのセット全体に対して 1 つのクラス階層ページ\fP (\f2overview\-tree.html\fP)。このページを表示するには、ナビゲーションバーの [概要] をクリックしてから、[階層ツリー] をクリックします。
+ɥȲ륯饹ޤϥեȤ 1 Ĥ\f3饹ڡޤϥեڡ\fP (\f2饹̾\fP\f2.html\fP)
.TP 2
o
-\f3パッケージごとに 1 つのクラス階層ページ\fP (\f2package\-tree.html\fP)。 特定のパッケージ、クラス、またはインタフェースのページを表示してから、[階層ツリー] をクリックすると、そのパッケージのクラス階層が表示されます。
-.TP 2
-o
-\f3パッケージごとに 1 つの [使用] ページ\fP (\f2package\-use.html\fP)と、\f3クラスおよびインタフェースごとに 1 つずつの [使用] ページ\fP (\f2class\-use/\fP\f2クラス名\fP\f2.html\fP)。このページには、特定のクラス、インタフェース、またはパッケージの一部を使っているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドについて記述されます。クラスまたはインタフェース A を例にして考えると、その [使用] ページには、A のサブクラス、A として宣言されたフィールド、A を返すメソッド、A 型のパラメータを持つメソッドおよびコンストラクタが表示されます。 このページを表示するには、まず、パッケージ、クラス、またはインタフェースのページに移動してから、ナビゲーションバーの [使用] リンクをクリックします。
-.TP 2
-o
-\f3非推奨 API ページ\fP (\f2deprecated\-list.html\fP)。 推奨されないすべての名前が一覧表示されます。非推奨名は、一般に改良された API が存在するために使用が推奨されていない API の名前であり、通常、それに置き換わる名前が提示されています。非推奨 API は、将来の実装では削除される可能性があります。
+ɥȲѥåȤ 1 Ĥ\f3ѥåڡ\fP (\f2package\-summary.html\fP)Javadoc ġϡ \f2package.html\fP ޤ \f2package\-info.java\fP Ȥ̾Υե HTML ƥȤ٤Ȥޤ
.TP 2
o
-\f3定数フィールド値ページ\fP (\f2constant\-values.html\fP)。 static フィールドの値用です。
-.TP 2
-o
-\f3直列化されたフォームページ\fP (\f2serialized\-form.html\fP)。 直列化および外部化可能なクラスです。これらの各クラスには、直列化フィールドおよびメソッドに関する説明があります。これらの情報は、API を使う開発者ではなく、再実装を行う開発者に必要な情報です。ナビゲーションバーにこのページへのリンクはありませんが、直列化されたクラスに移動して、そのクラスの説明にある [関連項目] セクションで [直列化された形式] をクリックすると、この情報を取得できます。標準ドックレットは、直列化された形式のページを自動的に生成します。ここには、Serializable を実装する public または非 public のクラスが組み込まれており、さらに、\f2readObject\fP メソッド、\f2writeObject\fP メソッド、直列化されたフィールド、および \f2@serial\fP タグ、\f2@serialField\fP タグ、\f2@serialData\fP タグからのドキュメンテーションコメントが組み込まれています。直列化が可能な public クラスを除外するには、そのクラスまたはそのクラスが属するパッケージを \f2@serial exclude\fP タグで指定します。 直列化が可能な package private クラスを含めるには、そのクラスまたはそのクラスが属するパッケージを \f2@serial include\fP タグで指定します。バージョン 1.4 では、\f2\-private\fP オプションの指定なしで javadoc ツールを実行することにより、public クラスおよび private クラスの完全に直列化されたクラスを生成できます。
-.TP 2
-o
-\f3索引\fP (\f2index\-*.html\fP)。 すべてのクラス名、インタフェース名、コンストラクタ名、フィールド名、およびメソッド名が、アルファベット順に並んでいます。索引は、Unicode を扱えるように国際化されています。 1 つのファイルとして生成することも、先頭文字 (英語の場合 A 〜 Z) ごとに別々のファイルとして生成することもできます。
+ѥåΥåΤФ 1 Ĥ\f3ץڡ\fP (\f2overview\-summary.html\fP)ϡɥȤƬڡˤʤޤJavadoc ġϡ\f2\-overview\fP ץǻꤵ줿ե HTML ƥȤ٤ȤޤΥڡΥեϡjavadoc ʣΥѥå̾Ϥˤޤܺ٤ϡHTML ե졼פȤƤ
.RE
-
-.LP
-.LP
-\f3サポートファイル\fP
-.LP
+.LP
+\f3ȥڡ\fP
.RS 3
.TP 2
o
-\f3ヘルプページ\fP (\f2help\-doc.html\fP)。 ナビゲーションバーや前述の各ページに関する説明が記載されています。\f2\-helpfile\fP を使うと、デフォルトのヘルプファイルに代わる独自のカスタムヘルプファイルを提供することもできます。
-.TP 2
-o
-表示用の HTML フレームを作成する 1 つの \f3index.html ファイル\fP。このファイルは、フレーム付きの先頭ページを表示する場合にロードします。このファイル自体には、テキスト内容は含まれていません。
+\f3ѥåΥåΤФ 1 ĤΥ饹إڡ\fP (\f2overview\-tree.html\fP)ΥڡɽˤϡʥӥС [] åƤ顢[إĥ] åޤ
.TP 2
o
-複数の\f3フレームファイル\fP (\f2*\-frame.html\fP)。 パッケージ、クラス、およびインタフェースのリストが含まれています。 HTML フレームを表示するときに使用されます。
+\f3ѥåȤ 1 ĤΥ饹إڡ\fP (\f2package\-tree.html\fP)ɽˤϡΥѥå饹ޤϥեΥڡ˰ư[إĥ] åƤΥѥåγؤɽޤ
.TP 2
o
-\f3パッケージリスト\fPファイル (\f2package\-list\fP)。 \f2\-link\fP オプションおよび \f2\-linkoffline\fP オプションで使用されます。これは、HTML ファイルではなくテキストファイルであり、どのリンクからもアクセスできません。
-.TP 2
-o
-\f3スタイルシート\fPファイル (\f2stylesheet.css\fP)。 生成されるページ上のいくつかの要素について、色、フォントファミリ、フォントサイズ、フォントのスタイル、および配置を制御します。
+\f3ѥåȤ 1 Ĥ [] ڡ\fP (\f2package\-use.html\fP) ȡ饹ӥեȤ 1 ĤĤ [] ڡ (\f2class\-use/\fP\f2饹̾\fP\f2.html\fP)ΥڡˤϡΥ饹եޤϥѥåΰȤäƤѥå饹åɡȥ饯ӥեɤˤĤƵҤޤ饹ޤϥե A ˤƹͤȡ [] ڡˤϡA Υ֥饹A Ȥ줿եɡA ֤åɡA Υѥĥåɤӥȥ饯ɽޤ Υڡɽˤϡޤѥå饹ޤϥեΥڡ˰ưƤ顢ʥӥС [] åޤ
.TP 2
o
-\f3doc\-files\fP ディレクトリ。 生成先ディレクトリにコピーするイメージ、サンプルコード、ソースコードなどのファイルがすべて格納されます。これらのファイルは、Javadoc ツールによって処理されないため、ファイル内に javadoc タグがあっても無視されます。このディレクトリは、ソースツリーの中にある場合にのみ生成されます。
+\f3侩 API ڡ\fP (\f2deprecated\-list.html\fP)侩ʤ̾٤ưɽޤ侩̾ϡ̤˲ɤ줿 API ¸ߤ뤿˻Ѥ侩Ƥʤ API ̾Ǥꡢ֤̾̾Ƥޤ侩 API ϡμǤϺǽޤ
+.TP 2
+o
+\f3եͥڡ\fP (\f2constant\-values.html\fP)static եɤѤǤ
+.TP 2
+o
+\f3ľ줿ڡ\fP (\f2serialized\-form.html\fP)ľǽijǽʥ饹˴ؤѤǤγƥ饹ˤϡľեɤӥåɤ˴ؤޤξϡAPI ȤȯԤǤϤʤƼԤȯԤɬפʾǤʥӥСˤΥڡؤΥϤޤľ줿饹˰ươΥ饹ˤִϢܡץǡľ줿פåȡξǤޤɸɥååȤľ줿ڡưޤSerializable 뤹٤ƤΥ饹 (public ޤ public) ޤޤۤ \f2readObject\fP åɤ \f2writeObject\fP åɡľեɡ \f2@serial\fP\f2@serialField\fP\f2@serialData\fP ΥɥơȤޤޤޤpublic ľǽ饹ˤϡΥ饹 (ޤϤΥѥå) \f2@serial exclude\fP ǥޡޤpackage\-private ľǽ饹ޤˤϡΥ饹 (ޤϤΥѥå) \f2@serial include\fP ǥޡޤС 1.4 Ǥ \f2\-private\fP ץλʤ javadoc ġ¹Ԥ뤳Ȥˤꡢpublic 饹 private 饹δľ줿饹Ǥޤ
+.TP 2
+o
+\f3\fP (\f2index\-*.html\fP)٤ƤΥ饹եȥ饯եɡӥåɤ̾ե٥åȽ¤ǤޤϡUnicode 褦˹ݲƤޤ1 ĤΥեȤ뤳Ȥ⡢Ƭʸ (Ѹξ A Z) Ȥ̡ΥեȤ뤳ȤǤޤ
.RE
-
-.LP
-.LP
-\f3HTML フレーム\fP
-.LP
-.LP
-Javadoc ツールは、下の図に示すように、2 〜 3 つの HTML フレームを生成します。1 つのパッケージしかない場合 (またはパッケージがない場合) は、パッケージの一覧を省略することによって最低限必要な数のフレームを作成します。単一のパッケージに属するソースファイル (*.java) または単一のパッケージ名を引数として javadoc コマンドに渡す場合は、左側の列にクラスの一覧を表示するフレーム (C) 1 つだけが作成されます。Javadoc に複数のパッケージ名を渡した場合は、概要ページ (Detail) に加えて、すべてのパッケージを一覧表示する第 3 のフレーム (P) が作成されます。この概要ページのファイル名は、\f2overview\-summary.html\fP です。したがって、このファイルは、2 つ以上のパッケージ名を渡した場合にだけ作成されます。[フレームなし] リンクをクリックするか、overview\-summary.html を最初に表示すると、フレームを省略できます。
-.LP
-.LP
-HTML フレームに慣れていない場合は、特定のフレームを印刷およびスクロールするには、そのフレームに「フォーカス」がなければならないことに注意してください。フレームにフォーカスを与えるには、そのフレームをクリックします。このようにすると、多くのブラウザでは、矢印キーやページキーを使ってそのフレームをスクロールしたり、[印刷] メニューコマンドを使ってそのフレームを印刷したりできます。
-.LP
-.nf
-\f3
-.fl
- \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
-.fl
- |C| Detail | |P| Detail |
-.fl
- | | | | | |
-.fl
- | | | |\-| |
-.fl
- | | | |C| |
-.fl
- | | | | | |
-.fl
- | | | | | |
-.fl
- \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
-.fl
- javadoc *.java javadoc java.lang java.awt
-.fl
-\fP
-.fi
-
-.LP
-.LP
-HTML フレームが必要かどうかによって、次のどちらかのファイルを開始ページとしてロードします。
-.LP
+.LP
+\f3ݡȥե\fP
.RS 3
.TP 2
o
-\f2index.html\fP (フレームあり)
+\f3إץڡ\fP (\f2help\-doc.html\fP)ʥӥСҤγƥڡ˴ؤܤƤޤǥեȤΥإץեȼΥإץեˤϡ\f2\-helpfile\fP Ѥޤ
+.TP 2
+o
+ɽѤ HTML ե졼 1 Ĥ \f3index.html ե\fPΥեϡե졼դƬڡɽ˥ɤޤΥե뼫ΤˤϡƥƤϴޤޤƤޤ
+.TP 2
+o
+ʣ\f3ե졼ե\fP (\f2*\-frame.html\fP)ѥå饹ӥեΥꥹȤޤޤƤޤHTML ե졼ɽȤ˻Ѥޤ
+.TP 2
+o
+\f3ѥåꥹ\fPե (\f2package\-list\fP) \f2\-link\fP \f2\-linkoffline\fP ץǻѤޤϡHTML եǤϤʤƥȥեǤꡢɤΥ⥢Ǥޤ
+.TP 2
+o
+\f3륷\fPե (\f2stylesheet.css\fP)ڡΤĤǤˤĤơեȥեߥꡢեȥեȤΥ롢֤椷ޤ
.TP 2
o
-\f2overview\-summary.html\fP (フレームなし)
+\f3doc\-files\fP ǥ쥯ȥꡣǥ쥯ȥ˥ԡ륤ץ륳ɡɤʤɤΥե뤬٤ƳǼޤΥեϡJavadoc ġˤäƽʤᡢե avadoc äƤ̵뤵ޤΥǥ쥯ȥϡĥˤˤΤޤ
.RE
-
-.LP
-.LP
-\f3生成されるファイルの構造\fP
-.LP
-.LP
-生成されるクラスファイルおよびインタフェースファイルは、Java ソースファイルおよびクラスファイルと同じディレクトリ階層に編成されます。1 つのサブパッケージにつき 1 つのディレクトリ、という構造になります。
-.LP
-.LP
-たとえば、\f2java.applet.Applet\fP クラスに対して生成されるドキュメントは、\f2java/applet/Applet.html\fP に格納されます。生成先のディレクトリの名前が \f2apidocs\fP だとすると、java.applet パッケージのファイル構造は、その下に構築されます。前述のように、「frame」という語を名前に含むファイルは、すべて左上または左下のフレームに表示されます。それ以外の HTML ファイルは、すべて右側のフレームに表示されます。
-.LP
+.LP
+\f3HTML ե졼\fP
+.LP
+Javadoc ġϡοޤ˼褦ˡ2 3 Ĥ HTML ե졼ޤ1 ĤΥѥåʤ (ޤϥѥåʤ) ϡѥåΰά뤳ȤˤäƺɬפʿΥե졼ޤñΥѥå°륽ե (*.java) ޤñΥѥå̾Ȥ javadoc ޥɤϤϡ¦˥饹ΰɽե졼 (C) 1 ĤޤJavadoc ʣΥѥå̾Ϥϡץڡ (Detail) ˲äơ٤ƤΥѥåɽ 3 Υե졼 (P) ޤγץڡΥե̾ϡ \f2overview\-summary.html Ǥ\fPäơΥեϡ2 İʾΥѥå̾Ϥˤޤ֥ե졼ʤץå뤫overview\-summary.html ǽɽȡե졼άǤޤ
+.LP
+HTML ե졼˴ƤʤϡΥե졼ӥ뤹ˤϡΥե졼ˡ֥եפʤФʤʤȤդƤե졼˥եͿˤϡΥե졼åޤΤ褦ˤȡ¿Υ֥饦ǤϡڡȤäƤΥե졼뤷ꡢְץ˥塼ޥɤȤäƤΥե졼Ǥޤ
+.LP
+HTML ե졼बɬפɤˤäơΤɤ餫ΥեϥڡȤƥɤޤ
.RS 3
-
-.LP
-.LP
-注 \- 下の階層図で、ディレクトリは\f3太字\fP (\f3bold\fP) で示してあります。アスタリスク (\f2*\fP) は、javadoc への引数がパッケージ名ではなくソースファイル名 (*.java) である場合に省略されるファイルおよびディレクトリを示しています。また、引数がソースファイル名の場合は、\f2package\-list\fP は作成されますが、内容は空です。doc\-files ディレクトリは、ソースツリー内に存在する場合にのみ、生成先に作成されます。
-.LP
+.TP 2
+o
+\f2index.html\fP (ե졼ढ)
+.TP 2
+o
+\f2overview\-summary.html\fP (ե졼ʤ)
.RE
+.LP
+\f3եι¤\fP
+.LP
+륯饹ե뤪ӥեեϡJava ե뤪ӥ饹եƱǥ쥯ȥ곬ؤޤ1 ĤΥ֥ѥåˤĤ 1 ĤΥǥ쥯ȥꡢȤ¤ˤʤޤ
+.LP
+ȤС \f2java.applet.Applet\fP 饹Ѥ줿ɥȤϡ \f2java/applet/Applet.html\fP ˳ǼޤΥǥ쥯ȥ̾ \f2apidocs\fP Ȥȡjava.applet ѥåΥե빽¤ϡβ˹ۤޤҤΤ褦ˡframeפȤ̾˴ޤեϡ٤ƺޤϺΥե졼ɽޤʳ HTML եϡ٤Ʊ¦Υե졼ɽޤ
+.LP
+ \- γؿޤǡǥ쥯ȥ\f3\fP (bold) ǼƤޤꥹ (\f2*\fP) ϡjavadoc ؤΰѥå̾ǤϤʤե̾ (*.java) Ǥ˾άե뤪ӥǥ쥯ȥƤޤޤե̾ξ硢 \f2package\-list\fP ϺޤȤ϶Ǥdoc\-files ǥ쥯ȥϡĥ¸ߤˤΤߡ˺ޤ
.nf
\f3
.fl
.fl
-\fP\f3apidocs\fP 最上位ディレクトリ
-.fl
- index.html HTML フレームを設定する初期ページ
-.fl
- * overview\-summary.html 全パッケージのリスト。 先頭に要約文がある
-.fl
- overview\-tree.html 全パッケージのクラス階層のリスト
-.fl
- deprecated\-list.html 全パッケージの推奨されない API のリスト
-.fl
- constant\-values.html 全パッケージの static フィールドの値のリスト
-.fl
- serialized\-form.html 全パッケージの直列化された形式のリスト
-.fl
- * overview\-frame.html 全パッケージのリスト。 左上のフレームに表示される
-.fl
- allclasses\-frame.html 全パッケージの全クラスのリスト。 左下のフレームに表示される
-.fl
- help\-doc.html これらのページの構成を示すユーザーヘルプを表示する
-.fl
- index\-all.html \-splitindex オプションなしで作成されたデフォルト索引
-.fl
- \f3index\-files\fP \-splitindex オプションを指定して作成されたディレクトリ
-.fl
- index\-<number>.html \-splitindex オプションを指定して作成された索引ファイル
-.fl
- package\-list パッケージ名のリスト。 外部参照を解決するためだけに使用される
-.fl
- stylesheet.css フォント、色、配置を定義する HTML スタイルシート
-.fl
- \f3java\fP パッケージディレクトリ
-.fl
- \f3applet\fP サブパッケージディレクトリ
-.fl
- Applet.html Applet クラスのページ
-.fl
- AppletContext.html AppletContext インタフェースのページ
-.fl
- AppletStub.html AppletStub インタフェースのページ
-.fl
- AudioClip.html AudioClip インタフェースのページ
-.fl
- * package\-summary.html このパッケージのクラスのリスト。 先頭に要約文がある
-.fl
- * package\-frame.html このパッケージのクラスのリスト。 左下のフレームに表示される
-.fl
- * package\-tree.html このパッケージのクラス階層のリスト
-.fl
- package\-use このパッケージが使用されている場所のリスト
-.fl
- \f3doc\-files\fP イメージやサンプルのファイルが格納されるディレクトリ
-.fl
- \f3class\-use\fP API が使用されている場所のページを格納するディレクトリ
-.fl
- Applet.html Applet クラスを使用するページ
-.fl
- AppletContext.html AppletContext インタフェースを使用するページ
-.fl
- AppletStub.html AppletStub インタフェースを使用するページ
-.fl
- AudioClip.html AudioClip インタフェースを使用するページ
-.fl
- \f3src\-html\fP ソースコードディレクトリ
-.fl
- \f3java\fP パッケージディレクトリ
-.fl
- \f3applet\fP サブパッケージディレクトリ
-.fl
- Applet.html Applet ソースコードのページ
-.fl
- AppletContext.html AppletContext ソースコードのページ
-.fl
- AppletStub.html AppletStub ソースコードのページ
-.fl
- AudioClip.html AudioClip ソースコードのページ
+\fP\f3apidocs\fP Ǿ̥ǥ쥯ȥ
+.fl
+ index.html HTML ե졼ꤹڡ
+.fl
+ * overview\-summary.html ѥåΥꥹȡƬʸˤդ
+.fl
+ overview\-tree.html ѥåΥ饹ؤΥꥹ
+.fl
+ deprecated\-list.html ѥå侩 API Υꥹ
+.fl
+ constant\-values.html ѥå static եɤͤΥꥹ
+.fl
+ serialized\-form.html ѥåľ줿Υꥹ
+.fl
+ * overview\-frame.html ѥåΥꥹȡΥե졼ǻѤ
+.fl
+ allclasses\-frame.html ѥå饹ΥꥹȡΥե졼ǻѤ
+.fl
+ help\-doc.html Υڡι桼إפΥꥹ
+.fl
+ index\-all.html \-splitindex ץꤷʤä˺ǥեȤκ
+.fl
+ \f3index\-files\fP \-splitindex ץꤷ˺ǥ쥯ȥ
+.fl
+ index\-<number>.html \-splitindex ץꤷ˺ե
+.fl
+ package\-list ѥå̾ΥꥹȡȤ褹뤿˻Ѥ
+.fl
+ stylesheet.css եȡ֤ HTML 륷
+.fl
+ \f3java\fP ѥåǥ쥯ȥ
+.fl
+ \f3applet\fP ֥ѥåǥ쥯ȥ
+.fl
+ Applet.html Applet 饹Υڡ
+.fl
+ AppletContext.html AppletContext եΥڡ
+.fl
+ AppletStub.html AppletStub եΥڡ
+.fl
+ AudioClip.html AudioClip եΥڡ
+.fl
+ * package\-summary.html ΥѥåΥ饹ΥꥹȡƬʸˤդ
+.fl
+ * package\-frame.html ΥѥåΥ饹ΥꥹȡΥե졼ǻѤ
+.fl
+ * package\-tree.html ΥѥåΥ饹ؤΥꥹ
+.fl
+ package\-use ΥѥåѤƤΥꥹ
+.fl
+ \f3doc\-files\fP 䥵ץեݻǥ쥯ȥ
+.fl
+ \f3class\-use\fP API ѤƤΥڡݻǥ쥯ȥ
+.fl
+ Applet.html Applet 饹λѤ˴ؤڡ
+.fl
+ AppletContext.html AppletContext եλѤ˴ؤڡ
+.fl
+ AppletStub.html AppletStub եλѤ˴ؤڡ
+.fl
+ AudioClip.html AudioClip եλѤ˴ؤڡ
+.fl
+ \f3src\-html\fP ɥǥ쥯ȥ
+.fl
+ \f3java\fP ѥåǥ쥯ȥ
+.fl
+ \f3applet\fP ֥ѥåǥ쥯ȥ
+.fl
+ Applet.html Applet ɤΥڡ
+.fl
+ AppletContext.html AppletContext ɤΥڡ
+.fl
+ AppletStub.html AppletStub ɤΥڡ
+.fl
+ AudioClip.html AudioClip ɤΥڡ
.fl
.fi
-
-.LP
.SS
-生成される API 宣言
-.LP
-.LP
-Javadoc ツールは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの説明の最初に、その API 用の宣言を生成します。 この宣言は、その API 項目の宣言です。たとえば、\f2Boolean\fP クラスの宣言は、次のようになります。
-.LP
+ API
+.LP
+Javadoc ġϡ줾Υ饹եեɡȥ饯ӥåɤκǽˡ API ѤޤȤС \f2Boolean\fP 饹ϡΤ褦ˤʤޤ
.LP
\f2public final class Boolean\fP
.br
@@ -937,29 +593,20 @@
.br
\f2implements Serializable\fP
.LP
-.LP
-また、\f2Boolean.valueOf\fP メソッドの宣言は、次のようになります。
-.LP
+ޤ \f2Boolean.valueOf\fP åɤϡΤ褦ˤʤޤ
.LP
\f2public static Boolean valueOf(String s)\fP
.LP
-.LP
-Javadoc ツールは、修飾子 \f2public\fP、\f2protected\fP、\f2private\fP、\f2abstract\fP、\f2final\fP、\f2static\fP、\f2transient\fP、および \f2volatile\fP を組み込むことができますが、\f2synchronized\fP と \f2native\fP を組み込むことができません。これら後者の 2 つの修飾子は、実装の詳細と見なされているため、API 仕様には含まれません。
-.LP
-.LP
-API では、並行性のセマンティクスについて、キーワード \f2synchronized\fP に依存するのではなく、コメントによる主説明としてドキュメント化する必要があります。 たとえば、「1 つの \f2Enumeration\fP を複数のスレッドから並行して使用することはできない」などのコメントを記述します。ドキュメントには、これらのセマンティクスを実現する方法を記述するべきではありません。たとえば、\f2Hashtable\fP はスレッドに対して安全である必要がありますが、「エクスポートされるすべてのメソッドを同期化すればそれを実現できる」のようには指定する根拠はありません。バケットレベルで内部的に同期化する権利を残しておく必要があります。 そうすれば、より高度な並行性が提供されます。
-.LP
-.SH "ドキュメンテーションコメント"
-.LP
-.LP
-オリジナルの「ドキュメンテーションコメントの仕様」は、「関連項目」を参照してください。
-.LP
+Javadoc ġǤϡ \f2public\fP \f2protected\fP \f2private\fP \f2abstract\fP \f2final\fP \f2static\fP \f2transient\fP \f2volatile\fP Ȥ߹ޤ \f2synchronized\fP \f2native\fP Ȥ߹ޤԤ 2 ĤνҤϡξܺ٤ȸʤƤ뤿ᡢAPI ͤˤϴޤޤޤ
+.LP
+API Ǥϡ¹ޥƥˤĤơ \f2synchronized\fP ˰¸ΤǤϤʤȤμȤƥɥȲ٤Ǥ \f2ȤС1 Ĥ Enumeration \fP ʣΥåɤ¹ԤƻѤ뤳ȤϤǤʤפʤɤȵҤޤɥȤˤϡΥޥƥ¸ˡҤ٤ǤϤޤȤС \f2Hashtable\fP ϥåɤФưǤɬפޤ֥ݡȤ뤹٤ƤΥåɤƱФ¸ǤפΤ褦ˤϻꤹ뺬ϤޤХåȥ٥ŪƱ븢ĤƤɬפޤС٤¹ޤ
+.SH "ɥơ"
+.LP
+ꥸʥΡ֥ɥơȤλ͡פϡִϢܡפȤƤ
.SS
-ソースコードへのコメントの挿入
-.LP
-.LP
-ソースコードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、ドキュメンテーションコメント ("doc comments") を記述することができます。各パッケージにドキュメンテーションコメントを作成できます。 構文は若干異なりますが、概要にもドキュメンテーションコメントを作成できます。ドキュメンテーションコメントは、非公式に「Javadoc コメント」と呼ばれています (この用語は商標関連の使用法に違反)。ドキュメンテーションコメントは、コメントの始まりを示す文字列 \f2/**\fP と、コメントの終わりを示す文字列 \f2*/\fP の間にある文字で構成されます。行の先頭のアスタリスクは、各行に記述できます。 詳細は、以下で説明します。コメントのテキストは、複数行にわたって記述できます。
-.LP
+ɤؤΥȤ
+.LP
+ɤǤդΥ饹եåɡȥ饯ޤϥեɤˡɥơ ("doc comments") Ҥ뤳ȤǤޤƥѥå˥ɥơȤǤޤʸϼ㴳ۤʤޤפˤɥơȤǤޤɥơȤϡˡJavadoc ȡפȸƤФƤޤ (ѸϾɸϢλˡ˰ȿ)ɥơȤϡȤϤޤʸ \f2/**\fP ȡȤʸ \f2*/\fP δ֤ˤʸ鹽ޤԤƬΥꥹϡƹԤ˵ҤǤޤܺ٤ϡʲޤȤΥƥȤϡʣԤˤ錄äƵҤǤޤ
.nf
\f3
.fl
@@ -973,26 +620,19 @@
.fl
\fP
.fi
-
-.LP
-.LP
-次のようにして 1 行に記述すると、スペースを節約できます。
-.LP
+.LP
+Τ褦ˤ 1 Ԥ˵ҤȡڡǤޤ
.nf
\f3
.fl
-/** This comment takes up only one line. */
+/** This comment takes up only one line.*/
.fl
\fP
.fi
-
-.LP
-.LP
-\f3コメントの配置\fP \- ドキュメンテーションコメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの宣言の直前に置かれているときにだけ認識されます。 クラスの例、メソッドの例、およびフィールドの例を参照してください。メソッドの本体に置かれているドキュメンテーションコメントは無視されます。javadoc ツールでは、1 つの宣言文につき 1 つのドキュメンテーションコメントだけが認識されます。
-.LP
-.LP
-よくある間違いは、クラスのコメントとクラスの宣言の間に \f2import\fP 文を置いてしまうことです。このような記述はしないでください。 このようなクラスコメントは無視されます。
-.LP
+.LP
+\f3Ȥ\fP \- ɥơȤϡ饹եȥ饯åɡޤϥեɤľ֤ƤȤˤǧޤ饹㡢åɤ㡢ӥեɤȤƤåɤΤ֤ƤɥơȤ̵뤵ޤjavadoc ġǤϡ1 ĤʸˤĤ 1 ĤΥɥơȤǧޤ
+.LP
+褯ְ㤤ϡ饹Ȥȥ饹δ֤ \f2import\fP ʸ֤ƤޤȤǤΤ褦ʵҤϤʤǤΤ褦ʥ饹Ȥ̵뤵ޤ
.nf
\f3
.fl
@@ -1014,11 +654,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3ドキュメンテーションコメントは主説明のあとにタグセクションが続く\fP \- コメントの開始区切り文字である \f2/**\fP のあとからタグセクションまでが主説明になります。タグセクションは、先頭文字が \f2@\fP である行で定義される最初のブロックタグから始まります (行の先頭のアスタリスク、空白、および行の先頭の区切り文字 \f2/**\fP は除く)。主説明を記述せず、タグセクションだけのコメントを記述することもできます。主説明は、タグセクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。 何回も記述できるタグと、1 回しか記述できないタグがあります。例えば、次の \f2@see\fP からタグセクションが始まります。
-.LP
+.LP
+\f3ɥơȤϼΤȤ˥³ \- Ȥγ϶ڤʸǤ\fP \f2/**\fP ΤȤ饿ޤǤˤʤޤϡԤƬˤǽ \f2@\fP ǽΥ֥åϤޤޤ (ƬΥꥹƬζڤʸ \f2/**\fP Ͻ)ҤΥȤҤ뤳ȤǤޤϡʹߤ³뤳ȤϤǤޤΰϡʣԤˤ錄äƵҤǤޤο¤ϤޤҤǤ륿ȡ1 ҤǤʤޤȤС \f2@see\fP ϡϤƤޤ
.nf
\f3
.fl
@@ -1032,11 +669,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3ブロックタグとインラインタグ\fP \- 「タグ」は、Javadoc が処理できる、ドキュメンテーションコメント内の特別なキーワードです。\f2@tag\fP のように記述するブロックタグ (「スタンドアロンタグ」とも呼ばれる) と、インラインタグ (\f2{@tag}\fP のように中括弧で囲んで記述) の 2 種類のタグがあります。ブロックタグが正しく解釈されるためには、行の先頭のアスタリスク、空白、区切り文字 (\f2/**\fP) を除いて、行の先頭に置かなければなりません。これは、テキスト内のそれ以外の位置で \f2@\fP 文字を使用しても、タグの開始としては解釈されないことを意味しています。行の最初に \f2@\fP 文字を使用してもタグとして解釈されないようにするには、HTML エンティティーの「\f2@\fP」を使用してください。それぞれのブロックタグには、対応付けられたテキストがあります。 このテキストは、タグのあとから、次のタグの前、またはドキュメンテーションコメントの最後までの間に記述されたテキスト (タグやコメント区切り文字を除く) です。この関連テキストは複数行にわたって記述できます。インラインタグは、テキストを記述できる場所であればどこにでも置くことができ、正しく解釈されます。次のコード例には、ブロックタグ \f2@deprecated\fP と、インラインタグ \f2{@link}\fP が含まれています。
-.LP
+.LP
+\f3֥åȥ饤\fP \- \f2֥\fPϡJavadoc Ǥ롢ɥơ̤ʥɤǤˤ 2 ढޤ1 Ĥ @tag Τ褦ɽ֥å \f2(ɸॿפȤƤФ)\fP ⤦ 1 Ĥ {@tag} Τ褦̤ǰϤޤ륤饤 \f2Ǥ\fP֥åᤵ뤿ˤϡԤƬΥꥹڤʸ (\f2/**\fP) ơԤƬ֤ʤФʤޤϡ \f2@\fP ʸƥ̤ξǻѤˤϥγϤȤƲᤵʤȤ̣ƤޤԤƬ \f2@\fP ʸѤƤ⤽줬ᤵʤ褦ˤˤϡHTML ƥƥ \f2@\fP Ѥޤ줾Υ֥åˤϡбդ줿ƥȤޤΥƥȤϡΤȤ顢ΥޤϥɥơȤκǸޤǤδ֤˵Ҥ줿ƥ (䥳ȶڤʸ) ǤδϢƥȤʣԤˤ錄äƵҤǤޤ饤ϡƥȤҤǤǤФɤˤǤ֤ȤǤᤵޤˤϥ֥å \f2@deprecated\fP ȥ饤 \f2{@link}\fP ޤޤƤޤ
.nf
\f3
.fl
@@ -1048,17 +682,12 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3コメントは HTML で記述する\fP \- テキストは HTML 形式で記述しなければなりません。 これは、HTML のエンティティーを使う必要があること、および HTML タグを使用できることを意味します。記述する HTML のバージョンとしては、使用するブラウザがサポートする任意のバージョンを使用できます。 標準ドックレットは、カスケーディングスタイルシート (CSS) とフレームを含め、すべての部分 (ドキュメンテーションコメント以外の部分) で HTML 3.2 に準拠したコードを生成するように作成されています。ただし、フレームセット対応のため、生成される各ファイルには「HTML 4.0」と記述されます。
-.LP
-.LP
-たとえば、より小さい (\f2<\fP) およびより大きい (\f2>\fP) という記号は\f2<\fP および \f2>\fP として記述する必要があります。同様に、アンパサンド (\f2&\fP) は、\f2&\fP と記述する必要があります。次の例では、ボールドの HTML タグ \f2<b>\fP を使っています。
-.LP
-.LP
-次に、ドキュメンテーションコメントを示します。
-.LP
+.LP
+\f3Ȥ HTML ǵҤ\fP \- ƥȤ HTML ǵҤʤФʤޤϡHTML ΥƥƥȤɬפ뤳ȡ HTML ѤǤ뤳Ȥ̣ޤҤ HTML ΥСȤƤϡѤ֥饦ݡȤǤդΥСѤǤޤɸɥååȤϡǥ륷 (CSS) ȥե졼ޤᡢ٤Ƥʬ (ɥơȰʳʬ) HTML 3.2 ˽ɤ褦˺Ƥޤե졼ॻåбΤᡢƥեˤϡHTML 4.0פȵҤޤ
+.LP
+ȤС꾮 (\f2<\fP) 椪Ӥ礭 (\f2>\fP) Υƥƥϡ \f2<\fP \f2>\fP ȵҤ٤ǤƱͤˡѥ (\f2&\fP) \f2&\fP ȵҤ٤ǤǤϥܡɤ HTML \f2<b>\fP Ƥޤ
+.LP
+ˡɥơȤޤ
.nf
\f3
.fl
@@ -1072,20 +701,12 @@
.fl
\fP
.fi
-
-.LP
-.LP
-\f3行頭のアスタリスク\fP \- Javadoc は、ドキュメンテーションコメントを解析するときに、各行の先頭にあるアスタリスク (\f2*\fP) をすべて破棄します。 また、最初のアスタリスク (\f2*\fP) より前の空白とタブも破棄します。バージョン 1.4 からは、行の先頭のアスタリスクを省略しても、先頭の空白文字は削除されなくなりました。このため、コード例を直接ドキュメンテーションコメントの \f2<PRE>\fP タグ内にペーストしても、インデントが保持されます。通常、ブラウザは、空白文字をタブよりも一律に解釈します。インデントは区切り文字 \f2/**\fP または \f2<PRE>\fP タグよりも左寄りになります。
-.LP
-.LP
-\f3最初の文\fP \- 各ドキュメンテーションコメントの最初の文は、宣言されているエンティティーに関する簡潔かつ完全な要約文である必要があります。この「最初の文」は、直後にスペース、タブ、または改行が続く最初のピリオド (ロケールが英語に設定されている場合)、または最初のタグがある位置で終わります。最初の文は、Javadoc ツールによって HTML ページの最初にあるメンバーの概要の部分にコピーされます。
-.LP
-.LP
-\f3複数フィールドの宣言\fP \- Java では、1 つの文で複数のフィールドを宣言できます。 ただし、この文には、1 つのドキュメンテーションコメントしか記述できません。 そのコメントが、すべてのフィールドに対してコピーされます。したがって、フィールドごとにドキュメンテーションコメントを記述する必要がある場合は、各フィールドを別々の文で宣言しなければなりません。たとえば、次のドキュメンテーションコメントは、1 つの宣言として記述すると不適切です。 この場合は、宣言を 2 つに分けることをお勧めします。
-.LP
-.RS 3
-
-.LP
+.LP
+\f3ƬΥꥹ\fP \- javadoc ˤɥơȤβϻˡƹԤƬˤ륢ꥹ (\f2*\fP) ʸ˴ޤǽΥꥹ (\f2*\fP) ʸˤ䥿֤˴ޤС 1.4 ϡԤƬΥꥹάƤ⡢ƬζʸϺʤʤޤΤᡢľܥɥơȤ \f2<PRE>\fP ˥ڡȤƤ⡢ǥȤݻޤ֥̾饦ϡʸ֤Χ˲ᤷޤǥȤεϺޡˤʤޤ (ڤʸ \f2/**\fP ޤ \f2<PRE>\fP ǤϤʤ)
+.LP
+\f3ǽʸ\fP \- ƥɥơȤκǽʸϡƤ륨ƥƥ˴ؤʷ餫ĴʸǤɬפޤΡֺǽʸפϡľ˥ڡ֡ޤϲԤ³ǽΥԥꥪ (뤬ѸꤵƤ)ޤϺǽΥ֤ǽޤǽʸϡJavadoc ġˤä HTML ڡκǽˤСγפʬ˥ԡޤ
+.LP
+\f3ʣեɤ\fP \- Java Ǥϡ1 ĤʸʣΥեɤǤޤʸˤϡ1 ĤΥɥơȤҤǤޤΥȤ٤ƤΥեɤФƥԡޤäơեɤȤ˥ɥơȤҤɬפϡƥեɤ̡ʸʤФʤޤȤСΥɥơȤϡ1 ĤȤƵҤŬڤǤξϡ 2 Ĥʬ뤳Ȥᤷޤ
.nf
\f3
.fl
@@ -1099,145 +720,105 @@
.fl
\fP
.fi
-.RE
-
-.LP
-.LP
-上記のコードからは、次のようなドキュメントが生成されます。
-.LP
-.RS 3
-
-.LP
+.LP
+嵭ΥɤϡΤ褦ʥɥȤޤ
.nf
\f3
.fl
public int \fP\f3x\fP
.fl
.fi
-
-.LP
.RS 3
The horizontal and vertical distances of point (x,y)
.RE
-
-.LP
.nf
\f3
.fl
public int \fP\f3y\fP
.fl
.fi
-
-.LP
.RS 3
The horizontal and vertical distances of point (x,y)
.RE
-
-.LP
-.RE
-.LP
-\f3見出しタグはなるべく使用しない\fP \- メンバーに対してドキュメンテーションコメントを記述するときには、<H1> や <H2> などの HTML 見出しタグは、なるべく使わないでください。 Javadoc ツールは、完全に構造化されたドキュメントを作成するので、このような構造化タグが使われていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しタグを使って独自の構造を組み立ててかまいません。
-.LP
+.LP
+\f3ФϤʤ٤Ѥʤ\fP \- СФƥɥơȤҤȤˤϡ<H1> <H2> ʤɤ HTML Фϡʤ٤ȤʤǤ Javadoc ġϡ˹¤줿ɥȤΤǡΤ褦ʹ¤ȤƤȡɥȤηƶ뤳Ȥޤ饹ѥåΥȤǤϡθФȤäȼι¤ȤΩƤƤޤޤ
.SS
-メソッドコメントの自動コピー
-.LP
-.LP
-Javadoc ツールには、次の 2 つの場合に、クラスおよびインタフェースのメソッドコメントをコピーまたは「継承」する機能があります。コンストラクタ、フィールド、および入れ子のクラスは、ドキュメンテーションコメントを継承しません。
-.LP
+åɥȤμưԡ
+.LP
+Javadoc ġˤϡ 2 Ĥξˡ饹ӥեΥåɥȤԡޤϡַѾפ뵡ǽޤȥ饯եɡҤΥ饹ϡɥơȤѾޤ
.RS 3
.TP 2
o
-\f3自動的にコメントを継承して、見つからないテキストを埋める\fP \- 主説明、または \f2@return\fP タグ、\f2@param\fP タグ、\f2@throws\fP タグが、メソッドコメントで見つからない場合、Javadoc ツールは、オーバーライドしたメソッドまたは実装している場合はそのメソッドから、対応する主説明またはタグコメントを、次のアルゴリズムに従ってコピーします。
-.LP
-厳密には、特定のパラメータの \f2@param\fP タグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の \f2@throws\fP タグが見つからない場合、その例外が宣言されている場合にかぎり、その \f2@throws\fP タグがコピーされます。
-.LP
-この動作はバージョン 1.3 以前の動作とは対照的です。 これまでのバージョンでは、主説明またはタグが存在すれば、コメントは一切継承されませんでした。
+\f3ưŪ˥ȤѾƸĤʤƥȤ\fP \- \f2@return\fP \f2@param\fP ޤ \f2@throws\fP åɥȤ˸Ĥʤ硢Javadoc ġϡС饤ɤޤϼƤϤоݤȤʤåɤ顢бޤϥȤΥ르ꥺ˽äƥԡޤ
+.LP
+̩ˤϡΥѥ \f2@param\fP Ĥʤ硢ΥѥΥȤ̤ηѾؤΥåɤ饳ԡޤ㳰 \f2@throws\fP Ĥʤ硢㳰Ƥˤꡢ \f2@throws\fP ԡޤ
+.LP
+ưϥС 1.3 ưȤоŪǤޤǤΥСǤϡޤϥ¸ߤСȤϰڷѾޤǤ
.TP 2
o
-\f3{@inheritDoc} タグを持つコメントを明示的に継承する\fP \- インラインタグ \f2{@inheritDoc}\fP を、メソッドの主説明、または \f2@return\fP、\f2@param\fP、\f2@throws\fP タグコメントに挿入します。 継承した対応する主説明またはタグコメントは、その箇所にコピーされます。
+\f3{@inheritDoc} ޤॳȤŪ˷Ѿ\fP \- 饤 \f2{@inheritDoc}\fP åɤμޤ \f2@return\fP \f2@param\fP \f2@throws\fP Τ줫ΥޤбѾ줿ޤϥȤΰ֤˥ԡޤ
.RE
-
-.LP
-.LP
-ドキュメンテーションコメントを実際にコピーに利用するには、継承したメソッドのソースファイルが \-sourcepath で指定したパスだけに置かれていることが必要になります。コマンド行で、クラスもパッケージも渡す必要はありません。この点は、クラスがドキュメント化されるクラスでなければならなかった 1.3.x 以前のリリースと異なります。
-.LP
-.LP
-\f3クラスおよびインタフェースからの継承\fP \- クラスおよびインタフェースから継承する次の 3 つの場合に、コメントの継承が行われます。
-.LP
+.LP
+ɥơȤºݤ˥ԡѤˤϡѾåɤΥե뤬 \-sourcepath ǻꤷѥ֤Ƥ뤳ȤɬפˤʤޤޥɹԤǡ饹ѥåϤɬפϤޤϡ饹ɥȲ륯饹ǤʤФʤʤä 1.3.x ΥȰۤʤޤ
+.LP
+\f3饹ӥեηѾ\fP \- 饹ӥեѾ뼡 3 ĤξˡȤηѾԤޤ
.RS 3
.TP 2
o
-クラスのメソッドがスーパークラスのメソッドをオーバーライドしている
+饹Υåɤѡ饹ΥåɤС饤ɤƤ
.TP 2
o
-インタフェースのメソッドがスーパーインタフェースのメソッドをオーバーライドしている
+եΥåɤѡեΥåɤС饤ɤƤ
.TP 2
o
-クラスのメソッドがインタフェースのメソッドを実装している
+饹ΥåɤեΥåɤƤ
.RE
-
-.LP
-.LP
-最初の 2 つのケース (メソッドがオーバーライドしている場合) では、Javadoc ツールは、そのコメントが継承されているかどうかにかかわらず、オーバーライドしているメソッドのドキュメント内に「オーバーライド」という小見出しを生成し、オーバーライドされているメソッドへのリンクを書き込みます。
-.LP
-.LP
-3 つ目のケース (特定のクラスのメソッドがインタフェースのメソッドを実装している場合) では、javadoc ツールは、オーバーライドしているメソッドのドキュメント内に「定義」という小見出しを生成し、実装されているメソッドへのリンクを書き込みます。これは、コメントが継承されているかどうかにかかわりません。
-.LP
-.LP
-\f3メソッドの説明が継承されるアルゴリズム\fP \- あるメソッドにドキュメンテーションコメントが記述されていない場合、または {@inheritDoc} タグがある場合、Javadoc ツールは、次のようなアルゴリズムを使用して適切なコメントを検索します。 このアルゴリズムは、もっとも適切なドキュメンテーションコメントを検索できるように設計されており、スーパークラスよりもインタフェースが優先されるようになっています。
-.LP
+.LP
+ǽ 2 ĤΥ (åɤС饤ɤƤ) ǤϡJavadoc ġϡΥȤѾƤ뤫ɤˤ餺С饤ɤƤåɤΥɥˡ֥С饤ɡפȤФС饤ɤƤåɤؤΥߤޤ
+.LP
+3 ܤΥ (Υ饹ΥåɤեΥåɤƤ) Ǥϡjavadoc ġϡС饤ɤƤåɤΥɥˡפȤФƤåɤؤΥߤޤϡȤѾƤ뤫ɤˤޤ
+.LP
+\f3åɤѾ륢르ꥺ\fP \- åɤ˥ɥơȤҤƤʤ硢ޤ {@inheritDoc} 硢Javadoc ġϡΤ褦ʥ르ꥺѤŬڤʥȤޤ Υ르ꥺϡäȤŬڤʥɥơȤǤ褦߷פƤꡢѡ饹⥤եͥ褵褦ˤʤäƤޤ
.RS 3
.TP 3
1.
-直接に実装されている (または、拡張されている) インタフェースを、メソッドの宣言で implements (または extends) キーワードのあとに登場する順序で、1 つずつ調べる。このメソッドについて最初に見つかったドキュメンテーションコメントを採用する
+ľܤ˼Ƥ (ޤϡĥƤ) եåɤ implements (ޤ extends) ɤΤȤо줹ǡ1 ĤĴ٤롣ΥåɤˤĤƺǽ˸ĤäɥơȤѤ
.TP 3
2.
-手順 1 でドキュメンテーションコメントが見つからなかった場合は、直接実装されている (または、拡張されている) インタフェースのそれぞれに対して、このアルゴリズム全体を再帰的に適用する (その際の順序は、手順 1 でインタフェースを調べたときの順序と同じ)
+ 1 ǥɥơȤĤʤäϡľܼƤ (ޤϡĥƤ) եΤ줾ФơΥ르ꥺΤƵŪŬѤ (κݤνϡ 1 ǥեĴ٤ȤνƱ)
.TP 3
3.
-手順 2 でドキュメンテーションコメントが見つからなかった場合で、このクラスが Object 以外のクラスである (インタフェースではない) 場合は、次のように処理する
+ 2 ǥɥơȤĤʤäǡΥ饹 Object ʳΥ饹Ǥ (եǤϤʤ) ϡΤ褦˽
.RS 3
.TP 3
a.
-スーパークラスにこのメソッドについてのドキュメンテーションコメントが記述されていれば、そのコメントを採用する
+ѡ饹ˤΥåɤˤĤƤΥɥơȤҤƤСΥȤѤ
.TP 3
b.
-手順 3a でドキュメンテーションコメントが見つからなかった場合は、スーパークラスに対して、このアルゴリズム全体を適用する
+ 3a ǥɥơȤĤʤäϡѡ饹ФơΥ르ꥺΤŬѤ
.RE
.RE
-
-.LP
-.SH "javadoc タグ"
-.LP
-.LP
-Javadoc ツールは、Java のドキュメンテーションコメント内に埋め込まれた特別なタグを解析します。これらのドキュメンテーションタグを使うと、書式の整った完全な API ドキュメントをソースコードから自動的に生成できます。タグは、単価記号 (\f2@\fP) で始まり、大文字と小文字が区別されます。 これらのタグは、定められたとおりの大文字と小文字を使用して記述する必要があります。タグは、行の先頭 (先行する空白と省略可能なアスタリスクは除く) に置かなければなりません。慣例として、同じ名前のタグは 1 か所にまとめて記述するようにします。たとえば、\f2@see\fP タグが複数ある場合は、すべてを 1 か所にまとめて記述します。
-.LP
-.LP
-タグには 2 つのタイプがあります。
-.LP
+.SH "javadoc "
+.LP
+Javadoc ġϡJava Υɥơޤ줿̤ʥϤޤΥɥơȤȡä API ɥȤɤ鼫ưŪǤޤϡ֥åȥޡ (\f2@\fP) ǻϤޤꡢʸȾʸζ̤ޤϡʸȾʸѤơɽƤȤϤɬפޤϡԤƬ (ԤȾάǽʥꥹϽ) ֤ʤФʤޤȤơƱ̾Υ 1 ˤޤȤƵҤ褦ˤޤȤС \f2@see\fP Ϥ٤Ʊ֤ޤ
+.LP
+ˤ 2 ĤΥפޤ
.RS 3
.TP 2
o
-\f3ブロックタグ\fP \- 主説明に続くタグセクション内にのみ記述可能。ブロックタグは、\f2@tag\fP の形式をとります。
+\f3֥å\fP \- ³ˤΤߵҲǽ֥åϡ \f2@tag\fP ηȤޤ
.TP 2
o
-\f3インラインタグ\fP \- コメントの主説明内またはブロックタグのコメント内に記述可能。インラインタグは、\f2{@tag}\fP のように中括弧で囲みます。
+\f3饤\fP \- ⡢ޤϥ֥åΥ˵Ҳǽ饤ϡ \f2{@tag}\fP.Τ褦̤ǰϤߤޤ
.RE
-
-.LP
-.LP
-今後のリリースで導入されるタグについては、
+.LP
+ΥƳ륿ˤĤƤϡ
.na
-\f2「Proposed Javadoc Tags」\fP @
+\f2Proposed Javadoc Tags\fP @
.fi
-http://java.sun.com/j2se/javadoc/proposed\-tags.htmlを参照してください。
-.LP
-.LP
-現時点で有効なタグは、次のとおりです。
-.LP
-.RS 3
-
-.LP
+http://java.sun.com/j2se/javadoc/proposed\-tags.htmlȤƤ
+.LP
+ͭʥϡΤȤǤ
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -1267,7 +848,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f3導入された JDK/SDK のバージョン\fP
+\f3Ƴ줿 JDK/SDK ΥС\fP
.br
.di
.nr a| \n(dn
@@ -1278,7 +859,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3タグ\fP
+.nr 38 \w\f3\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f2@author\fP
.if \n(80<\n(38 .nr 80 \n(38
@@ -1373,7 +954,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 1124 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 867 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -1392,7 +973,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3タグ\fP\h'|\n(41u'
+\&\h'|\n(40u'\f3\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -1486,74 +1067,38 @@
.rm a+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-44
-
-.LP
-.RE
-.LP
-カスタムタグについては、\-tag オプションを参照してください。
-.LP
+.LP
+ॿˤĤƤϡ\-tag ץȤƤ
.RS 3
.TP 3
@author\ name\-text
-\-author オプションが使われている場合、生成ドキュメントに「著者」の項目を追加し、指定された \f2name\-text\fP を書き込みます。1 つのドキュメンテーションコメントに複数の \f2@author\fP タグを含めることができます。1 つの \f2@author\fP タグに 1 つの名前を指定することも、1 つのタグに複数の名前を指定することもできます。前者の場合は、Javadoc ツールによって、名前と名前の間にコンマ (\f2,\fP) とスペースが挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要があるときは、1 つのタグに複数の名前を指定してください。
+\-author ץѤƤ硢ꤵ줿 \f2name\-text\fP ޤ [] ȥɥȤɲäޤ1 ĤΥɥơȤʣ \f2@author\fP ޤ뤳ȤǤޤ1 Ĥ \f2@author\fP 1 Ĥ̾ꤹ뤳Ȥ⡢ʣ̾ꤹ뤳ȤǤޤԤξϡJavadoc ġˤä̾̾δ֤˥ (\f2,\fP) ȶޤԤξϡƥΤϤ뤳ȤʤɥȤˤΤޤޥԡޤäơޤǤϤʤƸб̾ڤʸȤɬפȤϡ1 ĤΥʣ̾ꤷƤ
.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-詳細については、「タグを使用できる場所」および
+.LP
+ܺ٤ˤĤƤϡ֥ѤǤפ
.na
-\f2@author タグのドキュメント\fP @
+\f2@author Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@authorを参照してください。
-.LP
-.LP
-
-.LP
-.RE
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@authorȤƤ
+.LP
.RS 3
.TP 3
-@deprecated\ deprecated\-text
-.RS 3
-
-.LP
-.LP
-注: JDK 5.0 から、
-.na
-\f2@Deprecated 注釈\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/deprecation.htmlを使って特定のプログラム要素を非推奨にできるようになりました。
-.LP
-.RE
+@deprecated\ deprecated\-text : @Deprecated ȤäΥץǤ侩ˤǤޤ
.RE
-.RS 3
-
-.LP
-.LP
-この API は動作し続けますが、この API を使用するべきではないことを示すコメントを追加します。Javadoc ツールは、\f2deprecated\-text\fP を主説明の前に移動してイタリックにし、その前にボールドの警告「推奨されません。」を追加します。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
-.LP
-.LP
-\f2deprecated\-text\fP の最初の文では、少なくとも、その API が推奨されなくなった時期と、代替使用するべき API を読者に提示する必要があります。Javadoc ツールは、この最初の文だけを、概要セクションと索引にコピーします。そのあとの文では、その API が推奨されない理由を説明することもできます。また、代わりの API を指し示す \f2{@link}\fP タグ (Javadoc 1.2 以降の場合) を含める必要があります。 次のように記述します。
-.LP
-.LP
-詳細については、
+.LP
+ API ư³ޤ API Ѥ٤ǤϤʤȤȤɲäޤJavadoc ġϡ \f2deprecated\-text\fP ˰ưƥåˤ˥ܡɤηٹֿ侩ޤפɲäޤΥϡ٤ƤΥɥơȡĤޤ공סѥå饹եȥ饯åɡӥեɤͭǤ
+.LP
+\f2deprecated\-text\fP κǽʸǤϡʤȤ⡢ API 侩ʤʤäȡػѤ٤ API ɼԤɬפޤJavadoc ġϡκǽʸץȺ˥ԡޤΤȤʸǤϡ API 侩ʤͳ뤳ȤǤޤAPI ؤ \f2{@link}\fP ( Javadoc 1.2 ʹߤξ) ޤ٤Ǥ
+.LP
+ܺ٤ˤĤƤϡ
.na
-\f2@deprecated タグのドキュメント\fP @
+\f2@deprecated Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecatedを参照してください。
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecatedȤƤ
.RS 3
.TP 2
o
-Javadoc 1.2 以降では、\f2{@link}\fP タグを使用します。これにより、必要な場所にインラインでリンクを作成できます。例を示します。
-.RE
-
-.LP
-.RS 3
-
-.LP
+Javadoc 1.2 ʹߤǤ \f2{@link}\fP Ѥޤˤꡢɬפʾ˥饤ǥǤޤȤС
.nf
\f3
.fl
@@ -1567,106 +1112,71 @@
.fl
\fP
.fi
-.RE
-
-.LP
-.RS 3
.TP 2
o
-Javadoc 1.1 では、各 \f2@deprecated\fP タグに対して \f2@see\fP タグ (インラインにはできない) を記述するのが標準の形式です。
+Javadoc 1.1 ξɸϡ \f2@see\fP (饤Բ) \f2@deprecated\fP Ȥ˺뤳ȤǤ
.RE
-
-.LP
-.LP
-推奨されないタグについての詳細は、
+.LP
+侩ʤˤĤƤξܺ٤ϡ
.na
-\f2@deprecated タグ\fP @
+\f2@deprecated \fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.htmlのドキュメントを参照してください。
-.LP
-.LP
-
-.LP
-.RE
+http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.htmlΥɥȤȤƤ
+.LP
.RS 3
.TP 3
{@code\ text}
-\f2<code>{@literal}</code>\fP と同等です。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-テキストを HTML マークアップまたは入れ子になった javadoc タグとして解釈せずに、\f2text\fP を \f2code\fP フォントで表示します。これにより doc コメントでは、パラメータの種類 (\f2<Object>\fP)、不等号 (\f23 < 4\fP)、または矢印 (\f2<\-\fP) などで、HTML エンティティー (\f2<\fP および \f2>\fP) ではなく、通常の山括弧 (\f2<\fP および \f2>\fP) を使用できます。たとえば doc コメントのテキスト
-.LP
+\f2<code>{@literal}</code>\fP ƱǤ
+.LP
+ƥȤ \f2HTML ޡå\fP ޤ \f2Ҥˤʤä javadoc \fP ȤƲ᤻ˡtext ɥեȤɽޤΤᡢɥơ̾λ (\f2<\fP \f2>\fP) HTML ƥƥ (\f2<\fP \f2>\fP) ˻ѤǤޤȤСѥη (\f2<Object>\fP) (\f23 < 4\fP) (\f2<\-\fP) ʤɤǤȤСΥɥơ
.nf
\f3
.fl
\fP\f4{@code A<B>C}\fP\f3
.fl
+
+.fl
+\fP
+.fi
+.LP
+ϡ줿 HTML ڡǡΤ褦ˤΤޤɽޤ
+.nf
+\f3
+.fl
+ \fP\f4A<B>C\fP\f3
+.fl
+
+.fl
+\fP
+.fi
+.LP
+ܤ٤ϡ \f2<B>\fP ȤƲᤵ줺ΥեȤϥɥեȤˤʤ롢ȤǤ
+.LP
+ɥեȤʤƱǽ¸ˤϡ\f2{@literal}\fP Ѥޤ
+.LP
+.TP 3
+{@docRoot}
+ڡ鸫ɥȤ () 롼ȥǥ쥯ȥؤХѥɽޤΥϡΥڡҤΥʤɡ뤹٤ƤΥڡ黲ȤեȤ߹ȤǤ̾ϡƥڡβΥڡ˥ޤ
+.LP
+ \f2{@docRoot}\fP ϡޥɹԤǤɥơǤѤǤޤΥϡ@return@param@deprecated ʤɤǤդΥΥƥʬޤࡢ٤ƤΥɥơȡĤޤ공סѥå饹եȥ饯åɡӥեɤͭǤ
+.RS 3
+.TP 3
+1.
+ޥɹԤǤϡإåեåޤϥܥȥΡȤϼΤ褦ޤ
+.nf
+\f3
+.fl
+ javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
+.fl
.fl
\fP
.fi
-
-.LP
-.LP
-は、生成された HTML ページで、次のようにそのまま表示されます。
-.LP
-.nf
-\f3
-.fl
- \fP\f4A<B>C\fP\f3
-.fl
-
-.fl
-\fP
-.fi
-
-.LP
-.LP
-注目すべき点として、\f2<B>\fP は太字であると解釈されませんが、コードフォントになります。
-.LP
-.LP
-コードフォントなしで同じ機能を実現するには、\f2{@literal}\fP を使用します。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
-.TP 3
-{@docRoot}
-生成されるページから見た、生成ドキュメントの (生成先の) ルートディレクトリへの相対パスを表します。このタグは、著作権のページや会社のロゴなど、生成されるすべてのページから参照するファイルを組み込むときに便利です。通常は、各ページの下部から著作権のページにリンクします。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-この \f2{@docRoot}\fP タグは、コマンド行からも、ドキュメンテーションコメントの中でも使用できます。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
-.LP
-.RS 3
-.TP 3
-1.
-コマンド行では、ヘッダー、フッター、またはボトムノートは次のように定義します。
-.nf
-\f3
-.fl
- javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
-.fl
-
-.fl
-\fP
-.fi
-.LP
-\- \f2{@docRoot}\fP をこのように利用する場合、一部の Makefile プログラムでは、中括弧 { } 文字をエスケープする必要があります。たとえば、Inprise MAKE バージョン 5.2 を Windows 上で実行する場合は、「\f2{{@docRoot}}\fP」のように、中括弧を二重にする必要があります。さらに、\f2\-bottom\fP などのオプションに対する引数を、単一引用符ではなく、二重引用符で囲む必要があります。 \f2href\fP 引数の値を囲む引用符は省略します。
+.LP
+ \- \f2{@docRoot}\fP Makefile ǤΤ褦Ѥ硢 Makefile ץǤϡ { } ʸפɬפޤȤСInprise MAKE С 5.2 Windows Ǽ¹Ԥϡ \f2{{@docRoot}} Τ褦ˡ̤Ťˤɬפޤ\fPˡ \f2\-bottom\fP ʤɤΥץФñǤϤʤŰǰϤɬפ⤢ޤ ( \f2href\fP ΰϤϾά)
.TP 3
2.
-ドキュメンテーションコメントの中では、次のように使用します。
+ɥơȤǤϡΤ褦˻Ѥޤ
.nf
\f3
.fl
@@ -1676,16 +1186,13 @@
.fl
*/
.fl
-
+
.fl
\fP
.fi
.RE
-
-.LP
-.LP
-このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。次に例を示します。
-.LP
+.LP
+ΥɬפͳϡɥȤ֥ѥåƱijع¤Υǥ쥯ȥ˳Ǽ뤫Ǥޤ
.nf
\f3
.fl
@@ -1695,201 +1202,118 @@
.fl
\fP
.fi
-
-.LP
-.LP
-次のように解決されます。
-.LP
+.LP
+Τ褦˲褵ޤ
.nf
\f3
.fl
- <a href="../../copyright.html"> java/lang/Object.java の場合
+ <a href="../../copyright.html"> java/lang/Object.java ξ
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-および
-.LP
+.LP
+
.nf
\f3
.fl
- <a href="../../../copyright.html"> java/lang/ref/Reference.java の場合
+ <a href="../../../copyright.html"> java/lang/ref/Reference.java ξ
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
.TP 3
@exception\ class\-name\ description
-\f2@exception\fP タグは、\f2@throws\fP タグと同義です。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+\f2@exception\fP \f2@throws\fP ƱǤ
+.LP
.TP 3
{@inheritDoc}\
-もっとも近い継承可能なクラスまたは実装可能なインタフェースから、このタグの現在のドキュメンテーションコメントに、ドキュメントを継承 (コピー) します。この機能により、より汎用的なコメントを継承ツリーの上位に記述し、コピーしたテキストを使って記述することができます。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-このタグは、ドキュメンテーションコメントの次の位置でのみ有効です。
-.LP
+äȤᤤѾǽʥ饹ޤϼǽʥե顢ΥθߤΥɥơȤˡɥȤѾ (ԡ) ޤεǽˤꡢŪʥȤѾĥξ̤˵ҤԡƥȤȤäƵҤ뤳ȤǤޤ
+.LP
+ΥϡɥơȤμΰ֤ǤΤͭǤ
.RS 3
.TP 2
o
-メソッドの主説明ブロック内。この場合、主説明は、上位階層のクラスまたはインタフェースからコピーされる
+åɤμ֥å⡣ξ硢ϡ̳ؤΥ饹ޤϥե饳ԡ
.TP 2
o
-メソッドの @return、@param、@throws タグのテキスト引数内。この場合、タグテキストは、上位階層の対応するタグからコピーされる
+åɤ @return@param@throws ΥƥȰ⡣ξ硢ƥȤϡ̳ؤб륿饳ԡ
.RE
-
-.LP
-.LP
-継承階層でコメントを見つける方法に関する正確な説明について、「メソッドコメントの自動コピー」を参照してください。このタグが見つからない場合、コメントは、この節で説明するルールに応じて、自動的に継承されるかどうかが決まります。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+ѾؤǥȤĤˡ˴ؤΤˤĤơ֥åɥȤμưԡפȤƤΥĤʤ硢Ȥϡ롼˱ơưŪ˷Ѿ뤫ɤޤޤ
+.LP
.TP 3
-{@link\ \ package.class#member\ \ label}\
-表示テキスト \f2label\fP とのインラインリンクを挿入します。 \f2label\fP は、参照クラスの指定されたパッケージ、クラス、またはメンバーの名前のドキュメンテーションを指し示します。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-このタグは、\f2@see\fP タグとよく似ています。 どちらのタグも、\f2package.class\fP\f2#\fP\f2member\fP および \f2label\fP の参照の仕方が同じで、有効な構文もまったく同じです。大きな違いは、\f2{@link}\fP は、リンクを [関連項目] セクションに置くのではなく、インラインリンクを生成するということです。また、インラインテキストのほかの部分と区別するために、\f2{@link}\fP タグの最初と最後に中括弧を記述します。ラベルの中で「}」を使う必要がある場合は、HTML エンティティーの「}」を使います。
-.LP
-.LP
-1 つの文の中で使用できる \f2{@link}\fP タグの数に制限はありません。このタグは、ドキュメンテーションコメントの主説明部分、または @deprecated、@return、@param などの任意のタグのテキスト部分で使うことができます。
-.LP
-.LP
-たとえば、次のコメントでは \f2getComponentAt(int, int)\fP メソッドを参照しています。
-.LP
+{@link\ package.class#member\ label}
+ɽƥ \f2label\fP ȤΥ饤ޤlabel ϡȥ饹λꤵ줿ѥå饹ޤϥС̾ΥɥơؤޤΥϡ@return@param@deprecated ʤɤǤդΥΥƥʬޤࡢ٤ƤΥɥơȡĤޤ공סѥå饹եȥ饯åɡӥեɤͭǤ
+.LP
+Υ \f2@see\fP ˤ褯Ƥޤɤ⡢\f2package.class\fP\f2#\fP\f2member\fP \f2label\fP λȤλƱǡͭʹʸޤäƱǤ礭ʰ㤤ϡ \f2{@link}\fP Ǥϡ[Ϣ] ˥֤ˡ饤ΥȤǤޤ饤ƥȤΤۤʬȶ̤뤿ˡ \f2{@link}\fP κǽȺǸ̤Ҥޤ٥ǡ}פȤɬפϡHTML ƥƥΡ}פȤޤ
+.LP
+1 ʸǻѲǽ \f2{@link}\fP ο¤ϤޤΥϡɥơȤμʬޤ @deprecated@return@param ʤɤǤդΥΥƥʬǻȤȤǤޤ
+.LP
+ȤСΥȤǤ \f2getComponentAt(int, int)\fP åɤȤƤޤ
.nf
\f3
.fl
-{@link #getComponentAt(int, int) getComponentAt} メソッドを使用します。
+{@link #getComponentAt(int, int) getComponentAt} åɤѤޤ
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-標準ドックレットでは、上記のコメントから次の HTML が生成されます (このコメントが同じパッケージの別のクラスを参照している場合)。
-.LP
+.LP
+ɸɥååȤǤϡ嵭ΥȤ鼡 HTML ޤ (ΥȤƱѥå̤Υ饹ȤƤ)
.nf
\f3
.fl
-<a href="Component.html#getComponentAt(int, int)">getComponentAt</a> メソッドを使用します。
+<a href="Component.html#getComponentAt(int, int)">getComponentAt</a> åɤѤޤ
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-この HTML は、Web ページ上では次のように表示されます。
-.LP
+.LP
+ HTML ϡWeb ڡǤϼΤ褦ɽޤ
.nf
\f3
.fl
-getComponentAt メソッドを使用します。
+getComponentAt åɤѤޤ
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-\f2{@link}\fP を、ドキュメント化の対象にしていないクラスにまで拡張するには、\f2\-link\fP オプションを使用します。
-.LP
-.LP
-詳細については、
+.LP
+\f2{@link}\fP ĥƥɥȲʤ饹ؤΥǽˤˤϡ\f2\-link\fP ץѤޤ
+.LP
+ܺ٤ˤĤƤϡ
.na
-\f2{@link} タグのドキュメント\fP @
+\f2{@link} Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#{@link}を参照してください。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#{@link}ȤƤ
+.LP
.TP 3
{@linkplain\ package.class#member\ label}
-リンクのラベルがコードフォントではなくプレーンテキストで表示される点以外は \f2{@link}\fP と同じです。ラベルがプレーンテキストで記述されていると便利です。例:
-.RE
-
-.LP
-.RS 3
-
-.LP
+Υ٥뤬ɥեȤǤϤʤץ졼ƥȤɽʳ \f2{@link}\fP ƱǤ٥뤬ץ졼ƥȤǵҤƤǤȤƤ:
.nf
\f3
.fl
- {@linkplain add() the overridden method} を参照してください。
+ {@linkplain add() the overridden method} ȤƤ
.fl
.fl
\fP
.fi
-
-.LP
-.LP
-これは以下のように表示されます。
-.LP
-.RS 3
-
-.LP
-.LP
-the overridden method を参照してください。
-.LP
-.RE
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+ϰʲΤ褦ɽޤ
+.LP
+the overridden method ȤƤ
+.LP
.TP 3
{@literal\ text}
-テキストを HTML マークアップまたは入れ子になった javadoc タグとして解釈せずに、\f2text\fP を表示します。これにより doc コメントでは、パラメータの種類 (\f2<Object>\fP)、不等号 (\f23 < 4\fP)、または矢印 (\f2<\-\fP) などで、HTML エンティティー (\f2<\fP および \f2>\fP) ではなく、通常の山括弧 (\f2<\fP および \f2>\fP) を使用できます。たとえば doc コメントのテキスト
-.RE
-
-.LP
-.RS 3
-
-.LP
+ƥȤ HTML ޡåפޤҤˤʤä javadoc ȤƲ᤻ˡ \f2text\fP ɽޤΤᡢɥơ̾λ (\f2<\fP \f2>\fP) HTML ƥƥ (\f2<\fP \f2>\fP) ˻ѤǤޤȤСѥη (\f2<Object>\fP) (\f23 < 4\fP) (\f2<\-\fP) ʤɤǤȤСΥɥơ
.nf
\f3
.fl
@@ -1899,40 +1323,22 @@
.fl
\fP
.fi
-
-.LP
-.LP
-は、生成された HTML ページはブラウザで次のようにそのまま表示されます。
-.LP
-.LP
-\f2\ \ \ \ \ \fPA<B>C
-.LP
-.LP
-注目すべき点として、\f2<B>\fP は太字であると解釈されません (コードフォントにならない)。
-.LP
-.LP
-コードフォントで同じ機能を実現するには、\f2{@code}\fP を使用します。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+ϡ줿 HTML ڡϥ֥饦ǼΤ褦ˤΤޤɽޤ
+.LP
+\f2\ \ \ \ \ \fPA<B>C
+.LP
+ܤ٤ϡ \f2<B>\fP ȤƲᤵ줺ΥեȤϥɥեȤˤʤ롢ȤǤ
+.LP
+ɥեȤƱǽ¸ˤϡ\f2{@code}\fP Ѥޤ
+.LP
.TP 3
@param\ parameter\-name description
-指定した \f2parameter\-name\fP と指定した \f2description\fP を使用してパラメータを「Parameters」セクションに追加します。doc コメントを記述するときは、\f2description\fP を複数行に続けることができます。このタグは、メソッド、コンストラクタ、またはクラスの doc コメント内でのみ有効です。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f2parameter\-name\fP は、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタのタイプパラメータの名前になります。山括弧でパラメータ名を囲むと、型パラメータを使用することを指定します。
-.LP
-.LP
-クラスの型パラメータの例:
-.LP
+ꤵ줿 \f2parameter\-name\fP ΤȤ˻ꤵ줿 \f2description\fP ³ѥ[ѥ] ɲäޤɥơȤҤȤˤϡ \f2description\fP ʣԤˤ錄äƵҤ뤳ȤǤޤΥϡåɡȥ饯ޤϥ饹 doc ǤΤͭǤ
+.LP
+\f2parameter\-name\fP ϡåɤޤϥȥ饯ǤΥѥ̾饹åɤޤϥȥ饯Υץѥ̾ˤʤޤ̤ǥѥ̾ϤȡѥѤ뤳Ȥ ꤷޤ
+.LP
+饹ηѥ:
.nf
\f3
.fl
@@ -1950,11 +1356,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-メソッドの型パラメータの例:
-.LP
+.LP
+åɤηѥ:
.nf
\f3
.fl
@@ -1978,125 +1381,87 @@
.fl
\fP
.fi
-
-.LP
-.LP
-詳細については、
+.LP
+ܺ٤ˤĤƤϡ
.na
-\f2@param タグのドキュメント\fP @
+\f2@param Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@paramを参照してください。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@paramȤƤ
+.LP
.TP 3
@return\ description
-[戻り値] セクションを追加して、\f2description\fP のテキストを書き込みます。このテキストでは、戻り値の型と、取り得る値の範囲について記述する必要があります。このタグは、メソッドのドキュメンテーションコメントでのみ有効です。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-詳細については、
+[] ɲäơ \f2description\fP ΥƥȤߤޤΥƥȤǤϡͤηȡͤϰϤˤĤƵҤɬפޤΥϡåɤΥɥơȤǤΤͭǤ
+.LP
+ܺ٤ˤĤƤϡ
.na
-\f2@return タグのドキュメント\fP @
+\f2@return Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@returnを参照してください。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@returnȤƤ
+.LP
.TP 3
-@see\ \ reference
-[関連項目] 見出しを追加し、\f2reference\fP を指すリンクか、またはテキストエントリを書き込みます。1 つのドキュメンテーションコメントには、任意の数の \f2@see\fP タグを指定できます。 すべての \f2@see\fP タグの内容は、同じの見出しの下にグループ化されます。\f2@see\fP タグには、次の 3 種類の形式があります。 もっともよく使われるのは、3 番目の形式です。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。パッケージ、クラス、またはメンバーに対するインラインリンクを文中に挿入する方法は、\f2{@link}\fP を参照してください。
+@see\ reference
+ִϢܡФɲä \f2reference ؤޤϥƥȥȥߤޤ\fPɥơȤˤǤդο \f2@see\fP ޤ뤳ȤǤޤϤ٤ƱФβ˥롼ײޤ \f2@see\fP ˤϡ 3 ηޤäȤ褯ȤΤϡ3 ܤηǤΥϡ٤ƤΥɥơȡĤޤ공סѥå饹եȥ饯åɡӥեɤͭǤѥå饹ޤϥСФ륤饤ʸˡϡ\f2{@link}\fP ȤƤ
.RS 3
.TP 3
@see "string"
-\f2string\fP のテキストエントリを追加します。リンクは生成されません。\f2string\fP は、書籍または URL ではアクセスできない情報の参照先です。Javadoc ツールは、最初の文字が二重引用符 (\f2"\fP) かどうかを調べて、この形式をほかの 2 つの形式と区別します。例を示します。
+\f2string Υƥȥȥɲäޤ\fPޤ \f2string\fP ϡҤޤ URL ǤϥǤʤλǤJavadoc ġϡǽʸŰ (\f2"\fP) ɤĴ٤ơηۤ 2 Ĥηȶ̤ޤȤС
.nf
\f3
.fl
@see "The Java Programming Language"
.fl
-
-.fl
-\fP
-.fi
-.LP
-これは次のようなテキストを生成します。
-.RE
-.RS 3
-.RS 3
-
-.LP
-.RS 3
-.TP 3
-関連項目:
-The Java Programming Language
-.RE
-
-.LP
-.RE
-.RE
-.TP 3
-@see <a href="URL#value">label</a>
-\f2URL\fP#\f2value\fP で定義されたとおりにリンクを追加します。\f2URL\fP#\f2value\fP は、相対 URL または絶対 URL です。Javadoc ツールは、最初の文字が「より小さい」記号 (\f2<\fP) かどうかを調べて、この形式をほかの 2 つの形式と区別します。例を示します。
-.nf
-\f3
-.fl
- @see <a href="spec.html#section">Java Spec</a>
-.fl
.fl
\fP
.fi
.LP
-これは次のようなリンクを生成します。
-.RS 3
-.RS 3
-.TP 3
-関連項目:
-Java Spec
-.RE
+ϼΤ褦ʥƥȤޤ
.RE
.RE
.RS 3
-
-.LP
-.LP
-
-.LP
-.RE
+.RS 3
+.RS 3
.RS 3
.TP 3
+Ϣ:
+The Java Programming Language
+.RE
+.RE
+.TP 3
+@see <a href="URL#value">label</a>
+\f2URL\fP#\f2value\fP 줿Ȥ˥ɲäޤ \f2URL\fP#\f2value\fP URL ޤ URL ǤJavadoc ġϡǽʸ֤꾮 (\f2<\fP) ɤĴ٤ơηۤ 2 Ĥηȶ̤ޤȤС
+.nf
+\f3
+.fl
+ @see <a href="spec.html#section">Java Spec</a>
+.fl
+\fP
+.fi
+ϼΤ褦ʥޤ
+.RS 3
+.TP 3
+Ϣ:
+Java Spec
+.RE
+.TP 3
@see\ package.class#member\ label
-指定された名前を持つ、参照されている Java 言語のメンバーについてのドキュメントを指すリンクを、表示テキスト \f2label\fP とともに追加します。\f2label\fP は省略可能です。 \f2label\fP を省略すると、リンク先のメンバーの名前が適切に短縮されて表示されます。 「名前が表示される方法」を参照してください。\-noqualifier を使用すると、表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストを指定する場合に使います。
-.LP
-バージョン 1.2 だけは、ラベルではなく、名前が <code> HTML タグ内に自動的に表示されます。 1.2.2 からは、ラベルを使用するか、しないかにかかわらず、<code> は常に表示テキストを囲むかたちで、含まれます。
+ĻΥƥ \f2label\fP ĥɲäޤΥϡȤʤ롢ꤵ줿 Java ̾Υɥơؤޤ \f2label\fP ϾάǽǤlabel άȡΥС̾Ŭڤṳ̂ɽޤ ̾ɽˡפȤƤ\-noqualifier ѤȡɽƥȤѥå̾Ū˺ޤ٥ϡưɽƥȤȤϰۤʤɽƥȤꤹ˻Ȥޤ
+.LP
+С 1.2 ϡ٥ǤϤʤ̾ <code> HTML ˼ưŪɽޤ 1.2.2 ϡ٥Ѥ뤫ʤˤ餺<code> ϾɽƥȤϤफǡޤޤޤ
.LP
.RS 3
.TP 2
o
-\f4package.class\fP\f4#\fP\f4member\fP には、参照されている任意の有効なプログラム要素の名前を指定します。 つまり、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの名前です。 ただし、メンバー名ーの前のドットは、シャープ記号 (\f2#\fP) で置き換えます。\f2class\fP は、任意のトップレベルまたは入れ子にされたクラスまたはインタフェースを表します。\f2member\fP は、任意のコンストラクタ、メソッドまたはフィールド (入れ子にされたクラスまたはインタフェースではない) を表します。指定した名前が、ドキュメント化されているクラスに含まれている場合、Javadoc ツールは、その名前へのリンクを自動的に作成します。外部参照クラスへのリンクを作成するには、\f2\-link\fP オプションを使います。参照クラスに属していない名前のドキュメントを参照するには、ほかの 2 つの形式の \f2@see\fP タグを使います。この引数については、このあとの「名前の指定」で詳しく説明します。
-.TP 2
-o
-\f4label\fP は、省略可能なテキストで、リンクのラベルとして表示されます。\f2label\fP には空白を含めることができます。\f2label\fP を省略すると、\f2package.class.member\fP が、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。 「名前が表示される方法」を参照してください。
+\f4package.class\fP\f4#\fP\f4member\fP ˤϡȤƤǤդͭʥץǤ̾ꤷޤĤޤꡢѥå饹եȥ饯åɡޤϥեɤ̾ǤС̾ΥɥåȤϡ㡼 (\f2#\fP) ֤ޤ \f2class\fP ϡǤդΥȥåץ٥ޤҤˤ줿饹ޤϥեɽޤ \f2member\fP ϡǤդΥȥ饯åɤޤϥե (Ҥˤ줿饹ޤϥեǤϤʤ) ɽޤꤷ̾ɥȲƤ륯饹˴ޤޤƤ硢Javadoc ġϡ̾ؤΥưŪ˺ޤȥ饹ؤΥˤϡ\f2\-link\fP ץȤޤΥ饹°Ƥʤ̾ΥɥơȤˤϡĤ 2 Ĥ \f2@see\fP ΤΤɤ餫ѤޤΰˤĤƤϡΤȤΡ̾λפǾܤޤ
.TP 2
o
-空白文字は、\f2package.class\fP\f2#\fP\f2member\fP と \f2label\fP の間の区切り文字です。括弧の内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。
+\f4label\fP ϡάǽʥƥȤǡΥ٥Ȥɽޤ \f2label\fP ˤ϶ޤ뤳ȤǤޤ \f2label\fP άȡ\f2package.class.member\fP ߤΥ饹ӥѥå˱Ŭڤṳ̂ɽޤ̾ɽˡפȤƤ
+.TP 2
+o
+ \f2package.class\fP\f2#\fP\f2member\fP \f2label\fP δ֤ζڤʸˤʤޤ̤¦ζʸϥ٥ƬȤϲᤵʤᡢåɤΥѥ֤˶ʸƤ⤫ޤޤ
.RE
.LP
-\f3例\fP \- この例では、\f2Character\fP クラスにある \f2@see\fP タグが、\f2String\fP クラスの \f2equals\fP メソッドを参照しています。タグには、名前 \f2String#equals(Object)\fP とラベル \f2equals\fP の両方の引数が含まれています。
-.RS 3
-
-.LP
+\f3\fP \- Ǥϡ \f2@see\fP ( \f2Character\fP 饹) String 饹 \f2equals\fP å \f2\fP ƤޤΥˤ̾\f2String#equals(Object)\fPפȥ٥\f2equals\fPפξΰޤޤƤޤ
.nf
\f3
.fl
@@ -2106,62 +1471,33 @@
.fl
*/
.fl
-
-.fl
\fP
.fi
-.RE
-.LP
-標準ドックレットは、次のような HTML を生成します。
-.RS 3
-
-.LP
+ɸɥååȤϡΤ褦 HTML ޤ
.nf
\f3
.fl
<dl>
.fl
-<dt><b>See also:</b>
+<dt><b>See Also:</b>
.fl
<dd><a href="../../java/lang/String#equals(java.lang.Object)"><code>equals<code></a>
.fl
</dl>
.fl
-
-.fl
\fP
.fi
-.RE
-.LP
-これは、ブラウザでは次のように表示され、ラベルがリンクテキストになります。
-.RS 3
+ϡ֥饦ǤϼΤ褦ɽ졢٥뤬ƥȤˤʤޤ
.RS 3
.TP 3
-関連項目:
+Ϣ:
equals
.RE
-.RE
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-
-.LP
-.LP
-\f3名前の指定\fP \- このタグに指定する \f2package.class\fP\f2#\fP\f2member\fP という名前は、\f2java.lang.String#toUpperCase()\fP のように完全指定することも、\f2String#toUpperCase()\fP や \f2#toUpperCase()\fP のように部分的に指定することもできます。名前が完全指定されていない場合、Javadoc ツールは、Java コンパイラの通常の検索順序でその名前を検索します。詳細は、このあとの「@see の検索順序」を参照してください。名前には、メソッドの複数の引数の間など、括弧の内側であれば空白を含めることができます。
-.LP
-.LP
-「部分的に指定」した短い名前を指定することの利点は、入力する文字数が減ることや、ソースコードが読みやすくなることです。次の表に、さまざまな形式の名前を示します。 この表の中で、\f2Class\fP にはクラスまたはインタフェースを、\f2Type\fP にはクラス、インタフェース、配列、または基本データ型を、そして \f2method\fP にはメソッドまたはコンストラクタを指定できます。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
-.RS 3
+.LP
+\f3̾λ\fP \- \f2package.class\fP\f2#\fP\f2member\fP Ȥ̾ϡ \f2java.lang.String#toUpperCase()\fP Τ褦ʴ̾ˤ뤳Ȥ⡢ \f2String#toUpperCase()\fP \f2#toUpperCase()\fP Τ褦̾ˤ뤳ȤǤޤ̾ꤵƤʤ硢Javadoc ġϡJava ѥ̾θǤ̾ޤܺ٤ϡΤȤΡ@see θפȤƤ̾ˤϡåɤʣΰδ֤ʤɡ̤¦Ǥжޤ뤳ȤǤޤ
+.LP
+ʬŪ˻פû̾ꤹ뤳ȤϡϤʸ뤳Ȥ䡢ɤɤߤ䤹ʤ뤳ȤǤɽˡޤޤʷ̾ޤǡ \f2Class\fP ˤϥ饹ޤϥե \f2Type\fP ˤϥ饹եޤϴܥǡ \f2method\fP ˤϥåɤޤϥȥ饯줾Ǥޤ
+.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -2191,7 +1527,7 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f4@see\fP\f3\ \fP\f4package.class#member\fP\f3 の一般的な形式\fP
+\f4@see\fP\f3\ \fP\f4package.class#member\fP\f3 ΰŪʷ\fP
.br
.di
.nr a| \n(dn
@@ -2207,9 +1543,9 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3現在のクラスのメンバーを参照する\fP
+\f3ߤΥ饹ΥСȤ\fP
.br
-\f2@see\fP\ \f2#\fP\f2field\fP
+\f2@see\fP\ \f2#\fP\f2ե\fP
.br
\f2@see\fP\ \f2#\fP\f2method(Type,\ Type,...)\fP
.br
@@ -2233,21 +1569,21 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3現在の、またはインポートされたパッケージの別のクラスを参照する\fP
+\f3ߤΡޤϥݡȤ줿ѥå̤Υ饹Ȥ\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2field\fP
+\f2@see\fP\ \f2饹\fP\f2#\fP\f2ե\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP
+\f2@see\fP\ \f2饹\fP\f2#\fP\f2method(Type,\ Type,...)\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
+\f2@see\fP\ \f2饹\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP
+\f2@see\fP\ \f2饹\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP
.br
-\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
+\f2@see\fP\ \f2饹\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
.br
\f2@see\fP\ \f2Class.NestedClass\fP
.br
-\f2@see\fP\ \f2Class\fP
+\f2@see\fP\ \f2饹\fP
.br
.di
.nr c| \n(dn
@@ -2263,9 +1599,9 @@
.ll \n(34u*1u/2u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f3別のパッケージの要素を参照する\fP\ (完全修飾)
+\f3̤ΥѥåǤȤ\fP\ ()
.br
-\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2field\fP
+\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2ե\fP
.br
\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP
.br
@@ -2279,7 +1615,7 @@
.br
\f2@see\fP\ \f2package.Class\fP
.br
-\f2@see\fP\ \f2package\fP
+\f2@see\fP\ \f2ѥå\fP
.br
.di
.nr d| \n(dn
@@ -2308,7 +1644,7 @@
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 1860 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 1358 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2396,74 +1732,52 @@
.rm d+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-58
-.RE
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-上の表に対する補足事項を次に示します。
-.LP
+.LP
+ɽФ˼ޤ
.RS 3
.TP 2
o
-最初の種類の形式 (パッケージとクラスを省略) の場合、Javadoc ツールは、現在のクラスの階層だけを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、または現在のクラスかインタフェースを囲んでいるクラスかインタフェースからメンバーを検索します (このあとの検索手順 1 〜 3)。現在のパッケージのほかの部分や、ほかのパッケージは検索しません (検索手順 4 〜 5)。
+ǽμη (ѥåȥ饹ά) ξ硢Javadoc ġϡߤΥ饹γؤޤĤޤꡢߤΥ饹եΥѡ饹ѡեޤϸߤΥ饹եϤǤ륯饹եСޤ (ΤȤθ 1 3)ߤΥѥåΤۤʬ䡢ۤΥѥåϸޤ ( 4 5)
.TP 2
o
-メソッドまたはコンストラクタを指定するときに括弧を付けずに名前だけ (\f2getValue\fP など) を使用した場合、同じ名前のフィールドが存在しなければ、Javadoc ツールはそのメソッドに対して正しくリンクを作成します。 ただし、括弧と引数を追加するように促す警告メッセージを出力します。このメソッドがオーバーロードされている場合、Javadoc ツールは、検索で最初に見つかったメソッドにリンクします。 結果は前もって特定できません。
-.TP 2
-o
-入れ子にされたクラスは、上記のどの形式の場合も、単に「\f2inner\fP」ではなく、「\f2outer\fP\f2.\fP\f2inner\fP」として指定しなければなりません。
+åɤޤϥȥ饯λˡ \f2getValue\fP Τ褦˳̤ʤ̾Ѥ硢Ʊ̾Υեɤ¸ߤƤʤСJavadoc ġˤäƤ̾ؤΥޤ̤ɲä桼¥ηٹåɽޤΥåɤСɤƤ硢Javadoc ġϡǺǽ˸Ĥäåɤ˥ޤ̤äǤޤ
.TP 2
o
-すでに述べたとおり、クラスとメンバーを区切るために、ドット (\f2.\fP) ではなくシャープ記号 (\f2#\fP) を使用することに注意してください。このように指定すると、Javadoc ツールは、あいまいさを解決できます。 ドットは、クラス、入れ子にされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されます。ただし、Javadoc ツールでは一般に許容範囲が広く、あいまいさがなければ、ドットでも正しく解析されます。 その場合でも警告は表示されます。
+Ҥˤʤä饹ϡ٤ƤηˤĤơ \f2outer\fP\f2.\fP\f2inner\fP Ȥƻꤹɬפޤñ \f2inner\fP ȤϤʤǤ
+.TP 2
+o
+Ǥ˽Ҥ٤褦ˡ\f2饹ȥСȤδ֤ζڤʸȤƤϡ\fPɥå (\f2.\fP) ǤϤʤ㡼ʸ (#) ѤޤΤ褦˻ꤹȡJavadoc ġϡޤǤޤɥåȤϡ饹Ҥˤ줿饹ѥåӥ֥ѥåڤ뤿ˤѤޤJavadoc ġǤϰ̤˵ϰϤޤʤСɥåȤǤϤޤξǤٹɽޤ
.RE
-
-.LP
-.LP
-\f3@see の検索順序\fP \- Javadoc ツールは、ソースファイル (.java)、パッケージファイル (package.html または package\-info.java)、または概要ファイル (overview.html) の中に登場する \f2@see\fP タグを処理します。後者の 2 つのファイルでは、完全指定の名前を \f2@see\fP タグに指定しなければなりません。ソースファイルでは、完全指定の名前、または部分指定の名前を指定できます。
-.LP
-.LP
-Javadoc ツールは、\f2.java\fP ファイル内で完全指定でない名前が記述された \f2@see\fP タグを見つけると、Java コンパイラと同じ順序で指定された名前を検索します。 ただし、Javadoc ツールは、特定の名前空間のあいまいさを検出しません。 これは、ソースコードにこれらのエラーが存在していないことを前提としているためです。この検索順序は、Java 言語仕様第 2 版の第 6 章「Names」で正式に定義されています。Javadoc ツールは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてから名前を検索します。具体的には、次の順序で検索します。
-.LP
+.LP
+\f3@see θ\fP \- Javadoc ġϡե (.java)ѥåե (package.html ޤ package\-info.java) ޤϳץե (overview.html) ˴ޤޤ \f2@see\fP ޤԤ 2 ĤΥեǤϡ̾ \f2@see\fP ˻ꤷʤФʤޤեǤϡ̾ޤʬ̾Ǥޤ
+.LP
+Javadoc ġϡǤʤ̾Ҥ줿 \f2@see\fP \f2.java եǸĤȡ\fP Java ѥƱǻꤵ줿̾ޤ Javadoc ġϡ֤̾ΤޤФޤ ϡɤˤΥ顼¸ߤƤʤȤȤƤ뤿ǤθϡJava 2 Ǥ 6 ϡNamesפƤޤJavadoc ġϡϢ륯饹ȥѥåӥݡȤ줿饹ȥѥåΤ٤Ƥ̾ޤŪˤϡνǸޤ
.RS 3
.TP 3
1.
-現在のクラスまたはインタフェース
+ߤΥ饹ޤϥե
.TP 3
2.
-外側を囲んでいるクラスとインタフェース (もっとも近いものから検索)
+¦ϤǤ륯饹ȥե (äȤᤤΤ鸡)
.TP 3
3.
-スーパークラスとスーパーインタフェース (もっとも近いものから検索)
+ѡ饹ȥѡե (äȤᤤΤ鸡)
.TP 3
4.
-現在のパッケージ
+ߤΥѥå
.TP 3
5.
-インポートされているパッケージ、クラス、およびインタフェース (import 文の順序に従って検索)
+ݡȤƤѥå饹ӥե (import ʸν˽äƸ)
.RE
-
-.LP
-.LP
-Javadoc ツールは、各クラスについて手順 1 〜 3 を再帰的に適用しながら、一致する名前が見つかるまで検索を続けます。つまり、まず現在のクラスを検索し、次にそのクラスを囲んでいるクラス E を検索し、その次に E のスーパークラスを検索し、さらにその次に E を囲んでいるクラスを検索します。 手順 4 と 5 では、1 つのパッケージ内のクラスまたはインタフェースを検索する順序は決まっていません。 その順序は、個々のコンパイラによって異なります。手順 5 では、Javadoc ツールは、java.lang を検索します。 このパッケージは、すべてのプログラムに自動的にインポートされるからです。
-.LP
-.LP
-Javadoc ツールは、必ずしもサブクラスを検索するとは限りません。 また、javadoc の実行中にほかのパッケージのドキュメントが生成される場合でも、ほかのパッケージを検索しません。たとえば、\f2@see\fP タグが \f2java.awt.event.KeyEvent\fP クラス内にあって、\f2java.awt\fP パッケージにある名前を参照している場合、Javadoc は、そのクラスがインポートしないかぎりそのパッケージを検索しません。
-.LP
-.LP
-\f3名前が表示される方法\fP \- \f2label\fP を省略すると、\f2package.class.member\fP が表示されます。一般に、package.class.member は、現在のクラスおよびパッケージに応じて適切に短縮されます。「短縮される」とは、必要最小限の名前だけが表示されるということです。たとえば、\f2String.toUpperCase()\fP メソッドに、同じクラスのメンバーへの参照とほかのクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースだけです (次の表を参照)。
-.LP
-.LP
-パッケージ名を広域的に削除するには、\-noqualifier を使用します。
+.LP
+Javadoc ġϡƥ饹ˤĤƼ 1 3 ƵŪŬѤʤ顢פ̾ĤޤǸ³ޤĤޤꡢޤߤΥ饹ˤΥ饹ϤǤ륯饹 E μ E Υѡ饹ˤμ E ϤǤ륯饹ޤ 4 5 Ǥϡ1 ĤΥѥåΥ饹ޤϥեϷޤäƤޤνϡġΥѥˤäưۤʤޤ 5 ǤϡJavadoc ġϡjava.lang ޤΥѥåϡ٤ƤΥץ˼ưŪ˥ݡȤ뤫Ǥ
+.LP
+Javadoc ġϡɬ⥵֥饹Ȥϸ¤ޤޤjavadoc μ¹ˤۤΥѥåΥɥȤǤ⡢ۤΥѥåޤȤС \f2@see\fP \f2java.awt.event.KeyEvent\fP 饹˴ޤޤƤơ \f2java.awt\fP ѥåΤ̾ȤƤƤ⡢Υ饹ǤΥѥåݡȤʤꡢjavadoc ϤΥѥåǤθԤޤ
+.LP
+\f3̾ɽˡ\fP \- \f2label\fP άϡ\f2package.class.member\fP ɽޤ̤ˡpackage.class.member ϡߤΥ饹ӥѥå˱Ŭڤṳ̂ޤṳ̂פȤϡɬǾ¤̾ɽȤȤǤȤС \f2String.toUpperCase()\fP åɤˡƱ饹ΥСؤλȤȤۤΥ饹ΥСؤλȤޤޤƤ硢饹̾ɽΤϸԤΥǤ (ɽ)
+.LP
+ѥå̾Ū˺ˤϡ\-noqualifier Ѥޤ
.br
-
-.LP
-.RE
-.RS 3
-.RS 3
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -2493,7 +1807,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f4String.toUpperCase()\fP\f3 での例\fP
+\f4String.toUpperCase() Ǥ\fP
.br
.di
.nr a| \n(dn
@@ -2509,7 +1823,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f2@see\fP タグが同じクラスのメンバーを参照している
+\f2@see\fP Ʊ饹ƱѥåΥСȤƤ
.br
.di
.nr b| \n(dn
@@ -2525,7 +1839,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f2toLowerCase()\fP (クラス名は省略)
+\f2toLowerCase()\fP (饹̾Ͼά)
.br
.di
.nr c| \n(dn
@@ -2541,7 +1855,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f2@see\fP タグが別のクラスのメンバーを参照している
+\f2@see\fP ۤʤ륯饹ƱѥåΥСȤƤ
.br
.di
.nr d| \n(dn
@@ -2573,7 +1887,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f2Character.toLowerCase(char)\fP (パッケージ名は省略し、クラス名を含む)
+\f2Character.toLowerCase(char)\fP (ѥå̾Ͼά饹̾ޤ)
.br
.di
.nr f| \n(dn
@@ -2589,7 +1903,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(80 .ll \n(80u
.in 0
-\f2@see\fP タグが別のクラスのメンバーを参照している
+\f2@see\fP ۤʤ륯饹ۤʤѥåΥСȤƤ
.br
.di
.nr g| \n(dn
@@ -2621,7 +1935,7 @@
.ll \n(34u*1u/4u
.if \n(.l<\n(82 .ll \n(82u
.in 0
-\f2java.io.File.exists()\fP (パッケージ名とクラス名を含む)
+\f2java.io.File.exists()\fP (ѥå̾ȥ饹̾ޤ)
.br
.di
.nr i| \n(dn
@@ -2632,7 +1946,7 @@
.nf
.ll \n(34u
.nr 80 0
-.nr 38 \w\f3参照の種類\fP
+.nr 38 \w\f3Ȥμ\fP
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
@@ -2654,7 +1968,7 @@
.nr 38 \n(h-
.if \n(81<\n(38 .nr 81 \n(38
.nr 82 0
-.nr 38 \w\f3表示される名前\fP
+.nr 38 \w\f3ɽ̾\fP
.if \n(82<\n(38 .nr 82 \n(38
.82
.rm 82
@@ -2676,7 +1990,7 @@
.nr 42 \n(81+(3*\n(38)
.nr 82 +\n(42
.nr TW \n(82
-.if t .if \n(TW>\n(.li .tm Table at line 1958 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 1434 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -2695,7 +2009,7 @@
.ta \n(80u \n(81u \n(82u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f3参照の種類\fP\h'|\n(41u'\h'|\n(42u'\f3表示される名前\fP
+\&\h'|\n(40u'\f3Ȥμ\fP\h'|\n(41u'\h'|\n(42u'\f3ɽ̾\fP
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -2814,22 +2128,14 @@
.rm i+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-28
-.RE
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f3@see の例\fP
+.LP
+\f3@see \fP
.br
-右側のコメントは、\f2@see\fP タグが別のパッケージ (\f2java.applet.Applet\fP など) のクラス内にある場合に、名前がどのように表示されるかを示しています。
-.LP
+¦ΥȤϡ \f2@see\fP \f2java.applet.Applet\fP Τ褦̤ΥѥåΥ饹ˤˡ̾ɤΤ褦ɽ뤫Ƥޤ
.nf
\f3
.fl
- 関連項目:
+ Ϣ:
.fl
@see java.lang.String // String \fP\f3
.fl
@@ -2849,121 +2155,68 @@
.fl
@see "The Java Programming Language" // "The Java Programming Language" \fP\f3
.fl
-
-.fl
\fP
.fi
-
-.LP
-.LP
-\f2@see\fP を、ドキュメント化の対象にしていないクラスにまで拡張するには、\f2\-link\fP オプションを使用します。
-.LP
-.LP
-詳細については、
+\f2@see\fP ĥƥɥȲʤ饹ؤΥǽˤˤϡ\f2\-link\fP ץѤޤ
+.LP
+ܺ٤ˤĤƤϡ
.na
-\f2@see タグのドキュメント\fP @
+\f2@see Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@seeを参照してください。
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@seeȤƤ
.RE
-.LP
-
+.RE
.LP
.RS 3
.TP 3
@serial\ field\-description | include | exclude
-デフォルトの直列化可能フィールドのドキュメンテーションコメントで使用します。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f2field\-description\fP (省略可能) では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要に応じて、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式のページに追加します。
-.LP
-.LP
-クラスを直列化したあとしばらくしてから直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。
-.LP
-.LP
-\f2include\fP および \f2exclude\fP 引数は、直列化された形式のページにクラスまたはパッケージを含めるか除外するかを示します。これらの引数には、次のような効果があります。
-.LP
+ǥեȤľǽեɤΥɥơȤǻѤޤ
+.LP
+\f2field\-description\fP (άǽ) Ǥϡեɤΰ̣ͤΥꥹȤɬפޤɬפ˱ơʣιԤϤäҤǤޤɸɥååȤϡξľ줿Υڡɲäޤ
+.LP
+饹ľȤФ餯Ƥľǽեɤ饹ɲä硢ˡɲäС̤ʸɲäɬפޤ
+.LP
+\f2include\fP \f2exclude\fP ϡľ줿Υڡ˥饹ޤϥѥåޤ뤫뤫ޤΰˤϡΤ褦ʸ̤ޤ
.RS 3
.TP 2
o
-\f2Serializable\fP を実装している public または protected クラスは、通常はそのページに含められます。 ただし、そのクラスまたはそのクラスが属するパッケージが \f2@serial exclude\fP で指定されていると、そのページから除外されます。
+\f2Serializable\fP Ƥ public ޤ protected 饹ϡΥ饹 (ޤϤΥѥå) \f2@serial exclude\fP ȤƥޡƤʤꡢޤޤ
.TP 2
o
-\f2Serializable\fP を実装している private または package private クラスは、通常はそのページから除外されます。 ただし、そのクラスまたはそのクラスが属するパッケージが \f2@serial include\fP で指定されていると、そのページに含められます。
+\f2Serializable\fP Ƥ private ޤ package\-private 饹ϡΥ饹 (ޤϤΥѥå) \f2@serial include\fP Ȥ ޡƤʤꡢޤ
.RE
-
-.LP
-.LP
-例: \f2javax.swing\fP パッケージは、\f2@serial exclude\fP で指定されています (\f2package.html\fP または \f2package\-info.java\fP 内)。public クラス \f2java.security.BasicPermission\fP は、\f2@serial exclude\fP で指定されています。package private クラス \f2java.util.PropertyPermissionCollection\fP は、\f2@serial include\fP で指定されています。
-.LP
-.LP
-クラスレベルで指定された @serial タグは、パッケージレベルで指定された @serial タグをオーバーライドします。
-.LP
-.LP
-これらのタグの使用法についての詳細と使用例は、「Java オブジェクト直列化仕様」の第 1.6 節
+.LP
+: \f2javax.swing\fP ѥå \f2@serial exclude\fP ( \f2package.html\fP ޤ \f2package\-info.java\fP) ȤƥޡƤޤpublic 饹 \f2java.security.BasicPermission\fP \f2@serial exclude\fP ȤƥޡƤޤpackage\-private 饹 \f2java.util.PropertyPermissionCollection\fP \f2@serial include\fP ȤƥޡƤޤ
+.LP
+饹٥ǻꤵ줿 @serial ϡѥå٥ǻꤵ줿 @serial С饤ɤޤ
+.LP
+ΥλˡˤĤƤξܺ٤ȻϡJava ֥ľ͡פ 1.6
.na
-\f2「クラスの直列化可能なフィールドおよびデータの文書化」\fP @
+\f2֥饹ľǽʥեɤӥǡʸ\fP @
.fi
-http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.htmlを参照してください。また、
+http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.htmlȤƤޤ
.na
-\f2「直列化の FAQ」\fP @
-.fi
-http://java.sun.com/products/jdk/serialization/faq/#javadoc_warn_missingも参照してください。 この FAQ には、「\-private スイッチを指定しないで javadoc を実行しているのに private フィールドの @serial タグが見つからないという javadoc の警告が表示される」などの一般的な質問への回答が記載されています。直列化形式仕様にクラスを含める場合には、
-.na
-\f2「Sun の仕様」\fP @
+\f2ľ FAQ\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.htmlも参照してください。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/products/jdk/serialization/faq/#javadoc_warn_missing⻲ȤƤ FAQ ˤϡ\-private åꤷʤ javadoc ¹ԤƤΤ private եɤ @serial ĤʤȤ javadoc ηٹɽפʤɤΰŪʼؤβܤƤޤľͤ˥饹ޤˤϡ
+.na
+\f2Sun λ͡\fP @
+.fi
+http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.html⻲ȤƤ
+.LP
.TP 3
@serialField\ field\-name\ field\-type\ field\-description
-\f2Serializable\fP クラスの \f2serialPersistentFields\fP メンバーの \f2ObjectStreamField\fP コンポーネントをドキュメント化します。各 \f2ObjectStreamField\fP コンポーネントに対して \f2@serialField\fP タグを 1 つ使う必要があります。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+Serializable \f2饹\fP serialPersistentFields \f2С\fP ObjectStreamField ݡͥ \f2ɥȲ\fP ޤ1 Ĥ \f2@serialField\fP \f2ObjectStreamField\fP ݡͥȤǻѤ٤Ǥ
+.LP
.TP 3
@serialData\ data\-description
-\f2data\-description\fP は、直列化された形式でのデータの型と順序を説明するテキストです。このデータには、特に、\f2writeObject\fP メソッドによって書き込まれる省略可能なデータ、および \f2Externalizable.writeExternal\fP メソッドによって書き込まれるすべてのデータ (基底クラスを含む) が含まれます。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-\f2@serialData\fP タグは、\f2writeObject\fP、\f2readObject\fP、\f2writeExternal\fP、\f2readExternal\fP、\f2writeReplace\fP、および \f2readResolve\fP メソッドのドキュメンテーションコメントで使用できます。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+\f2data\-description\fP ϡľ줿ǤΥǡηȽƥȤǤŪ˸ȡΥǡˤϡ \f2writeObject\fP åɤˤäƽޤάǽʥǡ \f2Externalizable.writeExternal\fP åɤˤäƽޤ뤹٤ƤΥǡ (쥯饹ޤ) ޤޤޤ
+.LP
+\f2@serialData\fP ϡ \f2writeObject\fP \f2readObject\fP \f2writeExternal\fP \f2readExternal\fP \f2writeReplace\fP \f2readResolve\fP åɤΥɥơǻѤǤޤ
+.LP
.TP 3
@since\ since\-text
-生成ドキュメントに [導入されたバージョン] 見出しを追加し、指定された \f2since\-text\fP を書き込みます。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。このタグは、特定の変更または機能が、\f2since\-text\fP に示されたソフトウェアリリース以降、存在していることを意味します。例を示します。
-.RE
-
-.LP
-.RS 3
-
-.LP
+ɥȤ [Ƴ줿С] Фɲäꤵ줿 \f2since\-text\fP ߤޤΥƥȤˤϡ̤¤ϤޤΥϡ٤ƤΥɥơȡĤޤ공סѥå饹եȥ饯åɡӥեɤͭǤΥϡѹޤϵǽ \f2since\-text ˼줿եȥʹߡ¸ߤƤ뤳Ȥ̣ޤ\fPȤС
.nf
\f3
.fl
@@ -2973,52 +2226,26 @@
.fl
\fP
.fi
-
-.LP
-.LP
-Java プラットフォームのソースコードの場合、このタグは、Java プラットフォーム API 仕様のバージョンを示します。 その変更や機能がリファレンス実装に追加された時期を示すとは限りません。複数の @since タグを使用でき、複数の @author タグのように扱われます。プログラム要素が複数の API で使用される場合、複数のタグを使用できます。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+.LP
+Java ץåȥեΥɤξ硢ΥϡJava ץåȥե API ͤΥСޤѹ䵡ǽեɲä줿Ȥϸ¤ޤʣ @since ѤǤʣ @author Τ褦˰ޤץǤʣ API ǻѤ硢ʣΥѤǤޤ
+.LP
.TP 3
-@throws\ class\-name\ description\
-\f2@throws\fP タグと \f2@exception\fP タグは同義です。生成ドキュメントに [例外] 小見出しを追加して、\f2class\-name\fP と \f2description\fP テキストを書き込みます。\f2class\-name\fP は、そのメソッドからスローされる可能性のある例外の名前です。このタグは、メソッド、コンストラクタの doc コメント内でのみ有効です。このクラスが完全指定の名前で記述されていない場合、Javadoc ツールは、検索順序に従ってクラスを探します。同じまたは異なる例外の doc コメントで、複数の \f2@throws\fP タグを使用できます。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-すべてのチェック済み例外がドキュメント化されるようにするために、\f2@throws\fP タグが throws 節内の例外用に存在しない場合は、@throws タグのあるドキュメントであるかのように、Javadoc ツールによって例外が HTML 出力に説明なしで自動的に追加されます。
-.LP
-.LP
-オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、\f2@throws\fP ドキュメンテーションをそのメソッドからサブクラスにコピーされます。インタフェースメソッドから実装メソッドにコピーされる場合も同様です。@throws にドキュメンテーションを継承させるには、{@inheritDoc} を使用できます。
-.LP
-.LP
-詳細については、
+@throws\ class\-name\ description
+\f2@throws\fP \f2@exception\fP ƱǤɥȤˡ㳰Фɲäơ \f2class\-name\fP \f2description\fP ΥƥȤߤޤ \f2class\-name\fP ϡΥåɤ饹ǽΤ㳰̾ǤΥϡåɡȥ饯 doc ǤΤͭǤΥ饹̾ǵҤƤʤ硢Javadoc ġϡ˽äƥ饹õޤƱޤϰۤʤ㳰 doc Ȥǡʣ \f2@throws\fP ѤǤޤ
+.LP
+٤ƤΥåѤ㳰ɥȲ褦ˤ뤿ˡ \f2@throws\fP throws 㳰Ѥ¸ߤʤϡ@throws ΤɥȤǤ뤫Τ褦ˡJavadoc ġˤä㳰 HTML ϤʤǼưŪɲäޤ
+.LP
+С饤ɤå㳰ŪƤΤߡ \f2@throws\fP ɥơΥåɤ饵֥饹˥ԡޤեåɤåɤ˥ԡƱͤǤ@throws ˥ɥơѾˤϡ{@inheritDoc} ѤǤޤ
+.LP
+ܺ٤ˤĤƤϡ
.na
-\f2@throws タグのドキュメント\fP @
+\f2@throws Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@exceptionを参照してください。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@exceptionȤƤ
+.LP
.TP 3
{@value\ package.class#field}
-\f2{@value}\fP が静的フィールドの doc コメントで 引数なしで使用されている場合、その定数の値が表示されます。
-.RE
-
-.LP
-.RS 3
-
-.LP
+\f2{@value}\fP Ūեɤ doc Ȥ ʤǻѤƤ硢ͤɽޤ
.nf
\f3
.fl
@@ -3034,11 +2261,8 @@
.fl
\fP
.fi
-
-.LP
-.LP
-任意の doc コメント内で引数 \f2package.class#field\fP ありで使用されている場合は、指定した定数の値が表示されます。
-.LP
+.LP
+ǤդΥɥơǰ \f2package.class#field\fP ǻѤ줿ϡλꤵ줿ͤɽޤ
.nf
\f3
.fl
@@ -3056,448 +2280,130 @@
.fl
\fP
.fi
-
-.LP
-.LP
-引数 \f2package.class#field\fP は、@see 引数と同一の形式になります。ただし、メンバーが静的フィールドになければならない点が異なります。
-.LP
-.LP
-これらの定数での値は、
+.LP
+ \f2package.class#field\fP ϡ@see ƱηˤʤޤСŪեɤˤʤФʤʤۤʤޤ
+.LP
+Ǥͤϡ
.na
-\f2定数フィールド値\fP @
+\f2ե\fP @
.fi
-http://java.sun.com/javase/6/docs/api/constant\-values.htmlページにも表示されます。
-.LP
-.LP
-
-.LP
-.RE
-.RS 3
+http://java.sun.com/javase/6/docs/api/constant\-values.htmlڡˤɽޤ
+.LP
.TP 3
@version\ version\-text
-\-version オプションが使われている場合、生成ドキュメントに [バージョン] 小見出しを追加して、指定された \f2version\-text\fP を書き込みます。このタグは、このコードが含まれるソフトウェアの現在のバージョン番号を保持するように意図されています。 これに対し、@since は、このコードが導入されたバージョン番号を保持します。\f2version\-text\fP には、特別な内部構造はありません。バージョンタグを使用できる場所を調べるには、「タグを使用できる場所」を参照してください。
-.RE
-
-.LP
-.RS 3
-
-.LP
-.LP
-1 つのドキュメンテーションコメントに複数の \f2@version\fP タグを含めることができます。必要に応じて、\f2@version\fP タグごとに 1 つのバージョン番号を指定することも、タグごとに複数のバージョン番号を指定することもできます。前者の場合は、Javadoc ツールによって、名前と名前の間にコンマ (\f2,\fP) とスペースが挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要があるときは、1 つのタグに複数の名前を指定してください。
-.LP
-.LP
-詳細については、
+\-version ץѤȡɥȤ [С] Фɲäꤵ줿 \f2version\-text\fP ߤޤΥϡΥɤޤޤ륽եȥθߤΥСֹݻ褦˰տޤƤޤФ@since ϡΥɤƳ줿Сֹݻޤ \f2version\-text\fP ˤϡ̤¤ϤޤСѤǤĴ٤ˤϡ֥ѤǤפȤƤ
+.LP
+1 ĤΥɥơȤʣ \f2@version\fP ޤ뤳ȤǤޤ̣ʤϰǡ1 Ĥ \f2@version\fP 1 ĤΥСֹꤹ뤳Ȥ⡢ʣΥСֹꤹ뤳ȤǤޤԤξϡJavadoc ġˤä̾̾δ֤˥ (\f2,\fP) ȶ̾δ֤ޤԤξϡƥΤϤ뤳ȤʤɥȤˤΤޤޥԡޤäơޤǤϤʤƸб̾ڤʸȤɬפȤϡ1 ĤΥʣ̾ꤷƤ
+.LP
+ܺ٤ˤĤƤϡ
.na
-\f2@version タグのドキュメント\fP @
+\f2@version Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@versionを参照してください。
-.LP
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@versionȤƤ
.RE
-.LP
.SS
-タグを使用できる場所
-.LP
-ここでは、タグを使用できる場所について説明します。\f2@see\fP、\f2@since\fP、\f2@deprecated\fP、\f2{@link}\fP、\f2{@linkplain}\fP および \f2{@docroot}\fP のタグは、すべての doc コメントで使用できます。
-.RS 3
-
-.LP
+ѤǤ
+.LP
+ǤϡѤǤˤĤޤ٤ƤΥɥơȤǻѲǽʥϼΤȤǤ \f2@see\fP \f2@since\fP \f2@deprecated\fP \f2{@link}\fP \f2{@linkplain}\fP \f2{@docroot}\fP
.SS
-概要のドキュメンテーションタグ
-.LP
-.LP
-概要タグは、概要ページのドキュメンテーションコメントで使用できるタグです。 このドキュメンテーションコメントは、通常 \f2overview.html\fP という名前ソースファイル内にあります。ほかのドキュメンテーションコメントの場合と同様に、これらのタグは、主説明のあとで使う必要があります。
-.LP
-.LP
-\f3注\fP \- バージョン 1.2 では、概要ドキュメント内の \f2{@link}\fP タグにバグがあります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、\f2{@docRoot}\fP タグは、概要ドキュメント内では動作しません。
-.LP
+פΥɥơ
+.LP
+ץϡץڡΥɥơȤǻѤǤ륿ǤΥɥơȤϡ̾ \f2overview.html\fP Ȥ̾Υեˤޤ ۤΥɥơȤξƱͤˡΥϡΤȤǻȤɬפޤ
+.LP
+\f3\fP \- С 1.2 Ǥϡץɥ \f2{@link}\fP ˥ХޤƥȤɽޤꤵޤߤΤȤ \f2{@docRoot}\fP ϡץɥǤưޤ
+.LP
+\f3ץ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@author\fP
-.br
-\f2@version\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 38 \w\f3概要タグ\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2279 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f3概要タグ\fP
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-20
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@author\fP
+.TP 2
+o
+\f2@version\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
.SS
-パッケージドキュメンテーションタグ
-.LP
-.LP
-パッケージタグは、パッケージのドキュメンテーションコメントで使用できるタグです。 このドキュメンテーションコメントは、\f2package.html\fP または \f2package\-info.java\fP という名前のソースファイル内にあります。ここで使用できる \f2@serial\fP タグは、\f2include\fP または \f2exclude\fP 引数を指定したものだけです。
-.LP
+ѥåɥơ
+.LP
+ѥåϡѥåΥɥơȤǻѤǤ륿ǤΥɥơȤ \f2package.html\fP ޤ \f2package\-info.java\fP Ȥ̾ΥեˤޤǻѤǤ \f2@serial\fP ϡ \f2include\fP ޤ \f2exclude\fP ꤵ줿ΤǤ
+.LP
+\f3ѥå\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@serial\fP
-.br
-\f2@author\fP
-.br
-\f2@version\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 38 \w\f3パッケージタグ\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2315 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f3パッケージタグ\fP
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-22
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@serial\fP
+.TP 2
+o
+\f2@author\fP
+.TP 2
+o
+\f2@version\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
.SS
-クラスおよびインタフェースドキュメンテーションタグ
-.LP
-.LP
-次に、クラスまたはインタフェースのドキュメンテーションコメントで使用できるタグを示します。ここで使用できる \f2@serial\fP タグは、\f2include\fP または \f2exclude\fP 引数を指定したものだけです。
-.LP
+饹ӥեɥơ
+.LP
+ˡ饹ޤϥեΥɥơȤǻѤǤ륿ޤǻѤǤ \f2@serial\fP ϡ \f2include\fP ޤ \f2exclude\fP ꤵ줿ΤǤ
+.LP
+\f3饹ӥե\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f3クラスおよびインタフェースタグ\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.eo
-.am 80
-.br
-.di b+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@deprecated\fP
-.br
-\f2@serial\fP
-.br
-\f2@author\fP
-.br
-\f2@version\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr b| \n(dn
-.nr b- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \n(b-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2355 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(b|u+\n(.Vu
-.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.b+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.rm b+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-26
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@deprecated\fP
+.TP 2
+o
+\f2@serial\fP
+.TP 2
+o
+\f2@author\fP
+.TP 2
+o
+\f2@version\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
-\f3次にクラスコメントの例を示します。\fP
-.LP
+\f3˥饹Ȥޤ\fP
.nf
\f3
.fl
@@ -3533,137 +2439,44 @@
.fl
}
.fl
-
-.fl
\fP
.fi
-
-.LP
.SS
-フィールドドキュメンテーションタグ
-.LP
-.LP
-次に、フィールドのドキュメンテーションコメントで使用できるタグを示します。
-.LP
+եɥɥơ
+.LP
+ˡեɤΥɥơȤǻѤǤ륿ޤ
+.LP
+\f3եɥ\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@deprecated\fP
-.br
-\f2@serial\fP
-.br
-\f2@serialField\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@docRoot}\fP
-.br
-\f2{@value}\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 38 \w\f3フィールドタグ\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2436 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f3フィールドタグ\fP
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-24
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@deprecated\fP
+.TP 2
+o
+\f2@serial\fP
+.TP 2
+o
+\f2@serialField\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
+.TP 2
+o
+\f2{@value}\fP
.RE
-\f3次にフィールドコメントの例を示します。\fP
-.LP
+\f3˥եɥȤޤ\fP
.nf
\f3
.fl
@@ -3679,170 +2492,50 @@
.fl
int x = 1263732;
.fl
-
-.fl
\fP
.fi
-
-.LP
.SS
-コンストラクタおよびメソッドドキュメンテーションタグ
-.LP
-.LP
-次に、コンストラクタまたはメソッドのドキュメンテーションコメント内で表示できるタグを示します。 ただし、\f2@return\fP はコンストラクタでは表示できず、\f2{@inheritDoc}\fP は表示に制限があります。\f2@serialData\fP タグは特定の直列化メソッドの doc コメントでのみ使用できます。
-.LP
+ȥ饯ӥåɥɥơ
+.LP
+ˡȥ饯ޤϥåɤΥɥơȤǻѤǤ륿ޤ \f2@return\fP ϥȥ饯ǤϻѤǤ \f2{@inheritDoc}\fP ˤ¤ޤ \f2@serialData\fP ľåɤ doc ȤǤΤѤǤޤ
+.LP
+\f3åɤӥȥ饯\fP
.RS 3
-
-.LP
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80
-.nr 34 \n(.lu
-.eo
-.am 80
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f3メソッドおよびコンストラクタタグ\fP
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.eo
-.am 80
-.br
-.di b+
-.35
-.ft \n(.f
-.ll \n(34u*1u/2u
-.if \n(.l<\n(80 .ll \n(80u
-.in 0
-\f2@see\fP
-.br
-\f2@since\fP
-.br
-\f2@deprecated\fP
-.br
-\f2@param\fP
-.br
-\f2@return\fP
-.br
-\f2@throws\fP と \f2@exception\fP
-.br
-\f2@serialData\fP
-.br
-\f2{@link}\fP
-.br
-\f2{@linkplain}\fP
-.br
-\f2{@inheritDoc}\fP
-.br
-\f2{@docRoot}\fP
-.br
-.di
-.nr b| \n(dn
-.nr b- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.80
-.rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \n(b-
-.if \n(80<\n(38 .nr 80 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr TW \n(80
-.if t .if \n(TW>\n(.li .tm Table at line 2503 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(b|u+\n(.Vu
-.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
-.ta \n(80u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(40u
-.in +\n(37u
-.b+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.rm b+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-30
-
-.LP
+.TP 2
+o
+\f2@see\fP
+.TP 2
+o
+\f2@since\fP
+.TP 2
+o
+\f2@deprecated\fP
+.TP 2
+o
+\f2@param\fP
+.TP 2
+o
+\f2@return\fP
+.TP 2
+o
+\f2@throws\fP \f2@exception\fP
+.TP 2
+o
+\f2@serialData\fP
+.TP 2
+o
+\f2{@link}\fP
+.TP 2
+o
+\f2{@linkplain}\fP
+.TP 2
+o
+\f2{@inheritDoc}\fP
+.TP 2
+o
+\f2{@docRoot}\fP
.RE
-\f3次にメソッドのドキュメンテーションコメントの例を示します。\fP
-.LP
+\f3˥åɤΥɥơȤޤ\fP
.nf
\f3
.fl
@@ -3874,22 +2567,13 @@
.fl
}
.fl
-
-.fl
\fP
.fi
-.RE
-.SH "オプション"
-.LP
-.LP
-javadoc ツールは、ドックレットを使って出力を決定します。Javadoc ツールは、\-doclet オプションでカスタムドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使います。Javadoc ツールには、任意のドックレットとともに使用できるコマンド行オプションがあります。 これらのオプションについては、このあとの「Javadoc オプション」で説明します。標準ドックレットでは、このほかに、いくつかの追加のコマンド行オプションが提供されます。 これらのオプションについては、そのあとの「標準ドックレットが提供するオプション」で説明します。どのオプション名も、大文字と小文字が区別されません。 ただし、オプションの引数では、大文字と小文字が区別されます。
-.LP
-.LP
-オプションを次に示します。
-.LP
-.RS 3
-
-.LP
+.SH "ץ"
+.LP
+javadoc ġϡɥååȤȤäƽϤꤷޤJavadoc ġϡ\-doclet ץǥɥååȤꤵƤʳϡǥեȤɸɥååȤȤޤJavadoc ġˤϡǤդΥɥååȤȤȤ˻ѤǤ륳ޥɹԥץޤΥץˤĤƤϡΤȤΡJavadoc ץפޤɸɥååȤǤϡΤۤˡĤɲäΥޥɹԥץޤΥץˤĤƤϡΤȤΡɸɥååȤ륪ץפޤɤΥץ̾⡢ʸȾʸ̤ޤץΰǤϡʸȾʸ̤ޤ
+.LP
+ץϼΤȤǤ
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -4043,6 +2727,8 @@
.br
\-\f2sourcepath\fP
.br
+\-sourcetab
+.br
\-splitindex
.br
\-stylesheetfile
@@ -4055,6 +2741,8 @@
.br
\-tagletpath
.br
+\-top
+.br
\-title
.br
\-use
@@ -4101,7 +2789,7 @@
.nr 42 \n(81+(3*\n(38)
.nr 82 +\n(42
.nr TW \n(82
-.if t .if \n(TW>\n(.li .tm Table at line 2680 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 2009 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -4157,54 +2845,49 @@
.rm b+
.rm c+
.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-123
-
-.LP
-.RE
-.LP
-\f2イタリック\fPで示されたオプションは、Javadoc の基本オプションであり、Javadoc ツールのフロントエンドによって提供され、すべてのドックレットで使用できます。標準ドックレット自体は、イタリックでないオプションを提供します。
-.LP
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-127
+.LP
+\f2å\fP Ǽ줿ץϡJavadoc δܥץǤꡢJavadoc ġΥեȥɤˤä졢٤ƤΥɥååȤǻѤǤޤɸɥååȼΤϡåǤʤץޤ
.SS
-Javadoc オプション
-.LP
+Javadoc ץ
.RS 3
.TP 3
\-overview \ path/filename
-Javadoc に対して、\f2path/filename\fP で指定された「ソース」ファイルから概要ドキュメント用のテキストを取得し、そのテキストを概要ページ (\f2overview\-summary.html\fP) に配置するように指定します。\f2path/filename\fP は、\f2\-sourcepath\fP への相対パスです。
-.LP
-\f2filename\fP と \f2path\fP には、それぞれ任意の名前と場所を指定できますが、通常は、\f2overview.html\fP という名前を付けて、ソースツリー内の最上位のパッケージディレクトリがあるディレクトリに配置します。この場所に配置すると、\f2\-sourcepath\fP によってこのファイルが指し示されるので、パッケージをドキュメント化する際に \f2path\fP が不要になります。たとえば、\f2java.lang\fP パッケージのソースツリーが \f2/src/classes/java/lang/\fP の場合、概要ファイルを \f2/src/classes/overview.html\fP に配置できます。「使用例」を参照してください。
-.LP
-\f2path/filename\fP で指定するファイルについては、「概要コメントファイル」を参照してください。
-.LP
-概要ページが作成されるのは、Javadoc に複数のパッケージ名を渡した場合だけです。詳細は、「HTML フレーム」を参照してください。
-.LP
-概要ページのタイトルは、\f2\-doctitle\fP によって設定されます。
+Javadoc Фơ\f2path/filename\fP ǻꤵ줿֥ץե뤫鳵ץɥѤΥƥȤΥƥȤץڡ (\f2overview\-summary.html\fP) ֤褦˻ꤷޤ \f2path/filename\fP ϡȥǥ쥯ȥ꤫ХѥǤ
+.LP
+\f2filename\fPǤդ̾Ѥ\f2path\fP Ǥդ뤳ȤǽǤ̾ \f2overview.html\fP Ȥ̾դĥκǾ̥ѥåǥ쥯ȥޤǥ쥯ȥ֤ޤξ֤ȡѥåɥȲȤ \f2path\fP ꤹɬפʤʤޤʤʤ顢 \f2\-sourcepath\fP ˤäƤΥե뤬ؤ뤫ǤȤС \f2java.lang\fP ѥåΥĥ \f2/src/classes/java/lang/\fP ξ硢ץե \f2/src/classes/overview.html\fP ֤ǤޤֻפȤƤ
+.LP
+\f2path/filename\fP ǻꤹեˤĤƤϡֳץȥեפȤƤ
+.LP
+ץڡΤϡJavadoc ʣΥѥå̾ϤǤܺ٤ϡHTML ե졼פȤƤ
+.LP
+ץڡΥȥϡ\f2\-doctitle\fP ˤäꤵޤ
.LP
.TP 3
\-public
-public クラスおよびメンバーだけを表示します。
+public 饹ӥСɽޤ
.LP
.TP 3
\-protected
-protected および public のクラスとメンバーだけを表示します。これはデフォルトの設定です。
+protected public Υ饹ȥСɽޤ줬ǥեȤǤ
.LP
.TP 3
\-package
-package、protected、および public のクラスとメンバーだけを表示します。
+packageprotected public Υ饹ȥСɽޤ
.LP
.TP 3
\-private
-すべてのクラスとメンバーを表示します。
+٤ƤΥ饹ȥСɽޤ
.LP
.TP 3
\-help
-オンラインヘルプを表示します。 Javadoc とドックレットのコマンド行オプションが一覧表示されます。
+饤إפɽޤJavadoc ȥɥååȤΥޥɹԥץɽޤ
.LP
.TP 3
\-doclet\ class
-ドキュメントの生成に使うドックレットを起動するためのクラスファイルを指定します。完全指定の名前を指定してください。このドックレットにより、出力の内容と形式が定義されます。\f4\-doclet\fP オプションが使われていない場合、Javadoc は、標準ドックレットを使ってデフォルトの HTML 形式を生成します。このクラスには、\f2start(Root)\fP メソッドが含まれていなければなりません。この起動クラスへのパスは、\f2\-docletpath\fP オプションによって定義されます。
-.LP
-たとえば、MIF ドックレットを呼び出すには、次のように指定します。
+ɥȤ˻ȤɥååȤư뤿Υ饹եꤷޤ̾ꤷƤΥɥååȤˤꡢϤƤȷޤ\f4\-doclet\fP ץȤƤʤ硢Javadoc ϡɸɥååȤȤäƥǥեȤ HTML ޤΥ饹ˤ \f2start(Root)\fP ޤޤƤɬפޤεư饹ؤΥѥ \f2\-docletpath\fP ץˤäޤ
+.LP
+ȤСMIF ɥååȤƤӽФˤϡΤ褦˻ꤷޤ
.nf
\f3
.fl
@@ -4213,17 +2896,17 @@
\fP
.fi
.LP
-特定のドックレットを実行した完全な例については、
+ΥɥååȤ¹ԤˤĤƤϡ
.na
-\f2MIF Doclet のドキュメント\fP @
+\f2MIF Doclet Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。
+http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlȤƤ
.LP
.TP 3
\-docletpath\ classpathlist
-\f2\-doclet\fP オプションで指定されているドックレット開始クラスファイル、およびそれが依存するすべての jar ファイルへのパスを指定します。開始クラスファイルが jar ファイル内にある場合、以下の例のように jar ファイルのパスが指定されます。絶対パスまたは現在のディレクトリからの相対パスを指定できます。\f2classpathlist\fP には、複数のパスまたは JAR ファイルを含めることができます。 その場合、各パスまたは JAR ファイルを、Solaris の場合にはコロン (:)、Windows の場合にはセミコロン (;) で区切ります。目的のドックレット開始クラスがすでに検索パス内にある場合は、このオプションは不要です。
-.LP
-jar ファイルへのパスの例には、ドックレット開始クラスファイルが含まれています。jar ファイル名が含まれている点に注目してください。
+\f2\-doclet\fP ץǻꤵ줿ɥååȳϥ饹ե롢 ӤΥ饹¸뤹٤Ƥ JAR եؤΥѥꤷޤϥ饹ե뤬 jar եˤ硢ʲΤ褦 jar եΥѥꤵޤХѥޤϸߤΥǥ쥯ȥ꤫ХѥǤޤ \f2classpathlist\fP ˤϡʣΥѥޤ JAR եޤ뤳ȤǤޤ ξ硢ƥѥޤ JAR եSolaris ξˤϥ (:)Windows ξˤϥߥ (;) ǶڤޤŪΥɥååȳϥ饹Ǥ˸ѥˤϡΥץפǤ
+.LP
+jar եؤΥѥˤϡɥååȳϥ饹ե뤬ޤޤƤޤjar ե̾ޤޤƤܤƤ
.nf
\f3
.fl
@@ -4231,7 +2914,7 @@
.fl
\fP
.fi
-ドックレット開始クラスファイルのパスの例。クラスファイル名が省略されている点に注目してください。
+ɥååȳϥ饹եΥѥ㡣饹ե̾άƤܤƤ
.nf
\f3
.fl
@@ -4239,212 +2922,40 @@
.fl
\fP
.fi
-特定のドックレットを実行した完全な例については、
+ΥɥååȤ¹ԤˤĤƤϡ
.na
-\f2MIF Doclet のドキュメント\fP @
+\f2MIF Doclet Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。
+http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlȤƤ
.LP
.TP 3
\-1.1
-\f2この機能は、Javadoc 1.4 では削除されました。代替機能はありません。このオプションは、Javadoc 1.1 によって生成されるのと同じ外見と機能を持つドキュメントを作成するためのものでした。 入れ子のクラスはサポートされていません。このオプションが必要な場合は、Javadoc 1.2 または 1.3 を使用してください。\fP
+\f2εǽ Javadoc 1.4 ޤصǽϤޤΥץϡJavadoc 1.1 ˤäΤƱȵǽĥɥȤ뤿ΤΤǤҤΥ饹ϥݡȤƤޤΥץɬפʾϡJavadoc 1.2 ޤ 1.3 ѤƤ\fP
.LP
.TP 3
\-source release
-受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
-.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80 81
-.nr 34 \n(.lu
-.eo
-.am 81
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/3u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Javadoc は、JDK 1.5 で導入された総称および他の言語機能を含んだコードを受け付けます。\f3\-source\fP フラグを指定しないと、コンパイラはデフォルトとして 1.5 の動作をします。
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di b+
-.35
-.ft \n(.f
-.ll \n(34u*1u/3u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Javadoc は、JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
-.br
-.di
-.nr b| \n(dn
-.nr b- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di c+
-.35
-.ft \n(.f
-.ll \n(34u*1u/3u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Javadoc は、JDK 1.3 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。
-.br
-.di
-.nr c| \n(dn
-.nr c- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 31 0
-.nr 32 0
-.nr 38 \w\f31
-.if \n(31<\n(38 .nr 31 \n(38
-.nr 38 \w.5\fP
-.if \n(32<\n(38 .nr 32 \n(38
-.nr 38 \w\f31
-.if \n(31<\n(38 .nr 31 \n(38
-.nr 38 \w.4\fP
-.if \n(32<\n(38 .nr 32 \n(38
-.nr 38 \w\f31
-.if \n(31<\n(38 .nr 31 \n(38
-.nr 38 \w.3\fP
-.if \n(32<\n(38 .nr 32 \n(38
-.80
-.rm 80
-.nr 60 \n(31
-.nr 38 \n(60+\n(32
-.if \n(38>\n(80 .nr 80 \n(38
-.if \n(38<\n(80 .nr 60 +(\n(80-\n(38)/2
-.nr 81 0
-.81
-.rm 81
-.nr 38 \n(a-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(b-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(c-
-.if \n(81<\n(38 .nr 81 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr 60 +\n(40
-.nr 41 \n(80+(3*\n(38)
-.nr 81 +\n(41
-.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 2790 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(60u \n(80u \n(81u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f31.5\fP\h'|\n(41u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(b|u+\n(.Vu
-.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
-.ta \n(60u \n(80u \n(81u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f31.4\fP\h'|\n(41u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.b+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(c|u+\n(.Vu
-.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
-.ta \n(60u \n(80u \n(81u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f31.3\fP\h'|\n(41u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.c+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.rm b+
-.rm c+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-14
-.LP
-javac でコードをコンパイルするときに使用した値に対応する \f2release\fP の値を使用します。
+դ륽ɤΥСꤷޤ\f2release\fP ˤϼͤǤޤ
+.RS 3
+.TP 2
+o
+\f31.5\fP \- javadoc ϡJDK 1.5 Ƴ줿Τʤɤθ쵡ǽޤॳɤդޤ\f3\-source\fP ե饰ѤʤäΥѥΥǥեưϡ1.5 ΤΤˤʤޤ
+.TP 2
+o
+\f31.4\fP Javadoc ϡJDK 1.4 Ƴ줿ޤॳɤդޤ
+.TP 2
+o
+\f31.3\fP Javadoc ϡJDK 1.3 ʹߤƳ줿Ρޤ¾θ쵡ǽݡȤޤ
+.RE
+.LP
+javac ǥɤѥ뤹Ȥ˻Ѥͤб \f2release\fP ͤѤޤ
.LP
.TP 3
\-sourcepath\ sourcepathlist
-\f2javadoc\fP コマンドにパッケージ名または \f2\-subpackages\fP を渡すときに、ソースファイル (\f2.java\fP) を検索するためのパスを指定します。\f2sourcepathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパス以下のすべてのサブディレクトリを検索します。このオプションを使って、ドキュメント化されるソースファイルの位置だけでなく、それ自体はドキュメント化されないがドキュメント化されるソースファイルから継承されたコメントを持つソースファイルの位置も確認できます。
-.LP
-\f2\-sourcepath\fP オプションは、javadoc コマンドにパッケージ名を渡すときにだけ使用できます。 \f2javadoc\fP コマンドに渡される \f2.java\fP ファイルは、このパスからは検索されません。\f2.java\fP ファイルを検索するには、そのファイルのあるディレクトリに cd によって移動するか、または各ファイルの先頭にパスを含めます (「1 つ以上のクラスのドキュメント化」を参照)。\f2\-sourcepath\fP が省略された場合、Javadoc は、クラスパスを使ってソースファイルを検索します (\-classpath を参照)。したがって、デフォルトの \-sourcepath は、クラスパスの値です。\-classpath も省略してパッケージ名を Javadoc に渡すと、Javadoc は現在のディレクトリおよびそのサブディレクトリからソースファイルを検索します。
-.LP
-\f2sourcepathlist\fP には、ドキュメント化するパッケージ名のソースツリーのルートディレクトリを設定します。たとえば、\f2com.mypackage\fP というパッケージをドキュメント化する場合に、そのソースファイルが次の場所にあるとします。
+ѥå̾ޤ \-subpackages javadoc ޥɤϤȤϡե (.\f2.java\fP) Ĥ뤿 \f2ѥ\fP \f2ޤ\fP \f2sourcepathlist\fP ˤϡ (\f2:\fP) ǶڤäʣΥѥޤ뤳ȤǤޤJavadoc ġϡꤵ줿ѥʲΤ٤ƤΥ֥ǥ쥯ȥޤΥץȤäơɥȲ륽եΰ֤Ǥʤ켫ΤϥɥȲʤɥȲ륽ե뤫Ѿ줿Ȥĥեΰ֤ǧǤޤ
+.LP
+\f2\-sourcepath\fP ץѤǤΤϡjavadoc ޥɤ˥ѥå̾ϤǤΥѥϡjavadoc ޥɤϤ줿 \f2.java\fP ե \f2\fP ޤ \f2.java\fP եˤϡΥեΤǥ쥯ȥ cd ˤäưư뤫ޤϳƥեƬ˥ѥޤޤ (1 İʾΥ饹ΥɥȲפ) \f2\-sourcepath\fP ά줿硢Javadoc ϡ饹ѥȤäƥեޤ (\-classpath )äơǥեȤ \-sourcepath ϡ饹ѥͤǤ\-classpath άƥѥå̾ Javadoc ϤȡJavadoc ϸߤΥǥ쥯ȥꤪӤΥ֥ǥ쥯ȥ꤫饽եޤ
+.LP
+\f2sourcepathlist\fP ˤϡɥȲѥå̾ΥĥΥ롼ȥǥ쥯ȥꤷޤȤС \f2com.mypackage\fP Ȥ̾ΥѥåɥȲˡΥե뤬ξˤȤޤ
.nf
\f3
.fl
@@ -4452,16 +2963,16 @@
.fl
\fP
.fi
-この場合、次のようにして \f2sourcepath\fP を \f2/home/user/src\fP、つまり \f2com/mypackage\fP を含むディレクトリに指定し、それからパッケージ名 \f2com.mypackage\fP を指定します。
+ΤȤΤ褦ˡ \f2sourcepath\fP com/mypackage ޤǥ쥯ȥǤ \f2/home/user/src\fP ˻ꤷȡ ѥå̾ \f2com.mypackage\fP ꤷޤ
.nf
\f3
.fl
% \fP\f3javadoc \-sourcepath /home/user/src/ com.mypackage\fP
.fl
.fi
-この方法は、ソースパスの値とパッケージ名を連結して、ドットを (円記号) 「\\」に変えると、パッケージのフルパス (C:\\user\\src\\com\\mypackage) になることを理解すると簡単です。\f2/home/user/src/com/mypackage\fP.
-.LP
-2 つのソースパスを設定するには、次のようにします。
+ˡϡѥͤȥѥå̾Ϣ뤷ơɥåȤ (ߵ) \\פѤȡѥåΥեѥ \f2/home/user/src/com/mypackage ˤʤ뤳ȤȴñǤ\fP
+.LP
+2 ĤΥѥꤹˤϡΤ褦ˤޤ
.nf
\f3
.fl
@@ -4471,132 +2982,124 @@
.LP
.TP 3
\-classpath\ classpathlist
-Javadoc が参照クラス (\f2.class\fP ファイル) を検索するパスを指定します。 参照クラスとは、ドキュメント化されるクラスとそれらのクラスによって参照されるすべてのクラスのことです。\f2classpathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパスの以下すべてのサブディレクトリを検索します。\f2classpathlist\fP を指定するときは、
+javadoc ȥ饹 (\f2.class\fP ե) θԤȤ˻Ѥѥꤷޤȥ饹ȤϡɥȲ륯饹ȡΥ饹黲Ȥ뤹٤ƤΥ饹ؤޤ\f2classpathlist\fP ˤϡ (\f2:\fP) ǶڤäʣΥѥޤ뤳ȤǤޤ Javadoc ġϡꤵ줿ѥʲΤ٤ƤΥ֥ǥ쥯ȥޤclasspathlist ꤹȤϡ
.na
-\f2クラスパス\fP @
+\f2饹ѥ\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/index.html#generalのドキュメントにある指示に従ってください。
-.LP
-\f2\-sourcepath\fP が省略されている場合、Javadoc ツールは、\f2\-classpath\fP を使って、クラスファイルだけでなくソースファイルも検索します (下位互換性のため)。したがって、ソースファイルとクラスファイルを別々のパスから検索する必要がある場合は、\f2\-sourcepath\fP と \f2\-classpath\fP の両方を使います。
-.LP
-たとえば、\f2com.mypackage\fP をドキュメント化する場合に、ソースファイルがディレクトリ \f2/home/user/src/com/mypackage\fP にあり、このパッケージが \f2/home/user/lib\fP 内のライブラリを使うのであれば、次のように指定します。
+http://java.sun.com/javase/6/docs/technotes/tools/index.html#generalΥɥȤˤؼ \f2˽äƤ\fP
+.LP
+\f2\-sourcepath\fP άȡJavadoc ġϥ饹եȤǤʤեȤˤ \f2\-classpath\fP Ѥޤ (̸ߴΤ)äơեȥ饹ե̡Υѥ鸡ɬפϡ \f2\-sourcepath\fP \f2\-classpath ξȤޤ\fP.
+.LP
+ȤС \f2com.mypackage\fP ɥȲˡΥե뤬ǥ쥯ȥ \f2/home/user/src/com/mypackage\fP ˳ǼƤꡢΥѥå \f2/home/user/lib\fP Υ饤֥˰¸ƤȤޤΤȤΤ褦˻ꤷޤ
.nf
\f3
.fl
% \fP\f3javadoc \-classpath /home/user/lib \-sourcepath /home/user/src com.mypackage\fP
.fl
.fi
-ほかのツールと同様に、\f2\-classpath\fP が指定されていない場合は、CLASSPATH 環境変数が設定されていれば、Javadoc ツールはこの環境変数を使います。どちらも設定されていない場合、Javadoc ツールは現在のディレクトリからクラスを検索します。
-.LP
-Javadoc ツールは拡張機能クラスおよびブートストラップクラスに関連しているため、Javadoc ツールが \f2\-classpath\fP を使用してユーザークラスを検索する方法についての詳細は、
+\f2\-classpath\fP ꤵʤä硢Javadoc ġϤۤΥġƱCLASSPATH ĶѿꤵƤФͤѤޤɤꤵƤʤ硢Javadoc ġϸߤΥǥ쥯ȥ꤫饯饹ޤ
+.LP
+Javadoc ġ뤬 \f2\-classpath\fP Ѥƥ桼饹ˡˤĤơĥ饹֡ȥȥåץ饹ȴϢդƤꤹˤϡ
.na
-\f2「クラスの検索方法」\fP @
+\f2֥饹θˡ\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlをご覧ください。
-.LP
-便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
+http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlȤƤ
+.LP
+ص塢 \f2*\fP Υ١̾ޤ९饹ѥǤϡ \f2.jar\fP ޤ \f2.JAR\fP ĥҤ˻ĥǥ쥯ȥΤ٤ƤΥեΥꥹȤꤹΤƱȤߤʤޤ (java ץϤ 2 ĤθƤӽФ̤Ǥʤ)
.br
.br
-たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。 ただし、JAR ファイルの順番は指定されません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。\f2*\fP だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。\f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
+ȤСǥ쥯ȥ \f2foo\fP \f2a.jar\fP \f2b.JAR\fP ޤޤƤ硢饹ѥ \f2foo/*\fP \f2A.jar:b.JAR\fP ŸޤJAR եν֤̤ȤʤޤΥꥹȤˤϡեޤᡢꤵ줿ǥ쥯ȥΤ٤Ƥ JAR ե뤬ޤޤޤ* \f2饹ѥȥϡ\fP ȥǥ쥯ȥΤ٤Ƥ JAR եΥꥹȤŸޤ \f2CLASSPATH\fP Ķѿ⡢ˤƱͤŸޤ饹ѥΥ磻ɥŸɬJava ۥޥεư˼¹Ԥޤäơ\f2System.getenv("CLASSPATH")\fP ƤӽФΤ褦˴Ķ䤤碌Ԥʤ¤ꡢJava ץबŸƤʤ磻ɥɤǧ뤳ȤϤޤ
.LP
.TP 3
\-subpackages\ \ package1:package2:...
-ソースファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。このオプションは、ソースコードに新しいサブパッケージを追加する際に便利です。新しいサブパッケージは自動的に組み込まれます。各 \f2package\fP 引数は、任意の最上位サブパッケージ (\f2java\fP など) または完全指定のパッケージ (\f2javax.swing\fP など) になります。ソースファイルを含める必要はありません。引数は、コロンで区切られます (すべてのオペレーティングシステム)。ワイルドカードは不要です (使用不可)。パッケージの検索場所を指定するには、\f2\-sourcepath\fP を使用します。このオプションは、「ソースファイルの処理」で説明したとおり、ソースツリーにあるがパッケージには属していないソースファイルを処理しないので役立ちます。
-.LP
-例を示します。
+ե뤫ꤵ줿ѥåӤΥ֥ѥå˺ƵŪ˥ɥȤޤΥץϡɤ˿֥ѥåɲäݤǤ֥ѥåϼưŪȤ߹ޤޤ \f2package\fP ϡǤդκǾ̥֥ѥå ( \f2java\fP ʤ) ޤϴѥå ( \f2javax.swing\fP ʤ) ˤʤޤեޤɬפϤޤϡǶڤޤ (٤ƤΥڥ졼ƥƥ)磻ɥɤפǤ (Բ)ѥåθꤹˤϡ\f2\-sourcepath\fP ѤޤΥץϡ֥եνפȤꡢĥˤ뤬ѥåˤ°ƤʤեʤΤΩޤ
+.LP
+ȤС
.nf
\f3
.fl
% \fP\f3javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax.swing\fP
.fl
.fi
-このコマンドは、「java」および「javax.swing」という名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。
-.LP
-\f2\-exclude\fP とともに \f2\-subpackages\fP を使用すると、特定のパッケージを除外できます。
+Υޥɤϡjavaפӡjavax.swingפȤ̾ΥѥåȤΥ֥ѥåΥɥȤޤ
+.LP
+\f2\-subpackages\fP \f2\-exclude\fP Ȥ߹碌ƻѤȡΥѥåǤޤ
.LP
.TP 3
\-exclude\ \ packagename1:packagename2:...
-指定されたパッケージとそのサブパッケージを \f2\-subpackages\fP によって作成されたリストから無条件に除外します。過去の \f2\-subpackages\fP オプションの指定によって組み込まれたパッケージ、または将来組み込まれるパッケージも除外の対象となります。例を示します。
+ꤵ줿ѥåȤΥ֥ѥå \f2\-subpackages\fP ˤäƺ줿ꥹȤ̵˽ޤ \f2\-subpackages\fP ץλˤäȤ߹ޤ줿ѥåޤϾȤ߹ޤѥåоݤȤʤޤ ޤ
.nf
\f3
.fl
% \fP\f3javadoc \-sourcepath /home/user/src \-subpackages java \-exclude java.net:java.lang\fP
.fl
.fi
-このうち、\f2java.io\fP、\f2java.util\fP、\f2java.math\fP は組み込まれますが、\f2java.net\fP と \f2java.lang\fP 以下のパッケージは除外されます。ただし、\f2java.lang\fP のサブパッケージである \f2java.lang.ref\fP は除外されます。
+ξ硢 \f2java.io\fP \f2java.util\fP \f2java.math\fP ʤɤޤ졢 \f2java.net\fP \f2java.lang\fP 롼Ȥ˻ĥѥåޤξ硢 \f2java.lang\fP Υ֥ѥåǤ \f2java.lang.ref\fP դƤ
.LP
.TP 3
\-bootclasspath\ classpathlist
-ブートクラスが存在するパスを指定します。ブートクラスとは、通常、Java プラットフォームのコアクラスのことです。ブートクラスパスは、Javadoc ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。詳細は、
+֡ȥ饹¸ߤѥꤷޤ֡ȥ饹Ȥϡ̾Java ץåȥեΥ饹ΤȤǤ֡ȥ饹ѥϡJavadoc ġ뤬եȥ饹եõȤ˻ȤѥΰǤܺ٤ϡ
.na
-\f2「javac と javadoc がクラスを検索する方法」\fP @
+\f2֥饹θˡ\fP @
.fi
-http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfilesを参照してください。\f2classpathlist\fP 内の複数のディレクトリは、コロン (:) で区切ります。
+http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfilesȤƤ (:) \f2classpathlist\fP Υǥ쥯ȥ֤ζڤʸȤƻѤޤ
.LP
.TP 3
\-extdirs\ dirlist
-拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java 拡張機能機構を使うすべてのクラスです。extdirs は、Javadoc ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。詳細は、前述の \f2\-classpath\fP を参照してください。\f2dirlist\fP 内の複数のディレクトリは、コロン (:) で区切ります。
+ĥǽ饹¸ߤǥ쥯ȥꤷޤĥǽ饹ȤϡJava ĥǽȤ٤ƤΥ饹Ǥextdirs ϡJavadoc ġ뤬եȥ饹եõȤ˻ȤѥΰǤܺ٤ϡҤ \f2\-classpath\fP ȤƤ (:) \f2dirlist\fP Υǥ쥯ȥ֤ζڤʸȤƻѤޤ
.LP
.TP 3
\-verbose
-javadoc の実行中に詳細なメッセージを表示します。verbose オプションを指定しないと、ソースファイルのロード時、ドキュメントの生成時 (ソースファイルごとに 1 つのメッセージ)、およびソート時にメッセージが表示されます。verbose オプションを指定すると、各 Java ソースファイルの解析に要した時間 (ミリ秒単位) など、追加のメッセージが表示されます。
+javadoc μ¹˾ܺ٤ʥåɽޤverbose ץꤷʤȡեΥɻɥȤ (ե뤴Ȥ 1 ĤΥå)ӥȻ˥åɽޤverbose ץꤹȡ Java եβϤפ (ߥñ) ʤɡɲäΥåɽޤ
.LP
.TP 3
\-quiet
-エラーメッセージまたは警告メッセージ以外のメッセージを抑制し、警告とエラーだけが表示されるようにして、これらを特定しやすくします。バージョン文字列も抑制します。
+顼åޤϷٹåʳΥåٹȥ顼ɽ褦ˤơꤷ䤹ޤСʸޤ
.LP
.TP 3
\-breakiterator\
-英語言語というロケール固有のアルゴリズムではなく、
+ѸκǽʸꤹݤˡѸѤΥͭΥ르ꥺǤϤʤ
.na
\f2java.text.BreakIterator\fP @
.fi
-http://java.sun.com/javase/6/docs/api/java/text/BreakIterator.html の国際化された文境界を使用して、英文の最初の文の終わりを判断します (他のすべてのロケールはすでに \f2BreakIterator\fP を使用)。\f2「最初の文」\fPとは、パッケージ、クラス、またはメンバーの主説明での最初の文のことです。この文は、パッケージ、クラス、またはメンバーの要約にコピーされ、アルファベット順のインデックスにコピーされます。
-.LP
-JDK 1.2 以降、BreakIterator クラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、1.2 以降では、\f2\-breakiterator\fP オプションは英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。
+http://java.sun.com/javase/6/docs/api/java/text/BreakIterator.html ιݲ줿ʸѤޤ (ۤΤ٤ƤΥǤϤǤ \f2BreakIterator\fP ѤƤ)\f2ֺǽʸ\fPȤϡѥå饹ޤϥСμǤκǽʸΤȤǤʸϡѥå饹ޤϥС˥ԡ졢ե٥åȽΥǥå˥ԡޤ
+.LP
+JDK 1.2 ʹߡBreakIterator 饹ϡѸ٤ƤθʸνȽǤ뤿ˡǤ˻ѤƤޤäơ \f2\-breakiterator\fP ץϡ1.2 ʹߤǤϱʸʳˤϸ̤ޤʸˤϡΤ褦ȼΥǥեȤΥ르ꥺबޤ
.RS 3
.TP 2
o
-英文のデフォルトの文区切りアルゴリズム \- 空白または HTML ブロックタグ (\f2<P>\fP など) が続くピリオドで停止する
+ʸΥǥեȤʸڤꥢ르ꥺ \- ޤ HTML ֥å ( \f2<P>\fP ʤ) ³ԥꥪɤߤ
.TP 2
o
-breakiterator 文区切りアルゴリズム \- 一般に、次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止する。このアルゴリズムでは、ほとんどの省略表記が処理される (「The serial no. is valid」は処理されるが「Mr. Smith」は処理されない)。HTML タグや、数字または記号で始まる文では停止しない。HTML タグに埋め込まれている場合でも、「../filename」の最後のピリオドで停止する
+breakiterator ʸڤꥢ르ꥺ \- ̤ˡθ줬ʸǻϤޤ硢ʸ³ԥꥪɡ䡢ޤϴòߤ롣Υ르ꥺǤϡThe serial no. is validפʤɡۤȤɤξάɽޤMr. SmithפʤɤϽޤHTML 䡢ޤϵǻϤޤʸǤߤʤHTML ޤƤǤ⡢../filenameפκǸΥԥꥪɤߤ
.RE
-.RS 3
-
-.LP
-.LP
-注: 1.5.0 からは、1.4.x に設けられていた breakiterator 警告メッセージを削除し、デフォルトの文区切りアルゴリズムを変更していません。つまり、\\\-breakiterator オプションは、1.5.0 ではデフォルトではなくなり、またデフォルトにするつもりもありません。これは、「次のメジャーリリース」(1.5.0) でデフォルトを変更するという、以前の目的とは逆になっています。つまり、ソースコードを変更せず、1.4.x での breakiterator 警告を除去していない場合でも、1.5.0 からは何もする必要がなく、警告は消滅しています。 この逆戻りの理由は、breakiterator をデフォルトにするメリットよりも、デフォルトにするために必要となる、互換性のないソースの変更の方が負担が大きかったためです。この件で皆様に余分の手間をおかけし、混乱を招いたことをお詫びいたします。
-.LP
-.RE
+.LP
+: 1.5.0 ϡ1.4.x ߤƤ breakiterator ٹåǥեȤʸڤꥢ르ꥺѹƤޤĤޤꡢ\\\-breakiterator ץϡ1.5.0 ǤϥǥեȤǤϤʤʤꡢޤǥեȤˤĤ⤢ޤϡּΥ㡼(1.5.0) ǥǥեȤѹȤŪȤϵդˤʤäƤޤĤޤꡢɤѹ1.4.x Ǥ breakiterator ٹƤʤǤ⡢1.5.0 ϲ⤹ɬפʤٹϾǤƤޤεͳϡbreakiterator ǥեȤˤåȤ⡢ǥեȤˤ뤿ɬפȤʤ롢ߴΤʤѹô礭äǤηdzͤ;ʬμ֤ȤͤӤޤ
.TP 3
\-locale\ language_country_variant
-.RS 3
-.LP
-\f3重要\fP \- \f2\-locale\fP オプションは、標準ドックレットが提供するすべてのオプション、またはその他の任意のドックレットの提供するすべてのオプションより前 (左側) に指定する必要があります。そうしないと、ナビゲーションバーが英語で表示されます。このコマンド行オプションだけは、指定する順序に依存します。
-.LP
-.RE
-.LP
-Javadoc がドキュメントを生成するときに使うロケールを指定します。引数には、java.util.Locale のドキュメントで説明されているロケールの名前を指定します。たとえば、\f2en_US\fP (英語、米国)、\f2en_US_WIN\fP (Windows で使われる英語) などを指定します。
-.LP
-ロケールを指定すると、指定したロケールのリソースファイルが Javadoc によって選択されて、メッセージ (ナビゲーションバー、リストと表の見出し、ヘルプファイルの目次、stylesheet.css のコメントなどの文字列) のために使われます。また、アルファベット順にソートされるリストのソート順、および最初の文の末尾を判別するための文の区切り文字も、指定したロケールによって決まります。ただし、このオプションは、ドキュメント化されるクラスのソースファイル内で指定されているドキュメンテーションコメントのテキストのロケールを決定するものではありません。
+.LP
+\f3\fP \- \f2\-locale\fP ץϡ\f2ɸɥååȤ뤹٤ƤΥץ\fPޤϤ¾ǤդΥɥååȤ뤹٤ƤΥץ (¦) ˻ꤹɬפޤʤȡʥӥСѸɽޤΥޥɹԥץϡꤹ˰¸ޤ
+.LP
+Javadoc ɥȤȤ˻ȤꤷޤΰϼΤ褦ʡjava.util.Locale ΥɥơƤ̾Ǥ \f2en_US\fP (Ѹ졢ƹ) ޤ \f2en_US_WIN\fP (Windows ǻѤѸ)
+.LP
+ꤹȡꤷΥե뤬 Javadoc ˤäơå (ʥӥСꥹȤɽθФإץեܼstylesheet.css ΥȤʤɤʸ) Τ˻Ȥޤޤե٥åȽ˥ȤꥹȤΥȽ硢ӺǽʸȽ̤뤿ʸζڤʸ⡢ꤷˤäƷޤޤΥץϡɥȲ륯饹ΥեǻꤵƤɥơȤΥƥȤΥꤹΤǤϤޤ
.LP
.TP 3
\-encoding\ name
-ソースファイルのエンコーディングの名前 (\f2EUCJIS/SJIS\fP など) を指定します。このオプションが指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。
-.LP
-\-docencoding および \-charset も参照してください。
+եΥǥ̾ ( \f2EUCJIS/SJIS\fP ʤ) ꤷޤ ΥץꤵƤʤϡץåȥեΥǥեȥСȤޤ
+.LP
+\-docencoding \-charset ⻲ȤƤ
.LP
.TP 3
\-Jflag
-javadoc を実行する実行時システム java に、\f2flag\fP を直接渡します。\f2J\fP と \f2flag\fP の間に空白を入れてはなりません。たとえば、生成ドキュメントを処理するためにシステムで 32M バイトのメモリーを確保しておく必要がある場合は、Java の \f2\-Xmx\fP オプションを次のように呼び出します。 \f2\-Xms\fP は、省略可能です。 これは、初期メモリーのサイズを設定するだけのオプションで、必要なメモリーの最小サイズがわかっている場合に便利です。
+javadoc ¹Ԥ¹Իƥ java ˡ\f2flag\fP ľϤޤ \f2J\fP \f2flag\fP δ֤˶ʤ褦դƤȤСɥȤνѤȤ32M ХȤΥƥdzݤƤɬפˤϡjava \f2\-Xmx\fP ץΤ褦˸ƤӽФޤ\f2\-Xms\fP ϾάǽǤϡνꤹΥץǡκɬ̤狼äƤǤ
.nf
\f3
.fl
% \fP\f3javadoc \-J\-Xmx32m \-J\-Xms32m\fP \f3com.mypackage\fP
.fl
.fi
-使用している javadoc のバージョンを確認するには、次のように java の「\f2\-version\fP」オプションを呼び出します。
+ѤƤ javadoc ΥСǧˤϡΤ褦 Java \f2\-version\fPץƤӽФޤ
.nf
\f3
.fl
@@ -4607,17 +3110,16 @@
Classic VM (build JDK\-1.2\-V, green threads, sunwjit)
.fl
.fi
-出力ストリームには標準ドックレットのバージョン番号が含まれます。
+ϥȥˤɸɥååȤΥСֹ椬ޤޤޤ
.RE
.SS
-標準ドックレットが提供するオプション
-.LP
+ɸɥååȤ륪ץ
.RS 3
.TP 3
\-d\ directory
-生成された HTML ファイルを保存する生成先ディレクトリを指定します(「d」は「生成先 (destination)」の意味)。このオプションを省略すると、生成されたファイルは現在のディレクトリに保存されます。値 \f2directory\fP には、絶対ディレクトリ、または現在の作業ディレクトリからの相対ディレクトリを指定できます。バージョン 1.4 では、javadoc を実行すると生成先ディレクトリが自動的に作成されます。
-.LP
-たとえば、次の例では、\f2com.mypackage\fP パッケージのドキュメントを生成し、結果を \f2/home/user/doc/\fP ディレクトリに保存します。
+줿 HTML ե¸ǥ쥯ȥꤷޤ(dפϡ (destination)פΰ̣)Υץάȡ줿եϸߤΥǥ쥯ȥ¸ޤ \f2directory\fP ˤϡХǥ쥯ȥꡢޤϸߤκȥǥ쥯ȥ꤫Хǥ쥯ȥǤޤС 1.4 Ǥϡjavadoc ¹Ԥǥ쥯ȥ꤬ưŪ˺ޤ
+.LP
+Ȥмξ硢ѥå \f2com.mypackage\fP ΥɥȤ졢η̤ \f2/home/user/doc/\fP ǥ쥯ȥ¸ޤ
.nf
\f3
.fl
@@ -4627,50 +3129,50 @@
.LP
.TP 3
\-use
-ドキュメント化されるクラスおよびパッケージごとに 1 つの [使用] ページを組み込みます。このページには、その特定のクラスまたはパッケージの API を使っているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドが記述されます。たとえば、クラス C を例にとると、クラス C を使っているものとしては、C のサブクラス、C として宣言されているフィールド、C を返すメソッド、および、型 C のパラメータを持つメソッドとコンストラクタがあります。
-.LP
-たとえば、String の [使用] ページに何が表示されるかを見てみましょう。\f2java.awt.Font\fP クラスの \f2getName()\fP メソッドは、\f2String\fP 型を返します。したがって、\f2getName()\fP は \f2String\fP を使っているので、\f2String\fP の [使用] ページにはこのメソッドがあります。
-.LP
-ただし、ドキュメント化されるのは API の使用だけであって、実装はドキュメント化されません。あるメソッドが、その実装の中で \f2String\fP を使っていても、引数として文字列をとったり、文字列を返したりしない場合は、\f2String\fP の「使用」とはみなされません。
-.LP
-生成された [使用] ページにアクセスするには、目的のクラスまたはパッケージに移動し、ナビゲーションバーの [使用] リンクをクリックします。
+ɥȲ륯饹ӥѥåȤ 1 ĤΡֻѡץڡȤ߹ߤޤΥڡˤϡΥ饹ޤϥѥå API ȤäƤѥå饹åɡȥ饯ӥեɤҤޤȤС饹 C ˤȤȡ饹 C ȤäƤΤȤƤϡC Υ֥饹C ȤƤեɡC ֤åɡӡ C Υѥĥåɤȥȥ饯ޤ
+.LP
+ȤСString [] ڡ˲ɽ뤫Ƥߤޤ礦java.awt.Font 饹 \f2getName()\fP åɤϡ \f2String\fP ͤ \f2֤ޤ\fPäơ \f2getName()\fP \f2String\fP ѤƤΤǡString [] ڡ \f2Υåɤɽޤ\fP
+.LP
+ɥȲΤ API λѤǤäơϥɥȲޤåɤμ \f2String\fP ȤäƤƤ⡢ȤʸȤäꡢʸ֤ꤷʤϡ \f2String\fP ΡֻѡפȤϤߤʤޤ
+.LP
+줿 [] ڡ˥ˤϡŪΥ饹ޤϥѥå˰ưʥӥС [] åޤ
.TP 3
\-version
-生成ドキュメントに、@version のテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用している Javadoc ツールのバージョンを確認するには、\f2\-J\-version\fP オプションを使用します。
+ɥȤˡ@version ΥƥȤȤ߹ߤޤΥƥȤϡǥեȤǤϾάޤѤƤ Javadoc ġΥСǧˤ \f2\-J\-version\fP ץѤޤ
.LP
.TP 3
\-author
-生成ドキュメントに、@author のテキストを組み込みます。
+ɥȤˡ@author ΥƥȤȤ߹ߤޤ
.LP
.TP 3
\-splitindex
-索引ファイルをアルファベットごとに複数のファイルに分割し、文字ごとに 1 つのファイルと、アルファベット以外の文字で始まる索引エントリ用に 1 つのファイルを作成します。
+եե٥åȤȤʣΥեʬ䤷ʸȤ 1 ĤΥեȡե٥åȰʳʸǻϤޤȥѤ 1 ĤΥեޤ
.LP
.TP 3
\-windowtitle\ title
-HTML の <title> タグに配置するタイトルを指定します。指定したタイトルは、ウィンドウのタイトルや、このページに対して作成されたブラウザのブックマーク (お気に入り) に表示されます。このタイトルには HTML タグを含めないでください。 タイトルに HTML タグが含まれていると、ブラウザがタグを正しく解釈できません。\f2title\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。\-windowtitle が省略されている場合、Javadoc ツールは、このオプションの代わりに \-doctitle の値を使います。
+HTML <title> ֤륿ȥꤷޤꤷȥϡɥΥȥ䡢ΥڡФƺ줿֥饦Υ֥åޡ () ɽޤΥȥˤ HTML ޤʤǤȥ HTML ޤޤƤȡ֥饦Ǥޤ\f2title\fP ǰȤϡפɬפޤ\-windowtitle άƤ硢Javadoc ġϡΥץ \-doctitle ͤȤޤ
.nf
\f3
.fl
- % \fP\f3javadoc \-windowtitle "Java 2 Platform" com.mypackage\fP
+ % \fP\f3javadoc \-windowtitle "Java SE Platform" com.mypackage\fP
.fl
.fi
.TP 3
\-doctitle\ title
-概要ファイルの最上部の近くに配置するタイトルを指定します。タイトルは中央揃えになり、レベル 1 の見出しとして、上部ナビゲーションバーのすぐ下に置かれます。\f2title\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2title\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。
+ץեκǾζ֤륿ȥꤷޤȥ·ˤʤꡢ٥ 1 θФȤơʥӥСΤ֤ޤ\f2title\fP ˤϡHTML ȶޤ뤳ȤǤޤޤϡΤǰϤޤʤФʤޤ\f2title\fP ǰȤϡפɬפޤ
.nf
\f3
.fl
- % \fP\f3javadoc \-doctitle "Java (TM)" com.mypackage\fP
+ % \fP\f3javadoc \-doctitle "Java(TM)" com.mypackage\fP
.fl
.fi
.TP 3
\-title\ title
-\f3このオプションは、現在は存在しません。\fPJavadoc 1.2 のベータ版にだけ存在しました。このオプションは、\f2\-doctitle\fP という名前に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。
+\f3ΥץϤ⤦¸ߤƤޤ\fPΥץ Javadoc 1.2 Υ١Ǥˤ¸ߤƤޤǤΥץ̾ \f2\-doctitle\fP ѹޤ̾ѹͳϡΥץɥΥȥǤϤʤɥȤΥȥ뤳ȤΤˤ뤿Ǥ
.LP
.TP 3
\-header\ header
-各出力ファイルの上端に配置するヘッダーテキストを指定します。ヘッダーは、上部ナビゲーションバーの右側に配置されます。\f2header\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2header\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。
+ƽϥեξü֤إåƥȤꤷޤإåϡʥӥСα¦֤ޤ\f2header\fP ˤϡHTML ȶޤ뤳ȤǤޤޤϡΤǰϤޤʤФʤޤ\f2header\fP ǰȤϡפɬפޤ
.nf
\f3
.fl
@@ -4680,73 +3182,77 @@
.LP
.TP 3
\-footer\ footer
-各出力ファイルの下端に配置するフッターテキストを指定します。フッターは、下部ナビゲーションバーの右側に配置されます。 \f2footer\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2footer\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。
+ƽϥեβü֤եåƥȤꤷޤեåϡʥӥСα¦֤ޤ\f2footer\fP ˤϡHTML ȶޤ뤳ȤǤޤޤϡΤǰϤޤʤФʤޤ\f2footer\fP ǰȤϡפɬפޤ
+.LP
+.TP 3
+\-top
+ƽϥեξü֤ƥȤꤷޤ
.LP
.TP 3
\-bottom\ text
-各出力ファイルの最下部に配置するテキストを指定します。このテキストは、下部ナビゲーションバーより下の、ページの最下部に配置されます。\f2text\fP には、HTML タグと空白を含めることができますが、これらを含める場合は、全体を引用符で囲まなければなりません。\f2text\fP の中で引用符を使う場合は、引用符をエスケープする必要があります。
+ƽϥեκDz֤ƥȤꤷޤΥƥȤϡʥӥС겼ΡڡκDz֤ޤ \f2text\fP ˤϡHTML ȶޤ뤳ȤǤޤޤϡΤǰϤޤʤФʤޤ \f2text\fP ǻѤ硢פʤФʤʤǽޤ
.LP
.TP 3
\-link\ extdocURL
-javadoc により生成された既存の外部参照クラスのドキュメンテーションへのリンクを作成します。引数を 1 つとります。
+javadoc ˤ줿¸γȥ饹ΥɥơؤΥޤ 1 ĤȤޤ
.LP
.RS 3
.TP 2
o
-\f4extdocURL\fP は、リンク先として指定する、javadoc によって生成された外部ドキュメントを含むディレクトリの絶対 URL または相対 URL です。あとで例を示します。このディレクトリ内にパッケージリストファイルが存在していなければなりません。 存在しない場合は、\f2\-linkoffline\fP を使用します。Javadoc ツールは、\f2パッケージリスト\fPファイルからパッケージ名を読み取り、これらのパッケージをその URL にリンクします。Javadoc ツールを実行すると、作成される \f2<A HREF>\fP リンク内に \f2extdocURL\fP の値がそのままコピーされます。したがって、\f2extdocURL\fP はファイルへの URL ではなく「ディレクトリへの URL」でなければなりません。
-.LP
-\f2extdocURL\fP への絶対リンクを使用すると、ユーザーのドキュメントを任意の Web サイト上のドキュメントにリンクできます。 相対位置へリンクするだけでよい場合は相対リンクを使用できます。相対リンクを使用する場合、\f2\-d\fP を使って、生成先ディレクトリからリンクされるパッケージのあるディレクトリの相対パスを指定する必要があります。
-.LP
-通常、絶対リンクを指定する場合は、\f2http:\fPリンクを使用します。Web サーバーを持たないファイルシステムにリンクする場合は、\f2file:\fP リンクを使用できます。ただし、この方法は、すべてのユーザーが生成された同じファイルシステムを共有するドキュメントにアクセスする必要がある場合以外は使用しないでください。
-.LP
-いかなる場合にも、いかなるオペレーティングシステムでも、絶対 URL か相対 URL か、「http:」ベースか「file:」ベースかにかかわらず、スラッシュを区切り文字として使用します (
+\f4extdocURL\fP ϡȤƻꤹ롢javadoc ˤä줿ɥȤޤǥ쥯ȥ URL ޤ URL ǤȤޤΥǥ쥯ȥ˥ѥåꥹȥե뤬¸ߤƤʤФʤޤ ¸ߤʤϡ\f2\-linkoffline\fP ѤޤJavadoc ġϡ \f2package\-list\fP ե뤫ѥå̾ɤäȡ URL ǤΥѥå˥ޤJavadoc ġμ¹Իˡ\f2extdocURL\fP ͤΤޤޡ줿 \f2<A HREF>\fP ˥ԡޤäơ\f2extdocURL\fP ϥեؤ URL ǤϤʤ֥ǥ쥯ȥؤ URLפǤʤФʤޤ
+.LP
+\f2extdocURL\fP ؤХѤȡ桼ΥɥȤǤդ Web ȾΥɥȤ˥Ǥޤа֤إǤ褤ХѤǤޤХξ硢桼Ϥͤϡ( \f2\-d\fP ǻꤵ줿) ǥ쥯ȥ꤫顢Ȥʤѥåޤǥ쥯ȥؤХѥˤ٤Ǥ
+.LP
+̾Хꤹϡ \f2http:\fP ѤޤWeb Сʤե륷ƥ˥ϡ \f2file: ѤǤޤ\fP ˡϡ٤ƤΥ桼줿Ʊե륷ƥͭɥȤ˥ɬפʳϻѤʤǤ
+.LP
+٤Ƥξ硢٤ƤΥڥ졼ƥƥǡ URL URLhttp:ץ١ȡfile:ץ١ˤ餺åڤʸȤƻѤޤ (
.na
\f2URL Memo\fP @
.fi
-http://www.ietf.org/rfc/rfc1738.txt で指定)。
+http://www.ietf.org/rfc/rfc1738.txt ǻ)
.RS 3
.TP 3
-http:ベースの絶対リンク:
+http: ١Х:
\f2\-link http://<host>/<directory>/<directory>/.../<name>\fP
.TP 3
-file:ベースの絶対リンク:
+file: ١Х:
\f2\-link file://<host>/<directory>/<directory>/.../<name>\fP
.TP 3
-相対リンク:
+Х:
\f2\-link <directory>/<directory>/.../<name>\fP
.RE
.RE
.LP
-javadoc の実行時に複数の \f2\-link\fP オプションを指定して、複数のドキュメントへのリンクを作成することもできます。 \f3\-linkoffline または \-link の選択\fP
+javadoc 1 μ¹Ԥʣ \f2\-link\fP ץꤹСʣΥɥȤؤΥǤޤ \f3\-linkoffline ޤ \-link \fP
.br
-\f2\-link\fP を使用する場合:
+\f2\-link\fPѤ:
.RS 3
.TP 2
o
-外部 API ドキュメントへの相対パスを使用する場合
+ API ɥȤؤХѥѤ
.TP 2
o
-外部 API ドキュメントへの絶対 URL を使用する場合 (プログラムがその URL に接続し、読み取りを行うことがシェルによって許可されている場合)
+ API ɥȤؤ URL Ѥ (ץब URL ³ɤԤȤˤäƵĤƤ)
.RE
-次のような場合は、\f2\-linkoffline\fP オプションを使用します。
+\f2\-linkoffline\fP Ѥ:
.RS 3
.TP 2
o
-プログラムがその URL に接続し、読み取りを行うことがシェルによって許可されていない場合に外部 API ドキュメントへの絶対 URL を使用する場合。このような状況は、リンク先のドキュメントがファイアウォールの向こう側にある場合に発生します。
+ API ɥȤؤ URL Ѥ (ץब URL ³ɤԤȤˤäƵĤƤʤ)Τ褦ʾϡΥɥȤեθ¦ˤȯޤ
.RE
.LP
-\f3外部ドキュメントへの絶対リンクの使用例\fP \-
+\f3ɥȤؤХλ\fP \- \f2java.lang\fP \f2java.io\fP ¾ Java ץåȥեѥå (
.na
-\f2http://java.sun.com/j2se/1.5.0/docs/api\fP @
+\f2http://java.sun.com/javase/6/docs/api/\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/api 内の \f2java.lang\fP、\f2java.io\fP、その他の Java 2 プラットフォームパッケージにリンクしたい場合があります。 次のコマンドは、\f2com.mypackage\fP パッケージのドキュメントと Java 2 プラットフォームパッケージへのリンクを生成します。生成されたドキュメントには、たとえばクラスツリー内の \f2Object\fP クラスへのリンクが含まれています。\f2\-sourcepath\fP や \f2\-d\fP などの他のオプションは表示されません。
+http://java.sun.com/javase/6/docs/api ) ˥ͤޤΥޥɤϡJava SE ץåȥեѥåؤΥޤѥå \f2com.mypackage\fP ΥɥȤޤ줿ɥȤˤϡȤХ饹ĥ \f2Object\fP 饹ؤΥޤޤƤޤʤ \f2\-sourcepath\fP \f2\-d\fP ʤɡ¾ΥץϼƤޤ
.nf
\f3
.fl
- % \fP\f3javadoc \-link http://java.sun.com/j2se/1.5.0/docs/api com.mypackage\fP
+ % \fP\f3javadoc \-link http://java.sun.com/javase/6/docs/api com.mypackage\fP
.fl
.fi
-\f3外部ドキュメントへの相対リンクの使用例\fP \- 2 つのパッケージがあり、そのドキュメントが Javadoc ツールを複数回実行した結果生成されたものであるとします。 さらに、これらのドキュメントが相対パスで分割されているとします。この例の場合、2 つのパッケージは、API である \f2com.apipackage\fP とSPI (サービスプロバイダインタフェース) である \f2com.spipackage\fP です。ドキュメントの格納先は \f2docs/api/com/apipackage\fP パッケージと \f2docs/spi/com/spipackage\fP パッケージです。API パッケージのドキュメントがすでに生成されていて、現在のディレクトリが \f2docs\fP である場合、次のコマンドを実行することによって、この API ドキュメントへのリンクを持つ SPI パッケージをドキュメント化します。
+\f3ɥȤؤХλ\fP \- 2 ĤΥѥåꡢΥɥȤ Javadoc ġʣ¹Ԥ줿ΤǤȤޤˡΥɥȤХѥʬ䤵ƤȤޤξ硢ѥåϡAPI Ǥ \f2com.apipackage\fP ȡSPI (ӥץХե) Ǥ \f2com.spipackage\fP ǤɥȤγǼϡ \f2docs/api/com/apipackage\fP \f2docs/spi/com/spipackage\fP ǤAPI ѥåΥɥȤϤǤѤߤǡ \f2docs\fP ȥǥ쥯ȥˤʤäƤȲꤹȡAPI ɥȤؤΥޤ SPI ѥåɥȲˤϡΥޥɤ¹Ԥޤ
.nf
\f3
.fl
@@ -4754,43 +3260,43 @@
.fl
.fi
.LP
-\f2\-link\fP 引数は、生成先ディレクトリ (\f2docs/spi\fP) の相対パスです。
-.LP
-\f3詳細\fP \- \f2\-link\fP オプションを使うと、「コードからは参照されていても、Javadoc の今回の実行ではドキュメント化されない」というクラスにリンクできるようになります。リンクから有効なページに移動できるようにするには、それらの HTML ページがある場所を調べ、その場所を \f2extdocURL\fP に指定する必要があります。このオプションを使うと、たとえば、サードパーティーのドキュメントから、\f2http://java.sun.com\fP にある \f2java.*\fP のドキュメントにリンクすることができます。
-.LP
-今回の実行で Javadoc によって生成されるドキュメント内の API だけを対象にリンクを作成する場合は、\f2\-link\fP オプションを省略します。\f2\-link\fP オプションが指定されていない場合、Javadoc ツールは、外部参照されたドキュメントへのリンクを作成しません。これは、そのドキュメントが存在するかどうか、および存在する場合はその場所を判別できないからです。
-.LP
-このオプションでは、生成ドキュメント内の複数の場所にリンクを作成できます。
-.LP
-また、このオプションを使うと、複数のパッケージ群の間にクロスリンクを作成することもできます。つまり、ある一式のパッケージに対して javadoc を実行したあと、別の一式のパッケージに対して javadoc を実行し、これら 2 つのパッケージ群の間にクロスリンクを作成できます。
-.LP
-\f3クラスの参照方法\fP \- 外部参照クラスへのリンクを、テキストラベルだけではなく実際に表示するには、次の方法でクラスを参照する必要があります。メソッドの本体でクラスを参照するだけでは十分ではありません。\f2import\fP 文または宣言で参照する必要があります。次に、クラス \f2java.io.File\fP を参照する方法の例を示します。
+\f2\-link\fP ΰϡǥ쥯ȥ (\f2docs/spi\fP) ХѥǤ
+.LP
+\f3ܺ\fP \- \f2\-link\fP ץȤȡ֥ɤϻȤƤƤ⡢Javadoc κμ¹ԤǤϥɥȲʤפȤ饹˥Ǥ褦ˤʤޤͭʥڡ˰ưǤ褦ˤˤϡ HTML ڡĴ١ξ \f2extdocURL\fP ˻ꤹɬפޤˤꡢȤСɥѡƥΥɥȤ \f2http://java.sun.com java.*\fP ΥɥȤؤΥ \f2ǽȤʤޤ\fP
+.LP
+μ¹Ԥ Javadoc ˤäɥ API оݤ \f2ϡ\fP \-link ץάޤ \f2\-link\fP ץꤵƤʤ硢Javadoc ġϡȤ줿ɥȤؤΥޤϡΥɥȤ¸ߤ뤫ɤ¸ߤϤξȽ̤ǤʤǤ
+.LP
+ΥץǤϡɥʣξ˥Ǥޤ
+.LP
+⤦ 1 ĤӤϡѥååȴ֤ǤΥǤΥѥååȤФ javadoc ¹Ԥȡ¾ΥѥååȤФ javadoc ټ¹Ԥ뤳Ȥˤꡢξåȴ֤ΥǤޤ
+.LP
+\f3饹λˡ\fP \- ȥ饹ؤΥƥȥ٥ǤϤʤºݤɽˤϡˡǥ饹ȤɬפޤåɤΤǥ饹ȤǤϽʬǤϤޤΥ饹ϡ \f2import\fP ʸΤξǻȤƤɬפޤHere are examples of how the class \f2java.io.File\fP can be referenced:
.RS 3
.TP 2
o
-すべての種類の \f2import\fP 文の場合: ワイルドカードによるインポート、名前による明示的なインポート、または \f2java.lang.*\fP に対する自動的なインポート。たとえば、次のようにすれば十分です。
+٤Ƥμ \f2import\fP ʸξ: 磻ɥɤˤ륤ݡȡ̾ˤŪʥݡȡޤ \f2java.lang.* Ф뼫ưŪʥݡ\fPȤСΤ褦ˤнʬǤ
.br
\f2import java.io.*;\fP
.br
-1.3.x および 1.2.x では、名前による明示的なインポートだけです。ワイルドカードによるインポート文も、自動インポート \f2java.lang.*\fP も使用できません。
+1.3.x 1.2.x Ǥϡ̾ˤŪʥݡȤǤ磻ɥɤˤ륤ݡʸ⡢ \f2java.lang.* μưݡȤѤǤޤ\fP
.TP 2
o
-宣言の場合:
+ξ:
.br
\f2void foo(File f) {}\fP
.br
-この参照を使用し、メソッド、コンストラクタ、フィールド、クラス、またはインタフェースの戻り値の型またはパラメータの型に置くか、\f2implements\fP、\f2extends\fP、または \f2throws\fP 文に置きます。
+λȤѤåɡȥ饯եɡ饹ޤϥեͤηޤϥѥη֤ \f2implements\fP \f2extends\fP ޤ \f2throws\fP ʸ֤ޤ
.RE
.LP
-この結果、\f2\-link\fP オプションを使用しても、この制限のために誤って表示されない多くのリンクが多数発生する可能性があります。テキストはハイパーテキストリンクが付けられずに表示されます。これらのリンクが表示する警告から、このリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するためのもっとも安全な方法は上で説明したとおり、当該のクラスをインポートすることです。
-.LP
-\f3パッケージリスト\fP \- \f2\-link\fP オプションは、\f2package\-list\fP という名前のファイルを要求します。 このファイルは、Javadoc ツールによって生成され、\f2\-link\fP によって指定した URL に存在します。\f2package\-list\fP ファイルは、その場所にあるドキュメント化されたパッケージの名前のリストが入った単純なテキストファイルです。前の例では、Javadoc ツールは指定された URL にある \f2package\-list\fP という名前のファイルを探し、パッケージ名を読み込んで、その URL にあるそれらのパッケージへのリンクを作成しました。
-.LP
-たとえば、Java プラットフォーム v5.0 API のパッケージリストは
+פʷ̤Ȥơ \f2\-link\fP ץλѻˡ¤Τ˸äɽʤ¿ȯǽޤƥȤϥϥѡƥȥդ줺ɽޤΥɽٹ𤫤顢ΥǧǤޤ饹Ȥˤäƥɲä뤿ΤäȤˡϾȤꡢΥ饹ݡȤ뤳ȤǤ
+.LP
+\f3ѥåꥹ\fP \- \f2\-link\fP ץǽˤϡJavadoc ġˤä \f2package\-list\fP Ȥ̾Υե뤬桼 \f2\-link\fP ˻ꤷ URL ¸ߤƤɬפޤ \f2package\-list\fP եϡξˤɥȲ줿ѥå̾ΥꥹȤäñʥƥȥեǤǤϡJavadoc ġϡꤵ줿 URL \f2package\-list\fP Ȥ̾Υեѥå̾ɤ߹ȡ URL ˤ뤽ΥѥåؤΥޤ
+.LP
+ȤСJava SE 6 API ΥѥåꥹȤ
.na
-\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
+\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/api/package\-list にあり、次のような内容で始まっています。
+http://java.sun.com/javase/6/docs/api/package\-list ˤꡢΤ褦ƤǻϤޤäƤޤ
.nf
\f3
.fl
@@ -4808,64 +3314,64 @@
.fl
java.awt.font
.fl
- その他 ...
+ ¾
.fl
\fP
.fi
.LP
-\f2\-link\fP オプションを指定せずに javadoc を実行した場合、外部参照クラスに属する名前を見つけると、javadoc はその名前をリンクを持たない形で出力します。一方、\f2\-link\fP オプションを指定した場合は、指定した \f2extdocURL\fP にある \f2package\-list\fP ファイルから該当するパッケージ名が検索されます。パッケージ名が見つかると、\f2extdocURL\fP が名前の前に付加されます。
-.LP
-すべてのリンクが正しく機能するためには、外部参照のすべてのドキュメントが、指定した URL に存在していなければなりません。Javadoc ツールは、指定された package\-list が存在するかどうかを調べるだけで、指定された URL に目的のページが存在するかどうかはチェックしません。
-.LP
-\f3複数のリンク\fP \- 複数の \f2\-link\fP オプションを指定すると、生成された任意の数の外部ドキュメントに対してリンクを設定できます。Javadoc 1.2 には、複数の \f2\-link\fP オプションを指定できないというバグがあります。これは 1.2.2 で修正されました。
-.LP
-リンクする外部ドキュメントごとに、次のように別々のリンクオプションを指定します。
-.LP
-\ \ \f2% \fP\f4javadoc \-link\fP \f2extdocURL1\fP \f4\-link\fP \f2extdocURL2\fP \f2...\fP\f4\-link\fP \f2extdocURLn\fP \f4com.mypackage\fP
-.LP
-\f2extdocURL1\fP、\f2extdocURL2\fP、... \f2extdocURLn\fP は、それぞれ外部ドキュメントのルートを指し、各ルートには \f2package\-list\fP という名前のファイルが入っています。
-.LP
-\f3クロスリンク\fP \- まだ生成されていない 2 つ以上のドキュメントをクロスリンクする場合は、「ブートストラップ」が必要になります。つまり、どのドキュメントについても \f2package\-list\fP が存在していない場合は、最初のドキュメントに対して javadoc ツールを実行する時点で、2 番目のドキュメントの \f2package\-list\fP がまだ存在していません。したがって、外部リンクを作成するには、2 番目のドキュメントを生成したあとで、最初のドキュメントを生成し直す必要があります。
-.LP
-この場合、最初のドキュメント生成の目的は、そのドキュメントの \f2package\-list\fP を作成することです。 パッケージ名をすべて把握している場合は、package\-list を手動で作成することもできます。次に、2 番目のドキュメントとその外部リンクを生成します。必要な外部の \f2package\-list\fP ファイルが存在しない場合、Javadoc ツールは警告を表示します。
+\f2\-link\fP ץꤻ javadoc ¹Ԥ硢ȥ饹°̾Ĥȡjavadoc Ϥ̾ʤǽϤޤ \f2\-link\fP ץꤵ줿硢Javadoc ġϡ \f2ꤵ줿\fP \f2extdocURL\fP ξˤ package\-list եǡΥѥå̾ޤѥå̾Ĥȡ\f2extdocURL\fP ̾ղäޤ
+.LP
+٤ƤΥǽ뤿ˤϡȤΤ٤ƤΥɥȤꤷ URL ¸ߤƤʤФʤޤJavadoc ġϡꤵ줿 package\-list ¸ߤ뤫ɤĴ٤ǡꤵ줿 URL ŪΥڡ¸ߤ뤫ɤϥåޤ
+.LP
+\f3ʣΥ\fP \- ʣ \f2\-link\fP ץꤹȡǤդογɥȤؤΥǤޤJavadoc 1.2 ˤϡʣ \f2\-link\fP ޥɤǤʤȤХޤ 1.2.2 ǽޤ
+.LP
+볰ɥȤȤˡΤ褦̡Υץꤷޤ
+.LP
+\ \ \f2% \fP\f4javadoc \-link\fP \f2extdocURL1\fP \f4\-link\fP \f2extdocURL2\fP \f2... \fP\f4\-link\fP \f2extdocURLn\fP \f4com.mypackage\fP
+.LP
+\f2extdocURL1\fP\f2extdocURL2\fP... \f2extdocURLn\fP ϡ줾쳰ɥȤΥ롼Ȥؤƥ롼Ȥˤϡ \f2package\-list\fP Ȥ̾Υե뤬äƤޤ
+.LP
+\f3\fP \- ޤƤʤ 2 İʾΥɥȤϡ֥֡ȥȥåספɬפˤʤޤĤޤꡢɤΥɥȤˤĤƤ \f2package\-list\fP ¸ߤƤʤϡǽΥɥȤФ Javadoc ġ¹Ԥǡ2 ܤΥɥȤ \f2package\-list\fP Ϥޤ¸ߤƤޤäơˤϡ2 ܤΥɥȤȤǡǽΥɥȤľɬפޤ
+.LP
+ξ硢ǽΥɥŪϡ \f2package\-list\fP 뤳ȤǤѥå̾٤İƤϡpackage\-list ưǺƤ⤫ޤޤˡ2 ܤΥɥȤȤγޤɬפʳ \f2package\-list\fP ե뤬¸ߤʤϡJavadoc ġ뤫ٹ𤬽Ϥޤ
.LP
.TP 3
\-linkoffline\ extdocURL\ packagelistLoc
-このオプションは、\f2\-link\fP オプションを変えたものです。 どちらも、javadoc によって生成された外部参照クラスのドキュメントへのリンクを作成します。Javadoc ツール自体がオフラインになっているとき (Web 接続を使ってドキュメントにアクセスできないとき)、Web 上のドキュメントにリンクするには、\f2\-linkoffline\fP オプションを使用します。
-.LP
-厳密には、外部ドキュメントの \f2package\-list\fP ファイルにアクセスできないとき、またはこのファイルが \f2extdocURL\fP で指定された場所とは異なる場所 (通常、\f2packageListLoc\fP で指定可能なローカルな場所) に存在するとき、\f2\-linkoffline\fP を使用します。したがって、\f2extdocURL\fP に WWW 上でしかアクセスできない場合は、\f2\-linkoffline\fP を指定することにより、ドキュメントの生成時に javadoc ツールが Web に接続できなければならないという制約がなくなります。
-.LP
-さらに、ドキュメントを更新するための「ハッキング」としての使用も可能です。パッケージのセット全体に対して javadoc を実行したあと、変更した一部のパッケージだけに対して javadoc を実行します。 こうして、更新されたファイルを、オリジナルのファイルセットに挿入できるようにします。例をあとで示します。
-.LP
-\f2\-linkoffline\fP オプションは引数を 2 つ取ります。 最初の引数は \f2<a href>\fP リンクに組み込まれる文字列を指定する引数、2 番目の引数は \f2package\-list\fP の検索場所を指定する引数です。
+Υץ \f2\-link\fP ΥХꥨ 1 ĤǤɤ⡢ȥ饹 javadoc ɥȤؤΥޤJavadoc \f2ġ뼫Τ\fP ե饤ˤʤäƤȤ (Web ³ȤäƥɥȤ˥ǤʤȤ)Web ΥɥȤ˥ˤϡ\-linkoffline ץѤޤ
+.LP
+̩ˤϡ \f2\fP ɥȤ \f2package\-list\fP ե˥ǤʤȤޤϤΥե뤬 \f2extdocURL\fP ǻꤵ줿Ȥϰۤʤ (̾\f2packageListLoc\fP ǻǽʥʾ) ¸ߤȤ\-linkoffline ѤޤäơWWW ͳǤ \f2extdocURL\fP ˥Ǥʤ硢 \f2\-linkoffline\fP ꤹ뤳ȤˤꡢɥȤ Javadoc ġ뤬 Web ³ǤʤФʤʤȤʤʤޤ
+.LP
+ˡɥȤ뤿Ρ֥ϥåפȤƤλѤǽǤѥåΥåΤФ javadoc ¹ԤȡѹΥѥåФ javadoc ¹Ԥޤơ줿եꥸʥΥե륻åȤǤ褦ˤޤȤǼޤ
+.LP
+\f2\-linkoffline\fP ץϰ 2 ļޤ1 Ĥϡ \f2<a href>\fP Ȥ߹ޤʸɽ⤦ 1 Ĥ \f2package\-list\fP θǤ
.RS 3
.TP 2
o
-\f4extdocURL\fP は、リンク先として指定する、javadoc によって生成された外部ドキュメントを含むディレクトリの絶対 URL または相対 URL です。相対リンクを使用する場合、\f2\-d\fP を使って、生成先ディレクトリからリンクされるパッケージのルートの相対パスを指定する必要があります。詳細は、\f2\-link\fP オプションの \f2extdocURL\fP を参照してください。
+\f4extdocURL\fP ϡȤƻꤹ롢javadoc ˤä줿ɥȤޤǥ쥯ȥ URL ޤ URL ǤХξ硢ͤϡ( \f2\-d\fP ǻꤵ줿) ǥ쥯ȥ꤫ѥåΥ롼ȤؤХѥˤ٤Ǥܺ٤ϡ\-link ץ \f2extdocURL\fP \f2\fP Ƥ
.TP 2
o
-\f4packagelistLoc\fP には、外部ドキュメントの \f2package\-list\fP ファイルが入っているディレクトリのパスまたは URL を指定します。これは、URL (http: または file:)or file:)とファイルパスのどちらでもかまいません。また、絶対パスと相対パスのどちらでも指定できます。相対パスの場合は、javadoc が実行されるカレントディレクトリからの相対パスとして指定します。\f2package\-list\fP というファイル名は含めないでください。
+\f4packagelistLoc\fP ϡɥȤ \f2package\-list\fP եޤǥ쥯ȥؤΥѥޤ URL ǤϡURL (http: ޤ file:) ǤեѥǤ⤫ޤޤХѥǤХѥǤ⤫ޤޤХѥξϡjavadoc ¹Ԥ륫ȥǥ쥯ȥ꤫ХѥȤƻꤷޤե̾ \f2package\-list\fP ϴޤʤǤ
.RE
.LP
-javadoc の 1 回の実行で、複数の \f2\-linkoffline\fP オプションを指定できます。1.2.2 より前は、複数のオプションを指定することはできませんでした。
-.LP
-\f3外部ドキュメントへの絶対リンクを使った例\fP \- \f2http://java.sun.com/j2se/1.5.0/docs/api\fP 内の \f2java.lang\fP、\f2java.io\fP、、およびその他の Java 2 プラットフォームパッケージにリンクしたくても、Web にアクセスできない 場合について考えてみます。この場合は、ブラウザで
+1 javadoc ¹Ԥʣ \f2\-linkoffline\fP ץǤޤ1.2.2 ϡʣΥץꤹ뤳ȤϤǤޤǤ
+.LP
+\f3ɥȤؤХλ\fP \- http://java.sun.com/javase/6/docs/api \f2java.lang\fP \f2java.io\fP Ӥ¾ Java SE ץåȥեѥå \f2˥Ƥ\fP Web ˥Ǥʤͤޤ֥饦 \f2\fP
.na
-\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
+\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
.fi
-http://java.sun.com/j2se/1.5.0/docs/api/package\-list にある \f2package\-list\fP ファイルを開き、ローカルディレクトリに保存します。 さらに、2 番目の引数 \f2packagelistLoc\fP にこのローカルコピーの場所を指定します。この例では、パッケージリストファイルはカレントディレクトリ "\f2.\fP" に保存されています。次のコマンドは、Java 2 プラットフォーム API へのリンクを含む、\f2com.mypackage\fP パッケージのドキュメントを生成します。生成されたドキュメントには、たとえばクラスツリー内の \f2Object\fP クラスへのリンクが含まれています。\f2\-sourcepath\fP などの他の必要なオプションは表示されません。
+http://java.sun.com/javase/6/docs/api/package\-list ˤ package\-list եǥ쥯ȥ¸ 2 \f2packagelistLoc\fP ǤΥ륳ԡؤΥѥꤷޤǤϡѥåꥹȥեϥȥǥ쥯ȥ "\f2.\fP" ¸ƤޤΥޥɤϡJava SE ץåȥեѥåؤΥޤѥå \f2com.mypackage\fP ΥɥȤޤ줿ɥȤˤϡȤХ饹ĥ \f2Object\fP 饹ؤΥޤޤƤޤʤ \f2\-sourcepath\fP ʤɡ¾ɬץץϼƤޤ
.nf
\f3
.fl
-% \fP\f3javadoc \-linkoffline http://java.sun.com/j2se/1.5.0/docs/api . com.mypackage\fP
+% \fP\f3javadoc \-linkoffline http://java.sun.com/javase/6/docs/api . com.mypackage\fP
.fl
.fi
.LP
-\f3外部ドキュメントへの相対リンクの使用例\fP \- 通常、\f2\-linkoffline\fP に相対パスを指定することはありません。 \f2\-link\fP で同じことができるからです。\f2\-linkoffline\fP を使用する際、\f2package\-list\fP には通常ローカルのファイルを指定します。 相対リンクを使用する際も、リンク先のファイルには通常ローカルのファイルを指定します。したがって、\f2\-linkoffline\fP の 2 つの引数に別々のパスを指定する必要はありません。2 つの引数が同一である場合は、\f2\-link\fP を使用できます。\f2\-link\fP の相対リンクの例を参照してください。
-.LP
-\f4package\-list\fP\f3 ファイルを手動で作成\fP \- \f2package\-list\fP ファイルがまだ存在しなくても、ドキュメントのリンク先のパッケージ名がわかっている場合は、このファイルを自分で作成し、\f2packagelistLoc\fP でそのパスを指定することができます。\f2com.apipackage\fP が最初に生成され、\f2com.spipackage\fP のパッケージリストが存在しないという前出の例を参照してください。この方法は、パッケージ名はわかっているものの、まだ公開されていない、新しい外部ドキュメントにリンクするドキュメントを生成する必要がある場合に便利です。また、\f2package\-list\fP ファイルが生成されない Javadoc 1.0 や 1.1 などで生成されたパッケージ向けに \f2package\-list\fP ファイルを作成するときにも、この方法を利用します。同様に、2 つの会社が未公開の \f2package\-list\fP ファイルを共有することもできるため、クロスリンクを設定したドキュメントを同時にリリースすることも可能です。
-.LP
-\f3複数のドキュメントへのリンク\fP \- \f2\-linkoffline\fP は、参照先の生成ドキュメントごとに 1 つずつ指定します。 次の例では、わかりやすくするためにオプションごとに行を分けています。
+\f3ɥȤؤХλ\fP \- \f2\-linkoffline\fP ХѥѤ뤳Ȥϡޤꤢޤͳñǡ̾ \f2\-link\fP ǽʬǤ \f2\-linkoffline\fP Ѥݡ \f2package\-list\fP ˤ̾Υեꤷޤ ХѤݤ⡢Υեˤ̾Υեꤷޤäơ \f2\-linkoffline 2 Ĥΰ̡ΥѥꤹɬפϤޤ\fP2 ĤΰƱǤϡ \f2\-link\fP ѤǤޤ \f2\-link\fP ХȤƤ
+.LP
+\f4package\-list\fP\f3 եưǺ\fP \- \f2package\-list\fP ե뤬ޤ¸ߤʤƤ⡢ɥȤΥΥѥå̾狼äƤϡΥեʬǺpackagelistLoc \f2ǤΥѥꤹ뤳ȤǤޤ\fPcom.apipackage ǽ \f2com.spipackage\fP ΥѥåꥹȤ¸ߤƤʤäȤ \f2ФΥ\fP ȤƵޤˡϡѥå̾Ϥ狼äƤΤΡޤƤʤɥȤ˥ɥȤɬפǤޤJavadoc 1.0 ޤ 1.1 줿ѥå \f2package\-list\fP եɬפˤ⡢ˡȤޤΥСǤϡ \f2package\-list\fP եƤޤǤƱͤˡ2 ĤδȤ̤ \f2package\-list\fP եͭСޤɥȤƱ˥뤳ȤǽȤʤޤ
+.LP
+\f3ʣΥɥȤؤΥ\fP \- ȤʤɥȤȤ \f2\-linkoffline\fP 1 Ĵޤ뤳ȤǤޤ狼䤹뤿ˡץȤ˲ԤƼƤޤ
.LP
\f2% \fP\f4javadoc \-linkoffline\fP \f2extdocURL1\fP \f2packagelistLoc1\fP \f2\\\fP
.br
@@ -4873,24 +3379,24 @@
.br
\f2\ \ \ \ \ \ \ \ \ \ ...\fP
.LP
-\f3ドキュメントの更新\fP \- 前述の \f2\-linkoffline\fP オプションのもうひとつの用途は、プロジェクトに大量のパッケージが含まれていて、すでにツリー全体に対して javadoc の実行が完了している場合に、次の実行では、少量の変更を手早く加えたあと、ソースツリーのごく一部に対してだけ javadoc を再実行する場合に便利です。これは、ドキュメンテーションコメントに対してだけ変更を加え、宣言は変更しない場合にのみ正しく処理されるので、ハッキングのようなものです。ソースコードの宣言を追加、削除、または変更した場合は、索引、パッケージツリー、継承されるメンバーのリスト、[使用] ページなどの場所で、リンクが壊れることがあります。
-.LP
-まず、今回の実行で使用する新しい生成先ディレクトリ (\f2update\fP) を作成します。元の生成先ディレクトリの名前が \f2html\fP だとします。もっとも単純な例では、\f2html\fP ディレクトリの親ディレクトリに移動 (cd) します。\f2\-linkoffline\fP の最初の引数にカレントディレクトリ "." を指定し、2 番目の引数に \f2html\fP への相対パスを指定します。 ここで、\f2package\-list\fP が検索されます。 更新対照のパッケージのパッケージ名だけを指定してください。
+\f3ɥȤι\fP \- Ҥ \f2\-linkoffline\fP ץΤ⤦ҤȤĤӤϡץȤ̤ΥѥåޤޤƤơǤ˥ĥΤФ javadoc μ¹ԤλƤˡμ¹ԤǤϡ̤ѹäȡĥΤФƤ javadoc Ƽ¹ԤǤϡɥơȤФƤѹäѹʤˤΤΤǡϥåΤ褦ʤΤǤɤɲáޤѹϡѥåĥѾСΥꥹȡֻѡץڡʤɤξǡ뤳Ȥޤ
+.LP
+ޤοʼ¹ѤȤơǥ쥯ȥ ( \f2update\fP ̿̾) ޤǥ쥯ȥ̾ \f2html\fP äȤޤäȤñǤϡ \f2html ǥ쥯ȥοƥǥ쥯ȥ˰ư (cd) ޤ\fP \f2\-linkoffline\fP 1 ȥǥ쥯ȥ.פꤷ 2 package\-list ޤޤƤ \f2html\fP ؤХѥꤷ \f2ѥåΥѥå̾Τߤ\fPϤޤ
.nf
\f3
.fl
% \fP\f3javadoc \-d update \-linkoffline . html com.mypackage\fP
.fl
.fi
-Javadoc ツールの終了後、\f2update/com/package\fP 内の生成されたクラスのページをコピーし (概要や索引を除く)、\f2html/com/package\fP 内の元のファイルに上書きします。
+Javadoc ĥνλ塢 \f2update/com/package\fP 줿饹Υڡԡ (פϽ) \f2html/com/package θΥե˾ޤ\fP
.LP
.TP 3
\-linksource\
-各ソースファイル (行番号付き) の HTML バージョンを作成し、標準 HTML ドキュメントからソースファイルへのリンクを追加します。リンクは、ソースファイル内に宣言されているクラス、インタフェース、コンストラクタ、メソッド、フィールドに対して作成されます。デフォルトコンストラクタ、生成されたクラスに対しては作成されません。
-.LP
-\f3このオプションは、\fP\f4\-public\fP\f3、\fP\f4\-package\fP\f3、\fP\f4\-protected\fP\f3、\fP\f4\-private\fP\f3 の各オプションとは関係なく、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソースファイル内のすべての非公開実装の詳細を公開します。\fP\f2\-private\fP オプションを指定しないかぎり、非公開のクラスやインタフェースの一部には、リンクを介してアクセスできないことがあります。
-.LP
-各リンクは、その宣言内の識別子名の上に作成されます。たとえば、\f2Button\fP クラスのソースコードヘのリンクは、「Button」という語の上に作成されます。
+ƥե (ֹդ) HTML Сɸ HTML ɥȤ饽եؤΥɲäޤϡեƤ륯饹եȥ饯åɡեɤФƺޤǥեȥȥ饯줿饹ФƤϺޤ
+.LP
+\f3Υץϡ\fP\f4\-public\fP\f3 \fP\f4\-package\fP\f3 \fP\f4\-protected\fP\f3 \fP\f4\-private\fP\f3 γƥץȤϴطʤΥ饹եɡΥåɤΤϤȤȤ߹ޤ줿եΤ٤Ƥξܺ٤ޤ\fP\f2\-private\fP ץʻƻꤷʤꡢΤ٤ƤΥ饹䥤ե˥ͳǥǤȤϤޤ
+.LP
+ƥϡμ̻̾ξ˺ޤȤС \f2Button\fP 饹ΥɤؤΥϡButtonפȤξ˺ޤ
.nf
\f3
.fl
@@ -4902,7 +3408,7 @@
.fl
\fP
.fi
-Button クラスの \f2getLabel()\fP メソッドのソースコードへのリンクは、「getLabel」という語の上に作成されます。
+ޤButton 饹 \f2getLabel()\fP åɤΥɤؤΥϡgetLabelפȤξ˺ޤ
.nf
\f3
.fl
@@ -4913,26 +3419,21 @@
.LP
.TP 3
\-group\ groupheading\ packagepattern:packagepattern:...
-概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の \f2\-group\fP オプションで指定します。これらのグループは、コマンド行で指定した順序でページに表示されます。 各グループ内では、パッケージがアルファベット順に並べられます。指定した \f2\-group\fP オプションごとに、\f2packagepattern\fP 式のリストと一致するパッケージが、見出し \f2groupheading\fP を持つ 1 つの表にまとめて表示されます。
+ץڡʣΥѥåꤷ롼פʬơ롼פȤɽޤƥ롼פϡ줾̤ \f2\-group\fP ץǻꤷޤΥ롼פϡޥɹԤǻꤷǥڡɽޤƥ롼Ǥϡѥåե٥åȽ¤٤ޤ \f2\-group\fP ץǤϡ \f2packagepattern\fP ΥꥹȤ˰פѥå \f2groupheading\fP ȤФɽɽޤ
.RS 3
.TP 2
o
-\f4groupheading\fP には、任意のテキストを指定でき、空白を含めることができます。指定したテキストは、グループの表見出しになります。
+\f4groupheading\fP ˤϡǤդΥƥȤǤޤ뤳ȤǤޤꤷƥȤϡ롼פɽФˤʤޤ
.TP 2
o
-\f4packagepattern\fP には、任意のパッケージ名、または任意のパッケージ名の先頭部分とそれに続く 1 つのアスタリスク (\f2*\fP) を指定できます。アスタリスクは、「任意の文字に一致する」という意味のワイルドカードです。ワイルドカードとして指定できるのは、アスタリスクだけです。1 つのグループには、コロン (\f2:\fP) で区切って複数のパターンを含めることができます。
+\f4packagepattern\fP ˤϡǤդΥѥå̾ޤǤդΥѥå̾ƬʬȤ³ 1 ĤΥꥹ (\f2*\fP) Ǥޤ ꥹϡǤդʸ˰פפȤ̣Υ磻ɥɤǤ磻ɥɤȤƻǤΤϡꥹǤ1 ĤΥ롼פˤϡ (\f2:\fP) ǶڤäʣΥѥޤ뤳ȤǤޤ
.RE
-.RS 3
-
-.LP
-.LP
-\f3注: パターンやパターンリスト内でアスタリスクを使う場合は、\fP\f4"java.lang*:java.util"\fP\f3 のように、パターンリストを引用符で囲む必要があります。\fP
-.LP
-.RE
-.LP
-\f2\-group\fP オプションが指定されていない場合は、すべてのパッケージが、「パッケージ」という見出しの 1 つのグループに入れられます。ドキュメント化されるパッケージの中に、指定したグループのどのグループにも入らないパッケージがある場合、このようなパッケージは「その他のパッケージ」という見出しを持つ独立したグループに入れられます。
-.LP
-たとえば、次のようにオプションを指定すると、ドキュメント化される 5 つのパッケージは、コアパッケージ、拡張機能パッケージ、およびその他のパッケージに分けられます。「java.lang*」では、最後のドットを指定していないことに注目してください。 「java.lang.*」のようにドットを入れると、java.lang パッケージは除外されることになります。
+.LP
+\f3: ѥѥꥹǥꥹȤϡ \fP\f4"java.lang*:java.util" Τ褦ˡѥꥹȤǰϤɬפޤ\fP
+.LP
+桼 \f2\-group\fP ץ 1 Ĥꤷʤä硢֥ѥåפȤФ 1 ĤΥ롼ˡ٤ƤΥѥå֤ޤɥȲѥåˡꤷ롼פΤɤΥ롼פˤʤѥå硢Τ褦ʥѥåϡ֤¾ΥѥåפȤФΩ롼פޤ
+.LP
+ȤСΤ褦˥ץꤹȡɥȲ 5 ĤΥѥåϡѥåĥǽѥåӤ¾Υѥåʬޤjava.lang*פǤϡǸΥɥåȤꤷƤʤȤܤƤjava.lang.*פΤ褦˥ɥåȤȡjava.lang ѥåϽ뤳Ȥˤʤޤ
.nf
\f3
.fl
@@ -4943,56 +3444,52 @@
java.lang java.lang.reflect java.util javax.servlet java.new\fP
.fl
.fi
-この結果、次のようなグループ化が行われます。
-.RS 3
+η̡Τ褦ʥ롼ײԤޤ
.RS 3
.TP 3
-コアパッケージ
+ѥå
\f2java.lang\fP
\f2java.lang.reflect\fP
\f2java.util\fP
.TP 3
-拡張機能パッケージ
+ĥǽѥå
\f2javax.servlet\fP
.TP 3
-その他のパッケージ
+¾Υѥå
\f2java.new\fP
.RE
-
-.LP
-.RE
.LP
.TP 3
\-nodeprecated
-推奨されない API をドキュメントに生成しないようにします。このオプションを指定すると、\-nodeprecatedlist オプションを指定した場合と同じ効果があることに加えて、ドキュメントのほかの部分全体でも、推奨されない API が生成されません。このオプションは、コードを記述しているとき、推奨されないコードによって気を散らされたくない場合に便利です。
+侩ʤ API ɥȤʤ褦ˤޤΥץꤹȡ\-nodeprecatedlist ץꤷƱ̤뤳Ȥ˲äơɥȤΤۤʬΤǤ⡢侩ʤ API ޤΥץϡɤҤƤȤ侩ʤɤˤäƵ餵줿ʤǤ
.LP
.TP 3
\-nodeprecatedlist
-推奨されない API のリストを含むファイル (deprecated\-list.html)、およびナビゲーションバーのそのページへのリンクが生成されないようにします。ただし、ドキュメントのほかの部分では、推奨されない API が生成されます。このオプションは、推奨されない API がソースコードに含まれておらず、ナビゲーションバーをすっきりと見せたい場合に便利です。
+侩ʤ API ΥꥹȤޤե (deprecated\-list.html)ӥʥӥСΤΥڡؤΥʤ褦ˤޤɥȤΤۤʬǤϡ侩ʤ API ޤΥץϡ侩ʤ API ɤ˴ޤޤƤ餺ʥӥСäȸǤ
.LP
.TP 3
\-nosince
-生成ドキュメントから、@since タグに対応する「導入されたバージョン」 セクションを省略します。
+ɥȤ顢@since бƳ줿С άޤ
.LP
.TP 3
\-notree
-生成されるドキュメントからクラスおよびインタフェースの階層ページを省略します。これらのページには、ナビゲーションバーの「ツリー」ボタンからアクセスできます。デフォルトでは、階層が生成されます。
+ɥȤ饯饹ӥեγإڡάޤΥڡˤϡʥӥСΡ֥ĥץܥ饢ǤޤǥեȤǤϡؤޤ
.LP
.TP 3
\-noindex
-生成ドキュメントから、索引を省略します。デフォルトでは、索引が生成されます。
+ɥȤ顢άޤǥեȤǤϡޤ
.LP
.TP 3
\-nohelp
-出力の各ページの最上部と最下部にあるナビゲーションバーから [ヘルプ] リンクを省略します。
+ϤγƥڡκǾȺDzˤʥӥС֥إסץάޤ
.LP
.TP 3
\-nonavbar
-生成されるページの最上部と最下部に表示されるナビゲーションバー、ヘッダー、およびフッターを生成しないようにします。このオプションは、bottom オプションには影響を与えません。\f2\-nonavbar\fP オプションは、印刷するためだけにファイルを PostScript または PDF に変換する場合など、内容だけが重要で、ナビゲーションの必要がない場合に便利です。
+ڡκǾȺDzɽʥӥСإåӥեåʤ褦ˤޤΥץϡbottom ץˤϱƶͿޤ \f2\-nonavbar\fP ץϡ뤿˥ե PostScript ޤ PDF ѴʤɡƤפǡʥӥɬפʤǤ
.LP
.TP 3
\-helpfile\ path/filename
-上部と下部のナビゲーションバーの [ヘルプ] リンクのリンク先となる代替ヘルプファイル \f2path/filename\fP のパスを指定します。このオプションが指定されていない場合、Javadoc ツールは、ハードコードされているヘルプファイル \f2help\-doc.html\fP を自動的に作成します。このオプションを使うと、そのデフォルトの動作をオーバーライドできます。\f2filename\fP にはどんなファイル名でも指定でき、\f2help\-doc.html\fP には限定されません。例を示します。
+ȲΥʥӥСΡ֥إסץΥȤʤإإץե \f2path/filename\fP ΥѥꤷޤΥץꤵʤȡJavadoc ġϡġǥϡɥɤƤإץե \f2help\-doc.html\fP ưޤΥץȤȡΥǥեȤưС饤ɤǤޤ\f2filename\fP ˤϤɤʥե̾ǤǤ \f2help\-doc.html ˤϸꤵޤ\fP Javadoc ġϡʥӥСΥɬפ˱Ĵޤޤ
.nf
\f3
.fl
@@ -5001,7 +3498,7 @@
.fi
.TP 3
\-stylesheetfile\ path/filename
-代替 HTML スタイルシートファイルのパスを指定します。このオプションが指定されていない場合、Javadoc ツールは、ハードコードされているスタイルシートファイル \f2stylesheet.css\fP を自動的に作成します。このオプションを使うと、そのデフォルトの動作をオーバーライドできます。\f2filename\fP にはどんなファイル名でも指定でき、\f2stylesheet.css\fP には限定されません。例を示します。
+ HTML 륷ȥեΥѥꤷޤΥץꤵʤȡJavadoc ġϡġǥϡɥɤƤ륹륷ȥե \f2stylesheet.css\fP ưޤΥץȤȡΥǥեȤưС饤ɤǤޤ\f2filename\fP ˤϤɤʥե̾ǤǤ \f2stylesheet.css ˤϸꤵޤ\fPȤС
.nf
\f3
.fl
@@ -5010,22 +3507,22 @@
.fi
.TP 3
\-serialwarn
-@serial タグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1.2.2 以降のバージョンでは、直列化の警告は生成されません。1.2.2 より前の初期バージョンでは、警告が生成されます。このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと \f2writeExternal\fP メソッドを適切にドキュメント化するのに役立ちます。
+@serial ʤϡѥ˷ٹޤǥեȤǤϡJavadoc 1.2.2 ʹߤΥСǤϡľηٹޤ1.2.2 νСǤϡٹޤΥץѤȡľηٹɽΤǡǥեȤľǽեɤ \f2writeExternal\fP åɤŬڤ˥ɥȲΤΩޤ
.LP
.TP 3
\-charset\ name
-このドキュメント用の HTML 文字セットを指定します。この名前は、
+ΥɥѤ HTML ʸåȤꤷޤ̾ϡ
.na
\f2IANA Registry\fP @
.fi
-http://www.iana.org/assignments/character\-sets で与えられた、推奨される MIME 名でなければなりません。例を示します。
+http://www.iana.org/assignments/character\-sets Ϳ줿侩 MIME ̾ǤʤФʤޤȤС
.nf
\f3
.fl
% \fP\f3javadoc \-charset "iso\-8859\-1" mypackage\fP
.fl
.fi
-生成されるすべてのページの先頭に、次の行が挿入されます。
+뤹٤ƤΥڡƬˡιԤޤ
.nf
\f3
.fl
@@ -5033,34 +3530,34 @@
.fl
\fP
.fi
-この META タグについては、
+ META ˤĤƤϡ
.na
-\f2HTML の標準\fP @
+\f2HTML ɸ\fP @
.fi
-http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2 (4197265 および 4137321) を参照してください。
-.LP
-\-encoding および \-docencoding も参照してください。
+http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2 (4197265 4137321) ȤƤ
+.LP
+\-encoding \-docencoding ⻲ȤƤ
.LP
.TP 3
\-docencoding\ name
-生成される HTML ファイルのエンコーディングを指定します。この名前は、
+ HTML եΥǥꤷޤ̾ϡ
.na
\f2IANA Registry\fP @
.fi
-http://www.iana.org/assignments/character\-sets で与えられた、推奨される MIME 名でなければなりません。このオプションを省略しながら \-encoding を使用した場合、生成される HTML ファイルのエンコードは、\-encoding によって決められます。例:
+http://www.iana.org/assignments/character\-sets Ϳ줿侩 MIME ̾ǤʤФʤޤΥץάʤ \-encoding Ѥ硢 HTML եΥɤϡ\-encoding ˤäƷޤ:
.nf
\f3
.fl
% \fP\f3javadoc \-docencoding "ISO\-8859\-1" mypackage\fP
.fl
.fi
-\-encoding および \-charset も参照してください。
+\-encoding \-charset ⻲ȤƤ
.LP
.TP 3
\-keywords
-HTML メタキーワードタグを、クラスごとに生成されるファイルに追加します。これらのタグは、メタタグを検索するサーチエンジンがページを見つける場合に役立ちます。インターネット全体を検索する多くのサーチエンジンは、ページがメタタグを誤用しているため、メタタグを調べません。 一方、検索を自身の Web サイトに限定している企業では、サーチエンジンがメタタグを調べることによってメリットを得られます。
-.LP
-メタタグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス String は次のキーワードで開始します。
+HTML ɥ饹ȤեɲäޤΥϡ륵ڡĤΩޤͥåΤ¿ΥϡڡѤƤ뤿ᡢĴ٤ޤȤ Web Ȥ˸ꤷƤȤǤϡĴ٤뤳ȤˤäƥåȤޤ
+.LP
+ˤϡ饹δ̾ȡեɤӥåɤνƤʤ̾ޤޤޤȥ饯ϡ饹̾ƱǤ뤿ޤޤޤȤС饹 String ϼΥɤdzϤޤ
.nf
\f3
.fl
@@ -5077,29 +3574,29 @@
.LP
.TP 3
\-tag\ \ tagname:Xaoptcmf:"taghead"
-Javadoc ツールがドキュメンテーションコメント内の引数を 1 つ取る単純なカスタムブロックタグ \f2@\fP\f2tagname\fP を解釈できるようにします。これにより、Javadoc ツールはタグ名の「スペルチェック」を行うことができるので、ソースコード内のすべてのカスタムタグに \f2\-tag\fP オプションを組み込むことをお勧めします。今回の実行で出力されないタグは、\f2X\fP を付けて無効にします。
-.LP
-コロン (\f4:\fP) は常に区切り文字になります。\f2tagname\fP でコロンを使用するには、「タグ名でのコロンの使用」を参照してください。
-.LP
-\f2\-tag\fP オプションは、タグの見出し「taghead」を太字で出力します。 その次の行には、このオプションの引数で指定したテキストが続きます。 以下の例を参照してください。ブロックタグと同様、この引数のテキストにはインラインタグを含めることができます。 このインラインタグも解釈されます。出力は、引数を 1 つ取る標準のタグ (\f2@return\fP、\f2@author\fP など) の出力とよく似ています。\f2taghead\fP を省略すると、\f2tagname\fP が見出しとして表示されます。
-.LP
-\f3タグの配置\fP \- 引数の \f4Xaoptcmf\fP 部分は、ソースコード内のタグを配置できる位置と、\f2X\fP を使ってこのタグを無効にできるかどうかを特定します。タグの配置位置を制限しない場合は \f4a\fP を指定します。 それ以外の文字の組み合わせも可能です。 \f4X\fP (タグの無効化)
+Javadoc ġ뤬ɥơΰ 1 ļñʥ֥å \f2@\fP\f2tagname\fP Ǥ褦ˤޤJavadoc ġϥ̾Ρ֥ڥåפԤȤǤΤǡ¸ߤ뤹٤ƤΥॿˤĤơ \f2\-tag\fP ץޤ뤳ȤפǤμ¹ԤǤϽϤʤϡX դ̵ \f2ˤޤ\fP
+.LP
+ (\f4:\fP) ˶ڤʸˤʤޤtagname \f2ǥѤˡˤĤƤϡ\fP ֥̾ǤΥλѡפȤƤ
+.LP
+\f2\-tag\fP ץϡθФtagheadפǽϤޤ μιԤˤϡΥץΰǻꤷƥȤ³ޤ ʲȤƤ֥åƱ͡ΰΥƥȤˤϥ饤ޤ뤳ȤǤޤΥ饤ᤵޤϤϡ 1 ļɸΥ ( \f2@return\fP \f2@author\fP ʤ) νϤȤ褯Ƥޤ\f2taghead\fP άȡ\f2tagname\fP ФȤɽޤ
+.LP
+\f3\fP \- \f4Xaoptcmf\fP ʬϡΥ֤Ǥ֤ȡ ȤäƤΥ̵ˤǤ뤫ɤꤷޤ \f2X\fP). ְ֤¤ʤ \f4a\fP ꤷޤʳʸȤ߹碌ǽǤ \f4X\fP (̵)
.br
-\f4a\fP (すべての位置)
+\f4a\fP (٤)
.br
-\f4o\fP (概要)
+\f4o\fP ()
.br
-\f4p\fP (パッケージ)
+\f4p\fP (ѥå)
.br
-\f4t\fP (型すなわちクラスおよびインタフェース)
+\f4t\fP (Ĥޤꥯ饹ȥե)
.br
-\f4c\fP (コンストラクタ)
+\f4c\fP (ȥ饯)
.br
-\f4m\fP (メソッド)
+\f4m\fP (å)
.br
-\f4f\fP (フィールド)
-.LP
-\f3シングルタグの例\fP \- ソースコード内の任意の位置で使用で気るタグのタグオプションの例を示します。
+\f4f\fP (ե)
+.LP
+\f3륿\fP \- Ǥդΰ֤ǻѤǤ륿Υץޤ
.nf
\f3
.fl
@@ -5107,7 +3604,7 @@
.fl
\fP
.fi
-@todo をコンストラクタ、メソッド、フィールドのみで使用する場合は、以下のオプションを使用します。
+@todo ȥ饯åɡեɤΤߤǻѤϡʲΥץѤޤ
.nf
\f3
.fl
@@ -5115,7 +3612,7 @@
.fl
\fP
.fi
-上の例の最後のコロン (\f2:\fP) は、パラメータ区切り子ですが、見出しテキストの一部になっています (以下の例を参照)。次の例のように、\f2@todo\fP タグを含むソースコードでは、いずれかのタグオプションを使用します。
+κǸΥ (\f2:\fP) ϡѥڤҤǤФƥȤΰˤʤäƤޤ (ʲ)Τ褦ˡ \f2@todo\fP ޤॽɤǤϡ줫ΥץѤޤ
.nf
\f3
.fl
@@ -5123,7 +3620,7 @@
.fl
\fP
.fi
-\f3タグ名にコロンを使用する\fP \- コロン (:) をバックスラッシュでエスケープすると、コロンをタグ名に使用することができます。このドキュメンテーションコメントの中では、次のように使用します。
+\f3̾˥Ѥ\fP \- (:) Хååǥפȡ̾˻Ѥ뤳ȤǤޤΥɥơȤǤϡΤ褦˻Ѥޤ
.nf
\f3
.fl
@@ -5135,7 +3632,7 @@
.fl
\fP
.fi
-でこのタグオプションを使用すると、
+ǤΥץѤȡ
.nf
\f3
.fl
@@ -5143,9 +3640,9 @@
.fl
\fP
.fi
-\f3タグ名のスペルチェック (タグの無効化)\fP \- ソースコード内に配置した一部のカスタムタグの出力を抑制したい場合があります。この場合も、ソースコード内にすべてのタグを配置し、出力を抑制しないタグを有効にし、出力を抑制するタグを無効にします。タグを無効にするには、\f2X\fP を指定します。指定しないと、そのタグは有効になります。 これにより、Javadoc ツールは、検出したタグが入力ミスなどによる未知のタグであるかどうかを特定できます。未知のタグを検出した場合、Javadoc ツールは警告を出力します。
-.LP
-すでに配置されている値に \f2X\fP を追加できます。 こうしておけば、\f2X\fP を削除するだけでタグを有効にすることができます。たとえば、@todo タグの出力を抑制したい場合、次のように指定します。
+\f3̾Υڥå (̵)\fP \- ֤ΥॿνϤ礬ޤξ⡢ˤ٤ƤΥ֤ϤʤͭˤϤ륿̵ˤޤ \f2X\fP ¸ߤϥ̵ˤʤꡢ¸ߤʤϥͭˤʤޤˤꡢJavadoc ġϡФϥߥʤɤˤ̤ΤΥǤ뤫ɤǤޤ̤ΤΥФ硢Javadoc ġϷٹϤޤ
+.LP
+Ǥ֤Ƥͤ \f2X\fP ɲäǤޤƤС \f2X ǥͭˤ뤳ȤǤޤ\fPȤС@todo νϤ硢Τ褦˻ꤷޤ
.nf
\f3
.fl
@@ -5153,7 +3650,7 @@
.fl
\fP
.fi
-さらに単純な指定方法もあります。
+ñʻˡ⤢ޤ
.nf
\f3
.fl
@@ -5162,13 +3659,13 @@
\fP
.fi
.LP
-構文 \f2\-tag todo:X\fP は、\f2@todo\fP が taglet で定義されている場合も有効です。
-.LP
-\f3タグの順序\fP \- \f2\-tag\fP (および \f2\-taglet\fP) オプションの順序によって、その出力順序が決定します。カスタムタグと標準タグを組み合わせて使用することもできます。標準タグのタグオプションは、順序を決定するためだけのプレースホルダです。これらは標準タグ名のみを使用します。(標準タグの小見出しは変更できません。)これについては、以下の例で説明します。
-.LP
-\f2\-tag\fP がない場合、\f2\-taglet\fP の位置によってその順序が決定します。タグが両方とも存在する場合、コマンド行の最後にあるほうがその順序を決定します。これは、タグやタグレットがコマンド行に指定された順番に処理されるためです。たとえば、\f2\-taglet\fP と \f2\-tag\fP の両方が todo という名前を持っている場合、コマンド行の最後にあるほうが順序を決定します。
-.LP
-\f3タグの完全セットの例\fP \- この例では、出力の「Parameters」と「Throws」の間に「To Do」を挿入します。X を使用して、@example が、ソースコード内の今回の実行では出力されないタグであることを指定します。@argfile を使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます。 行の継続を示す文字は不要です。
+ʸ \f2\-tag todo:X\fP ϡ \f2@todo\fP åȤƤƤͭǤ
+.LP
+\f3ν\fP \- \f2\-tag\fP ( \f2\-taglet\fP) ץνˤäơνϽ礬ޤޤॿɸॿȤ߹碌ƻѤ뤳ȤǤޤɸॿΥץϡꤹ뤿Υץ졼ۥǤɸॿ̾ΤߤѤޤ(ɸॿξФѹǤޤ)ˤĤƤϡʲޤ
+.LP
+\f2\-tag\fP ¸ߤʤϡ \f2\-taglet\fP ΰ֤ˤäƤνޤޤξȤ¸ߤ硢ޥɹԤκǸˤۤνꤷޤϡ䥿åȤޥɹԤ˻ꤵ줿֤˽뤿ǤȤС \f2\-taglet\fP \f2\-tag\fP ξ todo Ȥ̾äƤ硢ޥɹԤκǸˤۤꤷޤ
+.LP
+\f3δåȤ\fP \- ǤϡϤΡParametersפȡThrowsפδ֤ˡTo DoפޤX Ѥơ@example κμ¹ԤǤϽϤʤǤ뤳Ȥꤷޤ@argfile ѤϡΤ褦ˡե̡ιԤ˥֤ǤޤԤη³ʸפǤ
.nf
\f3
.fl
@@ -5187,37 +3684,37 @@
\fP
.fi
.LP
-javadoc がドキュメンテーションコメントを解析する際に検出されたタグのうち、標準タグでも \f2\-tag\fP や \f2\-taglet\fP で渡されるタグでもないものは、未知のタグの見なされます。 この場合、警告がスローされます。
-.LP
-標準タグは、最初、デフォルトの順序でリスト内に内部的に格納されます。\f2\-tag\fP オプションを使用すると、このリストに追加されるタグ、すなわち標準タグの位置がデフォルトの位置から移動します。つまり、標準タグに \f2\-tag\fP オプションを付けなければ、これらはデフォルトの位置に配置されたままになります。
-.LP
-\f3競合の回避\fP \- 固有の名前空間を分割するには、パッケージに使用されている \f2com.mycompany.todo\fP のように、ドット (.) 区切りの命名規則を使用します。Sun は、今後も名前にドットを含まない標準タグを作成します。ユーザーが作成したタグは、Sun が提供する同じ名前のタグの動作をオーバーライドします。つまり、ユーザーが \f2@todo\fP という名前のタグまたはタグレットを作成している場合、Sun があとから同じ名前の標準タグを作成しても、そのタグまたはタグレットは元の動作を保持します。
-.LP
-\f3注釈 vs. Javadoc タグ\fP \- 一般に、追加する必要のあるマークアップが、ドキュメンテーションに影響を与えたりドキュメンテーションを生成したりするためのものである場合、そのマークアップは javadoc タグにすべきです。 それ以外の場合は注釈にすべきです。
+javadoc ɥơȤϤݤ˸줿ΤɸॿǤ⡢ \f2\-tag\fP \f2\-taglet\fP Ϥ줿ǤʤΤϤ٤̤ΤΥȤߤʤ졢ٹ𤬥ޤ
+.LP
+ɸॿϡǽ顢ǥեȤνǥꥹŪ˳Ǽޤ \f2\-tag\fP ץѤȡΥꥹȤɲä륿ʤɸॿΰ֤ǥեȤΰ֤ưޤĤޤꡢɸॿ \f2\-tag\fP ץդʤСϥǥեȤΰ֤֤줿ޤޤˤʤޤ
+.LP
+\f3β\fP \- ֤ͭ̾٤ʬˤϡѥå˻ѤƤ \f2com.mycompany.todo Ȥ̾Τ褦ˡɥå (.) ڤ국Ȥ̾Ȥޤ\fPOracle ϡ̾˥ɥåȤޤޤʤɸॿޤ桼ϡOracle Ʊ̾ΥưС饤ɤޤĤޤꡢ \f2@todo\fP Ȥ̾ΥޤϥåȤ桼硢Oracle θƱ̾ɸॿȤƤ⡢ưϾ˥桼ưƱˤʤޤ
+.LP
+\f3 vs. Javadoc \fP \- ̤ˡɲäɬפΤޡåפɥơ˱ƶͿɥơꤹ뤿ΤΤǤ硢Υޡåפ javadoc ˤ٤Ǥʳξˤ٤Ǥ
.na
-\f2「Comparing Annotations and Javadoc Tags」\fP @
+\f2Comparing Annotations and Javadoc Tags\fP @
.fi
-http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#annotationsを参照してください。
-.LP
-\-taglet オプションを使用して、より複雑なブロックタグやカスタムインラインタグを 作成することができます。
+http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#annotationsȤƤ
+.LP
+\-taglet ץѤơʣʥ֥å䥫।饤 뤳ȤǤޤ
.LP
.TP 3
\-taglet\ \ class
-そのタグのドキュメントの生成に使うドックレットを起動するためのクラスファイルを指定します。クラスの完全指定名を指定してください。このタグレットは、カスタムタグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。外部ドキュメントとサンプルタグレットについては、以下を参照してください。
+ΥΥɥȤ˻ȤɥååȤư뤿Υ饹եꤷޤ饹δ̾ꤷƤΥåȤϡॿΥƥȰοޤåȤϡΰդϤޤɥȤȥץ륿åȤˤĤƤϡʲȤƤ
.RS 3
.TP 2
o
.na
-\f2「タグレットの概要」\fP @
+\f2֥åȤγס\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/taglet/overview.html
.RE
.LP
-タグレットは、標準タグまたはインラインタグで便利です。タグレットは任意の数の引数をとることができます。 また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。
-.LP
-タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。
-.LP
-タグレットのパスを指定するには、\f2\-tagletpath\fP オプションを使用します。以下は、生成されるページの「Parameter」と「Throws」の間に「To Do」タグレットを挿入する例です。
+åȤϡ֥åޤϥ饤ǤåȤǤդοΰȤ뤳ȤǤޤޤƥȤˤ롢վ롢ƥȤե˽Ф¾ΥץϤʤɤΥưǤޤ
+.LP
+åȤǻǤΤϡ־ַΤߤǤ¾Τ٤ƤηϡɥååȤˤäƹԤޤåȤѤƤ⡢ޥ饹ΥꥹȤ饯饹̾ʤɤνϼ¹ԤǤޤΥƥȤե˽Ϥꡢ̤ΥץȥꥬʤɤѤޤ
+.LP
+åȤΥѥꤹˤϡ\f2\-tagletpath\fP ץѤޤʲϡڡΡParameterפȡThrowsפδ֤ˡTo DoץåȤǤ
.nf
\f3
.fl
@@ -5238,25 +3735,25 @@
\fP
.fi
.LP
-\f2\-tag\fP オプションの代わりに \f2\-taglet\fP オプションを使用することもできますが、読みやすさを考慮するなら、\f2\-tag\fP オプションを使用したほうがよいでしょう。
+ޤ \f2\-taglet\fP ץ \f2\-tag\fP ץ˻Ѥ뤳ȤǤޤȲ㲼ǽޤ
.LP
.TP 3
\-tagletpath\ \ tagletpathlist
-taglet クラスファイル (.class) の検索パスを指定します。\f2tagletpathlist\fP には、コロン (\f2:\fP) で区切って複数のパスを含めることができます。Javadoc ツールは、指定されたパスの以下すべてのサブディレクトリを検索します。
+taglet 饹ե (.class) θѥꤷޤ\f2tagletpathlist\fP ˤϡ (\f2:\fP) ǶڤäʣΥѥޤ뤳ȤǤޤJavadoc ġϡꤵ줿ѥʲΤ٤ƤΥ֥ǥ쥯ȥޤ
.LP
.TP 3
\-docfilessubdirs\
-\f2doc\-files\fP ディレクトリの深いコピーを有効にします。つまり、コピー先には、サブディレクトリとすべてのコンテンツがコピーされます。たとえば、\f2doc\-files/example/images\fP ディレクトリとその中のファイルがコピーされます。ここでも、サブディレクトリを除外する指定が可能です。
+\f2doc\-files\fPץǥ쥯ȥοԡͭˤޤĤޤꡢԡˤϡ֥ǥ쥯ȥȤ٤ƤΥƥĤԡޤȤСǥ쥯ȥ \f2doc\-files/example/images\fP ȤΤ٤ƤƤԡޤǤ⡢֥ǥ쥯ȥ꤬ǽǤ
.LP
.TP 3
\-excludedocfilessubdir\ \ name1:name2...
-所定の名前の \f2doc\-files\fP サブディレクトリを除外します。これにより、SCCS とその他のソースコード制御サブディレクトリのコピーを防ぎます。
+\f2doc\-files\fPפΡꤵ줿̾Υ֥ǥ쥯ȥ٤ƽޤˤꡢSCCS Ȥ¾Υ極֥ǥ쥯ȥΥԡɤޤ
.LP
.TP 3
\-noqualifier\ \ all\ | \ packagename1:packagename2:...
-出力されるクラス名の先頭のパッケージ名 (パッケージ修飾子) を省略します。\f2\-noqualifier\fP の引数として \f2all\fP を指定した場合、すべてのパッケージ修飾子がすべて省略されます。 削除する複数のパッケージ名をコロンで区切って、ワイルドカードとともに指定することもできます。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。
-.LP
-次の例では、すべてのパッケージ修飾子を省略します。
+Ϥ륯饹̾ƬΥѥå̾ (ѥå) άޤ \f2\-noqualifier\fP ΰϡ\f2all\fP(٤ƤΥѥåҤά)ҤȤƺ٤ѥåΥڤꥹ (磻ɥɤ)Τ줫Ȥʤޤ饹ޤϥե̾ɽ֤ѥå̾ޤ
+.LP
+Ǥϡ٤ƤΥѥåҤάޤ
.nf
\f3
.fl
@@ -5264,7 +3761,7 @@
.fl
\fP
.fi
-次の例では、パッケージ修飾子 java.lang および java.io を省略します。
+Ǥϡѥå java.lang java.io άޤ
.nf
\f3
.fl
@@ -5272,7 +3769,7 @@
.fl
\fP
.fi
-次の例では、java で始まるパッケージ修飾子と com.sun というサブパッケージ (javax ではない) を省略します。
+Ǥϡjava ǻϤޤѥåҤ com.sun Ȥ֥ѥå (javax ǤϤʤ) άޤ
.nf
\f3
.fl
@@ -5280,63 +3777,54 @@
.fl
\fP
.fi
-パッケージ修飾子が上記の動作に従って表示される場合、名前は適切に短くされます。 詳細は「名前の表示方法」を参照してください。この規則は、\f2\-noqualifier\fP を使用したかどうかにかかわらず有効です。
+ѥåҤ嵭ư˽äɽ硢̾Ŭڤûޤܺ٤ϡ̾ɽˡפȤƤε§ϡ \f2\-noqualifier\fP Ѥ뤫ɤˤ餺ͭǤ
.LP
.TP 3
\-notimestamp\
-タイムスタンプが抑制されます。 各ページ先頭近くにある、生成された HTML 内の HTML コメントでタイムスタンプが隠されます。Javadoc を 2 つのソースベースで実行し、それらに対して diff を実行するときにこのオプションを使用すると、タイムスタンプによって diff が発生しなくなるので便利です (このオプションを使用しないと、各ページで diff になります)。タイムスタンプには Javadoc のバージョン番号が含まれており、次のようになります。
+ॹפޤƥڡƬˤ롢줿 HTML HTML ȤǥॹפޤJavadoc 2 ĤΥ١Ǽ¹ԤФ diff ¹ԤȤˤΥץѤȡॹפˤä diff ȯʤʤΤǤ (ΥץѤʤȡƥڡ diff ˤʤޤ)ॹפˤ Javadoc ΥСֹ椬ޤޤƤꡢΤ褦ˤʤޤ
.nf
\f3
.fl
- <!\-\- Generated by javadoc (build 1.5.0\-internal) on Tue Jun 22 09:57:24 PDT 2004 \-\->
+ <!\-\- Generated by javadoc (build 1.5.0_01) on Thu Apr 02 14:04:52 IST 2009 \-\->
.fl
\fP
.fi
.LP
.TP 3
\-nocomment\
-主説明およびすべてのタグを含むコメント本文全体を抑制し、宣言だけを生成します。このオプションにより、元は異なる目的のためだったソースファイルを再利用し、新しいプロジェクトの早い段階でスケルトン HTML ドキュメントを作成できるようになりました。
+Ӥ٤ƤΥޤॳʸΤޤΥץˤꡢϰۤʤŪΤäեѤץȤᤤʳǥȥ HTML ɥȤǤ褦ˤʤޤ
+.LP
+.TP 3
+\-sourcetab tabLength
+dzƥ֤οꤷޤ
.RE
-.SH "コマンド行引数ファイル"
-.LP
-.LP
-\f2javadoc\fP のコマンド行を短くしたり簡潔にしたりするために、\f2javadoc\fP コマンドに対する引数 (\f2\-J\fP オプションを除く) が入った 1 つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティングシステム上でも、任意の長さの javadoc コマンドを作成できます。
-.LP
-.LP
-引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。
-.LP
-.LP
-引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、\f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fP オプションもサポートされていません。 このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
-.LP
-.LP
-javadoc を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javadoc は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
-.LP
+.SH "ޥɹե"
+.LP
+javadoc ΥޥɹԤûʷˤꤹ뤿ˡ \f2javadoc\fP ޥɤФ ( \f2\-J\fP ץ) ä 1 İʾΥեꤹ뤳ȤǤޤΤȤѤСɤΥڥ졼ƥƥǤ⡢ǤդĹ javadoc ޥɤǤޤ
+.LP
+եˤϡjavac Υץȥե̾ͳȤ߹碌ƵҤǤޤեγưϡڡޤϲԤǶڤޤե̾˶ޤޤƤϡΥե̾ΤŰǰϤߤޤ
+.LP
+եΥե̾ϡߤΥǥ쥯ȥ꤫鸫Хѥˤʤޤեΰ֤鸫ХѥǤϤޤեΥե̾ꥹȤǤϡ磻ɥ (*) ϻѤǤޤȤС \f2*.java\fP ȤϻǤޤեΰ \f2@\fP ʸѤơʣΥեƵŪ˲᤹뤳ȤϥݡȤƤޤޤ \f2\-J\fP ץ⥵ݡȤƤޤ ΥץϵưġϤޤưġǤϰեݡȤƤʤǤ
+.LP
+javadoc ¹ԤȤˡưեΥѥȥե̾Ƭ \f2@\fP ʸդϤޤjavadoc ϡ\f2@\fP ʸǻϤޤĤȡΥեƤŸưꥹȤޤ
.SS
-引数ファイルを 1 つ指定する例
-.LP
-.LP
-\f2argfile\fP という名前の引数ファイルにすべての Javadoc 引数を格納し、次のように使用することができます。
-.LP
+ե 1 Ļꤹ
+.LP
+Τ褦ˡ\f2argfile\fPפȤ̾ñΰեˡJavadoc Τ٤ƤΰǼޤ
.nf
\f3
.fl
% \fP\f3javadoc @argfile\fP
.fl
.fi
-
-.LP
-.LP
-この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。
-.LP
+.LP
+ΰեˤϡǼƤ 2 ĤΥեƤξȤ뤳ȤǤޤ
.SS
-引数ファイルを 2 つ指定する例
-.LP
-.LP
-Javadoc オプション用に 1 つ、ソースファイル名用に 1 つというように、2 つの引数ファイルを作成し、次のようにして使用することができます。なお、このあとのリストでは、行の継続文字を使用していません。
-.LP
-.LP
-以下の内容を含む \f2options\fP という名前のファイルを作成します。
-.LP
+ե 2 Ļꤹ
+.LP
+2 ĤΰեǤޤ1 Ĥ Javadoc ץѡ⤦ 1 Ĥϥѥå̾ޤϥե̾ѤǤʤΥꥹȤǤϹԷ³ʸѤƤޤ
+.LP
+Ƥޤࡢ\f2options\fPפȤ̾Υեޤ
.nf
\f3
.fl
@@ -5346,27 +3834,24 @@
.fl
\-splitindex
.fl
- \-windowtitle 'Java 2 Platform v1.3 API Specification'
-.fl
- \-doctitle 'Java(TM) 2 Platform 5.0 API Specification'
-.fl
- \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>'
-.fl
- \-bottom 'Copyright 1993\-2000 Sun Microsystems, Inc. All Rights Reserved.'
+ \-windowtitle 'Java SE 7 API Specification'
+.fl
+ \-doctitle 'Java SE 7 API Specification'
+.fl
+ \-header '<b>Java(TM) SE 7</b>'
+.fl
+ \-bottom 'Copyright © 1993\-2011 Oracle and/or its affiliates. All rights reserved.'
.fl
\-group "Core Packages" "java.*"
.fl
- \-overview /java/pubs/ws/1.5/src/share/classes/overview\-core.html
-.fl
- \-sourcepath /java/pubs/ws/1.5/src/share/classes
+ \-overview /java/pubs/ws/1.7.0/src/share/classes/overview\-core.html
+.fl
+ \-sourcepath /java/pubs/ws/1.7.0/src/share/classes
.fl
\fP
.fi
-
-.LP
-.LP
-以下の内容を含む \f2packages\fP という名前のファイルを作成します。
-.LP
+.LP
+Ƥޤࡢ\f2packages\fPפȤ̾Υեޤ
.nf
\f3
.fl
@@ -5378,115 +3863,89 @@
.fl
\fP
.fi
-
-.LP
-.LP
-そのあと、次のコマンドを使用して javadoc を実行します。
-.LP
+.LP
+ΤȡΥޥɤѤ javadoc ¹Ԥޤ
.nf
\f3
.fl
% \fP\f3javadoc @options @packages\fP
.fl
.fi
-
-.LP
.SS
-パス付きの引数ファイルの例
-.LP
-.LP
-引数ファイルには、パスを指定できます。 ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。 つまり、下の例の場合は、\f2path1\fP や \f2path2\fP から見た相対パスではありません。
-.LP
+ѥդΰե
+.LP
+եˤϡѥǤޤΥե˻ꤵ줿ե̾ϡߤκȥǥ쥯ȥ꤫鸫ХѥˤʤޤĤޤꡢξϡ \f2path1\fP \f2path2\fP 鸫ХѥǤϤޤ
.nf
\f3
.fl
% \fP\f3javadoc @path1/options @path2/packages\fP
.fl
.fi
-
-.LP
.SS
-オプションの引数の例
-.LP
-.LP
-次に、Javadoc オプションに対する引数だけを引数ファイルに格納する例を示します。ここでは、\f2\-bottom\fP を例に取り上げます。 そのオプションには、かなり長い引数を指定することがあるからです。まず、このオプションのテキスト引数になる次のような内容を含む、\f2bottom\fP という名前のファイルを作成します。
-.LP
+ץΰ
+.LP
+ˡJavadoc ץФե˳ǼޤǤ \f2\-bottom\fP ץѤޤȤΤ⡢Ĺʤǽ뤫ǤΤ褦ʥƥȰޤࡢ\f2bottom\fPפȤ̾ΥեǤޤ
.nf
\f3
.fl
-'<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a
-.fl
-bug or feature</a><br><br>Java is a trademark or registered trademark of
-.fl
-Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-2000 Sun
-.fl
-Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
-.fl
-All Rights Reserved.</font>'
+<font size="\-1">
+.fl
+ <a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a bug or feature</a><br/>
+.fl
+ Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.<br/>
+.fl
+ Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
+.fl
+ Other names may be trademarks of their respective owners.</font>
.fl
\fP
.fi
-
-.LP
-.LP
-そのあと、次のようにして Javadoc ツールを実行します。
-.LP
+.LP
+ΤȡΤ褦ˤ Javadoc ġ¹Ԥޤ
.nf
\f3
.fl
% \fP\f3javadoc \-bottom @bottom @packages\fP
.fl
.fi
-
-.LP
-.LP
-また、引数ファイルの先頭に \f2\-bottom\fP オプションを組み込んでおけば、次のようにして実行できます。
-.LP
+.LP
+뤤ϡեƬ \f2\-bottom\fP ץȤ߹ȡΤ褦˼¹ԤƤ⤫ޤޤ
.nf
\f3
.fl
% \fP\f3javadoc @bottom @packages\fP
.fl
.fi
-.SH "名前"
-実行
-.SH "Javadoc の実行"
-.LP
-.LP
-\f3バージョン番号\fP \- javadoc のバージョン番号を判別するには、\f3javadoc \-J\-version\fP を使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。\f2\-quiet\fP で無効にできます。
-.LP
-.LP
-\f3公開プログラムインタフェース\fP \- Java 言語で記述されたプログラムから Javadoc ツールを起動するとき使用します。このインタフェースは \f2com.sun.tools.javadoc.Main\fP にあります (javadoc は再入可能)。詳細は、
-.na
-\f2「標準ドックレット」\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyを参照してください。
-.LP
-.LP
-\f3ドックレットの実行\fP \- 下記の説明は、標準 HTML ドックレットを呼び出すためのものです。カスタムドックレットを呼び出すには、\-doclet および \-docletpath オプションを使用します。特定のドックレットを実行した完全な例については、
+.SH "̾"
+¹
+.SH "Javadoc μ¹"
+.LP
+\f3Сֹ\fP \- javadoc ΥСֹȽ̤ˤϡ\f3javadoc \-J\-version\fP ѤޤϥȥˤɸɥååȤΥСֹ椬ޤޤޤνϤ̵ˤˤϡ \f2\-quiet\fP Ѥޤ
+.LP
+\f3ץ।ե\fP \- Java ǵҤ줿ץफ Javadoc ġưȤѤޤΥե \f2com.sun.tools.javadoc.Main ˤޤ\fP (javadoc Ϻǽ)ܺ٤ϡ
.na
-\f2MIF Doclet のドキュメント\fP @
+\f2ɸɥååȡ\fP @
+.fi
+http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyȤƤ
+.LP
+\f3ɥååȤμ¹\fP \- ϡɸ HTML ɥååȤƤӽФΤΤǤɥååȤƤӽФˤϡ\-doclet \-docletpath ץѤޤΥɥååȤ¹ԤˤĤƤϡ
+.na
+\f2MIF Doclet Υɥ\fP @
.fi
-http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlを参照してください。
-.LP
-.SH "簡単な例"
-.LP
-.LP
-javadoc は、パッケージ全体に対して実行することも、個々のソースファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。次の例では、ソースファイルは \f2/home/src/java/awt/*.java\fP にあります。生成先ディレクトリは \f2/home/html\fP です。
-.LP
+http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlȤƤ
+.SH "ñ"
+.LP
+javadoc ϡѥåΤФƼ¹Ԥ뤳Ȥ⡢ġΥեФƼ¹Ԥ뤳ȤǤޤƥѥå̾ϡ줾Υѥå̾бǥ쥯ȥ̾ޤǤϡե \f2/home/src/java/awt/*.java ˤޤ\fPǥ쥯ȥ \f2/home/html Ǥ\fP
.SS
-1 つ以上のパッケージのドキュメント化
-.LP
-.LP
-パッケージをドキュメント化するには、そのパッケージのソースファイル (\f2*.java\fP) が、パッケージと同じ名前を持つディレクトリ内に存在していなければなりません。パッケージ名が複数の識別子で構成されている (\f2java.awt.color\fP のように、各識別子はドットで区切られている) 場合は、後続の各識別子が下位のサブディレクトリに対応していなければなりません (\f2java/awt/color\fP など)。1 つのパッケージのための複数のソースファイルを、異なる場所にある 2 つのディレクトリツリーに分けて格納することも可能です (\f2src1/java/awt/color\fP と \f2src2/java/awt/color\fP など)。 ただし、その場合は、\f2\-sourcepath\fP によって、その両方の場所を指定しなければなりません。
-.LP
-.LP
-javadoc を実行するには、\f2cd\fP コマンドを使ってディレクトリを変更するか、または \f2\-sourcepath\fP オプションを使用します。以下の例では、両方の方法について説明します。
-.LP
+1 İʾΥѥåΥɥȲ
+.LP
+ѥåɥȲˤϡΥѥåΥե (\f2*.java\fP) ΥѥåƱ̾Υǥ쥯ȥ˳Ǽɬפޤѥå̾ ( \f2java.awt.color\fP Τ褦˥ɥåȤǶڤ줿) Ĥμ̻Ҥ鹽Ƥ硢¦μ̻Ҥ˿ʤिӤˡμ̻Ҥ꿼֥ǥ쥯ȥбƤɬפޤ ( \f2java/awt/color\fP ʤ) ñѥåΥե 2 롼פʬۤʤˤ뤽Τ褦 2 ĤΥǥ쥯ȥĥˤ줾ǼƤ⤫ޤޤξΥǥ쥯ȥؤΥѥ \f2\-sourcepath\fP ꤹɬפޤ: \f2src1/java/awt/color\fP \f2src2/java/awt/color\fP
+.LP
+javadoc ¹Ԥˤϡ \f2cd\fP Ѥƥǥ쥯ȥѹ뤫 \f2\-sourcepath\fP ץѤޤʲǤϡξˡˤĤޤ
.RS 3
.TP 2
o
-\f3ケース 1 \- 1 つ以上のパッケージからの起動を再帰的に実行\fP \- この例では javadoc が任意のディレクトリから実行できるように、\-sourcepath を使用し、再帰的処理のために \-subpackages (1.4 の新オプション) を使用します。これは、\f2java\fP のサブパッケージ (\f2java.net\fP および \f2java.lang\fP をルートとするパッケージを除く) を処理します。ただし、\f2java.lang\fP のサブパッケージである \f2java.lang.ref\fP は除外されます。
+\f3 1 \- 1 İʾΥѥåεưƵŪ˼¹\fP \- Ǥ javadoc ǤդΥǥ쥯ȥ꤫¹ԤǤ褦ˡ\-sourcepath ѤƵŪΤ \-subpackages (1.4 οץ) Ѥޤϡ \f2java\fP ǥ쥯ȥΥ֥ѥåɤޤκݤˡ \f2java.net\fP \f2java.lang\fP 롼Ȥ˻ĥѥåϽޤΤȤ \f2java.lang Υ֥ѥå\fPǤ java.lang.ref \f2ޤ\fP
.nf
\f3
.fl
@@ -5494,10 +3953,10 @@
.fl
.fi
.LP
-その他のパッケージツリーを巡回するには、\f2java:javax:org.xml.sax\fP のように、\f2\-subpackages\fP 引数にその名前を追加します。
+ۤΥѥåĥⲼˤɤˤϡ \f2java:javax:org.xml.sax Τ褦ˡ\fP Υѥå̾ \-subpackages \f2ΰɲäޤ\fP
.TP 2
o
-\f3ケース 2 \- ルートソースディレクトリに移ってから明示的なパッケージに対して実行\fP \- 完全指定のパッケージ名の親ディレクトリに移ります。次に、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。
+\f3 2 \- 롼ȥǥ쥯ȥ˰ܤäƤŪʥѥåФƼ¹\fP \- Υѥå̾οƥǥ쥯ȥ˰ܤޤˡɥȲ 1 İʾΥѥå̾ꤷ javadoc ¹Ԥޤ
.nf
\f3
.fl
@@ -5508,7 +3967,7 @@
.fi
.TP 2
o
-\f3ケース 3 \- 任意のディレクトリから実行。 ソースファイルは 1 つのディレクトリツリー内にある\fP \- このケースでは、現在のディレクトリがどこであってもかまいません。最上位パッケージの親ディレクトリを \f2\-sourcepath\fP に指定し、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。
+\f3 3 \- ǤդΥǥ쥯ȥ꤫¹ԡե 1 ĤΥǥ쥯ȥĥˤ\fP \- ΥǤϡߤΥǥ쥯ȥ꤬ɤǤäƤ⤫ޤޤǾ̥ѥåοƥǥ쥯ȥ \f2\-sourcepath\fP ˻ꤷɥȲ 1 İʾΥѥå̾ꤷ javadoc ¹Ԥޤ
.nf
\f3
.fl
@@ -5517,7 +3976,7 @@
.fi
.TP 2
o
-\f3ケース 4 \- 任意のディレクトリから実行。 ソースファイルは複数のディレクトリツリー内にある\fP \- これはケース 3 と似ていますが、パッケージが複数のディレクトリツリーに存在します。それぞれのツリーのルートへのパスを \f2\-sourcepath\fP に指定し (コロンで区切る)、ドキュメント化する 1 つ以上のパッケージ名を指定して javadoc を実行します。1 つのパッケージのすべてのソースファイルが、1 つのルートディレクトリの下に存在しなければならない、ということはありません。 ソースパスとして指定された場所のどこかで見つかれば十分です。
+\f3 4 \- ǤդΥǥ쥯ȥ꤫¹ԡեʣΥǥ쥯ȥĥˤ\fP \- ϥ 3 ȻƤޤѥåʣΥǥ쥯ȥĥ¸ߤޤ줾ΥĥΥ롼ȤؤΥѥ \f2\-sourcepath\fP ˻ꤷ (Ƕڤ)ɥȲ 1 İʾΥѥå̾ꤷ javadoc ¹Ԥޤ1 ĤΥѥåΤ٤ƤΥե뤬1 ĤΥ롼ȥǥ쥯ȥβ¸ߤʤФʤʤȤȤϤޤѥȤƻꤵ줿ΤɤǸĤнʬǤ
.nf
\f3
.fl
@@ -5525,21 +3984,16 @@
.fl
.fi
.RE
-
-.LP
-.LP
-結果: 上記のどのケースでも、\f2java.awt\fP と \f2java.awt.event\fP パッケージ内の public および protected クラスとインタフェースについて、HTML 形式のドキュメントが生成され、指定された生成先ディレクトリ (\f2/home/html\fP) に HTML ファイルが保存されます。2 つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラスページという 3 つのフレームを持つことになります。
-.LP
+.LP
+: ٤ƤΥǥѥå \f2java.awt\fP \f2java.awt.event\fP public protected 饹ȥեˤĤơHTML ΥɥȤ졢ꤵ줿ǥ쥯ȥ (\f2/home/html\fP) HTML ե뤬¸ޤ2 İʾΥѥåƤΤǡɥȤϡѥåΥꥹȡ饹ΥꥹȡӥᥤΥ饹ڡȤ 3 ĤΥե졼ĤȤˤʤޤ
.SS
-1 つ以上のクラスのドキュメント化
-.LP
-.LP
-また、1 つ以上のソースファイル (\f2.java\fP) を渡して、Javadoc ツールを実行することもできます。javadoc は、次の 2 つのどちらかの方法で実行できます。 1 つは、\f2cd\fP コマンドでディレクトリを変更する方法、もう 1 つは \f2.java\fP ファイルへのパスを完全指定する方法です。相対パスは、現在のディレクトリを起点とします。ソースファイル名を渡すときは、\f2\-sourcepath\fP オプションは無視されます。アスタリスク (*) のようなコマンド行ワイルドカードを使用すると、クラスのグループを指定できます。
-.LP
+1 İʾΥ饹ΥɥȲ
+.LP
+ޤ1 İʾΥե (\f2.java\fP) ϤơJavadoc ġ¹Ԥ뤳ȤǤޤjavadoc ϡ 2 ĤˡΤ줫Ǽ¹ԤǤޤ1 Ĥ \f2cd\fP Ѥƥǥ쥯ȥѹˡ⤦ 1 Ĥ \f2.java\fP եؤΥѥ˻ꤹˡǤХѥϡߤΥǥ쥯ȥȤޤե̾ϤȤϡ \f2\-sourcepath\fP ץ̵뤵ޤꥹ (*) Τ褦ʥޥɹԥ磻ɥɤѤȡ饹Υ롼פǤޤ
.RS 3
.TP 2
o
-\f3ケース 1 \- ソースディレクトリに移る\fP \- \f2.java\fP ファイルのあるディレクトリに移ります。次に、ドキュメント化する 1 つ以上のソースファイルの名前を指定して javadoc を実行します。
+\f3 1 \- ǥ쥯ȥ˰ܤ\fP \- \f2.java\fP եΤǥ쥯ȥ˰ܤޤˡɥȲ 1 İʾΥե̾ꤷ javadoc ¹Ԥޤ
.nf
\f3
.fl
@@ -5548,10 +4002,10 @@
% \f3javadoc \-d /home/html Button.java Canvas.java Graphics*.java\fP
.fl
.fi
-この例では、クラス \f2Button\fP と \f2Canvas\fP、および名前が \f2Graphics\fP で始まるクラスについて、HTML 形式のドキュメントが生成されます。パッケージ名ではなくソースファイルが javadoc に引数として渡されているので、ドキュメントは、クラスのリストとメインページという 2 つのフレームを持つことになります。
+Ǥϡ饹 \f2Button\fP \f2Canvas\fP ̾ \f2Graphics ǻϤޤ륯饹ˤĤơHTML ΥɥȤޤ\fPѥå̾ǤϤʤե뤬 javadoc ˰ȤϤƤΤǡɥȤϡ饹ΥꥹȤȥᥤڡȤ 2 ĤΥե졼ĤȤˤʤޤ
.TP 2
o
-\f3ケース 2 \- パッケージのルートディレクトリに移る\fP \- これは、同じルート内にある複数のサブパッケージの個々のソースファイルをドキュメント化する場合に便利です。パッケージのルートディレクトリに移り、各ソースファイルを、ルートからのパスとともに指定します。
+\f3 2 \- ѥåΥ롼ȥǥ쥯ȥ˰ܤ\fP \- ϡƱ롼ˤʣΥ֥ѥåθġΥեɥȲǤѥåΥ롼ȥǥ쥯ȥ˰ܤꡢƥե롼ȤΥѥȤȤ˻ꤷޤ
.nf
\f3
.fl
@@ -5560,103 +4014,88 @@
% \f3javadoc \-d /home/html java/awt/Button.java java/applet/Applet.java\fP
.fl
.fi
-この例では、\f2Button\fP クラスおよび \f2Applet\fP クラスについて、HTML 形式のドキュメントが生成されます。
+Ǥϡ饹 \f2Button\fP \f2Applet ˤĤơHTML ΥɥȤޤ\fP
.TP 2
o
-\f3ケース 3 \- 任意のディレクトリから\fP \- このケースでは、現在のディレクトリがどこであってもかまいません。ドキュメント化する \f2.java\fP ファイルへの絶対パス (または、現在のディレクトリからの相対パス) を指定して javadoc を実行します。
+\f3 3 \- ǤդΥǥ쥯ȥ꤫\fP \- ΥǤϡߤΥǥ쥯ȥ꤬ɤǤäƤ⤫ޤޤɥȲ .java եؤХѥ (ޤϥȥǥ쥯ȥ꤫Хѥ) ꤷ \f2javadoc\fP ¹Ԥޤ
.nf
\f3
.fl
% \fP\f3javadoc \-d /home/html /home/src/java/awt/Button.java /home/src/java/awt/Graphics*.java\fP
.fl
.fi
-この例では、クラス \f2Button\fP と、名前が \f2Graphics\fP で始まるクラスについて、HTML 形式のドキュメントが生成されます。
+Ǥϡ饹 \f2Button\fP ȡ̾ \f2Graphics ǻϤޤ륯饹ˤĤơHTML ΥɥȤޤ\fP
.RE
-
-.LP
.SS
-パッケージとクラスのドキュメント化
-.LP
-.LP
-パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に前述の 2 つの例を組み合わせた例を示します。\f2\-sourcepath\fP は、パッケージへのパスに対しては使用できますが、個々のクラスのパスに対しては使用できません。
-.LP
+ѥåȥ饹ΥɥȲ
+.LP
+ѥåΤȸġΥ饹Ʊ˻ꤷƥɥȲ뤳ȤǤޤҤ 2 ĤȤ߹碌ޤ \f2\-sourcepath\fP ϡѥåؤΥѥФƤϻѤǤޤġΥ饹ΥѥФƤϻѤǤޤ
.nf
\f3
.fl
% \fP\f3javadoc \-d /home/html \-sourcepath /home/src java.awt /home/src/java/applet/Applet.java\fP
.fl
.fi
-
-.LP
-.LP
-この例では、パッケージ \f2java.awt\fP と、クラス \f2Applet\fP について、HTML 形式のドキュメントが生成されます。Javadoc ツールは、\f2Applet\fP のパッケージ名を、\f2Applet.java\fP ソースファイル内のパッケージ宣言 (その宣言がある場合) から判別します。
-.LP
-.SH "使用例"
-.LP
-.LP
-Javadoc ツールには多くの便利なオプションがあり、その中にはほかのオプションよりも頻繁に使われるものがあります。ここで紹介するのは、Java プラットフォーム API に対して Javadoc ツールを実行するときに使用する実際のコマンドです。Java 2 Platform, Standard Edition, v1.2 に存在する、約 1500 個の public および protected クラスについてドキュメントを生成するために、180M バイトのメモリーを使用しました。
-.LP
-.LP
-同じ例を 2 回掲載します。 最初の例はコマンド行から実行するもので、2 番目の例は Makefile から実行するものです。オプションの引数に絶対パスを使用しているため、任意のディレクトリからこの \f2javadoc\fP コマンドを実行できます。
-.LP
+.LP
+Ǥϡѥå \f2java.awt\fP ȥ饹 \f2Applet ˤĤơHTML ΥɥȤޤ\fPJavadoc ġϡ \f2Applet.java ե˥ѥåС\fP ˴Ť \f2Applet Υѥå̾\fP Ƚꤷޤ
+.SH ""
+.LP
+Javadoc ġˤ¿ʥץꡢˤϤۤΥץˤ˻ȤΤޤǾҲ𤹤ΤϡJava ץåȥե API Ф Javadoc ġ¹ԤȤ˻ѤºݤΥޥɤǤǤϡJava SE Platform, Standard Edition, v1.2 () 1500 Ĥ public protected 饹ΥɥȤ뤿ˡ180M ХȤΥѤޤ
+.LP
+Ʊ 2 ǺܤޤǽϥޥɹԤ¹ԤΤǡ2 ܤ Makefile ¹ԤΤǤץΰХѥѤƤ뤿ᡢƱ \f2javadoc\fP ޥɤɤΥǥ쥯ȥ꤫Ǥ¹ԤǤޤ
.SS
-コマンド行の例
-.LP
-.LP
-次のコマンド行の例は 900 文字を超えているため、DOS などのシェルには大きすぎます。この制限を回避するには、コマンド行引数ファイルを使用します。 または、シェルスクリプトを記述します。
-.LP
+ޥɹԤ
+.LP
+ϡDOS ʤɤΰΥǤĹǽޤ¤ˤϡޥɹեѤޤޤϡ륹ץȤҤޤ
.nf
\f3
.fl
-% javadoc \-sourcepath /java/jdk/src/share/classes \\
-.fl
- \-overview /java/jdk/src/share/classes/overview.html \\
-.fl
- \-d /java/jdk/build/api \\
-.fl
- \-use \\
-.fl
- \-splitIndex \\
-.fl
- \-windowtitle 'Java 2 Platform 5.0 API Specification' \\
-.fl
- \-doctitle 'Java(TM) 2 Platform 5.0 API Specification' \\
-.fl
- \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>' \\
-.fl
- \-bottom '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
-.fl
-a bug or feature</a><br><br>Java is a trademark or registered trademark of Sun Microsystems,
-.fl
-Inc. in the US and other countries.<br>Copyright 1993\-1999 Sun Microsystems, Inc.
-.fl
-901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A. All Rights Reserved.</font>' \\
+% javadoc \-sourcepath /java/jdk/src/share/classes \\
+.fl
+ \-overview /java/jdk/src/share/classes/overview.html \\
+.fl
+ \-d /java/jdk/build/api \\
+.fl
+ \-use \\
+.fl
+ \-splitIndex \\
+.fl
+ \-windowtitle 'Java Platform, Standard Edition 7 API Specification' \\
+.fl
+ \-doctitle 'Java Platform, Standard Edition 7 API Specification' \\
+.fl
+ \-header '<b>Java(TM) SE 7</b>' \\
+.fl
+ \-bottom '<font size="\-1">
+.fl
+ <a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a bug or feature</a><br/>
+.fl
+ Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.<br/>
+.fl
+ Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
+.fl
+ Other names may be trademarks of their respective owners.</font>' \\
.fl
\-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
.fl
- \-group "Extension Packages" "javax.*" \\
-.fl
- \-J\-Xmx180m \\
+ \-group "Extension Packages" "javax.*" \\
+.fl
+ \-J\-Xmx180m \\
.fl
@packages
.fl
\fP
.fi
-
-.LP
-.LP
-上記のコマンドで、\f2packages\fP は、処理対象のパッケージ名 (\f2java.applet java.lang\fP など) が入っているファイルの名前です。各オプションの、単一引用符で囲まれた引数の内側には、改行文字を挿入できません。たとえば、この例をコピー＆ペーストする場合は、\f2\-bottom\fP オプションから改行文字を削除してください。さらに、このあとの「注」も参照してください。
-.LP
+.LP
+嵭Υޥɤǡ \f2packages\fP ϡоݤΥѥå̾ ( \f2java.applet java.lang\fP ʤ) äƤե̾ǤƥץΡñǰϤޤ줿¦ˤϡʸǤޤȤСԡڡȤϡ \f2\-bottom\fP ץʸƤˡΤȤΡפ⻲ȤƤ
.SS
-Makefile の例
-.LP
-.LP
-ここでは、GNU Makefile の例を示します。Windows の Makefile の例については、
+Makefile
+.LP
+ǤϡGNU Makefile ޤWindows Makefile ˤĤƤϡ
.na
-\f2Windows の Makefile の作成方法\fP @
+\f2Windows Makefile κˡ\fP @
.fi
-http://java.sun.com/j2se/javadoc/faq/index.html#makefilesを参照してください。
-.LP
+http://java.sun.com/j2se/javadoc/faq/index.html#makefilesȤƤ
.nf
\f3
.fl
@@ -5692,101 +4131,83 @@
.fl
.fl
-WINDOWTITLE = 'Java 2 Platform v1.2 API Specification'
-.fl
-DOCTITLE = 'Java(TM) 2 Platform v1.2 API Specification'
-.fl
-HEADER = '<b>Java 2 Platform </b><br><font size="\-1">v1.2</font>'
-.fl
-BOTTOM = '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
-.fl
- a bug or feature</a><br><br>Java is a trademark or registered trademark
-.fl
- of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-1999
-.fl
- Sun Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
-.fl
- All Rights Reserved.</font>'
+WINDOWTITLE = 'Java(TM) SE 7 API Specification'
+.fl
+DOCTITLE = 'Java(TM) Platform Standard Edition 7 API Specification'
+.fl
+HEADER = '<b>Java(TM) SE 7</font>'
+.fl
+BOTTOM = '<font size="\-1">
+.fl
+ <a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a bug or feature</a><br/>
+.fl
+ Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.<br/>
+.fl
+ Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
+.fl
+ Other names may be trademarks of their respective owners.</font>'
.fl
GROUPCORE = '"Core Packages" "java.*:com.sun.java.*:org.omg.*"'
.fl
GROUPEXT = '"Extension Packages" "javax.*"'
.fl
-SRCDIR = '/java/jdk/1.2/src/share/classes'
+SRCDIR = '/java/jdk/1.7.0/src/share/classes'
.fl
\fP
.fi
-
-.LP
-.LP
-Makefile の引数は、単一引用符で囲みます。
-.LP
-.LP
-\f3注\fP
-.LP
+.LP
+Makefile ΰϡñǰϤߤޤ
+.LP
+\f3\fP
.RS 3
.TP 2
o
-\f2\-windowtitle\fP オプションを省略すると、Javadoc ツールによって、ドキュメントタイトルがウィンドウタイトルにコピーされます。\f2\-windowtitle\fP のテキストは、基本的に \f2\-doctitle\fP と同じです。 ただし、HTML タグは使用しません。 HTML タグは、ウィンドウタイトルにそのままのテキストとして表示されてしまいます。
+\-windowtitle \f2ץάȡ\fP Javadoc ġˤäƥɥȥȥ뤬ɥȥ˥ԡޤ \f2\-windowtitle\fP ΥƥȤϴŪ \f2\-doctitle\fP ΤΤƱǤHTML ޤޤʤۤʤޤϡHTML raw ƥȤȤƥɥȥɽΤɤǤ
.TP 2
o
-この例のように \f2\-footer\fP オプションを省略すると、Javadoc ツールによって、ヘッダーテキストがフッターにコピーされます。
+ǹԤäƤ褦 \f2\-footer\fP ץάȡJavadoc ġˤäƥإåΥƥȤեå˥ԡޤ
.TP 2
o
-この例では必要ありませんが、\-\f2classpath\fP および \-\f2link\fP も重要なオプションです。
+Ǥɬפޤ\-\f2classpath\fP \-\f2link\fP פʥץǤ
.RE
-
-.LP
-.SH "トラブルシューティング"
-.LP
+.SH "ȥ֥륷塼ƥ"
.SS
-一般的なトラブルシューティング
-.LP
+Ūʥȥ֥륷塼ƥ
.RS 3
.TP 2
o
-\f3Javadoc FAQ\fP \- 一般的なバグおよびトラブルシューティングのヒントは、
+\f3Javadoc FAQ\fP \- ŪʥХӥȥ֥륷塼ƥΥҥȤϡ
.na
-\f2「Javadoc FAQ」\fP @
+\f2Javadoc FAQ\fP @
.fi
-http://java.sun.com/j2se/javadoc/faq/index.html#B で参照できます。
+http://java.sun.com/j2se/javadoc/faq/index.html#B ǻȤǤޤ
.TP 2
o
-\f3バグおよび制限事項\fP \- バグの一部は、「Important Bug Fixes and Changes」 でも参照できます。
+\f3Х»\fP \- ХΰϡImportant Bug Fixes and Changes Ǥ⻲ȤǤޤ
.TP 2
o
-\f3バージョン番号\fP \- 「バージョン番号」を参照してください。
+\f3Сֹ\fP \- ֥СֹפȤƤ
.TP 2
o
-\f3有効なクラスだけをドキュメント化\fP \- パッケージをドキュメント化するとき、Javadoc は、有効なクラス名で構成されているファイルのみを読み込みます。たとえば、ファイル名にハイフン「\-」を含めることで、javadoc によるファイルの解析を防ぐことができます。
+\f3ͭʥ饹ɥȲ\fP \- ѥåɥȲȤJavadoc ϡͭʥ饹̾ǹƤեΤߤɤ߹ߤޤȤСե̾˥ϥե\-פޤ뤳Ȥǡjavadoc ˤեβϤɤȤǤޤ
.RE
-
-.LP
.SS
-エラーと警告
-.LP
-.LP
-エラーおよび警告メッセージには、ファイル名と宣言行 (ドキュメンテーションコメント内の特定の行ではない) の行番号が含まれます。
-.LP
+顼ȷٹ
+.LP
+顼ӷٹåˤϡե̾ (ɥơιԤǤϤʤ) ιֹ椬ޤޤޤ
.RS 3
.TP 2
o
-\f2"error:cannot read:Class1.java"\fP Javadoc ツールはカレントディレクトリに Class1.java クラスをロードしようとしています。絶対パスまたは相対パスとともに表示されるクラス名は、この例の場合 \f2./Class1.java\fP と同じです。
+\f2"error: cannot read: Class1.java"\fP Javadoc ġϥȥǥ쥯ȥ Class1.java 饹ɤ褦ȤƤޤХѥޤХѥȤȤɽ륯饹̾ϡξ \f2./Class1.java ƱǤ\fP
.RE
-
-.LP
-.SH "環境"
-.LP
+.SH "Ķ"
.RS 3
.TP 3
CLASSPATH
-Javadoc がユーザークラスのファイルを探すときに使うパスを指定する環境変数です。この環境変数は、\f2\-classpath\fP オプションによってオーバーライドされます。ディレクトリは、次のようにコロンで区切ります。
+Javadoc 桼饹ΥեõȤ˻ȤѥꤹĶѿǤδĶѿϡ \f2\-classpath\fP ץˤäƥС饤ɤޤǥ쥯ȥϡΤ褦˥Ƕڤޤ
.:/home/classes:/usr/local/java/classes
.RE
-
-.LP
-.SH "関連項目"
-.LP
+.SH "Ϣ"
.RS 3
.TP 2
o
@@ -5806,7 +4227,7 @@
.TP 2
o
.na
-\f2Javadoc のホームページ\fP @
+\f2Javadoc Υۡڡ\fP @
.fi
http://java.sun.com/j2se/javadoc/index.jsp
.TP 2
@@ -5818,16 +4239,14 @@
.TP 2
o
.na
-\f2クラスパスの設定\fP @
+\f2饹ѥ\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#general
.TP 2
o
.na
-\f2javac と javadoc がクラスを検索する方法\fP @
+\f2javac javadoc 饹ˡ\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles (tools.jar)
.RE
-
-.LP