Mercurial > hg > release > icedtea8-forest-3.0 > jdk
changeset 10352:0e0a35b0bf0f jdk8u25-b07
Merge
author | asaha |
---|---|
date | Mon, 14 Jul 2014 11:15:04 -0700 |
parents | bfb74d8f2afb (current diff) 35b34d6782b4 (diff) |
children | 16aeb088b949 |
files | |
diffstat | 94 files changed, 10552 insertions(+), 8965 deletions(-) [+] |
line wrap: on
line diff
--- a/src/linux/doc/man/ja/appletviewer.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/appletviewer.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: appletviewer -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: appletviewer +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "appletviewer" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" appletviewer \- Webブラウザの外側でアプレットを実行します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIappletviewer\fR [\fIoptions\fR] \fIurl\fR\&.\&.\&. +\fBappletviewer\fR [\fIoptions\fR] \fIurl\fR\&.\&.\&. .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -空白で区切られたコマンドライン・オプション。オプションを参照してください。 +空白で区切られたコマンド行オプション。オプションを参照してください。 .RE .PP \fIurl\fR @@ -73,20 +75,20 @@ .RE .SH "説明" .PP -\fIappletviewer\fRコマンドは\fIurls\fRに指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。urlsによって参照されたドキュメントが、\fIOBJECT\fR、\fIEMBED\fRまたは\fIAPPLET\fRタグでどのアプレットも参照していない場合、\fIappletviewer\fRコマンドは何も行いません。\fIappletviewer\fRコマンドでサポートされるHTMLタグの詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/appletviewertags\&.htmlにある +\fBappletviewer\fRコマンドは\fIurls\fRに指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。urlsによって参照されたドキュメントが、\fBOBJECT\fR、\fBEMBED\fRまたは\fBAPPLET\fRタグでどのアプレットも参照していない場合、\fBappletviewer\fRコマンドは何も行いません。\fBappletviewer\fRコマンドでサポートされるHTMLタグの詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/appletviewertags\&.htmlにある アプレット・ビューア・タグを参照してください。 .PP -\fIappletviewer\fRコマンドは、RFC2396で定義されたエスケープ・メカニズムに従ってエンコードされたURLを必要とします。サポートされるのは、エンコードされたURLのみです。ただし、ファイル名については、RFC2396の仕様に従ってエンコードを解除しておく必要があります。 +\fBappletviewer\fRコマンドは、RFC2396で定義されたエスケープ・メカニズムに従ってエンコードされたURLを必要とします。サポートされるのは、エンコードされたURLのみです。ただし、ファイル名については、RFC2396の仕様に従ってエンコードを解除しておく必要があります。 .PP \fB注意:\fR The -\fIappletviewer\fRコマンドは開発専用です。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/aboutCodeSamples\&.htmlにある +\fBappletviewer\fRコマンドは開発専用です。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/aboutCodeSamples\&.htmlにある サンプル/テスト・アプリケーションおよびコードについてを参照してください。 .SH "オプション" .PP \-debug .RS 4 -\fIjdb\fRコマンドを使用してJavaデバッガでアプレット・ビューアを開始して、ドキュメント中のアプレットをデバッグします。 +\fBjdb\fRコマンドを使用してJavaデバッガでアプレット・ビューアを開始して、ドキュメント中のアプレットをデバッグします。 .RE .PP \-encoding \fIencoding\-name\fR @@ -96,7 +98,7 @@ .PP \-J\fIjavaoption\fR .RS 4 -文字列\fIjavaoption\fRは、アプレット・ビューアを実行するJavaインタプリタに1つの引数として渡されます。引数にスペースを含めないでください。複数の引数は、すべてが接頭辞\fI\-J\fRで始まる必要があります。これは、コンパイラの実行環境またはメモリー使用の調整に有効です。 +文字列\fBjavaoption\fRは、アプレット・ビューアを実行するJavaインタプリタに1つの引数として渡されます。引数にスペースを含めないでください。複数の引数は、すべてが接頭辞\fB\-J\fRで始まる必要があります。これは、コンパイラの実行環境またはメモリー使用の調整に有効です。 .RE .PP
--- a/src/linux/doc/man/ja/extcheck.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/extcheck.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: extcheck -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: extcheck +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "extcheck" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" extcheck \- ターゲットのJavaアーカイブ(JAR)ファイルと現在インストールされている拡張機能のJARファイル間のバージョンの競合を検出します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIextcheck\fR [\fIoptions\fR] \fItargetfile\&.jar\fR +\fBextcheck\fR [\fIoptions\fR] \fItargetfile\&.jar\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fItargetfile\&.jar\fR @@ -73,13 +75,13 @@ .RE .SH "説明" .PP -\fIextcheck\fRコマンドは、指定されたJARファイルのタイトルおよびバージョンがJava SE SDKにインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティを使用して、同じバージョンまたはより新しいバージョンの拡張機能がすでにインストールされていないかどうかを調べることができます。 +\fBextcheck\fRコマンドは、指定されたJARファイルのタイトルおよびバージョンがJava SE SDKにインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティを使用して、同じバージョンまたはより新しいバージョンの拡張機能がすでにインストールされていないかどうかを調べることができます。 .PP -\fIextcheck\fRコマンドは、\fItargetfile\&.jar\fRファイルのマニフェスト内のヘッダーSpecification\-titleおよびSpecification\-versionを、拡張機能ディレクトリ内に現在インストールされているすべてのJARファイル内の対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、Oracle Solarisの場合は\fIjre/lib/ext\fR、Windowsの場合は\fI\ejre\elib\eext\fRです。\fIextcheck\fRコマンドは、\fIjava\&.lang\&.Package\&.isCompatibleWith\fRメソッドと同様の方法でバージョン番号を比較します。 +\fBextcheck\fRコマンドは、\fBtargetfile\&.jar\fRファイルのマニフェスト内のヘッダーSpecification\-titleおよびSpecification\-versionを、拡張機能ディレクトリ内に現在インストールされているすべてのJARファイル内の対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、Oracle Solarisの場合は\fBjre/lib/ext\fR、Windowsの場合は\fB\ejre\elib\eext\fRです。\fBextcheck\fRコマンドは、\fBjava\&.lang\&.Package\&.isCompatibleWith\fRメソッドと同様の方法でバージョン番号を比較します。 .PP 競合が検出されない場合、リターン・コードは0です。 .PP -拡張機能ディレクトリ内のいずれかのJARファイルのマニフェストに、同一の\fISpecification\-title\fR、および同一またはより新しい\fISpecification\-version\fR番号がある場合は、ゼロでないエラー・コードが返されます。\fItargetfile\&.jar\fRのマニフェスト・ファイルに\fISpecification\-title\fRまたは\fISpecification\-version\fR属性がない場合も、ゼロでないエラー・コードが返されます。 +拡張機能ディレクトリ内のいずれかのJARファイルのマニフェストに、同一の\fBSpecification\-title\fR、および同一またはより新しい\fBSpecification\-version\fR番号がある場合は、ゼロでないエラー・コードが返されます。\fBtargetfile\&.jar\fRのマニフェスト・ファイルに\fBSpecification\-title\fRまたは\fBSpecification\-version\fR属性がない場合も、ゼロでないエラー・コードが返されます。 .SH "オプション" .PP \-verbose @@ -89,7 +91,7 @@ .PP \-J\fIoption\fR .RS 4 -Java仮想マシン(JVM)に\fIoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machine (JVM)に\fIoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/idlj.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/idlj.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: idlj -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java IDLおよびRMI-IIOPツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: idlj +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java IDLおよびRMI-IIOPツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "idlj" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" idlj \- 指定されたインタフェース定義言語(IDL)ファイルに対してJavaバインディングを生成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIidlj\fR [ \fIoptions\fR ] \fIidlfile\fR +\fBidlj\fR [ \fIoptions\fR ] \fIidlfile\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。optionsの順番は任意ですが、\fIidlfile\fRよりも前に指定する必要があります。 +コマンド行オプション。オプションを参照してください。optionsの順番は任意ですが、\fBidlfile\fRよりも前に指定する必要があります。 .RE .PP \fIidlfile\fR @@ -76,16 +78,17 @@ IDL\-to\-Javaコンパイラは、指定されたIDLファイルに対してJavaバインディングを生成します。バインディングの詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/mapping/jidlMapping\&.htmlにある Java IDL: Java言語マッピングへのIDLを参照してください。 .PP -IDL\-to\-Javaコンパイラの以前のリリースの中には、\fIidltojava\fRという名前だったものがあります。 +IDL\-to\-Javaコンパイラの以前のリリースの中には、\fBidltojava\fRという名前だったものがあります。 .SS "クライアント・バインディングおよびサーバー・バインディングの発行" .PP -次の\fIidlj\fRコマンドは、クライアント側バインディングを含む\fIMy\&.idl\fRという名前のIDLファイルを生成します。 +次の\fBidlj\fRコマンドは、クライアント側バインディングを含む\fBMy\&.idl\fRという名前のIDLファイルを生成します。 .sp .if n \{\ .RS 4 .\} .nf -idlj My\&.idl +\fBidlj My\&.idl\fR + .fi .if n \{\ .RE @@ -97,7 +100,8 @@ .RS 4 .\} .nf -idlj \-fclient My\&.idl +\fBidlj \-fclient My\&.idl\fR + .fi .if n \{\ .RE @@ -109,7 +113,8 @@ .RS 4 .\} .nf -idlg \-fserver My\&.idl +\fBidlg \-fserver My\&.idl\fR + .fi .if n \{\ .RE @@ -121,102 +126,78 @@ .RS 4 .\} .nf -idlj \-fclient \-fserver My\&.idl -idlj \-fall My\&.idl +\fBidlj \-fclient \-fserver My\&.idl\fR +\fBidlj \-fall My\&.idl\fR + .fi .if n \{\ .RE .\} .PP サーバー側で可能なモデルは2つあります。移殖可能サーバント継承モデルとTieモデルです。Tie委譲モデルを参照してください。 -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fB移殖可能サーバント継承モデル\fR -.ps -1 -.br +.PP +\fB移殖可能サーバント継承モデル\fR. デフォルトのサーバー側のモデルは、移殖可能サーバント継承モデルです。\fBMy\&.idl\fR内で\fBMy\fRインタフェースが定義されている場合は、\fBMyPOA\&.java\fRというファイルが生成されます。\fBMy\fRインタフェースの実装を提供する必要があり、\fBMy\fRインタフェースは\fBMyPOA\fRクラスから継承する必要があります。\fBMyPOA\&.java\fRは、http://docs\&.oracle\&.com/javase/8/docs/api/org/omg/PortableServer/Servant\&.htmlにある +\fBorg\&.omg\&.PortableServer\&.Servant\fRクラスを拡張するストリームベースのスケルトンです。 .PP -デフォルトのサーバー側のモデルは、移殖可能サーバント継承モデルです。\fIMy\&.idl\fR内で\fIMy\fRインタフェースが定義されている場合は、\fIMyPOA\&.java\fRというファイルが生成されます。\fIMy\fRインタフェースの実装を提供する必要があり、\fIMy\fRインタフェースは\fIMyPOA\fRクラスから継承する必要があります。\fIMyPOA\&.java\fRは、http://docs\&.oracle\&.com/javase/8/docs/api/org/omg/PortableServer/Servant\&.htmlにある -\fIorg\&.omg\&.PortableServer\&.Servant\fRクラスを拡張するストリームベースのスケルトンです。 +\fBMy\fRインタフェースは、スケルトンが実装するIDLインタフェースに関連付けられている\fBcallHandler\fRインタフェースと操作インタフェースを実装します。 .PP -\fIMy\fRインタフェースは、スケルトンが実装するIDLインタフェースに関連付けられている\fIcallHandler\fRインタフェースと操作インタフェースを実装します。 -.PP -ポータブル・オブジェクト・アダプタ(POA)の\fIPortableServer\fRモジュールは、ネイティブの\fIServant\fR型を定義します。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/POA\&.htmlにある +ポータブル・オブジェクト・アダプタ(POA)の\fBPortableServer\fRモジュールは、ネイティブの\fBServant\fR型を定義します。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/POA\&.htmlにある ポータブル・オブジェクト・アダプタ(POA)を参照してください。 .PP -Javaプログラミング言語では、\fIServant\fR型はJavaの\fIorg\&.omg\&.PortableServer\&.Servant\fRクラスにマップされます。これは、すべてのPOAサーバント実装のベース・クラスとして機能し、アプリケーション・プログラマが呼び出すことのできるいくつかのメソッド、およびPOAによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドを提供します。 +Javaプログラミング言語では、\fBServant\fR型はJavaの\fBorg\&.omg\&.PortableServer\&.Servant\fRクラスにマップされます。これは、すべてのPOAサーバント実装のベース・クラスとして機能し、アプリケーション・プログラマが呼び出すことのできるいくつかのメソッド、およびPOAによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドを提供します。 .PP -継承モデルのもう1つのオプションは、\fI\-oldImplBase\fRフラグを使用して、Java SE 1\&.4より前のリリースのJavaプログラミング言語と互換性のあるサーバー側バインディングを生成することです。\-\fIoldImplBase\fRフラグは非標準で、これらのAPIは非推奨です。このフラグを使用するのは、Java SE 1\&.3で記述された既存のサーバーとの互換性が必要な場合のみです。その場合、既存のmakeファイルを変更して、\fI\-oldImplBase\fRフラグを\fIidlj\fRコンパイラに追加する必要があります。それ以外の場合、POAベースのサーバー側マッピングが生成されます。下位互換性のあるサーバー側バインディングを生成するには、次を実行します。 -.sp .5v -.RE +継承モデルのもう1つのオプションは、\fB\-oldImplBase\fRフラグを使用して、Java SE 1\&.4より前のリリースのJavaプログラミング言語と互換性のあるサーバー側バインディングを生成することです。\-\fBoldImplBase\fRフラグは非標準で、これらのAPIは非推奨です。このフラグを使用するのは、Java SE 1\&.3で記述された既存のサーバーとの互換性が必要な場合のみです。その場合、既存のmakeファイルを変更して、\fB\-oldImplBase\fRフラグを\fBidlj\fRコンパイラに追加する必要があります。それ以外の場合、POAベースのサーバー側マッピングが生成されます。後方互換性のあるサーバー側バインディングを生成するには、次を実行します。 .sp .if n \{\ .RS 4 .\} .nf -idlj \-fclient \-fserver \-oldImplBase My\&.idl -idlj \-fall \-oldImplBase My\&.idl +\fBidlj \-fclient \-fserver \-oldImplBase My\&.idl\fR +\fBidlj \-fall \-oldImplBase My\&.idl\fR + .fi .if n \{\ .RE .\} .PP -\fIMy\&.idl\fR内で\fIMy\fRインタフェースが定義されている場合は、\fI_MyImplBase\&.java\fRというファイルが生成されます。\fIMy\fRインタフェースの実装を提供する必要があり、\fIMy\fRインタフェースは\fI_MyImplBase\fRクラスから継承する必要があります。 -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBTie委譲モデル\fR -.ps -1 -.br +\fBMy\&.idl\fR内で\fBMy\fRインタフェースが定義されている場合は、\fB_MyImplBase\&.java\fRというファイルが生成されます。\fBMy\fRインタフェースの実装を提供する必要があり、\fBMy\fRインタフェースは\fB_MyImplBase\fRクラスから継承する必要があります。 .PP -もう1つのサーバー側モデルは、Tieモデルと呼ばれるものです。このサーバー側モデルは、委譲モデルです。Tieとスケルトンを同時に生成することはできないため、それらは別々に生成する必要があります。次のコマンドによって、Tieモデル用のバインディングが生成されます。 -.sp .5v -.RE +\fBTie委譲モデル\fR. もう1つのサーバー側モデルは、Tieモデルと呼ばれるものです。このサーバー側モデルは、委譲モデルです。Tieとスケルトンを同時に生成することはできないため、それらは別々に生成する必要があります。次のコマンドによって、Tieモデル用のバインディングが生成されます。 .sp .if n \{\ .RS 4 .\} .nf -idlj \-fall My\&.idl -idlj \-fallTIE My\&.idl +\fBidlj \-fall My\&.idl\fR +\fBidlj \-fallTIE My\&.idl\fR + .fi .if n \{\ .RE .\} .PP -\fIMy\fRインタフェースの場合、2番目のコマンドにより、\fIMyPOATie\&.java\fRが生成されます。\fIMyPOATie\fRクラスへのコンストラクタは、delegateを取ります。この例では、デフォルトのPOAモデルを使用しているため、コンストラクタにもPOAが必要です。delegateに対して実装を提供する必要がありますが、この実装は\fIMyOperations\fRインタフェースから継承する必要があるのみで、その他のクラスから継承する必要はありません。これをORBと一緒に使用するには、たとえば次のように\fIMyPOATie\fRクラス内で実装をラップする必要があります。 +\fBMy\fRインタフェースの場合、2番目のコマンドにより、\fBMyPOATie\&.java\fRが生成されます。\fBMyPOATie\fRクラスへのコンストラクタは、delegateを取ります。この例では、デフォルトのPOAモデルを使用しているため、コンストラクタにもPOAが必要です。delegateに対して実装を提供する必要がありますが、この実装は\fBMyOperations\fRインタフェースから継承する必要があるのみで、その他のクラスから継承する必要はありません。これをORBと一緒に使用するには、たとえば次のように\fBMyPOATie\fRクラス内で実装をラップする必要があります。 .sp .if n \{\ .RS 4 .\} .nf -ORB orb = ORB\&.init(args, System\&.getProperties()); - -// Get reference to rootpoa & activate the POAManager -POA rootpoa = (POA)orb\&.resolve_initial_references("RootPOA"); -rootpoa\&.the_POAManager()\&.activate(); +\fBORB orb = ORB\&.init(args, System\&.getProperties());\fR +\fB \fR +\fB// Get reference to rootpoa & activate the POAManager\fR +\fBPOA rootpoa = (POA)orb\&.resolve_initial_references("RootPOA");\fR +\fBrootpoa\&.the_POAManager()\&.activate();\fR +\fB \fR +\fB// create servant and register it with the ORB\fR +\fBMyServant myDelegate = new MyServant();\fR +\fBmyDelegate\&.setORB(orb); \fR +\fB \fR +\fB// create a tie, with servant being the delegate\&.\fR +\fBMyPOATie tie = new MyPOATie(myDelegate, rootpoa);\fR +\fB \fR +\fB// obtain the objectRef for the tie\fR +\fBMy ref = tie\&._this(orb);\fR -// create servant and register it with the ORB -MyServant myDelegate = new MyServant(); -myDelegate\&.setORB(orb); - -// create a tie, with servant being the delegate\&. -MyPOATie tie = new MyPOATie(myDelegate, rootpoa); - -// obtain the objectRef for the tie -My ref = tie\&._this(orb); .fi .if n \{\ .RE @@ -230,146 +211,154 @@ .RS 4 .\} .nf -idlj \-oldImplBase \-fall My\&.idl -idlj \-oldImplBase \-fallTIE My\&.idl +\fBidlj \-oldImplBase \-fall My\&.idl\fR +\fBidlj \-oldImplBase \-fallTIE My\&.idl\fR + .fi .if n \{\ .RE .\} .PP -\fIMy\fRインタフェースの場合、これにより、\fIMy_Tie\&.java\fRが生成されます。\fIMy_Tie\fRクラスへのコンストラクタは、\fIimpl\fRオブジェクトを取ります。\fIimpl\fRに対して実装を提供する必要がありますが、その実装は\fIHelloOperations\fRインタフェースから継承する必要があるのみで、その他のクラスから継承する必要はありません。しかし、これをORBと一緒に使用するには、たとえば次のように\fIMy_Tie\fR内で実装をラップする必要があります。 +\fBMy\fRインタフェースの場合、これにより、\fBMy_Tie\&.java\fRが生成されます。\fBMy_Tie\fRクラスへのコンストラクタは、\fBimpl\fRオブジェクトを取ります。\fBimpl\fRに対して実装を提供する必要がありますが、その実装は\fBHelloOperations\fRインタフェースから継承する必要があるのみで、その他のクラスから継承する必要はありません。しかし、これをORBと一緒に使用するには、たとえば次のように\fBMy_Tie\fR内で実装をラップする必要があります。 .sp .if n \{\ .RS 4 .\} .nf -ORB orb = ORB\&.init(args, System\&.getProperties()); - -// create servant and register it with the ORB -MyServant myDelegate = new MyServant(); -myDelegate\&.setORB(orb); +\fBORB orb = ORB\&.init(args, System\&.getProperties());\fR -// create a tie, with servant being the delegate\&. -MyPOATie tie = new MyPOATie(myDelegate); +\fB// create servant and register it with the ORB\fR +\fBMyServant myDelegate = new MyServant();\fR +\fBmyDelegate\&.setORB(orb); \fR +\fB \fR +\fB// create a tie, with servant being the delegate\&.\fR +\fBMyPOATie tie = new MyPOATie(myDelegate);\fR +\fB \fR +\fB// obtain the objectRef for the tie\fR +\fBMy ref = tie\&._this(orb);\fR -// obtain the objectRef for the tie -My ref = tie\&._this(orb); .fi .if n \{\ .RE .\} .SS "発行されたファイルの代替位置の指定" .PP -発行されたファイルを現在のディレクトリ以外のディレクトリに置くには、\fIi\fR\fIdlj \-td /altdir My\&.idl\fRのコマンドでコンパイラを呼び出します。 +発行されたファイルを現在のディレクトリ以外のディレクトリに置くには、\fBi\fR\fBdlj \-td /altdir My\&.idl\fRのコマンドでコンパイラを呼び出します。 .PP -\fIMy\fRインタフェースの場合、バインディングは、\fI\&./My\&.java\fRではなく、\fI/altdir/My\&.java\fRなどに発行されます。 +\fBMy\fRインタフェースの場合、バインディングは、\fB\&./My\&.java\fRではなく、\fB/altdir/My\&.java\fRなどに発行されます。 .SS "インクルード・ファイルの代替位置の指定" .PP -\fIMy\&.idl\fRファイルが別の\fIidl\fRファイルである\fIMyOther\&.idl\fRをインクルードする場合、コンパイラでは、\fIMyOther\&.idl\fRファイルがローカル・ディレクトリに存在することを前提としています。たとえば、それが\fI/includes\fRにある場合は、次のようなコマンドでコンパイラを呼び出します。 +\fBMy\&.idl\fRファイルが別の\fBidl\fRファイルである\fBMyOther\&.idl\fRをインクルードする場合、コンパイラでは、\fBMyOther\&.idl\fRファイルがローカル・ディレクトリに存在することを前提としています。たとえば、それが\fB/includes\fRにある場合は、次のようなコマンドでコンパイラを呼び出します。 .sp .if n \{\ .RS 4 .\} .nf -idlj \-i /includes My\&.idl +\fBidlj \-i /includes My\&.idl\fR + .fi .if n \{\ .RE .\} .PP -たとえば、\fI/moreIncludes\fRにある\fIAnother\&.idl\fRも\fIMy\&.idl\fRにインクルードされているのであれば、次のようなコマンドでコンパイラを呼び出します。 +たとえば、\fB/moreIncludes\fRにある\fBAnother\&.idl\fRも\fBMy\&.idl\fRにインクルードされているのであれば、次のようなコマンドでコンパイラを呼び出します。 .sp .if n \{\ .RS 4 .\} .nf -idlj \-i /includes \-i /moreIncludes My\&.idl +\fBidlj \-i /includes \-i /moreIncludes My\&.idl\fR + .fi .if n \{\ .RE .\} .PP -このような形式の\fIinclude\fRは長くなるため、インクルード・ファイルを検索する場所をコンパイラに指示するための別の方法が用意されています。この方法は、環境変数の考え方と似ています。\fICLASSPATH\fR変数に一覧表示されているディレクトリ内にidl\&.configという名前のファイルを作成します。その\fIidl\&.config\fRの中に、次のような形式の行を入れます。 +このような形式の\fBinclude\fRは長くなるため、インクルード・ファイルを検索する場所をコンパイラに指示するための別の方法が用意されています。この方法は、環境変数の考え方と似ています。\fBCLASSPATH\fR変数に一覧表示されているディレクトリ内にidl\&.configという名前のファイルを作成します。その\fBidl\&.config\fRの中に、次のような形式の行を入れます。 .sp .if n \{\ .RS 4 .\} .nf -includes=/includes;/moreIncludes +\fBincludes=/includes;/moreIncludes\fR + .fi .if n \{\ .RE .\} .PP -コンパイラは、このファイルを検索し、インクルード・リストを読み込みます。この例では、ディレクトリの間の区切り文字はセミコロン(;)になっています。この区切り文字は、プラットフォームによって異なります。Windowsプラットフォームではセミコロンを使用し、UNIXプラットフォームではコロンを使用するなどです。 +コンパイラは、このファイルを検索し、インクルード・リストを読み込みます。この例では、ディレクトリの間の区切り文字はセミコロン(;)になっています。この区切り文字は、プラットフォームによって異なります。Windowsプラットフォームではセミコロンを使用し、Solaris、LinuxおよびOS Xプラットフォームではコロンを使用します。 .SS "インクルード・ファイルに対するバインディングの発行" .PP -デフォルトでは、コマンドラインに指定した\fIidl\fRファイルで定義されているインタフェースや構造体などについてのみ、Javaバインディングが生成されます。インクルードされたファイルで定義されている型については生成されません。たとえば、次の2つの\fIidl\fRファイルについて考えてみます。 +デフォルトでは、コマンド行に指定した\fBidl\fRファイルで定義されているインタフェースや構造体などについてのみ、Javaバインディングが生成されます。インクルードされたファイルで定義されている型については生成されません。たとえば、次の2つの\fBidl\fRファイルについて考えてみます。 .sp .if n \{\ .RS 4 .\} .nf -My\&.idl file: +\fBMy\&.idl file:\fR +\fB \fR +\fB#include <MyOther\&.idl>\fR +\fBinterface My\fR +\fB{\fR +\fB};\fR +\fB \fR +\fBMyOther\&.idl file:\fR +\fB \fR +\fBinterface MyOther\fR +\fB{\fR +\fB};\fR -#include <MyOther\&.idl> -interface My -{ -}; - -MyOther\&.idl file: - -interface MyOther -{ -}; .fi .if n \{\ .RE .\} .PP -デフォルトのルールに関して警告があります。グローバル・スコープに表示される\fI#include\fR文は、前述のとおりに処理されます。これらの\fI#include\fR文は、インポート文と見なすことができます。囲まれたスコープ内に表示される\fI#include\fR文は、本当の意味での\fI#include\fR文として処理されます。つまり、インクルードされたファイルにあるコードが、元のファイルにそのまま表示されているかのように処理され、それに対してJavaバインディングが発行されます。次はその例です。 +デフォルトのルールに関して警告があります。グローバル・スコープに表示される\fB#include\fR文は、前述のとおりに処理されます。これらの\fB#include\fR文は、インポート文と見なすことができます。囲まれたスコープ内に表示される\fB#include\fR文は、本当の意味での\fB#include\fR文として処理されます。つまり、インクルードされたファイルにあるコードが、元のファイルにそのまま表示されているかのように処理され、それに対してJavaバインディングが発行されます。次はその例です。 .sp .if n \{\ .RS 4 .\} .nf -My\&.idl file: - -#include <MyOther\&.idl> -interface My -{ - #include <Embedded\&.idl> -}; +\fBMy\&.idl file:\fR +\fB \fR +\fB#include <MyOther\&.idl>\fR +\fBinterface My\fR +\fB{\fR +\fB #include <Embedded\&.idl>\fR +\fB};\fR +\fB \fR +\fBMyOther\&.idl file:\fR +\fB \fR +\fBinterface MyOther\fR +\fB{\fR +\fB};\fR +\fB \fR +\fBEmbedded\&.idl\fR +\fB \fR +\fBenum E {one, two, three};\fR -MyOther\&.idl file: - -interface MyOther -{ -}; - -Embedded\&.idl - -enum E {one, two, three}; .fi .if n \{\ .RE .\} .PP -\fI idlj My\&.idl \fRを実行して、Javaファイルの次のリストを生成します。インポート文とみなされる\fI#include\fRに定義されていたため、\fIMyOther\&.java\fRは生成されませんでした。ただし、本当の意味での\fI#include\fRで定義されていたため、\fIE\&.java\fRは生成されました。\fIEmbedded\&.idl\fRファイルが\fIMy\fRインタフェースのスコープ内にインクルードされているため、\fIMy\fRのスコープ内(つまり、\fIMyPackage\fR内)に生成されています。\fI\-emitAll\fRフラグを使用した場合、インクルードされたすべてのファイルにあるすべての型が発行されます。 +\fB idlj My\&.idl \fRを実行して、Javaファイルの次のリストを生成します。インポート文とみなされる\fB#include\fRに定義されていたため、\fBMyOther\&.java\fRは生成されませんでした。ただし、本当の意味での\fB#include\fRで定義されていたため、\fBE\&.java\fRは生成されました。\fBEmbedded\&.idl\fRファイルが\fBMy\fRインタフェースのスコープ内にインクルードされているため、\fBMy\fRのスコープ内(つまり、\fBMyPackage\fR内)に生成されています。\fB\-emitAll\fRフラグを使用した場合、インクルードされたすべてのファイルにあるすべての型が発行されます。 .sp .if n \{\ .RS 4 .\} .nf -\&./MyHolder\&.java -\&./MyHelper\&.java -\&./_MyStub\&.java -\&./MyPackage -\&./MyPackage/EHolder\&.java -\&./MyPackage/EHelper\&.java -\&./MyPackage/E\&.java -\&./My\&.java +\fB\&./MyHolder\&.java\fR +\fB\&./MyHelper\&.java\fR +\fB\&./_MyStub\&.java\fR +\fB\&./MyPackage\fR +\fB\&./MyPackage/EHolder\&.java\fR +\fB\&./MyPackage/EHelper\&.java\fR +\fB\&./MyPackage/E\&.java\fR +\fB\&./My\&.java\fR + .fi .if n \{\ .RE @@ -382,49 +371,51 @@ .RS 4 .\} .nf -Widgets\&.idl file: +\fBWidgets\&.idl file:\fR +\fB \fR +\fBmodule Widgets\fR +\fB{\fR +\fB interface W1 {\&.\&.\&.};\fR +\fB interface W2 {\&.\&.\&.};\fR +\fB};\fR -module Widgets -{ - interface W1 {\&.\&.\&.}; - interface W2 {\&.\&.\&.}; -}; .fi .if n \{\ .RE .\} .PP -IDL\-to\-Javaコンパイラを介してこのファイルを実行した場合、W1およびW2に対するJavaバインディングは、\fIWidgets\fRパッケージ内に格納されます。業界の慣例によると、会社のパッケージは、\fIcom\&.<company name>\fRという名前のパッケージ内に置くことになっています。この慣例に従うには、パッケージ名を\fIcom\&.abc\&.Widgets\fRにする必要があります。このパッケージ接頭辞をWidgetsモジュールに付加するには、次のコマンドを実行します。 +IDL\-to\-Javaコンパイラを介してこのファイルを実行した場合、W1およびW2に対するJavaバインディングは、\fBWidgets\fRパッケージ内に格納されます。業界の慣例によると、会社のパッケージは、\fBcom\&.<company name>\fRという名前のパッケージ内に置くことになっています。この慣例に従うには、パッケージ名を\fBcom\&.abc\&.Widgets\fRにする必要があります。このパッケージ接頭辞をWidgetsモジュールに付加するには、次のコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -idlj \-pkgPrefix Widgets com\&.abc Widgets\&.idl +\fBidlj \-pkgPrefix Widgets com\&.abc Widgets\&.idl\fR + .fi .if n \{\ .RE .\} .PP -Widgets\&.idlをインクルードしているIDLファイルがある場合は、そのコマンドにも\fI\-pkgPrefix\fRフラグが必要です。このフラグを指定しないと、そのIDLファイルは、\fIcom\&.abc\&.Widgets\fRパッケージではなく、\fIWidgets\fRパッケージを検索することになります。 +Widgets\&.idlをインクルードしているIDLファイルがある場合は、そのコマンドにも\fB\-pkgPrefix\fRフラグが必要です。このフラグを指定しないと、そのIDLファイルは、\fBcom\&.abc\&.Widgets\fRパッケージではなく、\fBWidgets\fRパッケージを検索することになります。 .PP -接頭辞が必要なパッケージがいくつもある場合は、前述のidl\&.configファイルで接頭辞を指定するのが簡単です。パッケージ接頭辞の各行は、\fIPkgPrefix\&.<type>=<prefix>\fRの形式である必要があります。前述の例の行では、\fIPkgPrefix\&.Widgets=com\&.abc\fRになります。このオプションは、リポジトリIDには影響しません。 +接頭辞が必要なパッケージがいくつもある場合は、前述のidl\&.configファイルで接頭辞を指定するのが簡単です。各パッケージの接頭辞行は、\fBPkgPrefix\&.<type>=<prefix>\fRの形式にする必要があります。前述の例の行では、\fBPkgPrefix\&.Widgets=com\&.abc\fRになります。このオプションは、リポジトリIDには影響しません。 .SS "コンパイル前のシンボルの定義" .PP -コンパイル用のシンボルがIDLファイル内で定義されていない場合は、そのシンボルを定義する必要があります。これは、たとえば、バインディング内にデバッグ・コードを組み入れるときに使用します。コマンド\fIidlj \-d MYDEF My\&.idl \fRは、My\&.idl内に行\fI#define MYDEF\fRを配置した場合と同等になります。 +コンパイル用のシンボルがIDLファイル内で定義されていない場合は、そのシンボルを定義する必要があります。これは、たとえば、バインディング内にデバッグ・コードを組み入れるときに使用します。コマンド\fBidlj \-d MYDEF My\&.idl \fRは、My\&.idl内に行\fB#define MYDEF\fRを配置した場合と同等になります。 .SS "既存のバインディングの保持" .PP -Javaバインディング・ファイルがすでに存在する場合は、\fI\-keep\fRフラグを指定すると、コンパイラによる上書きを回避できます。デフォルトでは、すでに存在するかどうかにかかわらず、すべてのファイルが生成されます。これらのファイルをカスタマイズした場合(ただし、それらの内容が正確であるとき以外はカスタマイズは避ける)、\fI\-keep\fRオプションは有用です。コマンド\fIidlj \-keep My\&.idl\fRは、すでに存在しないすべてのクライアント側バインディングを発行します。 +Javaバインディング・ファイルがすでに存在する場合は、\fB\-keep\fRフラグを指定すると、コンパイラによる上書きを回避できます。デフォルトでは、すでに存在するかどうかにかかわらず、すべてのファイルが生成されます。これらのファイルをカスタマイズした場合(ただし、それらの内容が正確であるとき以外はカスタマイズは避ける)、\fB\-keep\fRオプションは有用です。コマンド\fBidlj \-keep My\&.idl\fRは、すでに存在しないすべてのクライアント側バインディングを発行します。 .SS "コンパイルの進捗状況の表示" .PP -IDL\-to\-Javaコンパイラは、実行の各段階で状態メッセージを生成します。\fI\-v\fRオプションを使用して、\fIidlj \-v My\&.idl\fRのような冗長モードをアクティブ化します。 +IDL\-to\-Javaコンパイラは、実行の各段階で状態メッセージを生成します。\fB\-v\fRオプションを使用して、\fBidlj \-v My\&.idl\fRのような冗長モードをアクティブ化します。 .PP デフォルトでは、コンパイラは冗長モードでは実行されません。 .SS "バージョン情報の表示" .PP -IDL\-to\-Javaコンパイラのビルド・バージョンを表示するには、コマンドライン\fIidlj \-version\fRで\fI\-version\fRオプションを指定します。 +IDL\-to\-Javaコンパイラのビルド・バージョンを表示するには、コマンド行\fBidlj \-version\fRで\fB\-version\fRオプションを指定します。 .PP -バージョン情報は、コンパイラによって生成されたバインディング内にも書き込まれています。このオプションをコマンドラインに指定すると、それ以外のオプションを指定しても、すべて無視されます。 +バージョン情報は、コンパイラによって生成されたバインディング内にも書き込まれています。このオプションをコマンド行に指定すると、それ以外のオプションを指定しても、すべて無視されます。 .SH "オプション" .PP \-d \fIsymbol\fR @@ -435,7 +426,8 @@ .RS 4 .\} .nf -#define \fIsymbol\fR +\fB#define \fR\fB\fIsymbol\fR\fR + .fi .if n \{\ .RE @@ -444,12 +436,12 @@ .PP \-demitAll .RS 4 -\fI#include\fRファイル内で定義されているものも含めて、すべての型を発行します。 +\fB#include\fRファイル内で定義されているものも含めて、すべての型を発行します。 .RE .PP \-fside .RS 4 -発行するバインディングを定義します。\fIside\fRパラメータには、\fIclient\fR、\fIserver\fR、\fIserverTIE\fR、\fIall\fRまたは\fIallTIE\fRを指定できます。\fI\-fserverTIE\fRまたは\fI\-fallTIE\fRオプションを指定すると、委譲モデル・スケルトンが発行されます。フラグを指定しない場合、\fI\-fclient\fRにデフォルト設定されます。 +発行するバインディングを定義します。\fBside\fRパラメータには、\fBclient\fR、\fBserver\fR、\fBserverTIE\fR、\fBall\fRまたは\fBallTIE\fRを指定できます。\fB\-fserverTIE\fRまたは\fB\-fallTIE\fRオプションを指定すると、委譲モデル・スケルトンが発行されます。フラグを指定しない場合、\fB\-fclient\fRにデフォルト設定されます。 .RE .PP \-i \fIinclude\-path\fR @@ -469,17 +461,17 @@ .PP \-oldImplBase .RS 4 -1\&.4より前のJDK ORBと互換性のあるスケルトンを生成します。デフォルトでは、POA継承モデルのサーバー側バインディングが生成されます。このオプションを指定すると、\fIImplBase\fR継承モデルのクラスであるサーバー側バインディングが生成されるので、以前のリリースのJavaプログラミング言語との下位互換性が得られます。 +1\&.4より前のJDK ORBと互換性のあるスケルトンを生成します。デフォルトでは、POA継承モデルのサーバー側バインディングが生成されます。このオプションを指定すると、\fBImplBase\fR継承モデルのクラスであるサーバー側バインディングが生成されるので、以前のリリースのJavaプログラミング言語との後方互換性が得られます。 .RE .PP \-pkgPrefix \fItype\fR \fIprefix\fR .RS 4 -\fItype\fRがファイル・スコープで検出された場合は、その型に対して生成されるすべてのファイルについて、生成されるJavaパッケージ名に\fIprefix\fRという接頭辞が付加されます。typeは、トップレベル・モジュールの単純名か、どのモジュールよりも外側で定義されたIDL型の単純名のどちらかです。 +\fBtype\fRがファイル・スコープで検出された場合は、その型に対して生成されるすべてのファイルについて、生成されるJavaパッケージ名に\fBprefix\fRという接頭辞が付加されます。typeは、トップレベル・モジュールの単純名か、どのモジュールよりも外側で定義されたIDL型の単純名のどちらかです。 .RE .PP \-pkgTranslate \fItype\fR \fIpackage\fR .RS 4 -識別子の中にモジュール名typeが検出されると、生成されるJavaパッケージ内のすべてのファイルについて、識別子の中のその名前がpackageで置き換えられます。最初に\fIpkgPrefix\fRの変更が行われます。typeの値は、トップレベルのモジュールの単純名、またはすべてのモジュールの外部で定義されたIDL型の単純名で、完全なパッケージ名に正確に一致する必要があります。 +識別子の中にモジュール名typeが検出されると、生成されるJavaパッケージ内のすべてのファイルについて、識別子の中のその名前がpackageで置き換えられます。最初に\fBpkgPrefix\fRの変更が行われます。typeの値は、トップレベルのモジュールの単純名、またはすべてのモジュールの外部で定義されたIDL型の単純名で、完全なパッケージ名に正確に一致する必要があります。 .sp 複数の変換が識別子に一致する場合、次の例に示すように、最も長い一致が選択されます。 .sp @@ -489,7 +481,8 @@ .RS 4 .\} .nf -pkgTranslate type pkg \-pkgTranslate type2\&.baz pkg2\&.fizz +\fBpkgTranslate type pkg \-pkgTranslate type2\&.baz pkg2\&.fizz\fR + .fi .if n \{\ .RE @@ -500,22 +493,23 @@ .RS 4 .\} .nf -type => pkg -type\&.ext => pkg\&.ext -type\&.baz => pkg2\&.fizz -type2\&.baz\&.pkg => pkg2\&.fizz\&.pkg +\fBtype => pkg\fR +\fBtype\&.ext => pkg\&.ext\fR +\fBtype\&.baz => pkg2\&.fizz\fR +\fBtype2\&.baz\&.pkg => pkg2\&.fizz\&.pkg\fR + .fi .if n \{\ .RE .\} -パッケージ名\fIorg\fR、\fIorg\fR\&.o\fImg\fR、または\fIorg\&.omg\fRのサブパッケージは、変換できません。これらのパッケージ名を変換しようとすると、互換性のないコードが生成され、\fI\-pkgTranslate\fRの後の最初の引数としてそれらのパッケージを使用すると、エラーとして扱われます。 +パッケージ名\fBorg\fR、\fBorg\fR\&.o\fBmg\fR、または\fBorg\&.omg\fRのサブパッケージは、変換できません。これらのパッケージ名を変換しようとすると、互換性のないコードが生成され、\fB\-pkgTranslate\fRの後の最初の引数としてそれらのパッケージを使用すると、エラーとして扱われます。 .RE .PP \-skeletonName \fIxxx%yyy\fR .RS 4 -\fIxxx%yyy\fRが、スケルトンに名前を付けるパターンとして使用されます。デフォルトは次のとおりです。\fIPOA\fRベース・クラスの場合は\fI%POA\fR -(\fI\-fserver\fRまたは\fI\-fall\fR)、\fIoldImplBase\fRクラスの場合は\fI_%ImplBase\fR -(\-\fIoldImplBase\fR)および(\fI\-fserver\fRまたは\fI\-fall\fR))。 +\fBxxx%yyy\fRが、スケルトンに名前を付けるパターンとして使用されます。デフォルトは次のとおりです。\fBPOA\fRベース・クラスの場合は\fB%POA\fR +(\fB\-fserver\fRまたは\fB\-fall\fR)、\fBoldImplBase\fRクラスの場合は\fB_%ImplBase\fR +(\-\fBoldImplBase\fR)および(\fB\-fserver\fRまたは\fB\-fall\fR))。 .RE .PP \-td \fIdir\fR @@ -525,10 +519,10 @@ .PP \-tieName \fIxxx%yyy\fR .RS 4 -パターンに従って、\fIxxx%yyy\fRを使用します。デフォルトは次のとおりです。\fIPOA\fRベース・クラスの場合は\fI%POA\fR -(\fI\-fserverTieまたは\-fallTie\fR)、\fIoldImplBase\fR -tieクラスの場合は\fI_%Tie\fR -(\-\fIoldImplBase\fR)および(\fI\-fserverTie\fRまたは\fI\-fallTie\fR))。 +パターンに従って、\fBxxx%yyy\fRを使用します。デフォルトは次のとおりです。\fBPOA\fRベース・クラスの場合は\fB%POA\fR +(\fB\-fserverTieまたは\-fallTie\fR)、\fBoldImplBase\fR +tieクラスの場合は\fB_%Tie\fR +(\-\fBoldImplBase\fR)および(\fB\-fserverTie\fRまたは\fB\-fallTie\fR))。 .RE .PP \-nowarn、\-verbose @@ -542,13 +536,13 @@ .RE .SH "制限事項" .PP -グローバル・スコープ内のエスケープされた識別子は、IDLプリミティブ型の\fIObject\fRまたは\fIValueBase\fRと同じ綴りにしないでください。これは、シンボル表がこれらの識別子でプリロードされているためです。これらの再定義を許可すると、元の定義が上書きされます。これは、おそらく恒久的な制約です。 +グローバル・スコープ内のエスケープされた識別子は、IDLプリミティブ型の\fBObject\fRまたは\fBValueBase\fRと同じ綴りにしないでください。これは、シンボル表がこれらの識別子でプリロードされているためです。これらの再定義を許可すると、元の定義が上書きされます。これは、おそらく恒久的な制約です。 .PP -\fIfixed\fRというIDL型はサポートされていません。 +\fBfixed\fRというIDL型はサポートされていません。 .SH "既知の問題" .PP -グローバル識別子についてインポートが生成されません。予期されないローカル\fIimpl\fRオブジェクトを呼び出すと、例外を受け取ります。しかし、その原因は、\fIServerDelegate\fR -DSIコード内の\fINullPointerException\fRにあるようです。 +グローバル識別子についてインポートが生成されません。予期されないローカル\fBimpl\fRオブジェクトを呼び出すと、例外を受け取ります。しかし、その原因は、\fBServerDelegate\fR +DSIコード内の\fBNullPointerException\fRにあるようです。 .br 'pl 8.5i 'bp
--- a/src/linux/doc/man/ja/jar.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jar.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jar -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jar +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jar" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,72 +50,77 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jar \- Java Archive (JAR)ファイルを操作します。 .SH "概要" +.PP JARファイルの作成 .sp .if n \{\ .RS 4 .\} .nf -\fIjar c\fR[\fIefmMnv0\fR] [\fIentrypoint\fR] [\fIjarfile\fR] [\fImanifest\fR] [\fI\-C\fR \fIdir\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] +\fBjar c\fR[\fBefmMnv0\fR] [\fIentrypoint\fR] [\fIjarfile\fR] [\fImanifest\fR] [\fB\-C\fR \fIdir\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] .fi .if n \{\ .RE .\} +.PP JARファイルの更新 .sp .if n \{\ .RS 4 .\} .nf -\fIjar u\fR[\fIefmMnv0\fR] [\fIentrypoint\fR] [\fIjarfile\fR] [\fImanifest\fR] [\fI\-C\fR \fIdir\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] +\fBjar u\fR[\fBefmMnv0\fR] [\fIentrypoint\fR] [\fIjarfile\fR] [\fImanifest\fR] [\fB\-C\fR \fIdir\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] .fi .if n \{\ .RE .\} +.PP JARファイルの抽出 .sp .if n \{\ .RS 4 .\} .nf -\fIjar\fR \fIx\fR[\fIvf\fR] [\fIjarfile\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] +\fBjar\fR \fBx\fR[\fBvf\fR] [\fIjarfile\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] .fi .if n \{\ .RE .\} +.PP JARファイルのコンテンツのリスト .sp .if n \{\ .RS 4 .\} .nf -\fIjar\fR \fIt\fR[\fIvf\fR] [\fIjarfile\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] +\fBjar\fR \fBt\fR[\fBvf\fR] [\fIjarfile\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] .fi .if n \{\ .RE .\} +.PP JARファイルへの索引の追加 .sp .if n \{\ .RS 4 .\} .nf -\fIjar\fR \fIi\fR \fIjarfile\fR [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] +\fBjar\fR \fBi\fR \fIjarfile\fR [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] .fi .if n \{\ .RE .\} .SH "説明" .PP -\fIjar\fRコマンドは、ZIPおよびZLIB圧縮形式に基づく汎用のアーカイブおよび圧縮ツールです。ただし、\fIjar\fRコマンドは、主にいくつかのJavaアプレットやアプリケーションを単一のアーカイブにパッケージ化するように設計されました。アプレットやアプリケーションのコンポーネント(ファイル、イメージ、およびサウンド)が1つのアーカイブに結合されていると、Javaエージェント(ブラウザなど)は、それらのコンポーネントを1回のHTTPトランザクションでダウンロードすることができ、コンポーネントごとに新しい接続が不要になります。これにより、ダウンロード時間が大幅に短縮されます。また、\fIjar\fRコマンドはファイルの圧縮も行うため、ダウンロード時間がさらに短縮されます。また、\fIjar\fRコマンドによって、ファイル内の個々のエントリにアプレット作成者による署名を書き込めるため、配布元の認証が可能になります。JARファイルは、圧縮されているかどうかにかかわらず、クラス・パスのエントリとして使用できます。 +\fBjar\fRコマンドは、ZIPおよびZLIB圧縮形式に基づく汎用のアーカイブおよび圧縮ツールです。ただし、\fBjar\fRコマンドは、主にいくつかのJavaアプレットやアプリケーションを単一のアーカイブにパッケージ化するように設計されました。アプレットやアプリケーションのコンポーネント(ファイル、イメージ、およびサウンド)が1つのアーカイブに結合されていると、Javaエージェント(ブラウザなど)は、それらのコンポーネントを1回のHTTPトランザクションでダウンロードすることができ、コンポーネントごとに新しい接続が不要になります。これにより、ダウンロード時間が大幅に短縮されます。また、\fBjar\fRコマンドはファイルの圧縮も行うため、ダウンロード時間がさらに短縮されます。また、\fBjar\fRコマンドによって、ファイル内の個々のエントリにアプレット作成者による署名を書き込めるため、配布元の認証が可能になります。JARファイルは、圧縮されているかどうかにかかわらず、クラス・パスのエントリとして使用できます。 .PP -\fIjar\fRコマンドの構文は、\fItar\fRコマンドの構文に似ています。必須の\fI操作の引数\fRの1つで定義された複数の操作モードがあります。他の引数は、操作の動作を変更する\fIオプション\fR、または操作を実行するために必要な\fIオペランド\fRを使用します。 +\fBjar\fRコマンドの構文は、\fBtar\fRコマンドの構文に似ています。必須の\fI操作の引数\fRの1つで定義された複数の操作モードがあります。他の引数は、操作の動作を変更する\fIオプション\fR、または操作を実行するために必要な\fIオペランド\fRを使用します。 .SH "操作の引数" .PP -\fIjar\fRコマンドを使用する場合は、次の操作の引数のいずれかを指定して実行される操作を選択する必要があります。コマンドラインで他の1文字のオプションと混在させることができますが、通常、操作の引数は指定される最初の引数です。 +\fBjar\fRコマンドを使用する場合は、次の操作の引数のいずれかを指定して実行される操作を選択する必要があります。コマンド行で他の1文字のオプションと混在させることができますが、通常、操作の引数は指定される最初の引数です。 .PP c .RS 4 @@ -145,15 +152,16 @@ .PP e .RS 4 -\fIentrypoint\fRオペランドで指定されるクラスを、実行可能JARファイルにバンドルされるスタンドアロンJavaアプリケーションのエントリ・ポイントに設定します。このオプションを使用すると、マニフェスト・ファイル内の\fIMain\-Class\fR属性値が作成またはオーバーライドされます。\fIe\fRオプションは、JARファイルの作成時(\fIc\fR)または更新時(\fIu\fR)に使用できます。 +\fIentrypoint\fRオペランドで指定されるクラスを、実行可能JARファイルにバンドルされるスタンドアロンJavaアプリケーションのエントリ・ポイントに設定します。このオプションを使用すると、マニフェスト・ファイル内の\fBMain\-Class\fR属性値が作成またはオーバーライドされます。\fBe\fRオプションは、JARファイルの作成時(\fBc\fR)または更新時(\fBu\fR)に使用できます。 .sp -たとえば、次のコマンドでは、\fIMain\&.jar\fRアーカイブが\fIMain\&.class\fRファイルとともに作成されますが、その際、マニフェスト内の\fIMain\-Class\fR属性値は\fIMain\fRに設定されます。 +たとえば、次のコマンドでは、\fBMain\&.jar\fRアーカイブが\fBMain\&.class\fRファイルとともに作成されますが、その際、マニフェスト内の\fBMain\-Class\fR属性値は\fBMain\fRに設定されます。 .sp .if n \{\ .RS 4 .\} .nf -jar cfe Main\&.jar Main Main\&.class +\fBjar cfe Main\&.jar Main Main\&.class\fR + .fi .if n \{\ .RE @@ -164,19 +172,21 @@ .RS 4 .\} .nf -java \-jar Main\&.jar +\fBjava \-jar Main\&.jar\fR + .fi .if n \{\ .RE .\} -あるパッケージ内にエントリ・ポイントのクラス名が含まれている場合、ドット(\&.)またはスラッシュ(/)のいずれかを区切り文字として使用できます。たとえば、\fIMain\&.class\fRが\fImydir\fRという名前のパッケージに含まれている場合、エントリ・ポイントは次のいずれかの方法で指定できます。 +あるパッケージ内にエントリ・ポイントのクラス名が含まれている場合、ドット(\&.)またはスラッシュ(/)のいずれかを区切り文字として使用できます。たとえば、\fBMain\&.class\fRが\fBmydir\fRという名前のパッケージに含まれている場合、エントリ・ポイントは次のいずれかの方法で指定できます。 .sp .if n \{\ .RS 4 .\} .nf -jar \-cfe Main\&.jar mydir/Main mydir/Main\&.class -jar \-cfe Main\&.jar mydir\&.Main mydir/Main\&.class +\fBjar \-cfe Main\&.jar mydir/Main mydir/Main\&.class\fR +\fBjar \-cfe Main\&.jar mydir\&.Main mydir/Main\&.class\fR + .fi .if n \{\ .RE @@ -190,7 +200,7 @@ .nr an-break-flag 1 .br .ps +1 -\fBNote\fR +\fB注記\fR .ps -1 .br .TS @@ -198,7 +208,7 @@ l. T{ 注意 -特定のマニフェストにも\fIMain\-Class\fR属性が含まれている場合に\fIm\fRオプションと\fIe\fRオプションの両方を同時に指定すると、\fIMain\-Class\fRの指定があいまいになります。このあいまいさによってエラーが発生し、\fIjar\fRコマンドの作成や更新の操作が終了します。 +特定のマニフェストにも\fBMain\-Class\fR属性が含まれている場合に\fBm\fRオプションと\fBe\fRオプションの両方を同時に指定すると、\fBMain\-Class\fRの指定があいまいになります。このあいまいさによってエラーが発生し、\fBjar\fRコマンドの作成や更新の操作が終了します。 T} .TE .sp 1 @@ -208,26 +218,26 @@ .PP f .RS 4 -\fIjarfile\fRオペランドで指定されたファイルを、作成(\fIc\fR)、更新(\fIu\fR)、抽出(\fIx\fR)または表示(\fIt\fR)されるJARファイルの名前に設定します。\fIf\fRオプションおよび\fIjarfile\fRオペランドを省略すると、\fIjar\fRコマンドに、\fIstdin\fRからのJARファイル名を受け入れるか(\fIx\fRおよび\fIt\fRの場合)、JARファイルを\fIstdout\fRに送信すること(\fIc\fRおよび\fIu\fRの場合)が指示されます。 +\fIjarfile\fRオペランドで指定されたファイルを、作成(\fBc\fR)、更新(\fBu\fR)、抽出(\fBx\fR)または表示(\fBt\fR)されるJARファイルの名前に設定します。\fBf\fRオプションおよび\fIjarfile\fRオペランドを省略すると、\fBjar\fRコマンドに、\fBstdin\fRからのJARファイル名を受け入れるか(\fBx\fRおよび\fBt\fRの場合)、JARファイルを\fBstdout\fRに送信すること(\fBc\fRおよび\fBu\fRの場合)が指示されます。 .RE .PP m .RS 4 -(\fIMETA\-INF/MANIFEST\&.MF\fRのアーカイブにある) -\fIjar\fRコマンドのマニフェスト・ファイルの\fImanifest\fRオペランドで指定されたファイルから、属性の名前と値のペアを含めます。\fIjar\fRコマンドは、同じ名前のエントリがすでに存在する場合を除き、属性の名前と値をJARファイルに追加します。同じ名前のエントリがすでに存在する場合、\fIjar\fRコマンドは属性の値を更新します。\fIm\fRオプションは、JARファイルの作成時(\fIc\fR)または更新時(\fIu\fR)に使用できます。 +(\fBMETA\-INF/MANIFEST\&.MF\fRのアーカイブにある) +\fBjar\fRコマンドのマニフェスト・ファイルの\fBmanifest\fRオペランドで指定されたファイルから、属性の名前と値のペアを含めます。\fBjar\fRコマンドは、同じ名前のエントリがすでに存在する場合を除き、属性の名前と値をJARファイルに追加します。同じ名前のエントリがすでに存在する場合、\fBjar\fRコマンドは属性の値を更新します。\fBm\fRオプションは、JARファイルの作成時(\fBc\fR)または更新時(\fBu\fR)に使用できます。 .sp -デフォルトのマニフェスト・ファイルには含まれないマニフェストに、特別な目的の名前\-値の属性ペアを追加できます。たとえば、ベンダー情報、リリース情報、パッケージ・シーリングを指定する属性、またはJARにバンドルされたアプリケーションを実行可能にするための属性を追加できます。\fIm\fRオプションの使用例は、http://docs\&.oracle\&.com/javase/tutorial/deployment/jar/index\&.htmlにある +デフォルトのマニフェスト・ファイルには含まれないマニフェストに、特別な目的の名前\-値の属性ペアを追加できます。たとえば、ベンダー情報、リリース情報、パッケージ・シーリングを指定する属性、またはJARにバンドルされたアプリケーションを実行可能にするための属性を追加できます。\fBm\fRオプションの使用例は、http://docs\&.oracle\&.com/javase/tutorial/deployment/jar/index\&.htmlにある プログラムのパッケージ化に関する項を参照してください。 .RE .PP M .RS 4 -マニフェスト・ファイル・エントリを作成しない(\fIc\fRおよび\fIu\fRの場合)か、またはマニフェスト・ファイル・エントリが存在する場合は削除します(\fIu\fRの場合)。\fIM\fRオプションは、JARファイルの作成時(\fIc\fR)または更新時(\fIu\fR)に使用できます。 +マニフェスト・ファイル・エントリを作成しない(\fBc\fRおよび\fBu\fRの場合)か、またはマニフェスト・ファイル・エントリが存在する場合は削除します(\fBu\fRの場合)。\fBM\fRオプションは、JARファイルの作成時(\fBc\fR)または更新時(\fBu\fR)に使用できます。 .RE .PP n .RS 4 -JARファイルの作成(\fIc\fR)時に、このオプションは、コンテンツがpack200(1)コマンドのパックおよびアンパック操作の影響を受けないようにアーカイブを正規化します。この正規化を使用しない場合、署名付きJARの署名は無効になります。 +JARファイルの作成(\fBc\fR)時に、このオプションは、コンテンツがpack200(1)コマンドのパックおよびアンパック操作の影響を受けないようにアーカイブを正規化します。この正規化を使用しない場合、署名付きJARの署名は無効になります。 .RE .PP v @@ -237,46 +247,48 @@ .PP 0 .RS 4 -(ゼロ) ZIP圧縮を使用しないでJARファイルを作成(\fIc\fR)または更新(\fIu\fR)します。 +(ゼロ) ZIP圧縮を使用しないでJARファイルを作成(\fBc\fR)または更新(\fBu\fR)します。 .RE .PP \-C \fIdir\fR .RS 4 -JARファイルの作成(\fIc\fR)または更新(\fIu\fR)時に、このオプションは\fIfile\fRオペランドで指定されたファイルの処理中にディレクトリを一時的に変更します。この操作は、UNIX -\fItar\fRユーティリティの\fI\-C\fRオプションと同様になることを目的としています。たとえば、次のコマンドによって、\fIclasses\fRディレクトリに変更され、そのディレクトリから\fImy\&.jar\fRに\fIBar\&.class\fRファイルが追加されます。 +JARファイルの作成(\fBc\fR)または更新(\fBu\fR)時に、このオプションは\fIfile\fRオペランドで指定されたファイルの処理中にディレクトリを一時的に変更します。この操作は、\fBtar\fRユーティリティの\fB\-C\fRオプションと同様になることを目的としています。たとえば、次のコマンドによって、\fBclasses\fRディレクトリに変更され、そのディレクトリから\fBmy\&.jar\fRに\fBBar\&.class\fRファイルが追加されます。 .sp .if n \{\ .RS 4 .\} .nf -jar uf my\&.jar \-C classes Bar\&.class +\fBjar uf my\&.jar \-C classes Bar\&.class\fR + .fi .if n \{\ .RE .\} -次のコマンドでは、\fIclasses\fRディレクトリに移動し、classesディレクトリ内のすべてのファイルを\fImy\&.jar\fRに追加します(JARファイルには\fIclasses\fRディレクトリを作成しません)。次に元のディレクトリに戻ってから、\fIbin\fRディレクトリに移動し、\fIXyz\&.class\fRを\fImy\&.jar\fRに追加します。 +次のコマンドでは、\fBclasses\fRディレクトリに移動し、classesディレクトリ内のすべてのファイルを\fBmy\&.jar\fRに追加します(JARファイルには\fBclasses\fRディレクトリを作成しません)。次に元のディレクトリに戻ってから、\fBbin\fRディレクトリに移動し、\fBXyz\&.class\fRを\fBmy\&.jar\fRに追加します。 .sp .if n \{\ .RS 4 .\} .nf -jar uf my\&.jar \-C classes \&. \-C bin Xyz\&.class +\fBjar uf my\&.jar \-C classes \&. \-C bin Xyz\&.class\fR + .fi .if n \{\ .RE .\} -\fIclasses\fRに\fIbar1\fRファイルと\fIbar2\fRファイルが含まれている場合、前述のコマンドを実行した後、JARファイルには次のものが含まれます。 +\fBclasses\fRに\fBbar1\fRファイルと\fBbar2\fRファイルが含まれている場合、前述のコマンドを実行した後、JARファイルには次のものが含まれます。 .sp .if n \{\ .RS 4 .\} .nf -% \fIjar tf my\&.jar\fR -META\-INF/ -META\-INF/MANIFEST\&.MF -bar1 -bar2 -Xyz\&.class +\fB% \fR\fB\fBjar tf my\&.jar\fR\fR +\fBMETA\-INF/\fR +\fBMETA\-INF/MANIFEST\&.MF\fR +\fBbar1\fR +\fBbar2\fR +\fBXyz\&.class\fR + .fi .if n \{\ .RE @@ -285,69 +297,72 @@ .PP \-J\fIoption\fR .RS 4 -指定したJVMオプションを、JREがJARファイルを実行する際に使用するように設定します。JVMオプションは、java(1)コマンドのリファレンス・ページで説明されています。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。 +指定したJVMオプションを、JREがJARファイルを実行する際に使用するように設定します。JVMオプションは、java(1)コマンドのリファレンス・ページで説明されています。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。 .RE .SH "オペランド" .PP -次のオペランドは、\fIjar\fRコマンドで認識されます。 +次のオペランドは、\fBjar\fRコマンドで認識されます。 .PP \fIfile\fR .RS 4 -JARファイルの作成(\fIc\fR)または更新(\fIu\fR)時に、\fIfile\fRオペランドは、アーカイブに追加する必要のあるファイルまたはディレクトリのパスと名前を定義します。JARファイルの抽出(\fIx\fR)またはコンテンツのリスト(\fIt\fR)時に、\fIfile\fRオペランドは抽出またはリストするファイルのパスと名前を定義します。少なくとも1つの有効なファイルまたはディレクトリを指定する必要があります。複数の\fIfile\fRオペランドを空白で区切ります。\fIentrypoint\fR、\fIjarfile\fRまたは\fImanifest\fRオペランドが使用される場合は、その後に\fIfile\fRオペランドを指定する必要があります。 +JARファイルの作成(\fBc\fR)または更新(\fBu\fR)時に、\fIfile\fRオペランドは、アーカイブに追加する必要のあるファイルまたはディレクトリのパスと名前を定義します。JARファイルの抽出(\fBx\fR)またはコンテンツのリスト(\fBt\fR)時に、\fIfile\fRオペランドは抽出またはリストするファイルのパスと名前を定義します。少なくとも1つの有効なファイルまたはディレクトリを指定する必要があります。複数の\fIfile\fRオペランドを空白で区切ります。\fIentrypoint\fR、\fIjarfile\fRまたは\fImanifest\fRオペランドが使用される場合は、その後に\fIfile\fRオペランドを指定する必要があります。 .RE .PP \fIentrypoint\fR .RS 4 -JARファイルの作成(\fIc\fR)または更新(\fIu\fR)時に、\fIentrypoint\fRオペランドは、実行可能JARファイルにバンドルされているスタンドアロンJavaアプリケーションのエントリ・ポイントとなるクラスの名前を定義します。\fIe\fRオプションが存在する場合は\fIentrypoint\fRオペランドを指定する必要があります。 +JARファイルの作成(\fBc\fR)または更新(\fBu\fR)時に、\fIentrypoint\fRオペランドは、実行可能JARファイルにバンドルされているスタンドアロンJavaアプリケーションのエントリ・ポイントとなるクラスの名前を定義します。\fBe\fRオプションが存在する場合は\fIentrypoint\fRオペランドを指定する必要があります。 .RE .PP \fIjarfile\fR .RS 4 -作成(\fIc\fR)、更新(\fIu\fR)、抽出(\fIx\fR)または表示(\fIt\fR)するファイルの名前を定義します。\fIf\fRオプションが存在する場合は\fIjarfile\fRオペランドを指定する必要があります。\fIf\fRオプションおよび\fIjarfile\fRオペランドを省略すると、\fIjar\fRコマンドに、\fIstdin\fRからのJARファイル名を受け入れるか(\fIx\fRおよび\fIt\fRの場合)、JARファイルを\fIstdout\fRに送信すること(\fIc\fRおよび\fIu\fRの場合)が指示されます。 +作成(\fBc\fR)、更新(\fBu\fR)、抽出(\fBx\fR)または表示(\fBt\fR)するファイルの名前を定義します。\fBf\fRオプションが存在する場合は\fIjarfile\fRオペランドを指定する必要があります。\fBf\fRオプションおよび\fIjarfile\fRオペランドを省略すると、\fBjar\fRコマンドに、\fBstdin\fRからのJARファイル名を受け入れるか(\fBx\fRおよび\fBt\fRの場合)、JARファイルを\fBstdout\fRに送信すること(\fBc\fRおよび\fBu\fRの場合)が指示されます。 .sp -JARファイルを索引付け(\fIi\fR)する場合は、\fIf\fRオプションを指定しないで\fIjarfile\fRオペランドを指定します。 +JARファイルを索引付け(\fBi\fR)する場合は、\fBf\fRオプションを指定しないで\fIjarfile\fRオペランドを指定します。 .RE .PP \fImanifest\fR .RS 4 -JARファイルの作成(\fIc\fR)または更新(\fIu\fR)時に、\fImanifest\fRオペランドはJARファイルの\fIMANIFEST\&.MF\fRに含める属性の名前と値を持つ既存のマニフェスト・ファイルを定義します。\fIf\fRオプションが存在する場合は\fImanifest\fRオペランドを指定する必要があります。 +JARファイルの作成(\fBc\fR)または更新(\fBu\fR)時に、\fImanifest\fRオペランドはJARファイルの\fBMANIFEST\&.MF\fRに含める属性の名前と値を持つ既存のマニフェスト・ファイルを定義します。\fBf\fRオプションが存在する場合は\fImanifest\fRオペランドを指定する必要があります。 .RE .PP \fI@arg\-file\fR .RS 4 -\fIjar\fRコマンドを短縮または簡素化するには、別のテキスト・ファイル内の引数を指定し、接頭辞としてアットマーク(@)を付けて\fIjar\fRコマンドに渡すことができます。\fIjar\fRコマンドは、アットマーク文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 +\fBjar\fRコマンドを短縮または簡素化するには、別のテキスト・ファイル内の引数を指定し、接頭辞としてアットマーク(@)を付けて\fBjar\fRコマンドに渡すことができます。\fBjar\fRコマンドは、アットマーク文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 .sp -引数ファイルには、\fIjar\fRコマンドのオプションと引数(引数ファイルをサポートしない起動ツールに渡される\fI\-J\fRオプションを除く)を含めることができます。ファイル内の引数は、空白または改行文字で区切ることができます。引数ファイル内のファイル名は、\fIjar\fRコマンドを実行できる現在のディレクトリに対して相対的であり、引数ファイルの場所に対しては相対的ではありません。通常はオペレーティング・システム・シェルによって展開されるアスタリスク(*)などのワイルドカードは展開されません。 +引数ファイルには、\fBjar\fRコマンドのオプションと引数(引数ファイルをサポートしない起動ツールに渡される\fB\-J\fRオプションを除く)を含めることができます。ファイル内の引数は、空白または改行文字で区切ることができます。引数ファイル内のファイル名は、\fBjar\fRコマンドを実行できる現在のディレクトリに対して相対的であり、引数ファイルの場所に対しては相対的ではありません。通常はオペレーティング・システム・シェルによって展開されるアスタリスク(*)などのワイルドカードは展開されません。 .sp -次の例は、\fIfind\fRコマンドによる現在のディレクトリ出力からのファイル名で\fIclasses\&.list\fRファイルを作成する方法を示します。 +次の例は、\fBfind\fRコマンドによる現在のディレクトリ出力からのファイル名で\fBclasses\&.list\fRファイルを作成する方法を示します。 .sp .if n \{\ .RS 4 .\} .nf -find \&. \-name \*(Aq*\&.class\*(Aq \-print > classes\&.list +\fBfind \&. \-name \*(Aq*\&.class\*(Aq \-print > classes\&.list\fR + .fi .if n \{\ .RE .\} -\fIjar\fRコマンドを実行し、\fI@arg\-file\fR構文を使用して\fIclasses\&.list\fRファイルを渡すことができます。 +\fBjar\fRコマンドを実行し、\fI@arg\-file\fR構文を使用して\fBclasses\&.list\fRファイルを渡すことができます。 .sp .if n \{\ .RS 4 .\} .nf -jar cf my\&.jar @classes\&.list +\fBjar cf my\&.jar @classes\&.list\fR + .fi .if n \{\ .RE .\} -引数ファイルはパスを指定できますが、相対パスが記述された引数ファイル内のすべてのファイル名は、渡されたパスに対して相対的ではなく、\fIjar\fRコマンドの現在の作業ディレクトリに相対的となります。たとえば、次のようになります。 +引数ファイルはパスを指定できますが、相対パスが記述された引数ファイル内のすべてのファイル名は、渡されたパスに対して相対的ではなく、\fBjar\fRコマンドの現在の作業ディレクトリに相対的となります。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -jar @dir/classes\&.list +\fBjar @dir/classes\&.list\fR + .fi .if n \{\ .RE @@ -355,86 +370,95 @@ .RE .SH "注意" .PP -\fIe\fR、\fIf\fRおよび\fIm\fRオプションは、\fIentrypoint\fR、\fIjarfile\fRおよび\fImanifest\fRオペランドと同じ順序でコマンドラインに出現する必要があります。 +\fBe\fR、\fBf\fRおよび\fBm\fRオプションは、\fIentrypoint\fR、\fIjarfile\fRおよび\fImanifest\fRオペランドと同じ順序でコマンド行に出現する必要があります。 .sp .if n \{\ .RS 4 .\} .nf -jar cmef myManifestFile MyMainClass myFile\&.jar *\&.class +\fBjar cmef myManifestFile MyMainClass myFile\&.jar *\&.class\fR + .fi .if n \{\ .RE .\} .SH "例" .PP -\fBExample 1\fR, 冗長な出力による現在のディレクトリからのすべてのファイルの追加 +\fB例 1\fR +.br +冗長な出力による現在のディレクトリからのすべてのファイルの追加 .RS 4 .sp .if n \{\ .RS 4 .\} .nf -% ls -1\&.au Animator\&.class monkey\&.jpg -2\&.au Wave\&.class spacemusic\&.au -3\&.au at_work\&.gif - -% jar cvf bundle\&.jar * -added manifest -adding: 1\&.au(in = 2324) (out= 67)(deflated 97%) -adding: 2\&.au(in = 6970) (out= 90)(deflated 98%) -adding: 3\&.au(in = 11616) (out= 108)(deflated 99%) -adding: Animator\&.class(in = 2266) (out= 66)(deflated 97%) -adding: Wave\&.class(in = 3778) (out= 81)(deflated 97%) -adding: at_work\&.gif(in = 6621) (out= 89)(deflated 98%) -adding: monkey\&.jpg(in = 7667) (out= 91)(deflated 98%) -adding: spacemusic\&.au(in = 3079) (out= 73)(deflated 97%) +\fB% ls\fR +\fB1\&.au Animator\&.class monkey\&.jpg\fR +\fB2\&.au Wave\&.class spacemusic\&.au\fR +\fB3\&.au at_work\&.gif\fR + +\fB% jar cvf bundle\&.jar *\fR +\fBadded manifest\fR +\fBadding: 1\&.au(in = 2324) (out= 67)(deflated 97%)\fR +\fBadding: 2\&.au(in = 6970) (out= 90)(deflated 98%)\fR +\fBadding: 3\&.au(in = 11616) (out= 108)(deflated 99%)\fR +\fBadding: Animator\&.class(in = 2266) (out= 66)(deflated 97%)\fR +\fBadding: Wave\&.class(in = 3778) (out= 81)(deflated 97%)\fR +\fBadding: at_work\&.gif(in = 6621) (out= 89)(deflated 98%)\fR +\fBadding: monkey\&.jpg(in = 7667) (out= 91)(deflated 98%)\fR +\fBadding: spacemusic\&.au(in = 3079) (out= 73)(deflated 97%)\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 2\fR, サブディレクトリからのファイルの追加 +\fB例 2\fR +.br +サブディレクトリからのファイルの追加 .RS 4 .sp .if n \{\ .RS 4 .\} .nf -% ls \-F -audio/ classes/ images/ -% jar cvf bundle\&.jar audio classes images -added manifest -adding: audio/(in = 0) (out= 0)(stored 0%) -adding: audio/1\&.au(in = 2324) (out= 67)(deflated 97%) -adding: audio/2\&.au(in = 6970) (out= 90)(deflated 98%) -adding: audio/3\&.au(in = 11616) (out= 108)(deflated 99%) -adding: audio/spacemusic\&.au(in = 3079) (out= 73)(deflated 97%) -adding: classes/(in = 0) (out= 0)(stored 0%) -adding: classes/Animator\&.class(in = 2266) (out= 66)(deflated 97%) -adding: classes/Wave\&.class(in = 3778) (out= 81)(deflated 97%) -adding: images/(in = 0) (out= 0)(stored 0%) -adding: images/monkey\&.jpg(in = 7667) (out= 91)(deflated 98%) -adding: images/at_work\&.gif(in = 6621) (out= 89)(deflated 98%) - -% ls \-F -audio/ bundle\&.jar classes/ images/ +\fB% ls \-F\fR +\fBaudio/ classes/ images/\fR +\fB% jar cvf bundle\&.jar audio classes images\fR +\fBadded manifest\fR +\fBadding: audio/(in = 0) (out= 0)(stored 0%)\fR +\fBadding: audio/1\&.au(in = 2324) (out= 67)(deflated 97%)\fR +\fBadding: audio/2\&.au(in = 6970) (out= 90)(deflated 98%)\fR +\fBadding: audio/3\&.au(in = 11616) (out= 108)(deflated 99%)\fR +\fBadding: audio/spacemusic\&.au(in = 3079) (out= 73)(deflated 97%)\fR +\fBadding: classes/(in = 0) (out= 0)(stored 0%)\fR +\fBadding: classes/Animator\&.class(in = 2266) (out= 66)(deflated 97%)\fR +\fBadding: classes/Wave\&.class(in = 3778) (out= 81)(deflated 97%)\fR +\fBadding: images/(in = 0) (out= 0)(stored 0%)\fR +\fBadding: images/monkey\&.jpg(in = 7667) (out= 91)(deflated 98%)\fR +\fBadding: images/at_work\&.gif(in = 6621) (out= 89)(deflated 98%)\fR + +\fB% ls \-F\fR +\fBaudio/ bundle\&.jar classes/ images/\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, JARのコンテンツのリスト +\fB例 3\fR +.br +JARのコンテンツのリスト .RS 4 .sp .if n \{\ .RS 4 .\} .nf -% jar tf bundle\&.jar +\fB% jar tf bundle\&.jar\fR .fi .if n \{\ .RE @@ -444,45 +468,50 @@ .RS 4 .\} .nf -META\-INF/ -META\-INF/MANIFEST\&.MF -audio/1\&.au -audio/2\&.au -audio/3\&.au -audio/spacemusic\&.au -classes/Animator\&.class -classes/Wave\&.class -images/monkey\&.jpg -images/at_work\&.gif +\fBMETA\-INF/\fR +\fBMETA\-INF/MANIFEST\&.MF\fR +\fBaudio/1\&.au\fR +\fBaudio/2\&.au\fR +\fBaudio/3\&.au\fR +\fBaudio/spacemusic\&.au\fR +\fBclasses/Animator\&.class\fR +\fBclasses/Wave\&.class\fR +\fBimages/monkey\&.jpg\fR +\fBimages/at_work\&.gif\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 4\fR, 索引の追加 +\fB例 4\fR +.br +索引の追加 .RS 4 -株式取引のアプリケーションの相互依存クラスを、\fImain\&.jar\fR、\fIbuy\&.jar\fRおよび\fIsell\&.jar\fRの3つのJARファイルに分割する場合、\fIi\fRオプションを使用します。\fImain\&.jar\fRマニフェスト内の\fIClass\-Path\fR属性を指定する場合、\fIi\fRオプションを使用して、アプリケーションのクラス・ロードの速度を向上できます。 +株式取引のアプリケーションの相互依存クラスを、\fBmain\&.jar\fR、\fBbuy\&.jar\fRおよび\fBsell\&.jar\fRの3つのJARファイルに分割する場合、\fBi\fRオプションを使用します。\fBmain\&.jar\fRマニフェスト内の\fBClass\-Path\fR属性を指定する場合、\fBi\fRオプションを使用して、アプリケーションのクラス・ロードの速度を向上できます。 .sp .if n \{\ .RS 4 .\} .nf -Class\-Path: buy\&.jar sell\&.jar -jar i main\&.jar +\fBClass\-Path: buy\&.jar sell\&.jar\fR +\fBjar i main\&.jar\fR + .fi .if n \{\ .RE .\} -\fIINDEX\&.LIST\fRファイルが\fIMETA\-INF\fRディレクトリに挿入されます。これにより、アプリケーションのクラス・ローダーによってクラスまたはリソースの検索が行われるときに、指定したJARファイルがダウンロードされるようになります。 +\fBINDEX\&.LIST\fRファイルが\fBMETA\-INF\fRディレクトリに挿入されます。これにより、アプリケーションのクラス・ローダーによってクラスまたはリソースの検索が行われるときに、指定したJARファイルがダウンロードされるようになります。 .sp -アプリケーションのクラス・ローダーは、このファイルに格納されている情報を使用して、効率的にクラスをロードします。ディレクトリをコピーするには、最初に\fIdir1\fR内のファイルを\fIstdout\fRに圧縮してから、\fIstdin\fRから\fIdir2\fRにパイプラインを作成して抽出します(\fI\-f\fRオプションは両方の\fIjar\fRコマンドで省略します)。 +アプリケーションのクラス・ローダーは、このファイルに格納されている情報を使用して、効率的にクラスをロードします。ディレクトリをコピーするには、最初に\fBdir1\fR内のファイルを\fBstdout\fRに圧縮してから、\fBstdin\fRから\fBdir2\fRにパイプラインを作成して抽出します(\fB\-f\fRオプションは両方の\fBjar\fRコマンドで省略します)。 .sp .if n \{\ .RS 4 .\} .nf -(cd dir1; jar c \&.) | (cd dir2; jar x) +\fB(cd dir1; jar c \&.) | (cd dir2; jar x)\fR + .fi .if n \{\ .RE
--- a/src/linux/doc/man/ja/jarsigner.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jarsigner.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jarsigner -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: セキュリティ・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jarsigner +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: セキュリティ・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jarsigner" "1" "2013年11月21日" "JDK 8" "セキュリティ・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jarsigner \- Javaアーカイブ(JAR)ファイルに対して署名および検証を行います。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjarsigner\fR [ \fIoptions\fR ] \fIjar\-file\fR \fIalias\fR +\fBjarsigner\fR [ \fIoptions\fR ] \fIjar\-file\fR \fIalias\fR .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjarsigner\fR \fI\-verify\fR [ \fIoptions\fR ] \fIjar\-file\fR [\fIalias \&.\&.\&.\fR] +\fBjarsigner\fR \fB\-verify\fR [ \fIoptions\fR ] \fIjar\-file\fR [\fIalias \&.\&.\&.\fR] .fi .if n \{\ .RE @@ -74,30 +76,30 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \-verify .RS 4 -\fI\-verify\fRオプションでは、JARファイル名の後に0個以上のキーストア別名を指定できます。\fI\-verify\fRオプションが指定された場合、\fIjarsigner\fRコマンドでは、JARファイル内の各署名付きエンティティの検証に使用される証明書が、いずれかのキーストア別名に一致することをチェックします。別名は、\fI\-keystore\fRで指定されたキーストア内またはデフォルトのキーストア内に定義されます。 +\fB\-verify\fRオプションでは、JARファイル名の後に0個以上のキーストア別名を指定できます。\fB\-verify\fRオプションが指定された場合、\fBjarsigner\fRコマンドでは、JARファイル内の各署名付きエンティティの検証に使用される証明書が、いずれかのキーストア別名に一致することをチェックします。別名は、\fB\-keystore\fRで指定されたキーストア内またはデフォルトのキーストア内に定義されます。 .sp -\fI\-strict\fRオプションも指定した場合、\fIjarsigner\fRコマンドにより重大な警告が検出されると、メッセージ「jarが検証されました。署名者エラー」が表示されます。 +\fB\-strict\fRオプションも指定した場合、\fBjarsigner\fRコマンドにより重大な警告が検出されると、メッセージ「jarが検証されました。署名者エラー」が表示されます。 .RE .PP \fIjar\-file\fR .RS 4 署名されるJARファイル。 .sp -\fI\-strict\fRオプションも指定した場合、\fIjarsigner\fRコマンドにより重大な警告が検出されると、メッセージ「jarは署名されました \- 署名者エラーがあります。」というメッセージが表示されます。 +\fB\-strict\fRオプションも指定した場合、\fBjarsigner\fRコマンドにより重大な警告が検出されると、メッセージ「jarは署名されました \- 署名者エラーがあります。」というメッセージが表示されます。 .RE .PP \fIalias\fR .RS 4 -別名は、\fI\-keystore\fRで指定されたキーストア内またはデフォルトのキーストア内に定義されます。 +別名は、\fB\-keystore\fRで指定されたキーストア内またはデフォルトのキーストア内に定義されます。 .RE .SH "説明" .PP -\fIjarsigner\fRツールには、次の2つの目的があります。 +\fBjarsigner\fRツールには、次の2つの目的があります。 .sp .RS 4 .ie n \{\ @@ -121,7 +123,7 @@ 署名付きJARファイルの署名と整合性を検証する目的。 .RE .PP -JAR機能を使用すると、クラス・ファイル、イメージ、サウンドおよびその他のデジタル・データを単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。\fIjar\fRという名前のツールを使用して、開発者はJARファイルを作成できます。(技術的な観点から言えば、すべてのZIPファイルもJARファイルとみなすことができます。ただし、\fIjar\fRコマンドによって作成されたJARファイル、または\fIjarsigner\fRコマンドによって処理されたJARファイルには、\fIMETA\-INF/MANIFEST\&.MF\fRファイルも含まれています。) +JAR機能を使用すると、クラス・ファイル、イメージ、サウンドおよびその他のデジタル・データを単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。\fBjar\fRという名前のツールを使用して、開発者はJARファイルを作成できます。(技術的な観点から言えば、すべてのZIPファイルもJARファイルとみなすことができます。ただし、\fBjar\fRコマンドによって作成されたJARファイル、または\fBjarsigner\fRコマンドによって処理されたJARファイルには、\fBMETA\-INF/MANIFEST\&.MF\fRファイルも含まれています。) .PP デジタル署名は、なんらかのデータ(署名の対象となるデータ)、およびエンティティ(人、会社など)の秘密鍵から計算されるビットの文字列です。手書きの署名同様、デジタル署名には多くの利点があります。 .sp @@ -171,97 +173,101 @@ .PP ファイルに対してエンティティの署名を生成するには、まず、エンティティは、そのエンティティに関連する公開鍵/秘密鍵のペアと、公開鍵を認証する1つ以上の証明書を持つ必要があります。証明書とは、あるエンティティからのデジタル署名付きの文書で、別のエンティティの公開鍵が特定の値を持つことを示しています。 .PP -\fIjarsigner\fRコマンドは、キーストアからの鍵と証明書情報を使用して、JARファイルのデジタル署名を生成します。キーストアは、秘密鍵、および対応する公開鍵を認証する、秘密鍵に関連したX\&.509証明書チェーンのデータベースです。\fIkeytool\fRコマンドを使用して、キーストアを作成および管理します。 +\fBjarsigner\fRコマンドは、キーストアからの鍵と証明書情報を使用して、JARファイルのデジタル署名を生成します。キーストアは、秘密鍵、および対応する公開鍵を認証する、秘密鍵に関連したX\&.509証明書チェーンのデータベースです。\fBkeytool\fRコマンドを使用して、キーストアを作成および管理します。 .PP -\fIjarsigner\fRコマンドでは、エンティティの秘密鍵を使用して署名を生成します。署名付きJARファイルには、特に、ファイルへの署名に使用する秘密鍵に対応する公開鍵のキーストアからの証明書のコピーが含まれます。\fIjarsigner\fRコマンドでは、内部(署名ブロック・ファイル内)の証明書を使用して、署名付きJARファイルのデジタル署名を検証できます。 +\fBjarsigner\fRコマンドでは、エンティティの秘密鍵を使用して署名を生成します。署名付きJARファイルには、特に、ファイルへの署名に使用する秘密鍵に対応する公開鍵のキーストアからの証明書のコピーが含まれます。\fBjarsigner\fRコマンドでは、内部(署名ブロック・ファイル内)の証明書を使用して、署名付きJARファイルのデジタル署名を検証できます。 .PP -\fIjarsigner\fRコマンドでは、署名証明書の有効期間中にJARファイルが署名されたされたかどうかをシステムやデプロイヤ(Java Plug\-inを含む)がチェックできる、タイムスタンプを含む署名を生成できます。さらに、APIを使用すると、アプリケーションでタイムスタンプ情報を取得できます。 +\fBjarsigner\fRコマンドでは、署名証明書の有効期間中にJARファイルが署名されたされたかどうかをシステムやデプロイヤ(Java Plug\-inを含む)がチェックできる、タイムスタンプを含む署名を生成できます。さらに、APIを使用すると、アプリケーションでタイムスタンプ情報を取得できます。 .PP -現時点では、\fIjarsigner\fRコマンドでは、\fIjar\fRコマンドまたはZIPファイルによって作成されたJARファイルのみに署名できます。JARファイルはZIPファイルと同じですが、JARファイルには\fIMETA\-INF/MANIFEST\&.MF\fRファイルも含まれている点が異なります。\fIMETA\-INF/MANIFEST\&.MF\fRファイルは、\fIjarsigner\fRコマンドによってZIPファイルに署名する際に作成されます。 +現時点では、\fBjarsigner\fRコマンドでは、\fBjar\fRコマンドまたはZIPファイルによって作成されたJARファイルのみに署名できます。JARファイルはZIPファイルと同じですが、JARファイルには\fBMETA\-INF/MANIFEST\&.MF\fRファイルも含まれている点が異なります。\fBMETA\-INF/MANIFEST\&.MF\fRファイルは、\fBjarsigner\fRコマンドによってZIPファイルに署名する際に作成されます。 .PP -デフォルトの\fIjarsigner\fRコマンドの動作では、JARまたはZIPファイルに署名します。\fI\-verify\fRオプションを使用して、署名付きJARファイルを検証します。 +デフォルトの\fBjarsigner\fRコマンドの動作では、JARまたはZIPファイルに署名します。\fB\-verify\fRオプションを使用して、署名付きJARファイルを検証します。 .PP -\fIjarsigner\fRコマンドは、署名または検証の後に署名者の証明書の検証も試行します。検証エラーまたはその他の問題が発生すると、コマンドにより警告メッセージが生成されます。\fI\-strict\fRオプションを指定した場合、コマンドにより重大な警告がエラーとして処理されます。エラーと警告を参照してください。 +\fBjarsigner\fRコマンドは、署名または検証の後に署名者の証明書の検証も試行します。検証エラーまたはその他の問題が発生すると、コマンドにより警告メッセージが生成されます。\fB\-strict\fRオプションを指定した場合、コマンドにより重大な警告がエラーとして処理されます。エラーと警告を参照してください。 .SS "キーストアの別名" .PP キーストアのすべてのエンティティは、一意の別名を使用してアクセスされます。 .PP -\fIjarsigner\fRコマンドを使用してJARファイルに署名するときは、署名の生成に必要な秘密鍵を含むキーストア・エントリの別名を指定する必要があります。たとえば、次のコマンドでは、\fIworking\fRディレクトリの\fImystore\fRという名前のキーストアに含まれる別名\fIduke\fRに関連付けられた秘密鍵を使用して、\fIMyJARFile\&.jar\fRという名前のJARファイルに署名します。出力ファイルは指定されていないため、\fIMyJARFile\&.jar\fRは署名付きのJARファイルによって上書きされます。 +\fBjarsigner\fRコマンドを使用してJARファイルに署名するときは、署名の生成に必要な秘密鍵を含むキーストア・エントリの別名を指定する必要があります。たとえば、次のコマンドでは、\fBworking\fRディレクトリの\fBmystore\fRという名前のキーストアに含まれる別名\fBduke\fRに関連付けられた秘密鍵を使用して、\fBMyJARFile\&.jar\fRという名前のJARファイルに署名します。出力ファイルは指定されていないため、\fBMyJARFile\&.jar\fRは署名付きのJARファイルによって上書きされます。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-keystore /working/mystore \-storepass <keystore password> - \-keypass <private key password> MyJARFile\&.jar duke +\fBjarsigner \-keystore /working/mystore \-storepass <keystore password>\fR +\fB \-keypass <private key password> MyJARFile\&.jar duke\fR + .fi .if n \{\ .RE .\} .PP -キーストアはパスワードで保護されているので、ストアのパスワードを指定する必要があります。コマンドラインで指定しないと、入力を求められます。同様に、秘密鍵もキーストア内でパスワードによって保護されているため、秘密鍵のパスワードを指定する必要があります。コマンドラインでパスワードを指定していない場合、または指定したパスワートが保存されているパスワードと同じではない場合は、パスワードの入力を求められます。 +キーストアはパスワードで保護されているので、ストアのパスワードを指定する必要があります。コマンド行で指定しないと、入力を求められます。同様に、秘密鍵もキーストア内でパスワードによって保護されているため、秘密鍵のパスワードを指定する必要があります。コマンド行でパスワードを指定していない場合、または指定したパスワートが保存されているパスワードと同じではない場合は、パスワードの入力を求められます。 .SS "キーストアの場所" .PP -\fIjarsigner\fRコマンドには、使用するキーストアのURLを指定する\fI\-keystore\fRオプションがあります。キーストアはデフォルトで、\fIuser\&.home\fRシステム・プロパティで決まるユーザーのホーム・ディレクトリの\fI\&.keystore\fRという名前のファイル内に格納されます。 +\fBjarsigner\fRコマンドには、使用するキーストアのURLを指定する\fB\-keystore\fRオプションがあります。キーストアはデフォルトで、\fBuser\&.home\fRシステム・プロパティで決まるユーザーのホーム・ディレクトリの\fB\&.keystore\fRという名前のファイル内に格納されます。 .PP -Oracle Solarisシステムの場合、\fIuser\&.home\fRは、ユーザーのホーム・ディレクトリにデフォルト設定されます。 +Oracle Solarisシステムの場合、\fBuser\&.home\fRは、ユーザーのホーム・ディレクトリにデフォルト設定されます。 .PP -\fI\-keystore\fRオプションからの入力ストリームは、\fIKeyStore\&.load\fRメソッドに渡されます。URLとして\fINONE\fRが指定されている場合は、nullのストリームが\fIKeyStore\&.load\fRメソッドに渡されます。\fINONE\fRは、\fIKeyStore\fRクラスがファイルベースではない場合、たとえば、ハードウェア・トークン・デバイスに置かれている場合に指定します。 +\fB\-keystore\fRオプションからの入力ストリームは、\fBKeyStore\&.load\fRメソッドに渡されます。URLとして\fBNONE\fRが指定されている場合は、nullのストリームが\fBKeyStore\&.load\fRメソッドに渡されます。\fBNONE\fRは、\fBKeyStore\fRクラスがファイルベースではない場合、たとえば、ハードウェア・トークン・デバイスに置かれている場合に指定します。 .SS "キーストアの実装" .PP -\fIjava\&.security package\fRで提供されている\fIKeyStore\fRクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義された多くのインタフェースを提供します。複数の異なる固定実装を指定することができ、各実装は特定のタイプのキーストアを対象とします。 +\fBjava\&.security package\fRで提供されている\fBKeyStore\fRクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義された多くのインタフェースを提供します。複数の異なる固定実装を指定することができ、各実装は特定のタイプのキーストアを対象とします。 .PP -現在、キーストアの実装を使用する2つのコマンドライン・ツール(\fIkeytool\fRと\fIjarsigner\fR)、およびポリシー・ツールという名前の1つのGUIベースのツールがあります。\fIKeyStore\fRクラスは公開されているため、JDKユーザーは、それを使用する他のセキュリティ・アプリケーションを書き込むことができます。 +現在、キーストアの実装を使用する2つのコマンド行ツール(\fBkeytool\fRと\fBjarsigner\fR)、およびポリシー・ツールという名前の1つのGUIベースのツールがあります。\fBKeyStore\fRクラスは公開されているため、JDKユーザーは、それを使用する他のセキュリティ・アプリケーションを書き込むことができます。 .PP Oracleが提供する組込みのデフォルトの実装があります。これは、JKSという名前の独自のキーストア・タイプ(形式)を使用するもので、キーストアをファイルとして実装しています。組込みの実装では、各秘密鍵は個別のパスワードによって保護され、キーストア全体の整合性は(秘密鍵とは別の)パスワードによって保護されます。 .PP -キーストアの実装はプロバイダベースで、つまり、\fIKeyStore\fRクラスにより提供されるアプリケーション・インタフェースは、サービス・プロバイダ・インタフェース(SPI)に関して実装されます。対応する\fIKeystoreSpi\fR抽象クラスがあり、これも\fIjava\&.security package\fRに含まれています。このクラスが、プロバイダが実装する必要のあるサービス・プロバイダ・インタフェースのメソッドを定義しています。ここで、プロバイダとは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。キーストアの実装を提供するには、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/HowToImplAProvider\&.htmlにある -Java暗号化アーキテクチャのプロバイダの実装方法で説明しているように、クライアントはプロバイダを実装し、\fIKeystoreSpi\fRサブクラスの実装を提供する必要があります。 +キーストアの実装はプロバイダベースで、つまり、\fBKeyStore\fRクラスにより提供されるアプリケーション・インタフェースは、サービス・プロバイダ・インタフェース(SPI)に関して実装されます。対応する\fBKeystoreSpi\fR抽象クラスがあり、これも\fBjava\&.security package\fRに含まれています。このクラスが、プロバイダが実装する必要のあるサービス・プロバイダ・インタフェースのメソッドを定義しています。ここで、プロバイダとは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。キーストアの実装を提供するには、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/HowToImplAProvider\&.htmlにある +Java暗号化アーキテクチャのプロバイダの実装方法で説明しているように、クライアントはプロバイダを実装し、\fBKeystoreSpi\fRサブクラスの実装を提供する必要があります。 .PP -アプリケーションでは、\fIKeyStore\fRクラスの\fIgetInstance\fRファクトリ・メソッドを使用して、様々なプロバイダから異なるタイプのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の秘密鍵とキーストア自体の整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 +アプリケーションでは、\fBKeyStore\fRクラスの\fBgetInstance\fRファクトリ・メソッドを使用して、様々なプロバイダから異なるタイプのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の秘密鍵とキーストア自体の整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 .PP -\fIjarsigner\fRおよび\fIpolicytool\fRコマンドは、URLを使用して指定できる任意の場所からファイルベースのキーストアを読み取ることができます。また、これらのコマンドは、Windows上のMSCAPIおよびすべてのプラットフォーム上のPKCS11で提供されるような非ファイルベースのキーストアを読み取ることができます。 +\fBjarsigner\fRおよび\fBpolicytool\fRコマンドは、URLを使用して指定できる任意の場所からファイルベースのキーストアを読み取ることができます。また、これらのコマンドは、Windows上のMSCAPIおよびすべてのプラットフォーム上のPKCS11で提供されるような非ファイルベースのキーストアを読み取ることができます。 .PP -\fIjarsigner\fRコマンドおよび\fIkeytool\fRコマンドの場合、\fI\-storetype\fRオプションを使用して、コマンドラインでキーストアのタイプを指定できます。ポリシー・ツールの場合、\fB「キーストア」\fRメニューの\fB「編集」\fRコマンドを使用して、キーストアのタイプを指定できます。 +\fBjarsigner\fRコマンドおよび\fBkeytool\fRコマンドの場合、\fB\-storetype\fRオプションを使用して、コマンド行でキーストアのタイプを指定できます。ポリシー・ツールの場合、\fB「キーストア」\fRメニューの\fB「編集」\fRコマンドを使用して、キーストアのタイプを指定できます。 .PP -ユーザーがキーストアのタイプを明示的に指定しなかった場合、セキュリティ・プロパティ・ファイルで指定された\fIkeystore\&.type\fRプロパティの値に基づいて、ツールによってキーストアの実装が選択されます。このセキュリティ・プロパティ・ファイルは\fIjava\&.security\fRと呼ばれ、JDKセキュリティ・プロパティ・ディレクトリ\fIjava\&.home/lib/security\fR内に存在しています。ここで、\fIjava\&.home\fRは実行時環境のディレクトリです。\fIjre\fRディレクトリは、JDKまたはJava Runtime Environment (JRE)の最上位のディレクトリにあります。 +ユーザーがキーストアのタイプを明示的に指定しなかった場合、セキュリティ・プロパティ・ファイルで指定された\fBkeystore\&.type\fRプロパティの値に基づいて、ツールによってキーストアの実装が選択されます。このセキュリティ・プロパティ・ファイルは\fBjava\&.security\fRと呼ばれ、JDKセキュリティ・プロパティ・ディレクトリ\fBjava\&.home/lib/security\fR内に存在しています。ここで、\fBjava\&.home\fRは実行時環境のディレクトリです。\fBjre\fRディレクトリは、JDKまたはJava Runtime Environment (JRE)の最上位のディレクトリにあります。 .PP -各ツールは、\fIkeystore\&.type\fRの値を取得し、そのタイプのキーストアを実装しているプロバイダが見つかるまで、インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使用します。 +各ツールは、\fBkeystore\&.type\fRの値を取得し、そのタイプのキーストアを実装しているプロバイダが見つかるまで、インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使用します。 .PP -\fIKeyStore\fRクラスに定義されているstaticメソッド\fIgetDefaultType\fRを使用すると、アプリケーションやアプレットから\fIkeystore\&.type\fRプロパティの値を取得できます。次のコードの行では、\fIkeystore\&.type property\fRで指定された、デフォルトのキーストア・タイプのインスタンスを作成します。 +\fBKeyStore\fRクラスに定義されているstaticメソッド\fBgetDefaultType\fRを使用すると、アプリケーションやアプレットから\fBkeystore\&.type\fRプロパティの値を取得できます。次のコードの行では、\fBkeystore\&.type property\fRで指定された、デフォルトのキーストア・タイプのインスタンスを作成します。 .sp .if n \{\ .RS 4 .\} .nf -KeyStore keyStore = KeyStore\&.getInstance(KeyStore\&.getDefaultType()); +\fBKeyStore keyStore = KeyStore\&.getInstance(KeyStore\&.getDefaultType());\fR + .fi .if n \{\ .RE .\} .PP -デフォルトのキーストア・タイプは、\fIjks\fR +デフォルトのキーストア・タイプは、\fBjks\fR (Oracleが提供する独自のタイプのキーストアの実装)です。これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。 .sp .if n \{\ .RS 4 .\} .nf -keystore\&.type=jks +\fBkeystore\&.type=jks\fR + .fi .if n \{\ .RE .\} .PP -キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、\fIJKS\fRは\fIjks\fRと同じになります。 +キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、\fBJKS\fRは\fBjks\fRと同じになります。 .PP -ツールでデフォルト以外のキーストアの実装を使用するには、その行を変更して別のキーストアのタイプを指定します。たとえば、\fIpkcs12\fRと呼ばれるキーストアのタイプのキーストアの実装を提供するプロバイダ・パッケージがある場合、行を次のように変更します。 +ツールでデフォルト以外のキーストアの実装を使用するには、その行を変更して別のキーストアのタイプを指定します。たとえば、\fBpkcs12\fRと呼ばれるキーストアのタイプのキーストアの実装を提供するプロバイダ・パッケージがある場合、行を次のように変更します。 .sp .if n \{\ .RS 4 .\} .nf -keystore\&.type=pkcs12 +\fBkeystore\&.type=pkcs12\fR + .fi .if n \{\ .RE @@ -272,7 +278,7 @@ Java PKCS #11リファレンス・ガイドの「KeyTool」および「JarSigner」を参照してください。 .SS "サポートされるアルゴリズム" .PP -デフォルトで、\fIjarsigner\fRコマンドでは次のいずれかのアルゴリズムを使用してJARファイルに署名します。 +デフォルトで、\fBjarsigner\fRコマンドでは次のいずれかのアルゴリズムを使用してJARファイルに署名します。 .sp .RS 4 .ie n \{\ @@ -307,12 +313,12 @@ SHA256と楕円曲線デジタル署名アルゴリズム(ECDSA)を使用した楕円曲線(EC)暗号方式アルゴリズム .RE .PP -署名者の公開鍵と秘密鍵がDSA鍵である場合、\fIjarsigner\fRは\fISHA1withDSA\fRアルゴリズムを使用してJARファイルに署名します。署名者の鍵がRSA鍵である場合、\fIjarsigner\fRは\fISHA256withRSA\fRアルゴリズムを使用してJARファイルに署名しようとします。署名者の鍵がEC鍵である場合、\fIjarsigner\fRは\fISHA256withECDSA\fRアルゴリズムを使用してJARファイルに署名します。 +署名者の公開鍵と秘密鍵がDSA鍵である場合、\fBjarsigner\fRは\fBSHA1withDSA\fRアルゴリズムを使用してJARファイルに署名します。署名者の鍵がRSA鍵である場合、\fBjarsigner\fRは\fBSHA256withRSA\fRアルゴリズムを使用してJARファイルに署名しようとします。署名者の鍵がEC鍵である場合、\fBjarsigner\fRは\fBSHA256withECDSA\fRアルゴリズムを使用してJARファイルに署名します。 .PP -これらのデフォルトの署名アルゴリズムは、\fI\-sigalg\fRオプションを使用してオーバーライドできます。 +これらのデフォルトの署名アルゴリズムは、\fB\-sigalg\fRオプションを使用してオーバーライドできます。 .SS "署名付きJARファイル" .PP -\fIjarsigner\fRコマンドを使用してJARファイルに署名する場合、出力される署名付きJARファイルは入力JARファイルと同じですが、次の2つの追加ファイルがMETA\-INFディレクトリに置かれる点が異なります。 +\fBjarsigner\fRコマンドを使用してJARファイルに署名する場合、出力される署名付きJARファイルは入力JARファイルと同じですが、次の2つの追加ファイルがMETA\-INFディレクトリに置かれる点が異なります。 .sp .RS 4 .ie n \{\ @@ -322,7 +328,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\&.SF\fR拡張子の付いた署名ファイル +\fB\&.SF\fR拡張子の付いた署名ファイル .RE .sp .RS 4 @@ -333,14 +339,16 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\&.DSA\fR、\fI\&.RSA\fRまたは\fI\&.EC\fR拡張子の付いた署名ブロック・ファイル +\fB\&.DSA\fR、\fB\&.RSA\fRまたは\fB\&.EC\fR拡張子の付いた署名ブロック・ファイル .RE .PP -これら2つのファイルのベース・ファイル名は、\fI\-sigFile\fRオプションの値から作成されます。たとえば、オプションが\fI\-sigFile MKSIGN\fRの場合、ファイルは\fIMKSIGN\&.SF\fRおよび\fIMKSIGN\&.DSA\fRという名前になります。 +これら2つのファイルのベース・ファイル名は、\fB\-sigFile\fRオプションの値から作成されます。たとえば、オプションが\fB\-sigFile MKSIGN\fRの場合、ファイルは\fBMKSIGN\&.SF\fRおよび\fBMKSIGN\&.DSA\fRという名前になります。 +.PP +コマンド行で\fB\-sigfile\fRオプションを指定しなかった場合、\fB\&.SF\fRファイルと\fB\&.DSA\fRファイルのベース・ファイル名は、コマンド行で指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名に、署名ファイル名で使用できない文字が含まれている場合、ファイル名の作成時に、該当する文字が下線(_)文字に変換されます。有効な文字は、アルファベット、数字、下線およびハイフンです。 .PP -コマンドラインで\fI\-sigfile\fRオプションを指定しなかった場合、\fI\&.SF\fRファイルと\fI\&.DSA\fRファイルのベース・ファイル名は、コマンドラインで指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名に、署名ファイル名で使用できない文字が含まれている場合、ファイル名の作成時に、該当する文字が下線(_)文字に変換されます。有効な文字は、アルファベット、数字、下線およびハイフンです。 -署名ファイル.PP -署名ファイル(\fI\&.SF\fRファイル)は、\fIjarsigner\fRコマンドを使用してファイルに署名する際にJARファイルに常に含まれるマニフェスト・ファイルと似ています。JARファイルに含まれているソース・ファイルごとに、\fI\&.SF\fRファイルには、マニフェスト・ファイルにあるような、次に示す3つの行があります。 +署名ファイル +.PP +署名ファイル(\fB\&.SF\fRファイル)は、\fBjarsigner\fRコマンドを使用してファイルに署名する際にJARファイルに常に含まれるマニフェスト・ファイルと似ています。JARファイルに含まれているソース・ファイルごとに、\fB\&.SF\fRファイルには、マニフェスト・ファイルにあるような、次に示す3つの行があります。 .sp .RS 4 .ie n \{\ @@ -375,24 +383,27 @@ SHAダイジェストの値 .RE .PP -マニフェスト・ファイルでは、各ソース・ファイルのSHAダイジェストの値は、ソース・ファイルのバイナリ・データのダイジェスト(ハッシュ)になります。\fI\&.SF\fRファイルでは、指定されたソース・ファイルのダイジェストの値は、ソース・ファイルのマニフェスト・ファイル内のその3行のハッシュになります。 +マニフェスト・ファイルでは、各ソース・ファイルのSHAダイジェストの値は、ソース・ファイルのバイナリ・データのダイジェスト(ハッシュ)になります。\fB\&.SF\fRファイルでは、指定されたソース・ファイルのダイジェストの値は、ソース・ファイルのマニフェスト・ファイル内のその3行のハッシュになります。 .PP 署名ファイルには、デフォルトで、マニフェスト・ファイル全体のハッシュが格納されたヘッダーが含まれています。ヘッダーにはマニフェスト・ヘッダーのハッシュも含まれています。ヘッダーが存在すると、検証の最適化が有効になります。JARファイルの検証を参照してください。 -署名ブロック・ファイル.PP -\fI\&.SF\fRファイルには署名が付けられ、署名は署名ブロック・ファイルに置かれます。このファイルには、署名に使用された秘密鍵に対応する公開鍵を認証するキーストアからの証明書または証明書チェーンも、内部でエンコードされて含まれています。ファイルの拡張子は、使用されるダイジェスト・アルゴリズムに応じて、\fI\&.DSA\fR、\fI\&.RSA\fRまたは\fI\&.EC\fRになります。 +.PP +署名ブロック・ファイル +.PP +\fB\&.SF\fRファイルには署名が付けられ、署名は署名ブロック・ファイルに置かれます。このファイルには、署名に使用された秘密鍵に対応する公開鍵を認証するキーストアからの証明書または証明書チェーンも、内部でエンコードされて含まれています。ファイルの拡張子は、使用されるダイジェスト・アルゴリズムに応じて、\fB\&.DSA\fR、\fB\&.RSA\fRまたは\fB\&.EC\fRになります。 .SS "署名タイムスタンプ" .PP -\fIjarsigner\fRコマンドでは、JARファイルの署名時に署名タイムスタンプを生成および保存できます。さらに、\fIjarsigner\fRは代替署名機構をサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。オプションを参照してください。 +\fBjarsigner\fRコマンドでは、JARファイルの署名時に署名タイムスタンプを生成および保存できます。さらに、\fBjarsigner\fRは代替署名機構をサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。オプションを参照してください。 .sp .if n \{\ .RS 4 .\} .nf -\-tsa \fIurl\fR -\-tsacert \fIalias\fR -\-altsigner \fIclass\fR -\-altsignerpath \fIclasspathlist\fR -\-tsapolicyid \fIpolicyid\fR +\fB\-tsa \fR\fB\fIurl\fR\fR +\fB\-tsacert \fR\fB\fIalias\fR\fR +\fB\-altsigner \fR\fB\fIclass\fR\fR +\fB\-altsignerpath \fR\fB\fIclasspathlist\fR\fR +\fB\-tsapolicyid \fR\fB\fIpolicyid\fR\fR + .fi .if n \{\ .RE @@ -409,9 +420,9 @@ .sp -1 .IP " 1." 4.2 .\} -\fI\&.SF\fRファイルの署名を検証します。 +\fB\&.SF\fRファイルの署名を検証します。 .sp -検証では、各署名ブロック(\fI\&.DSA\fR)ファイルに格納された署名が、証明書(または証明書チェーン)も\fI\&.DSA\fRファイルに示される公開鍵に対応する秘密鍵を使用して生成されたことを確認します。また、署名が対応する署名(\fI\&.SF\fR)ファイルの有効な署名であることが確認され、それにより、\fI\&.SF\fRファイルが改ざんされていないことも確認されます。 +検証では、各署名ブロック(\fB\&.DSA\fR)ファイルに格納された署名が、証明書(または証明書チェーン)も\fB\&.DSA\fRファイルに示される公開鍵に対応する秘密鍵を使用して生成されたことを確認します。また、署名が対応する署名(\fB\&.SF\fR)ファイルの有効な署名であることが確認され、それにより、\fB\&.SF\fRファイルが改ざんされていないことも確認されます。 .RE .sp .RS 4 @@ -422,13 +433,13 @@ .sp -1 .IP " 2." 4.2 .\} -\fI\&.SF\fRファイル内の各エントリに示されるダイジェストを、マニフェスト内の対応する各セクションと突きあわせて検証します。 +\fB\&.SF\fRファイル内の各エントリに示されるダイジェストを、マニフェスト内の対応する各セクションと突きあわせて検証します。 .sp -\fI\&.SF\fRファイルには、マニフェスト・ファイル全体のハッシュが格納されたヘッダーがデフォルトで含まれています。ヘッダーが存在する場合、検証では、ヘッダー内のハッシュがマニフェスト・ファイルのハッシュと一致するかどうかを確認するためにチェックできます。一致する場合、検証は次の手順に進みます。 +\fB\&.SF\fRファイルには、マニフェスト・ファイル全体のハッシュが格納されたヘッダーがデフォルトで含まれています。ヘッダーが存在する場合、検証では、ヘッダー内のハッシュがマニフェスト・ファイルのハッシュと一致するかどうかを確認するためにチェックできます。一致する場合、検証は次の手順に進みます。 .sp -一致しない場合、\fI\&.SF\fRファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致することを確認するために、あまり最適化されていない検証が必要になります。署名ファイルを参照してください。 +一致しない場合、\fB\&.SF\fRファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致することを確認するために、あまり最適化されていない検証が必要になります。署名ファイルを参照してください。 .sp -\fI\&.SF\fRファイルのヘッダーに格納されたマニフェスト・ファイルのハッシュが、現在のマニフェスト・ファイルのハッシュに一致しない理由の1つは、署名および\fI\&.SF\fRファイルの生成後に、(\fIjar\fRツールを使用して)1つ以上のファイルがJARファイルに追加されたことです。\fIjar\fRツールを使用してファイルを追加した場合、新しいファイル用のセクションが追加されることにより、マニフェスト・ファイルは変更されますが、\fI\&.SF\fRファイルは変更されません。検証がまだ成功しているとみなされるのは、署名の生成以降にJARファイル内のどのファイルも変更されていない場合です。これが発生するのは、\fI\&.SF\fRファイルのヘッダー以外のセクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致する場合です。 +\fB\&.SF\fRファイルのヘッダーに格納されたマニフェスト・ファイルのハッシュが、現在のマニフェスト・ファイルのハッシュに一致しない理由の1つは、署名および\fB\&.SF\fRファイルの生成後に、(\fBjar\fRツールを使用して)1つ以上のファイルがJARファイルに追加されたことです。\fBjar\fRツールを使用してファイルを追加した場合、新しいファイル用のセクションが追加されることにより、マニフェスト・ファイルは変更されますが、\fB\&.SF\fRファイルは変更されません。検証がまだ成功しているとみなされるのは、署名の生成以降にJARファイル内のどのファイルも変更されていない場合です。これが発生するのは、\fB\&.SF\fRファイルのヘッダー以外のセクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致する場合です。 .RE .sp .RS 4 @@ -439,45 +450,46 @@ .sp -1 .IP " 3." 4.2 .\} -\fI\&.SF\fRファイル内にエントリを持つJARファイル内の各ファイルを読み取ります。読取り中にファイルのダイジェストを計算し、結果をマニフェスト・セクション内のこのファイルのダイジェストと比較します。ダイジェストは同じである必要があり、そうでない場合は検証が失敗します。 +\fB\&.SF\fRファイル内にエントリを持つJARファイル内の各ファイルを読み取ります。読取り中にファイルのダイジェストを計算し、結果をマニフェスト・セクション内のこのファイルのダイジェストと比較します。ダイジェストは同じである必要があり、そうでない場合は検証が失敗します。 .sp -検証プロセス中になんらかの重大な検証エラーが発生した場合、そのプロセスは停止され、セキュリティ例外がスローされます。\fIjarsigner\fRコマンドでは、例外を捕捉および表示します。 +検証プロセス中になんらかの重大な検証エラーが発生した場合、そのプロセスは停止され、セキュリティ例外がスローされます。\fBjarsigner\fRコマンドでは、例外を捕捉および表示します。 .RE .PP \fB注意:\fR -追加の警告(または、\fI\-strict\fRオプションを指定した場合はエラー)はすべて読む必要があります。同様に、証明が信頼できるかを決定するために、(\fI\-verbose\fRおよび\fI\-certs\fRオプションを指定して)証明書の内容も読む必要があります。 +追加の警告(または、\fB\-strict\fRオプションを指定した場合はエラー)はすべて読む必要があります。同様に、証明が信頼できるかを決定するために、(\fB\-verbose\fRおよび\fB\-certs\fRオプションを指定して)証明書の内容も読む必要があります。 .SS "1つのJARファイルを対象とする複数の署名" .PP -次のように、\fIjarsigner\fRコマンドをファイルで複数回実行し、実行のたびに異なるユーザーの別名を指定することによって、1つのJARファイルに複数のユーザーの署名を付けることができます。 +次のように、\fBjarsigner\fRコマンドをファイルで複数回実行し、実行のたびに異なるユーザーの別名を指定することによって、1つのJARファイルに複数のユーザーの署名を付けることができます。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner myBundle\&.jar susan -jarsigner myBundle\&.jar kevin +\fBjarsigner myBundle\&.jar susan\fR +\fBjarsigner myBundle\&.jar kevin\fR + .fi .if n \{\ .RE .\} .PP -JARファイルが複数回署名されている場合、そのJARファイルには、複数の\fI\&.SF\fRファイルと\fI\&.DSA\fRファイルが含まれており、1回の署名に対して1つのペアとなります。前述の例では、出力JARファイルには、次の名前のファイルが含まれています。 +JARファイルが複数回署名されている場合、そのJARファイルには、複数の\fB\&.SF\fRファイルと\fB\&.DSA\fRファイルが含まれており、1回の署名に対して1つのペアとなります。前述の例では、出力JARファイルには、次の名前のファイルが含まれています。 .sp .if n \{\ .RS 4 .\} .nf -SUSAN\&.SF -SUSAN\&.DSA -KEVIN\&.SF -KEVIN\&.DSA +\fBSUSAN\&.SF\fR +\fBSUSAN\&.DSA\fR +\fBKEVIN\&.SF\fR +\fBKEVIN\&.DSA\fR .fi .if n \{\ .RE .\} .SH "オプション" .PP -次の各項では、様々な\fIjarsigner\fRオプションについて説明します。次の標準に注意してください。 +次の各項では、様々な\fBjarsigner\fRオプションについて説明します。次の標準に注意してください。 .sp .RS 4 .ie n \{\ @@ -520,38 +532,40 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-storepass\fR、\fI\-keypass\fR、\fI\-sigfile\fR、\fI\-sigalg\fR、\fI\-digestalg\fR、\fI\-signedjar\fRおよびTSA関連のオプションを使用できるのは、JARファイルに署名する場合のみです。署名付きJARファイルを検証する場合ではありません。\fI\-keystore \fRオプションは、JARファイルの署名および検証に関連します。また、別名は、JARファイルの署名および検証時に指定します。 +\fB\-storepass\fR、\fB\-keypass\fR、\fB\-sigfile\fR、\fB\-sigalg\fR、\fB\-digestalg\fR、\fB\-signedjar\fRおよびTSA関連のオプションを使用できるのは、JARファイルに署名する場合のみです。署名付きJARファイルを検証する場合ではありません。\fB\-keystore \fRオプションは、JARファイルの署名および検証に関連します。また、別名は、JARファイルの署名および検証時に指定します。 .RE .PP \-keystore \fIurl\fR .RS 4 -キーストアの場所を示すURLを指定します。これにより、\fIuser\&.home\fRシステム・プロパティで決定されたユーザーのホーム・ディレクトリ内のファイル\fI\&.keystore\fRにデフォルト設定されます。 +キーストアの場所を示すURLを指定します。これにより、\fBuser\&.home\fRシステム・プロパティで決定されたユーザーのホーム・ディレクトリ内のファイル\fB\&.keystore\fRにデフォルト設定されます。 .sp キーストアは署名時には必要です。デフォルトのキーストアが存在しない場合、またはデフォルト以外のキーストアを使用する場合は、キーストアを明示的に指定する必要があります。 .sp -検証するときはキーストアは必要ありません。ただし、キーストアが指定されているか、あるいはデフォルトのキーストアが存在していて、さらに\fI\-verbose\fRオプションも指定されていた場合、JARファイルの検証に使用される証明書がそのキーストアに1つでも含まれているかどうかに関する追加情報が出力されます。 +検証するときはキーストアは必要ありません。ただし、キーストアが指定されているか、あるいはデフォルトのキーストアが存在していて、さらに\fB\-verbose\fRオプションも指定されていた場合、JARファイルの検証に使用される証明書がそのキーストアに1つでも含まれているかどうかに関する追加情報が出力されます。 .sp -\fI\-keystore\fR引数には、URLではなくファイル名とパスを指定でき、この場合、ファイル: URLと同じように処理されます。たとえば、次にように指定すると同等になります。 +\fB\-keystore\fR引数には、URLではなくファイル名とパスを指定でき、この場合、ファイル: URLと同じように処理されます。たとえば、次にように指定すると同等になります。 .sp .if n \{\ .RS 4 .\} .nf -\-keystore \fIfilePathAndName\fR -\-keystore file:\fIfilePathAndName\fR +\fB\-keystore \fR\fB\fIfilePathAndName\fR\fR +\fB\-keystore file:\fR\fB\fIfilePathAndName\fR\fR + .fi .if n \{\ .RE .\} -(JREの\fI$JAVA_HOME/lib/security directory\fRにある) -\fIjava\&.security\fRセキュリティ・プロパティ・ファイル内でSun PKCS #11プロバイダが構成された場合、\fIkeytool\fRおよび\fIjarsigner\fRツールはPKCS#11トークンに基づいて動作できます。次のオプションを指定します。 +(JREの\fB$JAVA_HOME/lib/security directory\fRにある) +\fBjava\&.security\fRセキュリティ・プロパティ・ファイル内でSun PKCS #11プロバイダが構成された場合、\fBkeytool\fRおよび\fBjarsigner\fRツールはPKCS#11トークンに基づいて動作できます。次のオプションを指定します。 .sp .if n \{\ .RS 4 .\} .nf -\-keystore NONE -\-storetype PKCS11 +\fB\-keystore NONE\fR +\fB\-storetype PKCS11\fR + .fi .if n \{\ .RE @@ -562,7 +576,8 @@ .RS 4 .\} .nf -keytool \-keystore NONE \-storetype PKCS11 \-list +\fBkeytool \-keystore NONE \-storetype PKCS11 \-list\fR + .fi .if n \{\ .RE @@ -571,17 +586,17 @@ .PP \-storetype \fIstoretype\fR .RS 4 -インスタンスを生成するキーストアのタイプを指定します。デフォルトのキーストア・タイプは、セキュリティ・プロパティ・ファイル内の\fIkeystore\&.type\fRプロパティの値で指定されたタイプです。この値は、\fIjava\&.security\&.KeyStore\fRのstatic -\fIgetDefaultType\fRメソッドによって返されます。 +インスタンスを生成するキーストアのタイプを指定します。デフォルトのキーストア・タイプは、セキュリティ・プロパティ・ファイル内の\fBkeystore\&.type\fRプロパティの値で指定されたタイプです。この値は、\fBjava\&.security\&.KeyStore\fRのstatic +\fBgetDefaultType\fRメソッドによって返されます。 .sp -\fI\-storepass\fRオプションを使用して、PCKS #11トークンのPINを指定することもできます。何も指定しない場合、\fIkeytool\fRおよび\fIjarsigner\fRコマンドによって、トークンPINの指定を求められます。トークンに保護された認証パス(専用のPINパッドや生体読取り機など)がある場合、\fI\-protected\fRオプションを指定する必要がありますが、パスワード・オプションは指定できません。 +\fB\-storepass\fRオプションを使用して、PCKS #11トークンのPINを指定することもできます。何も指定しない場合、\fBkeytool\fRおよび\fBjarsigner\fRコマンドによって、トークンPINの指定を求められます。トークンに保護された認証パス(専用のPINパッドや生体読取り機など)がある場合、\fB\-protected\fRオプションを指定する必要がありますが、パスワード・オプションは指定できません。 .RE .PP \-storepass[:env | :file] \fIargument\fR .RS 4 -キーストアにアクセスするのに必要なパスワードを指定します。これが必要なのは、JARファイルに署名を付けるときのみです(検証するときには不要です)。その場合、\fI\-storepass\fRオプションをコマンドラインで指定しないと、パスワードの入力を求められます。 +キーストアにアクセスするのに必要なパスワードを指定します。これが必要なのは、JARファイルに署名を付けるときのみです(検証するときには不要です)。その場合、\fB\-storepass\fRオプションをコマンド行で指定しないと、パスワードの入力を求められます。 .sp -修飾子\fIenv\fRまたは\fIfile\fRが指定されていない場合、パスワードの値は\fIargument\fRになります。それ以外の場合、パスワードは次のようにして取得されます。 +修飾子\fBenv\fRまたは\fBfile\fRが指定されていない場合、パスワードの値は\fIargument\fRになります。それ以外の場合、パスワードは次のようにして取得されます。 .sp .RS 4 .ie n \{\ @@ -591,8 +606,8 @@ .sp -1 .IP \(bu 2.3 .\} -\fIenv\fR: -\fIargument\fRという名前の環境変数からパスワードを取得します。 +\fBenv\fR: +\fBargument\fRという名前の環境変数からパスワードを取得します。 .RE .sp .RS 4 @@ -603,19 +618,19 @@ .sp -1 .IP \(bu 2.3 .\} -\fIfile\fR: -\fIargument\fRという名前のファイルからパスワードを取得します。 +\fBfile\fR: +\fBargument\fRという名前のファイルからパスワードを取得します。 .RE .sp \fB注意:\fR -テストを目的とする場合またはセキュリティ保護されたシステムを使用している場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。 +テストを目的とする場合またはセキュアなシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。 .RE .PP \-keypass [:env | :file] \fIargument\fR .RS 4 -コマンドラインで指定された別名に対応するキーストア・エントリの秘密鍵を保護するのに使用するパスワードを指定します。\fIjarsigner\fRを使用してJARファイルに署名を付けるときは、パスワードが必要です。コマンドラインでパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。 +コマンド行で指定された別名に対応するキーストア・エントリの秘密鍵を保護するのに使用するパスワードを指定します。\fBjarsigner\fRを使用してJARファイルに署名を付けるときは、パスワードが必要です。コマンド行でパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。 .sp -修飾子\fIenv\fRまたは\fIfile\fRが指定されていない場合、パスワードの値は\fIargument\fRになります。それ以外の場合、パスワードは次のようにして取得されます。 +修飾子\fBenv\fRまたは\fBfile\fRが指定されていない場合、パスワードの値は\fBargument\fRになります。それ以外の場合、パスワードは次のようにして取得されます。 .sp .RS 4 .ie n \{\ @@ -625,8 +640,8 @@ .sp -1 .IP \(bu 2.3 .\} -\fIenv\fR: -\fIargument\fRという名前の環境変数からパスワードを取得します。 +\fBenv\fR: +\fBargument\fRという名前の環境変数からパスワードを取得します。 .RE .sp .RS 4 @@ -637,21 +652,21 @@ .sp -1 .IP \(bu 2.3 .\} -\fIfile\fR: -\fIargument\fRという名前のファイルからパスワードを取得します。 +\fBfile\fR: +\fBargument\fRという名前のファイルからパスワードを取得します。 .RE .sp \fB注意:\fR -テストを目的とする場合またはセキュリティ保護されたシステムを使用している場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。 +テストを目的とする場合またはセキュアなシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。 .RE .PP \-sigfile \fIfile\fR .RS 4 -生成された\fI\&.SF\fRファイルおよび\fI\&.DSA\fRファイルに使用するベース・ファイル名を指定します。たとえば、ファイルが\fIDUKESIGN\fRの場合、生成される\fI\&.SF\fRおよび\fI\&.DSA\fRファイルは、\fIDUKESIGN\&.SF\fRおよび\fIDUKESIGN\&.DSA\fRという名前で、署名付きJARファイルの\fIMETA\-INF\fRディレクトリに格納されます。 +生成された\fB\&.SF\fRファイルおよび\fB\&.DSA\fRファイルに使用するベース・ファイル名を指定します。たとえば、ファイルが\fBDUKESIGN\fRの場合、生成される\fB\&.SF\fRおよび\fB\&.DSA\fRファイルは、\fBDUKESIGN\&.SF\fRおよび\fBDUKESIGN\&.DSA\fRという名前で、署名付きJARファイルの\fBMETA\-INF\fRディレクトリに格納されます。 .sp -ファイル内の文字は、セット\fIa\-zA\-Z0\-9_\-\fRから指定される必要があります。アルファベット、数字、下線およびハイフン文字のみを使用できます。\fI\&.SF\fRおよび\fI\&.DSA\fRのファイル名では、小文字はすべて大文字に変換されます。 +ファイル内の文字は、セット\fBa\-zA\-Z0\-9_\-\fRから指定される必要があります。アルファベット、数字、下線およびハイフン文字のみを使用できます。\fB\&.SF\fRおよび\fB\&.DSA\fRのファイル名では、小文字はすべて大文字に変換されます。 .sp -コマンドラインで\fI\-sigfile\fRオプションを指定しなかった場合、\fI\&.SF\fRファイルと\fI\&.DSA\fRファイルのベース・ファイル名は、コマンドラインで指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名に、署名ファイル名で無効な文字が含まれている場合、ファイル名を作成するために、該当する文字が下線(_)文字に変換されます。 +コマンド行で\fB\-sigfile\fRオプションを指定しなかった場合、\fB\&.SF\fRファイルと\fB\&.DSA\fRファイルのベース・ファイル名は、コマンド行で指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名に、署名ファイル名で無効な文字が含まれている場合、ファイル名を作成するために、該当する文字が下線(_)文字に変換されます。 .RE .PP \-sigalg \fIalgorithm\fR @@ -661,7 +676,7 @@ 標準的な署名アルゴリズム名のリストは、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/CryptoSpec\&.html#AppAにある Java Cryptography Architecture (JCA)リファレンス・ガイドの「付録A: 標準名」を参照してください。 .sp -このアルゴリズムには、JARファイルの署名に使用する秘密鍵との互換性が必要です。このオプションを指定しない場合、秘密鍵のタイプに応じて、\fISHA1withDSA\fR、\fISHA256withRSA\fRまたは\fISHA256withECDSA\fRが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\fI\-providerClass\fRオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドは失敗します。 +このアルゴリズムには、JARファイルの署名に使用する秘密鍵との互換性が必要です。このオプションを指定しない場合、秘密鍵のタイプに応じて、\fBSHA1withDSA\fR、\fBSHA256withRSA\fRまたは\fBSHA256withECDSA\fRが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\fB\-providerClass\fRオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドは失敗します。 .RE .PP \-digestalg \fIalgorithm\fR @@ -671,60 +686,61 @@ 標準的なメッセージ・ダイジェスト・アルゴリズム名のリストは、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/CryptoSpec\&.html#AppAにある Java Cryptography Architecture (JCA)リファレンス・ガイドの「付録A: 標準名」を参照してください。 .sp -このオプションを指定しない場合、\fISHA256\fRが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\fI\-providerClass\fRオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドは失敗します。 +このオプションを指定しない場合、\fBSHA256\fRが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\fB\-providerClass\fRオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドは失敗します。 .RE .PP \-certs .RS 4 -コマンドラインで、\fI\-certs\fRオプションを\fI\-verify\fRおよび\fI\-verbose\fRオプションとともに指定した場合、JARファイルの各署名者の証明書情報が出力に含まれます。この情報には、署名者の公開鍵を証明する証明書(\fI\&.DSA\fRファイルに格納)のタイプの名前が含まれ、証明書がX\&.509証明書(\fIjava\&.security\&.cert\&.X509Certificate\fRのインスタンス)の場合、署名者の識別名が含まれます。 +コマンド行で、\fB\-certs\fRオプションを\fB\-verify\fRおよび\fB\-verbose\fRオプションとともに指定した場合、JARファイルの各署名者の証明書情報が出力に含まれます。この情報には、署名者の公開鍵を証明する証明書(\fB\&.DSA\fRファイルに格納)のタイプの名前が含まれ、証明書がX\&.509証明書(\fBjava\&.security\&.cert\&.X509Certificate\fRのインスタンス)の場合、署名者の識別名が含まれます。 .sp -キーストアの確認も行われます。コマンドラインでキーストアの値が指定されていない場合、デフォルトのキーストア・ファイル(ある場合)がチェックされます。署名者の公開鍵の証明書がキーストア内のエントリと一致する場合、その署名者のキーストアのエントリの別名が丸カッコ内に表示されます。 +キーストアの確認も行われます。コマンド行でキーストアの値が指定されていない場合、デフォルトのキーストア・ファイル(ある場合)がチェックされます。署名者の公開鍵の証明書がキーストア内のエントリと一致する場合、その署名者のキーストアのエントリの別名が丸カッコ内に表示されます。 .RE .PP \-certchain \fIfile\fR .RS 4 -コマンドラインで指定した別名によって表されるキーストア・エントリの秘密鍵に関連付けられた証明書チェーンが完全ではない場合に、使用する証明書チェーンを指定します。これは、証明書チェーン全体を保持するのに十分な領域がないハードウェア・トークン上にキーストアが格納されている場合に発生します。このファイルは一連の連結されたX\&.509証明書、PKCS#7形式の単一データ・ブロックのいずれかとなり、そのエンコーディング形式はバイナリ・エンコーディング形式、Internet RFC 1421標準で規定される印刷可能エンコーディング形式(Base64エンコーディングとも呼ばれる)のいずれかになります。インターネットRFC 1421証明書符号化規格およびhttp://tools\&.ietf\&.org/html/rfc1421を参照してください。 +コマンド行で指定した別名によって表されるキーストア・エントリの秘密鍵に関連付けられた証明書チェーンが完全ではない場合に、使用する証明書チェーンを指定します。これは、証明書チェーン全体を保持するのに十分な領域がないハードウェア・トークン上にキーストアが格納されている場合に発生します。このファイルは一連の連結されたX\&.509証明書、PKCS#7形式の単一データ・ブロックのいずれかとなり、そのエンコーディング形式はバイナリ・エンコーディング形式、Internet RFC 1421標準で規定される印刷可能エンコーディング形式(Base64エンコーディングとも呼ばれる)のいずれかになります。インターネットRFC 1421証明書符号化規格およびhttp://tools\&.ietf\&.org/html/rfc1421を参照してください。 .RE .PP \-verbose .RS 4 -コマンドラインで\fI\-verbose\fRオプションを指定した場合、冗長モードで動作し、このモードでは、\fIjarsigner\fRは、JARの署名または検証の進行状況に関する追加情報を出力します。 +コマンド行で\fB\-verbose\fRオプションを指定した場合、冗長モードで動作し、このモードでは、\fBjarsigner\fRは、JARの署名または検証の進行状況に関する追加情報を出力します。 .RE .PP \-internalsf .RS 4 -以前は、JARファイルの署名時に生成された\fI\&.DSA\fR -(署名ブロック)ファイルに、生成された\fI\&.SF\fRファイル(署名ファイル)のエンコードされた完全なコピーが含まれていました。 この動作は変更されました。出力JARファイル全体のサイズを小さくするために、デフォルトでは\fI\&.DSA\fRファイルには\fI\&.SF\fRファイルのコピーが含まれないようになっています。コマンドラインで\fI\-internalsf\fRを指定した場合、以前と同じように動作します。このオプションは、テストを行う場合に便利です。実際には、\fI\-internalsf\fRオプションは、オーバーヘッドが大きくなるため、使用しないでください。 +以前は、JARファイルの署名時に生成された\fB\&.DSA\fR +(署名ブロック)ファイルに、生成された\fB\&.SF\fRファイル(署名ファイル)のエンコードされた完全なコピーが含まれていました。 この動作は変更されました。出力JARファイル全体のサイズを小さくするために、デフォルトでは\fB\&.DSA\fRファイルには\fB\&.SF\fRファイルのコピーが含まれないようになっています。コマンド行で\fB\-internalsf\fRを指定した場合、以前と同じように動作します。このオプションは、テストを行う場合に便利です。実際には、\fB\-internalsf\fRオプションは、オーバーヘッドが大きくなるため、使用しないでください。 .RE .PP \-sectionsonly .RS 4 -コマンドラインで\fI\-sectionsonly\fRオプションを指定した場合、JARファイルの署名時に生成される\fI\&.SF\fRファイル(署名ファイル)には、マニフェスト・ファイル全体のハッシュを含むヘッダーは含まれません。これに含まれるのは、JARファイル内の各ソース・ファイルに関連する情報およびハッシュのみです。署名ファイルを参照してください。 +コマンド行で\fB\-sectionsonly\fRオプションを指定した場合、JARファイルの署名時に生成される\fB\&.SF\fRファイル(署名ファイル)には、マニフェスト・ファイル全体のハッシュを含むヘッダーは含まれません。これに含まれるのは、JARファイル内の各ソース・ファイルに関連する情報およびハッシュのみです。署名ファイルを参照してください。 .sp -デフォルトでは、最適化のために、このヘッダーが追加されます。ヘッダーが存在する場合、JARファイルを検証するたびに、検証では、まずヘッダー内のハッシュがマニフェスト・ファイル全体のハッシュと一致するかどうかを確認するためにチェックできます。一致する場合、検証は次の手順に進みます。一致しない場合、\fI\&.SF\fRファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するという、あまり最適化されていない検証を実行する必要があります。JARファイルの検証を参照してください。 +デフォルトでは、最適化のために、このヘッダーが追加されます。ヘッダーが存在する場合、JARファイルを検証するたびに、検証では、まずヘッダー内のハッシュがマニフェスト・ファイル全体のハッシュと一致するかどうかを確認するためにチェックできます。一致する場合、検証は次の手順に進みます。一致しない場合、\fB\&.SF\fRファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するという、あまり最適化されていない検証を実行する必要があります。JARファイルの検証を参照してください。 .sp -\fI\-sectionsonly\fRオプションは、主にテスト用に使用されます。これを使用するとオーバーヘッドが大きくなるため、テスト用以外では使用しないでください。 +\fB\-sectionsonly\fRオプションは、主にテスト用に使用されます。これを使用するとオーバーヘッドが大きくなるため、テスト用以外では使用しないでください。 .RE .PP \-protected .RS 4 -\fItrue\fRまたは\fIfalse\fRのいずれかの値を指定できます。専用PINリーダーなどの保護された認証パスによってパスワードを指定する必要がある場合、\fItrue\fRを指定します。 +\fBtrue\fRまたは\fBfalse\fRのいずれかの値を指定できます。専用PINリーダーなどの保護された認証パスによってパスワードを指定する必要がある場合、\fBtrue\fRを指定します。 .RE .PP \-providerClass \fIprovider\-class\-name\fR .RS 4 -暗号化サービス・プロバイダが\fIjava\&.security\fRセキュリティ・プロパティ・ファイルに指定されていないときは、そのマスター・クラス・ファイルの名前を指定するときに使用されます。 +暗号化サービス・プロバイダが\fBjava\&.security\fRセキュリティ・プロパティ・ファイルに指定されていないときは、そのマスター・クラス・ファイルの名前を指定するときに使用されます。 .sp -\fI\-providerArg ConfigFilePath\fRオプションとともに使用し、\fIkeytool\fRおよび\fIjarsigner\fRツールは、プロバイダを動的にインストールし、トークン構成ファイルへのパスに\fIConfigFilePath\fRを使用します。次の例は、Oracle PKCS #11プロバイダがセキュリティ・プロパティ・ファイルに構成されていなかった場合に\fIPKCS #11\fRキーストアを一覧表示するコマンドを示しています。 +\fB\-providerArg ConfigFilePath\fRオプションとともに使用し、\fBkeytool\fRおよび\fBjarsigner\fRツールは、プロバイダを動的にインストールし、トークン構成ファイルへのパスに\fIConfigFilePath\fRを使用します。次の例は、Oracle PKCS #11プロバイダがセキュリティ・プロパティ・ファイルに構成されていなかった場合に\fBPKCS #11\fRキーストアを一覧表示するコマンドを示しています。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-keystore NONE \-storetype PKCS11 \e - \-providerClass sun\&.security\&.pkcs11\&.SunPKCS11 \e - \-providerArg /mydir1/mydir2/token\&.config \e - \-list +\fBjarsigner \-keystore NONE \-storetype PKCS11 \e\fR +\fB \-providerClass sun\&.security\&.pkcs11\&.SunPKCS11 \e\fR +\fB \-providerArg /mydir1/mydir2/token\&.config \e\fR +\fB \-list\fR + .fi .if n \{\ .RE @@ -733,17 +749,18 @@ .PP \-providerName \fIproviderName\fR .RS 4 -\fIjava\&.security\fRセキュリティ・プロパティ・ファイル内で2つ以上のプロバイダが構成された場合、\fI\-providerName\fRオプションを使用して、特定のプロバイダ・インスタンスを対象にすることができます。このオプションの引数は、プロバイダの名前です。 +\fBjava\&.security\fRセキュリティ・プロパティ・ファイル内で2つ以上のプロバイダが構成された場合、\fB\-providerName\fRオプションを使用して、特定のプロバイダ・インスタンスを対象にすることができます。このオプションの引数は、プロバイダの名前です。 .sp -Oracle PKCS #11プロバイダの場合、\fIproviderName\fRは\fISunPKCS11\-\fR\fITokenName\fRという形式になります。ここで、構成属性の表で詳細に説明されているように、\fITokenName\fRは、プロバイダ・インスタンスが構成された名前の接尾辞です。たとえば、次のコマンドは、名前接尾辞\fISmartCard\fRの\fIPKCS #11\fRキーストア・プロバイダ・インスタンスの内容を一覧表示します。 +Oracle PKCS #11プロバイダの場合、\fIproviderName\fRは\fBSunPKCS11\-\fR\fITokenName\fRという形式になります。ここで、構成属性の表で詳細に説明されているように、\fITokenName\fRは、プロバイダ・インスタンスが構成された名前の接尾辞です。たとえば、次のコマンドは、名前接尾辞\fBSmartCard\fRの\fBPKCS #11\fRキーストア・プロバイダ・インスタンスの内容を一覧表示します。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-keystore NONE \-storetype PKCS11 \e - \-providerName SunPKCS11\-SmartCard \e - \-list +\fBjarsigner \-keystore NONE \-storetype PKCS11 \e\fR +\fB \-providerName SunPKCS11\-SmartCard \e\fR +\fB \-list\fR + .fi .if n \{\ .RE @@ -752,41 +769,41 @@ .PP \-J\fIjavaoption\fR .RS 4 -指定された\fIjavaoption\fR文字列をJavaインタプリタに直接渡します。\fIjarsigner\fRコマンドは、インタプリタに対するラッパーです。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンドラインで\fIjava \-h\fRまたは\fIjava \-X\fRと入力してください。 +指定された\fIjavaoption\fR文字列をJavaインタプリタに直接渡します。\fBjarsigner\fRコマンドは、インタプリタに対するラッパーです。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンド行で\fBjava \-h\fRまたは\fBjava \-X\fRと入力してください。 .RE .PP \-tsa \fIurl\fR .RS 4 -\fI\-tsa http://example\&.tsa\&.url\fRがJARファイルの署名時にコマンドラインにある場合、署名のタイムスタンプが生成されます。URL -\fIhttp://example\&.tsa\&.url\fRは、Time Stamping Authority (TSA)の場所を特定し、\fI\-tsacert\fRオプションを指定して検出されたURLをオーバーライドします。\fI\-tsa\fRオプションでは、TSAの公開鍵証明書をキーストアに配置する必要はありません。 +\fB\-tsa http://example\&.tsa\&.url\fRがJARファイルの署名時にコマンド行にある場合、署名のタイムスタンプが生成されます。URL +\fBhttp://example\&.tsa\&.url\fRは、Time Stamping Authority (TSA)の場所を特定し、\fB\-tsacert\fRオプションを指定して検出されたURLをオーバーライドします。\fB\-tsa\fRオプションでは、TSAの公開鍵証明書をキーストアに配置する必要はありません。 .sp -タイムスタンプを生成するために、\fIjarsigner\fRは、RFC 3161で定義されているタイムスタンプ・プロトコル(TSP)を使用してTSAと通信します。成功すると、TSAによって返されたタイムスタンプ・トークンは、署名ブロック・ファイルの署名とともに保存されます。 +タイムスタンプを生成するために、\fBjarsigner\fRは、RFC 3161で定義されているタイムスタンプ・プロトコル(TSP)を使用してTSAと通信します。成功すると、TSAによって返されたタイムスタンプ・トークンは、署名ブロック・ファイルの署名とともに保存されます。 .RE .PP \-tsacert \fIalias\fR .RS 4 -\fI\-tsacert alias\fRがJARファイルの署名時にコマンドラインにある場合、署名のタイムスタンプが生成されます。別名は、キーストア内の有効なTSAの公開鍵証明書を特定します。エントリの証明書で、TSAの場所を特定するURLを含むSubject Information Access拡張機能が確認されます。 +\fB\-tsacert alias\fRがJARファイルの署名時にコマンド行にある場合、署名のタイムスタンプが生成されます。別名は、キーストア内の有効なTSAの公開鍵証明書を特定します。エントリの証明書で、TSAの場所を特定するURLを含むSubject Information Access拡張機能が確認されます。 .sp -\fI\-tsacert\fRオプションを使用する場合は、TSAの公開鍵証明書がキーストアに配置されている必要があります。 +\fB\-tsacert\fRオプションを使用する場合は、TSAの公開鍵証明書がキーストアに配置されている必要があります。 .RE .PP \-tsapolicyid \fIpolicyid\fR .RS 4 TSAサーバーに送信するポリシーIDを識別するオブジェクト識別子(OID)を指定します。このオプションを指定しない場合、ポリシーIDは送信されず、TSAサーバーはデフォルトのポリシーIDを選択します。 .sp -オブジェクト識別子は、ITU Telecommunication Standardization Sector (ITU\-T)標準であるX\&.696によって定義されます。これらの識別子は、通常、\fI1\&.2\&.3\&.4\fRなどの、負ではない数字のピリオド区切りのセットです。 +オブジェクト識別子は、ITU Telecommunication Standardization Sector (ITU\-T)標準であるX\&.696によって定義されます。これらの識別子は、通常、\fB1\&.2\&.3\&.4\fRなどの、負ではない数字のピリオド区切りのセットです。 .RE .PP \-altsigner \fIclass\fR .RS 4 -このオプションは、代替署名メカニズムを指定します。完全修飾クラス名は、\fIcom\&.sun\&.jarsigner\&.ContentSigner\fR抽象クラスを拡張するクラス・ファイルを識別します。このクラス・ファイルへのパスは、\fI\-altsignerpath\fRオプションによって定義されます。\fI\-altsigner\fRオプションを使用した場合、\fIjarsigner\fRコマンドでは、指定されたクラスによって提供される署名メカニズムを使用します。それ以外の場合、\fIjarsigner\fRコマンドはデフォルトの署名メカニズムを使用します。 +このオプションは、代替署名メカニズムを指定します。完全修飾クラス名は、\fBcom\&.sun\&.jarsigner\&.ContentSigner\fR抽象クラスを拡張するクラス・ファイルを識別します。このクラス・ファイルへのパスは、\fB\-altsignerpath\fRオプションによって定義されます。\fB\-altsigner\fRオプションを使用した場合、\fBjarsigner\fRコマンドでは、指定されたクラスによって提供される署名メカニズムを使用します。それ以外の場合、\fBjarsigner\fRコマンドはデフォルトの署名メカニズムを使用します。 .sp -たとえば、\fIcom\&.sun\&.sun\&.jarsigner\&.AuthSigner\fRという名前のクラスが提供する署名メカニズムを使用するには、jarsignerのオプション\fI\-altsigner com\&.sun\&.jarsigner\&.AuthSigner\fRを使用します。 +たとえば、\fBcom\&.sun\&.sun\&.jarsigner\&.AuthSigner\fRという名前のクラスが提供する署名メカニズムを使用するには、jarsignerのオプション\fB\-altsigner com\&.sun\&.jarsigner\&.AuthSigner\fRを使用します。 .RE .PP \-altsignerpath \fIclasspathlist\fR .RS 4 -クラス・ファイルおよびそれが依存するJARファイルへのパスを指定します。\fI\-altsigner\fRオプションを使用して、クラス・ファイル名を指定します。クラス・ファイルがJARファイル内にある場合、このオプションでは、そのJARファイルへのパスを指定します。 +クラス・ファイルおよびそれが依存するJARファイルへのパスを指定します。\fB\-altsigner\fRオプションを使用して、クラス・ファイル名を指定します。クラス・ファイルがJARファイル内にある場合、このオプションでは、そのJARファイルへのパスを指定します。 .sp 絶対パスまたは現在のディレクトリへの相対パスを指定できます。\fIclasspathlist\fRに複数のパスやJARファイルが含まれる場合、それらを、Oracle Solarisの場合はコロン(:)で、Windowsの場合はセミコロン(;)で、それぞれ区切ります。目的のクラスがすでに検索パス内にある場合は、このオプションは不要です。 .sp @@ -796,7 +813,8 @@ .RS 4 .\} .nf -\-altsignerpath /home/user/lib/authsigner\&.jar +\fB\-altsignerpath /home/user/lib/authsigner\&.jar\fR + .fi .if n \{\ .RE @@ -807,7 +825,8 @@ .RS 4 .\} .nf -\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/ +\fB\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fR + .fi .if n \{\ .RE @@ -821,23 +840,23 @@ .PP \-verbose \fIsuboptions\fR .RS 4 -検証処理の場合、\fI\-verbose\fRオプションには、表示する情報の量を決定するサブオプションを指定します。\fI\-certs\fRオプションも指定した場合、デフォルト・モード(またはサブオプション\fIall\fR)では、エントリが処理されるたびに各エントリが表示され、その後にJARファイルの各署名者の証明書情報も表示されます。\fI\-certs\fRおよび\fI\-verbose:grouped\fRサブオプションを指定した場合、同じ署名者情報を持つエントリが、その証明書情報とともに、グループ化されて表示されます。\fI\-certs\fRおよび\fI\-verbose:summary\fRサブオプションを指定した場合、同じ署名者情報を持つエントリが、その証明書情報とともに、グループ化されて表示されます。各エントリの詳細は、\fI1つのエントリ(以上)\fRにまとめられて表示されます。例を参照してください。 +検証処理の場合、\fB\-verbose\fRオプションには、表示する情報の量を決定するサブオプションを指定します。\fB\-certs\fRオプションも指定した場合、デフォルト・モード(またはサブオプション\fBall\fR)では、エントリが処理されるたびに各エントリが表示され、その後にJARファイルの各署名者の証明書情報も表示されます。\fB\-certs\fRおよび\fB\-verbose:grouped\fRサブオプションを指定した場合、同じ署名者情報を持つエントリが、その証明書情報とともに、グループ化されて表示されます。\fB\-certs\fRおよび\fB\-verbose:summary\fRサブオプションを指定した場合、同じ署名者情報を持つエントリが、その証明書情報とともに、グループ化されて表示されます。各エントリの詳細は、\fI1つのエントリ(以上)\fRにまとめられて表示されます。例を参照してください。 .RE .SH "エラーと警告" .PP -署名または検証プロセス中に、\fIjarsigner\fRコマンドで、様々なエラーまたは警告が発行される可能性があります。 +署名または検証プロセス中に、\fBjarsigner\fRコマンドで、様々なエラーまたは警告が発行される可能性があります。 .PP -障害がある場合、\fIjarsigner\fRコマンドはコード1で終了します。障害はないが、1つ以上の重大な警告がある場合、\fI\-strict\fRオプションが指定されて\fBいない\fR場合は、\fIjarsigner\fRコマンドはコード0で終了し、\fI\-strict\fRが指定されている場合は警告コードのOR値で終了します。情報警告のみがある、または警告がまったくない場合、コマンドは常にコード0で終了します。 +障害がある場合、\fBjarsigner\fRコマンドはコード1で終了します。障害はないが、1つ以上の重大な警告がある場合、\fB\-strict\fRオプションが指定されて\fBいない\fR場合は、\fBjarsigner\fRコマンドはコード0で終了し、\fB\-strict\fRが指定されている場合は警告コードのOR値で終了します。情報警告のみがある、または警告がまったくない場合、コマンドは常にコード0で終了します。 .PP -たとえば、エントリの署名に使用される証明書が期限切れで、ファイルの署名を許可しないKeyUsage拡張機能を使用している場合、\fI\-strict\fRオプションが指定されていると、\fIjarsigner\fRコマンドはコード12 (=4+8)で終了します。 +たとえば、エントリの署名に使用される証明書が期限切れで、ファイルの署名を許可しないKeyUsage拡張機能を使用している場合、\fB\-strict\fRオプションが指定されていると、\fBjarsigner\fRコマンドはコード12 (=4+8)で終了します。 .PP \fB注意:\fR -UNIXベースのオペレーティング・システムでは0から255までの値のみが有効のため、終了コードは再利用されます。 +Solaris、LinuxおよびOS Xでは0から255までの値のみが有効のため、終了コードは再利用されます。 .PP -次のセクションでは、\fIjarsigner\fRコマンドにより発行できるエラーおよび警告の名前、コード、説明を記述します。 +次のセクションでは、\fBjarsigner\fRコマンドにより発行できるエラーおよび警告の名前、コード、説明を記述します。 .SS "障害" .PP -コマンドライン解析エラー、JARファイルに署名する鍵ペアを検索できない、または署名付きJARファイルの検証失敗など(限定されません)、\fIjarsigner\fRコマンドの失敗理由。 +コマンド行解析エラー、JARファイルに署名する鍵ペアを検索できない、または署名付きJARファイルの検証失敗など(限定されません)、\fBjarsigner\fRコマンドの失敗理由。 .PP failure .RS 4 @@ -846,9 +865,9 @@ .SS "重大な警告" .PP \fB注意:\fR -\fI\-strict\fRオプションを指定した場合、重大な警告はエラーとして報告されます。 +\fB\-strict\fRオプションを指定した場合、重大な警告はエラーとして報告されます。 .PP -JARファイルの署名に使用する証明書にエラーがある、または署名付きJARファイルに他の問題があるなど、\fIjarsigner\fRコマンドが重大な警告を発行する理由。 +JARファイルの署名に使用する証明書にエラーがある、または署名付きJARファイルに他の問題があるなど、\fBjarsigner\fRコマンドが重大な警告を発行する理由。 .PP hasExpiredCert .RS 4 @@ -862,7 +881,7 @@ .PP chainNotValidated .RS 4 -コード4。このjarには、証明書チェーンが正しく検証できないエントリが含まれています。 +コード4。このjarには、証明書チェーンが検証されていないエントリが含まれています。 .RE .PP badKeyUsage @@ -905,27 +924,28 @@ .PP noTimestamp .RS 4 -このjarには、タイムスタンプを含まない署名が含まれています。タイムスタンプなしでは、署名者証明書の有効期限(\fIYYYY\-MM\-DD\fR)後または将来の取消日後、ユーザーはこのJARファイルを検証できない場合があります。 +このjarには、タイムスタンプを含まない署名が含まれています。タイムスタンプなしでは、署名者証明書の有効期限(\fBYYYY\-MM\-DD\fR)後または将来の取消日後、ユーザーはこのJARファイルを検証できない場合があります。 .RE .SH "例" .SS "JARファイルの署名" .PP -次のコマンドを使用して、キーストア別名が\fIworking\fRディレクトリの\fImystore\fRという名前のキーストアにある\fIjane\fRであるユーザーの秘密鍵でbundle\&.jarに署名し、署名付きJARファイルに\fIsbundle\&.jar\fRという名前を付けます。 +次のコマンドを使用して、キーストア別名が\fBworking\fRディレクトリの\fBmystore\fRという名前のキーストアにある\fBjane\fRであるユーザーの秘密鍵でbundle\&.jarに署名し、署名付きJARファイルに\fBsbundle\&.jar\fRという名前を付けます。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-keystore /working/mystore - \-storepass <keystore password> - \-keypass <private key password> - \-signedjar sbundle\&.jar bundle\&.jar jane +\fBjarsigner \-keystore /working/mystore\fR +\fB \-storepass <keystore password>\fR +\fB \-keypass <private key password>\fR +\fB \-signedjar sbundle\&.jar bundle\&.jar jane\fR + .fi .if n \{\ .RE .\} .PP -前述のコマンドでは\fI\-sigfile\fRが指定されていないため、署名付きJARファイルに格納される生成された\fI\&.SF\fRファイルおよび\fI\&.DSA\fRファイルの名前は、別名に基づいたデフォルトの名前になります。これらは、名前付きの\fIJANE\&.SF\fRおよび\fIJANE\&.DSA\fRです。 +前述のコマンドでは\fB\-sigfile\fRが指定されていないため、署名付きJARファイルに格納される生成された\fB\&.SF\fRファイルおよび\fB\&.DSA\fRファイルの名前は、別名に基づいたデフォルトの名前になります。これらは、名前付きの\fBJANE\&.SF\fRおよび\fBJANE\&.DSA\fRです。 .PP ストアのパスワードおよび秘密鍵のパスワードを求められる場合、前述のコマンドを短縮して、次のことを実行できます。 .sp @@ -933,8 +953,9 @@ .RS 4 .\} .nf -jarsigner \-keystore /working/mystore - \-signedjar sbundle\&.jar bundle\&.jar jane +\fBjarsigner \-keystore /working/mystore\fR +\fB \-signedjar sbundle\&.jar bundle\&.jar jane\fR + .fi .if n \{\ .RE @@ -946,19 +967,21 @@ .RS 4 .\} .nf -jarsigner \-signedjar sbundle\&.jar bundle\&.jar jane +\fBjarsigner \-signedjar sbundle\&.jar bundle\&.jar jane\fR + .fi .if n \{\ .RE .\} .PP -入力JARファイル(bundle\&.jar)を署名付きJARファイルで上書きする場合、次のように\fI\-signedjar\fRオプションを指定する必要はありません。 +入力JARファイル(bundle\&.jar)を署名付きJARファイルで上書きする場合、次のように\fB\-signedjar\fRオプションを指定する必要はありません。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner bundle\&.jar jane +\fBjarsigner bundle\&.jar jane\fR + .fi .if n \{\ .RE @@ -971,66 +994,69 @@ .RS 4 .\} .nf -jarsigner \-verify sbundle\&.jar +\fBjarsigner \-verify sbundle\&.jar\fR + .fi .if n \{\ .RE .\} .PP -検証が成功すると、\fIjar verified\fRが表示されます。そうでない場合は、エラー・メッセージが表示されます。\fI\-verbose\fRオプションを使用すると、詳細情報を取得できます。\fIjarsigner\fRを\fI\-verbose\fRオプションとともに使用するサンプルを、次に示します。 +検証が成功すると、\fBjar verified\fRが表示されます。そうでない場合は、エラー・メッセージが表示されます。\fB\-verbose\fRオプションを使用すると、詳細情報を取得できます。\fBjarsigner\fRを\fB\-verbose\fRオプションとともに使用するサンプルを、次に示します。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-verify \-verbose sbundle\&.jar +\fBjarsigner \-verify \-verbose sbundle\&.jar\fR +\fB \fR +\fB 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST\&.MF\fR +\fB 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.SF\fR +\fB 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.DSA\fR +\fB smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx\&.class\fR +\fB smk 849 Fri Sep 26 16:12:46 PDT 1997 test\&.class\fR +\fB \fR +\fB s = signature was verified\fR +\fB m = entry is listed in manifest\fR +\fB k = at least one certificate was found in keystore\fR +\fB \fR +\fB jar verified\&.\fR - 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST\&.MF - 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.SF - 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.DSA - smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx\&.class - smk 849 Fri Sep 26 16:12:46 PDT 1997 test\&.class - - s = signature was verified - m = entry is listed in manifest - k = at least one certificate was found in keystore - - jar verified\&. .fi .if n \{\ .RE .\} .SS "証明書情報を使用した検証" .PP -\fI\-certs\fRオプションを\fI\-verify\fRおよび\fI\-verbose\fRオプションとともに指定した場合、JARファイルの各署名者の証明書情報が出力に含まれます。この情報には、証明書タイプ、署名者の識別名情報(X\&.509証明書の場合)が含まれ、丸カッコ内には、JARファイルの公開鍵証明書がキーストア・エントリの公開鍵証明書に一致する場合の署名者のキーストア別名が含まれます。たとえば、次のようになります。 +\fB\-certs\fRオプションを\fB\-verify\fRおよび\fB\-verbose\fRオプションとともに指定した場合、JARファイルの各署名者の証明書情報が出力に含まれます。この情報には、証明書タイプ、署名者の識別名情報(X\&.509証明書の場合)が含まれ、丸カッコ内には、JARファイルの公開鍵証明書がキーストア・エントリの公開鍵証明書に一致する場合の署名者のキーストア別名が含まれます。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest\&.jar - - 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST\&.MF - 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.SF - 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.DSA - 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST\&.SF - 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST\&.DSA - smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst\&.class +\fBjarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest\&.jar\fR +\fB \fR +\fB 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST\&.MF\fR +\fB 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.SF\fR +\fB 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.DSA\fR +\fB 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST\&.SF\fR +\fB 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST\&.DSA\fR +\fB smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst\&.class\fR +\fB \fR +\fB X\&.509, CN=Test Group, OU=Java Software, O=Oracle, L=CUP, S=CA, C=US (javatest)\fR +\fB X\&.509, CN=Jane Smith, OU=Java Software, O=Oracle, L=cup, S=ca, C=us (jane)\fR +\fB \fR +\fB s = signature was verified\fR +\fB m = entry is listed in manifest\fR +\fB k = at least one certificate was found in keystore\fR +\fB \fR +\fB jar verified\&.\fR - X\&.509, CN=Test Group, OU=Java Software, O=Oracle, L=CUP, S=CA, C=US (javatest) - X\&.509, CN=Jane Smith, OU=Java Software, O=Oracle, L=cup, S=ca, C=us (jane) - - s = signature was verified - m = entry is listed in manifest - k = at least one certificate was found in keystore - - jar verified\&. .fi .if n \{\ .RE .\} .PP -署名者の証明書がX\&.509証明書ではない場合、識別名情報は表示されません。その場合には、証明書のタイプと別名のみが表示されます。たとえば、証明書がPGP証明書で、別名が\fIbob\fRである場合、\fIPGP, (bob)\fRを取得します。 +署名者の証明書がX\&.509証明書ではない場合、識別名情報は表示されません。その場合には、証明書のタイプと別名のみが表示されます。たとえば、証明書がPGP証明書で、別名が\fBbob\fRである場合、\fBPGP, (bob)\fRを取得します。 .SH "関連項目" .sp .RS 4
--- a/src/linux/doc/man/ja/java.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/java.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: java -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,8 +21,16 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 -.TH "java" "1" "2013年11月21日" "JDK 8" "基本ツール" +.\" Title: java +.\" Language: Japanese +.\" Date: 2014年8月8日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 +.TH "java" "1" "2014年8月8日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" java \- Javaアプリケーションを起動します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjava\fR [\fIoptions\fR] \fIclassname\fR [\fIargs\fR] +\fBjava\fR [\fIoptions\fR] \fIclassname\fR [\fIargs\fR] .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjava\fR [\fIoptions\fR] \fI\-jar\fR \fIfilename\fR [\fIargs\fR] +\fBjava\fR [\fIoptions\fR] \fB\-jar\fR \fIfilename\fR [\fIargs\fR] .fi .if n \{\ .RE @@ -74,7 +76,7 @@ .PP \fIoptions\fR .RS 4 -空白で区切られたコマンドライン・オプション。オプションを参照してください。 +空白で区切られたコマンド行オプション。オプションを参照してください。 .RE .PP \fIclassname\fR @@ -84,37 +86,38 @@ .PP \fIfilename\fR .RS 4 -呼び出されるJavaアーカイブ(JAR)ファイルの名前。\fI\-jar\fRオプションと一緒にのみ使用します。 +呼び出されるJavaアーカイブ(JAR)ファイルの名前。\fB\-jar\fRオプションと一緒にのみ使用します。 .RE .PP \fIargs\fR .RS 4 -空白で区切られた\fImain()\fRメソッドに渡される引数。 +空白で区切られた\fBmain()\fRメソッドに渡される引数。 .RE .SH "説明" .PP -\fIjava\fRコマンドはJavaアプリケーションを開始します。Java Runtime Environment (JRE)を起動した後、指定したクラスをロードし、そのクラスの\fImain()\fRメソッドを呼び出すことにより、これを行います。このメソッドは、\fIpublic\fRおよび\fIstatic\fRとして宣言する必要があります。また、値は返せません。さらに、\fIString\fR配列をパラメータとして指定できる必要があります。メソッド宣言は次の形式を含みます。 +\fBjava\fRコマンドはJavaアプリケーションを開始します。Java Runtime Environment (JRE)を起動した後、指定したクラスをロードし、そのクラスの\fBmain()\fRメソッドを呼び出すことにより、これを行います。このメソッドは、\fIpublic\fRおよび\fIstatic\fRとして宣言する必要があります。また、値は返せません。さらに、\fBString\fR配列をパラメータとして指定できる必要があります。メソッド宣言は次の形式を含みます。 .sp .if n \{\ .RS 4 .\} .nf -public static void main(String[] args) +\fBpublic static void main(String[] args)\fR + .fi .if n \{\ .RE .\} .PP -\fIjava\fRコマンドを使用して、\fImain()\fRメソッドがあるか\fIjavafx\&.application\&.Application\fRを拡張するクラスをロードすることで、JavaFXアプリケーションを起動できます。後者の場合、起動ツールは\fIApplication\fRクラスのインスタンスを構成し、その\fIinit()\fRメソッドをコールし、\fIstart(javafx\&.stage\&.Stage)\fRメソッドをコールします。 +\fBjava\fRコマンドを使用して、\fBmain()\fRメソッドがあるか\fBjavafx\&.application\&.Application\fRを拡張するクラスをロードすることで、JavaFXアプリケーションを起動できます。後者の場合、起動ツールは\fBApplication\fRクラスのインスタンスを構成し、その\fBinit()\fRメソッドをコールし、\fBstart(javafx\&.stage\&.Stage)\fRメソッドをコールします。 .PP -デフォルトでは、\fIjava\fRコマンドのオプションではない最初の引数は、呼び出されるクラスの完全修飾名です。\fI\-jar\fRオプションを指定した場合、その引数は、アプリケーションのクラス・ファイルとリソース・ファイルを含むJARファイルの名前になります。起動クラスは、ソース・コードの\fIMain\-Class\fRマニフェスト・ヘッダーによって指定される必要があります。 +デフォルトでは、\fBjava\fRコマンドのオプションではない最初の引数は、呼び出されるクラスの完全修飾名です。\fB\-jar\fRオプションを指定した場合、その引数は、アプリケーションのクラス・ファイルとリソース・ファイルを含むJARファイルの名前になります。起動クラスは、ソース・コードの\fBMain\-Class\fRマニフェスト・ヘッダーによって指定される必要があります。 .PP JREは、ブートストラップ・クラス・パス、インストール済拡張機能およびユーザーのクラス・パスの3箇所から、起動クラス(およびアプリケーションで使用されている他のクラス)を検索します。 .PP -クラス・ファイル名またはJARファイル名の後の引数は、\fImain()\fRメソッドに渡されます。 +クラス・ファイル名またはJARファイル名の後の引数は、\fBmain()\fRメソッドに渡されます。 .SH "オプション" .PP -\fIjava\fRコマンドは、次のカテゴリに分類できる広範なオプションをサポートしています。 +\fBjava\fRコマンドは、次のカテゴリに分類できる広範なオプションをサポートしています。 .sp .RS 4 .ie n \{\ @@ -184,15 +187,15 @@ .PP 標準のオプションは、Java Virtual Machine (JVM)のすべての実装でサポートすることが保証されます。これらは、JREのバージョンの確認、クラス・パスの設定、冗長な出力の有効化などの一般的なアクションに使用されます。 .PP -標準以外のオプションは、Java HotSpot仮想マシンに固有の汎用オプションであるため、すべてのJVM実装でサポートされることは保証されず、変更される可能性があります。これらのオプションは\fI\-X\fRで開始します。 +標準以外のオプションは、Java HotSpot仮想マシンに固有の汎用オプションであるため、すべてのJVM実装でサポートされることは保証されず、変更される可能性があります。これらのオプションは\fB\-X\fRで開始します。 .PP -拡張オプションは、不用意に使用しないことをお薦めします。これらは、特定のシステム要件を持つことが多く、システム構成パラメータへの特権アクセスが必要な場合があるJava HotSpot仮想マシン操作の特定の領域を調整するために使用される開発者オプションです。これらは、すべてのJVM実装でサポートされることは保証されず、変更される可能性があります。拡張オプションは\fI\-XX\fRで始まります。 +拡張オプションは、不用意に使用しないことをお薦めします。これらは、特定のシステム要件を持つことが多く、システム構成パラメータへの特権アクセスが必要な場合があるJava HotSpot仮想マシン操作の特定の領域を調整するために使用される開発者オプションです。これらは、すべてのJVM実装でサポートされることは保証されず、変更される可能性があります。拡張オプションは\fB\-XX\fRで始まります。 .PP 最新リリースで非推奨または削除されるオプションを追跡するために、ドキュメントの最後に非推奨で削除されたオプションという名前のセクションがあります。 .PP -ブール・オプションは、デフォルトで無効になっている機能を有効にしたり、デフォルトで有効になっている機能を無効にするために使用されます。このようなオプションは、パラメータを必要としません。ブール値\fI\-XX\fRオプションは、プラス記号(\fI\-XX:+\fR\fIOptionName\fR)を使用して有効にし、マイナス記号(\fI\-XX:\-\fR\fIOptionName\fR)を使用して無効にします。 +ブール・オプションは、デフォルトで無効になっている機能を有効にしたり、デフォルトで有効になっている機能を無効にするために使用されます。このようなオプションは、パラメータを必要としません。ブール値\fB\-XX\fRオプションは、プラス記号(\fB\-XX:+\fR\fIOptionName\fR)を使用して有効にし、マイナス記号(\fB\-XX:\-\fR\fIOptionName\fR)を使用して無効にします。 .PP -引数が必要なオプションの場合、引数は、オプション名を空白、コロン(:)または等号(=)で区切ったものになるか、あるいは引数がオプションの後に直接続く場合もあります(正確な構文は各オプションによって異なります)。サイズをバイト単位で指定するよう求められている場合、接尾辞を使用しないか、あるいはキロバイト(KB)には接尾辞\fIk\fRまたは\fIK\fR、メガバイト(MB)には接尾辞\fIm\fRまたは\fIM\fR、ギガバイト(GB)には接尾辞\fIg\fRまたは\fIG\fRを使用します。たとえば、サイズを8GBに設定するには、\fI8g\fR、\fI8192m\fR、\fI8388608k\fRまたは\fI8589934592\fRのいずれかを引数として指定できます。パーセントの指定が必要な場合は、0から1の数値を使用します(たとえば、25%の場合は\fI0\&.25\fRを指定します)。 +引数が必要なオプションの場合、引数は、オプション名を空白、コロン(:)または等号(=)で区切ったものになるか、あるいは引数がオプションの後に直接続く場合もあります(正確な構文は各オプションによって異なります)。サイズをバイト単位で指定するよう求められている場合、接尾辞を使用しないか、あるいはキロバイト(KB)には接尾辞\fBk\fRまたは\fBK\fR、メガバイト(MB)には接尾辞\fBm\fRまたは\fBM\fR、ギガバイト(GB)には接尾辞\fBg\fRまたは\fBG\fRを使用します。たとえば、サイズを8GBに設定するには、\fB8g\fR、\fB8192m\fR、\fB8388608k\fRまたは\fB8589934592\fRのいずれかを引数として指定できます。パーセントの指定が必要な場合は、0から1の数値を使用します(たとえば、25%の場合は\fB0\&.25\fRを指定します)。 .SS "標準オプション" .PP これらは、JVMのすべての実装でサポートされる最も一般的に使用されるオプションです。 @@ -201,7 +204,7 @@ .RS 4 指定したネイティブ・エージェント・ライブラリをロードします。ライブラリ名の後に、ライブラリに固有のオプションのカンマ区切りリストを使用できます。 .sp -オプション\fI\-agentlib:foo\fRを指定した場合、JVMは、\fILD_LIBRARY_PATH\fRシステム変数(OS Xでは、この変数は\fIDYLD_LIBRARY_PATH\fRになります)で指定された場所に\fIlibfoo\&.so\fRという名前のライブラリをロードしようとします。 +オプション\fB\-agentlib:foo\fRを指定した場合、JVMは、\fBLD_LIBRARY_PATH\fRシステム変数(OS Xでは、この変数は\fBDYLD_LIBRARY_PATH\fRになります)で指定された場所に\fBlibfoo\&.so\fRという名前のライブラリをロードしようとします。 .sp 次の例では、スタックの深さ3で、20ミリ秒ごとにヒープ・プロファイリング・ツール(HPROF)ライブラリをロードして、サンプルのCPU情報を取得する方法を示します。 .sp @@ -209,7 +212,8 @@ .RS 4 .\} .nf -\-agentlib:hprof=cpu=samples,interval=20,depth=3 +\fB\-agentlib:hprof=cpu=samples,interval=20,depth=3\fR + .fi .if n \{\ .RE @@ -220,7 +224,8 @@ .RS 4 .\} .nf -\-agentlib:jdwp=transport=dt_socket,server=y,address=8000 +\fB\-agentlib:jdwp=transport=dt_socket,server=y,address=8000\fR + .fi .if n \{\ .RE @@ -235,7 +240,7 @@ .sp -1 .IP \(bu 2.3 .\} -http://docs\&.oracle\&.com/javase/8/docs/api/java/lang/instrument/package\-summary\&.htmlにある\fIjava\&.lang\&.instrument\fRパッケージの説明 +http://docs\&.oracle\&.com/javase/8/docs/api/java/lang/instrument/package\-summary\&.htmlにある\fBjava\&.lang\&.instrument\fRパッケージの説明 .RE .sp .RS 4 @@ -246,13 +251,13 @@ .sp -1 .IP \(bu 2.3 .\} -http://docs\&.oracle\&.com/javase/8/docs/platform/jvmti/jvmti\&.html#startingにあるJVMツール・インタフェース・ガイドのエージェントのコマンドライン・オプションに関する項 +http://docs\&.oracle\&.com/javase/8/docs/platform/jvmti/jvmti\&.html#startingにあるJVMツール・インタフェース・ガイドのエージェントのコマンド行オプションに関する項 .RE .RE .PP \-agentpath:\fIpathname\fR[=\fIoptions\fR] .RS 4 -絶対パス名で指定されたネイティブ・エージェント・ライブラリをロードします。このオプションは\fI\-agentlib\fRと同等ですが、ライブラリのフル・パスおよびファイル名を使用します。 +絶対パス名で指定されたネイティブ・エージェント・ライブラリをロードします。このオプションは\fB\-agentlib\fRと同等ですが、ライブラリのフル・パスおよびファイル名を使用します。 .RE .PP \-client @@ -266,7 +271,7 @@ \-D\fIproperty\fR=\fIvalue\fR .RS 4 システム・プロパティの値を設定します。\fIproperty\fR変数は、プロパティの名前を表す、空白のない文字列です。\fIvalue\fR変数は、プロパティの値を表す文字列です。\fIvalue\fRが空白を含む文字列の場合、それを引用符で囲みます(例: -\fI\-Dfoo="foo bar"\fR)。 +\fB\-Dfoo="foo bar"\fR)。 .RE .PP \-d32 @@ -278,79 +283,91 @@ .RS 4 アプリケーションを64ビット環境で実行します。64ビット環境がインストールされていないかサポートされていない場合は、エラーが報告されます。デフォルトでは、64ビット・システムが使用されている場合を除き、アプリケーションは32ビット環境で実行されます。 .sp -現在のところ、Java HotSpot Server VMのみが64ビットの操作をサポートしているため、\fI\-d64\fR使用時には\fI\-server\fRオプションが暗黙的に使用されます。\fI\-d64\fR使用時には、\fI\-client\fRオプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。 +現在のところ、Java HotSpot Server VMのみが64ビットの操作をサポートしているため、\fB\-d64\fR使用時には\fB\-server\fRオプションが暗黙的に使用されます。\fB\-d64\fR使用時には、\fB\-client\fRオプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。 .RE .PP -\-disableassertions[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR], \-da[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] +\-disableassertions[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] +.br +\-da[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] .RS 4 アサーションを無効にします。デフォルトでは、アサーションはすべてのパッケージおよびクラスで無効になっています。 .sp -引数なしの\fI\-disableassertions\fR -(\fI\-da\fR)を指定すると、すべてのパッケージおよびクラスでアサーションが無効になります。\fI\&.\&.\&.\fRで終わる\fIpackagename\fR引数を指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として\fI\&.\&.\&.\fRのみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。\fIclassname\fR引数を指定すると、切替えによって、指定したクラス内でアサーションが無効になります。 +引数なしの\fB\-disableassertions\fR +(\fB\-da\fR)を指定すると、すべてのパッケージおよびクラスでアサーションが無効になります。\fB\&.\&.\&.\fRで終わる\fIpackagename\fR引数を指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として\fB\&.\&.\&.\fRのみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。\fIclassname\fR引数を指定すると、切替えによって、指定したクラス内でアサーションが無効になります。 .sp -\fI\-disableassertions\fR -(\fI\-da\fR)オプションは、すべてのクラス・ローダーおよびシステム・クラスに適用されます(システム・クラスにはクラス・ローダーはありません)。このルールには1つ例外があります。オプションの引数が指定されていない場合は、システム・クラスに適用されません。これにより、システム・クラスを除くすべてのクラスでアサーションを簡単に無効にすることができます。\fI\-disablesystemassertions\fRオプションを使用すると、すべてのシステム・クラスでアサーションを無効にすることができます。 +\fB\-disableassertions\fR +(\fB\-da\fR)オプションは、すべてのクラス・ローダーおよびシステム・クラスに適用されます(システム・クラスにはクラス・ローダーはありません)。このルールには1つ例外があります。オプションの引数が指定されていない場合は、システム・クラスに適用されません。これにより、システム・クラスを除くすべてのクラスでアサーションを簡単に無効にすることができます。\fB\-disablesystemassertions\fRオプションを使用すると、すべてのシステム・クラスでアサーションを無効にすることができます。 .sp -特定のパッケージやクラスでアサーションを明示的に有効にするには、\fI\-enableassertions\fR -(\fI\-ea\fR)オプションを使用します。両方のオプションを同時に使用できます。たとえば、パッケージ\fIcom\&.wombat\&.fruitbat\fR -(およびそのサブパッケージ)ではアサーションを有効にして、クラス\fIcom\&.wombat\&.fruitbat\&.Brickbat\fRではアサーションを無効にして、\fIMyClass\fRアプリケーションを実行するには、次のコマンドを使用します。 +特定のパッケージやクラスでアサーションを明示的に有効にするには、\fB\-enableassertions\fR +(\fB\-ea\fR)オプションを使用します。両方のオプションを同時に使用できます。たとえば、パッケージ\fBcom\&.wombat\&.fruitbat\fR +(およびそのサブパッケージ)ではアサーションを有効にして、クラス\fBcom\&.wombat\&.fruitbat\&.Brickbat\fRではアサーションを無効にして、\fBMyClass\fRアプリケーションを実行するには、次のコマンドを使用します。 .sp .if n \{\ .RS 4 .\} .nf -java \-ea:com\&.wombat\&.fruitbat\&.\&.\&. \-da:com\&.wombat\&.fruitbat\&.Brickbat MyClass +\fBjava \-ea:com\&.wombat\&.fruitbat\&.\&.\&. \-da:com\&.wombat\&.fruitbat\&.Brickbat MyClass\fR + .fi .if n \{\ .RE .\} .RE .PP -\-disablesystemassertions, \-dsa +\-disablesystemassertions +.br +\-dsa .RS 4 すべてのシステム・クラス内でアサーションを無効にします。 .RE .PP -\-enableassertions[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR], \-ea[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] +\-enableassertions[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] +.br +\-ea[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] .RS 4 アサーションを有効にします。デフォルトでは、アサーションはすべてのパッケージおよびクラスで無効になっています。 .sp -引数なしの\fI\-enableassertions\fR -(\fI\-ea\fR)を指定すると、すべてのパッケージおよびクラスでアサーションが有効になります。\fI\&.\&.\&.\fRで終わる\fIpackagename\fR引数を指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として\fI\&.\&.\&.\fRのみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。\fIclassname\fR引数を指定すると、切替えによって、指定したクラス内でアサーションが有効になります。 +引数なしの\fB\-enableassertions\fR +(\fB\-ea\fR)を指定すると、すべてのパッケージおよびクラスでアサーションが有効になります。\fB\&.\&.\&.\fRで終わる\fIpackagename\fR引数を指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として\fB\&.\&.\&.\fRのみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。\fIclassname\fR引数を指定すると、切替えによって、指定したクラス内でアサーションが有効になります。 .sp -\fI\-enableassertions\fR -(\fI\-ea\fR)オプションは、すべてのクラス・ローダーおよびシステム・クラスに適用されます(システム・クラスにはクラス・ローダーはありません)。このルールには1つ例外があります。オプションの引数が指定されていない場合は、システム・クラスに適用されません。これにより、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。\fI\-enablesystemassertions\fRオプションは、すべてのシステム・クラスでアサーションを有効にする別のスイッチを提供します。 +\fB\-enableassertions\fR +(\fB\-ea\fR)オプションは、すべてのクラス・ローダーおよびシステム・クラスに適用されます(システム・クラスにはクラス・ローダーはありません)。このルールには1つ例外があります。オプションの引数が指定されていない場合は、システム・クラスに適用されません。これにより、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。\fB\-enablesystemassertions\fRオプションは、すべてのシステム・クラスでアサーションを有効にする別のスイッチを提供します。 .sp -特定のパッケージやクラスでアサーションを明示的に無効にするには、\fI\-disableassertions\fR -(\fI\-da\fR)オプションを使用します。単一コマンドにこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。たとえば、パッケージ\fIcom\&.wombat\&.fruitbat\fR -(およびそのサブパッケージ)でのみアサーションを有効にして、クラス\fIcom\&.wombat\&.fruitbat\&.Brickbat\fRではアサーションを無効にして、\fIMyClass\fRアプリケーションを実行するには、次のコマンドを使用します。 +特定のパッケージやクラスでアサーションを明示的に無効にするには、\fB\-disableassertions\fR +(\fB\-da\fR)オプションを使用します。単一コマンドにこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。たとえば、パッケージ\fBcom\&.wombat\&.fruitbat\fR +(およびそのサブパッケージ)でのみアサーションを有効にして、クラス\fBcom\&.wombat\&.fruitbat\&.Brickbat\fRではアサーションを無効にして、\fBMyClass\fRアプリケーションを実行するには、次のコマンドを使用します。 .sp .if n \{\ .RS 4 .\} .nf -java \-ea:com\&.wombat\&.fruitbat\&.\&.\&. \-da:com\&.wombat\&.fruitbat\&.Brickbat MyClass +\fBjava \-ea:com\&.wombat\&.fruitbat\&.\&.\&. \-da:com\&.wombat\&.fruitbat\&.Brickbat MyClass\fR + .fi .if n \{\ .RE .\} .RE .PP -\-enablesystemassertions, \-esa +\-enablesystemassertions +.br +\-esa .RS 4 すべてのシステム・クラス内でアサーションを有効にします。 .RE .PP -\-help, \-? +\-help +.br +\-? .RS 4 -実際にJVMを実行せずに、\fIjava\fRコマンドの使用状況情報を表示します。 +実際にJVMを実行せずに、\fBjava\fRコマンドの使用状況情報を表示します。 .RE .PP \-jar \fIfilename\fR .RS 4 -JARファイルにカプセル化されたプログラムを実行します。\fIfilename\fR引数は、使用するアプリケーションの開始点として機能する\fIpublic static void main(String[] args)\fRメソッドを定義する、\fIMain\-Class:\fR\fIclassname\fRという形式の1行を含むマニフェストを持つJARファイルの名前です。 +JARファイルにカプセル化されたプログラムを実行します。\fIfilename\fR引数は、使用するアプリケーションの開始点として機能する\fBpublic static void main(String[] args)\fRメソッドを定義する、\fBMain\-Class:\fR\fIclassname\fRという形式の1行を含むマニフェストを持つJARファイルの名前です。 .sp -\fI\-jar\fRオプションを使用すると、指定したJARファイルがすべてのユーザー・クラスのソースになり、クラス・パスの他の設定は無視されます。 +\fB\-jar\fRオプションを使用すると、指定したJARファイルがすべてのユーザー・クラスのソースになり、クラス・パスの他の設定は無視されます。 .sp JARファイルの詳細は、次のリソースを参照してください。 .sp @@ -391,7 +408,7 @@ .PP \-javaagent:\fIjarpath\fR[=\fIoptions\fR] .RS 4 -指定したJavaプログラミング言語エージェントをロードします。Javaアプリケーションのインストゥルメントの詳細は、http://docs\&.oracle\&.com/javase/8/docs/api/java/lang/instrument/package\-summary\&.htmlにあるJava APIドキュメントの\fIjava\&.lang\&.instrument\fRパッケージの説明を参照してください。 +指定したJavaプログラミング言語エージェントをロードします。Javaアプリケーションのインストゥルメントの詳細は、http://docs\&.oracle\&.com/javase/8/docs/api/java/lang/instrument/package\-summary\&.htmlにあるJava APIドキュメントの\fBjava\&.lang\&.instrument\fRパッケージの説明を参照してください。 .RE .PP \-jre\-restrict\-search @@ -414,18 +431,19 @@ .PP \-showversion .RS 4 -バージョン情報を表示し、アプリケーションの実行を続行します。このオプションは\fI\-version\fRオプションと同等ですが、\-versionはバージョン情報の表示後にJVMに終了を指示する点が異なります。 +バージョン情報を表示し、アプリケーションの実行を続行します。このオプションは\fB\-version\fRオプションと同等ですが、\-versionはバージョン情報の表示後にJVMに終了を指示する点が異なります。 .RE .PP \-splash:\fIimgname\fR .RS 4 -\fIimgname\fRで指定されたイメージを含むスプラッシュ画面を表示します。たとえば、アプリケーションの起動時に\fIimages\fRディレクトリの\fIsplash\&.gif\fRファイルを表示するには、次のオプションを使用します。 +\fIimgname\fRで指定されたイメージを含むスプラッシュ画面を表示します。たとえば、アプリケーションの起動時に\fBimages\fRディレクトリの\fBsplash\&.gif\fRファイルを表示するには、次のオプションを使用します。 .sp .if n \{\ .RS 4 .\} .nf -\-splash:images/splash\&.gif +\fB\-splash:images/splash\&.gif\fR + .fi .if n \{\ .RE @@ -449,29 +467,30 @@ .PP \-version .RS 4 -バージョン情報を表示してから終了します。このオプションは\fI\-showversion\fRオプションと同等ですが、\-showversionはバージョン情報の表示後にJVMに終了を指示しない点が異なります。 +バージョン情報を表示してから終了します。このオプションは\fB\-showversion\fRオプションと同等ですが、\-showversionはバージョン情報の表示後にJVMに終了を指示しない点が異なります。 .RE .PP \-version:\fIrelease\fR .RS 4 -アプリケーションの実行に使用するリリース・バージョンを指定します。コールされた\fIjava\fRコマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。 +アプリケーションの実行に使用するリリース・バージョンを指定します。コールされた\fBjava\fRコマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。 .sp \fIrelease\fR引数は、正確なバージョン文字列、または空白で区切られたバージョン文字列とバージョン範囲のリストを指定します。\fIバージョン文字列\fRは、次の形式で、開発者のバージョン番号を指定します: -\fI1\&.\fR\fIx\fR\fI\&.0_\fR\fIu\fR -(\fIx\fRはメジャー・バージョン番号、\fIu\fRは更新バージョン番号です)。\fIバージョン範囲\fRは、このバージョン以降を指定するにはバージョン文字列の後にプラス記号(\fI+\fR)を続けたもの、または一致する接頭辞を含む任意のバージョン文字列を指定するには一部のバージョン文字列の後にアスタリスク(\fI*\fR)を続けたもので構成されます。論理\fIOR\fRの組合せには空白、2つのバージョンの文字列/範囲の論理\fIAND\fRの組合せにはアンパサンド(\fI&\fR)を使用して、バージョン文字列とバージョン範囲を組み合せることができます。たとえば、クラスまたはJARファイルの実行にJRE 6u13 (1\&.6\&.0_13)または6u10 (1\&.6\&.0_10)以降の任意のJRE 6のいずれかを必要とする場合、次を指定します。 +\fB1\&.\fR\fIx\fR\fB\&.0_\fR\fIu\fR +(\fIx\fRはメジャー・バージョン番号、\fIu\fRは更新バージョン番号です)。\fIバージョン範囲\fRは、このバージョン以降を指定するにはバージョン文字列の後にプラス記号(\fB+\fR)を続けたもの、または一致する接頭辞を含む任意のバージョン文字列を指定するには一部のバージョン文字列の後にアスタリスク(\fB*\fR)を続けたもので構成されます。論理\fIOR\fRの組合せには空白、2つのバージョンの文字列/範囲の論理\fIAND\fRの組合せにはアンパサンド(\fB&\fR)を使用して、バージョン文字列とバージョン範囲を組み合せることができます。たとえば、クラスまたはJARファイルの実行にJRE 6u13 (1\&.6\&.0_13)または6u10 (1\&.6\&.0_10)以降の任意のJRE 6のいずれかを必要とする場合、次を指定します。 .sp .if n \{\ .RS 4 .\} .nf -\-version:"1\&.6\&.0_13 1\&.6* & 1\&.6\&.0_10+" +\fB\-version:"1\&.6\&.0_13 1\&.6* & 1\&.6\&.0_10+"\fR + .fi .if n \{\ .RE .\} 引用符が必要なのは、\fIrelease\fRパラメータに空白がある場合のみです。 .sp -JARファイルの場合は、バージョン要件をコマンドラインに指定するよりも、JARファイルのマニフェスト内に指定することが推奨されています。 +JARファイルの場合は、バージョン要件をコマンド行に指定するよりも、JARファイルのマニフェスト内に指定することが推奨されています。 .RE .SS "非標準オプション" .PP @@ -479,40 +498,35 @@ .PP \-X .RS 4 -使用可能なすべての\fI\-X\fRオプションのヘルプを表示します。 +使用可能なすべての\fB\-X\fRオプションのヘルプを表示します。 .RE .PP \-Xbatch .RS 4 -バックグラウンド・コンパイルを無効にします。デフォルトでは、JVMでは、バックグラウンド・コンパイルが終了するまで、メソッドをバックグラウンド・タスクとしてコンパイルし、インタプリタ・モードでメソッドを実行します。\fI\-Xbatch\fRフラグを指定すると、バックグラウンド・コンパイルが無効になり、すべてのメソッドのコンパイルが完了するまでフォアグラウンド・タスクとして処理されます。 +バックグラウンド・コンパイルを無効にします。デフォルトでは、JVMでは、バックグラウンド・コンパイルが終了するまで、メソッドをバックグラウンド・タスクとしてコンパイルし、インタプリタ・モードでメソッドを実行します。\fB\-Xbatch\fRフラグを指定すると、バックグラウンド・コンパイルが無効になり、すべてのメソッドのコンパイルが完了するまでフォアグラウンド・タスクとして処理されます。 .sp -このオプションは\fI\-XX:\-BackgroundCompilation\fRと同等です。 +このオプションは\fB\-XX:\-BackgroundCompilation\fRと同等です。 .RE .PP \-Xbootclasspath:\fIpath\fR .RS 4 ブート・クラス・ファイルを検索するディレクトリ、JARファイルおよびZIPアーカイブの、コロン(:)で区切られたリストを指定します。これらは、JDKに含まれるブート・クラス・ファイルのかわりに使用されます。 .sp -JREバイナリ・コード・ライセンスに違反するため、\fIrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 +JREバイナリ・コード・ライセンスに違反するため、\fBrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 .RE .PP \-Xbootclasspath/a:\fIpath\fR .RS 4 デフォルトのブートストラップ・クラス・パスの最後に追加するディレクトリ、JARファイルおよびZIPアーカイブの、コロン(:)で区切られたリストを指定します。 .sp -JREバイナリ・コード・ライセンスに違反するため、\fIrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 +JREバイナリ・コード・ライセンスに違反するため、\fBrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 .RE .PP \-Xbootclasspath/p:\fIpath\fR .RS 4 デフォルトのブートストラップ・クラス・パスの先頭に追加するディレクトリ、JARファイルおよびZIPアーカイブの、コロン(:)で区切られたリストを指定します。 .sp -JREバイナリ・コード・ライセンスに違反するため、\fIrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 -.RE -.PP -\-Xboundthreads -.RS 4 -ユーザー・レベルのスレッドをカーネル・スレッドにバインドします。 +JREバイナリ・コード・ライセンスに違反するため、\fBrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 .RE .PP \-Xcheck:jni @@ -522,14 +536,14 @@ .PP \-Xcomp .RS 4 -最初の呼出しでJavaコードおよびコンパイル・メソッドの解釈を無効にします。デフォルトでは、JITコンパイラは、10,000の解釈されたメソッド呼出しを実行して、効率的なコンパイルのための情報を収集します。効率を犠牲にしてコンパイルのパフォーマンスを向上させるには、\fI\-Xcomp\fRフラグを使用して、解釈されたメソッド呼出しを無効にします。 +最初の呼出しでメソッドのコンパイルを強制的に実行します。デフォルトでは、クライアントVM(\fB\-client\fR)は1,000の解釈されたメソッド呼出しを実行し、サーバーVM(\fB\-server\fR)は10,000の解釈されたメソッド呼出しを実行して、効率的なコンパイルのための情報を収集します。\fB\-Xcomp\fRオプションを指定すると、解釈されたメソッド呼出しが無効になり、効率を犠牲にしてコンパイルのパフォーマンスが向上します。 .sp -\fI\-XX:CompileThreshold\fRオプションを使用して、コンパイルの前に、解釈されたメソッド呼出しの数を変更することもできます。 +\fB\-XX:CompileThreshold\fRオプションを使用して、コンパイルの前に、解釈されたメソッド呼出しの数を変更することもできます。 .RE .PP \-Xdebug .RS 4 -何も行いません。下位互換性のために用意されています。 +何も行いません。後方互換性のために用意されています。 .RE .PP \-Xdiag @@ -542,11 +556,6 @@ クラス・ファイル形式の仕様への準拠を強化する、厳密なクラス・ファイル形式のチェックが有効になります。将来のリリースでは、より厳密なチェックがデフォルトになるため、新しいコードを開発するときには、開発者はこのフラグを使用することをお薦めします。 .RE .PP -\-Xincgc -.RS 4 -増分GCを有効にします。 -.RE -.PP \-Xint .RS 4 インタプリタ専用モードでアプリケーションを実行します。ネイティブ・コードへのコンパイルは無効になり、すべてのバイトコードがインタプリタによって実行されます。ジャスト・イン・タイム(JIT)コンパイラが提供するパフォーマンス上の利点は、このモードでは実現されません。 @@ -554,12 +563,12 @@ .PP \-Xinternalversion .RS 4 -\fI\-version\fRオプションより詳細なJVMバージョン情報を表示してから終了します。 +\fB\-version\fRオプションより詳細なJVMバージョン情報を表示してから終了します。 .RE .PP \-Xloggc:\fIfilename\fR .RS 4 -詳細なGCイベント情報をロギング用にリダイレクトするファイルを設定します。このファイルに書き込まれる情報は、記録された各イベントの前に行われる最初のGCイベント以降に経過した時間を指定した\fI\-verbose:gc\fRの出力と類似しています。\fI\-Xloggc\fRオプションは\fI\-verbose:gc\fRをオーバーライドします(これらの両方が同じ\fIjava\fRコマンドで指定された場合)。 +詳細なGCイベント情報をロギング用にリダイレクトするファイルを設定します。このファイルに書き込まれる情報は、記録された各イベントの前に行われる最初のGCイベント以降に経過した時間を指定した\fB\-verbose:gc\fRの出力と類似しています。\fB\-Xloggc\fRオプションは\fB\-verbose:gc\fRをオーバーライドします(これらの両方が同じ\fBjava\fRコマンドで指定された場合)。 .sp 例: .sp @@ -567,7 +576,8 @@ .RS 4 .\} .nf -\-Xloggc:garbage\-collection\&.log +\fB\-Xloggc:garbage\-collection\&.log\fR + .fi .if n \{\ .RE @@ -576,18 +586,19 @@ .PP \-Xmaxjitcodesize=\fIsize\fR .RS 4 -JITコンパイルされたコードの最大コード・キャッシュ・サイズ(バイト単位)を指定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、この値は48MBに設定されています。 +JITコンパイルされたコードの最大コード・キャッシュ・サイズ(バイト単位)を指定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、この値は48MBに設定されています。 .sp .if n \{\ .RS 4 .\} .nf -\-Xmaxjitcodesize=48m +\fB\-Xmaxjitcodesize=48m\fR + .fi .if n \{\ .RE .\} -このオプションは\fI\-XX:ReservedCodeCacheSize\fRと同等です。 +このオプションは\fB\-XX:ReservedCodeCacheSize\fRと同等です。 .RE .PP \-Xmixed @@ -597,7 +608,7 @@ .PP \-Xmn\fIsize\fR .RS 4 -若い世代(ナーサリ)のヒープの初期サイズおよび最大サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。 +若い世代(ナーサリ)のヒープの初期サイズおよび最大サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。 .sp ヒープの若い世代リージョンは新しいオブジェクトに使用されます。GCは、他のリージョンよりこのリージョンで、より頻繁に実行されます。若い世代のサイズが小さすぎる場合、多数のマイナー・ガベージ・コレクションが実行されます。サイズが大きすぎる場合、フル・ガベージ・コレクションのみが実行されますが、完了までに時間がかかることがあります。若い世代のサイズは、全体のヒープ・サイズの半分から4分の1の間にしておくことをお薦めします。 .sp @@ -607,19 +618,20 @@ .RS 4 .\} .nf -\-Xmn256m -\-Xmn262144k -\-Xmn268435456 +\fB\-Xmn256m\fR +\fB\-Xmn262144k\fR +\fB\-Xmn268435456\fR + .fi .if n \{\ .RE .\} -若い世代のヒープの初期サイズと最大サイズの両方を設定する\fI\-Xmn\fRオプションのかわりに、初期サイズの設定には\fI\-XX:NewSize\fRを、最大サイズの設定には\fI\-XX:MaxNewSize\fRを使用できます。 +若い世代のヒープの初期サイズと最大サイズの両方を設定する\fB\-Xmn\fRオプションのかわりに、初期サイズの設定には\fB\-XX:NewSize\fRを、最大サイズの設定には\fB\-XX:MaxNewSize\fRを使用できます。 .RE .PP \-Xms\fIsize\fR .RS 4 -ヒープの初期サイズ(バイト単位)を設定します。指定する値は、1MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。 +ヒープの初期サイズ(バイト単位)を設定します。指定する値は、1MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。 .sp 次の例では、割り当てられたメモリーのサイズを様々な単位を使用して6MBに設定する方法を示します。 .sp @@ -627,19 +639,20 @@ .RS 4 .\} .nf -\-Xms6291456 -\-Xms6144k -\-Xms6m +\fB\-Xms6291456\fR +\fB\-Xms6144k\fR +\fB\-Xms6m\fR + .fi .if n \{\ .RE .\} -このオプションを設定しない場合、初期サイズは、古い世代と若い世代に割り当てられたサイズの合計として設定されます。若い世代のヒープの初期サイズは、\fI\-Xmn\fRオプションまたは\fI\-XX:NewSize\fRオプションを使用して設定できます。 +このオプションを設定しない場合、初期サイズは、古い世代と若い世代に割り当てられたサイズの合計として設定されます。若い世代のヒープの初期サイズは、\fB\-Xmn\fRオプションまたは\fB\-XX:NewSize\fRオプションを使用して設定できます。 .RE .PP \-Xmx\fIsize\fR .RS 4 -メモリー割当てプールの最大サイズ(バイト単位)を指定します。指定する値は、2MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。サーバー・デプロイメントでは、\fI\-Xms\fRおよび\fI\-Xmx\fRは通常同じ値に設定されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 +メモリー割当てプールの最大サイズ(バイト単位)を指定します。指定する値は、2MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。サーバー・デプロイメントでは、\fB\-Xms\fRおよび\fB\-Xmx\fRは通常同じ値に設定されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 .sp 次の例では、割り当てられたメモリーの許可される最大サイズを様々な単位を使用して80MBに設定する方法を示します。 .sp @@ -647,26 +660,27 @@ .RS 4 .\} .nf -\-Xmx83886080 -\-Xmx81920k -\-Xmx80m +\fB\-Xmx83886080\fR +\fB\-Xmx81920k\fR +\fB\-Xmx80m\fR + .fi .if n \{\ .RE .\} -\fI\-Xmx\fRオプションは\fI\-XX:MaxHeapSize\fRと同等です。 +\fB\-Xmx\fRオプションは\fB\-XX:MaxHeapSize\fRと同等です。 .RE .PP \-Xnoclassgc .RS 4 クラスのガベージ・コレクション(GC)を無効にします。これにより、GC時間を節約でき、アプリケーション実行中の中断が短縮されます。 .sp -起動時に\fI\-Xnoclassgc\fRを指定すると、アプリケーション内のクラス・オブジェクトは、GCの間はそのまま残り、常にライブであるとみなされます。これにより、より多くのメモリーが永久に占有されることになり、注意して使用しないと、メモリー不足の例外がスローされます。 +起動時に\fB\-Xnoclassgc\fRを指定すると、アプリケーション内のクラス・オブジェクトは、GCの間はそのまま残り、常にライブであるとみなされます。これにより、より多くのメモリーが永久に占有されることになり、注意して使用しないと、メモリー不足の例外がスローされます。 .RE .PP \-Xprof .RS 4 -実行中のプログラムのプロファイルを生成し、プロファイル・データを標準出力に送信します。このオプションは、プログラム開発用のユーティリティとして提供されています。本番稼働システムでの使用を目的としたものではありません。 +実行中のプログラムをプロファイルし、プロファイリング・データを標準出力に送信します。このオプションは、プログラム開発用のユーティリティとして提供されています。本番稼働システムでの使用を目的としたものではありません。 .RE .PP \-Xrs @@ -675,13 +689,13 @@ .sp シャットダウン・フックは、JVMが突然終了した場合でも、シャットダウン時にユーザー・クリーンアップ・コード(データベース接続のクローズなど)を実行することによって、Javaアプリケーションのシャットダウンを順番に有効にします。 .sp -JVMは、予期しない終了のシャットダウン・フックを実装するためにシグナルをキャッチします。JVMは、\fISIGHUP\fR、\fISIGINT\fRおよび\fISIGTERM\fRを使用して、シャットダウン・フックの実行を開始します。 +JVMは、予期しない終了のシャットダウン・フックを実装するためにシグナルをキャッチします。JVMは、\fBSIGHUP\fR、\fBSIGINT\fRおよび\fBSIGTERM\fRを使用して、シャットダウン・フックの実行を開始します。 .sp -JVMは、デバッグの目的でスレッド・スタックをダンプするという機能を実現するために、同様のメカニズムを使用します。JVMは、スレッド・ダンプを実行するために\fISIGQUIT\fRを使用します。 +JVMは、デバッグの目的でスレッド・スタックをダンプするという機能を実現するために、同様のメカニズムを使用します。JVMは、スレッド・ダンプを実行するために\fBSIGQUIT\fRを使用します。 .sp -JVMを埋め込んでいるアプリケーションは、\fISIGINT\fRや\fISIGTERM\fRなどのシグナルを頻繁にトラップする必要があり、その結果、JVMのシグナル・ハンドラと衝突する可能性があります。\fI\-Xrs\fRオプションは、この問題に対処するために使用できます。\fI\-Xrs\fRが使用されている場合、\fISIGINT\fR、\fISIGTERM\fR、\fISIGHUP\fRおよび\fISIGQUIT\fRのシグナル・マスクはJVMによって変更されず、これらのシグナルのシグナル・ハンドラはインストールされません。 +JVMを埋め込んでいるアプリケーションは、\fBSIGINT\fRや\fBSIGTERM\fRなどのシグナルを頻繁にトラップする必要があり、その結果、JVMのシグナル・ハンドラと衝突する可能性があります。\fB\-Xrs\fRオプションは、この問題に対処するために使用できます。\fB\-Xrs\fRが使用されている場合、\fBSIGINT\fR、\fBSIGTERM\fR、\fBSIGHUP\fRおよび\fBSIGQUIT\fRのシグナル・マスクはJVMによって変更されず、これらのシグナルのシグナル・ハンドラはインストールされません。 .sp -\fI\-Xrs\fRを指定すると、次の2つの結果が生じます: +\fB\-Xrs\fRを指定すると、次の2つの結果が生じます: .sp .RS 4 .ie n \{\ @@ -691,7 +705,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fISIGQUIT\fRによるスレッド・ダンプは使用できません。 +\fBSIGQUIT\fRによるスレッド・ダンプは使用できません。 .RE .sp .RS 4 @@ -702,7 +716,7 @@ .sp -1 .IP \(bu 2.3 .\} -シャットダウン・フック処理の実行は、JVMが終了しようとしている時点で\fISystem\&.exit()\fRを呼び出すなどして、ユーザー・コード側で行う必要があります。 +シャットダウン・フック処理の実行は、JVMが終了しようとしている時点で\fBSystem\&.exit()\fRを呼び出すなどして、ユーザー・コード側で行う必要があります。 .RE .RE .PP @@ -758,7 +772,7 @@ .PP \-Xss\fIsize\fR .RS 4 -スレッドのスタック・サイズ(バイト単位)を設定します。KBを示す場合は文字\fIk\fRまたは\fIK\fR、MBを示す場合は文字\fIm\fRまたは\fIM\fR、GBを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値はプラットフォームによって異なります。 +スレッドのスタック・サイズ(バイト単位)を設定します。KBを示す場合は文字\fBk\fRまたは\fBK\fR、MBを示す場合は文字\fBm\fRまたは\fBM\fR、GBを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値はプラットフォームによって異なります。 .sp .RS 4 .ie n \{\ @@ -843,19 +857,20 @@ .RS 4 .\} .nf -\-Xss1m -\-Xss1024k -\-Xss1048576 +\fB\-Xss1m\fR +\fB\-Xss1024k\fR +\fB\-Xss1048576\fR + .fi .if n \{\ .RE .\} -このオプションは\fI\-XX:ThreadStackSize\fRと同等です。 +このオプションは\fB\-XX:ThreadStackSize\fRと同等です。 .RE .PP \-Xusealtsigs .RS 4 -JVM内部シグナルの\fISIGUSR1\fRおよび\fISIGUSR2\fRのかわりに、代替シグナルを使用します。このオプションは\fI\-XX:+UseAltSigs\fRと同等です。 +JVM内部シグナルの\fBSIGUSR1\fRおよび\fBSIGUSR2\fRのかわりに、代替シグナルを使用します。このオプションは\fB\-XX:+UseAltSigs\fRと同等です。 .RE .PP \-Xverify:\fImode\fR @@ -869,7 +884,7 @@ .PP remote .RS 4 -ネットワークを介してリモートでロードされるクラスのみを検証します。これは、\fI\-Xverify\fRオプションを指定しない場合のデフォルトの動作です。 +ネットワークを介してリモートでロードされるクラスのみを検証します。これは、\fB\-Xverify\fRオプションを指定しない場合のデフォルトの動作です。 .RE .PP all @@ -883,40 +898,47 @@ .PP \-XX:+DisableAttachMechanism .RS 4 -JVMにツールをアタッチするメカニズムを無効にするオプションを有効にします。デフォルトでは、このオプションは無効になっており、これは、アタッチ・メカニズムを有効にすると、\fIjcmd\fR、\fIjstack\fR、\fIjmap\fR、\fIjinfo\fRなどのツールを使用できることを意味します。 +JVMにツールをアタッチするメカニズムを無効にするオプションを有効にします。デフォルトでは、このオプションは無効になっており、これは、アタッチ・メカニズムを有効にすると、\fBjcmd\fR、\fBjstack\fR、\fBjmap\fR、\fBjinfo\fRなどのツールを使用できることを意味します。 .RE .PP \-XX:ErrorFile=\fIfilename\fR .RS 4 -リカバリ不能なエラーが発生した場合にエラー・データが書き込まれるパスおよびファイル名を指定します。デフォルトでは、このファイルは、現在の作業ディレクトリに作成され、名前は\fIhs_err_pid\fR\fIpid\fR\fI\&.log\fR -(\fIpid\fRはエラーの原因となったプロセスの識別子)になります。次の例では、デフォルトのログ・ファイルを設定する方法を示します(プロセスの識別子は\fI%p\fRとして指定されます)。 +リカバリ不能なエラーが発生した場合にエラー・データが書き込まれるパスおよびファイル名を指定します。デフォルトでは、このファイルは、現在の作業ディレクトリに作成され、名前は\fBhs_err_pid\fR\fIpid\fR\fB\&.log\fR +(\fIpid\fRはエラーの原因となったプロセスの識別子)になります。次の例では、デフォルトのログ・ファイルを設定する方法を示します(プロセスの識別子は\fB%p\fRとして指定されます)。 .sp .if n \{\ .RS 4 .\} .nf -\-XX:ErrorFile=\&./hs_err_pid%p\&.log +\fB\-XX:ErrorFile=\&./hs_err_pid%p\&.log\fR + .fi .if n \{\ .RE .\} -次の例では、エラー・ログを\fI/var/log/java/java_error\&.log\fRに設定する方法を示します。 +次の例では、エラー・ログを\fB/var/log/java/java_error\&.log\fRに設定する方法を示します。 .sp .if n \{\ .RS 4 .\} .nf -\-XX:ErrorFile=/var/log/java/java_error\&.log +\fB\-XX:ErrorFile=/var/log/java/java_error\&.log\fR + .fi .if n \{\ .RE .\} -(領域不足、権限の問題または別の問題により)指定したディレクトリにファイルを作成できない場合、ファイルはオペレーティング・システムの一時ディレクトリに作成されます。一時ディレクトリは\fI/tmp\fRです。 +(領域不足、権限の問題または別の問題により)指定したディレクトリにファイルを作成できない場合、ファイルはオペレーティング・システムの一時ディレクトリに作成されます。一時ディレクトリは\fB/tmp\fRです。 +.RE +.PP +\-XX:+FailOverToOldVerifier +.RS 4 +新しいタイプ・チェッカが失敗した場合の、古いベリファイアへの自動フェイルオーバーを有効にします。デフォルトでは、このオプションは無効になっており、最近のバイトコード・バージョンを使用したクラスには、これは無視されます(つまり、無効として処理されます)。古いバージョンのバイトコードを使用したクラスには、これを有効化できます。 .RE .PP \-XX:LargePageSizeInBytes=\fIsize\fR .RS 4 -Javaヒープに使用される大きいページの最大サイズ(バイト単位)を設定します。\fIsize\fR引数は、2の累乗(2、4、8、16、\&.\&.\&.)である必要があります。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、サイズは0に設定され、これは、JVMでは大きいページのサイズが自動的に選択されていることを意味します。 +Javaヒープに使用される大きいページの最大サイズ(バイト単位)を設定します。\fIsize\fR引数は、2の累乗(2、4、8、16、\&.\&.\&.)である必要があります。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、サイズは0に設定され、これは、JVMでは大きいページのサイズが自動的に選択されていることを意味します。 .sp 次の例では、大きいページのサイズを4メガバイト(MB)に設定する方法を示します。 .sp @@ -924,7 +946,8 @@ .RS 4 .\} .nf -\-XX:LargePageSizeInBytes=4m +\fB\-XX:LargePageSizeInBytes=4m\fR + .fi .if n \{\ .RE @@ -933,7 +956,7 @@ .PP \-XX:MaxDirectMemorySize=\fIsize\fR .RS 4 -新規I/O (\fIjava\&.nio\fRパッケージ)の直接バッファ割当ての最大合計サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、サイズは0に設定され、これは、JVMではNIOの直接バッファ割当てのサイズが自動的に選択されていることを意味します。 +新規I/O (\fBjava\&.nio\fRパッケージ)の直接バッファ割当ての最大合計サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、サイズは0に設定され、これは、JVMではNIOの直接バッファ割当てのサイズが自動的に選択されていることを意味します。 .sp 次の例では、NIOサイズを異なる単位で1024KBに設定する方法を示します。 .sp @@ -941,9 +964,10 @@ .RS 4 .\} .nf -\-XX:MaxDirectMemorySize=1m -\-XX:MaxDirectMemorySize=1024k -\-XX:MaxDirectMemorySize=1048576 +\fB\-XX:MaxDirectMemorySize=1m\fR +\fB\-XX:MaxDirectMemorySize=1024k\fR +\fB\-XX:MaxDirectMemorySize=1048576\fR + .fi .if n \{\ .RE @@ -956,7 +980,7 @@ .PP off .RS 4 -JVMのネイティブ・メモリー使用状況を追跡しません。これは、\fI\-XX:NativeMemoryTracking\fRオプションを指定しない場合のデフォルトの動作です。 +JVMのネイティブ・メモリー使用状況を追跡しません。これは、\fB\-XX:NativeMemoryTracking\fRオプションを指定しない場合のデフォルトの動作です。 .RE .PP summary @@ -966,7 +990,7 @@ .PP detail .RS 4 -JVMサブシステムによるメモリー使用状況のトラッキングに加えて、個々の\fICallSite\fR +JVMサブシステムによるメモリー使用状況のトラッキングに加えて、個々の\fBCallSite\fR (個々の仮想メモリー・リージョンおよびそのコミット済リージョン)によるメモリー使用状況を追跡します。 .RE .RE @@ -975,13 +999,14 @@ .RS 4 リカバリ不能なエラーが発生したときに実行する、カスタム・コマンドまたは一連のセミコロン区切りのコマンドを設定します。文字列に空白が含まれている場合は、引用符で囲む必要があります。 .sp -次の例では、\fI\-XX:OnError\fRオプションを使用してコア・イメージを作成するために\fIgcore\fRコマンドを実行する方法、およびリカバリ不能なエラーの場合にデバッガを起動してプロセスに接続する方法を示します(\fI%p\fRは現在のプロセスを指定します)。 +次の例では、\fB\-XX:OnError\fRオプションを使用してコア・イメージを作成するために\fBgcore\fRコマンドを実行する方法、およびリカバリ不能なエラーの場合にデバッガを起動してプロセスに接続する方法を示します(\fB%p\fRは現在のプロセスを指定します)。 .sp .if n \{\ .RS 4 .\} .nf -\-XX:OnError="gcore %p;dbx \- %p" +\fB\-XX:OnError="gcore %p;dbx \- %p"\fR + .fi .if n \{\ .RE @@ -990,17 +1015,22 @@ .PP \-XX:OnOutOfMemoryError=\fIstring\fR .RS 4 -\fIOutOfMemoryError\fR例外が最初にスローされたときに実行する、カスタム・コマンドまたは一連のセミコロン区切りのコマンドを設定します。文字列に空白が含まれている場合は、引用符で囲む必要があります。コマンド文字列の例は、\fI\-XX:OnError\fRオプションの説明を参照してください。 +\fBOutOfMemoryError\fR例外が最初にスローされたときに実行する、カスタム・コマンドまたは一連のセミコロン区切りのコマンドを設定します。文字列に空白が含まれている場合は、引用符で囲む必要があります。コマンド文字列の例は、\fB\-XX:OnError\fRオプションの説明を参照してください。 .RE .PP \-XX:+PrintCommandLineFlags .RS 4 -コマンドラインに表示された、人間工学的に選択したJVMフラグの印刷を有効にします。これは、ヒープ領域サイズや選択されたガベージ・コレクタなど、JVMによって設定されたエルゴノミック値を確認する場合に役立ちます。デフォルトでは、このオプションは無効であり、フラグは印刷されません。 +コマンド行に表示された、人間工学的に選択したJVMフラグの印刷を有効にします。これは、ヒープ領域サイズや選択されたガベージ・コレクタなど、JVMによって設定されたエルゴノミック値を確認する場合に役立ちます。デフォルトでは、このオプションは無効であり、フラグは印刷されません。 .RE .PP \-XX:+PrintNMTStatistics .RS 4 -ネイティブ・メモリーのトラッキングが有効な場合に、JVMの終了時に収集されたネイティブ・メモリーのトラッキング・データの印刷を有効にします(\fI\-XX:NativeMemoryTracking\fRを参照してください)。デフォルトでは、このオプションは無効であり、ネイティブ・メモリーのトラッキング・データは印刷されません。 +ネイティブ・メモリーのトラッキングが有効な場合に、JVMの終了時に収集されたネイティブ・メモリーのトラッキング・データの印刷を有効にします(\fB\-XX:NativeMemoryTracking\fRを参照してください)。デフォルトでは、このオプションは無効であり、ネイティブ・メモリーのトラッキング・データは印刷されません。 +.RE +.PP +\-XX:+RelaxAccessControlCheck +.RS 4 +ベリファイア内のアクセス制御チェックの量を減らします。デフォルトでは、このオプションは無効になっており、最近のバイトコード・バージョンを使用したクラスには、これは無視されます(つまり、無効として処理されます)。古いバージョンのバイトコードを使用したクラスには、これを有効化できます。 .RE .PP \-XX:+ShowMessageBoxOnError @@ -1010,7 +1040,7 @@ .PP \-XX:ThreadStackSize=\fIsize\fR .RS 4 -スレッドのスタック・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値はプラットフォームによって異なります。 +スレッドのスタック・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値はプラットフォームによって異なります。 .sp .RS 4 .ie n \{\ @@ -1095,14 +1125,15 @@ .RS 4 .\} .nf -\-XX:ThreadStackSize=1m -\-XX:ThreadStackSize=1024k -\-XX:ThreadStackSize=1048576 +\fB\-XX:ThreadStackSize=1m\fR +\fB\-XX:ThreadStackSize=1024k\fR +\fB\-XX:ThreadStackSize=1048576\fR + .fi .if n \{\ .RE .\} -このオプションは\fI\-Xss\fRと同等です。 +このオプションは\fB\-Xss\fRと同等です。 .RE .PP \-XX:+TraceClassLoading @@ -1132,14 +1163,14 @@ .PP \-XX:+UseAltSigs .RS 4 -JVM内部シグナルの\fISIGUSR1\fRおよび\fISIGUSR2\fRのかわりに、代替シグナルの使用を有効にします。デフォルトでは、このオプションは無効であり、代替シグナルは使用されません。このオプションは\fI\-Xusealtsigs\fRと同等です。 +JVM内部シグナルの\fBSIGUSR1\fRおよび\fBSIGUSR2\fRのかわりに、代替シグナルの使用を有効にします。デフォルトでは、このオプションは無効であり、代替シグナルは使用されません。このオプションは\fB\-Xusealtsigs\fRと同等です。 .RE .PP \-XX:+UseBiasedLocking .RS 4 バイアス・ロックの使用を有効にします。かなりの量の非競合の同期化がある一部のアプリケーションは、このフラグを有効にすると大幅な高速化が実現しますが、特定のパターンのロックがあるアプリケーションは、速度が低下することがあります。バイアス・ロックの方法の詳細は、http://www\&.oracle\&.com/technetwork/java/tuning\-139912\&.html#section4\&.2\&.5にあるJavaチューニングのホワイト・ペーパーの例を参照してください。 .sp -デフォルトでは、このオプションは無効であり、バイアス・ロックは使用されません。 +デフォルトでは、このオプションは有効になっています。 .RE .PP \-XX:+UseCompressedOops @@ -1151,19 +1182,19 @@ .PP \-XX:+UseLargePages .RS 4 -大きいページのメモリーの使用を有効にします。このオプションはデフォルトで有効になっています。大きいページのメモリーの使用を無効にするには、\fI\-XX:\-UseLargePages\fRを指定します。 +大きいページのメモリーの使用を有効にします。このオプションはデフォルトで有効になっています。大きいページのメモリーの使用を無効にするには、\fB\-XX:\-UseLargePages\fRを指定します。 .sp 詳細は、http://www\&.oracle\&.com/technetwork/java/javase/tech/largememory\-jsp\-137182\&.htmlにある大きいメモリー・ページ用のJavaサポートを参照してください。 .RE .PP \-XX:+UseMembar .RS 4 -スレッドの状態の遷移でメンバーの発行を有効にします。このオプションは、有効になっているPower PCおよびARMサーバーを除くすべてのプラットフォーム上で、デフォルトでは無効になっています。Power PCとARMのスレッド状態遷移に対するメンバーの発行を無効にするには、\fI\-XX:\-UseMembar\fRを指定します。 +スレッドの状態の遷移でメンバーの発行を有効にします。このオプションは、有効になっているARMサーバーを除くすべてのプラットフォーム上で、デフォルトでは無効になっています。(ARMサーバーでこのオプションを無効にしないことをお薦めします。) .RE .PP \-XX:+UsePerfData .RS 4 -\fIperfdata\fR機能を有効にします。このオプションはデフォルトで有効になっており、JVMのモニタリングおよびパフォーマンス・テストが可能になります。これを無効にすると、\fIhsperfdata_userid\fRディレクトリの作成を抑制します。\fIperfdata\fR機能を無効にするには、\fI\-XX:\-UsePerfData\fRを指定します。 +\fBperfdata\fR機能を有効にします。このオプションはデフォルトで有効になっており、JVMのモニタリングおよびパフォーマンス・テストが可能になります。これを無効にすると、\fBhsperfdata_userid\fRディレクトリの作成を抑制します。\fBperfdata\fR機能を無効にするには、\fB\-XX:\-UsePerfData\fRを指定します。 .RE .PP \-XX:+AllowUserSignalHandlers @@ -1187,530 +1218,20 @@ .RS 4 .\} .nf -\-XX:AllocateInstancePrefetchLines=1 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:AllocatePrefetchInstr=\fIinstruction\fR -.RS 4 -割当てポインタの前にプリフェッチするプリフェッチ命令を設定します。使用可能な値は0から3までです。値の背後にある実際の命令は、プラットフォームによって異なります。デフォルトでは、プリフェッチ命令は0に設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:AllocatePrefetchInstr=0 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:AllocatePrefetchStepSize=\fIsize\fR -.RS 4 -順次プリフェッチ命令のステップ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、ステップ・サイズは16バイトに設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:AllocatePrefetchStepSize=16 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+BackgroundCompilation -.RS 4 -バックグラウンド・コンパイルを有効にします。このオプションはデフォルトで有効になっています。バックグラウンド・コンパイルを無効にするには、\fI\-XX:\-BackgroundCompilation\fRを指定します(これは\fI\-Xbatch\fRを指定するのと同等です)。 -.RE -.PP -\-XX:CICompilerCount=\fIthreads\fR -.RS 4 -コンパイルに使用するコンパイラ・スレッドの数を設定します。デフォルトでは、スレッド数は、サーバーJVMの場合は2、クライアントJVMの場合は1に設定されており、層コンパイルが使用されている場合、コア数に合せて増減します。次の例では、スレッドの数を2に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CICompilerCount=2 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:CodeCacheMinimumFreeSpace=\fIsize\fR -.RS 4 -コンパイルに必要な最小空き領域(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。最小空き領域より少ない領域しか残っていない場合、コンパイルは停止します。デフォルトでは、このオプションは500KBに設定されています。次の例では、最小空き領域を1024MBに設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CodeCacheMinimumFreeSpace=1024m -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:CompileCommand=\fIcommand\fR,\fImethod\fR[,\fIoption\fR] -.RS 4 -メソッドで実行するコマンドを指定します。たとえば、コンパイル元から\fIString\fRクラスの\fIindexOf()\fRメソッドを実行するには、次を使用します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand=exclude,java/lang/String\&.indexOf -.fi -.if n \{\ -.RE -.\} -スラッシュ(\fI/\fR)で区切られたすべてのパッケージおよびサブパッケージを含む、完全クラス名を指定します。切取りと貼付けの操作を容易にするために、\fI\-XX:+PrintCompilation\fRオプションおよび\fI\-XX:+LogCompilation\fRオプションによって生成されるメソッド名の形式を使用することもできます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand=exclude,java\&.lang\&.String::indexOf -.fi -.if n \{\ -.RE -.\} -署名なしでメソッドを指定すると、コマンドは指定した名前を持つすべてのメソッドに適用されます。ただし、クラス・ファイル形式でメソッドの署名を指定することもできます。たとえば、コンパイル元から\fIString\fRクラスの\fIindexOf(String)\fRメソッドのみ除外するには、次を使用します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand=exclude,java/lang/String\&.indexOf(Ljava/lang/String;)I -.fi -.if n \{\ -.RE -.\} -また、クラス名およびメソッド名にワイルドカードとしてアスタリスク(*)を使用できます。たとえば、コンパイル元からすべてのクラスのすべての\fIindexOf()\fRメソッドを除外するには、次を使用します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand=exclude,*\&.indexOf -.fi -.if n \{\ -.RE -.\} -カンマとピリオドは空白の別名で、これにより、シェルを介してコンパイラ・コマンドを渡すことが容易になります。引数を引用符で囲むことで、空白をセパレータとして使用して\fI\-XX:CompileCommand\fRに引数を渡すことができます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand="exclude java/lang/String indexOf" -.fi -.if n \{\ -.RE -.\} -\fI\-XX:CompileCommand\fRオプションを使用してコマンドラインで渡されたコマンドを解析した後に、JITコンパイラは\fI\&.hotspot_compiler\fRファイルからコマンドを読み取ります。このファイルにコマンドを追加するか、または\fI\-XX:CompileCommandFile\fRオプションを使用して別のファイルを指定することができます。 -.sp -複数のコマンドを追加するには、\fI\-XX:CompileCommand\fRオプションを複数回指定するか、または改行セパレータ(\fI\en\fR)を使用して各引数を区切ります。次のコマンドを使用できます。 -.PP -break -.RS 4 -指定したメソッドのコンパイルの最初に停止するために、JVMのデバッグ時のブレークポイントを設定します。 -.RE -.PP -compileonly -.RS 4 -指定したメソッドを除いたすべてのメソッドを、コンパイルから除外します。別の方法として、\fI\-XX:CompileOnly\fRオプションを使用して複数のメソッドを指定できます。 -.RE -.PP -dontinline -.RS 4 -指定したメソッドをインライン化しないようにします。 -.RE -.PP -exclude -.RS 4 -指定したメソッドをコンパイルから除外します。 -.RE -.PP -help -.RS 4 -\fI\-XX:CompileCommand\fRオプションのヘルプ・メッセージを印刷します。 -.RE -.PP -inline -.RS 4 -指定したメソッドをインライン化しようとします。 -.RE -.PP -log -.RS 4 -指定したメソッドを除くすべてのメソッドに対して、(\fI\-XX:+LogCompilation\fRオプションを使用して)コンパイル・ロギングを除外します。デフォルトでは、コンパイルされたすべてのメソッドにロギングが実行されます。 -.RE -.PP -option -.RS 4 -このコマンドは、最後の引数(\fIoption\fR)のかわりに、指定したメソッドにJITコンパイル・オプションを渡すために使用できます。コンパイル・オプションは、メソッド名の後の末尾に設定されます。たとえば、\fIStringBuffer\fRクラスの\fIappend()\fRメソッドに対して\fIBlockLayoutByFrequency\fRオプションを有効にするには、次を使用します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand=option,java/lang/StringBuffer\&.append,BlockLayoutByFrequency -.fi -.if n \{\ -.RE -.\} -カンマまたは空白で区切って、複数のコンパイル・オプションを指定できます。 -.RE -.PP -print -.RS 4 -指定したメソッドのコンパイル後に生成されたアセンブラ・コードを出力します。 -.RE -.PP -quiet -.RS 4 -コンパイル・コマンドを出力しません。デフォルトでは、\fI\-XX:CompileCommand\fRオプションを使用して指定したコマンドが出力されます。たとえば、\fIString\fRクラスの\fIindexOf()\fRメソッドのコンパイルから除外する場合、次が標準出力に出力されます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -CompilerOracle: exclude java/lang/String\&.indexOf -.fi -.if n \{\ -.RE -.\} -他の\fI\-XX:CompileCommand\fRオプションの前に\fI\-XX:CompileCommand=quiet\fRオプションを指定することによって、これを抑制できます。 -.RE -.RE -.PP -\-XX:CompileCommandFile=\fIfilename\fR -.RS 4 -JITコンパイラ・コマンドの読取り元のファイルを設定します。デフォルトでは、JITコンパイラによって実行されるコマンドを格納するために、\fI\&.hotspot_compiler\fRファイルが使用されます。 -.sp -コマンド・ファイルの各行は、コマンドが使用されるコマンド、クラス名およびメソッド名を表します。たとえば、次の行は、\fIString\fRクラスの\fItoString()\fRメソッドに対してアセンブリ・コードを出力します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -print java/lang/String toString -.fi -.if n \{\ -.RE -.\} -メソッドで実行するJITコンパイラのコマンドの指定の詳細は、\fI\-XX:CompileCommand\fRオプションを参照してください。 -.RE -.PP -\-XX:CompileOnly=\fImethods\fR -.RS 4 -コンパイルを制限する(カンマで区切られた)メソッドのリストを設定します。指定したメソッドのみがコンパイルされます。完全クラス名(パッケージおよびサブパッケージを含む)で各メソッドを指定します。たとえば、\fIString\fRクラスの\fIlength()\fRメソッドおよび\fIList\fRクラスの\fIsize()\fRメソッドのみをコンパイルするには、次を使用します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileOnly=java/lang/String\&.length,java/util/List\&.size -.fi -.if n \{\ -.RE -.\} -スラッシュ(\fI/\fR)で区切られたすべてのパッケージおよびサブパッケージを含む、完全クラス名を指定します。切取りと貼付けの操作を容易にするために、\fI\-XX:+PrintCompilation\fRオプションおよび\fI\-XX:+LogCompilation\fRオプションによって生成されるメソッド名の形式を使用することもできます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileOnly=java\&.lang\&.String::length,java\&.util\&.List::size +\fB\-XX:AllocateInstancePrefetchLines=1\fR + .fi .if n \{\ .RE .\} -ワイルドカードはサポートされていませんが、クラス名またはパッケージ名だけを指定してクラスまたはパッケージのすべてのメソッドをコンパイルすることも、メソッドだけを指定して任意のクラスのこの名前を持つメソッドをコンパイルすることもできます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileOnly=java/lang/String -\-XX:CompileOnly=java/lang -\-XX:CompileOnly=\&.length -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:CompileThreshold=\fIinvocations\fR -.RS 4 -コンパイル前に解釈されたメソッド呼出しの数を設定します。デフォルトでは、サーバーJVMでは、JITコンパイラは、10,000の解釈されたメソッド呼出しを実行して、効率的なコンパイルのための情報を収集します。クライアントJVMの場合、デフォルト設定は1,500呼出しです。次の例では、解釈されたメソッド呼出しの数を5,000に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileThreshold=5000 -.fi -.if n \{\ -.RE -.\} -\fI\-Xcomp\fRオプションを指定して、コンパイルの前に、Javaメソッドの解釈を完全に無効にすることができます。 -.RE -.PP -\-XX:+DoEscapeAnalysis -.RS 4 -エスケープ分析の使用を有効にします。このオプションはデフォルトで有効になっています。エスケープ分析の使用を無効にするには、\fI\-XX:\-DoEscapeAnalysis\fRを指定します。 -.RE -.PP -\-XX:+FailOverToOldVerifier -.RS 4 -新しいタイプ・チェッカが失敗した場合の、古いベリファイアへの自動フェイルオーバーを有効にします。デフォルトでは、このオプションは無効になっており、最近のバイトコード・バージョンを使用したクラスには、これは無視されます(つまり、無効として処理されます)。古いバージョンのバイトコードを使用したクラスには、これを有効化できます。 -.RE -.PP -\-XX:InitialCodeCacheSize=\fIsize\fR -.RS 4 -初期コード・キャッシュ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値は500KBに設定されています。次の例では、初期コード・キャッシュ・サイズを32KBに設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:InitialCodeCacheSize=32k -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+Inline -.RS 4 -メソッドのインライン化を有効にします。このオプションは、パフォーマンスを向上させるためにデフォルトで有効になっています。メソッドのインライン化を無効にするには、\fI\-XX:\-Inline\fRを指定します。 -.RE -.PP -\-XX:InlineSmallCode=\fIsize\fR -.RS 4 -インライン化が必要なコンパイルされたメソッドの最大コード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。指定したサイズより小さいサイズのコンパイルされたメソッドのみが、インライン化されます。デフォルトでは、最大コード・サイズは1000バイトに設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:InlineSmallCode=1000 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+LogCompilation -.RS 4 -現在の作業ディレクトリにある\fIhotspot\&.log\fRという名前のファイルへのコンパイル・アクティビティのロギングを有効にします。\fI\-XX:LogFile\fRオプションを使用して、異なるログ・ファイル・パスと名前を指定できます。 -.sp -デフォルトでは、このオプションは無効であり、コンパイル・アクティビティは記録されません。\fI\-XX:+LogCompilation\fRオプションは、診断JVMオプションのロックを解除する\fI\-XX:UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 -.sp -\fI\-XX:+PrintCompilation\fRオプションを使用して、メソッドをコンパイルするたびに、コンソールに出力されたメッセージを含む詳細な診断出力を有効化できます。 -.RE -.PP -\-XX:MaxInlineSize=\fIsize\fR -.RS 4 -インライン化するメソッドの最大バイトコード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、最大バイトコード・サイズは35バイトに設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:MaxInlineSize=35 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:MaxNodeLimit=\fInodes\fR -.RS 4 -単一のメソッドのコンパイル時に使用されるノードの最大数を設定します。デフォルトでは、ノードの最大数は65,000に設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:MaxNodeLimit=65000 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:MaxTrivialSize=\fIsize\fR -.RS 4 -インライン化する単純メソッドの最大バイトコード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、単純メソッドの最大バイトコード・サイズは6バイトに設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:MaxTrivialSize=6 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+OptimizeStringConcat -.RS 4 -\fIString\fR連結操作の最適化を有効にします。このオプションはデフォルトで有効になっています。\fIString\fR連結操作の最適化を無効にするには、\fI\-XX:\-OptimizeStringConcat\fRを指定します。 -.RE -.PP -\-XX:+PrintAssembly -.RS 4 -外部の\fIdisassembler\&.so\fRライブラリを使用して、バイトコード化されたネイティブのメソッドのアセンブリ・コードの出力を有効にします。これにより、生成されたコードを表示することができ、パフォーマンスの問題の診断に役立ちます。 -.sp -デフォルトでは、このオプションは無効であり、アセンブリ・コードは印刷されません。\fI\-XX:+PrintAssembly\fRオプションは、診断JVMオプションのロックを解除する\fI\-XX:UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 -.RE -.PP -\-XX:+PrintCompilation -.RS 4 -メソッドをコンパイルするたびに、コンソールにメッセージを出力することによって、JVMからの詳細な診断出力を有効にします。これにより、実際にコンパイルされるメソッドを確認できます。デフォルトでは、このオプションは無効であり、診断出力は印刷されません。 -.sp -\fI\-XX:+LogCompilation\fRオプションを使用して、コンパイル・アクティビティをファイルに記録することもできます。 -.RE -.PP -\-XX:+PrintInlining -.RS 4 -インライン化の決定内容の出力を有効にします。これにより、インライン化されるメソッドを確認できます。 -.sp -デフォルトでは、このオプションは無効であり、インライン化情報は出力されません。\fI\-XX:+PrintInlining\fRオプションは、診断JVMオプションのロックを解除する\fI\-XX:+UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 -.RE -.PP -\-XX:+RelaxAccessControlCheck -.RS 4 -ベリファイア内のアクセス制御チェックの量を減らします。デフォルトでは、このオプションは無効になっており、最近のバイトコード・バージョンを使用したクラスには、これは無視されます(つまり、無効として処理されます)。古いバージョンのバイトコードを使用したクラスには、これを有効化できます。 -.RE -.PP -\-XX:ReservedCodeCacheSize=\fIsize\fR -.RS 4 -JITコンパイルされたコードの最大コード・キャッシュ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。このオプションは\fI\-Xmaxjitcodesize\fRと同等です。 -.RE -.PP -\-XX:+TieredCompilation -.RS 4 -層コンパイルの使用を有効にします。デフォルトでは、このオプションは無効であり、層コンパイルは使用されません。 -.RE -.PP -\-XX:+UseCodeCacheFlushing -.RS 4 -コンパイラをシャットダウンする前に、コード・キャッシュのフラッシュを有効にします。このオプションはデフォルトで有効になっています。コンパイラをシャットダウンする前にコード・キャッシュのフラッシュを無効にするには\fI\-XX:\-UseCodeCacheFlushing\fRを指定します。 -.RE -.PP -\-XX:+UseCondCardMark -.RS 4 -カード表の更新前に、カードがすでにマークされているかどうかのチェックを有効にします。このオプションは、デフォルトでは無効になっており、複数のソケットを持つマシン上でのみ使用する必要があります。これにより、同時操作にかなり依存しているJavaアプリケーションのパフォーマンスが向上します。 -.RE -.PP -\-XX:+UseSuperWord -.RS 4 -スカラー演算のスーパーワード演算への変換を有効にします。このオプションはデフォルトで有効になっています。スカラー演算のスーパーワード演算への変換を無効にするには、\fI\-XX:\-UseSuperWord\fRを指定します。 -.RE -.SS "高度なサービスアビリティ・オプション" -.PP -これらのオプションは、システム情報を収集し、詳細なデバッグを実行する機能を提供します。 -.PP -\-XX:+ExtendedDTraceProbes -.RS 4 -パフォーマンスに影響を与える追加の\fIdtrace\fRツール・プローブを有効にします。デフォルトでは、このオプションは無効になっており、\fIdtrace\fRは標準プローブのみを実行します。 -.RE -.PP -\-XX:+HeapDumpOnOutOfMemory -.RS 4 -\fIjava\&.lang\&.OutOfMemoryError\fR例外がスローされた場合に、ヒープ・プロファイラ(HPROF)を使用して、現在のディレクトリ内のファイルへのJavaヒープのダンプを有効にします。\fI\-XX:HeapDumpPath\fRオプションを使用して、ヒープ・ダンプ・ファイルのパスおよび名前を明示的に設定できます。デフォルトでは、このオプションは無効であり、\fIOutOfMemoryError\fR例外がスローされた場合にヒープはダンプされません。 -.RE -.PP -\-XX:HeapDumpPath=\fIpath\fR -.RS 4 -\fI\-XX:+HeapDumpOnOutOfMemoryError\fRオプションが設定されている場合、ヒープ・プロファイラ(HPROF)が提供するヒープ・ダンプを書き込むパスおよびファイル名を設定します。デフォルトでは、このファイルは、現在の作業ディレクトリに作成され、名前は\fIjava_pid\fR\fIpid\fR\fI\&.hprof\fR -(\fIpid\fRはエラーの原因となったプロセスの識別子)になります。次の例では、デフォルトのファイルを明示的に設定する方法を示します(\fI%p\fRは現在のプロセスの識別子を表します)。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:HeapDumpPath=\&./java_pid%p\&.hprof -.fi -.if n \{\ -.RE -.\} -次の例では、ヒープ・ダンプ・ファイルを\fI/var/log/java/java_heapdump\&.hprof\fRに設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:HeapDumpPath=/var/log/java/java_heapdump\&.hprof -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:LogFile=\fIpath\fR -.RS 4 -ログ・データが書き込まれるパスおよびファイル名を設定します。デフォルトでは、ファイルは現在の作業ディレクトリに作成され、名前は\fIhotspot\&.log\fRです。 -.sp -次の例では、ログ・ファイルを\fI/var/log/java/hotspot\&.log\fRに設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:LogFile=/var/log/java/hotspot\&.log -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+PrintClassHistogram -.RS 4 -\fI[Control]+[C]\fRイベント(\fISIGTERM\fR)後にクラス・インスタンスのヒストグラムの印刷を有効にします。デフォルトでは、このオプションは無効です。 -.sp -このオプションを設定すると、\fIjmap \-histo\fRコマンド、または\fIjcmd \fR\fIpid\fR\fI GC\&.class_histogram\fRコマンド(\fIpid\fRは現在のJavaプロセスの識別子)を実行する場合と同じになります。 -.RE -.PP -\-XX:+PrintConcurrentLocks -.RS 4 -.sp -\fI[Control]+[C]\fRイベント(\fISIGTERM\fR)後に\fIjava\&.util\&.concurrent\fRロックの印刷を有効にします。デフォルトでは、このオプションは無効です。 -.sp -このオプションを設定すると、\fIjstack \-l\fRコマンド、または\fIjcmd \fR\fIpid\fR\fI Thread\&.print \-l\fRコマンド(\fIpid\fRは現在のJavaプロセスの識別子)を実行する場合と同じになります。 -.RE -.PP -\-XX:+UnlockDiagnosticVMOptions -.RS 4 -JVMの診断を目的としたオプションをアンロックします。デフォルトでは、このオプションは無効であり、診断オプションは使用できません。 -.RE -.SS "高度なガベージ・コレクション・オプション" -.PP -これらのオプションは、ガベージ・コレクション(GC)がJava HotSpot VMによってどのように実行されるかを制御します。 -.PP -\-XX:+AggressiveHeap -.RS 4 -Javaヒープの最適化を有効にします。これにより、コンピュータの構成(RAMおよびCPU)に基づいて、様々なパラメータが、メモリー割当てが集中した長時間実行ジョブに最適になるように設定されます。デフォルトでは、このオプションは無効であり、ヒープは最適化されません。 +Java HotSpot Server VMのみが、このオプションをサポートしています。 .RE .PP \-XX:AllocatePrefetchDistance=\fIsize\fR .RS 4 オブジェクト割当てのプリフェッチ距離のサイズ(バイト単位)を設定します。新規オブジェクトの値で書き込もうとするメモリーは、最後に割り当てられたオブジェクトのアドレスから、この距離までプリフェッチされます。各Javaスレッドには独自の割当てポイントがあります。 .sp -負の値は、プリフェッチ距離はプラットフォームに基づいて選択されることを示します。正の値は、プリフェッチするバイト数です。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値は\-1に設定されています。 +負の値は、プリフェッチ距離はプラットフォームに基づいて選択されることを示します。正の値は、プリフェッチするバイト数です。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値は\-1に設定されています。 .sp 次の例では、プリフェッチ距離を1024バイトに設定する方法を示します。 .sp @@ -1718,11 +1239,30 @@ .RS 4 .\} .nf -\-XX:AllocatePrefetchDistance=1024 +\fB\-XX:AllocatePrefetchDistance=1024\fR + .fi .if n \{\ .RE .\} +Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:AllocatePrefetchInstr=\fIinstruction\fR +.RS 4 +割当てポインタの前にプリフェッチするプリフェッチ命令を設定します。Java HotSpot Server VMのみが、このオプションをサポートしています。使用可能な値は0から3までです。値の背後にある実際の命令は、プラットフォームによって異なります。デフォルトでは、プリフェッチ命令は0に設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:AllocatePrefetchInstr=0\fR + +.fi +.if n \{\ +.RE +.\} +Java HotSpot Server VMのみが、このオプションをサポートしています。 .RE .PP \-XX:AllocatePrefetchLines=\fIlines\fR @@ -1735,11 +1275,30 @@ .RS 4 .\} .nf -\-XX:AllocatePrefetchLines=5 +\fB\-XX:AllocatePrefetchLines=5\fR + .fi .if n \{\ .RE .\} +Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:AllocatePrefetchStepSize=\fIsize\fR +.RS 4 +順次プリフェッチ命令のステップ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、ステップ・サイズは16バイトに設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:AllocatePrefetchStepSize=16\fR + +.fi +.if n \{\ +.RE +.\} +Java HotSpot Server VMのみが、このオプションをサポートしています。 .RE .PP \-XX:AllocatePrefetchStyle=\fIstyle\fR @@ -1765,16 +1324,565 @@ .RS 4 割当てプリフェッチ用のSPARCでBIS命令を使用します。 .RE +.sp +Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:+BackgroundCompilation +.RS 4 +バックグラウンド・コンパイルを有効にします。このオプションはデフォルトで有効になっています。バックグラウンド・コンパイルを無効にするには、\fB\-XX:\-BackgroundCompilation\fRを指定します(これは\fB\-Xbatch\fRを指定するのと同等です)。 +.RE +.PP +\-XX:CICompilerCount=\fIthreads\fR +.RS 4 +コンパイルに使用するコンパイラ・スレッドの数を設定します。デフォルトでは、スレッド数は、サーバーJVMの場合は2、クライアントJVMの場合は1に設定されており、層コンパイルが使用されている場合、コア数に合せて増減します。次の例では、スレッドの数を2に設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CICompilerCount=2\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:CodeCacheMinimumFreeSpace=\fIsize\fR +.RS 4 +コンパイルに必要な最小空き領域(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。最小空き領域より少ない領域しか残っていない場合、コンパイルは停止します。デフォルトでは、このオプションは500KBに設定されています。次の例では、最小空き領域を1024MBに設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CodeCacheMinimumFreeSpace=1024m\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:CompileCommand=\fIcommand\fR,\fImethod\fR[,\fIoption\fR] +.RS 4 +メソッドで実行するコマンドを指定します。たとえば、コンパイル元から\fBString\fRクラスの\fBindexOf()\fRメソッドを実行するには、次を使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand=exclude,java/lang/String\&.indexOf\fR + +.fi +.if n \{\ +.RE +.\} +スラッシュ(\fB/\fR)で区切られたすべてのパッケージおよびサブパッケージを含む、完全クラス名を指定します。切取りと貼付けの操作を容易にするために、\fB\-XX:+PrintCompilation\fRオプションおよび\fB\-XX:+LogCompilation\fRオプションによって生成されるメソッド名の形式を使用することもできます。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand=exclude,java\&.lang\&.String::indexOf\fR + +.fi +.if n \{\ +.RE +.\} +署名なしでメソッドを指定すると、コマンドは指定した名前を持つすべてのメソッドに適用されます。ただし、クラス・ファイル形式でメソッドの署名を指定することもできます。この場合、引数を引用符で囲む必要があり、囲まないと、シェルによりセミコロンがコマンドの終了として扱われます。たとえば、コンパイル元から\fBString\fRクラスの\fBindexOf(String)\fRメソッドのみ除外するには、次を使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand="exclude,java/lang/String\&.indexOf,(Ljava/lang/String;)I"\fR + +.fi +.if n \{\ +.RE +.\} +また、クラス名およびメソッド名にワイルドカードとしてアスタリスク(*)を使用できます。たとえば、コンパイル元からすべてのクラスのすべての\fBindexOf()\fRメソッドを除外するには、次を使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand=exclude,*\&.indexOf\fR + +.fi +.if n \{\ +.RE +.\} +カンマとピリオドは空白の別名で、これにより、シェルを介してコンパイラ・コマンドを渡すことが容易になります。引数を引用符で囲むことで、空白をセパレータとして使用して\fB\-XX:CompileCommand\fRに引数を渡すことができます。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand="exclude java/lang/String indexOf"\fR + +.fi +.if n \{\ +.RE +.\} +\fB\-XX:CompileCommand\fRオプションを使用してコマンド行で渡されたコマンドを解析した後に、JITコンパイラは\fB\&.hotspot_compiler\fRファイルからコマンドを読み取ります。このファイルにコマンドを追加するか、または\fB\-XX:CompileCommandFile\fRオプションを使用して別のファイルを指定することができます。 +.sp +複数のコマンドを追加するには、\fB\-XX:CompileCommand\fRオプションを複数回指定するか、または改行セパレータ(\fB\en\fR)を使用して各引数を区切ります。次のコマンドを使用できます。 +.PP +break +.RS 4 +指定したメソッドのコンパイルの最初に停止するために、JVMのデバッグ時のブレークポイントを設定します。 +.RE +.PP +compileonly +.RS 4 +指定したメソッドを除いたすべてのメソッドを、コンパイルから除外します。別の方法として、\fB\-XX:CompileOnly\fRオプションを使用して複数のメソッドを指定できます。 +.RE +.PP +dontinline +.RS 4 +指定したメソッドをインライン化しないようにします。 +.RE +.PP +exclude +.RS 4 +指定したメソッドをコンパイルから除外します。 +.RE +.PP +help +.RS 4 +\fB\-XX:CompileCommand\fRオプションのヘルプ・メッセージを印刷します。 +.RE +.PP +inline +.RS 4 +指定したメソッドをインライン化しようとします。 +.RE +.PP +log +.RS 4 +指定したメソッドを除くすべてのメソッドに対して、(\fB\-XX:+LogCompilation\fRオプションを使用して)コンパイル・ロギングを除外します。デフォルトでは、コンパイルされたすべてのメソッドにロギングが実行されます。 +.RE +.PP +option +.RS 4 +このコマンドは、最後の引数(\fIoption\fR)のかわりに、指定したメソッドにJITコンパイル・オプションを渡すために使用できます。コンパイル・オプションは、メソッド名の後の末尾に設定されます。たとえば、\fBStringBuffer\fRクラスの\fBappend()\fRメソッドに対して\fBBlockLayoutByFrequency\fRオプションを有効にするには、次を使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand=option,java/lang/StringBuffer\&.append,BlockLayoutByFrequency\fR + +.fi +.if n \{\ +.RE +.\} +カンマまたは空白で区切って、複数のコンパイル・オプションを指定できます。 +.RE +.PP +print +.RS 4 +指定したメソッドのコンパイル後に生成されたアセンブラ・コードを出力します。 +.RE +.PP +quiet +.RS 4 +コンパイル・コマンドを出力しません。デフォルトでは、\fB\-XX:CompileCommand\fRオプションを使用して指定したコマンドが出力されます。たとえば、\fBString\fRクラスの\fBindexOf()\fRメソッドのコンパイルから除外する場合、次が標準出力に出力されます。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBCompilerOracle: exclude java/lang/String\&.indexOf\fR + +.fi +.if n \{\ +.RE +.\} +他の\fB\-XX:CompileCommand\fRオプションの前に\fB\-XX:CompileCommand=quiet\fRオプションを指定することによって、これを抑制できます。 +.RE +.RE +.PP +\-XX:CompileCommandFile=\fIfilename\fR +.RS 4 +JITコンパイラ・コマンドの読取り元のファイルを設定します。デフォルトでは、JITコンパイラによって実行されるコマンドを格納するために、\fB\&.hotspot_compiler\fRファイルが使用されます。 +.sp +コマンド・ファイルの各行は、コマンドが使用されるコマンド、クラス名およびメソッド名を表します。たとえば、次の行は、\fBString\fRクラスの\fBtoString()\fRメソッドに対してアセンブリ・コードを出力します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBprint java/lang/String toString\fR + +.fi +.if n \{\ +.RE +.\} +メソッドで実行するJITコンパイラのコマンドの指定の詳細は、\fB\-XX:CompileCommand\fRオプションを参照してください。 +.RE +.PP +\-XX:CompileOnly=\fImethods\fR +.RS 4 +コンパイルを制限する(カンマで区切られた)メソッドのリストを設定します。指定したメソッドのみがコンパイルされます。完全クラス名(パッケージおよびサブパッケージを含む)で各メソッドを指定します。たとえば、\fBString\fRクラスの\fBlength()\fRメソッドおよび\fBList\fRクラスの\fBsize()\fRメソッドのみをコンパイルするには、次を使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileOnly=java/lang/String\&.length,java/util/List\&.size\fR + +.fi +.if n \{\ +.RE +.\} +スラッシュ(\fB/\fR)で区切られたすべてのパッケージおよびサブパッケージを含む、完全クラス名を指定します。切取りと貼付けの操作を容易にするために、\fB\-XX:+PrintCompilation\fRオプションおよび\fB\-XX:+LogCompilation\fRオプションによって生成されるメソッド名の形式を使用することもできます。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileOnly=java\&.lang\&.String::length,java\&.util\&.List::size\fR + +.fi +.if n \{\ +.RE +.\} +ワイルドカードはサポートされていませんが、クラス名またはパッケージ名だけを指定してクラスまたはパッケージのすべてのメソッドをコンパイルすることも、メソッドだけを指定して任意のクラスのこの名前を持つメソッドをコンパイルすることもできます。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileOnly=java/lang/String\fR +\fB\-XX:CompileOnly=java/lang\fR +\fB\-XX:CompileOnly=\&.length\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:CompileThreshold=\fIinvocations\fR +.RS 4 +コンパイル前に解釈されたメソッド呼出しの数を設定します。デフォルトでは、サーバーJVMでは、JITコンパイラは、10,000の解釈されたメソッド呼出しを実行して、効率的なコンパイルのための情報を収集します。クライアントJVMの場合、デフォルト設定は1,500呼出しです。次の例では、解釈されたメソッド呼出しの数を5,000に設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileThreshold=5000\fR + +.fi +.if n \{\ +.RE +.\} +\fB\-Xcomp\fRオプションを指定して、コンパイルの前に、Javaメソッドの解釈を完全に無効にすることができます。 +.RE +.PP +\-XX:+DoEscapeAnalysis +.RS 4 +エスケープ分析の使用を有効にします。このオプションはデフォルトで有効になっています。エスケープ分析の使用を無効にするには、\fB\-XX:\-DoEscapeAnalysis\fRを指定します。Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:InitialCodeCacheSize=\fIsize\fR +.RS 4 +初期コード・キャッシュ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値は500KBに設定されています。次の例では、初期コード・キャッシュ・サイズを32KBに設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:InitialCodeCacheSize=32k\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:+Inline +.RS 4 +メソッドのインライン化を有効にします。このオプションは、パフォーマンスを向上させるためにデフォルトで有効になっています。メソッドのインライン化を無効にするには、\fB\-XX:\-Inline\fRを指定します。 +.RE +.PP +\-XX:InlineSmallCode=\fIsize\fR +.RS 4 +インライン化が必要なコンパイルされたメソッドの最大コード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。指定したサイズより小さいサイズのコンパイルされたメソッドのみが、インライン化されます。デフォルトでは、最大コード・サイズは1000バイトに設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:InlineSmallCode=1000\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:+LogCompilation +.RS 4 +現在の作業ディレクトリにある\fBhotspot\&.log\fRという名前のファイルへのコンパイル・アクティビティのロギングを有効にします。\fB\-XX:LogFile\fRオプションを使用して、異なるログ・ファイル・パスと名前を指定できます。 +.sp +デフォルトでは、このオプションは無効であり、コンパイル・アクティビティは記録されません。\fB\-XX:+LogCompilation\fRオプションは、診断JVMオプションのロックを解除する\fB\-XX:UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 +.sp +\fB\-XX:+PrintCompilation\fRオプションを使用して、メソッドをコンパイルするたびに、コンソールに出力されたメッセージを含む詳細な診断出力を有効化できます。 +.RE +.PP +\-XX:MaxInlineSize=\fIsize\fR +.RS 4 +インライン化するメソッドの最大バイトコード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、最大バイトコード・サイズは35バイトに設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:MaxInlineSize=35\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:MaxNodeLimit=\fInodes\fR +.RS 4 +単一のメソッドのコンパイル時に使用されるノードの最大数を設定します。デフォルトでは、ノードの最大数は65,000に設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:MaxNodeLimit=65000\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:MaxTrivialSize=\fIsize\fR +.RS 4 +インライン化する単純メソッドの最大バイトコード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、単純メソッドの最大バイトコード・サイズは6バイトに設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:MaxTrivialSize=6\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:+OptimizeStringConcat +.RS 4 +\fBString\fR連結操作の最適化を有効にします。このオプションはデフォルトで有効になっています。\fBString\fR連結操作の最適化を無効にするには、\fB\-XX:\-OptimizeStringConcat\fRを指定します。Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:+PrintAssembly +.RS 4 +外部の\fBdisassembler\&.so\fRライブラリを使用して、バイトコード化されたネイティブのメソッドのアセンブリ・コードの出力を有効にします。これにより、生成されたコードを表示することができ、パフォーマンスの問題の診断に役立ちます。 +.sp +デフォルトでは、このオプションは無効であり、アセンブリ・コードは印刷されません。\fB\-XX:+PrintAssembly\fRオプションは、診断JVMオプションのロックを解除する\fB\-XX:UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 +.RE +.PP +\-XX:+PrintCompilation +.RS 4 +メソッドをコンパイルするたびに、コンソールにメッセージを出力することによって、JVMからの詳細な診断出力を有効にします。これにより、実際にコンパイルされるメソッドを確認できます。デフォルトでは、このオプションは無効であり、診断出力は印刷されません。 +.sp +\fB\-XX:+LogCompilation\fRオプションを使用して、コンパイル・アクティビティをファイルに記録することもできます。 +.RE +.PP +\-XX:+PrintInlining +.RS 4 +インライン化の決定内容の出力を有効にします。これにより、インライン化されるメソッドを確認できます。 +.sp +デフォルトでは、このオプションは無効であり、インライン化情報は出力されません。\fB\-XX:+PrintInlining\fRオプションは、診断JVMオプションのロックを解除する\fB\-XX:+UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 +.RE +.PP +\-XX:ReservedCodeCacheSize=\fIsize\fR +.RS 4 +JITコンパイルされたコードの最大コード・キャッシュ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。このオプションは\fB\-Xmaxjitcodesize\fRと同等です。 +.RE +.PP +\-XX:+TieredCompilation +.RS 4 +層コンパイルの使用を有効にします。デフォルトでは、このオプションは有効になっています。Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:+UseAES +.RS 4 +Intel、AMDおよびSPARCハードウェアに対して、ハードウェアベースのAES組込みを有効化します。Intel Westmere (2010以降)、AMD Bulldozer (2011以降)およびSPARC (T4以降)が、サポートされているハードウェアです。UseAESは、UseAESIntrinsicsとともに使用します。 +.RE +.PP +\-XX:+UseAESIntrinsics +.RS 4 +UseAESとUseAESIntrinsicsフラグはデフォルトで有効化されており、Java HotSpot Server VM 32ビットおよび64ビットに対してのみサポートされています。ハードウェアベースのAES組込みを無効化するには、\fB\-XX:\-UseAES \-XX:\-UseAESIntrinsics\fRを指定します。たとえば、ハードウェアAESを有効化するには、次のフラグを使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:+UseAES \-XX:+UseAESIntrinsics\fR + +.fi +.if n \{\ +.RE +.\} +32ビットおよび64ビットに対してUseAESおよびUseAESIntrinsicsフラグをサポートするには、\fB\-server\fRオプションを使用してJava HotSpot Server VMを選択します。これらのフラグは、クライアントVMではサポートされていません。 +.RE +.PP +\-XX:+UseCodeCacheFlushing +.RS 4 +コンパイラをシャットダウンする前に、コード・キャッシュのフラッシュを有効にします。このオプションはデフォルトで有効になっています。コンパイラをシャットダウンする前にコード・キャッシュのフラッシュを無効にするには\fB\-XX:\-UseCodeCacheFlushing\fRを指定します。 +.RE +.PP +\-XX:+UseCondCardMark +.RS 4 +カード表の更新前に、カードがすでにマークされているかどうかのチェックを有効にします。このオプションは、デフォルトでは無効になっており、複数のソケットを持つマシン上でのみ使用する必要があります。これにより、同時操作にかなり依存しているJavaアプリケーションのパフォーマンスが向上します。Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:+UseSuperWord +.RS 4 +スカラー演算のスーパーワード演算への変換を有効にします。このオプションはデフォルトで有効になっています。スカラー演算のスーパーワード演算への変換を無効にするには、\fB\-XX:\-UseSuperWord\fRを指定します。Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.SS "試験的なJITコンパイラ・オプション" +.PP +この項のRestricted Transactional Memory (RTM)のロック機能に関連するオプションは試験的なもので、Java SE 8u20で正式にサポートされていません。これらを使用するには、\fB\-XX:+UnlockExperimentalVMOptions\fRオプションを有効化する必要があります。これらのオプションは、Transactional Synchronization Extensions (TSX)をサポートするx86 CPU上のJava HotSpot Server VMに対してのみ使用可能です。 +.PP +\-XX:RTMAbortRatio=\fIabort_ratio\fR +.RS 4 +RTM中止率は、すべての実行済RTMトランザクションに対するパーセンテージ(%)として指定されます。中止されたトランザクション数がこの率を超えた場合、コンパイルされたコードが非最適化されます。この率は、\fB\-XX:+UseRTMDeopt\fRオプションが有効な場合に使用されます。このオプションのデフォルト値は50です。つまり、すべてのトランザクションの50%が中止された場合、コンパイルされたコードが非最適化されます。 +.RE +.PP +\-XX:RTMRetryCount=\fInumber_of_retries\fR +.RS 4 +中止またはビジーの場合、RTMロック・コードは、標準のロック・メカニズムにフォールバックする前にこのオプションによって指定された回数再試行されます。このオプションのデフォルト値は5です。\fB\-XX:UseRTMLocking\fRオプションを有効化する必要があります。 +.RE +.PP +\-XX:+UseRTMDeopt +.RS 4 +中止率に応じて、RTMロックを自動調整します。この率は、\fB\-XX:RTMAbortRatio\fRオプションによって指定されます。中止されたトランザクション数が中止率を超えた場合、ロックを含むメソッドがすべてのロックで標準のロックとして非最適化および再コンパイルされます。このオプションは、デフォルトでは無効になっています。\fB\-XX:UseRTMLocking\fRオプションを有効化する必要があります。 +.RE +.PP +\-XX:+UseRTMLocking +.RS 4 +フォールバック・ハンドラとして標準のロック・メカニズムを使用して、展開されたすべてのロックに対してRestricted Transactional Memory (RTM)ロック・コードを生成します。このオプションは、デフォルトでは無効になっています。 +.sp +RTMは、x86命令セット拡張でマルチスレッド・アプリケーションの作成を容易にするIntelのTransactional Synchronization Extensions (TSX)の一部です。RTMでは、新しい命令 +\fBXBEGIN\fR、\fBXABORT\fR、\fBXEND\fRおよび\fBXTEST\fRが導入されています。\fBXBEGIN\fRおよび\fBXEND\fR命令は、トランザクションとして実行するための命令セットを囲みます。トランザクションの実行時に競合が見つからなかった場合、メモリーとレジスタの変更が、\fBXEND\fR命令で同時にコミットされます。\fBXABORT\fR命令ではトランザクションを明示的に中止でき、\fBXEND\fR命令では命令セットがトランザクション内で実行中かどうかを確認できます。 +.sp +トランザクションのロックは、別のスレッドが同じトランザクションにアクセスしようとしたときに展開されます。したがって、そのトランザクションへのアクセスを最初にリクエストしなかったスレッドはブロックされます。RTMでは、トランザクションが中止または失敗した場合のために、フォールバックの操作セットを指定する必要があります。RTMロックとは、TSXのシステムに委譲されているロックです。 +.sp +RTMにより、重要なリージョンにおいて衝突が少なく競合度の高いロックのパフォーマンスが向上されます(これは、複数のスレッドによって同時にアクセスできないコードです)。また、RTMにより、粗粒度ロックのパフォーマンスも向上されますが、一般的にマルチスレッド・アプリケーションでのパフォーマンスはよくありません。(粗粒度ロックとは、ロックの取得および解放のオーバーヘッドを最小化するために長い期間ロックを保持する戦略であり、一方、細粒度ロックとは必要な場合のみロックし可能なかぎり早期にロック解除することで最大限の並行処理の達成を試みる戦略です。)さらに、異なるスレッドによって使用されている軽度な競合ロックの場合、RTMにより、誤ったキャッシュ・ライン共有(キャッシュ・ライン・ピンポンとも呼ばれる)を削減できます。これは、異なるプロセッサからの複数のスレッドが異なるリソースにアクセスしている場合に発生しますが、リソースは同じキャッシュ・ラインを共有します。結果として、プロセッサは他のプロセッサのキャッシュ・ラインを繰り返し無効にし、これにより、キャッシュではなくメイン・メモリーからの読取りが強制されます。 +.RE +.SS "高度なサービスアビリティ・オプション" +.PP +これらのオプションは、システム情報を収集し、詳細なデバッグを実行する機能を提供します。 +.PP +\-XX:+ExtendedDTraceProbes +.RS 4 +パフォーマンスに影響を与える追加の\fBdtrace\fRツール・プローブを有効にします。デフォルトでは、このオプションは無効になっており、\fBdtrace\fRは標準プローブのみを実行します。 +.RE +.PP +\-XX:+HeapDumpOnOutOfMemory +.RS 4 +\fBjava\&.lang\&.OutOfMemoryError\fR例外がスローされた場合に、ヒープ・プロファイラ(HPROF)を使用して、現在のディレクトリ内のファイルへのJavaヒープのダンプを有効にします。\fB\-XX:HeapDumpPath\fRオプションを使用して、ヒープ・ダンプ・ファイルのパスおよび名前を明示的に設定できます。デフォルトでは、このオプションは無効であり、\fBOutOfMemoryError\fR例外がスローされた場合にヒープはダンプされません。 +.RE +.PP +\-XX:HeapDumpPath=\fIpath\fR +.RS 4 +\fB\-XX:+HeapDumpOnOutOfMemoryError\fRオプションが設定されている場合、ヒープ・プロファイラ(HPROF)が提供するヒープ・ダンプを書き込むパスおよびファイル名を設定します。デフォルトでは、このファイルは、現在の作業ディレクトリに作成され、名前は\fBjava_pid\fR\fIpid\fR\fB\&.hprof\fR +(\fIpid\fRはエラーの原因となったプロセスの識別子)になります。次の例では、デフォルトのファイルを明示的に設定する方法を示します(\fB%p\fRは現在のプロセスの識別子を表します)。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:HeapDumpPath=\&./java_pid%p\&.hprof\fR + +.fi +.if n \{\ +.RE +.\} +次の例では、ヒープ・ダンプ・ファイルを\fB/var/log/java/java_heapdump\&.hprof\fRに設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:HeapDumpPath=/var/log/java/java_heapdump\&.hprof\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:LogFile=\fIpath\fR +.RS 4 +ログ・データが書き込まれるパスおよびファイル名を設定します。デフォルトでは、ファイルは現在の作業ディレクトリに作成され、名前は\fBhotspot\&.log\fRです。 +.sp +次の例では、ログ・ファイルを\fB/var/log/java/hotspot\&.log\fRに設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:LogFile=/var/log/java/hotspot\&.log\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:+PrintClassHistogram +.RS 4 +\fB[Control]+[C]\fRイベント(\fBSIGTERM\fR)後にクラス・インスタンスのヒストグラムの印刷を有効にします。デフォルトでは、このオプションは無効です。 +.sp +このオプションを設定すると、\fBjmap \-histo\fRコマンド、または\fBjcmd \fR\fIpid\fR\fB GC\&.class_histogram\fRコマンド(\fIpid\fRは現在のJavaプロセスの識別子)を実行する場合と同じになります。 +.RE +.PP +\-XX:+PrintConcurrentLocks +.RS 4 +次の印刷を有効化します: j ロック(次の後) \- イベント。デフォルトでは、このオプションは無効です。 +.sp +\fB[Control]+[C]\fRイベント(\fBSIGTERM\fR)後に\fBjava\&.util\&.concurrent\fRロックの印刷を有効にします。デフォルトでは、このオプションは無効です。 +.sp +このオプションを設定すると、\fBjstack \-l\fRコマンド、または\fBjcmd \fR\fIpid\fR\fB Thread\&.print \-l\fRコマンド(\fIpid\fRは現在のJavaプロセスの識別子)を実行する場合と同じになります。 +.RE +.PP +\-XX:+UnlockDiagnosticVMOptions +.RS 4 +JVMの診断を目的としたオプションをアンロックします。デフォルトでは、このオプションは無効であり、診断オプションは使用できません。 +.RE +.SS "高度なガベージ・コレクション・オプション" +.PP +これらのオプションは、ガベージ・コレクション(GC)がJava HotSpot VMによってどのように実行されるかを制御します。 +.PP +\-XX:+AggressiveHeap +.RS 4 +Javaヒープの最適化を有効にします。これにより、コンピュータの構成(RAMおよびCPU)に基づいて、様々なパラメータが、メモリー割当てが集中した長時間実行ジョブに最適になるように設定されます。デフォルトでは、このオプションは無効であり、ヒープは最適化されません。 .RE .PP \-XX:+AlwaysPreTouch .RS 4 -JVMの初期化中にJavaヒープ上のすべてのページのタッチを有効にします。これにより、\fImain()\fRメソッドの入力前に、すべてのページがメモリーに取得されます。このオプションは、物理メモリーにマップされたすべての仮想メモリーを含む長時間実行のシステムをシミュレートするテストで使用できます。デフォルトでは、このオプションは無効になっており、JVMヒープ領域がいっぱいになると、すべてのページがコミットされます。 +JVMの初期化中にJavaヒープ上のすべてのページのタッチを有効にします。これにより、\fBmain()\fRメソッドの入力前に、すべてのページがメモリーに取得されます。このオプションは、物理メモリーにマップされたすべての仮想メモリーを含む長時間実行のシステムをシミュレートするテストで使用できます。デフォルトでは、このオプションは無効になっており、JVMヒープ領域がいっぱいになると、すべてのページがコミットされます。 .RE .PP \-XX:+CMSClassUnloadingEnabled .RS 4 -並行マークスイープ(CMS)ガベージ・コレクタを使用する場合に、アンロードするクラスを有効にします。このオプションはデフォルトで有効になっています。CMSガベージ・コレクタのクラス・アンロードを無効にするには、\fI\-XX:\-CMSClassUnloadingEnabled\fRを指定します。 +並行マークスイープ(CMS)ガベージ・コレクタを使用する場合に、アンロードするクラスを有効にします。このオプションはデフォルトで有効になっています。CMSガベージ・コレクタのクラス・アンロードを無効にするには、\fB\-XX:\-CMSClassUnloadingEnabled\fRを指定します。 .RE .PP \-XX:CMSExpAvgFactor=\fIpercent\fR @@ -1785,79 +1893,8 @@ .RS 4 .\} .nf -\-XX:CMSExpAvgFactor=15 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:CMSIncrementalDutyCycle=\fIpercent\fR -.RS 4 -並行コレクタの実行が許可されているマイナー・コレクション間の時間の割合(0から100まで)を設定します。\fI\-XX:+CMSIncrementalPacing\fRが有効な場合、デューティ・サイクルが自動的に設定され、このオプションは初期値のみを設定します。 -.sp -デフォルトでは、デューティ・サイクルは10%に設定されています。次の例では、デューティ・サイクルを20%に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CMSIncrementalDutyCycle=20 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:CMSIncrementalDutyCycleMin=\fIpercent\fR -.RS 4 -\fI\-XX:+CMSIncrementalPacing\fRが有効な場合にデューティ・サイクルの下限であるマイナー・コレクション間の時間の割合(0から100まで)を設定します。デフォルトでは、デューティ・サイクルの下限は0%に設定されています。次の例では、下限を10%に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CMSIncrementalDutyCycleMin=10 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+CMSIncrementalMode -.RS 4 -CMSコレクタの増分モードを有効にします。このオプションはデフォルトで無効になっており、2つ以下のGCスレッドを持つ構成にのみ有効にする必要があります。\fICMSIncremental\fRで始まるすべてのオプションは、このオプションが有効な場合のみ、適用されます。 -.RE -.PP -\-XX:CMSIncrementalOffset=\fIpercent\fR -.RS 4 -増分モードのデューティ・サイクルをマイナー・コレクション間で期間内に右に移動する時間の割合(0から100まで)を設定します。デフォルトでは、オフセットは0%に設定されています。次の例では、デューティ・サイクルのオフセットを25%に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CMSIncrementalOffset=25 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+CMSIncrementalPacing -.RS 4 -JVMの実行中に収集された統計に基づいて、増分モードのデューティ・サイクルの自動調整を有効にします。このオプションはデフォルトで有効になっています。増分モード・デューティ・サイクルの自動調整を無効にするには、\fI\-XX:\-CMSIncrementalPacing\fRを指定します。 -.RE -.PP -\-XX:CMSIncrementalSafetyFactor=\fIpercent\fR -.RS 4 -デューティ・サイクルを計算する際に、保守を追加するために使用される時間の割合(0から100まで)を設定します。デフォルトでは、安全係数は10%に設定されています。次の例では、安全係数を5%に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CMSIncrementalSafetyFactor=5 +\fB\-XX:CMSExpAvgFactor=15\fR + .fi .if n \{\ .RE @@ -1866,7 +1903,7 @@ .PP \-XX:CMSInitiatingOccupancyFraction=\fIpercent\fR .RS 4 -CMS収集サイクルを開始する古い世代の占有率(0から100まで)を設定します。デフォルト値は\-1に設定されています。負の値(デフォルトを含む)は、\fI\-XX:CMSTriggerRatio\fRが開始占有率の値を定義するために使用されることを意味します。 +CMS収集サイクルを開始する古い世代の占有率(0から100まで)を設定します。デフォルト値は\-1に設定されています。負の値(デフォルトを含む)は、\fB\-XX:CMSTriggerRatio\fRが開始占有率の値を定義するために使用されることを意味します。 .sp 次の例では、占有率を20%に設定する方法を示します。 .sp @@ -1874,7 +1911,8 @@ .RS 4 .\} .nf -\-XX:CMSInitiatingOccupancyFraction=20 +\fB\-XX:CMSInitiatingOccupancyFraction=20\fR + .fi .if n \{\ .RE @@ -1888,7 +1926,7 @@ .PP \-XX:CMSTriggerRatio=\fIpercent\fR .RS 4 -CMS収集サイクルが開始する前に割り当てられる\fI\-XX:MinHeapFreeRatio\fRによって指定される値の割合(0から100まで)を設定します。デフォルト値は80%に設定されています。 +CMS収集サイクルが開始する前に割り当てられる\fB\-XX:MinHeapFreeRatio\fRによって指定される値の割合(0から100まで)を設定します。デフォルト値は80%に設定されています。 .sp 次の例では、占有率を75%に設定する方法を示します。 .sp @@ -1896,7 +1934,8 @@ .RS 4 .\} .nf -\-XX:CMSTriggerRatio=75 +\fB\-XX:CMSTriggerRatio=75\fR + .fi .if n \{\ .RE @@ -1913,7 +1952,8 @@ .RS 4 .\} .nf -\-XX:ConcGCThreads=2 +\fB\-XX:ConcGCThreads=2\fR + .fi .if n \{\ .RE @@ -1922,17 +1962,17 @@ .PP \-XX:+DisableExplicitGC .RS 4 -\fISystem\&.gc()\fRの呼出しの処理を無効にするオプションを有効にします。このオプションはデフォルトで無効になっており、これは\fISystem\&.gc()\fRへの呼出しが処理されることを意味します。\fISystem\&.gc()\fRの呼出しの処理が無効になっている場合、JVMは必要に応じてGCを実行します。 +\fBSystem\&.gc()\fRの呼出しの処理を無効にするオプションを有効にします。このオプションはデフォルトで無効になっており、これは\fBSystem\&.gc()\fRへの呼出しが処理されることを意味します。\fBSystem\&.gc()\fRの呼出しの処理が無効になっている場合、JVMは必要に応じてGCを実行します。 .RE .PP \-XX:+ExplicitGCInvokesConcurrent .RS 4 -\fISystem\&.gc()\fRリクエストを使用することによって、並行GCの呼出しを有効にします。このオプションはデフォルトで無効になっており、\fI\-XX:+UseConcMarkSweepGC\fRオプションとともに使用する場合のみ、有効にすることができます。 +\fBSystem\&.gc()\fRリクエストを使用することによって、並行GCの呼出しを有効にします。このオプションはデフォルトで無効になっており、\fB\-XX:+UseConcMarkSweepGC\fRオプションとともに使用する場合のみ、有効にすることができます。 .RE .PP \-XX:+ExplicitGCInvokesConcurrentAndUnloadsClasses .RS 4 -\fISystem\&.gc()\fRリクエストを使用し、並行GCサイクル中にクラスをアンロードすることによって、並行GCの呼出しを有効にします。このオプションはデフォルトで無効になっており、\fI\-XX:+UseConcMarkSweepGC\fRオプションとともに使用する場合のみ、有効にすることができます。 +\fBSystem\&.gc()\fRリクエストを使用し、並行GCサイクル中にクラスをアンロードすることによって、並行GCの呼出しを有効にします。このオプションはデフォルトで無効になっており、\fB\-XX:+UseConcMarkSweepGC\fRオプションとともに使用する場合のみ、有効にすることができます。 .RE .PP \-XX:G1HeapRegionSize=\fIsize\fR @@ -1945,7 +1985,8 @@ .RS 4 .\} .nf -\-XX:G1HeapRegionSize=16m +\fB\-XX:G1HeapRegionSize=16m\fR + .fi .if n \{\ .RE @@ -1967,7 +2008,8 @@ .RS 4 .\} .nf -\-XX:G1ReservePercent=20 +\fB\-XX:G1ReservePercent=20\fR + .fi .if n \{\ .RE @@ -1976,7 +2018,7 @@ .PP \-XX:InitialHeapSize=\fIsize\fR .RS 4 -メモリー割当てプールの初期サイズ(バイト単位)を設定します。指定する値は、0、または1MBより大きい1024の倍数のいずれかにする必要があります。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 +メモリー割当てプールの初期サイズ(バイト単位)を設定します。指定する値は、0、または1MBより大きい1024の倍数のいずれかにする必要があります。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 .sp 次の例では、割り当てられたメモリーのサイズを様々な単位を使用して6MBに設定する方法を示します。 .sp @@ -1984,19 +2026,20 @@ .RS 4 .\} .nf -\-XX:InitialHeapSize=6291456 -\-XX:InitialHeapSize=6144k -\-XX:InitialHeapSize=6m +\fB\-XX:InitialHeapSize=6291456\fR +\fB\-XX:InitialHeapSize=6144k\fR +\fB\-XX:InitialHeapSize=6m\fR + .fi .if n \{\ .RE .\} -このオプションを0に設定した場合、初期サイズは、古い世代と若い世代に割り当てられたサイズの合計として設定されます。若い世代のヒープのサイズは、\fI\-XX:NewSize\fRオプションを使用して設定できます。 +このオプションを0に設定した場合、初期サイズは、古い世代と若い世代に割り当てられたサイズの合計として設定されます。若い世代のヒープのサイズは、\fB\-XX:NewSize\fRオプションを使用して設定できます。 .RE .PP \-XX:InitialSurvivorRatio=\fIratio\fR .RS 4 -スループット・ガベージ・コレクタが使用するサバイバ領域の初期比を設定します(\fI\-XX:+UseParallelGC\fRおよび/または\fI\-XX:+UseParallelOldGC\fRオプションによって有効になります)。\fI\-XX:+UseParallelGC\fRオプションおよび\fI\-XX:+UseParallelOldGC\fRオプションを使用することによって、スループット・ガベージ・コレクタで適応サイズ指定をデフォルトで有効にします。初期値から始めて、アプリケーションの動作に従って、サバイバ領域がサイズ変更されます。(\fI\-XX:\-UseAdaptiveSizePolicy\fRオプションを使用して)適応サイズ指定を無効にした場合、\fI\-XX:SurvivorRatio\fRオプションを使用して、アプリケーションの実行全体のサバイバ領域のサイズを設定する必要があります。 +スループット・ガベージ・コレクタが使用するサバイバ領域の初期比を設定します(\fB\-XX:+UseParallelGC\fRおよび/または\fB\-XX:+UseParallelOldGC\fRオプションによって有効になります)。\fB\-XX:+UseParallelGC\fRオプションおよび\fB\-XX:+UseParallelOldGC\fRオプションを使用することによって、スループット・ガベージ・コレクタで適応サイズ指定をデフォルトで有効にします。初期値から始めて、アプリケーションの動作に従って、サバイバ領域がサイズ変更されます。(\fB\-XX:\-UseAdaptiveSizePolicy\fRオプションを使用して)適応サイズ指定を無効にした場合、\fB\-XX:SurvivorRatio\fRオプションを使用して、アプリケーションの実行全体のサバイバ領域のサイズを設定する必要があります。 .sp 次の式を使用して、若い世代のサイズ(Y)およびサバイバ領域の初期比(R)に基づいて、サバイバ領域の初期サイズ(S)を計算できます。 .sp @@ -2004,7 +2047,8 @@ .RS 4 .\} .nf -S=Y/(R+2) +\fBS=Y/(R+2)\fR + .fi .if n \{\ .RE @@ -2019,7 +2063,8 @@ .RS 4 .\} .nf -\-XX:InitialSurvivorRatio=4 +\fB\-XX:InitialSurvivorRatio=4\fR + .fi .if n \{\ .RE @@ -2036,7 +2081,8 @@ .RS 4 .\} .nf -\-XX:InitiatingHeapOccupancyPercent=75 +\fB\-XX:InitiatingHeapOccupancyPercent=75\fR + .fi .if n \{\ .RE @@ -2053,7 +2099,8 @@ .RS 4 .\} .nf -\-XX:MaxGCPauseMillis=500 +\fB\-XX:MaxGCPauseMillis=500\fR + .fi .if n \{\ .RE @@ -2062,7 +2109,7 @@ .PP \-XX:MaxHeapSize=\fIsize\fR .RS 4 -メモリー割当てプールの最大サイズ(バイト単位)を設定します。指定する値は、2MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。サーバー・デプロイメントでは、\fI\-XX:InitialHeapSize\fRおよび\fI\-XX:MaxHeapSize\fRは通常同じ値に設定されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 +メモリー割当てプールの最大サイズ(バイト単位)を設定します。指定する値は、2MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。サーバー・デプロイメントでは、\fB\-XX:InitialHeapSize\fRおよび\fB\-XX:MaxHeapSize\fRは通常同じ値に設定されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 .sp 次の例では、割り当てられたメモリーの許可される最大サイズを様々な単位を使用して80MBに設定する方法を示します。 .sp @@ -2070,16 +2117,17 @@ .RS 4 .\} .nf -\-XX:MaxHeapSize=83886080 -\-XX:MaxHeapSize=81920k -\-XX:MaxHeapSize=80m +\fB\-XX:MaxHeapSize=83886080\fR +\fB\-XX:MaxHeapSize=81920k\fR +\fB\-XX:MaxHeapSize=80m\fR + .fi .if n \{\ .RE .\} Oracle Solaris 7およびOracle Solaris 8 SPARCプラットフォームの場合のこの値の上限は、およそ4,000MBからオーバーヘッドの量を引いたものです。Oracle Solaris 2\&.6およびx86プラットフォームの場合の上限は、およそ2,000MBからオーバーヘッドの量を引いたものです。Linuxプラットフォームの場合の上限は、およそ2,000MBからオーバーヘッドの量を引いたものです。 .sp -\fI\-XX:MaxHeapSize\fRオプションは\fI\-Xmx\fRと同等です。 +\fB\-XX:MaxHeapSize\fRオプションは\fB\-Xmx\fRと同等です。 .RE .PP \-XX:MaxHeapFreeRatio=\fIpercent\fR @@ -2092,7 +2140,8 @@ .RS 4 .\} .nf -\-XX:MaxHeapFreeRatio=75 +\fB\-XX:MaxHeapFreeRatio=75\fR + .fi .if n \{\ .RE @@ -2109,7 +2158,8 @@ .RS 4 .\} .nf -\-XX:MaxMetaspaceSize=256m +\fB\-XX:MaxMetaspaceSize=256m\fR + .fi .if n \{\ .RE @@ -2131,7 +2181,8 @@ .RS 4 .\} .nf -\-XX:MaxTenuringThreshold=10 +\fB\-XX:MaxTenuringThreshold=10\fR + .fi .if n \{\ .RE @@ -2153,7 +2204,8 @@ .RS 4 .\} .nf -\-XX:MinHeapFreeRatio=25 +\fB\-XX:MinHeapFreeRatio=25\fR + .fi .if n \{\ .RE @@ -2168,7 +2220,8 @@ .RS 4 .\} .nf -\-XX:NewRatio=1 +\fB\-XX:NewRatio=1\fR + .fi .if n \{\ .RE @@ -2177,7 +2230,7 @@ .PP \-XX:NewSize=\fIsize\fR .RS 4 -若い世代(ナーサリ)のヒープの初期サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。 +若い世代(ナーサリ)のヒープの初期サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。 .sp ヒープの若い世代リージョンは新しいオブジェクトに使用されます。GCは、他のリージョンよりこのリージョンで、より頻繁に実行されます。若い世代のサイズが小さすぎる場合、多数のマイナーGCが実行されます。サイズが大きすぎる場合、フルGCのみが実行されますが、完了までに時間がかかることがあります。若い世代のサイズは、全体のヒープ・サイズの半分から4分の1の間にしておくことをお薦めします。 .sp @@ -2187,14 +2240,15 @@ .RS 4 .\} .nf -\-XX:NewSize=256m -\-XX:NewSize=262144k -\-XX:NewSize=268435456 +\fB\-XX:NewSize=256m\fR +\fB\-XX:NewSize=262144k\fR +\fB\-XX:NewSize=268435456\fR + .fi .if n \{\ .RE .\} -\fI\-XX:NewSize\fRオプションは\fI\-Xmn\fRと同等です。 +\fB\-XX:NewSize\fRオプションは\fB\-Xmn\fRと同等です。 .RE .PP \-XX:ParallelGCThreads=\fIthreads\fR @@ -2207,7 +2261,8 @@ .RS 4 .\} .nf -\-XX:ParallelGCThreads=2 +\fB\-XX:ParallelGCThreads=2\fR + .fi .if n \{\ .RE @@ -2239,7 +2294,7 @@ 休止(たとえばGC休止など)が継続した時間の出力を有効にします。デフォルトでは、このオプションは無効です。 .RE .PP -\-XX+PrintGCDateStamp +\-XX:+PrintGCDateStamps .RS 4 GCごとの日付スタンプの出力を有効にします。デフォルトでは、このオプションは無効です。 .RE @@ -2254,11 +2309,16 @@ 個々のGCワーカー・スレッド・タスクごとのタイムスタンプの出力を有効にします。デフォルトでは、このオプションは無効です。 .RE .PP -\-XX:+PrintGCTimeStamp +\-XX:+PrintGCTimeStamps .RS 4 GCごとのタイムスタンプの出力を有効にします。デフォルトでは、このオプションは無効です。 .RE .PP +\-XX:+PrintStringDeduplicationStatistics +.RS 4 +詳細な重複除外統計を印刷します。デフォルトでは、このオプションは無効です。\fB\-XX:+UseStringDeduplication\fRオプションを参照してください。 +.RE +.PP \-XX:+PrintTenuringDistribution .RS 4 殿堂入り期間情報の出力を有効にします。次に、出力の例を示します。 @@ -2267,11 +2327,12 @@ .RS 4 .\} .nf -Desired survivor size 48286924 bytes, new threshold 10 (max 10) -\- age 1: 28992024 bytes, 28992024 total -\- age 2: 1366864 bytes, 30358888 total -\- age 3: 1425912 bytes, 31784800 total -\&.\&.\&. +\fBDesired survivor size 48286924 bytes, new threshold 10 (max 10)\fR +\fB\- age 1: 28992024 bytes, 28992024 total\fR +\fB\- age 2: 1366864 bytes, 30358888 total\fR +\fB\- age 3: 1425912 bytes, 31784800 total\fR +\fB\&.\&.\&.\fR + .fi .if n \{\ .RE @@ -2285,12 +2346,12 @@ .PP \-XX:+ScavengeBeforeFullGC .RS 4 -それぞれのフルGCの前に若い世代のGCを有効にします。このオプションはデフォルトで有効になっています。フルGCの前に若い世代のスカベンジを行うと、古い世代領域から若い世代領域へのアクセスが可能なオブジェクトの数を減らすことができるため、これを無効に\fIしない\fRことをお薦めします。各フルGCの前に若い世代のGCを無効にするには、\fI\-XX:\-ScavengeBeforeFullGC\fRを指定します。 +それぞれのフルGCの前に若い世代のGCを有効にします。このオプションはデフォルトで有効になっています。フルGCの前に若い世代のスカベンジを行うと、古い世代領域から若い世代領域へのアクセスが可能なオブジェクトの数を減らすことができるため、これを無効に\fIしない\fRことをお薦めします。各フルGCの前に若い世代のGCを無効にするには、\fB\-XX:\-ScavengeBeforeFullGC\fRを指定します。 .RE .PP \-XX:SoftRefLRUPolicyMSPerMB=\fItime\fR .RS 4 -ソフト・アクセスが可能なオブジェクトが最後に参照されてからヒープ上でアクティブなままになっている時間(ミリ秒単位)を設定します。デフォルト値は、ヒープ内の空きメガバイト当たりで1秒の存続期間です。\fI\-XX:SoftRefLRUPolicyMSPerMB\fRオプションは、現在のヒープ・サイズ(Java HotSpot Client VM用)または最大可能ヒープ・サイズ(Java HotSpot Server VM用)の1メガバイト当たりのミリ秒を表す整数値を受け入れます。この違いは、Client VMは、ヒープを大きくするのではなく、ソフト参照をフラッシュする傾向があるのに対し、Server VMは、ソフト参照をフラッシュするのではなく、ヒープを大きくする傾向があることを意味します。後者の場合、\fI\-Xmx\fRオプションの値は、ソフト参照がどのくらい迅速にガベージ・コレクションされるかに重要な影響を及ぼします。 +ソフト・アクセスが可能なオブジェクトが最後に参照されてからヒープ上でアクティブなままになっている時間(ミリ秒単位)を設定します。デフォルト値は、ヒープ内の空きメガバイト当たりで1秒の存続期間です。\fB\-XX:SoftRefLRUPolicyMSPerMB\fRオプションは、現在のヒープ・サイズ(Java HotSpot Client VM用)または最大可能ヒープ・サイズ(Java HotSpot Server VM用)の1メガバイト当たりのミリ秒を表す整数値を受け入れます。この違いは、Client VMは、ヒープを大きくするのではなく、ソフト参照をフラッシュする傾向があるのに対し、Server VMは、ソフト参照をフラッシュするのではなく、ヒープを大きくする傾向があることを意味します。後者の場合、\fB\-Xmx\fRオプションの値は、ソフト参照がどのくらい迅速にガベージ・コレクションされるかに重要な影響を及ぼします。 .sp 次の例では、値を2\&.5秒に設定する方法を示します。 .sp @@ -2298,13 +2359,19 @@ .RS 4 .\} .nf -\-XX:SoftRefLRUPolicyMSPerMB=2500 +\fB\-XX:SoftRefLRUPolicyMSPerMB=2500\fR + .fi .if n \{\ .RE .\} .RE .PP +\-XX:StringDeduplicationAgeThreshold=\fIthreshold\fR +.RS 4 +指定した期間に到達しつつある\fBString\fRオブジェクトは、重複除外の候補とみなされます。オブジェクトの期間は、オブジェクトがガベージ・コレクションで存続した回数の測定値です。これは、殿堂入りと呼ばれる場合もあります。\fB\-XX:+PrintTenuringDistribution\fRオプションを参照してください。この期間に到達する前に古いヒープ・リージョンに昇格された\fBString\fRオブジェクトは、常に重複除外の候補とみなされます。このオプションのデフォルト値は\fB3\fRです。\fB\-XX:+UseStringDeduplication\fRオプションを参照してください。 +.RE +.PP \-XX:SurvivorRatio=\fIratio\fR .RS 4 Eden領域のサイズとサバイバ領域のサイズとの比率を設定します。デフォルトでは、このオプションは8に設定されています。次の例では、Eden/サバイバ領域の比率を4に設定する方法を示します。 @@ -2313,7 +2380,8 @@ .RS 4 .\} .nf -\-XX:SurvivorRatio=4 +\fB\-XX:SurvivorRatio=4\fR + .fi .if n \{\ .RE @@ -2330,7 +2398,8 @@ .RS 4 .\} .nf -\-XX:TargetSurvivorRatio=30 +\fB\-XX:TargetSurvivorRatio=30\fR + .fi .if n \{\ .RE @@ -2339,7 +2408,7 @@ .PP \-XX:TLABSize=\fIsize\fR .RS 4 -スレッド・ローカルな割当てバッファ(TLAB)の初期サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。このオプションが0に設定されている場合、JVMでは初期サイズが自動的に選択されます。 +スレッド・ローカルな割当てバッファ(TLAB)の初期サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。このオプションが0に設定されている場合、JVMでは初期サイズが自動的に選択されます。 .sp 次の例では、TLABの初期サイズを512KBに設定する方法を示します。 .sp @@ -2347,7 +2416,8 @@ .RS 4 .\} .nf -\-XX:TLABSize=512k +\fB\-XX:TLABSize=512k\fR + .fi .if n \{\ .RE @@ -2356,7 +2426,7 @@ .PP \-XX:+UseAdaptiveSizePolicy .RS 4 -適応世代サイズ指定の使用を有効にします。このオプションはデフォルトで有効になっています。適応世代サイズ指定を無効にするには、\fI\-XX:\-UseAdaptiveSizePolicy\fRを指定し、メモリー割当てプールのサイズを明示的に設定します(\fI\-XX:SurvivorRatio\fRオプションを参考にしてください)。 +適応世代サイズ指定の使用を有効にします。このオプションはデフォルトで有効になっています。適応世代サイズ指定を無効にするには、\fB\-XX:\-UseAdaptiveSizePolicy\fRを指定し、メモリー割当てプールのサイズを明示的に設定します(\fB\-XX:SurvivorRatio\fRオプションを参考にしてください)。 .RE .PP \-XX:+UseCMSInitiatingOccupancyOnly @@ -2366,43 +2436,43 @@ .PP \-XX:+UseConcMarkSweepGC .RS 4 -古い世代へのCMSガベージ・コレクタの使用を有効にします。アプリケーションの待機時間の要件を、スループット(\fI\-XX:+UseParallelGC\fR)ガベージ・コレクタによって満たすことができない場合、CMSガベージ・コレクタを使用することをお薦めします。G1ガベージ・コレクタ(\fI\-XX:+UseG1GC\fR)は別の代替となります。 +古い世代へのCMSガベージ・コレクタの使用を有効にします。アプリケーションの待機時間の要件を、スループット(\fB\-XX:+UseParallelGC\fR)ガベージ・コレクタによって満たすことができない場合、CMSガベージ・コレクタを使用することをお薦めします。G1ガベージ・コレクタ(\fB\-XX:+UseG1GC\fR)は別の代替となります。 .sp -デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。このオプションを有効にすると、\fI\-XX:+UseParNewGC\fRオプションが自動的に設定されます。 +デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。このオプションが有効な場合、\fB\-XX:+UseParNewGC\fRオプションは自動的に設定され、無効化しない必要がありますが、理由はJDK 8では\fB\-XX:+UseConcMarkSweepGC \-XX:\-UseParNewGC\fRオプションの組合せが非推奨であるためです。 .RE .PP \-XX:+UseG1GC .RS 4 -G1ガベージ・コレクタの使用を有効にします。これはサーバー形式のガベージ・コレクタで、大量のRAMを持つマルチプロセッサ・マシンを対象としています。高い確率でGC休止時間の目標を達成し、同時に適切なスループットも維持します。G1コレクタは、GC待機時間の限定された要件(安定した予測可能な0\&.5秒未満の休止時間)を持つ、大きいヒープ(約6GB以上のサイズ)が必要なアプリケーションに推奨されます。 +ガベージファースト(G1)・ガベージ・コレクタの使用を有効にします。これはサーバー形式のガベージ・コレクタで、大量のRAMを持つマルチプロセッサ・マシンを対象としています。高い確率でGC休止時間の目標を達成し、同時に適切なスループットも維持します。G1コレクタは、GC待機時間の限定された要件(安定した予測可能な0\&.5秒未満の休止時間)を持つ、大きいヒープ(約6GB以上のサイズ)が必要なアプリケーションに推奨されます。 .sp デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。 .RE .PP \-XX:+UseGCOverheadLimit .RS 4 -\fIOutOfMemoryError\fR例外がスローされるまでに、GCでJVMによって要した時間の割合を制限するポリシーの使用を有効にします。デフォルトでは、このオプションは有効になっており、ガベージ・コレクションに合計時間の98%より多く費やされ、ヒープのリカバリが2%未満である場合、パラレルGCによって\fIOutOfMemoryError\fRがスローされます。ヒープが小さい場合、この機能は、アプリケーションが長期間ほとんどまたはまったく進捗なく実行している状態を回避するために使用できます。このオプションを無効にするには、\fI\-XX:\-UseGCOverheadLimit\fRを指定します。 +\fBOutOfMemoryError\fR例外がスローされるまでに、GCでJVMによって要した時間の割合を制限するポリシーの使用を有効にします。デフォルトでは、このオプションは有効になっており、ガベージ・コレクションに合計時間の98%より多く費やされ、ヒープのリカバリが2%未満である場合、パラレルGCによって\fBOutOfMemoryError\fRがスローされます。ヒープが小さい場合、この機能は、アプリケーションが長期間ほとんどまたはまったく進捗なく実行している状態を回避するために使用できます。このオプションを無効にするには、\fB\-XX:\-UseGCOverheadLimit\fRを指定します。 .RE .PP \-XX:+UseNUMA .RS 4 -アプリケーションで短い待機時間のメモリーの使用を増加させることで、不均一なメモリー・アーキテクチャ(NUMA)を使用したマシン上のアプリケーションのパフォーマンス最適化を有効にします。デフォルトでは、このオプションは無効になっており、NUMAに対する最適化は行われません。このオプションは、パラレル・ガベージ・コレクタ(\fI\-XX:+UseParallelGC\fR)が使用されている場合のみ使用可能です。 +アプリケーションで短い待機時間のメモリーの使用を増加させることで、不均一なメモリー・アーキテクチャ(NUMA)を使用したマシン上のアプリケーションのパフォーマンス最適化を有効にします。デフォルトでは、このオプションは無効になっており、NUMAに対する最適化は行われません。このオプションは、パラレル・ガベージ・コレクタ(\fB\-XX:+UseParallelGC\fR)が使用されている場合のみ使用可能です。 .RE .PP \-XX:+UseParallelGC .RS 4 複数のプロセッサを利用してアプリケーションのパフォーマンスを向上させる、パラレル・スカベンジ・ガベージ・コレクタ(スループット・コレクタとも呼ばれる)の使用を有効にします。 .sp -デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。これを有効にした場合、明示的に無効にしないかぎり、\fI\-XX:+UseParallelOldGC\fRオプションが自動的に有効になります。 +デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。これを有効にした場合、明示的に無効にしないかぎり、\fB\-XX:+UseParallelOldGC\fRオプションが自動的に有効になります。 .RE .PP \-XX:+UseParallelOldGC .RS 4 -フルGCへのパラレル・ガベージ・コレクタの使用を有効にします。デフォルトでは、このオプションは無効です。これを有効にすると、\fI\-XX:+UseParallelGC\fRオプションが自動的に有効になります。 +フルGCへのパラレル・ガベージ・コレクタの使用を有効にします。デフォルトでは、このオプションは無効です。これを有効にすると、\fB\-XX:+UseParallelGC\fRオプションが自動的に有効になります。 .RE .PP \-XX:+UseParNewGC .RS 4 -若い世代でのコレクションへのパラレル・スレッドの使用を有効にします。デフォルトでは、このオプションは無効です。\fI\-XX:+UseConcMarkSweepGC\fRオプションを設定すると、これは自動的に有効になります。 +若い世代でのコレクションへのパラレル・スレッドの使用を有効にします。デフォルトでは、このオプションは無効です。\fB\-XX:+UseConcMarkSweepGC\fRオプションを設定すると、これは自動的に有効になります。JDK 8では、\fB\-XX:+UseConcMarkSweepGC\fRオプションを指定せずに\fB\-XX:+UseParNewGC\fRオプションを使用することは非推奨です。 .RE .PP \-XX:+UseSerialGC @@ -2410,17 +2480,59 @@ シリアル・ガベージ・コレクタの使用を有効にします。ガベージ・コレクションから特別な機能を必要としない、小規模で単純なアプリケーションの場合には、これは一般に最適な選択です。デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。 .RE .PP +\-XX:+UseStringDeduplication +.RS 4 +文字列の重複除外を有効化します。デフォルトでは、このオプションは無効です。このオプションを使用するには、ガベージファースト(G1)・ガベージ・コレクタを有効にする必要があります。\fB\-XX:+UseG1GC\fRオプションを参照してください。 +.sp +多くの\fBString\fRオブジェクトが同じであるということから、\fIString deduplication\fRにより、Javaヒープ上の\fBString\fRオブジェクトのメモリー・フットプリントが削減されます。各\fBString\fRオブジェクトが独自の文字配列をポイントするのではなく、同一の\fBString\fRオブジェクトは同じ文字配列をポイントし共有できます。 +.RE +.PP \-XX:+UseTLAB .RS 4 -若い世代の領域でのスレッド・ローカルな割当てブロック(TLAB)の使用を有効にします。このオプションはデフォルトで有効になっています。TLABの使用を無効にするには、\fI\-XX:\-UseTLAB\fRを指定します。 +若い世代の領域でのスレッド・ローカルな割当てブロック(TLAB)の使用を有効にします。このオプションはデフォルトで有効になっています。TLABの使用を無効にするには、\fB\-XX:\-UseTLAB\fRを指定します。 .RE .SS "非推奨で削除されたオプション" .PP これらのオプションは、以前のリリースには含まれていましたが、以降は不要とみなされています。 .PP +\-Xincgc +.RS 4 +インクリメンタル・ガベージ・コレクションを有効にします。このオプションはJDK 8では非推奨で、それに代わるものはありません。 +.RE +.PP \-Xrun\fIlibname\fR .RS 4 -指定したデバッグ/プロファイルのライブラリをロードします。このオプションは、\fI\-agentlib\fRオプションに取って代わられました。 +指定したデバッグ/プロファイルのライブラリをロードします。このオプションは、\fB\-agentlib\fRオプションに取って代わられました。 +.RE +.PP +\-XX:CMSIncrementalDutyCycle=\fIpercent\fR +.RS 4 +並行コレクタの実行が許可されているマイナー・コレクション間の時間の割合(0から100まで)を設定します。\fB\-XX:+CMSIncrementalMode\fRオプションの非推奨を受けて、このオプションはJDK 8では非推奨となり、それに代わるものはありません。 +.RE +.PP +\-XX:CMSIncrementalDutyCycleMin=\fIpercent\fR +.RS 4 +\fB\-XX:+CMSIncrementalPacing\fRが有効な場合にデューティ・サイクルの下限であるマイナー・コレクション間の時間の割合(0から100まで)を設定します。\fB\-XX:+CMSIncrementalMode\fRオプションの非推奨を受けて、このオプションはJDK 8では非推奨となり、それに代わるものはありません。 +.RE +.PP +\-XX:+CMSIncrementalMode +.RS 4 +CMSコレクタの増分モードを有効にします。\fBCMSIncremental\fRで始まるその他のオプションとともに、このオプションはJDK 8では非推奨となり、それに代わるものはありません +.RE +.PP +\-XX:CMSIncrementalOffset=\fIpercent\fR +.RS 4 +増分モードのデューティ・サイクルをマイナー・コレクション間で期間内に右に移動する時間の割合(0から100まで)を設定します。\fB\-XX:+CMSIncrementalMode\fRオプションの非推奨を受けて、このオプションはJDK 8では非推奨となり、それに代わるものはありません。 +.RE +.PP +\-XX:+CMSIncrementalPacing +.RS 4 +JVMの実行中に収集された統計に基づいて、増分モードのデューティ・サイクルの自動調整を有効にします。\fB\-XX:+CMSIncrementalMode\fRオプションの非推奨を受けて、このオプションはJDK 8では非推奨となり、それに代わるものはありません。 +.RE +.PP +\-XX:CMSIncrementalSafetyFactor=\fIpercent\fR +.RS 4 +デューティ・サイクルを計算する際に、保守を追加するために使用される時間の割合(0から100まで)を設定します。\fB\-XX:+CMSIncrementalMode\fRオプションの非推奨を受けて、このオプションはJDK 8では非推奨となり、それに代わるものはありません。 .RE .PP \-XX:CMSInitiatingPermOccupancyFraction=\fIpercent\fR @@ -2430,12 +2542,12 @@ .PP \-XX:MaxPermSize=\fIsize\fR .RS 4 -永久世代領域の最大サイズ(バイト単位)を設定します。このオプションは、JDK 8で非推奨になり、\fI\-XX:MaxMetaspaceSize\fRオプションに取って代わられました。 +永久世代領域の最大サイズ(バイト単位)を設定します。このオプションは、JDK 8で非推奨になり、\fB\-XX:MaxMetaspaceSize\fRオプションに取って代わられました。 .RE .PP \-XX:PermSize=\fIsize\fR .RS 4 -超えた場合にはガベージ・コレクションをトリガーする、永久世代に割り当てられた領域(バイト単位)を設定します。このオプションは、JDK 8で非推奨になり、\fI\-XX:MetaspaceSize\fRオプションに取って代わられました。 +超えた場合にはガベージ・コレクションをトリガーする、永久世代に割り当てられた領域(バイト単位)を設定します。このオプションは、JDK 8で非推奨になり、\fB\-XX:MetaspaceSize\fRオプションに取って代わられました。 .RE .PP \-XX:+UseSplitVerifier @@ -2451,28 +2563,34 @@ .PP 次の例では、スループットの最適化またはレスポンス時間の短縮化のいずれかを行うための、試験的なチューニング・フラグの使用方法を示します。 .PP -\fBExample 1\fR, スループットを向上するためのチューニング +\fB例 1\fR +.br +スループットを向上するためのチューニング .RS 4 .sp .if n \{\ .RS 4 .\} .nf -java \-d64 \-server \-XX:+AggressiveOpts \-XX:+UseLargePages \-Xmn10g \-Xms26g \-Xmx26g +\fBjava \-d64 \-server \-XX:+AggressiveOpts \-XX:+UseLargePages \-Xmn10g \-Xms26g \-Xmx26g\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 2\fR, レスポンス時間を速くするためのチューニング +\fB例 2\fR +.br +レスポンス時間を速くするためのチューニング .RS 4 .sp .if n \{\ .RS 4 .\} .nf -java \-d64 \-XX:+UseG1GC \-Xms26g Xmx26g \-XX:MaxGCPauseMillis=500 \-XX:+PrintGCTimeStamp +\fBjava \-d64 \-XX:+UseG1GC \-Xms26g Xmx26g \-XX:MaxGCPauseMillis=500 \-XX:+PrintGCTimeStamp\fR + .fi .if n \{\ .RE @@ -2480,7 +2598,7 @@ .RE .SH "終了ステータス" .PP -通常、次の終了値が起動ツールから返されるのは、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいはJVMにより例外がスローされた場合です。ただし、Javaアプリケーションは、API呼出し\fISystem\&.exit(exitValue)\fRを使用して任意の値を返すことを選択することもできます。値は次のとおりです。 +通常、次の終了値が起動ツールから返されるのは、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいはJVMにより例外がスローされた場合です。ただし、Javaアプリケーションは、API呼出し\fBSystem\&.exit(exitValue)\fRを使用して任意の値を返すことを選択することもできます。値は次のとおりです。 .sp .RS 4 .ie n \{\ @@ -2490,7 +2608,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI0\fR: 正常終了 +\fB0\fR: 正常終了 .RE .sp .RS 4 @@ -2501,7 +2619,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI>0\fR: エラー発生 +\fB>0\fR: エラー発生 .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/javac.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/javac.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: javac -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,8 +21,16 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 -.TH "javac" "1" "2013年11月21日" "JDK 8" "基本ツール" +.\" Title: javac +.\" Language: Japanese +.\" Date: 2014年8月8日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 +.TH "javac" "1" "2014年8月8日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" javac \- Javaクラスおよびインタフェースの定義を読み取り、バイトコードおよびクラス・ファイルにコンパイルします。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjavac\fR [ \fIoptions\fR ] [ \fIsourcefiles\fR ] [ \fIclasses\fR] [ \fI@argfiles\fR ] +\fBjavac\fR [ \fIoptions\fR ] [ \fIsourcefiles\fR ] [ \fIclasses\fR] [ \fI@argfiles\fR ] .fi .if n \{\ .RE @@ -66,28 +68,28 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIsourcefiles\fR .RS 4 -コンパイルされる1つ以上のソース・ファイル(\fIMyClass\&.java\fRなど)。 +コンパイルされる1つ以上のソース・ファイル(\fBMyClass\&.java\fRなど)。 .RE .PP \fIclasses\fR .RS 4 -注釈の処理対象となる1つ以上のクラス(\fIMyPackage\&.MyClass\fRなど)。 +注釈の処理対象となる1つ以上のクラス(\fBMyPackage\&.MyClass\fRなど)。 .RE .PP \fI@argfiles\fR .RS 4 -オプションとソース・ファイルを一覧表示する1つ以上のファイル。このファイルの中では\fI\-J\fRオプションは指定できません。コマンドライン引数ファイルを参照してください。 +オプションとソース・ファイルを一覧表示する1つ以上のファイル。このファイルの中では\fB\-J\fRオプションは指定できません。コマンド行引数ファイルを参照してください。 .RE .SH "説明" .PP -\fIjavac\fRコマンドは、Javaプログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラス・ファイルにコンパイルします。\fIjavac\fRコマンドでは、Javaソース・ファイルおよびクラス内の注釈の処理もできます。 +\fBjavac\fRコマンドは、Javaプログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラス・ファイルにコンパイルします。\fBjavac\fRコマンドでは、Javaソース・ファイルおよびクラス内の注釈の処理もできます。 .PP -ソース・コードのファイル名を\fIjavac\fRに渡すには、2つの方法があります。 +ソース・コードのファイル名を\fBjavac\fRに渡すには、2つの方法があります。 .sp .RS 4 .ie n \{\ @@ -97,7 +99,7 @@ .sp -1 .IP \(bu 2.3 .\} -ソース・ファイルの数が少ない場合は、ファイル名をコマンドラインで指定します。 +ソース・ファイルの数が少ない場合は、ファイル名をコマンド行で指定します。 .RE .sp .RS 4 @@ -108,19 +110,19 @@ .sp -1 .IP \(bu 2.3 .\} -ソース・ファイルの数が多い場合は、ファイル内のファイル名を空白または改行で区切って指定します。\fIjavac\fRコマンドで、リスト・ファイル名の先頭にアットマーク(@)を使用します。 +ソース・ファイルの数が多い場合は、ファイル内のファイル名を空白または改行で区切って指定します。\fBjavac\fRコマンドで、リスト・ファイル名の先頭にアットマーク(@)を使用します。 .RE .PP -ソース・コードのファイル名は\&.java拡張子を、クラスのファイル名は\&.class拡張子を持っている必要があります。また、ソース・ファイルとクラス・ファイルのどちらも、該当するクラスに対応するルート名を持っている必要があります。たとえば、\fIMyClass\fRという名前のクラスは、\fIMyClass\&.java\fRという名前のソース・ファイルに記述されます。このソース・ファイルは、\fIMyClass\&.class\fRという名前のバイトコード・クラス・ファイルにコンパイルされます。 +ソース・コードのファイル名は\&.java拡張子を、クラスのファイル名は\&.class拡張子を持っている必要があります。また、ソース・ファイルとクラス・ファイルのどちらも、該当するクラスに対応するルート名を持っている必要があります。たとえば、\fBMyClass\fRという名前のクラスは、\fBMyClass\&.java\fRという名前のソース・ファイルに記述されます。このソース・ファイルは、\fBMyClass\&.class\fRという名前のバイトコード・クラス・ファイルにコンパイルされます。 .PP -内部クラスが定義されていると、追加のクラス・ファイルが生成されます。これらのクラス・ファイルの名前は、\fIMyClass$MyInnerClass\&.class\fRのように、内部クラス名と外部クラス名を組み合せたものになります。 +内部クラスが定義されていると、追加のクラス・ファイルが生成されます。これらのクラス・ファイルの名前は、\fBMyClass$MyInnerClass\&.class\fRのように、内部クラス名と外部クラス名を組み合せたものになります。 .PP -ソース・ファイルは、パッケージ・ツリーを反映したディレクトリ・ツリーに配置します。たとえば、すべてのソース・ファイルが\fI/workspace\fRにある場合、\fIcom\&.mysoft\&.mypack\&.MyClass\fRのソース・コードを、\fI/workspace/com/mysoft/mypack/MyClass\&.java\fRに格納します。 +ソース・ファイルは、パッケージ・ツリーを反映したディレクトリ・ツリーに配置します。たとえば、すべてのソース・ファイルが\fB/workspace\fRにある場合、\fBcom\&.mysoft\&.mypack\&.MyClass\fRのソース・コードを、\fB/workspace/com/mysoft/mypack/MyClass\&.java\fRに格納します。 .PP -デフォルトでは、コンパイラは、各クラス・ファイルを対応するソース・ファイルと同じディレクトリに格納します。\fI\-d\fRオプションを使用して、別の出力先ディレクトリを指定できます。 +デフォルトでは、コンパイラは、各クラス・ファイルを対応するソース・ファイルと同じディレクトリに格納します。\fB\-d\fRオプションを使用して、別の出力先ディレクトリを指定できます。 .SH "オプション" .PP -コンパイラには、現在の開発環境でサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来、変更される可能性があります。非標準オプションは、\fI\-X\fRオプションで始まります。 +コンパイラには、現在の開発環境でサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来、変更される可能性があります。非標準オプションは、\fB\-X\fRオプションで始まります。 .sp .RS 4 .ie n \{\ @@ -130,7 +132,7 @@ .sp -1 .IP \(bu 2.3 .\} -クロスコンパイル・オプションを参照してください。 +クロスコンパイル・オプションも参照してください .RE .sp .RS 4 @@ -141,22 +143,22 @@ .sp -1 .IP \(bu 2.3 .\} -非標準オプションを参照してください。 +非標準オプションも参照してください .RE .SS "標準オプション" .PP \-A\fIkey\fR[\fI=value\fR] .RS 4 -注釈プロセッサに渡すオプションを指定します。これらのオプションは、\fIjavac\fRが直接解釈するのではなく、それぞれのプロセッサで使用できるようになります。\fIkey\fRの値は、1つまたは複数の識別子をドット(\&.)で区切る必要があります。 +注釈プロセッサに渡すオプションを指定します。これらのオプションは、\fBjavac\fRが直接解釈するのではなく、それぞれのプロセッサで使用できるようになります。\fBkey\fRの値は、1つまたは複数の識別子をドット(\&.)で区切る必要があります。 .RE .PP \-cp \fIpath\fR or \-classpath \fIpath\fR .RS 4 -ユーザー・クラス・ファイル、および(オプションで)注釈プロセッサとソース・ファイルを検索する場所を指定します。このクラス・パスは\fICLASSPATH\fR環境変数のユーザー・クラス・パスをオーバーライドします。\fICLASSPATH\fR、\fI\-cp\fR、\fI\-classpath\fRのいずれも指定されていない場合、ユーザーの\fIクラス・パス\fRは、現在のディレクトリになります。Setting the Class Path を参照してください。 +ユーザー・クラス・ファイル、および(オプションで)注釈プロセッサとソース・ファイルを検索する場所を指定します。このクラス・パスは\fBCLASSPATH\fR環境変数のユーザー・クラス・パスをオーバーライドします。\fBCLASSPATH\fR、\fB\-cp\fR、\fB\-classpath\fRのいずれも指定されていない場合、ユーザーの\fIクラス・パス\fRは、現在のディレクトリになります。Setting the Class Path を参照してください。 .sp -\fI\-sourcepath\fRオプションが指定されていない場合、ソース・ファイルもユーザー・クラス・パスから検索されます。 +\fB\-sourcepath\fRオプションが指定されていない場合、ソース・ファイルもユーザー・クラス・パスから検索されます。 .sp -\fI\-processorpath\fRオプションが指定されていない場合、注釈プロセッサもクラス・パスから検索されます。 +\fB\-processorpath\fRオプションが指定されていない場合、注釈プロセッサもクラス・パスから検索されます。 .RE .PP \-Djava\&.ext\&.dirs=\fIdirectories\fR @@ -171,12 +173,12 @@ .PP \-d \fIdirectory\fR .RS 4 -クラス・ファイルの出力先ディレクトリを設定します。そのディレクトリは\fIjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、\fIjavac\fRは、パッケージ名を反映したサブディレクトリ内にクラス・ファイルを格納し、必要に応じてディレクトリを作成します。 +クラス・ファイルの出力先ディレクトリを設定します。そのディレクトリは\fBjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、\fBjavac\fRは、パッケージ名を反映したサブディレクトリ内にクラス・ファイルを格納し、必要に応じてディレクトリを作成します。 .sp -\fI\-d\fR -\fI/home/myclasses\fRと指定し、クラスの名前が\fIcom\&.mypackage\&.MyClass\fRである場合、クラス・ファイルは\fI/home/myclasses/com/mypackage/MyClass\&.class\fRになります。 +\fB\-d\fR +\fB/home/myclasses\fRと指定し、クラスの名前が\fBcom\&.mypackage\&.MyClass\fRである場合、クラス・ファイルは\fB/home/myclasses/com/mypackage/MyClass\&.class\fRになります。 .sp -\fI\-d\fRオプションが指定されなかった場合、\fIjavac\fRは、各クラス・ファイルを、その生成元となるソース・ファイルと同じディレクトリ内に格納します。 +\fI\-d\fRオプションが指定されなかった場合、\fBjavac\fRは、各クラス・ファイルを、その生成元となるソース・ファイルと同じディレクトリ内に格納します。 .sp \fB注意:\fR \fI\-d\fRオプションによって指定されたディレクトリは、ユーザー・クラス・パスに自動的に追加されません。 @@ -184,12 +186,12 @@ .PP \-deprecation .RS 4 -非推奨のメンバーまたはクラスが使用またはオーバーライドされるたびに、説明を表示します。\fI\-deprecation\fRオプションが指定されていない場合、\fIjavac\fRは、非推奨のメンバーまたはクラスを使用またはオーバーライドしているソース・ファイルのサマリーを表示します。\fI\-deprecation\fRオプションは、\fI\-Xlint:deprecation\fRの省略表記です。 +非推奨のメンバーまたはクラスが使用またはオーバーライドされるたびに、説明を表示します。\fB\-deprecation\fRオプションが指定されていない場合、\fBjavac\fRは、非推奨のメンバーまたはクラスを使用またはオーバーライドしているソース・ファイルのサマリーを表示します。\fB\-deprecation\fRオプションは、\fB\-Xlint:deprecation\fRの省略表記です。 .RE .PP \-encoding \fIencoding\fR .RS 4 -ソース・ファイルのエンコーディング名(EUC\-JPやUTF\-8など)を設定します。\fI\-encoding\fRオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。 +ソース・ファイルのエンコーディング名(EUC\-JPやUTF\-8など)を設定します。\fB\-encoding\fRオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。 .RE .PP \-endorseddirs \fIdirectories\fR @@ -199,7 +201,7 @@ .PP \-extdirs \fIdirectories\fR .RS 4 -\fIext\fRディレクトリの位置をオーバーライドします。directories変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各JARファイルから、クラス・ファイルが検索されます。検出されたすべてのJARファイルは、クラス・パスの一部になります。 +\fBext\fRディレクトリの位置をオーバーライドします。directories変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各JARファイルから、クラス・ファイルが検索されます。検出されたすべてのJARファイルは、クラス・パスの一部になります。 .sp クロスコンパイル(異なるJavaプラットフォームに実装されたブートストラップ・クラスや拡張機能クラスに対してコンパイルを行う)を実行する場合、このオプションには拡張機能クラスを含むディレクトリを指定します。詳細はクロスコンパイル・オプションを参照してください。 .RE @@ -241,30 +243,30 @@ .PP \-implicit:[\fIclass, none\fR] .RS 4 -暗黙的にロードされたソース・ファイルに対するクラス・ファイルの生成を制御します。クラス・ファイルを自動生成するには、\fI\-implicit:class\fRを使用します。クラス・ファイルの生成を抑制するには、\fI\-implicit:none\fRを使用します。このオプションが指定されなかった場合のデフォルト動作は、クラス・ファイルの自動生成になります。その場合、そのようなクラス・ファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。\fI\-implicit\fRオプションが明示的に設定された場合、警告は発行されません。型の検索を参照してください。 +暗黙的にロードされたソース・ファイルに対するクラス・ファイルの生成を制御します。クラス・ファイルを自動生成するには、\fB\-implicit:class\fRを使用します。クラス・ファイルの生成を抑制するには、\fB\-implicit:none\fRを使用します。このオプションが指定されなかった場合のデフォルト動作は、クラス・ファイルの自動生成になります。その場合、そのようなクラス・ファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。\fB\-implicit\fRオプションが明示的に設定された場合、警告は発行されません。型の検索を参照してください。 .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシン(JVM)に\fIoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machine (JVM)に\fBoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .sp \fB注意:\fR -\fICLASSPATH\fR、\fI\-classpath\fR、\fI\-bootclasspath\fRおよび\fI\-extdirs\fRオプションは、\fIjavac\fRの実行に使用されるクラスを指定しません。これらのオプションおよび変数を使用してコンパイラの実装をカスタマイズしようとすると、リスクが高く、多くの場合、必要な処理が実行されません。コンパイラの実装をカスタマイズする必要がある場合、\fI\-J\fRオプションを使用して、基礎となるJava起動ツールにオプションを渡します。 +\fICLASSPATH\fR、\fB\-classpath\fR、\fB\-bootclasspath\fRおよび\fB\-extdirs\fRオプションは、\fBjavac\fRの実行に使用されるクラスを指定しません。これらのオプションおよび変数を使用してコンパイラの実装をカスタマイズしようとすると、リスクが高く、多くの場合、必要な処理が実行されません。コンパイラの実装をカスタマイズする必要がある場合、\fB\-J\fRオプションを使用して、基礎となるJava起動ツールにオプションを渡します。 .RE .PP \-nowarn .RS 4 -警告メッセージを無効にします。このオプションは、\fI\-Xlint:none\fRオプションと同じように動作します。 +警告メッセージを無効にします。このオプションは、\fB\-Xlint:none\fRオプションと同じように動作します。 .RE .PP \-parameters .RS 4 -リフレクションAPIのメソッド\fIjava\&.lang\&.reflect\&.Executable\&.getParameters\fRが取得できるように、生成されるクラス・ファイル内のコンストラクタとメソッドの仮パラメータ名を格納します。 +リフレクションAPIのメソッド\fBjava\&.lang\&.reflect\&.Executable\&.getParameters\fRが取得できるように、生成されるクラス・ファイル内のコンストラクタとメソッドの仮パラメータ名を格納します。 .RE .PP \-proc: [\fInone\fR, \fIonly\fR] .RS 4 -注釈処理およびコンパイルを実行するかを制御します。\fI\-proc:none\fRは、注釈処理なしでコンパイルが実行されることを意味します。\fI\-proc:only\fRは、注釈処理のみが実行され、後続のコンパイルはまったく実行されないことを意味します。 +注釈処理およびコンパイルを実行するかを制御します。\fB\-proc:none\fRは、注釈処理なしでコンパイルが実行されることを意味します。\fB\-proc:only\fRは、注釈処理のみが実行され、後続のコンパイルはまったく実行されないことを意味します。 .RE .PP \-processor \fIclass1\fR [,\fIclass2\fR,\fIclass3\fR\&.\&.\&.] @@ -279,14 +281,14 @@ .PP \-s \fIdir\fR .RS 4 -生成されたソース・ファイルの格納先となるディレクトリを指定します。そのディレクトリは\fIjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、コンパイラは、パッケージ名を反映したサブディレクトリ内にソース・ファイルを格納し、必要に応じてディレクトリを作成します。 +生成されたソース・ファイルの格納先となるディレクトリを指定します。そのディレクトリは\fBjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、コンパイラは、パッケージ名を反映したサブディレクトリ内にソース・ファイルを格納し、必要に応じてディレクトリを作成します。 .sp -\fI\-s /home/mysrc\fRと指定し、クラスの名前が\fIcom\&.mypackage\&.MyClass\fRである場合、ソース・ファイルは\fI/home/mysrc/com/mypackage/MyClass\&.java\fRに格納されます。 +\fB\-s /home/mysrc\fRと指定し、クラスの名前が\fBcom\&.mypackage\&.MyClass\fRである場合、ソース・ファイルは\fB/home/mysrc/com/mypackage/MyClass\&.java\fRに格納されます。 .RE .PP \-source \fIrelease\fR .RS 4 -受け付けるソース・コードのバージョンを指定します。\fIrelease\fRには次の値を指定できます。 +受け付けるソース・コードのバージョンを指定します。\fBrelease\fRには次の値を指定できます。 .PP 1\&.3 .RS 4 @@ -320,13 +322,23 @@ .PP 1\&.7 .RS 4 -これがデフォルト値です。Java SE 7で導入された機能を含むコードを受け付けます。 +Java SE 7で導入された機能を含むコードを受け付けます。 .RE .PP 7 .RS 4 1\&.7と同義です。 .RE +.PP +1\&.8 +.RS 4 +これがデフォルト値です。Java SE 8で導入された機能を含むコードを受け付けます。 +.RE +.PP +8 +.RS 4 +1\&.8と同義です。 +.RE .RE .PP \-sourcepath \fIsourcepath\fR @@ -358,13 +370,13 @@ .RE .SS "クロスコンパイル・オプション" .PP -デフォルトでは、クラスのコンパイルは、\fIjavac\fRが添付されているプラットフォームのブートストラップ・クラスおよび拡張機能クラスに対して行われます。ただし、\fIjavac\fRは、異なるJavaプラットフォームに実装されたブートストラップ・クラスおよび拡張機能クラスに対してコンパイルを行うクロスコンパイルもサポートしています。クロスコンパイルを行う場合は、\fI\-bootclasspath\fRおよび\fI\-extdirs\fRオプションを使用することが重要です。 +デフォルトでは、クラスのコンパイルは、\fBjavac\fRが添付されているプラットフォームのブートストラップ・クラスおよび拡張機能クラスに対して行われます。ただし、\fBjavac\fRは、異なるJavaプラットフォームに実装されたブートストラップ・クラスおよび拡張機能クラスに対してコンパイルを行うクロスコンパイルもサポートしています。クロスコンパイルを行う場合は、\fB\-bootclasspath\fRおよび\fB\-extdirs\fRオプションを使用することが重要です。 .PP \-target \fIversion\fR .RS 4 -仮想マシンの指定されたリリースを対象とするクラス・ファイルを生成します。クラス・ファイルは、指定されたターゲット以降のリリースでは動作しますが、それより前のリリースのJVMでは動作しません。有効なターゲットは、1\&.1、1\&.2、1\&.3、1\&.4、1\&.5 (5も可)、1\&.6 (6も可)および1\&.7 (7も可)です。 +仮想マシンの指定されたリリースを対象とするクラス・ファイルを生成します。クラス・ファイルは、指定されたターゲット以降のリリースでは動作しますが、それより前のリリースのJVMでは動作しません。有効なターゲットは、1\&.1、1\&.2、1\&.3、1\&.4、1\&.5 (5も可)、1\&.6 (6も可)、1\&.7 (7も可)および1\&.8 (8も可)です。 .sp -\fI\-target\fRオプションのデフォルトは、\fI\-source\fRオプションの値によって異なります。 +\fB\-target\fRオプションのデフォルトは、\fB\-source\fRオプションの値によって異なります。 .sp .RS 4 .ie n \{\ @@ -374,7 +386,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションが指定されていない場合、\fI\-target\fRオプションの値は1\&.7です。 +\fB\-source\fRオプションが指定されていない場合、\fB\-target\fRオプションの値は1\&.8です。 .RE .sp .RS 4 @@ -385,7 +397,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションが1\&.2の場合、\fI\-target\fRオプションの値は1\&.4です。 +\fB\-source\fRオプションが1\&.2の場合、\fB\-target\fRオプションの値は1\&.4です。 .RE .sp .RS 4 @@ -396,7 +408,18 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションが1\&.3の場合、\fI\-target\fRオプションの値は1\&.4です。 +\fB\-source\fRオプションが1\&.3の場合、\fB\-target\fRオプションの値は1\&.4です。 +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fB\-source\fRオプションが1\&.5の場合、\fB\-target\fRオプションの値は1\&.8です。 .RE .sp .RS 4 @@ -407,7 +430,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションが1\&.5の場合、\fI\-target\fRオプションの値は1\&.7です。 +\fB\-source\fRオプションが1\&.6の場合、\fB\-target\fRオプションの値は1\&.8です。 .RE .sp .RS 4 @@ -418,7 +441,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションが1\&.6の場合、\fI\-target\fRオプションの値は1\&.7です。 +\fB\-source\fRオプションが1\&.7の場合、\fB\-target\fRオプションの値は1\&.8です。 .RE .sp .RS 4 @@ -429,7 +452,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションの他のすべての値の場合、\fI\-target\fRオプションの値は、\fI\-source\fRオプションの値になります。 +\fB\-source\fRオプションの他のすべての値の場合、\fB\-target\fRオプションの値は、\fB\-source\fRオプションの値になります。 .RE .RE .PP @@ -439,9 +462,9 @@ .RE .SS "コンパクト・プロファイル・オプション" .PP -JDK 8以降から、\fIjavac\fRコンパイラはコンパクト・プロファイルをサポートします。コンパクト・プロファイルを使用すると、Javaプラットフォーム全体を必要としないアプリケーションは、デプロイ可能で、小さいフットプリントで実行できます。コンパクト・プロファイル機能は、アプリケーション・ストアからのアプリケーションのダウンロード時間を短縮するのに使用できます。この機能は、JREをバンドルするJavaアプリケーションの、よりコンパクトなデプロイメントに役立ちます。この機能は、小さいデバイスでも役立ちます。 +JDK 8以降から、\fBjavac\fRコンパイラはコンパクト・プロファイルをサポートします。コンパクト・プロファイルを使用すると、Javaプラットフォーム全体を必要としないアプリケーションは、デプロイ可能で、小さいフットプリントで実行できます。コンパクト・プロファイル機能は、アプリケーション・ストアからのアプリケーションのダウンロード時間を短縮するのに使用できます。この機能は、JREをバンドルするJavaアプリケーションの、よりコンパクトなデプロイメントに役立ちます。この機能は、小さいデバイスでも役立ちます。 .PP -サポートされているプロファイル値は、\fIcompact1\fR、\fIcompact2\fRおよび\fIcompact3\fRです。これらは、追加のレイヤーです。大きい番号の各コンパクト・プロファイルには、小さい番号の名前のプロファイル内のすべてのAPIが含まれます。 +サポートされているプロファイル値は、\fBcompact1\fR、\fBcompact2\fRおよび\fBcompact3\fRです。これらは、追加のレイヤーです。大きい番号の各コンパクト・プロファイルには、小さい番号の名前のプロファイル内のすべてのAPIが含まれます。 .PP \-profile .RS 4 @@ -451,7 +474,8 @@ .RS 4 .\} .nf -javac \-profile compact1 Hello\&.java +\fBjavac \-profile compact1 Hello\&.java\fR + .fi .if n \{\ .RE @@ -462,17 +486,18 @@ .RS 4 .\} .nf -cd jdk1\&.8\&.0/bin -\&./javac \-profile compact1 Paint\&.java -Paint\&.java:5: error: Applet is not available in profile \*(Aqcompact1\*(Aq -import java\&.applet\&.Applet; +\fBcd jdk1\&.8\&.0/bin\fR +\fB\&./javac \-profile compact1 Paint\&.java\fR +\fBPaint\&.java:5: error: Applet is not available in profile \*(Aqcompact1\*(Aq\fR +\fBimport java\&.applet\&.Applet;\fR + .fi .if n \{\ .RE .\} -この例では、\fIApplet\fRクラスを使用しないようにソースを変更することによって、エラーを修正できます。\-profileオプションを指定せずにコンパイルすることによって、エラーを修正することもできます。コンパイルは、Java SE APIの完全なセットに対して実行されます。(どのコンパクト・プロファイルにも、\fIApplet\fRクラスは含まれていません。) +この例では、\fBApplet\fRクラスを使用しないようにソースを変更することによって、エラーを修正できます。\-profileオプションを指定せずにコンパイルすることによって、エラーを修正することもできます。コンパイルは、Java SE APIの完全なセットに対して実行されます。(どのコンパクト・プロファイルにも、\fBApplet\fRクラスは含まれていません。) .sp -コンパクト・プロファイルを使用してコンパイルするための別の方法として、\fI\-bootclasspath\fRオプションを使用して、プロファイルのイメージを指定する\fIrt\&.jar\fRファイルへのパスを指定します。かわりに\fI\-profile\fRオプションを使用すると、プロファイル・イメージは、コンパイル時にシステム上に存在する必要がありません。これは、クロスコンパイル時に役立ちます。 +コンパクト・プロファイルを使用してコンパイルするための別の方法として、\fB\-bootclasspath\fRオプションを使用して、プロファイルのイメージを指定する\fBrt\&.jar\fRファイルへのパスを指定します。かわりに\fB\-profile\fRオプションを使用すると、プロファイル・イメージは、コンパイル時にシステム上に存在する必要がありません。これは、クロスコンパイル時に役立ちます。 .RE .SS "非標準オプション" .PP @@ -493,15 +518,16 @@ .PP \-Xdoclint:[\-]\fIgroup\fR [\fI/access\fR] .RS 4 -\fIgroup\fRの値が\fIaccessibility\fR、\fIsyntax\fR、\fIreference\fR、\fIhtml\fRまたは\fImissing\fRのいずれかである特定のチェック・グループを有効または無効にします。これらのチェック・グループの詳細は、\fIjavadoc\fRコマンドの\fI\-Xdoclint\fRオプションを参照してください。\fI\-Xdoclint\fRオプションは、\fIjavac\fRコマンドではデフォルトで無効になります。 +\fIgroup\fRの値が\fBaccessibility\fR、\fBsyntax\fR、\fBreference\fR、\fBhtml\fRまたは\fBmissing\fRのいずれかである特定のチェック・グループを有効または無効にします。これらのチェック・グループの詳細は、\fBjavadoc\fRコマンドの\fB\-Xdoclint\fRオプションを参照してください。\fB\-Xdoclint\fRオプションは、\fBjavac\fRコマンドではデフォルトで無効になります。 .sp -変数\fIaccess\fRは、\fI\-Xdoclint\fRオプションがチェックするクラスとメンバーの最小の可視性レベルを指定します。\fIpublic\fR、\fIprotected\fR、\fIpackage\fRおよび\fIprivate\fRの値(可視性の高い順)の1つを持つことができます。たとえば、次のオプションは、(protected、package、publicを含む) protected以上のアクセス・レベルを持つクラスおよびメンバーを(すべてのチェック・グループで)チェックします。 +変数\fIaccess\fRは、\fB\-Xdoclint\fRオプションがチェックするクラスとメンバーの最小の可視性レベルを指定します。\fBpublic\fR、\fBprotected\fR、\fBpackage\fRおよび\fBprivate\fRの値(可視性の高い順)の1つを持つことができます。たとえば、次のオプションは、(protected、package、publicを含む) protected以上のアクセス・レベルを持つクラスおよびメンバーを(すべてのチェック・グループで)チェックします。 .sp .if n \{\ .RS 4 .\} .nf -\-Xdoclint:all/protected +\fB\-Xdoclint:all/protected\fR + .fi .if n \{\ .RE @@ -512,7 +538,8 @@ .RS 4 .\} .nf -\-Xdoclint:all,\-html/package +\fB\-Xdoclint:all,\-html/package\fR + .fi .if n \{\ .RE @@ -551,7 +578,7 @@ .PP \-Xlint:\fI\-name\fR .RS 4 -警告名を無効にします。このオプションで無効にできる警告のリストを取得するには、\-Xlintオプションを使用した警告の有効化または無効化\-Xlint\fIオプションを使用した\fRを参照してください。 +警告名を無効にします。このオプションで無効にできる警告のリストを取得するには、\-Xlintオプションを使用した警告の有効化または無効化\-Xlint\fBオプションを使用した\fRを参照してください。 .RE .PP \-Xmaxerrs \fInumber\fR @@ -566,34 +593,34 @@ .PP \-Xstdout \fIfilename\fR .RS 4 -コンパイラのメッセージを、指定されたファイルに送信します。デフォルトでは、コンパイラのメッセージは\fISystem\&.err\fRに送られます。 +コンパイラのメッセージを、指定されたファイルに送信します。デフォルトでは、コンパイラのメッセージは\fBSystem\&.err\fRに送られます。 .RE .PP \-Xprefer:[\fInewer,source\fR] .RS 4 -ある型に対してソース・ファイルとクラス・ファイルの両方が見つかった場合、そのどちらのファイルを読み取るかを指定します。(型の検索を参照してください)。\fI\-Xprefer:newer\fRオプションを使用した場合、ある型に対するソース・ファイルとクラス・ファイルのうち新しい方が読み取られます(デフォルト)。\fI\-Xprefer:source\fRオプションを使用した場合、ソース・ファイルが読み取られます。\fISOURCE\fRの保存ポリシーを使用して宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\fI\-Xprefer:source\fRを使用してください。 +ある型に対してソース・ファイルとクラス・ファイルの両方が見つかった場合、そのどちらのファイルを読み取るかを指定します。(型の検索を参照してください)。\fB\-Xprefer:newer\fRオプションを使用した場合、ある型に対するソース・ファイルとクラス・ファイルのうち新しい方が読み取られます(デフォルト)。\fB\-Xprefer:source\fRオプションを使用した場合、ソース・ファイルが読み取られます。\fBSOURCE\fRの保存ポリシーを使用して宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\fB\-Xprefer:source\fRを使用してください。 .RE .PP \-Xpkginfo:[\fIalways\fR,\fIlegacy\fR,\fInonempty\fR] .RS 4 -javacがpackage\-info\&.javaファイルから\fIpackage\-info\&.class\fRファイルを生成するかどうかを制御します。このオプションで使用可能なmode引数は次のとおりです。 +javacがpackage\-info\&.javaファイルから\fBpackage\-info\&.class\fRファイルを生成するかどうかを制御します。このオプションで使用可能なmode引数は次のとおりです。 .PP always .RS 4 -すべての\fIpackage\-info\&.java\fRファイルの\fIpackage\-info\&.class\fRファイルを常に生成します。このオプションは、各\fI\&.java\fRファイルに対応する\fI\&.class\fRファイルがあることを確認するAntなどのビルド・システムを使用する場合に役立つことがあります。 +すべての\fBpackage\-info\&.java\fRファイルの\fBpackage\-info\&.class\fRファイルを常に生成します。このオプションは、各\fB\&.java\fRファイルに対応する\fB\&.class\fRファイルがあることを確認するAntなどのビルド・システムを使用する場合に役立つことがあります。 .RE .PP legacy .RS 4 -package\-info\&.javaに注釈が含まれる場合にのみ\fIpackage\-info\&.class\fRファイルを生成します。package\-info\&.javaにコメントのみ含まれる場合に\fIpackage\-info\&.class\fRファイルを生成しません。 +package\-info\&.javaに注釈が含まれる場合にのみ\fBpackage\-info\&.class\fRファイルを生成します。package\-info\&.javaにコメントのみ含まれる場合に\fBpackage\-info\&.class\fRファイルを生成しません。 .sp \fB注意:\fR -\fIpackage\-info\&.class\fRファイルは生成できますが、package\-info\&.javaファイル内のすべての注釈に\fIRetentionPolicy\&.SOURCE\fRがある場合は空になります。 +\fBpackage\-info\&.class\fRファイルは生成できますが、package\-info\&.javaファイル内のすべての注釈に\fBRetentionPolicy\&.SOURCE\fRがある場合は空になります。 .RE .PP nonempty .RS 4 -package\-info\&.javaに\fIRetentionPolicy\&.CLASS\fRまたは\fIRetentionPolicy\&.RUNTIME\fRとともに注釈が含まれる場合にのみ\fIpackage\-info\&.class\fRファイルを生成します。 +package\-info\&.javaに\fBRetentionPolicy\&.CLASS\fRまたは\fBRetentionPolicy\&.RUNTIME\fRとともに注釈が含まれる場合にのみ\fBpackage\-info\&.class\fRファイルを生成します。 .RE .RE .PP @@ -613,7 +640,7 @@ .RE .SH "-XLINTオプションを使用した警告の有効化または無効化" .PP -\fI\-Xlint:name\fRオプションを使用して警告\fIname\fRを有効にします。ここで、\fIname\fRは次の警告名のいずれかになります。\fI\-Xlint:\-name:\fRオプションを使用して、警告を無効化できます。 +\fB\-Xlint:name\fRオプションを使用して警告\fIname\fRを有効にします。ここで、\fBname\fRは次の警告名のいずれかになります。\fB\-Xlint:\-name:\fRオプションを使用して、警告を無効化できます。 .PP cast .RS 4 @@ -623,7 +650,8 @@ .RS 4 .\} .nf -String s = (String) "Hello!" +\fBString s = (String) "Hello!"\fR + .fi .if n \{\ .RE @@ -643,29 +671,31 @@ .RS 4 .\} .nf -java\&.util\&.Date myDate = new java\&.util\&.Date(); -int currentDay = myDate\&.getDay(); +\fBjava\&.util\&.Date myDate = new java\&.util\&.Date();\fR +\fBint currentDay = myDate\&.getDay();\fR + .fi .if n \{\ .RE .\} -メソッド\fIjava\&.util\&.Date\&.getDay\fRはJDK 1\&.1以降は非推奨になりました。 +メソッド\fBjava\&.util\&.Date\&.getDay\fRはJDK 1\&.1以降は非推奨になりました。 .RE .PP dep\-ann .RS 4 -\fI@deprecated\fR -Javadocコメントでドキュメント化されているが、\fI@Deprecated\fR注釈が付いていない項目について警告します。たとえば、次のようになります。 +\fB@deprecated\fR +Javadocコメントでドキュメント化されているが、\fB@Deprecated\fR注釈が付いていない項目について警告します。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -/** - * @deprecated As of Java SE 7, replaced by {@link #newMethod()} - */ -public static void deprecatedMethood() { } -public static void newMethod() { } +\fB/**\fR +\fB * @deprecated As of Java SE 7, replaced by {@link #newMethod()}\fR +\fB */\fR +\fBpublic static void deprecatedMethood() { }\fR +\fBpublic static void newMethod() { }\fR + .fi .if n \{\ .RE @@ -680,7 +710,8 @@ .RS 4 .\} .nf -int divideByZero = 42 / 0; +\fBint divideByZero = 42 / 0;\fR + .fi .if n \{\ .RE @@ -689,17 +720,18 @@ .PP empty .RS 4 -\fIif \fR文以降が空の文であることについて警告します。たとえば、次のようになります。 +\fBif \fR文以降が空の文であることについて警告します。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -class E { - void m() { - if (true) ; - } -} +\fBclass E {\fR +\fB void m() {\fR +\fB if (true) ;\fR +\fB }\fR +\fB}\fR + .fi .if n \{\ .RE @@ -714,48 +746,50 @@ .RS 4 .\} .nf -switch (x) { -case 1: - System\&.out\&.println("1"); - // No break statement here\&. -case 2: - System\&.out\&.println("2"); -} +\fBswitch (x) {\fR +\fBcase 1:\fR +\fB System\&.out\&.println("1");\fR +\fB // No break statement here\&.\fR +\fBcase 2:\fR +\fB System\&.out\&.println("2");\fR +\fB}\fR + .fi .if n \{\ .RE .\} -このコードのコンパイル時に\fI\-Xlint:fallthrough\fRオプションが使用されていた場合、コンパイラは、問題になっているケースの行番号とともに、caseにfall\-throughする可能性があることを示す警告を発行します。 +このコードのコンパイル時に\fB\-Xlint:fallthrough\fRオプションが使用されていた場合、コンパイラは、問題になっているケースの行番号とともに、caseにfall\-throughする可能性があることを示す警告を発行します。 .RE .PP finally .RS 4 -正常に完了できない\fIfinally\fR句について警告します。たとえば、次のようになります。 +正常に完了できない\fBfinally\fR句について警告します。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -public static int m() { - try { - throw new NullPointerException(); - } catch (NullPointerException(); { - System\&.err\&.println("Caught NullPointerException\&."); - return 1; - } finally { - return 0; - } - } +\fBpublic static int m() {\fR +\fB try {\fR +\fB throw new NullPointerException();\fR +\fB } catch (NullPointerException(); {\fR +\fB System\&.err\&.println("Caught NullPointerException\&.");\fR +\fB return 1;\fR +\fB } finally {\fR +\fB return 0;\fR +\fB }\fR +\fB }\fR + .fi .if n \{\ .RE .\} -この例では、コンパイラは\fIfinally\fRブロックに関する警告を生成します。\fIint\fRメソッドが呼び出されると、値0が返されます。\fIfinally\fRブロックは、\fItry\fRブロックが終了すると実行されます。この例では、制御が\fIcatch\fRブロックに移された場合、\fIint\fRメソッドは終了します。ただし、\fIfinally\fRブロックは実行される必要があるため、制御がメソッドの外部に移されていても、このブロックは実行されます。 +この例では、コンパイラは\fBfinally\fRブロックに関する警告を生成します。\fBint\fRメソッドが呼び出されると、値0が返されます。\fBfinally\fRブロックは、\fBtry\fRブロックが終了すると実行されます。この例では、制御が\fBcatch\fRブロックに移された場合、\fBint\fRメソッドは終了します。ただし、\fBfinally\fRブロックは実行される必要があるため、制御がメソッドの外部に移されていても、このブロックは実行されます。 .RE .PP options .RS 4 -コマンドライン・オプションの使用に関する問題について警告します。クロスコンパイル・オプションを参照してください。 +コマンド行オプションの使用に関する問題について警告します。クロスコンパイル・オプションを参照してください。 .RE .PP overrides @@ -766,14 +800,15 @@ .RS 4 .\} .nf -public class ClassWithVarargsMethod { - void varargsMethod(String\&.\&.\&. s) { } -} - -public class ClassWithOverridingMethod extends ClassWithVarargsMethod { - @Override - void varargsMethod(String[] s) { } -} +\fBpublic class ClassWithVarargsMethod {\fR +\fB void varargsMethod(String\&.\&.\&. s) { }\fR +\fB}\fR + +\fBpublic class ClassWithOverridingMethod extends ClassWithVarargsMethod {\fR +\fB @Override\fR +\fB void varargsMethod(String[] s) { }\fR +\fB}\fR + .fi .if n \{\ .RE @@ -784,25 +819,27 @@ .RS 4 .\} .nf -warning: [override] varargsMethod(String[]) in ClassWithOverridingMethod -overrides varargsMethod(String\&.\&.\&.) in ClassWithVarargsMethod; overriding -method is missing \*(Aq\&.\&.\&.\*(Aq +\fBwarning: [override] varargsMethod(String[]) in ClassWithOverridingMethod \fR +\fBoverrides varargsMethod(String\&.\&.\&.) in ClassWithVarargsMethod; overriding\fR +\fBmethod is missing \*(Aq\&.\&.\&.\*(Aq\fR + .fi .if n \{\ .RE .\} -コンパイラは、\fIvarargs\fRメソッドを検出すると、\fIvarargs\fRの仮パラメータを配列に変換します。メソッド\fIClassWithVarargsMethod\&.varargsMethod\fRでは、コンパイラは\fIvarargs\fRの仮パラメータ\fIString\&.\&.\&. s\fRを仮パラメータ\fIString[] s\fRに変換します。これは、メソッド\fIClassWithOverridingMethod\&.varargsMethod\fRの仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。 +コンパイラは、\fBvarargs\fRメソッドを検出すると、\fBvarargs\fRの仮パラメータを配列に変換します。メソッド\fBClassWithVarargsMethod\&.varargsMethod\fRでは、コンパイラは\fBvarargs\fRの仮パラメータ\fBString\&.\&.\&. s\fRを仮パラメータ\fBString[] s\fRに変換します。これは、メソッド\fBClassWithOverridingMethod\&.varargsMethod\fRの仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。 .RE .PP path .RS 4 -コマンドラインでの無効なパス要素と存在しないパス・ディレクトリについて警告します(クラス・パス、ソース・パスなどのパス関連)。このような警告を\fI@SuppressWarnings\fR注釈で抑制することはできません。たとえば、次のようになります。 +コマンド行での無効なパス要素と存在しないパス・ディレクトリについて警告します(クラス・パス、ソース・パスなどのパス関連)。このような警告を\fB@SuppressWarnings\fR注釈で抑制することはできません。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -javac \-Xlint:path \-classpath /nonexistentpath Example\&.java +\fBjavac \-Xlint:path \-classpath /nonexistentpath Example\&.java\fR + .fi .if n \{\ .RE @@ -819,21 +856,22 @@ .RS 4 .\} .nf -import java\&.util\&.*; -import javax\&.annotation\&.processing\&.*; -import javax\&.lang\&.model\&.*; -import\&.javaz\&.lang\&.model\&.element\&.*; - -@SupportedAnnotationTypes("NotAnno") -public class AnnoProc extends AbstractProcessor { - public boolean process(Set<? extends TypeElement> elems, RoundEnvironment renv){ - return true; - } - - public SourceVersion getSupportedSourceVersion() { - return SourceVersion\&.latest(); - } -} +\fBimport java\&.util\&.*;\fR +\fBimport javax\&.annotation\&.processing\&.*;\fR +\fBimport javax\&.lang\&.model\&.*;\fR +\fBimport\&.javaz\&.lang\&.model\&.element\&.*;\fR + +\fB@SupportedAnnotationTypes("NotAnno")\fR +\fBpublic class AnnoProc extends AbstractProcessor {\fR +\fB public boolean process(Set<? extends TypeElement> elems, RoundEnvironment renv){\fR +\fB return true;\fR +\fB }\fR + +\fB public SourceVersion getSupportedSourceVersion() {\fR +\fB return SourceVersion\&.latest();\fR +\fB }\fR +\fB}\fR + .fi .if n \{\ .RE @@ -844,88 +882,93 @@ .RS 4 .\} .nf -@interface Anno { } +\fB@interface Anno { }\fR +\fB \fR +\fB@Anno\fR +\fBclass AnnosWithoutProcessors { }\fR -@Anno -class AnnosWithoutProcessors { } .fi .if n \{\ .RE .\} -次のコマンドは、注釈プロセッサ\fIAnnoProc\fRをコンパイルし、この注釈プロセッサをソース・ファイル\fIAnnosWithoutProcessors\&.java\fRに対して実行します。 +次のコマンドは、注釈プロセッサ\fBAnnoProc\fRをコンパイルし、この注釈プロセッサをソース・ファイル\fBAnnosWithoutProcessors\&.java\fRに対して実行します。 .sp .if n \{\ .RS 4 .\} .nf -javac AnnoProc\&.java -javac \-cp \&. \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors\&.java -.fi -.if n \{\ -.RE -.\} -コンパイラがソース・ファイル\fIAnnosWithoutProcessors\&.java\fRに対して注釈プロセッサを実行すると、次の警告が生成されます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -warning: [processing] No processor claimed any of these annotations: Anno +\fBjavac AnnoProc\&.java\fR +\fBjavac \-cp \&. \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors\&.java\fR .fi .if n \{\ .RE .\} -この問題を解決するために、クラス\fIAnnosWithoutProcessors\fRで定義および使用される注釈の名前を、\fIAnno\fRから\fINotAnno\fRに変更できます。 -.RE -.PP -rawtypes -.RS 4 -raw型に対する未検査操作について警告します。次の文では、\fIrawtypes\fR警告が生成されます。 +コンパイラがソース・ファイル\fBAnnosWithoutProcessors\&.java\fRに対して注釈プロセッサを実行すると、次の警告が生成されます。 .sp .if n \{\ .RS 4 .\} .nf -void countElements(List l) { \&.\&.\&. } +\fBwarning: [processing] No processor claimed any of these annotations: Anno\fR +\fB \fR .fi .if n \{\ .RE .\} -次の例では、\fIrawtypes\fR警告は生成されません。 +この問題を解決するために、クラス\fBAnnosWithoutProcessors\fRで定義および使用される注釈の名前を、\fBAnno\fRから\fBNotAnno\fRに変更できます。 +.RE +.PP +rawtypes +.RS 4 +raw型に対する未検査操作について警告します。次の文では、\fBrawtypes\fR警告が生成されます。 .sp .if n \{\ .RS 4 .\} .nf -void countElements(List<?> l) { \&.\&.\&. } +\fBvoid countElements(List l) { \&.\&.\&. }\fR + .fi .if n \{\ .RE .\} -\fIList\fRはraw型です。ただし、\fIList<?>\fRは、アンバウンド形式のワイルドカードのパラメータ化された型です。\fIList\fRはパラメータ化されたインタフェースであるため、常にその型引数を指定します。この例では、\fIList\fRの仮引数はアンバウンド形式のワイルドカード(\fI?\fR)を使用してその仮型パラメータとして指定されます。つまり、\fIcountElements\fRメソッドは\fIList\fRインタフェースのどのインスタンス化も受け付けることができます。 -.RE -.PP -Serial -.RS 4 -直列化可能クラスに\fIserialVersionUID\fR定義がないことを警告します。たとえば、次のようになります。 +次の例では、\fBrawtypes\fR警告は生成されません。 .sp .if n \{\ .RS 4 .\} .nf -public class PersistentTime implements Serializable -{ - private Date time; +\fBvoid countElements(List<?> l) { \&.\&.\&. }\fR - public PersistentTime() { - time = Calendar\&.getInstance()\&.getTime(); - } +.fi +.if n \{\ +.RE +.\} +\fBList\fRはraw型です。ただし、\fBList<?>\fRは、アンバウンド形式のワイルドカードのパラメータ化された型です。\fBList\fRはパラメータ化されたインタフェースであるため、常にその型引数を指定します。この例では、\fBList\fRの仮引数はアンバウンド形式のワイルドカード(\fB?\fR)を使用してその仮型パラメータとして指定されます。つまり、\fBcountElements\fRメソッドは\fBList\fRインタフェースのどのインスタンス化も受け付けることができます。 +.RE +.PP +Serial +.RS 4 +直列化可能クラスに\fBserialVersionUID\fR定義がないことを警告します。たとえば、次のようになります。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBpublic class PersistentTime implements Serializable\fR +\fB{\fR +\fB private Date time;\fR +\fB \fR +\fB public PersistentTime() {\fR +\fB time = Calendar\&.getInstance()\&.getTime();\fR +\fB }\fR +\fB \fR +\fB public Date getTime() {\fR +\fB return time;\fR +\fB }\fR +\fB}\fR - public Date getTime() { - return time; - } -} .fi .if n \{\ .RE @@ -936,13 +979,14 @@ .RS 4 .\} .nf -warning: [serial] serializable class PersistentTime has no definition of -serialVersionUID +\fBwarning: [serial] serializable class PersistentTime has no definition of\fR +\fBserialVersionUID\fR + .fi .if n \{\ .RE .\} -直列化可能クラスが\fIserialVersionUID\fRという名前のフィールドを明示的に宣言しない場合、直列化ランタイム環境では、「Javaオブジェクト直列化仕様」で説明されているように、クラスの様々な側面に基づいて、クラスの\fIserialVersionUID\fRのデフォルト値を計算します。ただし、すべての直列化可能クラスが\fIserialVersionUID\fR値を明示的に宣言することを強くお薦めします。 これは、\fIserialVersionUID\fR値を計算するデフォルトのプロセスが、コンパイラの実装によって異なる可能性のあるクラスの詳細にきわめて影響を受けやすく、その結果、直列化復元中に予期しない\fIInvalidClassExceptions\fRが発生する可能性があるためです。Javaコンパイラの実装が異なっても\fIserialVersionUID\fR値の一貫性を確保にするには、直列化可能クラスが\fIserialVersionUID\fR値を明示的に宣言する必要があります。 +直列化可能クラスが\fBserialVersionUID\fRという名前のフィールドを明示的に宣言しない場合、直列化ランタイム環境では、「Javaオブジェクト直列化仕様」で説明されているように、クラスの様々な側面に基づいて、クラスの\fBserialVersionUID\fRのデフォルト値を計算します。ただし、すべての直列化可能クラスが\fBserialVersionUID\fR値を明示的に宣言することを強くお薦めします。 これは、\fBserialVersionUID\fR値を計算するデフォルトのプロセスが、コンパイラの実装によって異なる可能性のあるクラスの詳細にきわめて影響を受けやすく、その結果、直列化復元中に予期しない\fBInvalidClassExceptions\fRが発生する可能性があるためです。Javaコンパイラの実装が異なっても\fBserialVersionUID\fR値の一貫性を確保にするには、直列化可能クラスが\fBserialVersionUID\fR値を明示的に宣言する必要があります。 .RE .PP static @@ -953,10 +997,11 @@ .RS 4 .\} .nf -class XLintStatic { - static void m1() { } - void m2() { this\&.m1(); } -} +\fBclass XLintStatic {\fR +\fB static void m1() { }\fR +\fB void m2() { this\&.m1(); }\fR +\fB}\fR + .fi .if n \{\ .RE @@ -967,35 +1012,38 @@ .RS 4 .\} .nf -warning: [static] static method should be qualified by type name, -XLintStatic, instead of by an expression +\fBwarning: [static] static method should be qualified by type name, \fR +\fBXLintStatic, instead of by an expression\fR + .fi .if n \{\ .RE .\} -この問題を解決するために、次のように\fIstatic\fRメソッド\fIm1\fRを呼び出すことができます。 +この問題を解決するために、次のように\fBstatic\fRメソッド\fBm1\fRを呼び出すことができます。 .sp .if n \{\ .RS 4 .\} .nf -XLintStatic\&.m1(); +\fBXLintStatic\&.m1();\fR + .fi .if n \{\ .RE .\} -あるいは、\fIstatic\fRキーワードをメソッド\fIm1\fRの宣言から削除することもできます。 +あるいは、\fBstatic\fRキーワードをメソッド\fBm1\fRの宣言から削除することもできます。 .RE .PP try .RS 4 -try\-with\-resources文を含む、\fItry\fRブロックの使用に関する問題について警告します。たとえば、\fItry\fRブロックで宣言されたリソース\fIac\fRが使用されないために、次の文に対して警告が生成されます。 +try\-with\-resources文を含む、\fBtry\fRブロックの使用に関する問題について警告します。たとえば、\fBtry\fRブロックで宣言されたリソース\fBac\fRが使用されないために、次の文に対して警告が生成されます。 .sp .if n \{\ .RS 4 .\} .nf -try ( AutoCloseable ac = getResource() ) { // do nothing} +\fBtry ( AutoCloseable ac = getResource() ) { // do nothing}\fR + .fi .if n \{\ .RE @@ -1010,37 +1058,39 @@ .RS 4 .\} .nf -List l = new ArrayList<Number>(); -List<String> ls = l; // unchecked warning +\fBList l = new ArrayList<Number>();\fR +\fBList<String> ls = l; // unchecked warning\fR + .fi .if n \{\ .RE .\} -型の消去中に、型\fIArrayList<Number>\fRおよび\fIList<String>\fRは、それぞれ\fIArrayList\fRおよび\fIList\fRになります。 +型の削除中、型\fBArrayList<Number>\fRおよび\fBList<String>\fRは、それぞれ\fBArrayList\fRおよび\fBList\fRになります。 .sp -\fIls\fRコマンドには、パラメータ化された型\fIList<String>\fRが指定されています。\fIl\fRによって参照される\fIList\fRが\fIls\fRに割り当てられた場合、コンパイラは未検査警告を生成します。コンパイル時に、コンパイラおよびJVMは、\fIl\fRが\fIList<String>\fR型を参照するかどうかを判別できません。この場合、\fIl\fRは、\fIList<String>\fR型を参照しません。その結果、ヒープ汚染が発生します。 +\fBls\fRコマンドには、パラメータ化された型\fBList<String>\fRが指定されています。\fBl\fRによって参照される\fBList\fRが\fBls\fRに割り当てられた場合、コンパイラは未検査警告を生成します。コンパイル時に、コンパイラおよびJVMは、\fBl\fRが\fBList<String>\fR型を参照するかどうかを判別できません。この場合、\fBl\fRは、\fBList<String>\fR型を参照しません。その結果、ヒープ汚染が発生します。 .sp -ヒープ汚染状態が発生するのは、\fIList\fRオブジェクト\fIl\fR -(そのstatic型は\fIList<Number>\fR)が別の\fIList\fRオブジェクト\fIls\fR -(異なるstatic型\fIList<String>\fRを持つ)に代入される場合です。しかし、コンパイラではこの代入をいまだに許可しています。総称をサポートしないJava SEのリリースとの下位互換性を確保するために、この代入を許可する必要があります。型消去により、\fIList<Number>\fRおよび\fIList<String>\fRは、両方とも\fIList\fRになります。その結果、コンパイラはオブジェクト\fIl\fR -(\fIList\fRというraw型を持つ)をオブジェクト\fIls\fRに代入することを許可します。 +ヒープ汚染状態が発生するのは、\fBList\fRオブジェクト\fBl\fR +(そのstatic型は\fBList<Number>\fR)が別の\fBList\fRオブジェクト\fBls\fR +(異なるstatic型\fBList<String>\fRを持つ)に代入される場合です。しかし、コンパイラではこの代入をいまだに許可しています。総称をサポートしないJava SEのリリースとの後方互換性を確保するために、この代入を許可する必要があります。型の削除のため、\fBList<Number>\fRおよび\fBList<String>\fRは、両方\fBList\fRになります。その結果、コンパイラはオブジェクト\fBl\fR +(\fBList\fRというraw型を持つ)をオブジェクト\fBls\fRに代入することを許可します。 .RE .PP varargs .RS 4 -可変引数(\fIvarargs\fR)メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。たとえば、次のようになります。 +可変引数(\fBvarargs\fR)メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -public class ArrayBuilder { - public static <T> void addToList (List<T> listArg, T\&.\&.\&. elements) { - for (T x : elements) { - listArg\&.add(x); - } - } -} +\fBpublic class ArrayBuilder {\fR +\fB public static <T> void addToList (List<T> listArg, T\&.\&.\&. elements) {\fR +\fB for (T x : elements) {\fR +\fB listArg\&.add(x);\fR +\fB }\fR +\fB }\fR +\fB}\fR + .fi .if n \{\ .RE @@ -1048,38 +1098,42 @@ \fB注意:\fR 非具象化可能型は、型情報が実行時に完全に使用不可能な型です。 .sp -コンパイラは、メソッド\fIArrayBuilder\&.addToList\fRの定義に関する次の警告を生成します。 +コンパイラは、メソッド\fBArrayBuilder\&.addToList\fRの定義に関する次の警告を生成します。 .sp .if n \{\ .RS 4 .\} .nf -warning: [varargs] Possible heap pollution from parameterized vararg type T +\fBwarning: [varargs] Possible heap pollution from parameterized vararg type T\fR + .fi .if n \{\ .RE .\} -コンパイラは、varargsメソッドを検出すると、\fIvarargs\fRの仮パラメータを配列に変換します。しかし、Javaプログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド\fIArrayBuilder\&.addToList\fRでは、コンパイラは\fIvarargs\fRの仮パラメータ\fIT\&.\&.\&.\fR要素を仮パラメータ\fIT[]\fR要素(配列)に変換します。しかし、型消去により、コンパイラは\fIvarargs\fRの仮パラメータを\fIObject[]\fR要素に変換します。その結果、ヒープ汚染が発生する可能性があります。 +コンパイラは、varargsメソッドを検出すると、\fBvarargs\fRの仮パラメータを配列に変換します。しかし、Javaプログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド\fBArrayBuilder\&.addToList\fRでは、コンパイラは\fBvarargs\fRの仮パラメータ\fBT\&.\&.\&.\fR要素を仮パラメータ\fBT[]\fR要素(配列)に変換します。しかし、型消去により、コンパイラは\fBvarargs\fRの仮パラメータを\fBObject[]\fR要素に変換します。その結果、ヒープ汚染が発生する可能性があります。 .RE -.SH "コマンドライン引数ファイル" +.SH "コマンド行引数ファイル" .PP -\fIjavac\fRコマンドを短くしたり簡潔にしたりするために、\fIjavac\fRコマンドに対する引数(\fI\-J\fRオプションを除く)を含む1つ以上のファイルを指定することができます。これにより、どのオペレーティング・システム上でも、任意の長さの\fIjavac\fRコマンドを作成できます。 +\fBjavac\fRコマンドを短くしたり簡潔にしたりするために、\fBjavac\fRコマンドに対する引数(\fB\-J\fRオプションを除く)を含む1つ以上のファイルを指定することができます。これにより、どのオペレーティング・システム上でも、任意の長さの\fBjavac\fRコマンドを作成できます。 .PP -引数ファイルには、\fIjavac\fRのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の引数は、空白または改行文字で区切ることができます。ファイル名に埋め込まれた空白がある場合、ファイル名全体を二重引用符で囲みます。 +引数ファイルには、\fBjavac\fRのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の引数は、空白または改行文字で区切ることができます。ファイル名に埋め込まれた空白がある場合、ファイル名全体を二重引用符で囲みます。 .PP -引数ファイル内のファイル名は、引数ファイルの位置ではなく、現在のディレクトリに相対的となります。これらのリストでは、ワイルドカード(*)は使用できません(たとえば、\fI*\&.java\fRとは指定できません)。アットマーク(@)を使用したファイルの再帰的な解釈はサポートされていません。また、\fI\-J\fRオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 +引数ファイル内のファイル名は、引数ファイルの位置ではなく、現在のディレクトリに相対的となります。これらのリストでは、ワイルドカード(*)は使用できません(たとえば、\fB*\&.java\fRとは指定できません)。アットマーク(@)を使用したファイルの再帰的な解釈はサポートされていません。また、\fB\-J\fRオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 .PP -\fIjavac\fRコマンドを実行するときに、各引数ファイルのパスと名前の先頭にアットマーク(@)文字を付けて渡します。\fIjavac\fRコマンドは、アットマーク(@)で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 +\fBjavac\fRコマンドを実行するときに、各引数ファイルのパスと名前の先頭にアットマーク(@)文字を付けて渡します。\fBjavac\fRコマンドは、アットマーク(@)で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 .PP -\fBExample 1\fR, 単一の引数ファイル +\fB例 1\fR +.br +単一の引数ファイル .RS 4 -\fIargfile\fRという名前の単一の引数ファイルを使用して、すべての\fIjavac\fR引数を格納する場合は、次のように指定します。 +\fBargfile\fRという名前の単一の引数ファイルを使用して、すべての\fBjavac\fR引数を格納する場合は、次のように指定します。 .sp .if n \{\ .RS 4 .\} .nf -javac @argfile +\fBjavac @argfile\fR + .fi .if n \{\ .RE @@ -1087,9 +1141,11 @@ この引数ファイルには、例2で示されている両方のファイルの内容を入れることができます。 .RE .PP -\fBExample 2\fR, 2つの引数ファイル +\fB例 2\fR +.br +2つの引数ファイル .RS 4 -\fIjavac\fRオプション用とソース・ファイル名用に、2つの引数ファイルを作成できます。次のリストには、行の継続文字はありません。 +\fBjavac\fRオプション用とソース・ファイル名用に、2つの引数ファイルを作成できます。次のリストには、行の継続文字はありません。 .sp 次を含むoptionsという名前のファイルを作成します。 .sp @@ -1097,9 +1153,7 @@ .RS 4 .\} .nf -\-d classes -\-g -\-sourcepath /java/pubs/ws/1\&.3/src/share/classes +\fB\-d classes\fR .fi .if n \{\ .RE @@ -1109,6 +1163,27 @@ .RS 4 .\} .nf +\fB\-g\fR +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-sourcepath /java/pubs/ws/1\&.3/src/share/classes\fR +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf + .fi .if n \{\ .RE @@ -1119,35 +1194,40 @@ .RS 4 .\} .nf -MyClass1\&.java -MyClass2\&.java -MyClass3\&.java +\fBMyClass1\&.java\fR +\fBMyClass2\&.java\fR +\fBMyClass3\&.java\fR + .fi .if n \{\ .RE .\} -それから、次のように\fIjavac\fRコマンドを実行します。 +それから、次のように\fBjavac\fRコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -javac @options @classes +\fBjavac @options @classes\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, パスを使用した引数ファイル +\fB例 3\fR +.br +パスを使用した引数ファイル .RS 4 -引数ファイルはパスを指定できますが、ファイル内のすべてのファイル名は、(\fIpath1\fRや\fIpath2\fRではなく)次のように現在の作業ディレクトリに相対的となります。 +引数ファイルはパスを指定できますが、ファイル内のすべてのファイル名は、(\fBpath1\fRや\fBpath2\fRではなく)次のように現在の作業ディレクトリに相対的となります。 .sp .if n \{\ .RS 4 .\} .nf -javac @path1/options @path2/classes +\fBjavac @path1/options @path2/classes\fR + .fi .if n \{\ .RE @@ -1155,106 +1235,110 @@ .RE .SH "注釈処理" .PP -\fIjavac\fRコマンドが注釈処理を直接サポートしているため、独立した注釈処理コマンドである\fIapt\fRを使用する必要がなくなりました。 +\fBjavac\fRコマンドが注釈処理を直接サポートしているため、独立した注釈処理コマンドである\fBapt\fRを使用する必要がなくなりました。 .PP -注釈プロセッサのAPIは、\fIjavax\&.annotation\&.processing\fRおよび\fIjavax\&.lang\&.model\fRパッケージとそのサブパッケージ内に定義されています。 +注釈プロセッサのAPIは、\fBjavax\&.annotation\&.processing\fRおよび\fBjavax\&.lang\&.model\fRパッケージとそのサブパッケージ内に定義されています。 .SS "注釈処理を行う方法" .PP -\fI\-proc:none\fRオプションによって注釈処理が無効化されない限り、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは、\fI\-processorpath\fRオプションを使用して指定できます。パスを指定しない場合、ユーザー・クラス・パスが使用されます。プロセッサの検索は、検索パス上の\fIMETA\-INF/services/javax\&.annotation\&.processing\fR\&.Processorという名前のサービス・プロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1行に1つずつ含めてください。また、別の方法として、\fI\-processor\fRオプションを使用してプロセッサを明示的に指定することもできます。 +\fB\-proc:none\fRオプションによって注釈処理が無効化されない限り、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは、\fB\-processorpath\fRオプションを使用して指定できます。パスを指定しない場合、ユーザー・クラス・パスが使用されます。プロセッサの検索は、検索パス上の\fBMETA\-INF/services/javax\&.annotation\&.processing\fR\&.Processorという名前のサービス・プロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1行に1つずつ含めてください。また、別の方法として、\fB\-processor\fRオプションを使用してプロセッサを明示的に指定することもできます。 .PP -コンパイラは、コマンドラインのソース・ファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問合せを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を要求できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されると、コンパイラはそれ以上プロセッサの検索を行いません。 +コンパイラは、コマンド行のソース・ファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問合せを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を要求できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されると、コンパイラはそれ以上プロセッサの検索を行いません。 .PP いずれかのプロセッサによって新しいソース・ファイルが生成されると、注釈処理の2回目のラウンドが開始されます。新しく生成されたすべてのソース・ファイルがスキャンされ、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソース・ファイルが生成されなくなるまで続きます。 .PP -あるラウンドで新しいソース・ファイルが生成されなかった場合、注釈プロセッサがあと1回のみ呼び出され、残りの処理を実行する機会が与えられます。最後に、\fI\-proc:only\fRオプションが使用されないかぎり、コンパイラは、元のソース・ファイルと生成されたすべてのソース・ファイルをコンパイルします。 +あるラウンドで新しいソース・ファイルが生成されなかった場合、注釈プロセッサがあと1回のみ呼び出され、残りの処理を実行する機会が与えられます。最後に、\fB\-proc:only\fRオプションが使用されないかぎり、コンパイラは、元のソース・ファイルと生成されたすべてのソース・ファイルをコンパイルします。 .SS "暗黙的にロードされたソース・ファイル" .PP -コンパイラは、一連のソース・ファイルをコンパイルする際に、別のソース・ファイルを暗黙的にロードすることが必要な場合があります。型の検索を参照してください。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされた任意のソース・ファイルがコンパイルされた場合、コンパイラは警告を発行します。\fI\-implicit\fRオプションでは、警告を抑制する方法が提供されます。 +コンパイラは、一連のソース・ファイルをコンパイルする際に、別のソース・ファイルを暗黙的にロードすることが必要な場合があります。型の検索を参照してください。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされた任意のソース・ファイルがコンパイルされた場合、コンパイラは警告を発行します。\fB\-implicit\fRオプションでは、警告を抑制する方法が提供されます。 .SH "型の検索" .PP -ソース・ファイルをコンパイルするために、コンパイラは通常、型に関する情報を必要としますが、その型の定義はコマンドラインで指定したソース・ファイルにありません。コンパイラは、ソース・ファイルで使用されているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソース・ファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。 +ソース・ファイルをコンパイルするために、コンパイラは通常、型に関する情報を必要としますが、その型の定義はコマンド行で指定したソース・ファイルにありません。コンパイラは、ソース・ファイルで使用されているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソース・ファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。 .PP -たとえば、サブクラス\fIjava\&.applet\&.Applet\fRを作成すると、\fIアプレット\fRの祖先のクラス(\fIjava\&.awt\&.Panel\fR、\fIjava\&.awt\&.Container\fR、\fIjava\&.awt\&.Component\fRおよび\fIjava\&.lang\&.Object\fR)を使用していることにもなります。 +たとえば、サブクラス\fBjava\&.applet\&.Applet\fRを作成すると、\fBアプレット\fRの祖先のクラス(\fBjava\&.awt\&.Panel\fR、\fBjava\&.awt\&.Container\fR、\fBjava\&.awt\&.Component\fRおよび\fBjava\&.lang\&.Object\fR)を使用していることにもなります。 .PP -コンパイラは、型の情報が必要になると、その型を定義しているソース・ファイルまたはクラス・ファイルを検索します。まず、ブートストラップ・クラスと拡張機能クラスを検索し、続いてユーザー・クラス・パス(デフォルトでは現在のディレクトリ)を検索します。ユーザー・クラス・パスは、\fICLASSPATH\fR環境変数を設定して定義するか、または\fI\-classpath\fRオプションを使用して定義します。 +コンパイラは、型の情報が必要になると、その型を定義しているソース・ファイルまたはクラス・ファイルを検索します。まず、ブートストラップ・クラスと拡張機能クラスを検索し、続いてユーザー・クラス・パス(デフォルトでは現在のディレクトリ)を検索します。ユーザー・クラス・パスは、\fBCLASSPATH\fR環境変数を設定して定義するか、または\fB\-classpath\fRオプションを使用して定義します。 .PP -\fI\-sourcepath\fRオプションが設定されている場合、コンパイラは、指定されたパスからソース・ファイルを検索します。それ以外の場合、コンパイラは、ユーザー・クラス・パスからクラス・ファイルとソース・ファイルの両方を検索します。 +\fB\-sourcepath\fRオプションが設定されている場合、コンパイラは、指定されたパスからソース・ファイルを検索します。それ以外の場合、コンパイラは、ユーザー・クラス・パスからクラス・ファイルとソース・ファイルの両方を検索します。 .PP -\fI\-bootclasspath\fRオプションおよび\fI\-extdirs\fRオプションを使用して、別のブートストラップ・クラスや拡張機能クラスを指定できます。クロスコンパイル・オプションを参照してください。 +\fB\-bootclasspath\fRオプションおよび\fB\-extdirs\fRオプションを使用して、別のブートストラップ・クラスや拡張機能クラスを指定できます。クロスコンパイル・オプションを参照してください。 .PP -型の検索に成功したときに得られる結果は、クラス・ファイル、ソース・ファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用するかを\fI\-Xprefer\fRオプションでコンパイラに指示できます。\fInewer\fRが指定された場合、コンパイラは2つのファイルのうち新しい方を使用します。\fIsource\fRが指定された場合、コンパイラはソース・ファイルを使用します。デフォルトは\fInewer\fRです。 +型の検索に成功したときに得られる結果は、クラス・ファイル、ソース・ファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用するかを\fB\-Xprefer\fRオプションでコンパイラに指示できます。\fBnewer\fRが指定された場合、コンパイラは2つのファイルのうち新しい方を使用します。\fBsource\fRが指定された場合、コンパイラはソース・ファイルを使用します。デフォルトは\fBnewer\fRです。 .PP -型の検索自体によって、または\fI\-Xprefer\fRオプションが設定された結果として必要な型のソース・ファイルが見つかった場合、コンパイラはそのソース・ファイルを読み取り、必要な情報を取得します。デフォルトでは、コンパイラはソース・ファイルのコンパイルも行います。\fI\-implicit\fRオプションを使用してその動作を指定できます。\fInone\fRが指定された場合、ソース・ファイルに対してクラス・ファイルは生成されません。\fIclass\fRが指定された場合、ソース・ファイルに対してクラス・ファイルが生成されます。 +型の検索自体によって、または\fB\-Xprefer\fRオプションが設定された結果として必要な型のソース・ファイルが見つかった場合、コンパイラはそのソース・ファイルを読み取り、必要な情報を取得します。デフォルトでは、コンパイラはソース・ファイルのコンパイルも行います。\fB\-implicit\fRオプションを使用してその動作を指定できます。\fBnone\fRが指定された場合、ソース・ファイルに対してクラス・ファイルは生成されません。\fBclass\fRが指定された場合、ソース・ファイルに対してクラス・ファイルが生成されます。 .PP -コンパイラは、注釈処理が完了するまで、ある型情報の必要性を認識しない場合があります。型情報がソース・ファイル内に見つかり、かつ\fI\-implicit\fRオプションが指定されていない場合、コンパイラによって、そのファイルが注釈処理の対象とならずにコンパイルされることが警告されます。この警告を無効にするには、(そのファイルが注釈処理の対象となるように)そのファイルをコマンドラインに指定するか、あるいはそのようなソース・ファイルに対してクラス・ファイルを生成する必要があるかどうかを\fI\-implicit\fRオプションを使用して指定します。 +コンパイラは、注釈処理が完了するまで、ある型情報の必要性を認識しない場合があります。型情報がソース・ファイル内に見つかり、かつ\fB\-implicit\fRオプションが指定されていない場合、コンパイラによって、そのファイルが注釈処理の対象とならずにコンパイルされることが警告されます。この警告を無効にするには、(そのファイルが注釈処理の対象となるように)そのファイルをコマンド行に指定するか、あるいはそのようなソース・ファイルに対してクラス・ファイルを生成する必要があるかどうかを\fB\-implicit\fRオプションを使用して指定します。 .SH "プログラマティック・インタフェース" .PP -\fIjavac\fRコマンドは、\fIjavax\&.tools\fRパッケージ内のクラスとインタフェースによって定義される新しいJava Compiler APIをサポートします。 +\fBjavac\fRコマンドは、\fBjavax\&.tools\fRパッケージ内のクラスとインタフェースによって定義される新しいJava Compiler APIをサポートします。 .SS "例" .PP -コマンドライン引数を指定するようにコンパイルするには、次の構文を使用します。 +コマンド行引数を指定するようにコンパイルするには、次の構文を使用します。 .sp .if n \{\ .RS 4 .\} .nf -JavaCompiler javac = ToolProvider\&.getSystemJavaCompiler(); -JavaCompiler javac = ToolProvider\&.getSystemJavaCompiler(); +\fBJavaCompiler javac = ToolProvider\&.getSystemJavaCompiler();\fR + .fi .if n \{\ .RE .\} .PP -例では、診断を標準出力ストリームに書き込み、コマンドラインからの呼出し時に\fIjavac\fRが指定する終了コードを返します。 +例では、診断を標準出力ストリームに書き込み、コマンド行からの呼出し時に\fBjavac\fRが指定する終了コードを返します。 .PP -\fIjavax\&.tools\&.JavaCompiler\fRインタフェースの他のメソッドを使用すると、診断の処理やファイルの読取り元/書込み先の制御などを行うことができます。 +\fBjavax\&.tools\&.JavaCompiler\fRインタフェースの他のメソッドを使用すると、診断の処理やファイルの読取り元/書込み先の制御などを行うことができます。 .SS "旧式のインタフェース" .PP \fB注意:\fR -このAPIは、下位互換性のためにのみ保持されています。すべての新しいコードは、新しいJava Compiler APIを使用する必要があります。 +このAPIは、後方互換性のためにのみ保持されています。すべての新しいコードは、新しいJava Compiler APIを使用する必要があります。 .PP -次のように、\fIcom\&.sun\&.tools\&.javac\&.Main\fRクラスには、プログラムからコンパイラを呼び出すためのstaticメソッドが2つ用意されています。 +次のように、\fBcom\&.sun\&.tools\&.javac\&.Main\fRクラスには、プログラムからコンパイラを呼び出すためのstaticメソッドが2つ用意されています。 .sp .if n \{\ .RS 4 .\} .nf -public static int compile(String[] args); -public static int compile(String[] args, PrintWriter out); +\fBpublic static int compile(String[] args);\fR +\fBpublic static int compile(String[] args, PrintWriter out);\fR + .fi .if n \{\ .RE .\} .PP -\fIargs\fRパラメータは、通常コンパイラに渡される任意のコマンドライン引数を表しています。 +\fBargs\fRパラメータは、通常コンパイラに渡される任意のコマンド行引数を表しています。 .PP -\fIout\fRパラメータは、コンパイラの診断出力の宛先を示します。 +\fBout\fRパラメータは、コンパイラの診断出力の宛先を示します。 .PP -\fIreturn\fR値は、\fIjavac\fRの\fIexit\fR値と同じです。 +\fBreturn\fR値は、\fBjavac\fRの\fBexit\fR値と同じです。 .PP \fB注意:\fR -名前が\fIcom\&.sun\&.tools\&.javac\fRで始まるパッケージ(\fIcom\&.sun\&.tools\&.javac\fRのサブパッケージ)で検出される他のすべてのクラスおよびメソッドは、完全に内部用であり、いつでも変更される可能性があります。 +名前が\fBcom\&.sun\&.tools\&.javac\fRで始まるパッケージ(\fBcom\&.sun\&.tools\&.javac\fRのサブパッケージ)で検出される他のすべてのクラスおよびメソッドは、完全に内部用であり、いつでも変更される可能性があります。 .SH "例" .PP -\fBExample 1\fR, 簡単なプログラムのコンパイル +\fB例 1\fR +.br +簡単なプログラムのコンパイル .RS 4 -この例では、greetingsディレクトリで\fIHello\&.java\fRソース・ファイルをコンパイルする方法を示しています。\fIHello\&.java\fRで定義されたクラスは、\fIgreetings\&.Hello\fRと呼ばれます。greetingsディレクトリは、ソース・ファイルとクラス・ファイルの両方があるパッケージ・ディレクトリで、現在のディレクトリのすぐ下にあります。これにより、デフォルトのユーザー・クラス・パスを使用できるようになります。また、\fI\-d\fRオプションを使用して別の出力先ディレクトリを指定する必要もありません。 +この例では、greetingsディレクトリで\fBHello\&.java\fRソース・ファイルをコンパイルする方法を示しています。\fBHello\&.java\fRで定義されたクラスは、\fBgreetings\&.Hello\fRと呼ばれます。greetingsディレクトリは、ソース・ファイルとクラス・ファイルの両方があるパッケージ・ディレクトリで、現在のディレクトリのすぐ下にあります。これにより、デフォルトのユーザー・クラス・パスを使用できるようになります。また、\fB\-d\fRオプションを使用して別の出力先ディレクトリを指定する必要もありません。 .sp -\fIHello\&.java\fR内のソース・コードは次のとおりです。 +\fBHello\&.java\fR内のソース・コードは次のとおりです。 .sp .if n \{\ .RS 4 .\} .nf -package greetings; +\fBpackage greetings;\fR +\fB \fR +\fBpublic class Hello {\fR +\fB public static void main(String[] args) {\fR +\fB for (int i=0; i < args\&.length; i++) {\fR +\fB System\&.out\&.println("Hello " + args[i]);\fR +\fB }\fR +\fB }\fR +\fB}\fR -public class Hello { - public static void main(String[] args) { - for (int i=0; i < args\&.length; i++) { - System\&.out\&.println("Hello " + args[i]); - } - } -} .fi .if n \{\ .RE @@ -1265,46 +1349,53 @@ .RS 4 .\} .nf -javac greetings/Hello\&.java +\fBjavac greetings/Hello\&.java\fR + .fi .if n \{\ .RE .\} -\fIgreetings\&.Hello\fRの実行: +\fBgreetings\&.Hello\fRの実行: .sp .if n \{\ .RS 4 .\} .nf -java greetings\&.Hello World Universe Everyone -Hello World -Hello Universe -Hello Everyone +\fBjava greetings\&.Hello World Universe Everyone\fR +\fBHello World\fR +\fBHello Universe\fR +\fBHello Everyone\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 2\fR, 複数のソース・ファイルのコンパイル +\fB例 2\fR +.br +複数のソース・ファイルのコンパイル .RS 4 -この例では、\fIgreetings\fRパッケージのソース・ファイル\fIAloha\&.java\fR、\fIGutenTag\&.java\fR、\fIHello\&.java\fRおよび\fIHi\&.java\fRをコンパイルします。 +この例では、\fBgreetings\fRパッケージのソース・ファイル\fBAloha\&.java\fR、\fBGutenTag\&.java\fR、\fBHello\&.java\fRおよび\fBHi\&.java\fRをコンパイルします。 .sp .if n \{\ .RS 4 .\} .nf -% javac greetings/*\&.java -% ls greetings -Aloha\&.class GutenTag\&.class Hello\&.class Hi\&.class -Aloha\&.java GutenTag\&.java Hello\&.java Hi\&.java +\fB% javac greetings/*\&.java\fR +\fB% ls greetings\fR +\fBAloha\&.class GutenTag\&.class Hello\&.class Hi\&.class\fR +\fBAloha\&.java GutenTag\&.java Hello\&.java Hi\&.java\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, ユーザー・クラス・パスの指定 +\fB例 3\fR +.br +ユーザー・クラス・パスの指定 .RS 4 前述の例のソース・ファイルのうち1つを変更した後に、そのファイルを再コンパイルします。 .sp @@ -1312,110 +1403,122 @@ .RS 4 .\} .nf -pwd -/examples -javac greetings/Hi\&.java +\fBpwd\fR +\fB/examples\fR +\fBjavac greetings/Hi\&.java\fR + .fi .if n \{\ .RE .\} -\fIgreetings\&.Hi\fRは\fIgreetings\fRパッケージ内の他のクラスを参照しているため、コンパイラはこれらの他のクラスを探す必要があります。デフォルトのユーザー・クラス・パスはパッケージ・ディレクトリを含むディレクトリであるため、前述の例は動作します。現在のディレクトリを気にせずにこのファイルを再コンパイルする場合、\fICLASSPATH\fRを設定して、ユーザー・クラス・パスに例のディレクトリを追加します。この例では、\fI\-classpath\fRオプションを使用しています。 +\fBgreetings\&.Hi\fRは\fBgreetings\fRパッケージ内の他のクラスを参照しているため、コンパイラはこれらの他のクラスを探す必要があります。デフォルトのユーザー・クラス・パスはパッケージ・ディレクトリを含むディレクトリであるため、前述の例は動作します。現在のディレクトリを気にせずにこのファイルを再コンパイルする場合、\fBCLASSPATH\fRを設定して、ユーザー・クラス・パスに例のディレクトリを追加します。この例では、\fB\-classpath\fRオプションを使用しています。 .sp .if n \{\ .RS 4 .\} .nf -javac \-classpath /examples /examples/greetings/Hi\&.java +\fBjavac \-classpath /examples /examples/greetings/Hi\&.java\fR + .fi .if n \{\ .RE .\} -\fIgreetings\&.Hi\fRを変更してバナー・ユーティリティを使用するようにした場合、 そのユーティリティもユーザー・クラス・パスを通じてアクセスできるようになっている必要があります。 +\fBgreetings\&.Hi\fRを変更してバナー・ユーティリティを使用するようにした場合、 そのユーティリティもユーザー・クラス・パスを通じてアクセスできるようになっている必要があります。 .sp .if n \{\ .RS 4 .\} .nf -javac \-classpath /examples:/lib/Banners\&.jar \e - /examples/greetings/Hi\&.java +\fBjavac \-classpath /examples:/lib/Banners\&.jar \e\fR +\fB /examples/greetings/Hi\&.java\fR + .fi .if n \{\ .RE .\} -\fIgreetings\fRパッケージでクラスを実行するには、プログラムは\fIgreetings\fRパッケージ、および\fIgreetings\fRクラスが使用するクラスにアクセスする必要があります。 +\fBgreetings\fRパッケージでクラスを実行するには、プログラムは\fBgreetings\fRパッケージ、および\fBgreetings\fRクラスが使用するクラスにアクセスする必要があります。 .sp .if n \{\ .RS 4 .\} .nf -java \-classpath /examples:/lib/Banners\&.jar greetings\&.Hi +\fBjava \-classpath /examples:/lib/Banners\&.jar greetings\&.Hi\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 4\fR, ソース・ファイルとクラス・ファイルの分離 +\fB例 4\fR +.br +ソース・ファイルとクラス・ファイルの分離 .RS 4 -次の例では、\fIjavac\fRを使用して、JVM 1\&.6上で実行するコードをコンパイルします。 +次の例では、\fBjavac\fRを使用して、JVM 1\&.7上で実行するコードをコンパイルします。 .sp .if n \{\ .RS 4 .\} .nf -javac \-source 1\&.6 \-target 1\&.6 \-bootclasspath jdk1\&.6\&.0/lib/rt\&.jar \e -\-extdirs "" OldCode\&.java +\fBjavac \-source 1\&.7 \-target 1\&.7 \-bootclasspath jdk1\&.7\&.0/lib/rt\&.jar \e \fR +\fB\-extdirs "" OldCode\&.java\fR + .fi .if n \{\ .RE .\} -\fI\-source 1\&.6\fRオプションにより、\fIOldCode\&.java\fRのコンパイルにはリリース1\&.6(または6)のJavaプログラミング言語が使用されます。\fI\-target 1\&.6\fRオプションにより、JVM 1\&.6と互換性のあるクラス・ファイルが生成されます。ほとんどの場合、\fI\-target\fRオプションの値は\fI\-source\fRオプションの値になります。この例では、\fI\-target\fRオプションを省略できます。 +\fB\-source 1\&.7\fRオプションにより、\fBOldCode\&.java\fRのコンパイルにはリリース1\&.7(または7)のJavaプログラミング言語が使用されます。\fB\-target 1\&.7\fRオプションにより、JVM 1\&.7と互換性のあるクラス・ファイルが生成されます。ほとんどの場合、\fB\-target\fRオプションの値は\fB\-source\fRオプションの値になります。この例では、\fB\-target\fRオプションを省略できます。 .sp -\fI\-bootclasspath\fRオプションを使用して、適切なバージョンのブートストラップ・クラス(\fIrt\&.jar\fRライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 +\fB\-bootclasspath\fRオプションを使用して、適切なバージョンのブートストラップ・クラス(\fBrt\&.jar\fRライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 .sp .if n \{\ .RS 4 .\} .nf -javac \-source 1\&.6 OldCode\&.java -warning: [options] bootstrap class path not set in conjunction with -\-source 1\&.6 +\fBjavac \-source 1\&.7 OldCode\&.java\fR +\fBwarning: [options] bootstrap class path not set in conjunction with \fR +\fB\-source 1\&.7\fR + .fi .if n \{\ .RE .\} -適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様(この例では、バージョン1\&.6のJavaプログラミング言語)を新しいブートストラップ・クラスと組み合せて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 6)で動作しない可能性があります。 +適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様(この例では、バージョン1\&.7のJavaプログラミング言語)を新しいブートストラップ・クラスと組み合せて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 7)で動作しない可能性があります。 .RE .PP -\fBExample 5\fR, クロス・コンパイル +\fB例 5\fR +.br +クロス・コンパイル .RS 4 -この例では、\fIjavac\fRを使用して、JVM 1\&.6上で実行するコードをコンパイルします。 +この例では、\fBjavac\fRを使用して、JVM 1\&.7上で実行するコードをコンパイルします。 .sp .if n \{\ .RS 4 .\} .nf -javac \-source 1\&.6 \-target 1\&.6 \-bootclasspath jdk1\&.6\&.0/lib/rt\&.jar \e - \-extdirs "" OldCode\&.java +\fBjavac \-source 1\&.7 \-target 1\&.7 \-bootclasspath jdk1\&.7\&.0/lib/rt\&.jar \e\fR +\fB \-extdirs "" OldCode\&.java\fR + .fi .if n \{\ .RE .\} -The\fI \-source 1\&.6\fRオプションにより、OldCode\&.javaのコンパイルにはリリース1\&.6(または6)のJavaプログラミング言語が使用されます。\fI\-target 1\&.6\fRオプションにより、JVM 1\&.6と互換性のあるクラス・ファイルが生成されます。ほとんどの場合、\fI\-target\fRの値は\fI\-source\fRの値になります。この例では、\fI\-target\fRオプションは省略されます。 +\fB \-source 1\&.7\fRオプションにより、OldCode\&.javaのコンパイルにはリリース1\&.7(または7)のJavaプログラミング言語が使用されます。\fB\-target 1\&.7\fRオプションにより、JVM 1\&.7と互換性のあるクラス・ファイルが生成されます。ほとんどの場合、\fB\-target\fRの値は\fB\-source\fRの値になります。この例では、\fB\-target\fRオプションは省略されます。 .sp -\fI\-bootclasspath\fRオプションを使用して、適切なバージョンのブートストラップ・クラス(\fIrt\&.jar\fRライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 +\fB\-bootclasspath\fRオプションを使用して、適切なバージョンのブートストラップ・クラス(\fBrt\&.jar\fRライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 .sp .if n \{\ .RS 4 .\} .nf -javac \-source 1\&.6 OldCode\&.java -warning: [options] bootstrap class path not set in conjunction with \-source 1\&.6 +\fBjavac \-source 1\&.7 OldCode\&.java\fR +\fBwarning: [options] bootstrap class path not set in conjunction with \-source 1\&.7\fR + .fi .if n \{\ .RE .\} -適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様を新しいブートストラップ・クラスと組み合せて使用します。この組合せは、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 6)で動作しない可能性があります。この例では、コンパイラはJavaプログラミング言語のリリース1\&.6を使用します。 +適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様を新しいブートストラップ・クラスと組み合せて使用します。この組合せは、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 7)で動作しない可能性があります。この例では、コンパイラはJavaプログラミング言語のリリース1\&.7を使用します。 .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/javadoc.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/javadoc.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: javadoc -.\" Language: English -.\" Date: 2011年5月10日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: javadoc +.\" Language: Japanese +.\" Date: 2011年5月10日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "javadoc" "1" "2011年5月10日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" javadoc \- Javaソース・ファイルから、APIドキュメントのHTMLページを生成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjavadoc\fR {\fIpackages\fR|\fIsource\-files\fR} [\fIoptions\fR] [\fI@argfiles\fR] +\fBjavadoc\fR {\fIpackages\fR|\fIsource\-files\fR} [\fIoptions\fR] [\fI@argfiles\fR] .fi .if n \{\ .RE @@ -64,33 +66,33 @@ .PP \fIpackages\fR .RS 4 -\fIjava\&.lang java\&.lang\&.reflect java\&.awt\fRなど、空白で区切ってドキュメント化するパッケージの名前。サブパッケージもドキュメント化する場合は、\fI\-subpackages\fRオプションを使用してパッケージを指定します。 -.sp -デフォルトでは、\fIjavadoc\fRは、現在のディレクトリおよびサブディレクトリで指定されたパッケージを探します。\fI\-sourcepath\fRオプションを使用して、パッケージを探すディレクトリのリストを指定します。 +\fBjava\&.lang java\&.lang\&.reflect java\&.awt\fRなど、空白で区切ってドキュメント化するパッケージの名前。サブパッケージもドキュメント化する場合は、\fB\-subpackages\fRオプションを使用してパッケージを指定します。 +.sp +デフォルトでは、\fBjavadoc\fRは、現在のディレクトリおよびサブディレクトリで指定されたパッケージを探します。\fB\-sourcepath\fRオプションを使用して、パッケージを探すディレクトリのリストを指定します。 .RE .PP \fIsource\-files\fR .RS 4 -\fIClass\&.java Object\&.java Button\&.java\fRのように空白で区切った、ドキュメント化するJavaソース・ファイルの名前。デフォルトでは、\fIjavadoc\fRは、現在のディレクトリで指定されたクラスを探します。ただし、\fI/home/src/java/awt/Graphics*\&.java\fRのように、クラス・ファイルのフルパスを指定し、ワイルドカード文字を使用できます。現在のディレクトリからの相対パスも指定できます。 +\fBClass\&.java Object\&.java Button\&.java\fRのように空白で区切った、ドキュメント化するJavaソース・ファイルの名前。デフォルトでは、\fBjavadoc\fRは、現在のディレクトリで指定されたクラスを探します。ただし、\fB/home/src/java/awt/Graphics*\&.java\fRのように、クラス・ファイルのフルパスを指定し、ワイルドカード文字を使用できます。現在のディレクトリからの相対パスも指定できます。 .RE .PP \fIoptions\fR .RS 4 -空白で区切られたコマンドライン・オプション。オプションを参照してください。 +空白で区切られたコマンド行オプション。オプションを参照してください。 .RE .PP \fI@argfiles\fR .RS 4 -\fIjavadoc\fRコマンド・オプション、パッケージ名およびソース・ファイル名のリストを任意の順序で含むファイルの名前。 +\fBjavadoc\fRコマンド・オプション、パッケージ名およびソース・ファイル名のリストを任意の順序で含むファイルの名前。 .RE .SH "説明" .PP -\fIjavadoc\fRコマンドは、一連のJavaソース・ファイルにある宣言およびドキュメンテーション・コメントを解析し、デフォルトでは、publicクラス、protectedクラス、ネストされたクラス(匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて記述した一連のHTMLページを生成します。\fIjavadoc\fRコマンドは、APIドキュメントの生成や、一連のソース・ファイルの実装ドキュメントの生成に使用できます。 -.PP -\fIjavadoc\fRコマンドは、パッケージ全体、個々のソース・ファイル、またはその両方に対して実行できます。パッケージ全体のドキュメント化を行うには、\fI\-subpackages\fRオプションを使用してディレクトリおよびそのサブディレクトリを再帰的にたどるか、パッケージ名の明示的なリストを渡します。個々のソース・ファイルをドキュメント化するには、Javaソース・ファイル名のリストを渡します。簡単な例を参照してください。 +\fBjavadoc\fRコマンドは、一連のJavaソース・ファイルにある宣言およびドキュメンテーション・コメントを解析し、デフォルトでは、publicクラス、protectedクラス、ネストされたクラス(匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて記述した一連のHTMLページを生成します。\fBjavadoc\fRコマンドは、APIドキュメントの生成や、一連のソース・ファイルの実装ドキュメントの生成に使用できます。 +.PP +\fBjavadoc\fRコマンドは、パッケージ全体、個々のソース・ファイル、またはその両方に対して実行できます。パッケージ全体のドキュメント化を行うには、\fB\-subpackages\fRオプションを使用してディレクトリおよびそのサブディレクトリを再帰的にたどるか、パッケージ名の明示的なリストを渡します。個々のソース・ファイルをドキュメント化するには、Javaソース・ファイル名のリストを渡します。簡単な例を参照してください。 .SS "ソース・ファイルの処理" .PP -\fIjavadoc\fRコマンドは、ソースで終わるファイル、およびソース・ファイルで説明しているその他のファイルを処理します。個々のソース・ファイル名を渡して\fIjavadoc\fRを実行する場合、どのソース・ファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。ソース・ファイル名を明示的に指定しなくても、\fIjavadoc\fRコマンドは3つの方法で実行できます。パッケージ名を渡し、\fI\-subpackages\fRオプションを使用するか、またはソース・ファイル名にワイルドカードを使用することができます。これらの場合、\fIjavadoc\fRコマンドがソース・ファイルの処理を行うのは、そのファイルが次のすべての要件を満たす場合のみです。 +\fBjavadoc\fRコマンドは、ソースで終わるファイル、およびソース・ファイルで説明しているその他のファイルを処理します。個々のソース・ファイル名を渡して\fBjavadoc\fRを実行する場合、どのソース・ファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。ソース・ファイル名を明示的に指定しなくても、\fBjavadoc\fRコマンドは3つの方法で実行できます。パッケージ名を渡し、\fB\-subpackages\fRオプションを使用するか、またはソース・ファイル名にワイルドカードを使用することができます。これらの場合、\fBjavadoc\fRコマンドがソース・ファイルの処理を行うのは、そのファイルが次のすべての要件を満たす場合のみです。 .sp .RS 4 .ie n \{\ @@ -100,7 +102,7 @@ .sp -1 .IP \(bu 2.3 .\} -ファイル名の接頭辞(\fI\&.java\fRを削除)が有効なクラス名である。 +ファイル名の接頭辞(\fB\&.java\fRを削除)が有効なクラス名である。 .RE .sp .RS 4 @@ -124,8 +126,10 @@ .\} パッケージ文に有効なパッケージ名が含まれている。 .RE -リンクの処理.PP -処理の実行中に、\fIjavadoc\fRコマンドは、その実行でドキュメント化されるパッケージ、クラス、およびメンバーの名前に対して、相互参照リンクを追加します。リンクは、次の場所に表示されます。@タグの説明については、javadocタグを参照してください。 +.PP +リンクの処理 +.PP +処理の実行中に、\fBjavadoc\fRコマンドは、その実行でドキュメント化されるパッケージ、クラス、およびメンバーの名前に対して、相互参照リンクを追加します。リンクは、次の場所に表示されます。@タグの説明については、javadocタグを参照してください。 .sp .RS 4 .ie n \{\ @@ -146,7 +150,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI@see\fRタグから生成された「\fI関連項目\fR」セクション。 +\fB@see\fRタグから生成された\fI「関連項目」\fRセクション。 .RE .sp .RS 4 @@ -157,7 +161,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI{@link}\fRタグから生成されたインライン・テキスト。 +\fB{@link}\fRタグから生成されたインライン・テキスト。 .RE .sp .RS 4 @@ -168,7 +172,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI@throws\fRタグから生成された例外の名前。 +\fB@throws\fRタグから生成された例外の名前。 .RE .sp .RS 4 @@ -179,7 +183,7 @@ .sp -1 .IP \(bu 2.3 .\} -インタフェースのメンバーに対する「\fI定義\fR」リンクと、クラスのメンバーに対する「\fIオーバーライド\fR」リンク。メソッド・コメントの継承を参照してください。 +インタフェースのメンバーに対する\fI「定義」\fRリンクと、クラスのメンバーに対する\fI「オーバーライド」\fRリンク。メソッド・コメントの継承を参照してください。 .RE .sp .RS 4 @@ -215,37 +219,39 @@ 索引。 .RE .PP -コマンドラインで指定しなかったクラスについての既存のテキスト(別に生成したテキスト)に対してリンクを追加するには、\fI\-link\fRおよび\fI\-linkoffline\fRオプションを利用できます。 -処理の詳細.PP -\fIjavadoc\fRコマンドは実行するたびに1つの完全なドキュメントを生成します。前の実行の結果を変更または直接取り込む、増分ビルドを行いません。ただし、\fIjavadoc\fRコマンドは、他の実行の結果にリンクできます。 -.PP -\fIjavadoc\fRコマンドの実装にはJavaコンパイラが必要で、Javaコンパイラに依存しています。\fIjavadoc\fRコマンドは\fIjavac\fRコマンドの一部を呼び出し、宣言をコンパイルして、メンバーの実装を無視します。\fIjavadoc\fRコマンドは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、HTMLを生成します。さらに、J\fIjavadoc\fRコマンドは、ソース・コードのドキュメンテーション・コメントから、ユーザーの提供したドキュメントも取得します。ドキュメンテーション・コメントを参照してください。 -.PP -\fIjavadoc\fRコマンドは、メソッド本体を持たない純粋なスタブ・ファイルであるソース・ファイルに対して実行できます。したがって、APIの実装前の設計の早い段階で、ドキュメンテーション・コメントを記述して\fIjavadoc\fRコメントを実行できます。 -.PP -コンパイラに依存することによって、HTML出力は、実際の実装に正確に対応します。実際の実装は、明示的なソース・コードにではなく、暗黙のソース・コードに依存する場合があります。たとえば、\fIjavadoc\fRコマンドは、コンパイル済クラス・ファイルには存在するがソース・コードには存在しないデフォルト・コンストラクタをドキュメント化します。 -.PP -多くの場合、\fIjavadoc\fRコマンドでは、ソース・ファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。すべてのデバッグやトラブルシューティングを完了する前にドキュメントを生成できます。\fIjavadoc\fRコマンドはドキュメンテーション・コメントの基本的なチェックを行います。 -.PP -\fIjavadoc\fRコマンドは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、 -\fIjavadoc\fRコマンドは、ブートストラップ・クラス、拡張機能、またはユーザー・クラスにかかわらず、すべての参照クラスを検索できる必要があります。クラスの検出方法 +コマンド行で指定しなかったクラスについての既存のテキスト(別に生成したテキスト)に対してリンクを追加するには、\fB\-link\fRおよび\fB\-linkoffline\fRオプションを利用できます。 +.PP +処理の詳細 +.PP +\fBjavadoc\fRコマンドは実行するたびに1つの完全なドキュメントを生成します。前の実行の結果を変更または直接取り込む、増分ビルドを行いません。ただし、\fBjavadoc\fRコマンドは、他の実行の結果にリンクできます。 +.PP +\fBjavadoc\fRコマンドの実装にはJavaコンパイラが必要で、Javaコンパイラに依存しています。\fBjavadoc\fRコマンドは\fBjavac\fRコマンドの一部を呼び出し、宣言をコンパイルして、メンバーの実装を無視します。\fBjavadoc\fRコマンドは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、HTMLを生成します。さらに、J\fBjavadoc\fRコマンドは、ソース・コードのドキュメンテーション・コメントから、ユーザーの提供したドキュメントも取得します。ドキュメンテーション・コメントを参照してください。 +.PP +\fBjavadoc\fRコマンドは、メソッド本体を持たない純粋なスタブ・ファイルであるソース・ファイルに対して実行できます。したがって、APIの実装前の設計の早い段階で、ドキュメンテーション・コメントを記述して\fBjavadoc\fRコメントを実行できます。 +.PP +コンパイラに依存することによって、HTML出力は、実際の実装に正確に対応します。実際の実装は、明示的なソース・コードにではなく、暗黙のソース・コードに依存する場合があります。たとえば、\fBjavadoc\fRコマンドは、コンパイル済クラス・ファイルには存在するがソース・コードには存在しないデフォルト・コンストラクタをドキュメント化します。 +.PP +多くの場合、\fBjavadoc\fRコマンドでは、ソース・ファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。すべてのデバッグやトラブルシューティングを完了する前にドキュメントを生成できます。\fBjavadoc\fRコマンドはドキュメンテーション・コメントの基本的なチェックを行います。 +.PP +\fBjavadoc\fRコマンドは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、 +\fBjavadoc\fRコマンドは、ブートストラップ・クラス、拡張機能、またはユーザー・クラスにかかわらず、すべての参照クラスを検索できる必要があります。クラスの検出方法 (http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/findingclasses\&.html)を参照してください .PP -通常、作成するクラスは、拡張クラスとして、または\fIjavadoc\fRコマンドのクラス・パスでロードされる必要があります。 +通常、作成するクラスは、拡張クラスとして、または\fBjavadoc\fRコマンドのクラス・パスでロードされる必要があります。 .SS "Javadocのドックレット" .PP -\fIjavadoc\fRコマンドの出力の内容と形式は、ドックレットを使用してカスタマイズできます。\fIjavadoc\fRコマンドには、標準ドックレットと呼ばれるデフォルトの組込みドックレットがあります。標準ドックレットは、HTML形式のAPIドキュメントを生成します。標準ドックレットを修正またはサブクラスを作成することや、HTML、XML、MIF、RTFなどの好みの出力形式を生成する独自のドックレットを記述することも可能です。 -.PP -\fI\-doclet\fRオプションでカスタム・ドックレットが指定されていない場合、\fIjavadoc\fRコマンドは、デフォルトの標準ドックレットを使用します。\fIjavadoc\fRコマンドには、使用されているドックレットに関係なく使用できるいくつかのオプションがあります。標準ドックレットでは、これらの他に、いくつかのコマンドライン・オプションが追加されます。オプションを参照してください。 +\fBjavadoc\fRコマンドの出力の内容と形式は、ドックレットを使用してカスタマイズできます。\fBjavadoc\fRコマンドには、標準ドックレットと呼ばれるデフォルトの組込みドックレットがあります。標準ドックレットは、HTML形式のAPIドキュメントを生成します。標準ドックレットを修正またはサブクラスを作成することや、HTML、XML、MIF、RTFなどの好みの出力形式を生成する独自のドックレットを記述することも可能です。 +.PP +\fB\-doclet\fRオプションでカスタム・ドックレットが指定されていない場合、\fBjavadoc\fRコマンドは、デフォルトの標準ドックレットを使用します。\fBjavadoc\fRコマンドには、使用されているドックレットに関係なく使用できるいくつかのオプションがあります。標準ドックレットでは、これらの他に、いくつかのコマンド行オプションが追加されます。オプションを参照してください。 .SH "ソース・ファイル" .PP -\fIjavadoc\fRコマンドは、次のタイプのソース・ファイルから出力を生成します。そのファイルは、クラスのJava言語ソース・ファイル(\fI\&.java\fR)、パッケージ・コメント・ファイル、概要コメント・ファイル、およびその他の未処理のファイルです。ここでは、ドキュメント化しないがソース・ツリーに存在する場合があるテスト・ファイルやテンプレート・ファイルについても説明します。 +\fBjavadoc\fRコマンドは、次のタイプのソース・ファイルから出力を生成します。そのファイルは、クラスのJava言語ソース・ファイル(\fB\&.java\fR)、パッケージ・コメント・ファイル、概要コメント・ファイル、およびその他の未処理のファイルです。ここでは、ドキュメント化しないがソース・ツリーに存在する場合があるテスト・ファイルやテンプレート・ファイルについても説明します。 .SS "クラスのソース・ファイル" .PP それぞれのクラスまたはインタフェース、およびそのメンバーは、独自のドキュメンテーション・コメントを持つことができ、それをソース・ファイル内に保持します。ドキュメンテーション・コメントを参照してください。 .SS "パッケージ・コメント・ファイル" .PP -それぞれのパッケージは、独自のドキュメンテーション・コメントを持つことができ、それを専用のソース・ファイルに保持します。その内容は、\fIjavadoc\fRコマンドによって生成されるパッケージのサマリー・ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。 +それぞれのパッケージは、独自のドキュメンテーション・コメントを持つことができ、それを専用のソース・ファイルに保持します。その内容は、\fBjavadoc\fRコマンドによって生成されるパッケージのサマリー・ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。 .PP パッケージ・コメント・ファイルを作成するには、次のいずれかのファイルにコメントを格納できます。 .sp @@ -257,7 +263,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIpackage\-info\&.java\fRファイルには、パッケージ宣言、パッケージ注釈、パッケージ・コメント、およびJavadocタグを格納できます。このファイルが優先されます。 +\fBpackage\-info\&.java\fRファイルには、パッケージ宣言、パッケージ注釈、パッケージ・コメント、およびJavadocタグを格納できます。このファイルが優先されます。 .RE .sp .RS 4 @@ -268,73 +274,81 @@ .sp -1 .IP \(bu 2.3 .\} -\fIpackage\&.html\fRファイルには、パッケージ・コメントとJavadocタグのみを格納できます。パッケージ注釈は格納できません。 -.RE -.PP -各パッケージは、\fIpackage\&.html\fRファイルまたは\fIpackage\-info\&.java\fRファイルのいずれかを1つ持つことができますが、その両方を持つことはできません。このどちらかのファイルをソース・ファイルとともに、ソース・ツリー内のそのパッケージ・ディレクトリ内に配置してください。 -package\-info\&.javaファイル.PP -\fIpackage\-info\&.java\fRファイルには、次の構造のパッケージ・コメントを含めることができます。コメントは、パッケージ宣言の前に配置されます。 +\fBpackage\&.html\fRファイルには、パッケージ・コメントとJavadocタグのみを格納できます。パッケージ注釈は格納できません。 +.RE +.PP +各パッケージは、\fBpackage\&.html\fRファイルまたは\fBpackage\-info\&.java\fRファイルのいずれかを1つ持つことができますが、その両方を持つことはできません。このどちらかのファイルをソース・ファイルとともに、ソース・ツリー内のそのパッケージ・ディレクトリ内に配置してください。 +.PP +package\-info\&.javaファイル +.PP +\fBpackage\-info\&.java\fRファイルには、次の構造のパッケージ・コメントを含めることができます。コメントは、パッケージ宣言の前に配置されます。 .PP \fB注意:\fR -コメント区切り文字である\fI/**\fRおよび\fI*/\fRが存在する必要がありますが、中間の行の先頭のアスタリスクは省略可能です。 +コメント区切り文字である\fB/**\fRおよび\fB*/\fRが存在する必要がありますが、中間の行の先頭のアスタリスクは省略可能です。 .sp .if n \{\ .RS 4 .\} .nf -/** - * Provides the classes necessary to create an - * applet and the classes an applet uses - * to communicate with its applet context\&. - * <p> - * The applet framework involves two entities: - * the applet 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 - */ -package java\&.lang\&.applet; +\fB/**\fR +\fB * Provides the classes necessary to create an \fR +\fB * applet and the classes an applet uses \fR +\fB * to communicate with its applet context\&.\fR +\fB * <p>\fR +\fB * The applet framework involves two entities:\fR +\fB * the applet and the applet context\&.\fR +\fB * An applet is an embeddable window (see the\fR +\fB * {@link java\&.awt\&.Panel} class) with a few extra\fR +\fB * methods that the applet context can use to \fR +\fB * initialize, start, and stop the applet\&.\fR +\fB *\fR +\fB * @since 1\&.0\fR +\fB * @see java\&.awt\fR +\fB */\fR +\fBpackage java\&.lang\&.applet;\fR + .fi .if n \{\ .RE .\} -package\&.htmlファイル.PP -\fIpackage\&.html\fRファイルには、次の構造のパッケージ・コメントを含めることができます。コメントは、\fI<body>\fR要素に配置されます。 +.PP +package\&.htmlファイル +.PP +\fBpackage\&.html\fRファイルには、次の構造のパッケージ・コメントを含めることができます。コメントは、\fB<body>\fR要素に配置されます。 .PP ファイル: -\fIjava/applet/package\&.html\fR +\fBjava/applet/package\&.html\fR .sp .if n \{\ .RS 4 .\} .nf -<HTML> -<BODY> -Provides the classes necessary to create an applet and the -classes an applet uses to communicate with its applet context\&. -<p> -The applet framework involves two entities: the applet -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> +\fB<HTML>\fR +\fB<BODY>\fR +\fBProvides the classes necessary to create an applet and the \fR +\fBclasses an applet uses to communicate with its applet context\&.\fR +\fB<p>\fR +\fBThe applet framework involves two entities: the applet\fR +\fBand the applet context\&. An applet is an embeddable\fR +\fBwindow (see the {@link java\&.awt\&.Panel} class) with a\fR +\fBfew extra methods that the applet context can use to\fR +\fBinitialize, start, and stop the applet\&. \fR + +\fB@since 1\&.0 \fR +\fB@see java\&.awt\fR +\fB</BODY>\fR +\fB</HTML>\fR + .fi .if n \{\ .RE .\} .PP -\fIpackage\&.html\fRファイルは通常のHTMLファイルであり、パッケージ宣言を含んでいません。パッケージ・コメント・ファイルの内容はHTMLで記述しますが、例外が1つあります。このドキュメンテーション・コメントには、コメント区切り文字である\fI/**\fRと\fI*/\fR、または行頭のアスタリスクを含めない、という点です。コメントを書く場合は、最初の文をパッケージのサマリーとし、\fI<body>\fRタグと最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージ・タグを含めることができます。すべてのブロック・タグは、主説明の後に配置する必要があります。\fI@see\fRタグをパッケージ・コメント・ファイルに追加する場合には、完全修飾名を使用する必要があります。 -コメント・ファイルの処理.PP -\fIjavadoc\fRコメントを実行すると、パッケージ・コメント・ファイルが検索されます。パッケージ・コメント・ファイルが見つかった場合は、\fIjavadoc\fRコマンドは次の手順を実行します。 +\fBpackage\&.html\fRファイルは通常のHTMLファイルであり、パッケージ宣言を含んでいません。パッケージ・コメント・ファイルの内容はHTMLで記述しますが、例外が1つあります。このドキュメンテーション・コメントには、コメント区切り文字である\fB/**\fRと\fB*/\fR、または行頭のアスタリスクを含めない、という点です。コメントを書く場合は、最初の文をパッケージのサマリーとし、\fB<body>\fRタグと最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージ・タグを含めることができます。すべてのブロック・タグは、主説明の後に配置する必要があります。\fB@see\fRタグをパッケージ・コメント・ファイルに追加する場合には、完全修飾名を使用する必要があります。 +.PP +コメント・ファイルの処理 +.PP +\fBjavadoc\fRコメントを実行すると、パッケージ・コメント・ファイルが検索されます。パッケージ・コメント・ファイルが見つかった場合は、\fBjavadoc\fRコマンドは次の手順を実行します。 .sp .RS 4 .ie n \{\ @@ -344,8 +358,8 @@ .sp -1 .IP \(bu 2.3 .\} -処理できるようにコメントをコピーします。package\&.htmlの場合、\fIjavadoc\fRコマンドは、\fI<body>\fRと\fI</body>\fR -HTMLタグ間のすべての内容をコピーします。\fI<head>\fRセクションを含め、そこに\fI<title>\fRタグやソース・ファイルの著作権記述などの情報を配置することもできますが、生成されたドキュメントにはそれらは一切表示されません。 +処理できるようにコメントをコピーします。package\&.htmlの場合、\fBjavadoc\fRコマンドは、\fB<body>\fRと\fB</body>\fR +HTMLタグ間ですべてのコンテンツをコピーします。\fB<head>\fRセクションを含めて、\fB<title>\fRタグ、ソース・ファイルのコピーライト文、その他の情報を配置することはできますが、これらは生成されるドキュメントには表示されません。 .RE .sp .RS 4 @@ -379,24 +393,24 @@ .sp -1 .IP \(bu 2.3 .\} -パッケージのサマリー・ページの先頭に、パッケージ・コメントの最初の文をコピーします。さらに、\fIjavadoc\fRコマンドは、概要ページのパッケージ・リストに、パッケージ名とパッケージ・コメントの最初の文を追加します。Javaプラットフォーム、Standard Edition API仕様の概要 +パッケージのサマリー・ページの先頭に、パッケージ・コメントの最初の文をコピーします。さらに、\fBjavadoc\fRコマンドは、概要ページのパッケージ・リストに、パッケージ名とパッケージ・コメントの最初の文を追加します。Javaプラットフォーム、Standard Edition API仕様の概要 (http://docs\&.oracle\&.com/javase/8/docs/api/overview\-summary\&.html)を参照してください .sp 文の終わりは、クラスやメンバーの主説明の最初の文の終わりと同じルールによって判断されます。 .RE .SS "概要コメント・ファイル" .PP -ドキュメント化する各アプリケーションまたはパッケージ・セットは、独自の概要ドキュメンテーション・コメントを持つことができ、それは専用のソース・ファイルに保持されます。その内容は、\fIjavadoc\fRコマンドによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージ・セット全体に当てはまるドキュメントを記述します。 +ドキュメント化する各アプリケーションまたはパッケージ・セットは、独自の概要ドキュメンテーション・コメントを持つことができ、それは専用のソース・ファイルに保持されます。その内容は、\fBjavadoc\fRコマンドによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージ・セット全体に当てはまるドキュメントを記述します。 .PP このファイルにはoverview\&.htmlなどの名前を付けることができ、どこに配置してもかまいません。一般的な場所は、ソース・ツリーの最上部です。 .PP -たとえば、\fIjava\&.applet\fRパッケージのソース・ファイルが/home/user/src/java/appletディレクトリに格納されている場合、概要コメント・ファイルは/home/user/src/overview\&.htmlに作成できます。 -.PP -異なるパッケージのセットに対して\fIjavadoc\fRコマンドを複数回実行する場合は、同じ1つのソース・ファイルのセットに対して複数の概要コメント・ファイルを作成できます。たとえば、内部ドキュメント用に\fI\-private\fRを指定して\fIjavadoc\fRコマンドを1回実行した後、公開ドキュメント用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメント・ファイルの1文目で、そのドキュメントを公開用または内部用として記述できます。 -.PP -概要コメント・ファイルの内容は、HTMLで記述された1つの大きなドキュメンテーション・コメントです。最初の文はアプリケーションまたはパッケージのセットのサマリーとします。\fI<body>\fRタグと最初の文の間にタイトルやその他のテキストを含めないようにします。{\fI@link}\fRなどのインライン・タグを除くすべてのタグは、主説明の後に配置する必要があります。\fI@see\fRタグを追加する場合には、完全修飾名を使用する必要があります。 -.PP -\fIjavadoc\fRコマンドの実行時に、\fI\-overview\fRオプションを使用して概要コメント・ファイル名を指定します。このファイルは、パッケージ・コメント・ファイルと同じように処理されます。\fIjavadoc\fRコマンドは次の手順を実行します。 +たとえば、\fBjava\&.applet\fRパッケージのソース・ファイルが/home/user/src/java/appletディレクトリに格納されている場合、概要コメント・ファイルは/home/user/src/overview\&.htmlに作成できます。 +.PP +異なるパッケージのセットに対して\fBjavadoc\fRコマンドを複数回実行する場合は、同じ1つのソース・ファイルのセットに対して複数の概要コメント・ファイルを作成できます。たとえば、内部ドキュメント用に\fB\-private\fRを指定して\fBjavadoc\fRコマンドを1回実行した後、公開ドキュメント用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメント・ファイルの1文目で、そのドキュメントを公開用または内部用として記述できます。 +.PP +概要コメント・ファイルの内容は、HTMLで記述された1つの大きなドキュメンテーション・コメントです。最初の文はアプリケーションまたはパッケージのセットのサマリーとします。\fB<body>\fRタグと最初の文の間にタイトルやその他のテキストを含めないようにします。{\fB@link}\fRなどのインライン・タグを除くすべてのタグは、主説明の後に配置する必要があります。\fB@see\fRタグを追加する場合には、完全修飾名を使用する必要があります。 +.PP +\fBjavadoc\fRコマンドの実行時に、\fB\-overview\fRオプションを使用して概要コメント・ファイル名を指定します。このファイルは、パッケージ・コメント・ファイルと同じように処理されます。\fBjavadoc\fRコマンドは次の手順を実行します。 .sp .RS 4 .ie n \{\ @@ -406,7 +420,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI<body>\fRと\fI</body>\fRタグの間にある内容をすべて処理対象としてコピーします。 +\fB<body>\fRと\fB</body>\fRタグ間で、処理するすべてのコンテンツをコピーします。 .RE .sp .RS 4 @@ -444,50 +458,56 @@ .RE .SS "未処理のファイル" .PP -ソース・ファイルには、\fIjavadoc\fRコマンドによって宛先ディレクトリにコピーされる、任意のファイルを含めることができます。このようなファイルには、通常、グラフィック・ファイル、サンプルのJavaソースおよびクラス・ファイル、一般的なJavaソース・ファイルのドキュメンテーション・コメントの影響を受けない多くの内容を含む独立したHTMLファイルなどがあります。 +ソース・ファイルには、\fBjavadoc\fRコマンドによって宛先ディレクトリにコピーされる、任意のファイルを含めることができます。このようなファイルには、通常、グラフィック・ファイル、サンプルのJavaソースおよびクラス・ファイル、一般的なJavaソース・ファイルのドキュメンテーション・コメントの影響を受けない多くの内容を含む独立したHTMLファイルなどがあります。 .PP 未処理のファイルを含めるには、doc\-filesというディレクトリにファイルを配置します。doc\-filesディレクトリは、ソース・ファイルを含む任意のパッケージ・ディレクトリのサブディレクトリになることができます。doc\-filesサブディレクトリは、パッケージごとに1つ用意できます。 .PP -たとえば、ボタンのイメージを\fIjava\&.awt\&.Button\fRクラスのドキュメントに含める場合には、そのイメージ・ファイルを/home/user/src/java/awt/doc\-files/ディレクトリに置きます。doc\-filesディレクトリを/home/user/src/java/doc\-filesに置かないでください。javaはパッケージではないからです。ソース・ファイルを含めることもできません。 -.PP -\fIjavadoc\fRコマンドはファイルを参照しないので、未処理のファイルへのすべてのリンクは、コードに含まれている必要があります。\fIjavadoc\fRコマンドはディレクトリとそのすべての内容を宛先にコピーします。次の例では、Button\&.javaドキュメンテーション・コメントのリンクがどのように見えるかを示しています。 +たとえば、ボタンのイメージを\fBjava\&.awt\&.Button\fRクラスのドキュメントに含める場合には、そのイメージ・ファイルを/home/user/src/java/awt/doc\-files/ディレクトリに置きます。doc\-filesディレクトリを/home/user/src/java/doc\-filesに置かないでください。javaはパッケージではないからです。ソース・ファイルを含めることもできません。 +.PP +\fBjavadoc\fRコマンドはファイルを参照しないので、未処理のファイルへのすべてのリンクは、コードに含まれている必要があります。\fBjavadoc\fRコマンドはディレクトリとそのすべての内容を宛先にコピーします。次の例では、Button\&.javaドキュメンテーション・コメントのリンクがどのように見えるかを示しています。 .sp .if n \{\ .RS 4 .\} .nf -/** - * This button looks like this: - * <img src="doc\-files/Button\&.gif"> - */ +\fB/**\fR +\fB * This button looks like this: \fR +\fB * <img src="doc\-files/Button\&.gif">\fR +\fB */\fR + .fi .if n \{\ .RE .\} .SS "テストおよびテンプレート・ファイル" .PP -ソース・ツリーのテストおよびテンプレート・ファイルを、ソース・ファイルが存在するディレクトリまたはサブディレクトリと同じディレクトリに格納できます。テストおよびテンプレート・ファイルが処理されるのを防ぐには、\fIjavadoc\fRコマンドを実行し、明示的に個別のソース・ファイル名を渡します。 -.PP -テスト・ファイルは、有効な、コンパイル可能なソース・ファイルです。テンプレート・ファイルは、有効な、互換性のあるソース・ファイルではありませんが、多くの場合、\fI\&.java\fR接尾辞を持っています。 -テスト・ファイル.PP -テスト・ファイルを、名前なしパッケージや、ソース・ファイルが存在するパッケージとは別のパッケージに属するようにする場合、テスト・ファイルをソース・ファイルの下のサブディレクトリに配置し、そのディレクトリに無効な名前を付けます。テスト・ファイルをソースと同じディレクトリに配置し、パッケージ名を示すコマンドライン引数を指定して\fIjavadoc\fRコマンドを呼び出すと、テスト・ファイルは警告またはエラーを引き起こします。ファイルが無効な名前を持つサブディレクトリ内に存在する場合、テスト・ファイル・ディレクトリはスキップされ、エラーまたは警告は発行されません。たとえば、ソース・ファイルのテスト・ファイルをcom\&.package1に追加するには、無効なパッケージ名のサブディレクトリに配置します。次のディレクトリ名にはハイフンが含まれているため無効です。 +ソース・ツリーのテストおよびテンプレート・ファイルを、ソース・ファイルが存在するディレクトリまたはサブディレクトリと同じディレクトリに格納できます。テストおよびテンプレート・ファイルが処理されるのを防ぐには、\fBjavadoc\fRコマンドを実行し、明示的に個別のソース・ファイル名を渡します。 +.PP +テスト・ファイルは、有効な、コンパイル可能なソース・ファイルです。テンプレート・ファイルは、有効な、互換性のあるソース・ファイルではありませんが、多くの場合、\fB\&.java\fR接尾辞を持っています。 +.PP +テスト・ファイル +.PP +テスト・ファイルを、名前なしパッケージや、ソース・ファイルが存在するパッケージとは別のパッケージに属するようにする場合、テスト・ファイルをソース・ファイルの下のサブディレクトリに配置し、そのディレクトリに無効な名前を付けます。テスト・ファイルをソースと同じディレクトリに配置し、パッケージ名を示すコマンド行引数を指定して\fBjavadoc\fRコマンドを呼び出すと、テスト・ファイルは警告またはエラーを引き起こします。ファイルが無効な名前を持つサブディレクトリ内に存在する場合、テスト・ファイル・ディレクトリはスキップされ、エラーまたは警告は発行されません。たとえば、ソース・ファイルのテスト・ファイルをcom\&.package1に追加するには、無効なパッケージ名のサブディレクトリに配置します。次のディレクトリ名にはハイフンが含まれているため無効です。 .sp .if n \{\ .RS 4 .\} .nf -com/package1/test\-files/ +\fBcom/package1/test\-files/\fR + .fi .if n \{\ .RE .\} .PP -テスト・ファイルにドキュメンテーション・コメントが含まれる場合、\fIjavadoc\fRコマンドの個別の実行で、ワイルドカードを含んだテスト・ソース・ファイル名(\fIcom/package1/test\-files/*\&.java\fRなど)を渡して、テスト・ファイルのドキュメントを生成するように設定できます。 -テンプレート・ファイル.PP -テンプレート・ファイルをソース・ディレクトリに配置するが、\fIjavadoc\fRコマンドを実行するときにエラーを生成しない場合、ファイルに\fIBuffer\-Template\&.java\fRなどの無効な名前を付けて、処理させないようにします。\fIjavadoc\fRコマンドは、接尾辞の\fI\&.java\fRが削除されると有効なクラス名になる名前を持つソース・ファイルのみを処理します。 +テスト・ファイルにドキュメンテーション・コメントが含まれる場合、\fBjavadoc\fRコマンドの個別の実行で、ワイルドカードを含んだテスト・ソース・ファイル名(\fBcom/package1/test\-files/*\&.java\fRなど)を渡して、テスト・ファイルのドキュメントを生成するように設定できます。 +.PP +テンプレート・ファイル +.PP +テンプレート・ファイルをソース・ディレクトリに配置するが、\fBjavadoc\fRコマンドを実行するときにエラーを生成しない場合、ファイルに\fBBuffer\-Template\&.java\fRなどの無効な名前を付けて、処理させないようにします。\fBjavadoc\fRコマンドは、接尾辞の\fB\&.java\fRが削除されると有効なクラス名になる名前を持つソース・ファイルのみを処理します。 .SH "生成されるファイル" .PP -デフォルトでは、\fIjavadoc\fRコマンドは、HTML形式のドキュメントを生成する標準ドックレットを使用します。標準ドックレットは、ここで説明する、基本内容ページ、相互参照ページ、サポート・ページを生成します。各HTMLページは個別のファイルに対応します。\fIjavadoc\fRコマンドは、2つのタイプのファイルを生成します。最初のタイプには、クラスおよびインタフェースに応じた名前が付けられます。2番目のタイプには、最初のタイプのファイルとの競合を防ぐために、ハイフンが含まれます(package\-summary\&.htmlなど)。 +デフォルトでは、\fBjavadoc\fRコマンドは、HTML形式のドキュメントを生成する標準ドックレットを使用します。標準ドックレットは、ここで説明する、基本内容ページ、相互参照ページ、サポート・ページを生成します。各HTMLページは個別のファイルに対応します。\fBjavadoc\fRコマンドは、2つのタイプのファイルを生成します。最初のタイプには、クラスおよびインタフェースに応じた名前が付けられます。2番目のタイプには、最初のタイプのファイルとの競合を防ぐために、ハイフンが含まれます(package\-summary\&.htmlなど)。 .SS "基本内容ページ" .sp .RS 4 @@ -509,7 +529,7 @@ .sp -1 .IP \(bu 2.3 .\} -記載されているパッケージごとに1つのパッケージ・ページ(package\-summary\&.html)。\fIjavadoc\fRコマンドは、ソース・ツリーのパッケージ・ディレクトリ内にあるpackage\&.htmlまたはpackage\-info\&.javaという名前のファイル内のHTMLテキストをすべて組み入れます。 +記載されているパッケージごとに1つのパッケージ・ページ(package\-summary\&.html)。\fBjavadoc\fRコマンドは、ソース・ツリーのパッケージ・ディレクトリ内にあるpackage\&.htmlまたはpackage\-info\&.javaという名前のファイル内のHTMLテキストをすべて組み入れます。 .RE .sp .RS 4 @@ -520,7 +540,7 @@ .sp -1 .IP \(bu 2.3 .\} -パッケージのセット全体に対して1つの概要ページ(overview\-summary\&.html)。概要ページは、生成ドキュメントの先頭ページになります。\fIjavadoc\fRコマンドは、\fI\-overview\fRオプションで指定されたファイル内のHTMLテキストをすべて組み入れます。概要ページが作成されるのは、\fIjavadoc\fRコマンドに複数のパッケージ名を渡した場合のみです。HTMLフレームおよびオプションを参照してください。 +パッケージのセット全体に対して1つの概要ページ(overview\-summary\&.html)。概要ページは、生成ドキュメントの先頭ページになります。\fBjavadoc\fRコマンドは、\fB\-overview\fRオプションで指定されたファイル内のHTMLテキストをすべて組み入れます。概要ページが作成されるのは、\fBjavadoc\fRコマンドに複数のパッケージ名を渡した場合のみです。HTMLフレームおよびオプションを参照してください。 .RE .SS "相互参照ページ" .sp @@ -587,9 +607,9 @@ .sp -1 .IP \(bu 2.3 .\} -直列化された形式ページ(serialized\-form\&.html)。フィールドおよびメソッドの説明を含む、直列化可能かつ外部化可能なクラスに関する情報用のページです。このページ内の情報は、APIを使用する開発者ではなく、再実装者に必要な情報です。直列化された形式ページへアクセスするには、直列化されたクラスに移動して、そのクラス・コメントにある「関連項目」セクションで「直列化された形式」をクリックします。標準ドックレットは直列化された形式ページを生成します。このページには、Serializableを実装するすべてのクラス(publicまたは非public)が、その\fIreadObject\fRや\fIwriteObject\fRメソッド、直列化されたフィールド、および\fI@serial\fR、\fI@serialField\fR、\fI@serialData\fRタグからのドキュメンテーション・コメントとともにリストされます。直列化可能なpublicクラスを除外するには、そのクラス(またはそのパッケージ)を\fI@serial\fR -excludeでマークします。直列化可能なpackage\-privateクラスを含めるには、そのクラス(またはそのパッケージ)を\fI@serial\fR -includeでマークします。リリース1\&.4では、\fI\-private\fRオプションを指定せずに\fIjavadoc\fRコマンドを実行することにより、publicクラスおよびprivateクラスの完全に直列化された形式を生成できます。オプションを参照してください。 +直列化された形式ページ(serialized\-form\&.html)。フィールドおよびメソッドの説明を含む、直列化可能かつ外部化可能なクラスに関する情報用のページです。このページ内の情報は、APIを使用する開発者ではなく、再実装者に必要な情報です。直列化された形式ページへアクセスするには、直列化されたクラスに移動して、そのクラス・コメントにある「関連項目」セクションで「直列化された形式」をクリックします。標準ドックレットは直列化された形式ページを生成します。このページには、Serializableを実装するすべてのクラス(publicまたは非public)が、その\fBreadObject\fRや\fBwriteObject\fRメソッド、直列化されたフィールド、および\fB@serial\fR、\fB@serialField\fR、\fB@serialData\fRタグからのドキュメンテーション・コメントとともにリストされます。直列化可能なpublicクラスを除外するには、そのクラス(またはそのパッケージ)を\fB@serial\fR +excludeでマークします。直列化可能なpackage\-privateクラスを含めるには、そのクラス(またはそのパッケージ)を\fB@serial\fR +includeでマークします。リリース1\&.4では、\fB\-private\fRオプションを指定せずに\fBjavadoc\fRコマンドを実行することにより、publicクラスおよびprivateクラスの完全に直列化された形式を生成できます。オプションを参照してください。 .RE .sp .RS 4 @@ -600,7 +620,7 @@ .sp -1 .IP \(bu 2.3 .\} -索引ページ(\fIindex\-*\&.html\fR)。すべてのクラス名、インタフェース名、コンストラクタ名、フィールド名、およびメソッド名がアルファベット順に並んでいます。索引ページは、Unicodeを扱えるように国際化されています。1つのファイルとして生成することも、先頭文字(英語の場合A\(enZ)ごとに別々のファイルとして生成することもできます。 +索引ページ(\fBindex\-*\&.html\fR)。すべてのクラス名、インタフェース名、コンストラクタ名、フィールド名、およびメソッド名がアルファベット順に並んでいます。索引ページは、Unicodeを扱えるように国際化されています。1つのファイルとして生成することも、先頭文字(英語の場合A\(enZ)ごとに別々のファイルとして生成することもできます。 .RE .SS "サポート・ページ" .sp @@ -612,7 +632,7 @@ .sp -1 .IP \(bu 2.3 .\} -ヘルプ・ページ(help\-doc\&.html)。ナビゲーション・バーや前述の各ページに関する説明が記載されています。デフォルトのヘルプ・ファイルを独自のカスタム・ヘルプ・ファイルでオーバーライドするには、\fI\-helpfile\fRを使用します。 +ヘルプ・ページ(help\-doc\&.html)。ナビゲーション・バーや前述の各ページに関する説明が記載されています。デフォルトのヘルプ・ファイルを独自のカスタム・ヘルプ・ファイルでオーバーライドするには、\fB\-helpfile\fRを使用します。 .RE .sp .RS 4 @@ -634,7 +654,7 @@ .sp -1 .IP \(bu 2.3 .\} -複数のフレーム・ファイル(\fI*\-frame\&.html\fR)。パッケージ、クラス、およびインタフェースのリストが含まれています。フレーム・ファイルはHTMLフレームを表示します。 +複数のフレーム・ファイル(\fB*\-frame\&.html\fR)。パッケージ、クラス、およびインタフェースのリストが含まれています。フレーム・ファイルはHTMLフレームを表示します。 .RE .sp .RS 4 @@ -645,7 +665,7 @@ .sp -1 .IP \(bu 2.3 .\} -パッケージ・リスト・ファイル(package\-list)。\fI\-link\fRおよび\fI\-linkoffline\fRオプションで使用されます。パッケージ・リスト・ファイルはテキスト・ファイルであり、どのリンクからもアクセスできません。 +パッケージ・リスト・ファイル(package\-list)。\fB\-link\fRおよび\fB\-linkoffline\fRオプションで使用されます。パッケージ・リスト・ファイルはテキスト・ファイルであり、どのリンクからもアクセスできません。 .RE .sp .RS 4 @@ -667,22 +687,22 @@ .sp -1 .IP \(bu 2.3 .\} -doc\-filesディレクトリ。宛先ディレクトリにコピーするイメージ、サンプル・コード、ソース・コードなどのファイルが格納されます。これらのファイルは、\fIjavadoc\fRコマンドによって処理されません。このディレクトリは、ソース・ツリーの中に存在する場合にのみ処理されます。 +doc\-filesディレクトリ。宛先ディレクトリにコピーするイメージ、サンプル・コード、ソース・コードなどのファイルが格納されます。これらのファイルは、\fBjavadoc\fRコマンドによって処理されません。このディレクトリは、ソース・ツリーの中に存在する場合にのみ処理されます。 .RE .PP オプションを参照してください。 .SS "HTMLフレーム" .PP -\fIjavadoc\fRコマンドは、コマンドに渡された値に基づき、最小限必要な数(2または3)のフレームを生成します。\fIjavadoc\fRコマンドに引数として1つのパッケージ名または1つのパッケージに含まれるソース・ファイルを渡す場合は、パッケージのリストが省略されます。そのかわりに、\fIjavadoc\fRコマンドは左側の列に1つのフレームを作成し、クラスのリストを表示します。複数のパッケージ名を渡した場合は、\fIjavadoc\fRコマンドは、すべてのパッケージをリストする第3のフレームと概要ページ(overview\-summary\&.html)を作成します。フレームを省略するには、「フレームなし」リンクをクリックするか、overview\-summary\&.htmlページからページ・セットを表示します。 +\fBjavadoc\fRコマンドは、コマンドに渡された値に基づき、最小限必要な数(2または3)のフレームを生成します。\fBjavadoc\fRコマンドに引数として1つのパッケージ名または1つのパッケージに含まれるソース・ファイルを渡す場合は、パッケージのリストが省略されます。そのかわりに、\fBjavadoc\fRコマンドは左側の列に1つのフレームを作成し、クラスのリストを表示します。複数のパッケージ名を渡した場合は、\fBjavadoc\fRコマンドは、すべてのパッケージをリストする第3のフレームと概要ページ(overview\-summary\&.html)を作成します。フレームを省略するには、「フレームなし」リンクをクリックするか、overview\-summary\&.htmlページからページ・セットを表示します。 .SS "生成されるファイルの構造" .PP 生成されるクラス・ファイルおよびインタフェース・ファイルは、Javaソース・ファイルおよびクラス・ファイルと同じディレクトリ階層に編成されます。1つのサブパッケージにつき1つのディレクトリ、という構造になります。 .PP -たとえば、\fIjava\&.applet\&.Applet\fRクラス用に生成されるドキュメントは、java/applet/Applet\&.htmlに格納されます。 -.PP -生成先ディレクトリの名前が\fIapidocs\fRだとすると、\fIjava\&.applet\fRパッケージのファイルの構造は、次のとおりです。前述のように、\fIframe\fRという語を名前に含むファイルは、すべて左上または左下のフレームに表示されます。それ以外のHTMLファイルは、すべて右側のフレームに表示されます。 -.PP -ディレクトリは太字です。アスタリスク(*)は、\fIjavadoc\fRコマンドへの引数がパッケージ名ではなくソース・ファイル名である場合に省略されるファイルおよびディレクトリを示しています。引数がソース・ファイル名の場合、空のパッケージ・リストが作成されます。doc\-filesディレクトリは、ソース・ツリー内に存在する場合にのみ、生成先に作成されます。生成されるファイルを参照してください。 +たとえば、\fBjava\&.applet\&.Applet\fRクラス用に生成されるドキュメントは、java/applet/Applet\&.htmlに格納されます。 +.PP +生成先ディレクトリの名前が\fBapidocs\fRだとすると、\fBjava\&.applet\fRパッケージのファイルの構造は、次のとおりです。前述のように、\fIframe\fRという語を名前に含むファイルは、すべて左上または左下のフレームに表示されます。それ以外のHTMLファイルは、すべて右側のフレームに表示されます。 +.PP +ディレクトリは太字です。アスタリスク(*)は、\fBjavadoc\fRコマンドへの引数がパッケージ名ではなくソース・ファイル名である場合に省略されるファイルおよびディレクトリを示しています。引数がソース・ファイル名の場合、空のパッケージ・リストが作成されます。doc\-filesディレクトリは、ソース・ツリー内に存在する場合にのみ、生成先に作成されます。生成されるファイルを参照してください。 .sp .RS 4 .ie n \{\ @@ -802,7 +822,7 @@ .IP \(bu 2.3 .\} index\-all\&.html: -\fI\-splitindex\fRオプションなしで作成されたデフォルトの索引 +\fB\-splitindex\fRオプションなしで作成されたデフォルトの索引 .RE .sp .RS 4 @@ -814,7 +834,7 @@ .IP \(bu 2.3 .\} \fBindex\-files\fR: -\fI\-splitindex\fRオプションを指定して作成されたディレクトリ +\fB\-splitindex\fRオプションを指定して作成されたディレクトリ .sp .RS 4 .ie n \{\ @@ -825,7 +845,7 @@ .IP \(bu 2.3 .\} index\-<number>\&.html: -\fI\-splitindex\fRオプションを指定して作成された索引ファイル +\fB\-splitindex\fRオプションを指定して作成された索引ファイル .RE .RE .sp @@ -881,7 +901,7 @@ .IP \(bu 2.3 .\} Applet\&.html: -\fIApplet\fRクラス・ページ +\fBApplet\fRクラス・ページ .RE .sp .RS 4 @@ -893,7 +913,7 @@ .IP \(bu 2.3 .\} AppletContext\&.html: -\fIAppletContext\fRインタフェース +\fBAppletContext\fRインタフェース .RE .sp .RS 4 @@ -905,7 +925,7 @@ .IP \(bu 2.3 .\} AppletStub\&.html: -\fIAppletStub\fRインタフェース +\fBAppletStub\fRインタフェース .RE .sp .RS 4 @@ -917,7 +937,7 @@ .IP \(bu 2.3 .\} AudioClip\&.html: -\fIAudioClip\fRインタフェース +\fBAudioClip\fRインタフェース .RE .sp .RS 4 @@ -988,13 +1008,13 @@ \- Applet\&.html: Appletクラスの使用 .sp \- AppletContext\&.html: -\fIAppletContext\fRインタフェースの使用 +\fBAppletContext\fRインタフェースの使用 .sp \- AppletStub\&.html: -\fIAppletStub\fRインタフェースの使用 +\fBAppletStub\fRインタフェースの使用 .sp \- AudioClip\&.html: -\fIAudioClip\fRインタフェースの使用 +\fBAudioClip\fRインタフェースの使用 .RE .RE .RE @@ -1032,62 +1052,65 @@ \- Applet\&.html: Appletソース・コード .sp \- AppletContext\&.html: -\fIAppletContext\fRソース・コード +\fBAppletContext\fRソース・コード .sp \- AppletStub\&.html: -\fIAppletStub\fRソース・コード +\fBAppletStub\fRソース・コード .sp \- AudioClip\&.html: -\fIAudioClip\fRソース・コード +\fBAudioClip\fRソース・コード .RE .RE .RE .SS "生成されるAPI宣言" .PP -\fIjavadoc\fRコマンドは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの記述の最初に、そのAPI用の宣言を生成します。たとえば、\fIBoolean\fRクラスの宣言は、次のようになります。 +\fBjavadoc\fRコマンドは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの記述の最初に、そのAPI用の宣言を生成します。たとえば、\fBBoolean\fRクラスの宣言は、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -public final class Boolean -extends Object -implements Serializable +\fBpublic final class Boolean\fR +\fBextends Object\fR +\fBimplements Serializable\fR + .fi .if n \{\ .RE .\} .PP -\fIBoolean\&.valueOf\fRメソッドの宣言は次のとおりです。 +\fBBoolean\&.valueOf\fRメソッドの宣言は次のとおりです。 .sp .if n \{\ .RS 4 .\} .nf -public static Boolean valueOf(String s) +\fBpublic static Boolean valueOf(String s)\fR + .fi .if n \{\ .RE .\} .PP -\fIjavadoc\fRコマンドは、修飾子\fIpublic\fR、\fIprotected\fR、\fIprivate\fR、\fIabstract\fR、\fIfinal\fR、\fIstatic\fR、\fItransient\fR、および\fIvolatile\fRを含めることができますが、\fIsynchronized\fRおよび\fInative\fRはできません。\fIsynchronized\fRおよび\fInative\fR修飾子は、実装の詳細とみなされているため、API仕様には含まれません。 -.PP -APIでは、並行性セマンティクスについて、キーワード\fIsynchronized\fRに依存するのではなく、コメントの主説明としてドキュメント化する必要があります。たとえば、「1つのenumerationを複数のスレッドから並行して使用することはできない」のように記述します。ドキュメントには、これらのセマンティクスを実現する方法を記述しないでください。たとえば、\fIHashtable\fRオプションはスレッドセーフである必要がありますが、「エクスポートされるすべてのメソッドを同期化してそれを実現する」のように指定する根拠はありません。より高度な並行性のために、バケット・レベルで内部的に同期化する権限を保有しておくことをお薦めします。 +\fBjavadoc\fRコマンドは、修飾子\fBpublic\fR、\fBprotected\fR、\fBprivate\fR、\fBabstract\fR、\fBfinal\fR、\fBstatic\fR、\fBtransient\fR、および\fBvolatile\fRを含めることができますが、\fBsynchronized\fRおよび\fBnative\fRはできません。\fBsynchronized\fRおよび\fBnative\fR修飾子は、実装の詳細とみなされているため、API仕様には含まれません。 +.PP +APIでは、並行性セマンティクスについて、キーワード\fBsynchronized\fRに依存するのではなく、コメントの主説明としてドキュメント化する必要があります。たとえば、「1つのenumerationを複数のスレッドから並行して使用することはできない」のように記述します。ドキュメントには、これらのセマンティクスを実現する方法を記述しないでください。たとえば、\fBHashtable\fRオプションはスレッドセーフである必要がありますが、「エクスポートされるすべてのメソッドを同期化してそれを実現する」のように指定する根拠はありません。より高度な並行性のために、バケット・レベルで内部的に同期化する権限を保有しておくことをお薦めします。 .SH "ドキュメンテーション・コメント" .PP このセクションでは、ソース・コードのコメントとコメントの継承について説明します。 .SS "ソース・コード・コメント" .PP -ソース・コードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、ドキュメンテーション・コメントを記述することができます。各パッケージにもドキュメンテーション・コメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーション・コメントを作成できます。ドキュメンテーション・コメントは、\fI/**\fRと、終わりを表す\fI*/\fRの間にある文字から構成されます。先頭のアスタリスクは各行で使用でき、次の項で詳しく説明します。コメントのテキストは、複数行にわたって記述できます。 +ソース・コードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、ドキュメンテーション・コメントを記述することができます。各パッケージにもドキュメンテーション・コメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーション・コメントを作成できます。ドキュメンテーション・コメントは、\fB/**\fRと、終わりを表す\fB*/\fRの間にある文字から構成されます。先頭のアスタリスクは各行で使用でき、次の項で詳しく説明します。コメントのテキストは、複数行にわたって記述できます。 .sp .if n \{\ .RS 4 .\} .nf -/** - * This is the typical format of a simple documentation comment - * that spans two lines\&. - */ +\fB/**\fR +\fB * This is the typical format of a simple documentation comment\fR +\fB * that spans two lines\&.\fR +\fB */\fR + .fi .if n \{\ .RE @@ -1099,105 +1122,125 @@ .RS 4 .\} .nf -/** This comment takes up only one line\&. */ +\fB/** This comment takes up only one line\&. */\fR + .fi .if n \{\ .RE .\} -コメントの配置.PP -ドキュメンテーション・コメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールド宣言の直前に配置される場合にのみ認識されます。メソッドの本体に置かれているドキュメンテーション・コメントは無視されます。\fIjavadoc\fRコマンドは、宣言文ごとに1つのドキュメンテーション・コメントしか認識しません。タグを使用できる場所を参照してください。 -.PP -よくある間違いは、クラス・コメントとクラス宣言の間に\fIimport\fR文を置いてしまうことです。\fIjavadoc\fRコマンドはクラス・コメントを無視するので、\fIimport\fR文をこの場所に配置しないでください。 +.PP +コメントの配置 +.PP +ドキュメンテーション・コメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールド宣言の直前に配置される場合にのみ認識されます。メソッドの本体に置かれているドキュメンテーション・コメントは無視されます。\fBjavadoc\fRコマンドは、宣言文ごとに1つのドキュメンテーション・コメントしか認識しません。タグを使用できる場所を参照してください。 +.PP +よくある間違いは、クラス・コメントとクラス宣言の間に\fBimport\fR文を置いてしまうことです。\fBjavadoc\fRコマンドはクラス・コメントを無視するので、\fBimport\fR文をこの場所に配置しないでください。 .sp .if n \{\ .RS 4 .\} .nf -/** - * This is the class comment for the class Whatever\&. - */ +\fB/**\fR +\fB * This is the class comment for the class Whatever\&.\fR +\fB */\fR +\fB \fR +\fBimport com\&.example; // MISTAKE \- Important not to put import statement here\fR +\fB \fR +\fBpublic class Whatever{ }\fR -import com\&.example; // MISTAKE \- Important not to put import statement here - -public class Whatever{ } .fi .if n \{\ .RE .\} -コメントのパーツ.PP -ドキュメンテーション・コメントには、主説明とその後に続くタグ・セクションが含まれます。主説明は、開始区切り文字\fI/**\fRで始まり、タグ・セクションまで続きます。タグ・セクションは、先頭文字が\fI@\fRの行で定義される最初のブロック・タグから始まります(先頭のアスタリスク、空白文字、先頭の区切り文字\fI/**\fRは除く)。主説明を記述せず、タグ・セクションのみのコメントを記述することもできます。主説明は、タグ・セクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1回しか記述できないタグがあります。たとえば、次の\fI@see\fRタグからタグ・セクションは始まります。 +.PP +コメントのパーツ +.PP +ドキュメンテーション・コメントには、主説明とその後に続くタグ・セクションが含まれます。主説明は、開始区切り文字\fB/**\fRで始まり、タグ・セクションまで続きます。タグ・セクションは、先頭文字が\fB@\fRの行で定義される最初のブロック・タグから始まります(先頭のアスタリスク、空白文字、先頭の区切り文字\fB/**\fRは除く)。主説明を記述せず、タグ・セクションのみのコメントを記述することもできます。主説明は、タグ・セクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1回しか記述できないタグがあります。たとえば、次の\fB@see\fRタグからタグ・セクションは始まります。 .sp .if n \{\ .RS 4 .\} .nf -/** - * This sentence holds the main description for this documentation comment\&. - * @see java\&.lang\&.Object - */ +\fB/**\fR +\fB * This sentence holds the main description for this documentation comment\&.\fR +\fB * @see java\&.lang\&.Object\fR +\fB */\fR + .fi .if n \{\ .RE .\} -ブロックおよびインライン・タグ.PP -タグは、\fIjavadoc\fRコマンドが処理するドキュメンテーション・コメント内の特殊なキーワードです。タグには2つのタイプがあります。1つは\fI@tag\fRタグのように表記されるブロック・タグ(スタンドアロン・タグとも呼ばれる)、もう1つは\fI{@tag}\fRタグのように中カッコで囲んで表記されるインライン・タグです。ブロック・タグが解釈されるには、行頭のアスタリスク、空白文字、区切り文字(\fI/**\fR)を除いて、行の先頭に置く必要があります。これは、\fI@\fR文字をテキスト内の別の場所で使用しても、タグの開始として解釈されないことを意味しています。\fI@\fR文字を使用して行を開始しても、それが解釈されないようにするには、HTMLエンティティ\fI@\fRを使用します。それぞれのブロック・タグには、関連付けられたテキストがあります。このテキストは、タグの後から、次のタグの前、またはドキュメンテーション・コメントの最後までの間に記述されたテキストです(タグまたはコメント区切り文字を除く)。この関連テキストは、複数行にわたって記述できます。インライン・タグは、テキストを記述できる場所であればどこにでも置くことができ、解釈されます。次の例にはブロック・タグ\fI@deprecated\fRとインライン・タグ\fI{@link}\fRが含まれています。javadocタグを参照してください。 +.PP +ブロックおよびインライン・タグ +.PP +タグは、\fBjavadoc\fRコマンドが処理するドキュメンテーション・コメント内の特殊なキーワードです。タグには2つのタイプがあります。1つは\fB@tag\fRタグのように表記されるブロック・タグ(スタンドアロン・タグとも呼ばれる)、もう1つは\fB{@tag}\fRタグのように中カッコで囲んで表記されるインライン・タグです。ブロック・タグが解釈されるには、行頭のアスタリスク、空白文字、区切り文字(\fB/**\fR)を除いて、行の先頭に置く必要があります。これは、\fB@\fR文字をテキスト内の別の場所で使用しても、タグの開始として解釈されないことを意味しています。\fB@\fR文字を使用して行を開始しても、それが解釈されないようにするには、HTMLエンティティ\fB@\fRを使用します。それぞれのブロック・タグには、関連付けられたテキストがあります。このテキストは、タグの後から、次のタグの前、またはドキュメンテーション・コメントの最後までの間に記述されたテキストです(タグまたはコメント区切り文字を除く)。この関連テキストは、複数行にわたって記述できます。インライン・タグは、テキストを記述できる場所であればどこにでも置くことができ、解釈されます。次の例にはブロック・タグ\fB@deprecated\fRとインライン・タグ\fB{@link}\fRが含まれています。javadocタグを参照してください。 .sp .if n \{\ .RS 4 .\} .nf -/** - * @deprecated As of JDK 1\&.1, replaced by {@link #setBounds(int,int,int,int)} - */ +\fB/**\fR +\fB * @deprecated As of JDK 1\&.1, replaced by {@link #setBounds(int,int,int,int)}\fR +\fB */\fR + .fi .if n \{\ .RE .\} -HTMLでのコメントの記述.PP +.PP +HTMLでのコメントの記述 +.PP テキストはHTMLエンティティとHTMLタグを使用してHTMLで記述される必要があります。使用するブラウザがサポートする任意のHTMLのバージョンを使用できます。標準ドックレットは、カスケーディング・スタイル・シートおよびフレームを含め、ドキュメンテーション・コメント以外の部分でHTML 3\&.2に準拠したコードを生成します。フレーム・セットのため、生成されたファイルにはHTML 4\&.0が推奨されます。 .PP -たとえば、より小さい記号(<)およびより大きい記号(>)のエンティティは、\fI<\fRおよび\fI>\fRと記述する必要があります。同様に、アンパサンド(&)は\fI&\fRと記述する必要があります。次の例では、太字のHTMLタグ\fI<b>\fRを使用しています。 +たとえば、より小さい記号(<)およびより大きい記号(>)のエンティティは、\fB<\fRおよび\fB>\fRと記述する必要があります。同様に、アンパサンド(&)は\fB&\fRと記述する必要があります。次の例では、太字のHTMLタグ\fB<b>\fRを使用しています。 .sp .if n \{\ .RS 4 .\} .nf -/** - * This is a <b>doc</b> comment\&. - * @see java\&.lang\&.Object - */ +\fB/**\fR +\fB * This is a <b>doc</b> comment\&.\fR +\fB * @see java\&.lang\&.Object\fR +\fB */\fR + .fi .if n \{\ .RE .\} -先頭のアスタリスク.PP -\fIjavadoc\fRコマンドによるドキュメンテーション・コメントの解析時に、各行の先頭にあるアスタリスク(*)文字は破棄されます。最初のアスタリスク(*)文字より前にある空白やタブも破棄されます。行頭のアスタリスクを省略した場合、インデントを保持したままでサンプル・コードを\fI<PRE>\fRタグ内のドキュメンテーション・コメントに直接貼り付けられるように、先頭の空白文字は削除されなくなります。ブラウザは、空白文字をタブよりも一律に解釈します。インデントの起点は(区切り文字\fI/**\fRまたは\fI<PRE>\fRタグではなく)左マージンになります。 -最初の文.PP -各ドキュメンテーション・コメントの最初の文は、宣言されているエンティティに関する簡潔かつ完全なサマリー文である必要があります。この文は、空白、タブ、または行終了文字が続く最初のピリオド、または最初のブロック・タグがある位置で終わります。最初の文は、\fIjavadoc\fRコマンドによってHTMLページの先頭にあるメンバーのサマリーの部分にコピーされます。 -複数フィールドの宣言.PP +.PP +先頭のアスタリスク +.PP +\fBjavadoc\fRコマンドによるドキュメンテーション・コメントの解析時に、各行の先頭にあるアスタリスク(*)文字は破棄されます。最初のアスタリスク(*)文字より前にある空白やタブも破棄されます。行頭のアスタリスクを省略した場合、インデントを保持したままでサンプル・コードを\fB<PRE>\fRタグ内のドキュメンテーション・コメントに直接貼り付けられるように、先頭の空白文字は削除されなくなります。ブラウザは、空白文字をタブよりも一律に解釈します。インデントの起点は(区切り文字\fB/**\fRまたは\fB<PRE>\fRタグではなく)左マージンになります。 +.PP +最初の文 +.PP +各ドキュメンテーション・コメントの最初の文は、宣言されているエンティティに関する簡潔かつ完全なサマリー文である必要があります。この文は、空白、タブ、または行終了文字が続く最初のピリオド、または最初のブロック・タグがある位置で終わります。最初の文は、\fBjavadoc\fRコマンドによってHTMLページの先頭にあるメンバーのサマリーの部分にコピーされます。 +.PP +複数フィールドの宣言 +.PP Javaプラットフォームでは、1つの文で複数のフィールドを宣言できます。ただし、この文には、1つのドキュメンテーション・コメントしか記述できません。そのコメントが、すべてのフィールドに対してコピーされます。フィールドごとにドキュメンテーション・コメントを記述する必要がある場合は、各フィールドを別々の文で宣言する必要があります。たとえば、次のドキュメンテーション・コメントは、1つの宣言として記述すると不適切です。この場合は、宣言を2つに分けることをお薦めします。 .sp .if n \{\ .RS 4 .\} .nf -/** - * The horizontal and vertical distances of point (x,y) - */ -public int x, y; // Avoid this - +\fB/** \fR +\fB * The horizontal and vertical distances of point (x,y)\fR +\fB */\fR +\fBpublic int x, y; // Avoid this \fR +\fB \fR .fi .if n \{\ .RE .\} .PP -\fIjavadoc\fRコマンドは、上のコードから次のようなドキュメントを生成します。 +\fBjavadoc\fRコマンドは、上のコードから次のようなドキュメントを生成します。 .sp .if n \{\ .RS 4 .\} .nf -public int x +\fBpublic int x\fR + .fi .if n \{\ .RE @@ -1209,31 +1252,38 @@ .RS 4 .\} .nf -public int y +\fBpublic int y\fR + .fi .if n \{\ .RE .\} .PP The horizontal and vertical distances of point (x, y)\&. -ヘッダー・タグの使用.PP -メンバーに対してドキュメンテーション・コメントを記述するときには、\fI<H1>\fRや\fI<H2>\fRなどのHTML見出しタグを使用しないことをお薦めします。\fIjavadoc\fRコマンドは、完全な構造化ドキュメントを作成するので、このような構造化タグが使用されていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しを使用して独自の構造を指定してかまいません。 +.PP +ヘッダー・タグの使用 +.PP +メンバーに対してドキュメンテーション・コメントを記述するときには、\fB<H1>\fRおよび\fB<H2>\fRなどのHTML見出しタグを使用しないことをお薦めします。\fBjavadoc\fRコマンドは、完全な構造化ドキュメントを作成するので、このような構造化タグが使用されていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しを使用して独自の構造を指定してかまいません。 .SS "メソッド・コメントの継承" .PP -\fIjavadoc\fRコマンドでは、クラスおよびインタフェースでメソッド・コメントを継承して、欠落したテキストを入力したり、明示的にメソッド・コメントを継承することができます。コンストラクタ、フィールド、およびネストされたクラスは、ドキュメンテーション・コメントを継承しません。 +\fBjavadoc\fRコマンドでは、クラスおよびインタフェースでメソッド・コメントを継承して、欠落したテキストを入力したり、明示的にメソッド・コメントを継承することができます。コンストラクタ、フィールド、およびネストされたクラスは、ドキュメンテーション・コメントを継承しません。 .PP \fB注意:\fR -ドキュメンテーション・コメントをコピーに利用するには、継承したメソッドのソース・ファイルが\fI\-sourcepath\fRオプションで指定したパスのみに置かれている必要があります。コマンドラインで、クラスもパッケージも渡す必要はありません。この点はリリース1\&.3\&.\fIn\fR以前とは対照的です。これまでは、クラスがドキュメント化されるクラスであることが必要でした。 -欠落テキストの入力.PP -主説明、または\fI@return\fR、\fI@param\fR、\fI@throws\fRタグがメソッド・コメントから欠落している場合、\fIjavadoc\fRコマンドは、対応する主説明またはタグ・コメントを、それがオーバーライドまたは実装しているメソッド(ある場合)からコピーします。メソッド・コメントの継承を参照してください。 -.PP -特定のパラメータの\fI@param\fRタグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の\fI@throws\fRタグが見つからない場合、その例外が宣言されている場合にかぎり、\fI@throws\fRタグがコピーされます。 +ドキュメンテーション・コメントをコピーに利用するには、継承したメソッドのソース・ファイルが\fB\-sourcepath\fRオプションで指定したパスのみに置かれている必要があります。コマンド行で、クラスもパッケージも渡す必要はありません。この点はリリース1\&.3\&.\fIn\fR以前とは対照的です。これまでは、クラスがドキュメント化されるクラスであることが必要でした。 +.PP +欠落テキストの入力 +.PP +主説明、または\fB@return\fR、\fB@param\fR、\fB@throws\fRタグがメソッド・コメントから欠落している場合、\fBjavadoc\fRコマンドは、対応する主説明またはタグ・コメントを、それがオーバーライドまたは実装しているメソッド(ある場合)からコピーします。メソッド・コメントの継承を参照してください。 +.PP +特定のパラメータの\fB@param\fRタグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の\fB@throws\fRタグが見つからない場合、その例外が宣言されている場合にかぎり、\fB@throws\fRタグがコピーされます。 .PP この動作はリリース1\&.3以前の動作とは対照的です。これまでのバージョンでは、主説明またはタグが存在すれば、コメントは一切継承されませんでした。 .PP javadocタグおよびオプションを参照してください。 -明示的な継承.PP -\fI{@inheritDoc}\fRインライン・タグをメソッドの主説明または\fI@return\fR、\fI@param\fR、\fI@throws\fRタグ・コメントに挿入します。対応する継承された主説明またはタグ・コメントは、その場所にコピーされます。 +.PP +明示的な継承 +.PP +\fB{@inheritDoc}\fRインライン・タグをメソッドの主説明または\fB@return\fR、\fB@param\fR、\fB@throws\fRタグ・コメントに挿入します。対応する継承された主説明またはタグ・コメントは、その場所にコピーされます。 .SS "クラスおよびインタフェースの継承" .PP コメントの継承は、クラスおよびインタフェースからの継承の、考えられるすべての場合に発生します。 @@ -1271,12 +1321,12 @@ クラスのメソッドがインタフェースのメソッドを実装している場合 .RE .PP -最初の2つのケースでは、\fIjavadoc\fRコマンドは、オーバーライドしているメソッドのドキュメント内に\fI「オーバーライド」\fRという小見出しを生成します。コメントが継承されているかどうかにかかわらず、オーバーライドされているメソッドへのリンクが含まれます。 -.PP -3つ目のケース(特定のクラスのメソッドがインタフェースのメソッドを実装している場合)では、\fIjavadoc\fRコマンドは、オーバーライドしているメソッドのドキュメント内に\fI「定義」\fRという小見出しを生成します。コメントが継承されているかどうかにかかわらず、実装されているメソッドへのリンクが含まれます。 +最初の2つのケースでは、\fBjavadoc\fRコマンドは、オーバーライドしているメソッドのドキュメント内に\fI「オーバーライド」\fRという小見出しを生成します。コメントが継承されているかどうかにかかわらず、オーバーライドされているメソッドへのリンクが含まれます。 +.PP +3つ目のケース(特定のクラスのメソッドがインタフェースのメソッドを実装している場合)では、\fBjavadoc\fRコマンドは、オーバーライドしているメソッドのドキュメント内に\fI「定義」\fRという小見出しを生成します。コメントが継承されているかどうかにかかわらず、実装されているメソッドへのリンクが含まれます。 .SS "メソッド・コメントのアルゴリズム" .PP -メソッドにドキュメンテーション・コメントがない、または\fI{@inheritDoc}\fRタグがある場合、\fIjavadoc\fRコマンドは次のアルゴリズムを使用して適用できるコメントを検索します。アルゴリズムは、最も特定される適用可能なドキュメンテーション・コメントを探し、スーパークラスよりもインタフェースを優先するように設計されています。 +メソッドにドキュメンテーション・コメントがない、または\fB{@inheritDoc}\fRタグがある場合、\fBjavadoc\fRコマンドは次のアルゴリズムを使用して適用できるコメントを検索します。アルゴリズムは、最も特定される適用可能なドキュメンテーション・コメントを探し、スーパークラスよりもインタフェースを優先するように設計されています。 .sp .RS 4 .ie n \{\ @@ -1286,7 +1336,7 @@ .sp -1 .IP " 1." 4.2 .\} -直接に実装されている(または、拡張されている)インタフェースを、メソッドの宣言で\fIimplements\fR(または\fIextends\fR)という語の後に出現する順序で、1つずつ調べます。このメソッドについて最初に見つかったドキュメンテーション・コメントを採用します。 +直接に実装されている(または、拡張されている)インタフェースを、メソッドの宣言で\fBimplements\fR(または\fBextends\fR)という語の後に出現する順序で、1つずつ調べます。このメソッドについて最初に見つかったドキュメンテーション・コメントを採用します。 .RE .sp .RS 4 @@ -1308,7 +1358,7 @@ .sp -1 .IP " 3." 4.2 .\} -手順2でドキュメンテーション・コメントが見つからなかった場合で、このクラスが\fIObject\fR以外のクラスであるが、インタフェースではない場合は、次のように処理します。 +手順2でドキュメンテーション・コメントが見つからなかった場合で、このクラスが\fBObject\fR以外のクラスであるが、インタフェースではない場合は、次のように処理します。 .sp .RS 4 .ie n \{\ @@ -1334,7 +1384,7 @@ .RE .SH "JAVADOCタグ" .PP -\fIjavadoc\fRコマンドは、Javaのドキュメンテーション・コメント内に埋め込まれた特別なタグを解析します。\fIjavadoc\fRタグを使用すると、完全な整形式のAPIをソース・コードから自動的に生成できます。タグはアットマーク記号(\fI@\fR)で始まり、大文字と小文字が区別されます。これらのタグは、表示されているとおりに大文字と小文字を使用して入力する必要があります。タグは、行の先頭(先頭の空白文字と省略可能なアスタリスクの後)に置く必要があります。そうしないと、テキストとして扱われます。慣例として、同じ名前のタグは1箇所にまとめます。たとえば、\fI@see\fRタグが複数ある場合は、すべて同じ場所にまとめて配置します。詳細は、タグを使用できる場所を参照してください。 +\fBjavadoc\fRコマンドは、Javaのドキュメンテーション・コメント内に埋め込まれた特別なタグを解析します。\fBjavadoc\fRタグを使用すると、完全な整形式のAPIをソース・コードから自動的に生成できます。タグはアットマーク記号(\fB@\fR)で始まり、大文字と小文字が区別されます。これらのタグは、表示されているとおりに大文字と小文字を使用して入力する必要があります。タグは、行の先頭(先頭の空白文字と省略可能なアスタリスクの後)に置く必要があります。そうしないと、テキストとして扱われます。慣例として、同じ名前のタグは1箇所にまとめます。たとえば、\fB@see\fRタグが複数ある場合は、すべて同じ場所にまとめて配置します。詳細は、タグを使用できる場所を参照してください。 .PP タグには、次のタイプがあります。 .sp @@ -1367,7 +1417,7 @@ .RS 4 JDK 1\&.0で導入 .sp -\fI\-author\fRオプションが使用されている場合、指定した名前のテキストの作成者エントリを生成されるドキュメントに追加します。1つのドキュメンテーション・コメントに複数の\fI@author\fRタグを含めることができます。1つの\fI@author\fRタグに1つの名前を指定することも、複数の名前を指定することもできます。前者の場合は、\fIjavadoc\fRコマンドによって名前と名前の間にカンマ(,)と空白文字が挿入されます。後者の場合は、テキスト全体が解析されることなく、生成ドキュメントにコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときに、1行に複数の名前を指定できます。JavadocツールでのDocコメントの記述方法の@authorに関する項 +\fB\-author\fRオプションが使用されている場合、指定した名前のテキストの作成者エントリを生成されるドキュメントに追加します。1つのドキュメンテーション・コメントに複数の\fB@author\fRタグを含めることができます。1つの\fB@author\fRタグに1つの名前を指定することも、複数の名前を指定することもできます。前者の場合は、\fBjavadoc\fRコマンドによって名前と名前の間にカンマ(,)と空白文字が挿入されます。後者の場合は、テキスト全体が解析されることなく、生成ドキュメントにコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときに、1行に複数の名前を指定できます。JavadocツールでのDocコメントの記述方法の@authorに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#@author)を参照してください。 .RE .PP @@ -1375,18 +1425,18 @@ .RS 4 JDK 1\&.5で導入 .sp -\fI<code>{@literal}</code>\fRと同等です。 -.sp -テキストをHTMLマークアップまたはネストされたJavadocタグとして解釈せずに、textをコード・フォントで表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\fI<Object>\fR)、不等号(\fI3 < 4\fR)、矢印(\fI<\-\fR)などで、通常の山カッコ(<および>)をHTMLエンティティ(\fI<\fRおよび\fI>\fR)のかわりに使用できます。たとえば、ドキュメンテーション・コメント\fI{@code A<B>C}\fRは\fIA<B>C\fRとして変更されずに生成されたHTMLページに表示されます。つまり、\fI<B>\fRが太字として解釈されず、そのフォントはコード・フォントになります。コード・フォントなしで同じ機能を実現するには、\fI{@literal}\fRタグを使用します。 +\fB<code>{@literal}</code>\fRと同等です。 +.sp +テキストをHTMLマークアップまたはネストされたJavadocタグとして解釈せずに、textをコード・フォントで表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\fB<Object>\fR)、不等号(\fB3 < 4\fR)、矢印(\fB<\-\fR)などで、通常の山カッコ(<および>)をHTMLエンティティ(\fB<\fRおよび\fB>\fR)のかわりに使用できます。たとえば、生成されたHTMLページに表示されるドキュメンテーション・コメント・テキスト\fB{@code A<B>C}\fRは、変更されず\fBA<B>C\fRとなります。つまり、\fB<B>\fRが太字として解釈されず、そのフォントはコード・フォントになります。コード・フォントなしで同じ機能を実現するには、\fB{@literal}\fRタグを使用します。 .RE .PP @deprecated \fIdeprecated\-text\fR .RS 4 JDK 1\&.0で導入 .sp -このAPIは動作し続けますが、このAPIを使用しないことを薦めるコメントを追加します。\fIjavadoc\fRコマンドは、\fIdeprecated\-text\fRを主説明の前に移動してイタリックにし、その前に太字の警告「推奨されていません。」を追加します。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 -.sp -非推奨テキストの最初の文では、そのAPIが推奨されなくなった時期と、代替として使用するAPIをユーザーに提示する必要があります。\fIjavadoc\fRコマンドは、この最初の文を、サマリー・セクションと索引にコピーします。その後の文で非推奨になった理由を説明することもできます。代替APIを指し示す\fI{@link}\fRタグ(Javadoc 1\&.2以降の場合)を含める必要があります。 +このAPIは動作し続けますが、このAPIを使用しないことを薦めるコメントを追加します。\fBjavadoc\fRコマンドは、\fBdeprecated\-text\fRを主説明の前に移動してイタリックにし、その前に太字の警告「推奨されていません。」を追加します。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 +.sp +非推奨テキストの最初の文では、そのAPIが推奨されなくなった時期と、代替として使用するAPIをユーザーに提示する必要があります。\fBjavadoc\fRコマンドは、この最初の文を、サマリー・セクションと索引にコピーします。その後の文で非推奨になった理由を説明することもできます。代替APIを指し示す\fB{@link}\fRタグ(Javadoc 1\&.2以降の場合)を含める必要があります。 .sp \fI@deprecated annotation\fRタグを使用してプログラム要素を非推奨にします。APIを非推奨にする方法と時期 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/deprecation/deprecation\&.html)を参照してください。 @@ -1402,7 +1452,7 @@ .sp 生成されるページからの、生成ドキュメントの(生成先)ルート・ディレクトリへの相対パスを表します。このタグは、著作権のページや会社のロゴなど、生成されるすべてのページから参照するファイルを組み込むときに便利です。通常は、各ページの最下部から著作権のページにリンクします。 .sp -この\fI{@docRoot}\fRタグは、コマンドラインでもドキュメンテーション・コメント内でも使用できます。このタグは、任意のタグ(\fI@return\fR、\fI@param\fRおよび\fI@deprecated\fRタグなど)のテキスト部分を含む、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 +この\fB{@docRoot}\fRタグは、コマンド行でもドキュメンテーション・コメント内でも使用できます。このタグは、任意のタグ(\fB@return\fR、\fB@param\fRおよび\fB@deprecated\fRタグなど)のテキスト部分を含む、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 .sp .RS 4 .ie n \{\ @@ -1412,9 +1462,9 @@ .sp -1 .IP \(bu 2.3 .\} -コマンドラインで、ヘッダー、フッターまたは最下部が次のように定義されます。\fIjavadoc \-bottom \*(Aq<a href="{@docRoot}/copyright\&.html">Copyright</a>\*(Aq\fR -.sp -\fI{@docRoot}\fRタグをmakefile内でこのように利用する場合、一部の\fImakefile\fRプログラムでは、中カッコ\fI{}\fR文字を特別にエスケープする必要があります。たとえば、Inprise MAKEバージョン5\&.2をWindows上で実行する場合は、\fI{{@docRoot}}\fRのように、中カッコを二重にする必要があります。\fI\-bottom\fRオプションなどのオプションへの引数を囲むのに、二重(一重ではなく)引用符も必要です(\fIhref\fR引数を囲む引用符は省略)。 +コマンド行で、header、footerまたはbottomが定義されている場合、\fBjavadoc \-bottom \*(Aq<a href="{@docRoot}/copyright\&.html">Copyright</a>\*(Aq\fRとなります。 +.sp +\fB{@docRoot}\fRタグをmakefile内でこのように利用する場合、一部の\fBmakefile\fRプログラムでは、中カッコ\fB{}\fR文字を特別にエスケープする必要があります。たとえば、Inprise MAKEバージョン5\&.2をWindows上で実行する場合は、\fB{{@docRoot}}\fRのように、中カッコを二重にする必要があります。\fB\-bottom\fRオプションなどのオプションへの引数を囲むのに、二重(一重ではなく)引用符も必要です(\fBhref\fR引数を囲む引用符は省略)。 .RE .sp .RS 4 @@ -1431,14 +1481,16 @@ .RS 4 .\} .nf -/** - * See the <a href="{@docRoot}/copyright\&.html">Copyright</a>\&. - */ +\fB/**\fR +\fB * See the <a href="{@docRoot}/copyright\&.html">Copyright</a>\&.\fR +\fB */\fR + .fi .if n \{\ .RE .\} -このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。式\fI<a href="{@docRoot}/copyright\&.html">\fRは、\fIjava/lang/Object\&.java\fRに対しては\fI<a href="\&.\&./\&.\&./copyright\&.html">\fRに解決され、\fIjava/lang/ref/Reference\&.java\fRに対しては\fI<a href="\&.\&./\&.\&./\&.\&./copyright\&.html">\fRに解決されます。 +このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。式: +\fB<a href="{@docRoot}/copyright\&.html">\fRは、\fBjava/lang/Object\&.java\fRの場合\fB<a href="\&.\&./\&.\&./copyright\&.html">\fRに、\fBjava/lang/ref/Reference\&.java\fRの場合\fB<a href="\&.\&./\&.\&./\&.\&./copyright\&.html">\fRに解決されます。 .RE .RE .PP @@ -1446,7 +1498,7 @@ .RS 4 JDK 1\&.0で導入 .sp -\fI@throws\fRタグと同じです。@throws class\-name descriptionを参照してください。 +\fB@throws\fRタグと同じです。@throws class\-name descriptionを参照してください。 .RE .PP {@inheritDoc} @@ -1476,7 +1528,7 @@ .sp -1 .IP \(bu 2.3 .\} -メソッドの\fI@return\fR、\fI@param\fR、\fI@throws\fRタグのテキスト引数内。この場合、タグ・テキストは、上位階層の対応するタグからコピーされます。 +メソッドの\fB@return\fR、\fB@param\fR、\fB@throws\fRタグのテキスト引数内。この場合、タグ・テキストは、上位階層の対応するタグからコピーされます。 .RE .sp 継承階層でコメントを見つける方法に関する説明は、メソッド・コメントの継承を参照してください。このタグが見つからない場合、コメントは、この項で説明するルールに応じて、自動的に継承されるかどうかが決まります。 @@ -1486,20 +1538,21 @@ .RS 4 JDK 1\&.2で導入 .sp -表示テキストlabelとともにインライン・リンクを挿入します。labelは、参照クラスの指定されたパッケージ、クラス、またはメンバーの名前のドキュメントを指し示します。このタグは、\fI@return\fR、\fI@param\fRおよび\fI@deprecated\fRタグなどの任意のタグのテキスト部分を含む、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。JavadocツールでのDocコメントの記述方法の@linkに関する項 +表示テキストlabelとともにインライン・リンクを挿入します。labelは、参照クラスの指定されたパッケージ、クラス、またはメンバーの名前のドキュメントを指し示します。このタグは、\fB@return\fR、\fB@param\fRおよび\fB@deprecated\fRタグなどの任意のタグのテキスト部分を含む、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。JavadocツールでのDocコメントの記述方法の@linkに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#{@link)を参照してください。 .sp -このタグは\fI@see\fRタグに似ています。どちらのタグも、\fIpackage\&.class#member\fRと\fIlabel\fRの参照方法と、有効な構文が同じです。主な違いは、\fI{@link}\fRタグでは、「関連項目」セクションにリンクが配置されるかわりに、インライン・リンクが生成されるという点です。インライン・テキストの他の部分と区別するために、\fI{@link}\fRタグの最初と最後に中カッコを記述します。ラベル内で右中カッコ(\fI}\fR)を使用する必要がある場合、HTMLエンティティ記法\fI}\fRを使用します。 -.sp -1つ文の中で使用できる\fI{@link}\fRタグの数に制限はありません。このタグは、ドキュメンテーション・コメントの主説明部分、または\fI@deprecated\fR、\fI@return\fR、\fI@param\fRタグなどの任意のタグのテキスト部分で使用できます。 -.sp -たとえば、次のコメントでは\fIgetComponentAt(int,int)\fRメソッドを参照しています。 +このタグは\fB@see\fRタグに似ています。どちらのタグも、\fBpackage\&.class#member\fRと\fBlabel\fRの参照方法と、有効な構文が同じです。主な違いは、\fB{@link}\fRタグでは、「関連項目」セクションにリンクが配置されるかわりに、インライン・リンクが生成されるという点です。インライン・テキストの他の部分と区別するために、\fB{@link}\fRタグの最初と最後に中カッコを記述します。ラベル内で右中カッコ(\fB}\fR)を使用する必要がある場合、HTMLエンティティ記法\fB}\fRを使用します。 +.sp +1つ文の中で使用できる\fB{@link}\fRタグの数に制限はありません。このタグは、ドキュメンテーション・コメントの主説明部分、または\fB@deprecated\fR、\fB@return\fR、\fB@param\fRタグなどの任意のタグのテキスト部分で使用できます。 +.sp +たとえば、次のコメントでは\fBgetComponentAt(int,int)\fRメソッドを参照しています。 .sp .if n \{\ .RS 4 .\} .nf -Use the {@link #getComponentAt(int, int) getComponentAt} method\&. +\fBUse the {@link #getComponentAt(int, int) getComponentAt} method\&.\fR + .fi .if n \{\ .RE @@ -1510,7 +1563,8 @@ .RS 4 .\} .nf -Use the <a href="Component\&.html#getComponentAt(int, int)">getComponentAt</a> method\&. +\fBUse the <a href="Component\&.html#getComponentAt(int, int)">getComponentAt</a> method\&.\fR + .fi .if n \{\ .RE @@ -1521,7 +1575,8 @@ .RS 4 .\} .nf -Use the getComponentAt method\&. +\fBUse the getComponentAt method\&.\fR + .fi .if n \{\ .RE @@ -1532,24 +1587,24 @@ .RS 4 JDK 1\&.4で導入 .sp -\fI{@link}\fRタグと同じ動作をしますが、リンク・ラベルがコード・フォントではなくプレーン・テキストで表示される点が異なります。ラベルがプレーン・テキストで記述されていると便利です。たとえば、「\fIRefer to {@linkplain add() the overridden method}\fR\&.」は「Refer to the overridden method」と表示されます。 +\fB{@link}\fRタグと同じ動作をしますが、リンク・ラベルがコード・フォントではなくプレーン・テキストで表示される点が異なります。ラベルがプレーン・テキストで記述されていると便利です。たとえば、「\fBRefer to {@linkplain add() the overridden method}\fR\&.」は「Refer to the overridden method」と表示されます。 .RE .PP {@literal \fItext\fR} .RS 4 JDK 1\&.5で導入 .sp -テキストをHTMLマークアップまたはネストされたJavadocタグとして解釈せずに、textを表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\fI<Object>\fR)、不等号(\fI3 < 4\fR)、矢印(<\-)などで、山カッコ(\fI<および>\fR)をHTMLエンティティ(\fI<\fRおよび\fI>\fR)のかわりに使用できます。たとえば、ドキュメンテーション・コメントのテキスト\fI{@literal A<B>C}\fRは\fIA<B>C\fRとして、ブラウザの生成されたHTMLページに変更されずに表示されます。\fI<B>\fRは太字として解釈されません(コード・フォントになりません)。コード・フォントで同じ機能を実現するには、\fI{@code}\fRタグを使用します。 +テキストをHTMLマークアップまたはネストされたJavadocタグとして解釈せずに、textを表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\fB<Object>\fR)、不等号(\fB3 < 4\fR)、矢印(<\-)などで、山カッコ(\fB<および>\fR)をHTMLエンティティ(\fB<\fRおよび\fB>\fR)のかわりに使用できます。たとえば、ドキュメンテーション・コメント・テキスト\fB{@literal A<B>C}\fRは、変更されずにブラウザに生成されたHTMLページに\fBA<B>C\fRと表示されます。\fB<B>\fRは太字として解釈されません(コード・フォントになりません)。コード・フォントで同じ機能を実現するには、\fB{@code}\fRタグを使用します。 .RE .PP @param \fIparameter\-name description\fR .RS 4 JDK 1\&.0で導入 .sp -「パラメータ」セクションに、指定された\fIparameter\-name\fRの後に指定されたdescriptionを続けてパラメータを追加します。ドキュメンテーション・コメントを記述するときには、descriptionを複数行にわたって記述することもできます。このタグは、メソッド、コンストラクタ、またはクラスのドキュメンテーション・コメント内でのみ有効です。JavadocツールでのDocコメントの記述方法の@paramに関する項 +「パラメータ」セクションに、指定された\fBparameter\-name\fRの後に指定されたdescriptionを続けてパラメータを追加します。ドキュメンテーション・コメントを記述するときには、descriptionを複数行にわたって記述することもできます。このタグは、メソッド、コンストラクタ、またはクラスのドキュメンテーション・コメント内でのみ有効です。JavadocツールでのDocコメントの記述方法の@paramに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#@param)を参照してください。 .sp -\fIparameter\-name\fRは、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタの型パラメータの名前になります。山カッコでこのパラメータ名を囲み、型パラメータを使用することを指定します。 +\fBparameter\-name\fRは、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタの型パラメータの名前になります。山カッコでこのパラメータ名を囲み、型パラメータを使用することを指定します。 .sp クラスの型パラメータの例: .sp @@ -1557,11 +1612,12 @@ .RS 4 .\} .nf -/** - * @param <E> Type of element stored in a list - */ -public interface List<E> extends Collection<E> { -} +\fB/**\fR +\fB * @param <E> Type of element stored in a list\fR +\fB */\fR +\fBpublic interface List<E> extends Collection<E> {\fR +\fB}\fR + .fi .if n \{\ .RE @@ -1572,14 +1628,15 @@ .RS 4 .\} .nf -/** - * @param string the string to be converted - * @param type the type to convert the string to - * @param <T> the type of the element - * @param <V> the value of the element - */ -<T, V extends T> V convert(String string, Class<T> type) { -} +\fB/**\fR +\fB * @param string the string to be converted\fR +\fB * @param type the type to convert the string to\fR +\fB * @param <T> the type of the element\fR +\fB * @param <V> the value of the element\fR +\fB */\fR +\fB<T, V extends T> V convert(String string, Class<T> type) {\fR +\fB}\fR + .fi .if n \{\ .RE @@ -1598,25 +1655,25 @@ .RS 4 JDK 1\&.0で導入 .sp -\fI「関連項目」\fR見出しを追加して、referenceを指すリンク、またはテキスト・エントリを書き込みます。1つのドキュメンテーション・コメントには任意の数の\fI@see\fRタグを含めることができますが、それらはすべて同じ見出しの下にグループ化されます。\fI@see\fRタグには、3つのタイプの形式があります。この形式が最も一般的です。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドで有効です。パッケージ、クラス、またはメンバーに対するインライン・リンクを文中に挿入する方法は、\fI{@link}\fRを参照してください。 +\fI「関連項目」\fR見出しを追加して、referenceを指すリンク、またはテキスト・エントリを書き込みます。1つのドキュメンテーション・コメントには任意の数の\fB@see\fRタグを含めることができますが、それらはすべて同じ見出しの下にグループ化されます。\fB@see\fRタグには、3つのタイプの形式があります。この形式が最も一般的です。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドで有効です。パッケージ、クラス、またはメンバーに対するインライン・リンクを文中に挿入する方法は、\fB{@link}\fRを参照してください。 .sp \fB形式1\fR。@see -\fIstring\fRタグ形式は、\fIstring\fRのテキスト・エントリを追加します。リンクは生成されません。stringは、書籍またはURLではアクセスできない情報の参照先です。\fIjavadoc\fRコマンドは、最初の文字として二重引用符(")を検索して、この形式を前述の形式と区別します。たとえば、\fI@see "The Java Programming Language"\fRは次のテキストを生成します。 +\fBstring\fRタグ形式は、\fIstring\fRのテキスト・エントリを追加します。リンクは生成されません。stringは、書籍またはURLではアクセスできない情報の参照先です。\fBjavadoc\fRコマンドは、最初の文字として二重引用符(")を検索して、この形式を前述の形式と区別します。たとえば、\fB@see "The Java Programming Language"\fRは次のテキストを生成します。 .sp \fB関連項目\fR: .sp "The Java Programming Language" .sp -\fB形式2\fR。\fI@see <a href="URL#value">label</a>\fR形式は、\fIURL#value\fRにより定義されたリンクを追加します。\fIURL#value\fRパラメータは、相対URLまたは絶対URLです。\fIjavadoc\fRコマンドは、最初の文字として「より小さい」記号(\fI<\fR)を検索して、この形式を他の形式と区別します。たとえば、\fI@see <a href="spec\&.html#section">Java Spec</a>\fRは次のリンクを生成します。 +\fB形式2\fR。\fB@see <a href="URL#value">label</a>\fR形式は、\fBURL#value\fRで定義されたリンクを追加します。\fBURL#value\fRパラメータは、相対URLまたは絶対URLです。\fBjavadoc\fRコマンドは、最初の文字として「より小さい」記号(\fB<\fR)を検索して、この形式を他の形式と区別します。たとえば、\fB@see <a href="spec\&.html#section">Java Spec</a>\fRは次のリンクを生成します。 .sp \fB関連項目\fR: .sp Java Spec .sp -\fB形式3\fR。\fI@see package\&.class#member label\fR形式は、表示テキスト・ラベルとともにリンクを追加します。このラベルは参照されているJava言語の指定された名前のドキュメントを指し示します。ラベルはオプションです。ラベルを省略した場合は、表示テキストのかわりに、名前が適切に短縮されて表示されます。\fI\-noqualifier\fRオプションを使用すると、この表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストにする場合に使用します。「名前が表示される方法」を参照してください。 -.sp -Java SE 1\&.2だけは、ラベルではなく名前が\fI<code>\fR -HTMLタグ内に自動的に表示されます。Java SE 1\&.2\&.2からは、ラベルを使用するかしないかにかかわらず、\fI<code>\fRタグは常に表示テキストを囲むかたちで含まれます。 +\fB形式3\fR。\fB@see package\&.class#member label\fR形式は、表示テキスト・ラベルとともにリンクを追加します。このラベルは参照されているJava言語の指定された名前のドキュメントを指し示します。ラベルはオプションです。ラベルを省略した場合は、表示テキストのかわりに、名前が適切に短縮されて表示されます。\fB\-noqualifier\fRオプションを使用すると、この表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストにする場合に使用します。「名前が表示される方法」を参照してください。 +.sp +Java SE 1\&.2だけは、ラベルではなく名前が\fB<code>\fR +HTMLタグ内に自動的に表示されます。Java SE 1\&.2\&.2からは、ラベルを使用するかしないかにかかわらず、\fB<code>\fRタグは常に表示テキストを囲むかたちで含まれます。 .sp .RS 4 .ie n \{\ @@ -1626,10 +1683,10 @@ .sp -1 .IP \(bu 2.3 .\} -\fIpackage\&.class#member\fRには、参照されている任意の有効なプログラム要素の名前を指定します。つまり、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの名前です。ただし、メンバー名の前の文字は、シャープ記号(\fI#\fR)にする必要があります。classは、任意のトップレベルまたはネストされたクラスか、インタフェースを表します。memberは、任意のコンストラクタ、メソッドまたはフィールドを表します(ネストされたクラスまたはインタフェースではありません)。この名前が、ドキュメント化されるクラスに含まれている場合、\fIjavadoc\fRコマンドは、その名前へのリンクを作成します。外部参照クラスへのリンクを作成するには、\fI\-link\fRオプションを使用します。参照クラスに属していない名前のドキュメントを参照するには、他の2つの\fI@see\fRタグ形式のどちらかを使用します。「名前の指定」を参照してください。 +\fBpackage\&.class#member\fRには、参照されている任意の有効なプログラム要素の名前を指定します。つまり、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの名前です。ただし、メンバー名の前の文字は、シャープ記号(\fB#\fR)にする必要があります。classは、任意のトップレベルまたはネストされたクラスか、インタフェースを表します。memberは、任意のコンストラクタ、メソッドまたはフィールドを表します(ネストされたクラスまたはインタフェースではありません)。この名前が、ドキュメント化されるクラスに含まれている場合、\fBjavadoc\fRコマンドは、その名前へのリンクを作成します。外部参照クラスへのリンクを作成するには、\fB\-link\fRオプションを使用します。参照クラスに属していない名前のドキュメントを参照するには、他の2つの\fB@see\fRタグ形式のどちらかを使用します。「名前の指定」を参照してください。 .sp \fB注意:\fR -外部参照クラスは、コマンドラインで\fIjavadoc\fRコマンドに渡されないクラスです。生成ドキュメント内で外部参照クラスにリンクしている箇所は、外部参照または外部リンクと呼ばれます。たとえば、\fIjava\&.awt package\fRに対してのみ\fIjavadoc\fRコマンドを実行した場合、\fIObject\fRなどの\fIjava\&.lang\fR内のすべてのクラスが外部参照クラスになります。\fI\-link\fRおよび\fI\-linkoffline\fRオプションを使用して、外部参照クラスへリンクします。外部参照クラスのソース・コメントは\fIjavadoc\fRコマンドの実行には使用できません。 +外部参照クラスは、コマンド行で\fBjavadoc\fRコマンドに渡されないクラスです。生成ドキュメント内で外部参照クラスにリンクしている箇所は、外部参照または外部リンクと呼ばれます。たとえば、\fBjava\&.awt package\fRに対してのみ\fBjavadoc\fRコマンドを実行した場合、\fBObject\fRなどの\fBjava\&.lang\fR内のすべてのクラスが外部参照クラスになります。\fB\-link\fRおよび\fB\-linkoffline\fRオプションを使用して、外部参照クラスへリンクします。外部参照クラスのソース・コメントは\fBjavadoc\fRコマンドの実行には使用できません。 .RE .sp .RS 4 @@ -1640,7 +1697,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIlabel\fRは、省略可能なテキストで、リンクのラベルとして表示されます。ラベルには空白を含めることができます。\fIlabel\fRを省略すると、\fIpackage\&.class\&.member\fRが、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。「名前が表示される方法」を参照してください。 +\fBlabel\fRは、省略可能なテキストで、リンクのラベルとして表示されます。ラベルには空白を含めることができます。\fBlabel\fRを省略すると、\fBpackage\&.class\&.member\fRが、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。「名前が表示される方法」を参照してください。 .RE .sp .RS 4 @@ -1651,18 +1708,19 @@ .sp -1 .IP \(bu 2.3 .\} -空白文字が、\fIpackage\&.class#member\fRと\fIlabel\fRの間の区切り文字になります。カッコの内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。 -.RE -.sp -この例では、\fI@see\fRタグ(\fICharacter\fRクラス内)が、\fIString\fRクラスのequalsメソッドを参照しています。タグには、名前\fIString#equals(Object)\fRとラベル\fIequals\fRの両方の引数が含まれています。 +空白文字が、\fBpackage\&.class#member\fRと\fBlabel\fRの間の区切り文字になります。カッコの内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。 +.RE +.sp +この例では、\fB@see\fRタグ(\fBCharacter\fRクラス内)が、\fBString\fRクラスのequalsメソッドを参照しています。タグには、名前\fBString#equals(Object)\fRとラベル\fBequals\fRの両方の引数が含まれています。 .sp .if n \{\ .RS 4 .\} .nf -/** - * @see String#equals(Object) equals - */ +\fB/**\fR +\fB * @see String#equals(Object) equals\fR +\fB */\fR + .fi .if n \{\ .RE @@ -1673,10 +1731,11 @@ .RS 4 .\} .nf -<dl> -<dt><b>See Also:</b> -<dd><a href="\&.\&./\&.\&./java/lang/String#equals(java\&.lang\&.Object)"><code>equals<code></a> -</dl> +\fB<dl>\fR +\fB<dt><b>See Also:</b>\fR +\fB<dd><a href="\&.\&./\&.\&./java/lang/String#equals(java\&.lang\&.Object)"><code>equals<code></a>\fR +\fB</dl>\fR + .fi .if n \{\ .RE @@ -1687,39 +1746,42 @@ .sp equals .RE -名前の指定.PP -この\fIpackage\&.class#member\fRという名前は、\fIjava\&.lang\&.String#toUpperCase()\fRのような完全修飾名にすることも、\fIString#toUpperCase()\fRや\fI#toUpperCase()\fRのような非完全修飾名にすることもできます。名前が完全修飾より短い場合は、\fIjavadoc\fRコマンドは、標準のJavaコンパイラの検索順序を使用して探します。「@seeタグの検索順序」を参照してください。名前は、メソッド引数の間など、カッコ内のスペースを含めることができます。部分的に修飾した短い名前を指定することの利点は、入力する文字数が減ることや、ソース・コードが読みやすくなることです。次のリストに様々な形式の名前を示します。ここで、\fIClass\fRにはクラスまたはインタフェースを、Typeにはクラス、インタフェース、配列、またはプリミティブを、methodにはメソッドまたはコンストラクタを、それぞれ指定できます。 +.PP +名前の指定 +.PP +この\fBpackage\&.class#member\fRという名前は、\fBjava\&.lang\&.String#toUpperCase()\fRのような完全修飾名にすることも、\fBString#toUpperCase()\fRや\fB#toUpperCase()\fRのような非完全修飾名にすることもできます。名前が完全修飾より短い場合は、\fBjavadoc\fRコマンドは、標準のJavaコンパイラの検索順序を使用して探します。「@seeタグの検索順序」を参照してください。名前は、メソッド引数の間など、カッコ内のスペースを含めることができます。部分的に修飾した短い名前を指定することの利点は、入力する文字数が減ることや、ソース・コードが読みやすくなることです。次のリストに様々な形式の名前を示します。ここで、\fBClass\fRにはクラスまたはインタフェースを、Typeにはクラス、インタフェース、配列、またはプリミティブを、methodにはメソッドまたはコンストラクタを、それぞれ指定できます。 .sp .if n \{\ .RS 4 .\} .nf -\fBTypical forms for\fR\fB @see package\&.class#member\fR -\fBReferencing a member of the current class\fR -@see #field -@see #method(Type, Type,\&.\&.\&.) -@see #method(Type argname, Type argname,\&.\&.\&.) -@see #constructor(Type, Type,\&.\&.\&.) -@see #constructor(Type argname, Type argname,\&.\&.\&.) - -\fBReferencing another class in the current or imported packages\fR -@see Class#field -@see Class#method(Type, Type,\&.\&.\&.) -@see Class#method(Type argname, Type argname,\&.\&.\&.) -@see Class#constructor(Type, Type,\&.\&.\&.) -@see Class#constructor(Type argname, Type argname,\&.\&.\&.) -@see Class\&.NestedClass -@see Class - -\fBReferencing an element in another package (fully qualified)\fR -@see package\&.Class#field -@see package\&.Class#method(Type, Type,\&.\&.\&.) -@see package\&.Class#method(Type argname, Type argname,\&.\&.\&.) -@see package\&.Class#constructor(Type, Type,\&.\&.\&.) -@see package\&.Class#constructor(Type argname, Type argname,\&.\&.\&.) -@see package\&.Class\&.NestedClass -@see package\&.Class -@see package +\fB\fBTypical forms for\fR\fR\fB\fB @see package\&.class#member\fR\fR\fB \fR +\fB\fBReferencing a member of the current class\fR\fR +\fB@see #field\fR +\fB@see #method(Type, Type,\&.\&.\&.)\fR +\fB@see #method(Type argname, Type argname,\&.\&.\&.)\fR +\fB@see #constructor(Type, Type,\&.\&.\&.)\fR +\fB@see #constructor(Type argname, Type argname,\&.\&.\&.) \fR + +\fB\fBReferencing another class in the current or imported packages\fR\fR +\fB@see Class#field\fR +\fB@see Class#method(Type, Type,\&.\&.\&.)\fR +\fB@see Class#method(Type argname, Type argname,\&.\&.\&.)\fR +\fB@see Class#constructor(Type, Type,\&.\&.\&.)\fR +\fB@see Class#constructor(Type argname, Type argname,\&.\&.\&.)\fR +\fB@see Class\&.NestedClass\fR +\fB@see Class \fR + +\fB\fBReferencing an element in another package (fully qualified)\fR\fR +\fB@see package\&.Class#field\fR +\fB@see package\&.Class#method(Type, Type,\&.\&.\&.)\fR +\fB@see package\&.Class#method(Type argname, Type argname,\&.\&.\&.)\fR +\fB@see package\&.Class#constructor(Type, Type,\&.\&.\&.)\fR +\fB@see package\&.Class#constructor(Type argname, Type argname,\&.\&.\&.)\fR +\fB@see package\&.Class\&.NestedClass\fR +\fB@see package\&.Class\fR +\fB@see package\fR + .fi .if n \{\ .RE @@ -1735,7 +1797,18 @@ .sp -1 .IP \(bu 2.3 .\} -最初のタイプの形式(パッケージとクラスを省略)の場合、\fIjavadoc\fRコマンドは、現在のクラスの階層のみを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、またはその外側を囲んでいるクラスかインタフェースからメンバーを検索します(検索項目1\(en3)。現在のパッケージの他の部分や、他のパッケージは検索しません(検索項目4\(en5)。「@seeタグの検索順序」を参照してください。 +最初のタイプの形式(パッケージとクラスを省略)の場合、\fBjavadoc\fRコマンドは、現在のクラスの階層のみを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、またはその外側を囲んでいるクラスかインタフェースからメンバーを検索します(検索項目1\(en3)。現在のパッケージの他の部分や、他のパッケージは検索しません(検索項目4\(en5)。「@seeタグの検索順序」を参照してください。 +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +メソッドまたはコンストラクタの入力時に、\fBgetValue\fRのようにカッコなしの名前を使用した場合、同じ名前のフィールドが存在していなければ、\fBjavadoc\fRコマンドはそのメソッドへのリンクを作成します。このメソッドがオーバーロードされている場合、\fBjavadoc\fRコマンドは、検索で最初に見つかったメソッドにリンクします。結果は前もって特定できません。 .RE .sp .RS 4 @@ -1746,7 +1819,7 @@ .sp -1 .IP \(bu 2.3 .\} -メソッドまたはコンストラクタの入力時に、\fIgetValue\fRのようにカッコなしの名前を使用した場合、同じ名前のフィールドが存在していなければ、\fIjavadoc\fRコマンドはそのメソッドへのリンクを作成します。このメソッドがオーバーロードされている場合、\fIjavadoc\fRコマンドは、検索で最初に見つかったメソッドにリンクします。結果は前もって特定できません。 +ネストされたクラスは、すべての形式について、\fBouter\&.inner\fRとして指定する必要があります。単純に\fBinner\fRとはしないでください。 .RE .sp .RS 4 @@ -1757,23 +1830,14 @@ .sp -1 .IP \(bu 2.3 .\} -ネストされたクラスは、すべての形式について、\fIouter\&.inner\fRとして指定する必要があります。単純に\fIinner\fRとはしないでください。 -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -すでに述べたように、クラスとメンバーとの間の区切り文字としては、ドット(\fI\&.\fR)ではなくシャープ記号(\fI#\fR)を使用します。このように指定すると、\fIjavadoc\fRコマンドは、あいまいさを解決できます。ドットは、クラス、ネストされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されるからです。ただし、\fIjavadoc\fRコマンドでは、あいまいさがなければドットは正しく解析されますが、警告は表示されます。 -.RE -@seeタグの検索順序.PP -\fIjavadoc\fRコマンドは、ソース・ファイル、パッケージ・ファイル、概要ファイルに表示される\fI@see\fRタグを処理します。後者の2つのファイルでは、完全修飾の名前を\fI@see\fRタグに指定する必要があります。ソース・ファイルでは、完全修飾の名前、または部分修飾の名前を指定できます。 -.PP -次に、\fI@see\fRタグの検索順序を示します。 +すでに述べたように、クラスとメンバーとの間の区切り文字としては、ドット(\fB\&.\fR)ではなくシャープ記号(\fB#\fR)を使用します。このように指定すると、\fBjavadoc\fRコマンドは、あいまいさを解決できます。ドットは、クラス、ネストされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されるからです。ただし、\fBjavadoc\fRコマンドでは、あいまいさがなければドットは正しく解析されますが、警告は表示されます。 +.RE +.PP +@seeタグの検索順序 +.PP +\fBjavadoc\fRコマンドは、ソース・ファイル、パッケージ・ファイル、概要ファイルに表示される\fB@see\fRタグを処理します。後者の2つのファイルでは、完全修飾の名前を\fB@see\fRタグに指定する必要があります。ソース・ファイルでは、完全修飾の名前、または部分修飾の名前を指定できます。 +.PP +次に、\fB@see\fRタグの検索順序を示します。 .sp .RS 4 .ie n \{\ @@ -1827,12 +1891,12 @@ .sp -1 .IP " 5." 4.2 .\} -インポートされているパッケージ、クラス、およびインタフェース(\fIimport\fR文の順序に従って検索)。 -.RE -.PP -\fIjavadoc\fRコマンドは、各クラスについて項目1\-3を再帰的に適用しながら、一致する名前が見つかるまで検索を続けます。つまり、まず現在のクラスを検索し、次にその外側を囲んでいるクラスEを検索した後、Eのスーパークラスを検索してから、Eを囲んでいるクラスを検索します。項目4と5では、\fIjavadoc\fRコマンドが1つのパッケージ内のクラスまたはインタフェースを検索する順序は決まっていません(その順序は、個々のコンパイラによって異なります)。項目5では、\fIjavadoc\fRコマンドは、\fIjava\&.lang\fRを検索します。このパッケージは、すべてのプログラムに自動的にインポートされるからです。 -.PP -\fIjavadoc\fRコマンドは、完全修飾でないソース・ファイルで\fI@see\fRタグを見つけると、Javaコンパイラと同じ順序で指定された名前を検索します(ただし、\fIjavadoc\fRコマンドは、特定の名前空間のあいまいさを検出しません。これは、ソース・コードにこれらのエラーが存在していないことを前提としているためです)。この検索順序は、Java言語仕様で正式に定義されています。\fIjavadoc\fRコマンドは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてからその名前を検索します。具体的には、次の順序で検索します。 +インポートされているパッケージ、クラス、およびインタフェース(\fBimport\fR文の順序に従って検索)。 +.RE +.PP +\fBjavadoc\fRコマンドは、各クラスについて項目1\-3を再帰的に適用しながら、一致する名前が見つかるまで検索を続けます。つまり、まず現在のクラスを検索し、次にその外側を囲んでいるクラスEを検索した後、Eのスーパークラスを検索してから、Eを囲んでいるクラスを検索します。項目4と5では、\fBjavadoc\fRコマンドが1つのパッケージ内のクラスまたはインタフェースを検索する順序は決まっていません(その順序は、個々のコンパイラによって異なります)。項目5では、\fBjavadoc\fRコマンドは、\fIjava\&.lang\fRを検索します。このパッケージは、すべてのプログラムに自動的にインポートされるからです。 +.PP +\fBjavadoc\fRコマンドは、完全修飾でないソース・ファイルで\fB@see\fRタグを見つけると、Javaコンパイラと同じ順序で指定された名前を検索します(ただし、\fBjavadoc\fRコマンドは、特定の名前空間のあいまいさを検出しません。これは、ソース・コードにこれらのエラーが存在していないことを前提としているためです)。この検索順序は、Java言語仕様で正式に定義されています。\fBjavadoc\fRコマンドは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてからその名前を検索します。具体的には、次の順序で検索します。 .sp .RS 4 .ie n \{\ @@ -1886,70 +1950,75 @@ .sp -1 .IP " 5." 4.2 .\} -インポートされているパッケージ、クラス、およびインタフェース(\fIimport\fR文の順序に従って検索)。 -.RE -.PP -\fIjavadoc\fRコマンドは、必ずしもサブクラスを検索するとは限りません。また、実行中に他のパッケージのドキュメントが生成される場合でも、他のパッケージを検索しません。たとえば、\fI@see\fRタグが\fIjava\&.awt\&.event\&.KeyEvent\fRクラス内に含まれていて、\fIjava\&.awt package\fR内のある名前を参照していても、そのクラスがインポートしないかぎり\fIjavadoc\fRコマンドはそのパッケージを検索しません。 -名前が表示される方法.PP -\fIlabel\fRを省略すると、\fIpackage\&.class\&.member\fRが表示されます。一般に、これは現在のクラスおよびパッケージに応じて適切に短縮されます。短縮されるとは、\fIjavadoc\fRコマンドにより必要最小限の名前のみが表示されるということです。たとえば、\fIString\&.toUpperCase()\fRメソッドに、同じクラスのメンバーへの参照と他のクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースのみです(次のリストを参照)。パッケージ名を全体的に削除するには、\fI\-noqualifier\fRオプションを使用します。 -.RS 4 -\fB参照のタイプ\fR: \fI@see\fRタグは同じクラス、同じパッケージのメンバーを参照します -.RE -.RS 4 -\fB例\fR: \fI@see String#toLowerCase()\fR -.RE -.RS 4 -\fB表示\fR: \fItoLowerCase()\fR \- パッケージおよびクラス名を省略します -.RE -.RS 4 -.RE -.RS 4 -\fB参照のタイプ\fR: \fI@see\fRタグは別のクラス、同じパッケージのメンバーを参照します -.RE -.RS 4 -\fB例\fR: \fI@see Character#toLowerCase(char)\fR -.RE -.RS 4 -\fB表示\fR: \fICharacter\&.toLowerCase(char)\fR \- パッケージ名を省略し、クラス名を含みます -.RE -.RS 4 -.RE -.RS 4 -\fB参照のタイプ\fR: \fI@see\fRタグは異なるクラス、異なるパッケージのメンバーを参照します -.RE -.RS 4 -\fB例\fR: \fI@see java\&.io\&.File#exists()\fR -.RE -.RS 4 -\fB表示\fR: \fIjava\&.io\&.File\&.exists()\fR \- パッケージおよびクラス名を含みます -.RE -.RS 4 -.RE -@seeタグの例.PP -右側のコメントは、\fI@see\fRタグが\fIjava\&.applet\&.Applet\fRなどの別のパッケージのクラス内にある場合に、名前がどのように表示されるかを示しています。JavadocツールでのDocコメントの記述方法の@seeに関する項 +インポートされているパッケージ、クラス、およびインタフェース(\fBimport\fR文の順序に従って検索)。 +.RE +.PP +\fBjavadoc\fRコマンドは、必ずしもサブクラスを検索するとは限りません。また、実行中に他のパッケージのドキュメントが生成される場合でも、他のパッケージを検索しません。たとえば、\fB@see\fRタグが\fBjava\&.awt\&.event\&.KeyEvent\fRクラス内に含まれていて、\fBjava\&.awt package\fR内のある名前を参照していても、そのクラスがインポートしないかぎり\fBjavadoc\fRコマンドはそのパッケージを検索しません。 +.PP +名前が表示される方法 +.PP +\fBlabel\fRを省略すると、\fBpackage\&.class\&.member\fRが表示されます。一般に、これは現在のクラスおよびパッケージに応じて適切に短縮されます。短縮されるとは、\fBjavadoc\fRコマンドにより必要最小限の名前のみが表示されるということです。たとえば、\fBString\&.toUpperCase()\fRメソッドに、同じクラスのメンバーへの参照と他のクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースのみです(次のリストを参照)。パッケージ名を全体的に削除するには、\fB\-noqualifier\fRオプションを使用します。 +.RS 4 +\fB参照のタイプ\fR: \fB@see\fRタグは同じクラス、同じパッケージのメンバーを参照します +.RE +.RS 4 +\fB例\fR: \fB@see String#toLowerCase()\fR +.RE +.RS 4 +\fB表示\fR: \fBtoLowerCase()\fR \- パッケージおよびクラス名を省略します +.RE +.RS 4 +.RE +.RS 4 +\fB参照のタイプ\fR: \fB@see\fRタグは別のクラス、同じパッケージのメンバーを参照します +.RE +.RS 4 +\fB例\fR: \fB@see Character#toLowerCase(char)\fR +.RE +.RS 4 +\fB表示\fR: \fBCharacter\&.toLowerCase(char)\fR \- パッケージ名を省略し、クラス名を含みます +.RE +.RS 4 +.RE +.RS 4 +\fB参照のタイプ\fR: \fB@see\fRタグは異なるクラス、異なるパッケージのメンバーを参照します +.RE +.RS 4 +\fB例\fR: \fB@see java\&.io\&.File#exists()\fR +.RE +.RS 4 +\fB表示\fR: \fBjava\&.io\&.File\&.exists()\fR \- パッケージおよびクラス名を含みます +.RE +.RS 4 +.RE +.PP +@seeタグの例 +.PP +右側のコメントは、\fB@see\fRタグが\fBjava\&.applet\&.Applet\fRなどの別のパッケージのクラス内にある場合に、名前がどのように表示されるかを示しています。JavadocツールでのDocコメントの記述方法の@seeに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#@see)を参照してください。 .sp .if n \{\ .RS 4 .\} .nf - See also: -@see java\&.lang\&.String // String -@see java\&.lang\&.String The String class // The String class -@see String // String -@see String#equals(Object) // String\&.equals(Object) -@see String#equals // String\&.equals(java\&.lang\&.Object) -@see java\&.lang\&.Object#wait(long) // java\&.lang\&.Object\&.wait(long) -@see Character#MAX_RADIX // Character\&.MAX_RADIX -@see <a href="spec\&.html">Java Spec</a> // Java Spec -@see "The Java Programming Language" // "The Java Programming Language" +\fB See also:\fR +\fB@see java\&.lang\&.String // String \fR +\fB@see java\&.lang\&.String The String class // The String class \fR +\fB@see String // String \fR +\fB@see String#equals(Object) // String\&.equals(Object) \fR +\fB@see String#equals // String\&.equals(java\&.lang\&.Object) \fR +\fB@see java\&.lang\&.Object#wait(long) // java\&.lang\&.Object\&.wait(long) \fR +\fB@see Character#MAX_RADIX // Character\&.MAX_RADIX \fR +\fB@see <a href="spec\&.html">Java Spec</a> // Java Spec \fR +\fB@see "The Java Programming Language" // "The Java Programming Language" \fR + .fi .if n \{\ .RE .\} .PP \fB注意:\fR -\fI@se\fR\fIe\fRタグを拡張してドキュメント化されないクラスにリンクするには、\fI\-link\fRオプションを使用します。 +\fB@se\fR\fBe\fRタグを拡張してドキュメント化されないクラスにリンクするには、\fB\-link\fRオプションを使用します。 .PP @serial \fIfield\-description\fR | include | exclude .RS 4 @@ -1961,11 +2030,11 @@ Oracleの直列化された形式の仕様にクラスを含める基準 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/serialized\-criteria\-137781\&.html)も参照してください .sp -\fIfield\-description\fR(省略可能)では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要な場合は、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式ページに追加します。相互参照ページを参照してください。 +\fBfield\-description\fR(省略可能)では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要な場合は、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式ページに追加します。相互参照ページを参照してください。 .sp クラスを直列化した後に直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。 .sp -\fIinclude\fRおよび\fIexclude\fR引数は、直列化された形式ページにクラスまたはパッケージを含めるか除外するかを示します。次のように機能します。 +\fBinclude\fRおよび\fBexclude\fR引数は、直列化された形式ページにクラスまたはパッケージを含めるか除外するかを示します。次のように機能します。 .sp .RS 4 .ie n \{\ @@ -1975,7 +2044,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fISerializable\fRを実装しているpublicまたはprotectedクラスは、そのクラス(またはそのクラスが属するパッケージ)が\fI@serial exclude\fRタグでマークされていないかぎり、含められます。 +\fBSerializable\fRを実装しているpublicまたはprotectedクラスは、そのクラス(またはそのクラスが属するパッケージ)が\fB@serial exclude\fRタグでマークされていないかぎり、含められます。 .RE .sp .RS 4 @@ -1986,87 +2055,89 @@ .sp -1 .IP \(bu 2.3 .\} -\fISerializable\fRを実装しているprivateまたはpackage\-privateクラスは、そのクラス(またはそのクラスが属するパッケージ)が\fI@serial include\fRタグでマークされていないかぎり、除外されます。 -.RE -.sp -たとえば、\fIjavax\&.swing\fRパッケージはpackage\&.htmlまたはpackage\-info\&.java内で\fI@serial\fR -\fIexclude\fRタグでマークされています。publicクラス\fIjava\&.security\&.BasicPermission\fRは\fI@serial exclude\fRタグでマークされています。package\-privateクラス\fIjava\&.util\&.PropertyPermissionCollection\fRは\fI@serial include\fRタグでマークされています。 -.sp -クラス・レベルの\fI@serial\fRタグはパッケージ・レベルの\fI@serial\fRタグをオーバーライドします。 +\fBSerializable\fRを実装しているprivateまたはpackage\-privateクラスは、そのクラス(またはそのクラスが属するパッケージ)が\fB@serial include\fRタグでマークされていないかぎり、除外されます。 +.RE +.sp +たとえば、\fBjavax\&.swing\fRパッケージはpackage\&.htmlまたはpackage\-info\&.java内で\fB@serial\fR +\fBexclude\fRタグでマークされています。publicクラス\fBjava\&.security\&.BasicPermission\fRは\fB@serial exclude\fRタグでマークされています。package\-privateクラス\fBjava\&.util\&.PropertyPermissionCollection\fRは\fB@serial include\fRタグでマークされています。 +.sp +クラス・レベルの\fB@serial\fRタグはパッケージ・レベルの\fB@serial\fRタグをオーバーライドします。 .RE .PP @serialData \fIdata\-description\fR .RS 4 JDK 1\&.2で導入 .sp -データの説明値を使用して、直列化された形式でのデータの型と順序をドキュメント化します。このデータには、\fIwriteObject\fRメソッドによって書き込まれる省略可能なデータ、および\fIExternalizable\&.writeExternal\fRメソッドによって書き込まれるすべてのデータ(ベース・クラスを含む)が含まれます。 -.sp -\fI@serialData\fRタグは、\fIwriteObject\fR、\fIreadObject\fR、\fIwriteExternal\fR、\fIreadExternal\fR、\fIwriteReplace\fRおよび\fIreadResolve\fRメソッドのドキュメンテーション・コメントで使用できます。 +データの説明値を使用して、直列化された形式でのデータの型と順序をドキュメント化します。このデータには、\fBwriteObject\fRメソッドによって書き込まれる省略可能なデータ、および\fBExternalizable\&.writeExternal\fRメソッドによって書き込まれるすべてのデータ(ベース・クラスを含む)が含まれます。 +.sp +\fB@serialData\fRタグは、\fBwriteObject\fR、\fBreadObject\fR、\fBwriteExternal\fR、\fBreadExternal\fR、\fBwriteReplace\fRおよび\fBreadResolve\fRメソッドのドキュメンテーション・コメントで使用できます。 .RE .PP @serialField \fIfield\-name\fR \fIfield\-type\fR \fIfield\-description\fR .RS 4 JDK 1\&.2で導入 .sp -\fISerializable\fRクラスの\fIserialPersistentFields\fRメンバーの\fIObjectStreamField\fRコンポーネントをドキュメント化します。\fIObjectStreamField\fRコンポーネントごとに1つの\fI@serialField\fRタグを使用します。 +\fBSerializable\fRクラスの\fBserialPersistentFields\fRメンバーの\fBObjectStreamField\fRコンポーネントをドキュメント化します。\fBObjectStreamField\fRコンポーネントごとに1つの\fB@serialField\fRタグを使用します。 .RE .PP @since \fIsince\-text\fR .RS 4 JDK 1\&.1で導入 .sp -生成ドキュメントに、指定された\fIsince\-text\fRの値の\fI「導入されたバージョン」\fR見出しを追加します。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドで有効です。このタグは、特定の変更または機能が、\fIsince\-text\fRの値によって指定されたソフトウェア・リリース以降、存在していることを意味します。たとえば、\fI@since 1\&.5\fRです。 -.sp -Javaプラットフォームのソース・コードの場合、\fI@since\fRタグは、JavaプラットフォームAPI仕様のバージョンを示します。ソース・コードがリファレンス実装に追加された時期を示すとは限りません。複数の\fI@since\fRタグを使用でき、複数の\fI@author\fRタグのように扱われます。プログラム要素が複数のAPIで使用される場合、複数のタグを使用できます。 +生成ドキュメントに、指定された\fBsince\-text\fRの値の\fI「導入されたバージョン」\fR見出しを追加します。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドで有効です。このタグは、特定の変更または機能が、\fBsince\-text\fRの値によって指定されたソフトウェア・リリース以降、存在していることを意味します。たとえば、\fB@since 1\&.5\fRです。 +.sp +Javaプラットフォームのソース・コードの場合、\fB@since\fRタグは、JavaプラットフォームAPI仕様のバージョンを示します。ソース・コードがリファレンス実装に追加された時期を示すとは限りません。複数の\fB@since\fRタグを使用でき、複数の\fB@author\fRタグのように扱われます。プログラム要素が複数のAPIで使用される場合、複数のタグを使用できます。 .RE .PP @throws \fIclass\-name\fR \fIdescription\fR .RS 4 JDK 1\&.2で導入 .sp -\fI@exception\fRタグと同じ動作をします。JavadocツールでのDocコメントの記述方法の@throwsに関する項 +\fB@exception\fRタグと同じ動作をします。JavadocツールでのDocコメントの記述方法の@throwsに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#@exception)を参照してください .sp -\fI@throws\fRタグは、生成ドキュメントに\fIThrows\fR小見出しを追加して、\fIclass\-name\fRおよび\fIdescription\fRテキストを書き込みます。\fIclass\-name\fRは、そのメソッドからスローされる可能性のある例外の名前です。このタグは、メソッド、コンストラクタのドキュメンテーション・コメント内でのみ有効です。このクラスが完全指定の名前で記述されていない場合、\fIjavadoc\fRコマンドは、検索順序に従ってクラスを探します。複数の\fI@throws\fRタグを、同じ例外または違う例外の指定したドキュメンテーション・コメントで使用できます。「@seeタグの検索順序」を参照してください。 -.sp -すべてのチェック済例外がドキュメント化されるようにするために、\fI@throws\fRタグがthrows節内の例外用に存在しない場合は、\fI@throws\fRタグでドキュメント化されたかのように、\fIjavadoc\fRコマンドによって例外がHTML出力に説明なしで追加されます。 -.sp -オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、\fI@throws\fRのドキュメントがそのメソッドからサブクラスにコピーされます。インタフェース・メソッドから実装メソッドにコピーされる場合も同様です。\fI{@inheritDoc}\fRタグを使用して、\fI@throws\fRタグがドキュメンテーションを継承するように強制できます。 +\fB@throws\fRタグは、生成ドキュメントに\fIThrows\fR小見出しを追加して、\fBclass\-name\fRおよび\fBdescription\fRテキストを書き込みます。\fIclass\-name\fRは、そのメソッドからスローされる可能性のある例外の名前です。このタグは、メソッド、コンストラクタのドキュメンテーション・コメント内でのみ有効です。このクラスが完全指定の名前で記述されていない場合、\fBjavadoc\fRコマンドは、検索順序に従ってクラスを探します。複数の\fB@throws\fRタグを、同じ例外または違う例外の指定したドキュメンテーション・コメントで使用できます。「@seeタグの検索順序」を参照してください。 +.sp +すべてのチェック済例外がドキュメント化されるようにするために、\fB@throws\fRタグがthrows節内の例外用に存在しない場合は、\fB@throws\fRタグでドキュメント化されたかのように、\fBjavadoc\fRコマンドによって例外がHTML出力に説明なしで追加されます。 +.sp +オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、\fB@throws\fRのドキュメントがそのメソッドからサブクラスにコピーされます。インタフェース・メソッドから実装メソッドにコピーされる場合も同様です。\fB{@inheritDoc}\fRタグを使用して、\fB@throws\fRタグがドキュメンテーションを継承するように強制できます。 .RE .PP {@value \fIpackage\&.class#field\fR} .RS 4 JDK 1\&.4で導入 .sp -定数の値を表示します。\fI{@value}\fRタグが静的フィールドのドキュメンテーション・コメントで引数なしで使用されている場合、その定数の値を表示します。 +定数の値を表示します。\fB{@value}\fRタグが静的フィールドのドキュメンテーション・コメントで引数なしで使用されている場合、その定数の値を表示します。 .sp .if n \{\ .RS 4 .\} .nf -/** - * The value of this constant is {@value}\&. - */ -public static final String SCRIPT_START = "<script>" +\fB/**\fR +\fB * The value of this constant is {@value}\&.\fR +\fB */\fR +\fBpublic static final String SCRIPT_START = "<script>"\fR + .fi .if n \{\ .RE .\} -任意のドキュメンテーション・コメント内で引数\fIpackage\&.class#field\fRありで使用された場合、\fI{@value}\fRタグは指定された定数の値を表示します。 +任意のドキュメンテーション・コメント内で引数\fBpackage\&.class#field\fRありで使用された場合、\fB{@value}\fRタグは指定された定数の値を表示します。 .sp .if n \{\ .RS 4 .\} .nf -/** - * Evaluates the script starting with {@value #SCRIPT_START}\&. - */ -public String evalScript(String script) {} +\fB/**\fR +\fB * Evaluates the script starting with {@value #SCRIPT_START}\&.\fR +\fB */\fR +\fBpublic String evalScript(String script) {}\fR + .fi .if n \{\ .RE .\} -引数\fIpackage\&.class#field\fRは、\fI@see\fRタグ引数と同一の形式になります。ただし、メンバーは静的フィールドである必要があります。 +引数\fBpackage\&.class#field\fRは、\fB@see\fRタグ引数と同一の形式になります。ただし、メンバーは静的フィールドである必要があります。 .sp これらの定数の値は「定数フィールド値」 (http://docs\&.oracle\&.com/javase/8/docs/api/constant\-values\&.html)にも表示されます @@ -2076,34 +2147,34 @@ .RS 4 JDK 1\&.0で導入 .sp -\fI\-version\fRオプションが使用されている場合、生成ドキュメントに\fI「バージョン」\fR小見出しを追加して、指定された\fIversion\-text\fRの値を書き込みます。このタグはこのコードが含まれるソフトウェアの現在のリリース番号を保持するためのものであるのに対し、\fI@since\fRタグは、このコードが導入されたリリース番号を保持します。\fIversion\-text\fRの値には、特別な内部構造はありません。JavadocツールでのDocコメントの記述方法の@versionに関する項 +\fB\-version\fRオプションが使用されている場合、生成ドキュメントに\fI「バージョン」\fR小見出しを追加して、指定された\fBversion\-text\fRの値を書き込みます。このタグはこのコードが含まれるソフトウェアの現在のリリース番号を保持するためのものであるのに対し、\fB@since\fRタグは、このコードが導入されたリリース番号を保持します。\fBversion\-text\fRの値には、特別な内部構造はありません。JavadocツールでのDocコメントの記述方法の@versionに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#@version)を参照してください .sp -1つのドキュメンテーション・コメントに複数の\fI@version\fRタグを含めることができます。必要に応じて、1つの\fI@version\fRタグに1つのリリース番号を指定することも、複数のリリース番号を指定することもできます。前者の場合は、\fIjavadoc\fRコマンドによって名前と名前の間にカンマ(,)と空白文字が挿入されます。後者の場合は、テキスト全体が解析されることなく、生成ドキュメントにコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときに、1行に複数の名前を指定できます。 +1つのドキュメンテーション・コメントに複数の\fB@version\fRタグを含めることができます。必要に応じて、1つの\fB@version\fRタグに1つのリリース番号を指定することも、複数のリリース番号を指定することもできます。前者の場合は、\fBjavadoc\fRコマンドによって名前と名前の間にカンマ(,)と空白文字が挿入されます。後者の場合は、テキスト全体が解析されることなく、生成ドキュメントにコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときに、1行に複数の名前を指定できます。 .RE .SH "タグを使用できる場所" .PP -ここでは、タグを使用できる場所について説明します。次のタグがすべてのドキュメンテーション・コメントで使用できます。\fI@see\fR、\fI@since\fR、\fI@deprecated\fR、\fI{@link}\fR、\fI{@linkplain}\fRおよび\fI{@docroot}\fR。 +ここでは、タグを使用できる場所について説明します。次のタグがすべてのドキュメンテーション・コメントで使用できます。\fB@see\fR、\fB@since\fR、\fB@deprecated\fR、\fB{@link}\fR、\fB{@linkplain}\fRおよび\fB{@docroot}\fR。 .SS "概要タグ" .PP 概要タグは、概要ページのドキュメンテーション・コメントで使用できるタグです(このドキュメンテーション・コメントは、通常overview\&.htmlという名前のソース・ファイル内にあります)。他のドキュメンテーション・コメントの場合と同様に、これらのタグは、主説明の後で使用する必要があります。 .PP \fB注意:\fR -Java SE 1\&.2では、概要ドキュメント内の\fI{@link}\fRタグに不具合があります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、\fI{@docRoot}\fRタグは、概要ドキュメント内では機能しません。 +Java SE 1\&.2では、概要ドキュメント内の\fB{@link}\fRタグにbugがあります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、\fB{@docRoot}\fRタグは、概要ドキュメント内では機能しません。 .PP 概要タグは、次のとおりです。 .PP @see reference || @since since\-text || @serialField field\-name field\-type field\-description || @author name\-text || @version version\-text || {@link package\&.class#member label} || {@linkplain package\&.class#member label} || {@docRoot} || .SS "パッケージ・タグ" .PP -パッケージ・タグは、パッケージのドキュメンテーション・コメントで使用できるタグで、ドキュメンテーション・コメントはpackage\&.htmlまたはpackage\-info\&.javaという名前のソース・ファイル内にあります。ここで使用できる\fI@serial\fRタグは、\fIinclude\fRまたは\fIexclude\fR引数を指定したもののみです。 +パッケージ・タグは、パッケージのドキュメンテーション・コメントで使用できるタグで、ドキュメンテーション・コメントはpackage\&.htmlまたはpackage\-info\&.javaという名前のソース・ファイル内にあります。ここで使用できる\fB@serial\fRタグは、\fBinclude\fRまたは\fBexclude\fR引数を指定したもののみです。 .PP パッケージ・タグは、次のとおりです。 .PP @see reference || @since since\-text || @serial field\-description | include | exclude || @author name\-text || @version version\-text || {@linkplain package\&.class#member label} || {@linkplain package\&.class#member label} || {@docRoot} || .SS "クラスおよびインタフェース・タグ" .PP -次に、クラスまたはインタフェースのドキュメンテーション・コメントで使用できるタグを示します。\fI@serial\fRタグは、\fIinclude\fRまたは\fIexclude\fR引数を指定して、クラスまたはインタフェースのドキュメンテーション内でのみ使用できます。 +次に、クラスまたはインタフェースのドキュメンテーション・コメントで使用できるタグを示します。\fB@serial\fRタグは、\fBinclude\fRまたは\fBexclude\fR引数を指定して、クラスまたはインタフェースのドキュメンテーション内でのみ使用できます。 .PP @see reference || @since since\-text || @deprecated deprecated\-text || @serial field\-description | include | exclude || @author name\-text || @version version\-text || {@link package\&.class#member label} || {@linkplain package\&.class#member label} || {@docRoot} || .PP @@ -2113,22 +2184,23 @@ .RS 4 .\} .nf -/** - * A class representing a window on the screen\&. - * For example: - * <pre> - * Window win = new Window(parent); - * win\&.show(); - * </pre> - * - * @author Sami Shaio - * @version 1\&.13, 06/08/06 - * @see java\&.awt\&.BaseWindow - * @see java\&.awt\&.Button - */ -class Window extends BaseWindow { - \&.\&.\&. -} +\fB/**\fR +\fB * A class representing a window on the screen\&.\fR +\fB * For example:\fR +\fB * <pre>\fR +\fB * Window win = new Window(parent);\fR +\fB * win\&.show();\fR +\fB * </pre>\fR +\fB *\fR +\fB * @author Sami Shaio\fR +\fB * @version 1\&.13, 06/08/06\fR +\fB * @see java\&.awt\&.BaseWindow\fR +\fB * @see java\&.awt\&.Button\fR +\fB */\fR +\fBclass Window extends BaseWindow {\fR +\fB \&.\&.\&.\fR +\fB}\fR + .fi .if n \{\ .RE @@ -2145,25 +2217,26 @@ .RS 4 .\} .nf - /** - * The X\-coordinate of the component\&. - * - * @see #getLocation() - */ - int x = 1263732; +\fB /**\fR +\fB * The X\-coordinate of the component\&.\fR +\fB *\fR +\fB * @see #getLocation()\fR +\fB */\fR +\fB int x = 1263732;\fR + .fi .if n \{\ .RE .\} .SS "コンストラクタとメソッド・タグ" .PP -次に、コンストラクタまたはメソッドのドキュメンテーション・コメントで使用できるタグを示します。ただし、\fI@return\fRはコンストラクタでは使用できず、 -\fI{@inheritDoc}\fRには制限があります。 +次に、コンストラクタまたはメソッドのドキュメンテーション・コメントで使用できるタグを示します。ただし、\fB@return\fRはコンストラクタでは使用できず、 +\fB{@inheritDoc}\fRには制限があります。 .PP @see reference || @since since\-text || @deprecated deprecated\-text || @param parameter\-name description || @return description || @throws class\-name description || @exception class\-name description || @serialData data\-description || {@link package\&.class#member label} || {@linkplain package\&.class#member label} || {@inheritDoc} || {@docRoot} .PP \fB注意:\fR -\fI@serialData\fRタグは、\fIwriteObject\fR、\fIreadObject\fR、\fIwriteExternal\fR、\fIreadExternal\fR、\fIwriteReplace\fRおよび\fIreadResolve\fRメソッドのドキュメンテーション・コメントでのみ使用できます。 +\fB@serialData\fRタグは、\fBwriteObject\fR、\fBreadObject\fR、\fBwriteExternal\fR、\fBreadExternal\fR、\fBwriteReplace\fRおよび\fBreadResolve\fRメソッドのドキュメンテーション・コメントでのみ使用できます。 .PP メソッド・コメントの例: .sp @@ -2171,27 +2244,28 @@ .RS 4 .\} .nf -/** - * Returns the character at the specified index\&. An index - * ranges from <code>0</code> to <code>length() \- 1</code> - * - * @param index the index of the desired character\&. - * @return the desired character\&. - * @exception StringIndexOutOfRangeException - * if the index is not in the range <code>0</code> - * to <code>length()\-1</code> - * @see java\&.lang\&.Character#charValue() - */ - public char charAt(int index) { - \&.\&.\&. - } +\fB/**\fR +\fB * Returns the character at the specified index\&. An index \fR +\fB * ranges from <code>0</code> to <code>length() \- 1</code>\fR +\fB *\fR +\fB * @param index the index of the desired character\&.\fR +\fB * @return the desired character\&.\fR +\fB * @exception StringIndexOutOfRangeException \fR +\fB * if the index is not in the range <code>0</code> \fR +\fB * to <code>length()\-1</code>\fR +\fB * @see java\&.lang\&.Character#charValue()\fR +\fB */\fR +\fB public char charAt(int index) {\fR +\fB \&.\&.\&.\fR +\fB }\fR + .fi .if n \{\ .RE .\} .SH "オプション" .PP -\fIjavadoc\fRコマンドは、ドックレットを使用して出力を決定します。\fIjavadoc\fRコマンドは、\fI\-doclet\fRオプションでカスタム・ドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使用します。\fIjavadoc\fRコマンドには、任意のドックレットとともに使用できるコマンドライン・オプションがあります。これらのオプションについては、Javadocオプションで説明します。標準ドックレットでは、この他に、いくつかの追加のコマンドライン・オプションが提供されます。これらのオプションについては、標準ドックレットのオプションで説明します。どのオプション名も、大文字と小文字が区別されません。ただし、オプションの引数では、大文字と小文字が区別されます。 +\fBjavadoc\fRコマンドは、ドックレットを使用して出力を決定します。\fBjavadoc\fRコマンドは、\fB\-doclet\fRオプションでカスタム・ドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使用します。\fBjavadoc\fRコマンドには、任意のドックレットとともに使用できるコマンド行オプションがあります。これらのオプションについては、Javadocオプションで説明します。標準ドックレットでは、この他に、いくつかの追加のコマンド行オプションが提供されます。これらのオプションについては、標準ドックレットのオプションで説明します。どのオプション名も、大文字と小文字が区別されません。ただし、オプションの引数では、大文字と小文字が区別されます。 .sp .RS 4 .ie n \{\ @@ -2218,39 +2292,44 @@ オプションは次のとおりです。 .PP \-1\&.1 || \-author || \-bootclasspath classpathlist || \-bottom text || \-breakiterator || \-charset name || \-classpath classpathlist || \-d directory || \-docencoding name || \-docfilesubdirs || \-doclet class || \-docletpath classpathlist || \-doctitle title || \-encoding || \-exclude packagename1:packagename2:\&.\&.\&. || \-excludedocfilessubdir name1:name2 || \-extdirs dirist || \-footer footer || \-group groupheading packagepattern:packagepattern || \-header header || \-help || \-helpfile path\efilename || \-Jflag || \-keywords || \-link extdocURL || \-linkoffline extdocURL packagelistLoc || \-linksource || \-locale language_country_variant || \-nocomment || \-nodeprecated || \-nodeprecatedlist || \-nohelp || \-noindex || \-nonavbar || \-noqualifier all | packagename1:packagename2\&.\&.\&. || \-nosince || \-notimestamp || \-notree || -\fI\-overview path/filename || \fR\-package || \-private || \-protected || \-public || \-quiet || \-serialwarn || \-source release || \-sourcepath sourcepathlist || \-sourcetab tablength || \-splitindex || -\fI\-stylesheet path/filename || \fR\-subpackages package1:package2:\&.\&.\&. || \-tag tagname:Xaoptcmf:"taghead" || \-taglet class || \-tagletpath tagletpathlist || \-title title || \-top || \-use || \-verbose || \-version || \-windowtitle title -.PP -次のオプションは、すべてのドックレットに使用可能なコアのJavadocオプションです。標準ドックレットでは、ドックレットの他の部分を提供します。\fI\-bootclasspath\fR、\fI\-breakiterator\fR、\fI\-classpath\fR、\fI\-doclet\fR、\fI\-docletpath\fR、\fI\-encoding\fR、\-\fIexclude\fR、\fI\-extdirs\fR、\fI\-help\fR、\fI\-locale\fR、\fI\-\fR\fIoverview\fR、\fI\-package\fR、\fI\-private\fR、\fI\-protected\fR、\fI\-public\fR、\fI\-quiet\fR、\fI\-source\fR、\fI\-sourcepath\fR、\fI\-subpackages\fRおよび\fI\-verbose\fR。 + +\-overview path/filename || +\-package || \-private || \-protected || \-public || \-quiet || \-serialwarn || \-source release || \-sourcepath sourcepathlist || \-sourcetab tablength || \-splitindex || + +\-stylesheet path/filename || + +||\-subpackages package1:package2:\&.\&.\&. || \-tag tagname:Xaoptcmf:"taghead" || \-taglet class || \-tagletpath tagletpathlist || \-title title || \-top || \-use || \-verbose || \-version || \-windowtitle title +.PP +次のオプションは、すべてのドックレットに使用可能なコアのJavadocオプションです。標準ドックレットでは、ドックレットの他の部分を提供します。\fB\-bootclasspath\fR、\fB\-breakiterator\fR、\fB\-classpath\fR、\fB\-doclet\fR、\fB\-docletpath\fR、\fB\-encoding\fR、\-\fBexclude\fR、\fB\-extdirs\fR、\fB\-help\fR、\fB\-locale\fR、\fB\-\fR\fBoverview\fR、\fB\-package\fR、\fB\-private\fR、\fB\-protected\fR、\fB\-public\fR、\fB\-quiet\fR、\fB\-source\fR、\fB\-sourcepath\fR、\fB\-subpackages\fRおよび\fB\-verbose\fR。 .SS "Javadocオプション" .PP \-overview \fIpath/filename \fR .RS 4 -\fIjavadoc\fRコマンドに対して、\fIpath/filename \fRで指定されたソース・ファイルから概要ドキュメント用のテキストを取得し、そのテキストを概要ページ(overview\-summary\&.html)に配置するように指定します。\fIpath/filename\fRは、現在のディレクトリからの相対パスです。 -.sp -\fIfilename\fRの値で任意の名前を使用し、pathで任意の配置先を指定できますが、通常はoverview\&.htmlという名前を付け、ソース・ツリー内の最上位パッケージ・ディレクトリを含むディレクトリに配置します。この場所に配置すると、パッケージをドキュメント化するときにpathを指定する必要がなくなります。これは、\fI\-sourcepath\fRオプションによってこのファイルが指し示されるからです。 -.sp -たとえば、\fIjava\&.lang\fRパッケージのソース・ツリーが/src/classes/java/lang/の場合、概要ファイルを/src/classes/overview\&.htmlに配置できます +\fBjavadoc\fRコマンドに対して、\fIpath/filename \fRで指定されたソース・ファイルから概要ドキュメント用のテキストを取得し、そのテキストを概要ページ(overview\-summary\&.html)に配置するように指定します。\fIpath/filename\fRは、現在のディレクトリからの相対パスです。 +.sp +\fBfilename\fRの値で任意の名前を使用し、pathで任意の配置先を指定できますが、通常はoverview\&.htmlという名前を付け、ソース・ツリー内の最上位パッケージ・ディレクトリを含むディレクトリに配置します。この場所に配置すると、パッケージをドキュメント化するときにpathを指定する必要がなくなります。これは、\fB\-sourcepath\fRオプションによってこのファイルが指し示されるからです。 +.sp +たとえば、\fBjava\&.lang\fRパッケージのソース・ツリーが/src/classes/java/lang/の場合、概要ファイルを/src/classes/overview\&.htmlに配置できます .sp 実際の例を参照してください。 .sp \fIpath/filename\fRで指定するファイルについては、概要コメント・ファイルを参照してください。 .sp -概要ページが作成されるのは、\fIjavadoc\fRコマンドに複数のパッケージ名を渡した場合のみです。詳細は、HTMLフレームを参照してください。概要ページのタイトルは、\fI\-doctitle\fRによって設定されます。 +概要ページが作成されるのは、\fBjavadoc\fRコマンドに複数のパッケージ名を渡した場合のみです。詳細は、HTMLフレームを参照してください。概要ページのタイトルは、\fB\-doctitle\fRによって設定されます。 .RE .PP \-Xdoclint:(all|none|[\-]\fI<group>\fR) .RS 4 不正な参照、アクセシビリティの欠落およびJavadocコメントの不足の警告をレポートし、無効なJavadoc構文および不足しているHTMLタグのエラーをレポートします。 .sp -このオプションにより、\fIjavadoc\fRコマンドは生成された出力に含まれるすべてのドキュメント・コメントをチェックします。通常どおり、標準オプション\fI\-public\fR、\fI\-protected\fR、\fI\-package\fRおよび\fI\-private\fRで生成された出力に含む項目を選択できます。 -.sp -\fI\-Xdoclint\fRが有効になっている場合は、\fIjavac\fRコマンドと同様にメッセージで問題がレポートされます。\fIjavadoc\fRコマンドは、メッセージ、ソース・ファイルのコピーおよびエラーが検出された正確な位置を指すキャレットを出力します。メッセージは、重大度、および生成されたドキュメントがバリデータを使用して実行された場合にエラーが発生する可能性に応じて、警告またはエラーになります。たとえば、不正な参照またはJavadocコメントの欠落は、\fIjavadoc\fRコマンドが無効なHTMLを生成する原因にならないため、これらの問題は警告としてレポートされます。構文エラーまたはHTML終了タグの欠落は、\fIjavadoc\fRコマンドが無効なHTMLを生成する原因になるため、これらの問題はエラーとしてレポートされます。 -.sp -デフォルトでは、\fI\-Xdoclint\fRオプションは有効になっています。オプション\fI\-Xdoclint:none\fRで無効にします。 -.sp -\fI\-Xdoclint\fRオプションでレポートされる内容は次のオプションで変更します。 +このオプションにより、\fBjavadoc\fRコマンドは生成された出力に含まれるすべてのドキュメント・コメントをチェックします。通常どおり、標準オプション\fB\-public\fR、\fB\-protected\fR、\fB\-package\fRおよび\fB\-private\fRで生成された出力に含む項目を選択できます。 +.sp +\fB\-Xdoclint\fRが有効になっている場合は、\fBjavac\fRコマンドと同様にメッセージで問題がレポートされます。\fBjavadoc\fRコマンドは、メッセージ、ソース・ファイルのコピーおよびエラーが検出された正確な位置を指すキャレットを出力します。メッセージは、重大度、および生成されたドキュメントがバリデータを使用して実行された場合にエラーが発生する可能性に応じて、警告またはエラーになります。たとえば、不正な参照またはJavadocコメントの欠落は、\fBjavadoc\fRコマンドが無効なHTMLを生成する原因にならないため、これらの問題は警告としてレポートされます。構文エラーまたはHTML終了タグの欠落は、\fBjavadoc\fRコマンドが無効なHTMLを生成する原因になるため、これらの問題はエラーとしてレポートされます。 +.sp +デフォルトでは、\fB\-Xdoclint\fRオプションは有効になっています。オプション\fB\-Xdoclint:none\fRで無効にします。 +.sp +\fB\-Xdoclint\fRオプションでレポートされる内容は次のオプションで変更します。 .sp .RS 4 .ie n \{\ @@ -2260,8 +2339,8 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-Xdoclint\fR\fI\fR\fI none\fR: -\fI\-Xdoclint\fRオプションを無効にします。 +\fB\-Xdoclint none\fR: +\fB\-Xdoclint\fRオプションを無効にします。 .RE .sp .RS 4 @@ -2272,7 +2351,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-Xdoclint\fR\fI\fR\fI \fR\fIgroup\fR: +\fB\-Xdoclint \fR\fIgroup\fR: \fIgroup\fRチェックを有効にします。 .RE .sp @@ -2284,7 +2363,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-Xdoclint\fR\fI\fR\fI all\fR: すべてのチェック・グループを有効にします。 +\fB\-Xdoclint all\fR: すべてのチェック・グループを有効にします。 .RE .sp .RS 4 @@ -2295,7 +2374,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-Xdoclint\fR\fI\fR\fI all,\fR\fI\-group\fR: +\fB\-Xdoclint all,\fR\fI\-group\fR: \fIgroup\fRチェック以外のすべてを有効にします。 .RE .sp @@ -2309,7 +2388,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIaccessibility\fR: アクセシビリティ・チェッカで検出する問題をチェックします(たとえば、\fI<table>\fRタグで指定されるno captionまたはsummary属性)。 +\fBaccessibility\fR: アクセシビリティ・チェッカで検出する問題をチェックします(たとえば、\fB<table>\fRタグで指定されるno captionまたはsummary属性)。 .RE .sp .RS 4 @@ -2320,7 +2399,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIhtml\fR: インライン要素へのブロック要素の挿入や終了タグを必要とする要素を終了しないなど、上位レベルHTMLの問題を検出します。ルールは、HTML 4\&.01仕様から導出されます。このタイプのチェックは、\fIjavadoc\fRコマンドを有効にして、ブラウザが受け入れる可能性のあるHTMLの問題を検出します。 +\fBhtml\fR: インライン要素へのブロック要素の挿入や終了タグを必要とする要素を終了しないなど、上位レベルHTMLの問題を検出します。ルールは、HTML 4\&.01仕様から導出されます。このタイプのチェックは、\fBjavadoc\fRコマンドを有効にして、ブラウザが受け入れる可能性のあるHTMLの問題を検出します。 .RE .sp .RS 4 @@ -2331,7 +2410,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fImissing\fR: 欠落しているJavadocコメントまたはタグをチェックします(たとえば、欠落しているコメントやクラス、または欠落している\fI@return\fRタグやメソッド上の同様のタグ)。 +\fBmissing\fR: 欠落しているJavadocコメントまたはタグをチェックします(たとえば、欠落しているコメントやクラス、または欠落している\fB@return\fRタグやメソッド上の同様のタグ)。 .RE .sp .RS 4 @@ -2342,7 +2421,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIreference\fR: JavadocタグのJava API要素の参照に関連する問題をチェックします(たとえば、\fI@see\fRで見つからない項目、または\fI@param\fRの後の不正な名前)。 +\fBreference\fR: JavadocタグのJava API要素の参照に関連する問題をチェックします(たとえば、\fB@see\fRで見つからない項目、または\fB@param\fRの後の不正な名前)。 .RE .sp .RS 4 @@ -2353,25 +2432,26 @@ .sp -1 .IP \(bu 2.3 .\} -\fIsyntax\fR: エスケープされていない山カッコ(\fI<\fRおよび\fI>\fR)やアンパサンド(\fI&\fR)、無効なJavadocタグなどの下位レベルの問題を確認します。 -.RE -.sp -\fI\-Xdoclint\fRオプションを複数回指定して、複数のカテゴリのエラーと警告をチェックするオプションを有効にできます。または、前のオプションを使用して、複数のエラーおよび警告カテゴリを指定できます。たとえば、次のコマンドのいずれかを使用して、\fIfilename\fRファイル内のHTML、構文およびアクセシビリティの問題をチェックします。 +\fBsyntax\fR: エスケープされていない山カッコ(\fB<\fRおよび\fB>\fR)やアンパサンド(\fB&\fR)、無効なJavadocタグなどの下位レベルの問題を確認します。 +.RE +.sp +\fB\-Xdoclint\fRオプションを複数回指定して、複数のカテゴリのエラーと警告をチェックするオプションを有効にできます。または、前のオプションを使用して、複数のエラーおよび警告カテゴリを指定できます。たとえば、次のコマンドのいずれかを使用して、\fIfilename\fRファイル内のHTML、構文およびアクセシビリティの問題をチェックします。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-Xdoclint:html \-Xdoclint:syntax \-Xdoclint:accessibility \fIfilename\fR -javadoc \-Xdoclint:html,syntax,accessibility \fIfilename\fR +\fBjavadoc \-Xdoclint:html \-Xdoclint:syntax \-Xdoclint:accessibility \fR\fB\fIfilename\fR\fR +\fBjavadoc \-Xdoclint:html,syntax,accessibility \fR\fB\fIfilename\fR\fR + .fi .if n \{\ .RE .\} \fB注意:\fR -\fIjavadoc\fRコマンドでは、これらのチェックの完全性は保証されません。具体的には、完全なHTMLコンプライアンス・チェッカではありません。\-\fIXdoclint\fRオプションの目的は、\fIjavadoc\fRコマンドを有効にして一般的なエラーの大半をレポートすることです。 -.sp -\fIjavadoc\fRコマンドは、無効な入力の修正を試行せず、レポートのみ行います。 +\fBjavadoc\fRコマンドでは、これらのチェックの完全性は保証されません。具体的には、完全なHTMLコンプライアンス・チェッカではありません。\-\fBXdoclint\fRオプションの目的は、\fBjavadoc\fRコマンドを有効にして一般的なエラーの大半をレポートすることです。 +.sp +\fBjavadoc\fRコマンドは、無効な入力の修正を試行せず、レポートのみ行います。 .RE .PP \-public @@ -2396,18 +2476,18 @@ .PP \-help .RS 4 -オンライン・ヘルプを表示します。\fIjavadoc\fRと\fIドックレット\fRのコマンドライン・オプションがリストされます。 +オンライン・ヘルプを表示します。\fBjavadoc\fRと\fBドックレット\fRのコマンド行オプションがリストされます。 .RE .PP \-doclet \fIclass\fR .RS 4 -ドキュメントの生成に使用するドックレットを起動するためのクラス・ファイルを指定します。完全修飾名を使用します。このドックレットにより、出力の内容と形式が定義されます。\fI\-doclet\fRオプションが使用されていない場合、\fIjavadoc\fRコマンドは、標準ドックレットを使用してデフォルトのHTML形式を生成します。このクラスには\fIstart(Root)\fRメソッドが含まれている必要があります。この起動クラスへのパスは\fI\-docletpath\fRオプションによって定義されます。ドックレットの概要 +ドキュメントの生成に使用するドックレットを起動するためのクラス・ファイルを指定します。完全修飾名を使用します。このドックレットにより、出力の内容と形式が定義されます。\fB\-doclet\fRオプションが使用されていない場合、\fBjavadoc\fRコマンドは、標準ドックレットを使用してデフォルトのHTML形式を生成します。このクラスには\fBstart(Root)\fRメソッドが含まれている必要があります。この起動クラスへのパスは\fB\-docletpath\fRオプションによって定義されます。ドックレットの概要 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/doclet/overview\&.html)を参照してください .RE .PP \-docletpath \fIclasspathlist\fR .RS 4 -\fI\-doclet\fRオプションで指定されたドックレット開始クラス・ファイル、およびそのクラスが依存するすべてのJARファイルへのパスを指定します。開始クラス・ファイルがJARファイル内にある場合、このオプションでJARファイルへのパスを指定します。絶対パスまたは現在のディレクトリからの相対パスを指定できます。\fIclasspathlist\fRに複数のパスやJARファイルが含まれる場合には、それらをSolarisの場合はコロン(:)で、Windowsの場合はセミコロン(;)でそれぞれ区切ります。目的のドックレット開始クラスがすでに検索パス内にある場合は、このオプションは不要です。ドックレットの概要 +\fB\-doclet\fRオプションで指定されたドックレット開始クラス・ファイル、およびそのクラスが依存するすべてのJARファイルへのパスを指定します。開始クラス・ファイルがJARファイル内にある場合、このオプションでJARファイルへのパスを指定します。絶対パスまたは現在のディレクトリからの相対パスを指定できます。\fBclasspathlist\fRに複数のパスやJARファイルが含まれる場合には、それらをSolarisの場合はコロン(:)で、Windowsの場合はセミコロン(;)でそれぞれ区切ります。目的のドックレット開始クラスがすでに検索パス内にある場合は、このオプションは不要です。ドックレットの概要 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/doclet/overview\&.html)を参照してください .RE .PP @@ -2418,7 +2498,7 @@ .PP \-source \fIrelease\fR .RS 4 -受け付けるソース・コードのリリースを指定します。\fIrelease\fRパラメータには次の値を指定できます。\fIjavac\fRコマンドでコードをコンパイルするときに使用する値に対応する\fIリリース\fRの値を使用します。 +受け付けるソース・コードのリリースを指定します。\fBrelease\fRパラメータには次の値を指定できます。\fBjavac\fRコマンドでコードをコンパイルするときに使用する値に対応する\fBリリース\fRの値を使用します。 .sp .RS 4 .ie n \{\ @@ -2428,7 +2508,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fBリリース値: 1\&.5\fR。\fIjavadoc\fRコマンドは、JDK 1\&.5で導入された総称および他の言語機能を含むコードを受け付けます。\fI\-source\fRオプションが使用されなかった場合のコンパイラのデフォルト動作は、1\&.5のものになります。 +\fBリリース値: 1\&.5\fR。\fBjavadoc\fRコマンドは、JDK 1\&.5で導入された総称および他の言語機能を含むコードを受け付けます。\fB\-source\fRオプションが使用されなかった場合のコンパイラのデフォルト動作は、1\&.5のものになります。 .RE .sp .RS 4 @@ -2439,7 +2519,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fBリリース値: 1\&.4\fR。\fIjavadoc\fRコマンドは、JDK 1\&.4で導入されたアサーションを含むコードを受け付けます。 +\fBリリース値: 1\&.4\fR。\fBjavadoc\fRコマンドは、JDK 1\&.4で導入されたアサーションを含むコードを受け付けます。 .RE .sp .RS 4 @@ -2450,26 +2530,29 @@ .sp -1 .IP \(bu 2.3 .\} -\fBリリース値: 1\&.3\fR。\fIjavadoc\fRコマンドは、JDK 1\&.3以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 +\fBリリース値: 1\&.3\fR。\fBjavadoc\fRコマンドは、JDK 1\&.3以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 .RE .RE .PP \-sourcepath \fIsourcepathlist\fR .RS 4 -パッケージ名または\fI\-subpackages\fRオプションを\fIjavadoc\fRコマンドに渡すときに、ソース・ファイルを見つけるための検索パスを指定します。 -\fI複数のパスはコロン(:)で区切ります。\fR\fIjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。このオプションを使用して、ドキュメント化されるソース・ファイルの位置のみでなく、それ自体はドキュメント化されないがドキュメント化されるソース・ファイルから継承されたコメントを持つソース・ファイルの位置も確認できます。 -.sp -\fI\-sourcepath\fRオプションを使用できるのは、\fIjavadoc\fRコマンドにパッケージ名を渡す場合のみです。\fIjavadoc\fRコマンドに渡されるソース・ファイルは検索されません。ソース・ファイルを特定するには、そのディレクトリに移動するか、「1つ以上のクラスのドキュメント化」に示すように各ファイルの前にパスを含めます。\fI\-sourcepath\fRが省略された場合、\fIjavadoc\fRコマンドは、クラス・パスを使用してソース・ファイルを検索します(\fI\-classpath\fRを参照)。デフォルトの\fI\-sourcepath\fRは、クラス・パスの値です。\fI\-classpath\fRを省略してパッケージ名を\fIjavadoc\fRコマンドに渡すと、\fIjavadoc\fRコマンドは現在のディレクトリ(およびそのサブディレクトリ)からソース・ファイルを検索します。 -.sp -\fIsourcepathlist\fRには、ドキュメント化するパッケージのソース・ツリーのルート・ディレクトリを設定します。 -.sp -たとえば、\fIcom\&.mypackage\fRという名前のパッケージをドキュメント化する場合に、そのソース・ファイルが/home/user/src/com/mypackage/*\&.javaにあるとします。ソース・パスをcom\emypackageが含まれるディレクトリ/home/user/srcに指定してから、次のように、パッケージ名を指定します。 +パッケージ名または\fB\-subpackages\fRオプションを\fBjavadoc\fRコマンドに渡すときに、ソース・ファイルを見つけるための検索パスを指定します。 + +複数のパスはコロン(:)で区切ります。 +\fBjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。このオプションを使用して、ドキュメント化されるソース・ファイルの位置のみでなく、それ自体はドキュメント化されないがドキュメント化されるソース・ファイルから継承されたコメントを持つソース・ファイルの位置も確認できます。 +.sp +\fB\-sourcepath\fRオプションを使用できるのは、\fBjavadoc\fRコマンドにパッケージ名を渡す場合のみです。\fBjavadoc\fRコマンドに渡されるソース・ファイルは検索されません。ソース・ファイルを特定するには、そのディレクトリに移動するか、「1つ以上のクラスのドキュメント化」に示すように各ファイルの前にパスを含めます。\fB\-sourcepath\fRが省略された場合、\fBjavadoc\fRコマンドは、クラス・パスを使用してソース・ファイルを検索します(\fB\-classpath\fRを参照)。デフォルトの\fB\-sourcepath\fRは、クラス・パスの値です。\fB\-classpath\fRを省略してパッケージ名を\fBjavadoc\fRコマンドに渡すと、\fBjavadoc\fRコマンドは現在のディレクトリ(およびそのサブディレクトリ)からソース・ファイルを検索します。 +.sp +\fBsourcepathlist\fRには、ドキュメント化するパッケージのソース・ツリーのルート・ディレクトリを設定します。 +.sp +たとえば、\fBcom\&.mypackage\fRという名前のパッケージをドキュメント化する場合に、そのソース・ファイルが/home/user/src/com/mypackage/*\&.javaにあるとします。ソース・パスをcom\emypackageが含まれるディレクトリ/home/user/srcに指定してから、次のように、パッケージ名を指定します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-sourcepath /home/user/src/ com\&.mypackage +\fBjavadoc \-sourcepath /home/user/src/ com\&.mypackage\fR + .fi .if n \{\ .RE @@ -2484,7 +2567,8 @@ .RS 4 .\} .nf -javadoc \-sourcepath /home/user1/src:/home/user2/src com\&.mypackage +\fBjavadoc \-sourcepath /home/user1/src:/home/user2/src com\&.mypackage\fR + .fi .if n \{\ .RE @@ -2493,43 +2577,47 @@ .PP \-classpath \fIclasspathlist\fR .RS 4 -\fIjavadoc\fRコマンドが参照クラスの検索を行うときに使用するパスを指定します。参照クラスとは、ドキュメント化されるクラスと、それらのクラスによって参照されるすべてのクラスのことです。 -\fI複数のパスはコロン(:)で区切ります。\fR\fIjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。\fIclasspathlist\fRの値を指定するときは、クラス・パスのドキュメントにある指示に従ってください。 -.sp -\fI\-sourcepath\fRが省略された場合、\fIjavadoc\fRコマンドは\fI\-classpath\fRを使用して、ソース・ファイルおよびクラス・ファイルを検索します(下位互換性のため)。ソース・ファイルとクラス・ファイルを別々のパスから検索する必要がある場合は、\fI\-sourcepath\fRと\fI\-classpath\fRの両方を使用します。 -.sp -たとえば、\fIcom\&.mypackage\fRをドキュメント化する場合に、そのソース・ファイルがディレクトリ/home/user/src/com/mypackageにあり、このパッケージが/home/user/libthen内のライブラリに依存しているとき、次のように指定します。 +\fBjavadoc\fRコマンドが参照クラスの検索を行うときに使用するパスを指定します。参照クラスとは、ドキュメント化されるクラスと、それらのクラスによって参照されるすべてのクラスのことです。 + +複数のパスはコロン(:)で区切ります。 +\fBjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。\fBclasspathlist\fRの値を指定するときは、クラス・パスのドキュメントにある指示に従ってください。 +.sp +\fB\-sourcepath\fRが省略された場合、\fBjavadoc\fRコマンドは\fB\-classpath\fRを使用して、ソース・ファイルおよびクラス・ファイルを検索します(後方互換性のため)。ソース・ファイルとクラス・ファイルを別々のパスから検索する必要がある場合は、\fB\-sourcepath\fRと\fB\-classpath\fRの両方を使用します。 +.sp +たとえば、\fBcom\&.mypackage\fRをドキュメント化する場合に、そのソース・ファイルがディレクトリ/home/user/src/com/mypackageにあり、このパッケージが/home/user/lib内のライブラリに依存しているとき、次のように指定します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-sourcepath /home/user/lib \-classpath /home/user/src com\&.mypackage +\fBjavadoc \-sourcepath /home/user/lib \-classpath /home/user/src com\&.mypackage\fR + .fi .if n \{\ .RE .\} -他のツールと同様に、\fI\-classpath\fRが指定されていない場合、\fICLASSPATH\fR環境変数が設定されていれば、\fIjavadoc\fRコマンドはその環境変数を使用します。どちらも設定されていない場合、\fIjavadoc\fRコマンドは現在のディレクトリからクラスを検索します。 -.sp -\fIjavadoc\fRコマンドが\fI\-classpath\fRを使用してユーザー・クラスを検索する方法についての、拡張機能クラスやブートストラップ・クラスに関連した詳細は、クラスの検索方法 +他のツールと同様に、\fB\-classpath\fRが指定されていない場合、\fBCLASSPATH\fR環境変数が設定されていれば、\fBjavadoc\fRコマンドはその環境変数を使用します。どちらも設定されていない場合、\fBjavadoc\fRコマンドは現在のディレクトリからクラスを検索します。 +.sp +\fBjavadoc\fRコマンドが\fB\-classpath\fRを使用してユーザー・クラスを検索する方法についての、拡張機能クラスやブートストラップ・クラスに関連した詳細は、クラスの検索方法 (http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/findingclasses\&.html)を参照してください。 .sp -*のベース名を含むクラス・パス要素は、\fI\&.jar\fRまたは\fI\&.JAR\fRを拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます。 -.sp -たとえば、ディレクトリ\fImydir\fRに\fIa\&.jar\fRと\fIb\&.JA\fRRが含まれている場合、クラス・パス要素\fIfoo/*\fRは\fIA\&.jar:b\&.JAR\fRに展開されますが、JARファイルの順番は未指定となります。非表示のファイルを含む、指定したディレクトリ内のすべてのJARファイルがリストに含まれます。*からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\fICLASSPATH\fR環境変数も同様に展開されます。クラス・パスのワイルドカードの展開は、Java仮想マシン(JVM)の開始前に行われます。Javaプログラムは、System\&.getenv(\fI"CLASSPATH"\fR)の呼び出しによってなど、環境を問い合せる場合を除き、展開されていないワイルドカードを参照しません。 +*のベース名を含むクラス・パス要素は、\fB\&.jar\fRまたは\fB\&.JAR\fRを拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます。 +.sp +たとえば、ディレクトリ\fBmydir\fRに\fBa\&.jar\fRと\fBb\&.JA\fRRが含まれている場合、クラス・パス要素\fBfoo/*\fRは\fBA\&.jar:b\&.JAR\fRに展開されますが、JARファイルの順番は未指定となります。非表示のファイルを含む、指定したディレクトリ内のすべてのJARファイルがリストに含まれます。*からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\fBCLASSPATH\fR環境変数も同様に展開されます。クラス・パスのワイルドカードの展開は、Java Virtual Machine (JVM)の開始前に行われます。Javaプログラムは、System\&.getenv(\fB"CLASSPATH"\fR)の呼び出しによってなど、環境を問い合せる場合を除き、展開されていないワイルドカードを参照しません。 .RE .PP \-subpackages \fIpackage1:package2:\&.\&.\&.\fR .RS 4 -ソース・ファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。このオプションは、ソース・コードに新しいサブパッケージを追加する際に便利です。新しいサブパッケージが自動的に組み込まれるからです。各package引数は、任意の最上位サブパッケージ(\fIjava\fRなど)または完全修飾パッケージ(\fIjavax\&.swing\fRなど)になります。ソース・ファイルを含める必要はありません。引数は、すべてのオペレーティング・システムで、コロンで区切られます。ワイルドカードは使用できません。パッケージの検索場所を指定するには、\fI\-sourcepath\fRを使用します。このオプションでは、ソース・ツリー内に存在するがパッケージに含まれないソース・ファイルを処理しません。ソース・ファイルの処理を参照してください。 -.sp -たとえば、次のコマンドは、\fIjava\fRおよび\fIjavax\&.swing\fRという名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。 +ソース・ファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。このオプションは、ソース・コードに新しいサブパッケージを追加する際に便利です。新しいサブパッケージが自動的に組み込まれるからです。各package引数は、任意の最上位サブパッケージ(\fBjava\fRなど)または完全修飾パッケージ(\fBjavax\&.swing\fRなど)になります。ソース・ファイルを含める必要はありません。引数は、すべてのオペレーティング・システムで、コロンで区切られます。ワイルドカードは使用できません。パッケージの検索場所を指定するには、\fB\-sourcepath\fRを使用します。このオプションでは、ソース・ツリー内に存在するがパッケージに含まれないソース・ファイルを処理しません。ソース・ファイルの処理を参照してください。 +.sp +たとえば、次のコマンドは、\fBjava\fRおよび\fBjavax\&.swing\fRという名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax\&.swing +\fBjavadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax\&.swing \fR + .fi .if n \{\ .RE @@ -2538,16 +2626,17 @@ .PP \-exclude \fIpackagename1:packagename2:\&.\&.\&.\fR .RS 4 -指定されたパッケージとそのサブパッケージを\fI\-subpackages\fRによって作成されたリストから無条件に除外します。過去または将来の\fI\-subpackages\fRオプションの指定によって組み込まれるパッケージも除外の対象となります。 -.sp -次の例では、\fIjava\&.io\fR、\fIjava\&.util\fR、\fIjava\&.math\fRなどは組み込まれますが、\fIjava\&.net\fRと\fIjava\&.lang\fRをルートに持つパッケージは除外されます。\fIjava\&.lang\fRのサブパッケージである\fIjava\&.lang\&.ref\fRが除外される点に注意してください。 +指定されたパッケージとそのサブパッケージを\fB\-subpackages\fRによって作成されたリストから無条件に除外します。過去または将来の\fB\-subpackages\fRオプションの指定によって組み込まれるパッケージも除外の対象となります。 +.sp +次の例では、\fBjava\&.io\fR、\fBjava\&.util\fR、\fBjava\&.math\fRなどは組み込まれますが、\fBjava\&.net\fRと\fBjava\&.lang\fRをルートに持つパッケージは除外されます。\fBjava\&.lang\fRのサブパッケージである\fBjava\&.lang\&.ref\fRが除外される点に注意してください。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-sourcepath /home/user/src \-subpackages java \-exclude - java\&.net:java\&.lang +\fBjavadoc \-sourcepath /home/user/src \-subpackages java \-exclude \fR +\fB java\&.net:java\&.lang\fR + .fi .if n \{\ .RE @@ -2556,30 +2645,30 @@ .PP \-bootclasspath \fIclasspathlist\fR .RS 4 -ブート・クラスが存在するパスを指定します。ブート・クラスとは、通常、Javaプラットフォーム・クラスのことです。\fIbootclasspath\fRは、\fIjavadoc\fRコマンドがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、クラスの検出方法 +ブート・クラスが存在するパスを指定します。ブート・クラスとは、通常、Javaプラットフォーム・クラスのことです。\fBbootclasspath\fRは、\fBjavadoc\fRコマンドがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、クラスの検出方法 (http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/findingclasses\&.html)を参照してください .sp -\fIclasspathlist\fRパラメータ内のディレクトリは、セミコロン(;)で区切る(Windowsの場合)か、コロン(:)で区切ります(Oracle Solarisの場合)。 +\fBclasspathlist\fRパラメータ内のディレクトリは、セミコロン(;)で区切る(Windowsの場合)か、コロン(:)で区切ります(Oracle Solarisの場合)。 .RE .PP \-extdirs \fIdirist\fR .RS 4 -拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java拡張機能機構を使用するすべてのクラスです。\fIextdirs\fRオプションは、\fIjavadoc\fRコマンドがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、\fI\-classpath\fRオプションを参照してください。\fIdirlist\fR内のディレクトリは、セミコロン(;)で区切る(Windowsの場合)か、コロン(:)で区切ります(Oracle Solarisの場合)。 +拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java拡張機能機構を使用するすべてのクラスです。\fBextdirs\fRオプションは、\fBjavadoc\fRコマンドがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、\fB\-classpath\fRオプションを参照してください。\fBdirlist\fR内のディレクトリは、セミコロン(;)で区切る(Windowsの場合)か、コロン(:)で区切ります(Oracle Solarisの場合)。 .RE .PP \-verbose .RS 4 -\fIjavadoc\fRコマンドの実行中に詳細なメッセージを表示します。\fIverbose\fRオプションを指定しないと、ソース・ファイルのロード時、ドキュメントの生成時(ソース・ファイルごとに1つのメッセージ)、およびソート時にメッセージが表示されます。verboseオプションを指定すると、各Javaソース・ファイルの解析に要した時間(ミリ秒単位)を示す追加のメッセージが表示されます。 +\fBjavadoc\fRコマンドの実行中に詳細なメッセージを表示します。\fBverbose\fRオプションを指定しないと、ソース・ファイルのロード時、ドキュメントの生成時(ソース・ファイルごとに1つのメッセージ)、およびソート時にメッセージが表示されます。verboseオプションを指定すると、各Javaソース・ファイルの解析に要した時間(ミリ秒単位)を示す追加のメッセージが表示されます。 .RE .PP \-quiet .RS 4 -メッセージを抑制し、警告とエラーのみが表示されるようにして、これらを確認しやすくします。\fIversion\fR文字列も抑止します。 +メッセージを抑制し、警告とエラーのみが表示されるようにして、これらを確認しやすくします。\fBversion\fR文字列も抑止します。 .RE .PP \-breakiterator .RS 4 -英語の場合、パッケージ、クラスまたはメンバーの主説明の最初の文の終わりを判断する際に、\fIjava\&.text\&.BreakIterator\fRの国際化された文境界を使用します。他のすべてのロケールは、英語言語というロケール固有のアルゴリズムではなく、すでに\fIBreakIterator\fRクラスを使用しています。最初の文は、パッケージ、クラス、またはメンバーのサマリーにコピーされ、アルファベット順の索引にコピーされます。JDK 1\&.2以降、\fIBreakIterator\fRクラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、\fI\-breakiterator\fRオプションは、1\&.2以降では英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。 +英語の場合、パッケージ、クラスまたはメンバーの主説明の最初の文の終わりを判断する際に、\fBjava\&.text\&.BreakIterator\fRの国際化された文境界を使用します。他のすべてのロケールは、英語言語というロケール固有のアルゴリズムではなく、すでに\fBBreakIterator\fRクラスを使用しています。最初の文は、パッケージ、クラス、またはメンバーのサマリーにコピーされ、アルファベット順の索引にコピーされます。JDK 1\&.2以降、\fBBreakIterator\fRクラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、\fB\-breakiterator\fRオプションは、1\&.2以降では英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。 .sp .RS 4 .ie n \{\ @@ -2589,7 +2678,7 @@ .sp -1 .IP \(bu 2.3 .\} -英文のデフォルトの文区切りアルゴリズム。空白文字またはHTMLブロック・タグ(\fI<P>\fRなど)が続くピリオドで停止します。 +英文のデフォルトの文区切りアルゴリズム。空白文字またはHTMLブロック・タグ(\fB<P>\fRなど)が続くピリオドで停止します。 .RE .sp .RS 4 @@ -2600,45 +2689,46 @@ .sp -1 .IP \(bu 2.3 .\} -breakiterator文区切りアルゴリズム。次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止します。このアルゴリズムでは「The serial no\&. is valid」など、ほとんどの省略表記が処理されますが、「Mr\&. Smith」は処理されません。\fI\-breakiterator\fRオプションでは、HTMLタグや、数字または記号で始まる文では停止しません。HTMLタグに埋め込まれている場合でも、「\&.\&./filename」の最後のピリオドで停止します。 -.RE -.sp -Java SE 1\&.5では\fI\-breakiterator\fR警告メッセージが削除され、デフォルトの文区切りアルゴリズムは変更されていません。ソース・コードを変更せず、SE 1\&.4\&.xでの\fI\-breakiterator\fRオプションの警告を除去していない場合でも、何もする必要はありません。Java SE 1\&.5\&.0からは警告は消滅しています。 +breakiterator文区切りアルゴリズム。次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止します。このアルゴリズムでは「The serial no\&. is valid」など、ほとんどの省略表記が処理されますが、「Mr\&. Smith」は処理されません。\fB\-breakiterator\fRオプションでは、HTMLタグや、数字または記号で始まる文では停止しません。HTMLタグに埋め込まれている場合でも、「\&.\&./filename」の最後のピリオドで停止します。 +.RE +.sp +Java SE 1\&.5では\fB\-breakiterator\fR警告メッセージが削除され、デフォルトの文区切りアルゴリズムは変更されていません。ソース・コードを変更せず、SE 1\&.4\&.xでの\fB\-breakiterator\fRオプションの警告を除去していない場合でも、何もする必要はありません。Java SE 1\&.5\&.0からは警告は消滅しています。 .RE .PP \-locale \fIlanguage_country_variant\fR .RS 4 -\fIjavadoc\fRコマンドがドキュメントを生成するときに使用するロケールを指定します。この引数は、\fIj\fR\fIava\&.util\&.Locale\fRドキュメントで説明しているように、\fIen_US\fR -(英語、米国)または\fIen_US_WIN\fR +\fBjavadoc\fRコマンドがドキュメントを生成するときに使用するロケールを指定します。この引数は、\fBj\fR\fBava\&.util\&.Locale\fRドキュメントで説明しているように、\fBen_US\fR +(英語、米国)または\fBen_US_WIN\fR (Windowsバリアント)などのロケールの名前です。 .sp \fB注意:\fR -\fI\-locale\fRオプションは、標準ドックレットが提供するすべてのオプション、またはその他の任意のドックレットが提供するすべてのオプションより前(左側)に指定する必要があります。そうしないと、ナビゲーション・バーが英語で表示されます。このコマンドライン・オプションのみ、指定する順序に依存します。標準ドックレットのオプションを参照してください。 -.sp -ロケールを指定すると、指定したロケールのリソース・ファイルが\fIjavadoc\fRコマンドによって選択されて、メッセージ(ナビゲーション・バー、リストと表の見出し、ヘルプ・ファイルの目次、stylesheet\&.cssのコメントなどの文字列)のために使用されます。また、アルファベット順にソートされるリストのソート順、および最初の文の終わりを判断するための文の区切り文字も、指定したロケールによって決まります。\fI\-locale\fRオプションは、ドキュメント化されるクラスのソース・ファイル内で指定されているドキュメンテーション・コメントのテキストのロケールを決定するものではありません。 +\fB\-locale\fRオプションは、標準ドックレットが提供するすべてのオプション、またはその他の任意のドックレットが提供するすべてのオプションより前(左側)に指定する必要があります。そうしないと、ナビゲーション・バーが英語で表示されます。このコマンド行オプションのみ、指定する順序に依存します。標準ドックレットのオプションを参照してください。 +.sp +ロケールを指定すると、指定したロケールのリソース・ファイルが\fBjavadoc\fRコマンドによって選択されて、メッセージ(ナビゲーション・バー、リストと表の見出し、ヘルプ・ファイルの目次、stylesheet\&.cssのコメントなどの文字列)のために使用されます。また、アルファベット順にソートされるリストのソート順、および最初の文の終わりを判断するための文の区切り文字も、指定したロケールによって決まります。\fB\-locale\fRオプションは、ドキュメント化されるクラスのソース・ファイル内で指定されているドキュメンテーション・コメントのテキストのロケールを決定するものではありません。 .RE .PP \-encoding .RS 4 -ソース・ファイルのエンコーディングの名前(\fIEUCJIS/SJIS\fRなど)を指定します。このオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。およびオプションも参照してください。 +ソース・ファイルのエンコーディングの名前(\fBEUCJIS/SJIS\fRなど)を指定します。このオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。およびオプションも参照してください。 .RE .PP \-J\fIflag\fR .RS 4 -\fIjavadoc\fRコマンドを実行するJava Runtime Environment (JRE)に、\fIflag\fRを直接渡します。たとえば、生成ドキュメントを処理するためにシステムで32MBのメモリーを確保しておく必要がある場合は、\fI\-Xmx\fRオプションを次のように呼び出します。\fIjavadoc \-J\-Xmx32m \-J\-Xms32m com\&.mypackage\fR。\fI\-Xms\fRは省略可能で、これは初期メモリーのサイズを設定するのみのオプションで、必要なメモリーの最小量がわかっている場合に便利です。 -.sp -\fIJ\fRと\fIflag\fRの間に空白文字はありません。 -.sp -使用している\fIjavadoc\fRコマンドのバージョンを確認するには\fI\-version\fRオプションを使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。Javadocコマンドの実行を参照してください。 +\fBjavadoc\fRコマンドを実行するJava Runtime Environment (JRE)に、\fBflag\fRを直接渡します。たとえば、生成ドキュメントを処理するためにシステムで32MBのメモリーを確保しておく必要がある場合は、\fB\-Xmx\fRオプションを次のように呼び出します。\fBjavadoc \-J\-Xmx32m \-J\-Xms32m com\&.mypackage\fR。\fB\-Xms\fRは省略可能で、これは初期メモリーのサイズを設定するのみのオプションで、必要なメモリーの最小量がわかっている場合に便利です。 +.sp +\fBJ\fRと\fBflag\fRの間に空白文字はありません。 +.sp +使用している\fBjavadoc\fRコマンドのバージョンを確認するには\fB\-version\fRオプションを使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。Javadocコマンドの実行を参照してください。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-J\-version -java version "1\&.7\&.0_09" -Java(TM) SE Runtime Environment (build 1\&.7\&.0_09\-b05) -Java HotSpot(TM) 64\-Bit Server VM (build 23\&.5\-b02, mixed mode) +\fBjavadoc \-J\-version\fR +\fBjava version "1\&.7\&.0_09"\fR +\fBJava(TM) SE Runtime Environment (build 1\&.7\&.0_09\-b05)\fR +\fBJava HotSpot(TM) 64\-Bit Server VM (build 23\&.5\-b02, mixed mode)\fR + .fi .if n \{\ .RE @@ -2648,24 +2738,24 @@ .PP \-d \fIdirectory\fR .RS 4 -\fIjavadoc\fRコマンドが生成されたHTMLファイルを保存する生成先ディレクトリを指定します。\fI\-d\fRオプションを省略すると、ファイルは現在のディレクトリに保存されます。\fIdirectory\fRの値には、絶対ディレクトリ、または現在の作業ディレクトリからの相対ディレクトリを指定できます。Java SE 1\&.4では、\fIjavadoc\fRコマンドを実行すると生成先ディレクトリが自動的に作成されます。 -.sp -たとえば、次の例では、\fIcom\&.mypackage\fRパッケージのドキュメントが生成され、その結果が\fI/user/doc/ \fRディレクトリに保存されます。\fIjavadoc \-d \fR\fI/user/doc/ \fR\fIcom\&.mypackage\fR +\fBjavadoc\fRコマンドが生成されたHTMLファイルを保存する生成先ディレクトリを指定します。\fB\-d\fRオプションを省略すると、ファイルは現在のディレクトリに保存されます。\fBdirectory\fRの値には、絶対ディレクトリ、または現在の作業ディレクトリからの相対ディレクトリを指定できます。Java SE 1\&.4では、\fBjavadoc\fRコマンドを実行すると生成先ディレクトリが自動的に作成されます。 +.sp +たとえば、次の例では、\fBcom\&.mypackage\fRパッケージのドキュメントが生成され、その結果が/user/doc/ ディレクトリに保存されます。\fBjavadoc \-d \fR\fB/user/doc/ \fR\fBcom\&.mypackage\fR .RE .PP \-use .RS 4 -ドキュメント化されるクラスおよびパッケージごとに1つの使用ページを組み込みます。このページには、その特定のクラスまたはパッケージのAPIを使用しているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドが記述されます。たとえば、クラスCを例にとると、クラスCを使用しているものとしては、Cのサブクラス、Cとして宣言されているフィールド、Cを返すメソッド、および型Cのパラメータを持つメソッドとコンストラクタがあります。たとえば、\fIString\fR型用の使用ページを表示できます。\fIjava\&.awt\&.Font\fRクラスの\fIgetName\fRメソッドは\fIString\fR型を戻すので、\fIgetName\fRメソッドは\fIString\fRを使用し、\fIgetName\fRメソッドが\fIString\fR用の使用ページに表示されます。これは実装ではなくAPIの使用のみをドキュメント化します。メソッドがその実装で\fIString\fRを使用するが、引数として文字列を取らない、または文字列を返さない場合、それは\fIString\fRの使用とはみなされません。生成された使用ページにアクセスするには、クラスまたはパッケージに移動し、ナビゲーション・バーの\fBリンクの使用\fRをクリックします。 +ドキュメント化されるクラスおよびパッケージごとに1つの使用ページを組み込みます。このページには、その特定のクラスまたはパッケージのAPIを使用しているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドが記述されます。たとえば、クラスCを例にとると、クラスCを使用しているものとしては、Cのサブクラス、Cとして宣言されているフィールド、Cを返すメソッド、および型Cのパラメータを持つメソッドとコンストラクタがあります。たとえば、\fBString\fR型用の使用ページを表示できます。\fBjava\&.awt\&.Font\fRクラスの\fBgetName\fRメソッドは\fBString\fR型を戻すので、\fBgetName\fRメソッドは\fBString\fRを使用し、\fBgetName\fRメソッドが\fBString\fR用の使用ページに表示されます。これは実装ではなくAPIの使用のみをドキュメント化します。メソッドがその実装で\fBString\fRを使用するが、引数として文字列を取らない、または文字列を返さない場合、それは\fBString\fRの使用とはみなされません。生成された使用ページにアクセスするには、クラスまたはパッケージに移動し、ナビゲーション・バーの\fBリンクの使用\fRをクリックします。 .RE .PP \-version .RS 4 -生成ドキュメントに、@versionのテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用している\fIjavadoc\fRコマンドのバージョンを確認するには\fI\-J\-version\fRオプションを使用します。 +生成ドキュメントに、@versionのテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用している\fBjavadoc\fRコマンドのバージョンを確認するには\fB\-J\-version\fRオプションを使用します。 .RE .PP \-author .RS 4 -生成ドキュメントに、\fI@author\fRのテキストを組み込みます。 +生成ドキュメントに、\fB@author\fRのテキストを組み込みます。 .RE .PP \-splitindex @@ -2675,27 +2765,27 @@ .PP \-windowtitle \fItitle\fR .RS 4 -HTMLの\fI<title>\fRタグに配置するタイトルを指定します。\fItitle\fRタグに指定したテキストは、ウィンドウのタイトルや、このページに対して作成されたブラウザのブックマーク(お気に入り)に表示されます。このタイトルにはHTMLタグを含めないでください。タイトルにHTMLタグが含まれていると、ブラウザがタグを正しく解釈できません。\fItitle\fRタグ内の内部の二重引用符はエスケープ文字を使用してマークします。\fI\-windowtitle\fRオプションを省略すると、\fIjavadoc\fRコマンドは、\fI\-windowtitle\fRオプションのかわりに、\fI\-doctitle\fRオプションの値を使用します。たとえば、\fIjavadoc \-windowtitle "Java SE Platform" com\&.mypackage\fRです。 +HTMLの\fB<title>\fRタグに配置するタイトルを指定します。\fBtitle\fRタグに指定したテキストは、ウィンドウのタイトルや、このページに対して作成されたブラウザのブックマーク(お気に入り)に表示されます。このタイトルにはHTMLタグを含めないでください。タイトルにHTMLタグが含まれていると、ブラウザがタグを正しく解釈できません。\fBtitle\fRタグ内の内部の二重引用符はエスケープ文字を使用してマークします。\fB\-windowtitle\fRオプションを省略すると、\fBjavadoc\fRコマンドは、\fB\-windowtitle\fRオプションのかわりに、\fB\-doctitle\fRオプションの値を使用します。たとえば、\fBjavadoc \-windowtitle "Java SE Platform" com\&.mypackage\fRです。 .RE .PP \-doctitle \fItitle\fR .RS 4 -概要サマリー・ファイルの最上部の近くに配置するタイトルを指定します。\fItitle\fRタグに指定したテキストは中央揃えになり、レベル1の見出しとして、上部ナビゲーション・バーのすぐ下に置かれます。\fItitle\fRタグにはHTMLタグおよび空白文字を含めることができますが、その場合、タイトルを引用符で囲む必要があります。\fItitle\fRタグの内部で引用符を使用する場合は、エスケープする必要があります。たとえば、\fIjavadoc \-header "<b>Java Platform </b><br>v1\&.4" com\&.mypackage\fRです。 +概要サマリー・ファイルの最上部の近くに配置するタイトルを指定します。\fBtitle\fRタグに指定したテキストは中央揃えになり、レベル1の見出しとして、上部ナビゲーション・バーのすぐ下に置かれます。\fBtitle\fRタグにはHTMLタグおよび空白文字を含めることができますが、その場合、タイトルを引用符で囲む必要があります。\fBtitle\fRタグの内部で引用符を使用する場合は、エスケープする必要があります。たとえば、\fBjavadoc \-header "<b>Java Platform </b><br>v1\&.4" com\&.mypackage\&.\fRとなります。 .RE .PP \-title \fItitle\fR .RS 4 -すでに存在しません。Javadoc 1\&.2のベータ版にしか存在していませんでした。このオプションは、\fI\-doctitle\fRという名前に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。 +すでに存在しません。Javadoc 1\&.2のベータ版にしか存在していませんでした。このオプションは、\fB\-doctitle\fRという名前に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。 .RE .PP \-header \fIheader\fR .RS 4 -各出力ファイルの最上部に配置するヘッダー・テキストを指定します。ヘッダーは、ナビゲーション・バーの右上に配置されます。\fIheader\fRにはHTMLタグおよび空白文字を含めることができますが、その場合、\fIheader\fRを引用符で囲む必要があります。ヘッダー内部の引用符にはエスケープ文字を使用します。たとえば、\fIjavadoc \-header "<b>Java Platform </b><br>v1\&.4" com\&.mypackage\fRです。 +各出力ファイルの最上部に配置するヘッダー・テキストを指定します。ヘッダーは、ナビゲーション・バーの右上に配置されます。\fBheader\fRにはHTMLタグおよび空白文字を含めることができますが、その場合、\fBheader\fRを引用符で囲む必要があります。ヘッダー内部の引用符にはエスケープ文字を使用します。たとえば、\fBjavadoc \-header "<b>Java Platform </b><br>v1\&.4" com\&.mypackage\&.\fRとなります。 .RE .PP \-footer \fIfooter\fR .RS 4 -各出力ファイルの最下部に配置するフッター・テキストを指定します。\fIfooter\fRの値は、ナビゲーション・バーの右下に配置されます。\fIfooter\fRにはHTMLタグおよび空白文字を含めることができますが、その場合、\fIfooter\fRを引用符で囲む必要があります。フッター内部の引用符にはエスケープ文字を使用します。 +各出力ファイルの最下部に配置するフッター・テキストを指定します。\fIfooter\fRの値は、ナビゲーション・バーの右下に配置されます。\fBfooter\fRにはHTMLタグおよび空白文字を含めることができますが、その場合、\fBfooter\fRを引用符で囲む必要があります。フッター内部の引用符にはエスケープ文字を使用します。 .RE .PP \-top @@ -2710,25 +2800,28 @@ .PP \-link \fIextdocURL\fR .RS 4 -既存のJavadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。\fIextdocURL\fR引数は、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。指定した\fIjavadoc\fRコマンドの実行で、複数の\fI\-link\fRオプションを指定して複数のドキュメントへのリンクを作成できます。 -.sp -このディレクトリ内にpackage\-listファイルが存在する必要があります(存在しない場合は、\fI\-linkoffline\fRオプションを使用します)。\fIjavadoc\fRコマンドは、package\-listファイルからパッケージ名を読み取った後、そのURLでこれらのパッケージにリンクします。\fIjavadoc\fRコマンドの実行時に、\fIextdocURL\fRの値が、作成された\fI<A HREF>\fRリンク内にコピーされます。したがって、\fIextdocURL\fRはファイルではなくディレクトリへのURLである必要があります。\fIextdocURL\fRに絶対リンクを使用すると、ユーザーのドキュメントを任意のWebサイト上のドキュメントにリンクできます。相対位置へリンクするのみの場合は相対リンクを使用できます。相対リンクを使用する場合、渡す値は宛先ディレクトリから、リンクされているパッケージを含むディレクトリへである必要があります(\fI\-d\fRオプションで指定)。絶対リンクを指定する場合、通常、HTTPリンクを使用します。ただし、Webサーバーを持たないファイル・システムにリンクする場合は、ファイル・リンクを使用できます。生成されたドキュメンテーションにアクセスする全員が同じファイル・システムを共有する場合にのみファイル・リンクを使用します。どの場合も、どのオペレーティング・システムでも、URLが絶対または相対のいずれでも、また\fIh\fR\fIttp:\fRまたは\fIf\fR\fIile:\fRのいずれでも、URLメモ: Uniform Resource Locators +既存のJavadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。\fIextdocURL\fR引数は、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。指定した\fBjavadoc\fRコマンドの実行で、複数の\fB\-link\fRオプションを指定して複数のドキュメントへのリンクを作成できます。 +.sp +このディレクトリ内にpackage\-listファイルが存在する必要があります(存在しない場合は、\fB\-linkoffline\fRオプションを使用します)。\fBjavadoc\fRコマンドは、package\-listファイルからパッケージ名を読み取った後、そのURLでこれらのパッケージにリンクします。\fBjavadoc\fRコマンドの実行時に、\fBextdocURL\fRの値が、作成された\fB<A HREF>\fRリンク内にコピーされます。したがって、\fBextdocURL\fRはファイルではなくディレクトリへのURLである必要があります。\fIextdocURL\fRに絶対リンクを使用すると、ユーザーのドキュメントを任意のWebサイト上のドキュメントにリンクできます。相対位置へリンクするのみの場合は相対リンクを使用できます。相対リンクを使用する場合、渡す値は宛先ディレクトリから、リンクされているパッケージを含むディレクトリへである必要があります(\fB\-d\fRオプションで指定)。絶対リンクを指定する場合、通常、HTTPリンクを使用します。ただし、Webサーバーを持たないファイル・システムにリンクする場合は、ファイル・リンクを使用できます。生成されたドキュメンテーションにアクセスする全員が同じファイル・システムを共有する場合にのみファイル・リンクを使用します。どの場合も、どのオペレーティング・システムでも、URLが絶対または相対のいずれでも、また\fBh\fR\fBttp:\fRまたは\fBf\fR\fBile:\fRのいずれでも、URLメモ: Uniform Resource Locators (http://www\&.ietf\&.org/rfc/rfc1738\&.txt)に指定されているとおり、区切り文字としてスラッシュを使用します。 .sp .if n \{\ .RS 4 .\} .nf -\-link http://<host>/<directory>/<directory>/\&.\&.\&./<name> -\-link file://<host>/<directory>/<directory>/\&.\&.\&./<name> -\-link <directory>/<directory>/\&.\&.\&./<name> +\fB\-link http://<host>/<directory>/<directory>/\&.\&.\&./<name>\fR +\fB\-link file://<host>/<directory>/<directory>/\&.\&.\&./<name>\fR +\fB\-link <directory>/<directory>/\&.\&.\&./<name>\fR + .fi .if n \{\ .RE .\} .RE -\-linkofflineおよび\-linkオプションの違い.PP -次の場合に、\fI\-link\fRオプションを使用します。 +.PP +\-linkofflineおよび\-linkオプションの違い +.PP +次の場合に、\fB\-link\fRオプションを使用します。 .sp .RS 4 .ie n \{\ @@ -2752,47 +2845,59 @@ 外部APIドキュメントへの絶対URLを使用する場合(そのURLに接続し、読取りを行うことがシェルによって許可されている場合)。 .RE .PP -外部APIドキュメントへの絶対URLを使用する場合(そのURLに接続し、読取りを行うことがシェルによって許可されていない場合)は\fI\-linkoffline\fRオプションを使用します。このような状況は、ファイアウォールの内側からファイアウォールの外側にあるドキュメントにリンクしようとする場合に発生します。 -.PP -\fBExample 1\fR, 外部ドキュメントへの絶対リンク -.RS 4 -http://docs\&.oracle\&.com/javase/8/docs/api/index\&.htmlに示すような、\fIjava\&.lang\fR、\fIjava\&.io\fRおよびその他のJavaプラットフォーム・パッケージにリンクする場合、次のコマンドを使用します +外部APIドキュメントへの絶対URLを使用する場合(そのURLに接続し、読取りを行うことがシェルによって許可されていない場合)は\fB\-linkoffline\fRオプションを使用します。このような状況は、ファイアウォールの内側からファイアウォールの外側にあるドキュメントにリンクしようとする場合に発生します。 +.PP +\fB例 1\fR +.br +外部ドキュメントへの絶対リンク +.RS 4 +http://docs\&.oracle\&.com/javase/8/docs/api/index\&.htmlに示すような、\fBjava\&.lang\fR、\fBjava\&.io\fRおよびその他のJavaプラットフォーム・パッケージにリンクする場合、次のコマンドを使用します .sp .if n \{\ .RS 4 .\} .nf -javadoc \-link http://docs\&.oracle\&.com/javase/8/docs/api/ com\&.mypackage +\fBjavadoc \-link http://docs\&.oracle\&.com/javase/8/docs/api/ com\&.mypackage\fR + .fi .if n \{\ .RE .\} -このコマンドは、Java SEプラットフォーム・パッケージへのリンク持つ\fIcom\&.mypackage\fRパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス\fItrees\fR内の\fIObject\fRクラスへのリンクが含まれています。\fI\-sourcepath\fRや\fI\-d\fRなどの他のオプションは表示されません。 -.RE -.PP -\fBExample 2\fR, 外部ドキュメントへの相対リンク -.RS 4 -この例では、2つのパッケージがあり、そのドキュメントは\fIjavadoc\fRコマンドを複数回実行した結果生成されたものです。さらに、これらのドキュメントは相対パスで分割されています。パッケージは、APIである\fIcom\&.apipackage\fRと、SPI(サービス・プロバイダ・インタフェース)であるc\fIom\&.spipackage\fRです。ドキュメントの格納先は、docs/api/com/apipackageとdocs/spi/com/spipackageです。APIパッケージのドキュメントはすでに生成されていて、docsが現在のディレクトリである場合、APIドキュメントへのリンクを持つSPIパッケージをドキュメント化するには、次のコマンドを実行します。\fIjavadoc \-d \&./spi \-link \&.\&./api com\&.spipackage\fR -.sp -\fI\-link\fRオプションは、宛先ディレクトリ(docs/spi)からの相対パスです。 -.RE -注意.PP -\fI\-link\fRオプションを使用すると、コードからは参照されていても、今回の\fIjavadoc\fRの実行ではドキュメント化されないクラスにリンクできるようになります。リンクから有効なページに移動できるようにするには、それらのHTMLページがある場所を調べ、その場所を\fIextdocURL\fRに指定する必要があります。これにより、サードパーティのドキュメンテーションがjava\&.*ドキュメンテーション(http://docs\&.oracle\&.com)へリンクすることができます。\fIjavadoc\fRコマンドで、現在の実行で生成しているドキュメンテーション内のAPIへのリンクのみを作成する場合には、\fI\-link\fRオプションを省略します。\fI\-link\fRオプションを指定しないと、\fIjavadoc\fRコマンドは外部参照のためのドキュメンテーションへのリンクを作成しません。ドキュメンテーションが存在するのかどうか、またはどこに存在するのかがわからないからです。\fI\-link\fRオプションでは、生成ドキュメンテーション内の複数の場所にリンクを作成できます。ソース・ファイルの処理を参照してください。もう1つの用途は、パッケージ・セットの間にクロスリンクを作成することです。一方のパッケージ・セットに対して\fIjavadoc\fRコマンドを実行した後、他方のパッケージ・セットに対して\fIjavadoc\fRコマンドを再度実行すると、両セット間に双方向のリンクを作成できます。 -クラスの参照方法.PP -表示される外部参照クラスへのリンクの場合(およびそのテキスト・ラベルだけではなく)、クラスは次の方法で参照される必要があります。メソッドの本体でクラスを参照するのみでは十分ではありません。\fIimport\fR文、宣言のいずれかで参照する必要があります。次に、クラス\fIjava\&.io\&.File\fRを参照する方法の例を示します。 -.PP -すべてのタイプのimport文の場合。ワイルドカードによるインポート、名前による明示的なインポート、または\fIjava\&.lang\&.*\fRに対する自動インポート。 -.PP -Java SE 1\&.3\&.\fIn\fRおよび1\&.2\&.\fIn\fRでは、名前による明示的なインポートのみ機能します。ワイルドカードによる\fIimport\fR文も、\fIimport java\&.lang\&.*\fRの自動インポートも機能しません。 +このコマンドは、Java SEプラットフォーム・パッケージへのリンク持つ\fBcom\&.mypackage\fRパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス\fBtrees\fR内の\fBObject\fRクラスへのリンクが含まれています。\fB\-sourcepath\fRや\fB\-d\fRなどの他のオプションは表示されません。 +.RE +.PP +\fB例 2\fR +.br +外部ドキュメントへの相対リンク +.RS 4 +この例では、2つのパッケージがあり、そのドキュメントは\fBjavadoc\fRコマンドを複数回実行した結果生成されたものです。さらに、これらのドキュメントは相対パスで分割されています。パッケージは、APIである\fBcom\&.apipackage\fRと、SPI(サービス・プロバイダ・インタフェース)であるc\fBom\&.spipackage\fRです。ドキュメントの格納先は、docs/api/com/apipackageとdocs/spi/com/spipackageです。APIパッケージのドキュメントはすでに生成されていて、docsが現在のディレクトリである場合、APIドキュメントへのリンクを持つSPIパッケージをドキュメント化するには、次のコマンドを実行します。\fBjavadoc \-d \&./spi \-link \&.\&./api com\&.spipackage\fR +.sp +\fB\-link\fRオプションは、宛先ディレクトリ(docs/spi)からの相対パスです。 +.RE +.PP +注意 +.PP +\fB\-link\fRオプションを使用すると、コードからは参照されていても、今回の\fBjavadoc\fRの実行ではドキュメント化されないクラスにリンクできるようになります。リンクから有効なページに移動できるようにするには、それらのHTMLページがある場所を調べ、その場所を\fBextdocURL\fRに指定する必要があります。これにより、サードパーティのドキュメンテーションがjava\&.*ドキュメンテーション( +http://docs\&.oracle\&.com)へリンクすることができます。\fBjavadoc\fRコマンドで、現在の実行で生成しているドキュメンテーション内のAPIへのリンクのみを作成する場合には、\fB\-link\fRオプションを省略します。\fB\-link\fRオプションを指定しないと、\fBjavadoc\fRコマンドは外部参照のためのドキュメンテーションへのリンクを作成しません。ドキュメンテーションが存在するのかどうか、またはどこに存在するのかがわからないからです。\fB\-link\fRオプションでは、生成ドキュメンテーション内の複数の場所にリンクを作成できます。ソース・ファイルの処理を参照してください。もう1つの用途は、パッケージ・セットの間にクロスリンクを作成することです。一方のパッケージ・セットに対して\fBjavadoc\fRコマンドを実行した後、他方のパッケージ・セットに対して\fBjavadoc\fRコマンドを再度実行すると、両セット間に双方向のリンクを作成できます。 +.PP +クラスの参照方法 +.PP +表示される外部参照クラスへのリンクの場合(およびそのテキスト・ラベルだけではなく)、クラスは次の方法で参照される必要があります。メソッドの本体でクラスを参照するのみでは十分ではありません。\fBimport\fR文、宣言のいずれかで参照する必要があります。次に、クラス\fBjava\&.io\&.File\fRを参照する方法の例を示します。 +.PP +すべてのタイプのimport文の場合。ワイルドカードによるインポート、名前による明示的なインポート、または\fBjava\&.lang\&.*\fRに対する自動インポート。 +.PP +Java SE 1\&.3\&.\fIn\fRおよび1\&.2\&.\fIn\fRでは、名前による明示的なインポートのみ機能します。ワイルドカードによる\fBimport\fR文も、\fBimport java\&.lang\&.*\fRの自動インポートも機能しません。 .PP 宣言の場合: -\fIvoid mymethod(File f) {}\fR +\fBvoid mymethod(File f) {}\fR .PP 参照は、メソッド、コンストラクタ、フィールド、クラスまたはインタフェースの戻り型またはパラメータ・タイプ、あるいは実装、拡張またはスロー文にあります。 .PP -重要な結果として、\fI\-link\fRオプションを使用しても、この制限のために誤って表示されないリンクが多数発生する可能性があります。テキストはハイパーテキスト・リンクが付けられずに表示されます。リンクが表示する警告から、これらのリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するための最も簡単な方法はそのクラスをインポートすることです。 -パッケージ・リスト.PP -\fI\-link\fRオプションには、\fIjavadoc\fRコマンドによって生成されるpackage\-listという名前のファイルが、\fI\-link\fRオプションに指定したURLに存在していることが必要です。package\-listファイルは、その場所にあるドキュメント化されたパッケージの名前のリストが入った単純なテキスト・ファイルです。前述の例では、\fIjavadoc\fRコマンドは、指定したURLでpackage\-listという名前のファイルを検索し、パッケージ名を読み取って、そのURLでこれらのパッケージにリンクします。 +重要な結果として、\fB\-link\fRオプションを使用しても、この制限のために誤って表示されないリンクが多数発生する可能性があります。テキストはハイパーテキスト・リンクが付けられずに表示されます。リンクが表示する警告から、これらのリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するための最も簡単な方法はそのクラスをインポートすることです。 +.PP +パッケージ・リスト +.PP +\fB\-link\fRオプションには、\fBjavadoc\fRコマンドによって生成されるpackage\-listという名前のファイルが、\fB\-link\fRオプションに指定したURLに存在していることが必要です。package\-listファイルは、その場所にあるドキュメント化されたパッケージの名前のリストが入った単純なテキスト・ファイルです。前述の例では、\fBjavadoc\fRコマンドは、指定したURLでpackage\-listという名前のファイルを検索し、パッケージ名を読み取って、そのURLでこれらのパッケージにリンクします。 .PP たとえば、Java SE APIのパッケージ・リストは http://docs\&.oracle\&.com/javase/8/docs/api/package\-listにあります。 @@ -2803,33 +2908,38 @@ .RS 4 .\} .nf -java\&.applet -java\&.awt -java\&.awt\&.color -java\&.awt\&.datatransfer -java\&.awt\&.dnd -java\&.awt\&.event -java\&.awt\&.font -and so on \&.\&.\&.\&. +\fBjava\&.applet\fR +\fBjava\&.awt\fR +\fBjava\&.awt\&.color\fR +\fBjava\&.awt\&.datatransfer\fR +\fBjava\&.awt\&.dnd\fR +\fBjava\&.awt\&.event\fR +\fBjava\&.awt\&.font\fR +\fBand so on \&.\&.\&.\&.\fR + .fi .if n \{\ .RE .\} .PP -\fI\-link\fRオプションを指定せずに\fIjavadoc\fRを実行した場合、外部参照クラスに属する名前を見つけると、その名前をリンクなしで出力します。一方、\fI\-link\fRオプションを指定した場合、\fIjavadoc\fRコマンドは、指定された\fIextdocURL\fRの場所にあるpackage\-listファイルでそのパッケージ名を検索します。パッケージ名が見つかると、\fIextdocURL\fRが名前の前に付加されます。 -.PP -すべてのリンクが正しく機能するためには、外部参照のすべてのドキュメントが、指定したURLに存在する必要があります。\fIjavadoc\fRコマンドは、指定されたpackage\-listが存在するかどうかのみをチェックし、これらのページが存在するかどうかはチェックしません。 -複数のリンク.PP -複数の\fI\-link\fRオプションを指定すると、任意の数の外部生成ドキュメントへのリンクを作成できます。Javadoc 1\&.2には、複数の\fI\-link\fRオプションを指定できないという既知の不具合があります。これはJavadoc 1\&.2\&.2で修正されました。リンクする外部ドキュメントごとに、次のように別々のリンク・オプションを指定します。\fIjavadoc \-link extdocURL1 \-link extdocURL2 \&.\&.\&. \-link extdocURLn com\&.mypackage\fR -\fIextdocURL1\fR、\fIextdocURL2\fR、\&.\fI\&.\&. extdocURLn\fRは、それぞれ外部ドキュメントのルートを指し、各ルートには、package\-listという名前のファイルが入っています。 -クロスリンク.PP -以前に作成された複数のドキュメントをクロスリンクする場合、ブートストラップが必要になることがあります。どのドキュメントについてもpackage\-listが存在していない場合は、最初のドキュメントに対して\fIjavadoc\fRコマンドを実行する時点で、2番目のドキュメントのpackage\-listはまだ存在していません。したがって、外部リンクを作成するには、2番目のドキュメントを生成した後で、最初のドキュメントを生成しなおす必要があります。 -.PP -この場合、最初のドキュメント生成の目的は、package\-listを作成することです(パッケージ名を把握している場合は手動で作成してもかまいません)。次に、2番目のドキュメントとその外部リンクを生成します。必要な外部のpackage\-listファイルが存在しない場合は、\fIjavadoc\fRコマンドから警告が出力されます。 +\fB\-link\fRオプションを指定せずに\fBjavadoc\fRを実行した場合、外部参照クラスに属する名前を見つけると、その名前をリンクなしで出力します。一方、\fB\-link\fRオプションを指定した場合、\fBjavadoc\fRコマンドは、指定された\fIextdocURL\fRの場所にあるpackage\-listファイルでそのパッケージ名を検索します。パッケージ名が見つかると、\fIextdocURL\fRが名前の前に付加されます。 +.PP +すべてのリンクが正しく機能するためには、外部参照のすべてのドキュメントが、指定したURLに存在する必要があります。\fBjavadoc\fRコマンドは、指定されたpackage\-listが存在するかどうかのみをチェックし、これらのページが存在するかどうかはチェックしません。 +.PP +複数のリンク +.PP +複数の\fB\-link\fRオプションを指定すると、任意の数の外部生成ドキュメントへのリンクを作成できます。Javadoc 1\&.2には、複数の\fB\-link\fRオプションを指定できないという既知のbugがあります。これはJavadoc 1\&.2\&.2で修正されました。リンクする外部ドキュメントごとに、次のように別々のリンク・オプションを指定します。\fBjavadoc \-link extdocURL1 \-link extdocURL2 \&.\&.\&. \-link extdocURLn com\&.mypackage\fR +\fIextdocURL1\fR、\fIextdocURL2\fR、\&.\fB\&.\&. extdocURLn\fRは、それぞれ外部ドキュメントのルートを指し、各ルートには、package\-listという名前のファイルが入っています。 +.PP +クロスリンク +.PP +以前に作成された複数のドキュメントをクロスリンクする場合、ブートストラップが必要になることがあります。どのドキュメントについてもpackage\-listが存在していない場合は、最初のドキュメントに対して\fBjavadoc\fRコマンドを実行する時点で、2番目のドキュメントのpackage\-listはまだ存在していません。したがって、外部リンクを作成するには、2番目のドキュメントを生成した後で、最初のドキュメントを生成しなおす必要があります。 +.PP +この場合、最初のドキュメント生成の目的は、package\-listを作成することです(パッケージ名を把握している場合は手動で作成してもかまいません)。次に、2番目のドキュメントとその外部リンクを生成します。必要な外部のpackage\-listファイルが存在しない場合は、\fBjavadoc\fRコマンドから警告が出力されます。 .PP \-linkoffline \fIextdocURL packagelistLoc\fR .RS 4 -このオプションは\fI\-link\fRオプションのバリエーションです。両方とも、Javadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。\fIjavadoc\fRコマンドがWeb接続を使用してドキュメントにアクセスできないとき、Web上のドキュメントにリンクするには、\fI\-link\fRo\fIffline\fRオプションを使用します。外部ドキュメントのpackage\-listファイルにアクセスできないとき、またはこのファイルが\fIextdocURL\fRで指定された場所には存在せず、\fIpackageListLoc\fRで指定できる別の場所(通常ローカル)に存在するとき、\fI\-linkoffline\fRオプションを使用します。\fIextdocURL\fRにWorld Wide Web上でしかアクセスできない場合は、\fI\-linkoffline\fRオプションを指定することにより、ドキュメントの生成時に\fIjavadoc\fRコマンドがWebに接続する必要があるという制約がなくなります。もう1つの用途は、ドキュメントを更新するための回避策として使用することです。パッケージのセット全体に対して\fIjavadoc\fRコマンドを実行した後、変更した一部のパッケージに対してのみ\fIjavadoc\fRコマンドを再度実行して、更新されたファイルを、オリジナルのセットに挿入できるようにします。次に例を示します。\fI\-linkoffline\fRオプションは引数を2つ取ります。第1引数は\fI<a href>\fRリンクに組み込まれる文字列を指定し、第2引数はpackage\-listの検索場所を\fI\-linkoffline\fRに伝えます。 +このオプションは\fB\-link\fRオプションのバリエーションです。両方とも、Javadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。\fBjavadoc\fRコマンドがWeb接続を使用してドキュメントにアクセスできないとき、Web上のドキュメントにリンクするには、\fB\-link\fRo\fBffline\fRオプションを使用します。外部ドキュメントのpackage\-listファイルにアクセスできないとき、またはこのファイルが\fBextdocURL\fRで指定された場所には存在せず、\fBpackageListLoc\fRで指定できる別の場所(通常ローカル)に存在するとき、\fB\-linkoffline\fRオプションを使用します。\fBextdocURL\fRにWorld Wide Web上でしかアクセスできない場合は、\fB\-linkoffline\fRオプションを指定することにより、ドキュメントの生成時に\fBjavadoc\fRコマンドがWebに接続する必要があるという制約がなくなります。もう1つの用途は、ドキュメントを更新するための回避策として使用することです。パッケージのセット全体に対して\fBjavadoc\fRコマンドを実行した後、変更した一部のパッケージに対してのみ\fBjavadoc\fRコマンドを再度実行して、更新されたファイルを、オリジナルのセットに挿入できるようにします。次に例を示します。\fB\-linkoffline\fRオプションは引数を2つ取ります。第1引数は\fB<a href>\fRリンクに組み込まれる文字列を指定し、第2引数はpackage\-listの検索場所を\fB\-linkoffline\fRに伝えます。 .sp .RS 4 .ie n \{\ @@ -2839,7 +2949,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIextdocURL\fRの値は、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。相対URLの場合、値は、生成先ディレクトリ(\fI\-d\fRオプションで指定)からリンク先となるパッケージのルートへの相対パスにする必要があります。詳細は、\fI\-link\fRオプションの\fIextdocURL\fRを参照してください。 +\fBextdocURL\fRの値は、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。相対URLの場合、値は、生成先ディレクトリ(\fB\-d\fRオプションで指定)からリンク先となるパッケージのルートへの相対パスにする必要があります。詳細は、\fB\-link\fRオプションの\fIextdocURL\fRを参照してください。 .RE .sp .RS 4 @@ -2850,14 +2960,16 @@ .sp -1 .IP \(bu 2.3 .\} -\fIpackagelistLoc\fRの値は、外部ドキュメントのpackage\-listファイルを含むディレクトリへのパスまたはURLです。これは、URL (http:またはfile:)でもファイル・パスでもかまいません。また、絶対パスと相対パスのどちらでもかまいません。相対パスの場合は、\fIjavadoc\fRコマンドが実行される現在のディレクトリからの相対パスとして指定します。package\-listファイル名を含めないでください。 -.sp -指定した\fIjavadoc\fRコマンドの実行で、複数の\fI\-link\fRオプションを指定できます。Javadoc 1\&.2\&.2より前では、\fI\-linkfile\fRオプションは1回しか指定できませんでした。 -.RE -.RE -外部ドキュメントへの絶対リンク.PP -http://docs\&.oracle\&.com/javase/8/docs/api/index\&.htmlに示すような、\fIjava\&.lang\fR、 -\fIjava\&.io\fRおよびその他のJava SEパッケージにリンクする必要がある場合があります。 +\fBpackagelistLoc\fRの値は、外部ドキュメントのpackage\-listファイルを含むディレクトリへのパスまたはURLです。これは、URL (http:またはfile:)でもファイル・パスでもかまいません。また、絶対パスと相対パスのどちらでもかまいません。相対パスの場合は、\fBjavadoc\fRコマンドが実行される現在のディレクトリからの相対パスとして指定します。package\-listファイル名を含めないでください。 +.sp +指定した\fBjavadoc\fRコマンドの実行で、複数の\fB\-link\fRオプションを指定できます。Javadoc 1\&.2\&.2より前では、\fB\-linkfile\fRオプションは1回しか指定できませんでした。 +.RE +.RE +.PP +外部ドキュメントへの絶対リンク +.PP +http://docs\&.oracle\&.com/javase/8/docs/api/index\&.htmlに示すような、\fBjava\&.lang\fR、 +\fBjava\&.io\fRおよびその他のJava SEパッケージにリンクする必要がある場合があります。 .PP ただし、シェルにはWebアクセス権がありません。この場合、次を行います。 .sp @@ -2880,78 +2992,91 @@ .sp -1 .IP " 2." 4.2 .\} -ファイルをローカル・ディレクトリに保存し、このローカル・コピーを第2引数\fIpackagelistLoc\fRで指定します。この例では、パッケージ・リスト・ファイルはカレント・ディレクトリ(\&.)に保存されています。 -.RE -.PP -次のコマンドは、Java SEプラットフォーム・パッケージへのリンクを持つc\fIom\&.mypackage\fRパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス\fItrees\fR内の\fIObject\fRクラスへのリンクが含まれています。\fI\-sourcepath\fRなど、他の必要なオプションは表示されません。 +ファイルをローカル・ディレクトリに保存し、このローカル・コピーを第2引数\fBpackagelistLoc\fRで指定します。この例では、パッケージ・リスト・ファイルはカレント・ディレクトリ(\&.)に保存されています。 +.RE +.PP +次のコマンドは、Java SEプラットフォーム・パッケージへのリンクを持つc\fBom\&.mypackage\fRパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス\fBtrees\fR内の\fBObject\fRクラスへのリンクが含まれています。\fB\-sourcepath\fRなど、他の必要なオプションは表示されません。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-linkoffline http://docs\&.oracle\&.com/javase/8/docs/api/ \&. com\&.mypackage +\fBjavadoc \-linkoffline http://docs\&.oracle\&.com/javase/8/docs/api/ \&. com\&.mypackage \fR + .fi .if n \{\ .RE .\} -外部ドキュメントへの相対リンク.PP -\fI\-linkoffline\fRを相対パスとともに使用することはあまりありません。理由は単純で、通常は\fI\-link\fRで間に合うからです。\fI\-linkoffline\fRオプションを使用する場合、通常、package\-listファイルはローカルで、相対リンクを使用する場合はリンク先のファイルもローカルなので、通常は\fI\-linkoffline\fRオプションの2つの引数に、異なるパスを指定する必要はありません。2つの引数が同一の場合、\fI\-link\fRオプションを使用できます。 -package\-listファイルの手動での作成.PP -package\-listファイルがまだ存在しなくても、ドキュメントのリンク先のパッケージ名がわかっている場合は、このファイルのコピーを手動で作成し、\fIpackagelistLoc\fRでそのパスを指定することができます。\fIcom\&.apipackage\fRが最初に生成された時点で\fIcom\&.spipackage\fRのパッケージ・リストが存在しないという前出のケースが一例として挙げられます。この方法は、パッケージ名はわかっているものの、まだ公開されていない、新しい外部ドキュメントにリンクするドキュメントを生成する必要がある場合に便利です。また、package\-listファイルが生成されないJavadoc 1\&.0または1\&.1で生成されたパッケージ用にpackage\-listファイルを作成する場合にも、この方法が使用できます。同様に、2つの企業が未公開のpackage\-listファイルを共有できるため、クロスリンクを設定したドキュメントを同時にリリースすることも可能になります。 -複数ドキュメントへのリンク.PP -参照先の生成ドキュメントごとに1回、\fI\-linkoffline\fRオプションを含めることができます。 +.PP +外部ドキュメントへの相対リンク +.PP +\fB\-linkoffline\fRを相対パスとともに使用することはあまりありません。理由は単純で、通常は\fB\-link\fRで間に合うからです。\fB\-linkoffline\fRオプションを使用する場合、通常、package\-listファイルはローカルで、相対リンクを使用する場合はリンク先のファイルもローカルなので、通常は\fB\-linkoffline\fRオプションの2つの引数に、異なるパスを指定する必要はありません。2つの引数が同一の場合、\fB\-link\fRオプションを使用できます。 +.PP +package\-listファイルの手動での作成 +.PP +package\-listファイルがまだ存在しなくても、ドキュメントのリンク先のパッケージ名がわかっている場合は、このファイルのコピーを手動で作成し、\fBpackagelistLoc\fRでそのパスを指定することができます。\fBcom\&.apipackage\fRが最初に生成された時点で\fBcom\&.spipackage\fRのパッケージ・リストが存在しないという前出のケースが一例として挙げられます。この方法は、パッケージ名はわかっているものの、まだ公開されていない、新しい外部ドキュメントにリンクするドキュメントを生成する必要がある場合に便利です。また、package\-listファイルが生成されないJavadoc 1\&.0または1\&.1で生成されたパッケージ用にpackage\-listファイルを作成する場合にも、この方法が使用できます。同様に、2つの企業が未公開のpackage\-listファイルを共有できるため、クロスリンクを設定したドキュメントを同時にリリースすることも可能になります。 +.PP +複数ドキュメントへのリンク +.PP +参照先の生成ドキュメントごとに1回、\fB\-linkoffline\fRオプションを含めることができます。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-linkoffline extdocURL1 packagelistLoc1 \-linkoffline extdocURL2 -packagelistLoc2 \&.\&.\&. +\fBjavadoc \-linkoffline extdocURL1 packagelistLoc1 \-linkoffline extdocURL2\fR +\fBpackagelistLoc2 \&.\&.\&.\fR + .fi .if n \{\ .RE .\} -ドキュメントの更新.PP -プロジェクトに何十または何百のパッケージが含まれる場合にも、\fI\-linkoffline\fRオプションを使用できます。ソース・ツリー全体ですでに\fIjavadoc\fRコマンドを実行したことがある場合、ドキュメンテーション・コメントにわずかな変更を迅速に加え、ソース・ツリーの一部で\fIjavadoc\fRコマンドを再実行することができます。2回目の実行は、ドキュメンテーション・コメントを変更し、宣言は変更しない場合にのみ正しく処理されることに注意してください。ソース・コードに対して宣言を追加、削除、または変更した場合は、索引、パッケージ・ツリー、継承されるメンバーのリスト、使用ページなどの場所で、リンクが壊れることがあります。 -.PP -まず、この新しい小規模な実行で使用する、新しい生成先ディレクトリ(updateなど)を作成します。この例では、元の生成先ディレクトリの名前はhtmlです。最も単純な例では、htmlディレクトリの親ディレクトリに移動します。\fI\-linkoffline\fRオプションの第1引数にカレント・ディレクトリ(\&.)を設定し、第2引数にpackage\-listが検索されるhtmlへの相対パスを設定し、更新するパッケージのパッケージ名のみを渡します。 +.PP +ドキュメントの更新 +.PP +プロジェクトに何十または何百のパッケージが含まれる場合にも、\fB\-linkoffline\fRオプションを使用できます。ソース・ツリー全体ですでに\fBjavadoc\fRコマンドを実行したことがある場合、ドキュメンテーション・コメントにわずかな変更を迅速に加え、ソース・ツリーの一部で\fBjavadoc\fRコマンドを再実行することができます。2回目の実行は、ドキュメンテーション・コメントを変更し、宣言は変更しない場合にのみ正しく処理されることに注意してください。ソース・コードに対して宣言を追加、削除、または変更した場合は、索引、パッケージ・ツリー、継承されるメンバーのリスト、使用ページなどの場所で、リンクが壊れることがあります。 +.PP +まず、この新しい小規模な実行で使用する、新しい生成先ディレクトリ(updateなど)を作成します。この例では、元の生成先ディレクトリの名前はhtmlです。最も単純な例では、htmlディレクトリの親ディレクトリに移動します。\fB\-linkoffline\fRオプションの第1引数にカレント・ディレクトリ(\&.)を設定し、第2引数にpackage\-listが検索されるhtmlへの相対パスを設定し、更新するパッケージのパッケージ名のみを渡します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d update \-linkoffline \&. html com\&.mypackage +\fBjavadoc \-d update \-linkoffline \&. html com\&.mypackage\fR + .fi .if n \{\ .RE .\} .PP -\fIjavadoc\fRコマンドの終了後、update/com/package内の生成されたクラスのページをコピーし(概要や索引は除く)、html/com/package内の元のファイルに上書きします。 +\fBjavadoc\fRコマンドの終了後、update/com/package内の生成されたクラスのページをコピーし(概要や索引は除く)、html/com/package内の元のファイルに上書きします。 .PP \-linksource .RS 4 各ソース・ファイル(行番号付き)のHTMLバージョンを作成し、標準HTMLドキュメントからソース・ファイルへのリンクを追加します。リンクは、ソース・ファイル内に宣言されているクラス、インタフェース、コンストラクタ、メソッド、フィールドに対して作成されます。そうでない場合、たとえばデフォルト・コンストラクタや生成されたクラスに対しては、リンクは作成されません。 .sp -このオプションは、\fI\-public\fR、\fI\-package\fR、\fI\-protected\fRおよび\fI\-private\fRの各オプションとは関係なく、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソース・ファイル内のすべての非公開実装の詳細を公開します。\fI\-private\fRオプションもあわせて指定しないかぎり、非公開のクラスやインタフェースの一部には、リンクを介してアクセスできないことがあります。 -.sp -各リンクは、その宣言内の識別子名の上に作成されます。たとえば、\fIButton\fRクラスのソース・コードへのリンクは、\fIButton\fRという語の上に作成されます。 +このオプションは、\fB\-public\fR、\fB\-package\fR、\fB\-protected\fRおよび\fB\-private\fRの各オプションとは関係なく、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソース・ファイル内のすべての非公開実装の詳細を公開します。\fB\-private\fRオプションもあわせて指定しないかぎり、非公開のクラスやインタフェースの一部には、リンクを介してアクセスできないことがあります。 +.sp +各リンクは、その宣言内の識別子名の上に作成されます。たとえば、\fBButton\fRクラスのソース・コードへのリンクは、\fBButton\fRという語の上に作成されます。 .sp .if n \{\ .RS 4 .\} .nf -public class Button extends Component implements Accessible +\fBpublic class Button extends Component implements Accessible\fR + .fi .if n \{\ .RE .\} -\fIButton\fRクラスの\fIgetLabel\fRメソッドのソース・コードへのリンクは、\fIgetLabel\fRという語の上に作成されます。 +\fBButton\fRクラスの\fBgetLabel\fRメソッドのソース・コードへのリンクは、\fBgetLabel\fRという語の上に作成されます。 .sp .if n \{\ .RS 4 .\} .nf -public String getLabel() +\fBpublic String getLabel()\fR + .fi .if n \{\ .RE @@ -2960,7 +3085,7 @@ .PP \-group groupheading \fIpackagepattern:packagepattern\fR .RS 4 -概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の\fI\-group\fRオプションで指定します。グループは、コマンド行で指定された順序でページに表示されます。パッケージは、グループ内でアルファベット順になっています。指定した\fI\-group\fRオプションでは、\fIpackagepattern\fR式のリストに一致するパッケージが、見出しとして\fIgroupheading\fRを持つ1つの表に表示されます。 +概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の\fB\-group\fRオプションで指定します。グループは、コマンド行で指定された順序でページに表示されます。パッケージは、グループ内でアルファベット順になっています。指定した\fB\-group\fRオプションでは、\fBpackagepattern\fR式のリストに一致するパッケージが、見出しとして\fIgroupheading\fRを持つ1つの表に表示されます。 .sp .RS 4 .ie n \{\ @@ -2970,7 +3095,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIgroupheading\fRには、任意のテキストを指定でき、空白を含めることができます。指定したテキストは、グループの表見出しになります。 +\fBgroupheading\fRには、任意のテキストを指定でき、空白を含めることができます。指定したテキストは、グループの表見出しになります。 .RE .sp .RS 4 @@ -2981,54 +3106,55 @@ .sp -1 .IP \(bu 2.3 .\} -\fIpackagepattern\fRの値には、任意のパッケージ名の先頭部分とそれに続く1つのアスタリスク(*)で任意のパッケージ名を指定できます。アスタリスクは使用できる唯一のワイルドカードで、任意の文字に一致する、という意味です。1つのグループには、コロン(:)で区切って複数のパターンを含めることができます。パターンまたはパターン・リストでアスタリスクを使用する場合、パターン・リストは\fI"java\&.lang*:java\&.util"\fRのように引用符で囲む必要があります。 -.RE -.sp -\fI\-group\fRオプションを指定しない場合は、見出し\fIPackages\fRおよび適切な小見出しを持つ1つのグループに配置されます。小見出しにすべてのドキュメント化されるパッケージ(すべてのグループ)が含まれるわけではない場合、残りのパッケージは「その他のパッケージ」というサブ見出しを持つ独立したグループに入れられます。 -.sp -たとえば、次の\fIjavadoc\fRコマンドでは、3つのドキュメント化されたパッケージが\fI「コア」\fR、\fI「拡張」\fRおよび\fI「その他のパッケージ」\fRに分けられます。\fIjava\&.lang*\fRでは、最後のドット(\&.)を指定していません。\fIjava\&.lang\&.*\fRのようにドットを入れると、\fI java\&.lang\fRパッケージは除外されることになります。 +\fBpackagepattern\fRの値には、任意のパッケージ名の先頭部分とそれに続く1つのアスタリスク(*)で任意のパッケージ名を指定できます。アスタリスクは使用できる唯一のワイルドカードで、任意の文字に一致する、という意味です。1つのグループには、コロン(:)で区切って複数のパターンを含めることができます。パターンまたはパターン・リストでアスタリスクを使用する場合、パターン・リストは\fB"java\&.lang*:java\&.util"\fRのように引用符で囲む必要があります。 +.RE +.sp +\fB\-group\fRオプションを指定しない場合は、見出し\fIPackages\fRおよび適切な小見出しを持つ1つのグループに配置されます。小見出しにすべてのドキュメント化されるパッケージ(すべてのグループ)が含まれるわけではない場合、残りのパッケージは「その他のパッケージ」というサブ見出しを持つ独立したグループに入れられます。 +.sp +たとえば、次の\fBjavadoc\fRコマンドでは、3つのドキュメント化されたパッケージが\fI「コア」\fR、\fI「拡張」\fRおよび\fI「その他のパッケージ」\fRに分けられます。\fBjava\&.lang*\fRでは、最後のドット(\&.)を指定していません。\fBjava\&.lang\&.*\fRのようにドットを入れると、\fB java\&.lang\fRパッケージは除外されることになります。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-group "Core Packages" "java\&.lang*:java\&.util" - \-group "Extension Packages" "javax\&.*" - java\&.lang java\&.lang\&.reflect java\&.util javax\&.servlet java\&.new +\fBjavadoc \-group "Core Packages" "java\&.lang*:java\&.util"\fR +\fB \-group "Extension Packages" "javax\&.*"\fR +\fB java\&.lang java\&.lang\&.reflect java\&.util javax\&.servlet java\&.new\fR + .fi .if n \{\ .RE .\} \fBコア・パッケージ\fR .sp -\fIjava\&.lang\fR -.sp -\fIjava\&.lang\&.reflect\fR -.sp -\fIjava\&.util\fR +\fBjava\&.lang\fR +.sp +\fBjava\&.lang\&.reflect\fR +.sp +\fBjava\&.util\fR .sp \fB拡張機能パッケージ\fR .sp -\fIjavax\&.servlet\fR +\fBjavax\&.servlet\fR .sp \fBOther Packages\fR .sp -\fIjava\&.new\fR +\fBjava\&.new\fR .RE .PP \-nodeprecated .RS 4 -非推奨のAPIをドキュメントに生成しないようにします。このオプションを指定すると、\fI\-nodeprecatedlist\fRオプションを指定した場合と同じ効果があり、ドキュメントの他の部分全体でも、非推奨のAPIが生成されません。このオプションは、コードを記述しているとき、非推奨のコードによって気を散らされたくない場合に便利です。 +非推奨のAPIをドキュメントに生成しないようにします。このオプションを指定すると、\fB\-nodeprecatedlist\fRオプションを指定した場合と同じ効果があり、ドキュメントの他の部分全体でも、非推奨のAPIが生成されません。このオプションは、コードを記述しているとき、非推奨のコードによって気を散らされたくない場合に便利です。 .RE .PP \-nodeprecatedlist .RS 4 -非推奨のAPIのリストを含むファイル(deprecated\-list\&.html)、およびナビゲーション・バーのそのページへのリンクが生成されないようにします。\fIjavadoc\fRコマンドでは、引き続き、ドキュメントの他の部分では、非推奨のAPIが生成されます。このオプションは、非推奨のAPIがソース・コードに含まれておらず、ナビゲーション・バーをすっきりと見せる場合に便利です。 +非推奨のAPIのリストを含むファイル(deprecated\-list\&.html)、およびナビゲーション・バーのそのページへのリンクが生成されないようにします。\fBjavadoc\fRコマンドでは、引き続き、ドキュメントの他の部分では、非推奨のAPIが生成されます。このオプションは、非推奨のAPIがソース・コードに含まれておらず、ナビゲーション・バーをすっきりと見せる場合に便利です。 .RE .PP \-nosince .RS 4 -生成ドキュメントから、\fI@since\fRタグに関連付けられた\fI「導入されたバージョン」\fRセクションを省略します。 +生成ドキュメントから、\fB@since\fRタグに関連付けられた\fB「導入されたバージョン」\fRセクションを省略します。 .RE .PP \-notree @@ -3048,18 +3174,19 @@ .PP \-nonavbar .RS 4 -通常、生成されるページの最上部と最下部に表示されるナビゲーション・バー、ヘッダー、およびフッターを生成しないようにします。\fI\-nonavbar\fRオプションは\fI\-bottom\fRオプションに影響を与えません。\fI\-nonavbar\fRオプションは、印刷するためにのみファイルをPostScriptやPDFに変換する場合など、内容のみが重要で、ナビゲーションの必要がない場合に便利です。 +通常、生成されるページの最上部と最下部に表示されるナビゲーション・バー、ヘッダー、およびフッターを生成しないようにします。\fB\-nonavbar\fRオプションは\fB\-bottom\fRオプションに影響を与えません。\fB\-nonavbar\fRオプションは、印刷するためにのみファイルをPostScriptやPDFに変換する場合など、内容のみが重要で、ナビゲーションの必要がない場合に便利です。 .RE .PP \-helpfile \fIpath\efilename\fR .RS 4 -最上部および最下部のナビゲーション・バーの「ヘルプ」リンクのリンク先となる代替ヘルプ・ファイルpath\efilenameのパスを指定します。このオプションが指定されていないと、\fIjavadoc\fRコマンドは、\fIjavadoc\fRコマンド内でハードコードされているヘルプ・ファイルhelp\-doc\&.htmlを自動作成します。このオプションを使用すると、デフォルトをオーバーライドできます。ファイル名にはどんな名前でも指定でき、help\-doc\&.htmlに限定されません。\fIjavadoc\fRコマンドは、次の例のように、ナビゲーション・バー内のリンクを必要に応じて調整します。 +最上部および最下部のナビゲーション・バーの「ヘルプ」リンクのリンク先となる代替ヘルプ・ファイルpath\efilenameのパスを指定します。このオプションが指定されていないと、\fBjavadoc\fRコマンドは、\fBjavadoc\fRコマンド内でハードコードされているヘルプ・ファイルhelp\-doc\&.htmlを自動作成します。このオプションを使用すると、デフォルトをオーバーライドできます。ファイル名にはどんな名前でも指定でき、help\-doc\&.htmlに限定されません。\fBjavadoc\fRコマンドは、次の例のように、ナビゲーション・バー内のリンクを必要に応じて調整します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-helpfile /home/user/myhelp\&.html java\&.awt\&. +\fBjavadoc \-helpfile /home/user/myhelp\&.html java\&.awt\&.\fR + .fi .if n \{\ .RE @@ -3068,13 +3195,14 @@ .PP \-stylesheet \fIpath/filename \fR .RS 4 -代替HTMLスタイルシート・ファイルのパスを指定します。このオプションが指定されていないと、\fIjavadoc\fRコマンドは、\fIjavadoc\fRコマンド内でハードコードされているスタイルシート・ファイルstylesheet\&.cssを自動作成します。このオプションを使用すると、デフォルトをオーバーライドできます。ファイル名にはどんな名前でも指定でき、stylesheet\&.cssに限定されません。 +代替HTMLスタイルシート・ファイルのパスを指定します。このオプションが指定されていないと、\fBjavadoc\fRコマンドは、\fBjavadoc\fRコマンド内でハードコードされているスタイルシート・ファイルstylesheet\&.cssを自動作成します。このオプションを使用すると、デフォルトをオーバーライドできます。ファイル名にはどんな名前でも指定でき、stylesheet\&.cssに限定されません。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-stylesheet file /home/user/mystylesheet\&.css com\&.mypackage +\fBjavadoc \-stylesheet file /home/user/mystylesheet\&.css com\&.mypackage\fR + .fi .if n \{\ .RE @@ -3083,7 +3211,7 @@ .PP \-serialwarn .RS 4 -\fI@serial\fRタグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1\&.2\&.2以降では、直列化の警告は生成されません。以前のリリースとは逆の動作です。このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと\fIwriteExternal\fRメソッドを適切にドキュメント化するのに役立ちます。 +\fB@serial\fRタグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1\&.2\&.2以降では、直列化の警告は生成されません。以前のリリースとは逆の動作です。このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと\fBwriteExternal\fRメソッドを適切にドキュメント化するのに役立ちます。 .RE .PP \-charset \fIname\fR @@ -3091,18 +3219,19 @@ このドキュメント用のHTML文字セットを指定します。この名前は、IANA RegistryのCharacter Sets (http://www\&.iana\&.org/assignments/character\-sets)に示された、優先MIME名である必要があります。 .sp -たとえば、\fIjavadoc \-charset "iso\-8859\-1" mypackage\fRは次の行を生成された各ページのヘッダーに挿入します。 +たとえば、\fBjavadoc \-charset "iso\-8859\-1" mypackage\fRは次の行を生成された各ページのヘッダーに挿入します。 .sp .if n \{\ .RS 4 .\} .nf -<META http\-equiv="Content\-Type" content="text/html; charset=ISO\-8859\-1"> +\fB<META http\-equiv="Content\-Type" content="text/html; charset=ISO\-8859\-1">\fR + .fi .if n \{\ .RE .\} -この\fIMETA\fRタグは、HTML標準(4197265および4137321)のHTML Document Representation +この\fBMETA\fRタグは、HTML標準(4197265および4137321)のHTML Document Representation (http://www\&.w3\&.org/TR/REC\-html40/charset\&.html#h\-5\&.2\&.2)に記載されています。 .sp およびオプションも参照してください。 @@ -3113,22 +3242,23 @@ 生成されるHTMLファイルのエンコーディングを指定します。この名前は、IANA RegistryのCharacter Sets (http://www\&.iana\&.org/assignments/character\-sets)に示された、優先MIME名である必要があります。 .sp -\fI\-docencoding\fRオプションを省略し、\fI\-encoding\fRオプションを使用すると、生成されたHTMLファイルの暗号化は\fI\-encoding\fRオプションで特定されます。例: -\fIjavadoc \-docencoding"iso\-8859\-1" mypackage\fRおよびオプションも参照してください。 +\fB\-docencoding\fRオプションを省略し、\fB\-encoding\fRオプションを使用すると、生成されたHTMLファイルの暗号化は\fB\-encoding\fRオプションで特定されます。例: +\fBjavadoc \-docencoding "iso\-8859\-1" mypackage\fRおよびオプションも参照してください。 .RE .PP \-keywords .RS 4 -HTMLキーワード<META>タグを、クラスごとに生成されるファイルに追加します。これらのタグは、<META>タグを検索するサーチ・エンジンがページを見つける場合に役立ちます。インターネット全体を検索する検索エンジンのほとんどは<META>タグを参照しません。ページが誤用している可能性があるからです。自身のWebサイトへの検索を制限する、企業により提供される検索エンジンは、<META>タグを参照することで恩恵を受けることができます。<META>タグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス\fIString\fRは次のキーワードで開始します。 +HTMLキーワード<META>タグを、クラスごとに生成されるファイルに追加します。これらのタグは、<META>タグを検索するサーチ・エンジンがページを見つける場合に役立ちます。インターネット全体を検索する検索エンジンのほとんどは<META>タグを参照しません。ページが誤用している可能性があるからです。自身のWebサイトへの検索を制限する、企業により提供される検索エンジンは、<META>タグを参照することで恩恵を受けることができます。<META>タグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス\fBString\fRは次のキーワードで開始します。 .sp .if n \{\ .RS 4 .\} .nf -<META NAME="keywords" CONTENT="java\&.lang\&.String class"> -<META NAME="keywords" CONTENT="CASE_INSENSITIVE_ORDER"> -<META NAME="keywords" CONTENT="length()"> -<META NAME="keywords" CONTENT="charAt()"> +\fB<META NAME="keywords" CONTENT="java\&.lang\&.String class">\fR +\fB<META NAME="keywords" CONTENT="CASE_INSENSITIVE_ORDER">\fR +\fB<META NAME="keywords" CONTENT="length()">\fR +\fB<META NAME="keywords" CONTENT="charAt()">\fR + .fi .if n \{\ .RE @@ -3137,105 +3267,108 @@ .PP \-tag \fItagname\fR:Xaoptcmf:"\fItaghead\fR" .RS 4 -\fIjavadoc\fRコマンドがドキュメンテーション・コメント内の引数を1つ取る単純なカスタム・ブロック・タグ\fI@tagname\fRを解釈できるようにします。これにより、\fIjavadoc\fRコマンドはタグ名のスペルチェックを行うことができるので、ソース・コード内に存在するすべてのカスタム・タグについて、\fI\-tag\fRオプションを組み込むことが重要です。今回の実行では出力されないタグは、\fIX\fRを付けて無効にします。\fI\-tag\fRオプションは、タグの見出し\fItaghead\fRを太字で出力します。その次の行には、このオプションの1つの引数で指定したテキストが続きます。ブロック・タグと同様、この引数のテキストにはインライン・タグを含めることができます。このインライン・タグも解釈されます。出力は、引数を1つ取る標準のタグ(\fI@return\fRや\fI@author\fRなど)の出力とよく似ています。\fItaghead\fRの値を省略すると、\fItagname\fRが見出しとして表示されます。 +\fBjavadoc\fRコマンドがドキュメンテーション・コメント内の引数を1つ取る単純なカスタム・ブロック・タグ\fB@tagname\fRを解釈できるようにします。これにより、\fBjavadoc\fRコマンドはタグ名のスペルチェックを行うことができるので、ソース・コード内に存在するすべてのカスタム・タグについて、\fB\-tag\fRオプションを組み込むことが重要です。今回の実行では出力されないタグは、\fBX\fRを付けて無効にします。\fB\-tag\fRオプションは、タグの見出し\fItaghead\fRを太字で出力します。その次の行には、このオプションの1つの引数で指定したテキストが続きます。ブロック・タグと同様、この引数のテキストにはインライン・タグを含めることができます。このインライン・タグも解釈されます。出力は、引数を1つ取る標準のタグ(\fB@return\fRや\fB@author\fRなど)の出力とよく似ています。\fItaghead\fRの値を省略すると、\fBtagname\fRが見出しとして表示されます。 .sp \fBタグの配置\fR: -\fIXaoptcmf\fR引数により、ソース・コード内でタグを配置できる場所が決まり、タグを無効にできるかどうか(\fIX\fRを使用して)が決まります。タグの配置位置を制限しない場合は\fIa\fRを指定します。それ以外の文字の組合せも可能です。 -.sp -\fIX\fR +\fBXaoptcmf\fR引数により、ソース・コード内でタグを配置できる場所が決まり、タグを無効にできるかどうか(\fBX\fRを使用して)が決まります。タグの配置位置を制限しない場合は\fBa\fRを指定します。それ以外の文字の組合せも可能です。 +.sp +\fBX\fR (タグの無効化) .sp -\fIa\fR +\fBa\fR (すべて) .sp -\fIo\fR +\fBo\fR (概要) .sp -\fIp\fR +\fBp\fR (パッケージ) .sp -\fIt\fR +\fBt\fR (タイプ、つまりクラスとインタフェース) .sp -\fIc\fR +\fBc\fR (コンストラクタ) .sp -\fIm\fR +\fBm\fR (メソッド) .sp -\fIf\fR +\fBf\fR (フィールド) .sp -\fBシングル・タグの例\fR: ソース・コード内の任意の位置で使用できるタグのタグ・オプションの例を示します。\fI\-tag todo:a:"To Do:"\fR -.sp -\fI@todo\fRタグをコンストラクタ、メソッドおよびフィールドとのみ使用する場合、\fI\-tag todo:cmf:"To Do:"\fRを使用します。 -.sp -最後のコロン(:)は、パラメータ区切り文字ではなく、見出しテキストの一部になっています。\fI@todo\fRタグを含む、ソース・コード用のいずれかのタグ・オプションを使用します。たとえば、\fI@todo The documentation for this method needs work\fRです。 -.sp -\fBタグ名内のコロン\fR: タグ名内でコロンを使用する場合はバックスラッシュを使用してエスケープします。次のドキュメンテーション・コメントには、\fI\-tag ejb\e\e:bean:a:"EJB Bean:"\fRオプションを使用します。 +\fBシングル・タグの例\fR: ソース・コード内の任意の位置で使用できるタグのタグ・オプションの例を示します。\fB\-tag todo:a:"To Do:"\fR +.sp +\fB@todo\fRタグをコンストラクタ、メソッドおよびフィールドとのみ使用する場合、\fB\-tag todo:cmf:"To Do:"\fRを使用します。 +.sp +最後のコロン(:)は、パラメータ区切り文字ではなく、見出しテキストの一部になっています。\fB@todo\fRタグを含む、ソース・コード用のいずれかのタグ・オプションを使用します。たとえば、\fB@todo The documentation for this method needs work\fRです。 +.sp +\fBタグ名内のコロン\fR: タグ名内でコロンを使用する場合はバックスラッシュを使用してエスケープします。次のドキュメンテーション・コメントには、\fB\-tag ejb\e\e:bean:a:"EJB Bean:"\fRオプションを使用します。 .sp .if n \{\ .RS 4 .\} .nf -/** - * @ejb:bean - */ +\fB/**\fR +\fB * @ejb:bean\fR +\fB */\fR + .fi .if n \{\ .RE .\} -\fBタグ名のスペルチェック\fR: 一部の開発者が必ずしも出力しないカスタム・タグをソース・コード内に配置することがあります。この場合、ソース・コード内のすべてのタグをリストし、出力するタグを有効にし、出力しないタグを無効にする必要があります。\fIX\fRを指定するとタグは無効になります。指定しないと、タグは有効になります。これにより、\fIjavadoc\fRコマンドは、検出したタグが入力ミスなどによる不明タグであるかどうかを特定できます。このような場合に、\fIjavadoc\fRコマンドから警告が出力されます。すでに配置されている値に\fIX\fRを追加できます。こうしておけば、\fIX\fRを削除するのみでタグを有効にすることができます。たとえば、\fI@todo\fRタグを出力で抑制する場合、\fI\-tag todo:Xcmf:"To Do:"\fRを使用します。さらに簡単にする場合、\fI\-tag todo:X\fRを使用します。構文\fI\-tag todo:X\fRは、\fI@todo\fRタグがタグレットで定義されていても機能します。 +\fBタグ名のスペルチェック\fR: 一部の開発者が必ずしも出力しないカスタム・タグをソース・コード内に配置することがあります。この場合、ソース・コード内のすべてのタグをリストし、出力するタグを有効にし、出力しないタグを無効にする必要があります。\fBX\fRを指定するとタグは無効になります。指定しないと、タグは有効になります。これにより、\fBjavadoc\fRコマンドは、検出したタグが入力ミスなどによる不明タグであるかどうかを特定できます。このような場合に、\fBjavadoc\fRコマンドから警告が出力されます。すでに配置されている値に\fBX\fRを追加できます。こうしておけば、\fBX\fRを削除するのみでタグを有効にすることができます。たとえば、\fB@todo\fRタグを出力で抑制する場合、\fB\-tag todo:Xcmf:"To Do:"\fRを使用します。さらに簡単にする場合、\fB\-tag todo:X\fRを使用します。構文\fB\-tag todo:X\fRは、\fB@todo\fRタグがタグレットで定義されていても機能します。 .sp \fBタグの順序\fR: -\fI\-ta\fR\fIg\fRおよび\fI\-taglet\fRオプションの順序によって、タグの出力順が決まります。カスタム・タグと標準タグを組み合せて使用することもできます。標準タグのタグ・オプションは、順序を決定するためだけのプレースホルダです。標準タグの名前のみを取ります。標準タグの小見出しは変更できません。これを次の例に示します。\fI\-tag\fRオプションを指定しないと、\fI\-tagle\fR\fIt\fRオプションの位置により、順序が決まります。タグが両方とも存在する場合、コマンドラインの最後にある方がその順序を決定します。これは、タグやタグレットがコマンドラインに指定された順番に処理されるためです。たとえば、\fI\-taglet\fRおよび\fI\-tag\fRオプションが名前\fItodo\fR値を持つ場合、コマンドラインに最後に指定されたものが順序を決定します。 -.sp -\fBタグの完全セットの例\fR: この例では、出力のParametersとThrowsの間にTo Doを挿入します。\fIX\fRを使用して、\fI@example\fRタグが、ソース・コード内の今回の実行では出力されないタグであることも指定します。\fI@argfile\fRタグを使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます(行の継続を示す文字は不要)。 +\fB\-ta\fR\fBg\fRおよび\fB\-taglet\fRオプションの順序によって、タグの出力順が決まります。カスタム・タグと標準タグを組み合せて使用することもできます。標準タグのタグ・オプションは、順序を決定するためだけのプレースホルダです。標準タグの名前のみを取ります。標準タグの小見出しは変更できません。これを次の例に示します。\fB\-tag\fRオプションを指定しないと、\fB\-tagle\fR\fBt\fRオプションの位置により、順序が決まります。タグが両方とも存在する場合、コマンド行の最後にある方がその順序を決定します。これは、タグやタグレットがコマンド行に指定された順番に処理されるためです。たとえば、\fB\-taglet\fRおよび\fB\-tag\fRオプションが名前\fBtodo\fR値を持つ場合、コマンド行に最後に指定されたものが順序を決定します。 +.sp +\fBタグの完全セットの例\fR: この例では、出力のParametersとThrowsの間にTo Doを挿入します。\fBX\fRを使用して、\fB@example\fRタグが、ソース・コード内の今回の実行では出力されないタグであることも指定します。\fB@argfile\fRタグを使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます(行の継続を示す文字は不要)。 .sp .if n \{\ .RS 4 .\} .nf -\-tag param -\-tag return -\-tag todo:a:"To Do:" -\-tag throws -\-tag see -\-tag example:X +\fB\-tag param\fR +\fB\-tag return\fR +\fB\-tag todo:a:"To Do:"\fR +\fB\-tag throws\fR +\fB\-tag see\fR +\fB\-tag example:X\fR + .fi .if n \{\ .RE .\} -\fIjavadoc\fRコマンドがドキュメンテーション・コメントを解析する際に検索されたタグのうち、標準タグでも、\fI\-tag\fRや\fI\-taglet\fRオプションで渡されたタグでもないものはすべて不明タグとみなされ、警告がスローされます。 -.sp -標準タグは、最初、デフォルトの順序でリスト内に内部的に格納されます。\fI\-tag\fRオプションを使用すると、それらのタグはこのリストに追加されます。標準タグは、デフォルトの位置から移動されます。そのため、標準タグの\fI\-tag\fRオプションを省略すると、それはデフォルトの位置に配置されたままになります。 -.sp -\fB競合の回避\fR: 固有の名前空間を作成するには、パッケージに使用されている\fIcom\&.mycompany\&.todo\fRという名前のように、ドットで区切られた名前を使用します。Oracleは、今後も名前にドットを含まない標準タグを作成します。ユーザーが作成したタグは、Oracleが定義する同じ名前のタグの動作をオーバーライドします。\fI@todo\fRという名前のタグまたはタグレットをユーザーが作成した場合、その後にOracleが同じ名前の標準タグを作成しても、そのタグまたはタグレットは常にユーザーが定義したのと同じ動作を保持します。 +\fBjavadoc\fRコマンドがドキュメンテーション・コメントを解析する際に検索されたタグのうち、標準タグでも、\fB\-tag\fRや\fB\-taglet\fRオプションで渡されたタグでもないものはすべて不明タグとみなされ、警告がスローされます。 +.sp +標準タグは、最初、デフォルトの順序でリスト内に内部的に格納されます。\fB\-tag\fRオプションを使用すると、それらのタグはこのリストに追加されます。標準タグは、デフォルトの位置から移動されます。そのため、標準タグの\fB\-tag\fRオプションを省略すると、それはデフォルトの位置に配置されたままになります。 +.sp +\fB競合の回避\fR: 固有の名前空間を作成するには、パッケージに使用されている\fBcom\&.mycompany\&.todo\fRという名前のように、ドットで区切られた名前を使用します。Oracleは、今後も名前にドットを含まない標準タグを作成します。ユーザーが作成したタグは、Oracleが定義する同じ名前のタグの動作をオーバーライドします。\fB@todo\fRという名前のタグまたはタグレットをユーザーが作成した場合、その後にOracleが同じ名前の標準タグを作成しても、そのタグまたはタグレットは常にユーザーが定義したのと同じ動作を保持します。 .sp \fB注釈vs\&. Javadocタグ\fR: 一般に、追加する必要のあるマークアップが、ドキュメントに影響を与えたりドキュメントを生成したりするためのものである場合、そのマークアップはJavadocタグにします。それ以外の場合は注釈にします。JavadocツールでのDocコメントの記述方法のカスタム・タグと注釈に関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#annotations)を参照してください。 .sp -\fI\-taglet\fRオプションを使用して、より複雑なブロック・タグやカスタム・インライン・タグも作成できます。 +\fB\-taglet\fRオプションを使用して、より複雑なブロック・タグやカスタム・インライン・タグも作成できます。 .RE .PP \-taglet \fIclass\fR .RS 4 -そのタグのドキュメントの生成に使用するドックレットを起動するためのクラス・ファイルを指定します。\fIclass\fR値の完全修飾名を使用します。このタグレットは、カスタム・タグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。タグレットの例を使用した豊富なドキュメントについては、タグレットの概要 +そのタグのドキュメントの生成に使用するドックレットを起動するためのクラス・ファイルを指定します。\fBclass\fR値の完全修飾名を使用します。このタグレットは、カスタム・タグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。タグレットの例を使用した豊富なドキュメントについては、タグレットの概要 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/taglet/overview\&.html)を参照してください。 .sp -タグレットは、ブロックタグまたはインライン・タグで便利です。タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。タグレットへのパスを指定するには、\fI\-tagletpath\fRオプションを使用します。次に、生成されるページのParametersとThrowsの間にTo Doタグレットを挿入する例を示します。または、\fI\-taglet\fRオプションをその\fI\-tag\fRオプションのかわりに使用することができますが、読み取りが困難になる可能性があります。 +タグレットは、ブロックタグまたはインライン・タグで便利です。タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。タグレットへのパスを指定するには、\fB\-tagletpath\fRオプションを使用します。次に、生成されるページのParametersとThrowsの間にTo Doタグレットを挿入する例を示します。または、\fB\-taglet\fRオプションをその\fB\-tag\fRオプションのかわりに使用することができますが、読み取りが困難になる可能性があります。 .sp .if n \{\ .RS 4 .\} .nf -\-taglet com\&.sun\&.tools\&.doclets\&.ToDoTaglet -\-tagletpath /home/taglets -\-tag return -\-tag param -\-tag todo -\-tag throws -\-tag see +\fB\-taglet com\&.sun\&.tools\&.doclets\&.ToDoTaglet\fR +\fB\-tagletpath /home/taglets \fR +\fB\-tag return\fR +\fB\-tag param\fR +\fB\-tag todo\fR +\fB\-tag throws\fR +\fB\-tag see\fR + .fi .if n \{\ .RE @@ -3244,7 +3377,7 @@ .PP \-tagletpath \fItagletpathlist\fR .RS 4 -tagletクラス・ファイルを検索するための検索パスを指定します。\fItagletpathlist\fRには、コロン(:)で区切って複数のパスを含めることができます。\fIjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。 +tagletクラス・ファイルを検索するための検索パスを指定します。\fBtagletpathlist\fRには、コロン(:)で区切って複数のパスを含めることができます。\fBjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。 .RE .PP \-docfilesubdirs @@ -3259,21 +3392,21 @@ .PP \-noqualifier all | \fIpackagename1\fR:\fIpackagename2\&.\&.\&.\fR .RS 4 -出力されるクラス名から修飾パッケージ名を省略します。\fI\-noqualifier\fRオプションの引数は、\fIall\fR(すべてのパッケージ修飾子を省略)、または修飾子として削除するパッケージのコロン区切りリスト(ワイルドカードも可)、のいずれかとなります。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。ソース・ファイルの処理を参照してください。 -.sp -次の例では、すべてのパッケージ修飾子を省略します。\fI\-noqualifier all\fR -.sp -次の例では、\fIjava\&.lang\fRおよび\fIjava\&.io\fRパッケージ修飾子を省略します: -\fI\-noqualifier java\&.lang:java\&.io\fR。 -.sp -次の例では、\fIjava\fRで始まるパッケージ修飾子および\fIcom\&.sun\fRサブパッケージを省略しますが、\fIjavax\fRは省略しません。\fI\-noqualifier java\&.*:com\&.sun\&.*\fR -.sp -パッケージ修飾子が前述の動作に従って表示される場合、名前は適切に短縮されます。「名前が表示される方法」を参照してください。このルールは、\fI\-noqualifier\fRオプションを使用するかどうかにかかわらず有効です。 +出力されるクラス名から修飾パッケージ名を省略します。\fB\-noqualifier\fRオプションの引数は、\fBall\fR(すべてのパッケージ修飾子を省略)、または修飾子として削除するパッケージのコロン区切りリスト(ワイルドカードも可)、のいずれかとなります。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。ソース・ファイルの処理を参照してください。 +.sp +次の例では、すべてのパッケージ修飾子を省略します。\fB\-noqualifier all\fR +.sp +次の例では、\fBjava\&.lang\fRおよび\fBjava\&.io\fRパッケージ修飾子を省略します: +\fB\-noqualifier java\&.lang:java\&.io\fR。 +.sp +次の例では、\fBjava\fRで始まるパッケージ修飾子および\fBcom\&.sun\fRサブパッケージを省略しますが、\fBjavax\fRは省略しません。\fB\-noqualifier java\&.*:com\&.sun\&.*\fR +.sp +パッケージ修飾子が前述の動作に従って表示される場合、名前は適切に短縮されます。「名前が表示される方法」を参照してください。このルールは、\fB\-noqualifier\fRオプションを使用するかどうかにかかわらず有効です。 .RE .PP \-notimestamp .RS 4 -タイムスタンプが抑制されます。各ページの先頭近くにある、生成されたHTML内のHTMLコメントでタイムスタンプが隠されます。\fI\-notimestamp\fRオプションは、\fIjavadoc\fRコマンドを2つのソース・ベースで実行し、それらの間の差分\fIdiff\fRを取得する場合に役立ちます。タイムスタンプによる\fIdiff\fRの発生を防ぐからです(そうでないとすべてのページで\fIdiff\fRになります)。タイムスタンプには\fIjavadoc\fRコマンドのリリース番号が含まれ、現在では、\fI<!\-\- Generated by javadoc (build 1\&.5\&.0_01) on Thu Apr 02 14:04:52 IST 2009 \-\->\fRのように表示されます。 +タイムスタンプが抑制されます。各ページの先頭近くにある、生成されたHTML内のHTMLコメントでタイムスタンプが隠されます。\fB\-notimestamp\fRオプションは、\fBjavadoc\fRコマンドを2つのソース・ベースで実行し、それらの間の差分\fBdiff\fRを取得する場合に役立ちます。タイムスタンプによる\fBdiff\fRの発生を防ぐからです(そうでないとすべてのページで\fBdiff\fRになります)。タイムスタンプには\fBjavadoc\fRコマンドのリリース番号が含まれ、現在では、\fB<!\-\- Generated by javadoc (build 1\&.5\&.0_01) on Thu Apr 02 14:04:52 IST 2009 \-\->\fRのように表示されます。 .RE .PP \-nocomment @@ -3285,24 +3418,28 @@ .RS 4 ソース内で各タブが使用する空白文字の数を指定します。 .RE -.SH "コマンドライン引数ファイル" -.PP -\fIjavadoc\fRコマンドを短くしたり簡潔にしたりするために、\fIjavadoc\fRコマンドに対する引数(\fI\-J\fRオプションを除く)が入った1つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティング・システム上でも、任意の長さの\fIjavadoc\fRコマンドを作成できます。 -.PP -引数ファイルには、\fIjavac\fRのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に埋め込まれた空白がある場合、ファイル名全体を二重引用符で囲みます。 -.PP -引数ファイル内のファイル名は、引数ファイルの位置ではなく、現在のディレクトリに相対的となります。これらのリストでは、ワイルドカード(\fI*\fR)は使用できません。たとえば、*\&.javaとは指定できません。アットマーク(@)を使用して、ファイルを再帰的に解釈することはできません。また、\fI\-J\fRオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 -.PP -\fIjavadoc\fRを実行するときに、各引数ファイルのパスとファイル名の先頭に@文字を付けて渡します。\fIjavadoc\fRコマンドは、アットマーク(@)文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 -.PP -\fBExample 1\fR, 単一の引数ファイル -.RS 4 -\fIargfile\fRという名前の1つの引数ファイルを使用して、すべての\fIjavadoc\fRコマンド引数を保持できます。\fIjavadoc @argfile\fR次の例に示すように、この引数ファイルには両方のファイルの内容が含まれています。 -.RE -.PP -\fBExample 2\fR, 2つの引数ファイル -.RS 4 -次のように、2つの引数ファイルを作成できます。\fIjavadoc\fRコマンドのオプション用に1つ、パッケージ名またはソース・ファイル名用に1つです。次のリストでは行継続文字を使用していません。 +.SH "コマンド行引数ファイル" +.PP +\fBjavadoc\fRコマンドを短くしたり簡潔にしたりするために、\fBjavadoc\fRコマンドに対する引数(\fB\-J\fRオプションを除く)が入った1つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティング・システム上でも、任意の長さの\fBjavadoc\fRコマンドを作成できます。 +.PP +引数ファイルには、\fBjavac\fRのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に埋め込まれた空白がある場合、ファイル名全体を二重引用符で囲みます。 +.PP +引数ファイル内のファイル名は、引数ファイルの位置ではなく、現在のディレクトリに相対的となります。これらのリストでは、ワイルドカード(\fB*\fR)は使用できません。たとえば、*\&.javaとは指定できません。アットマーク(@)を使用して、ファイルを再帰的に解釈することはできません。また、\fB\-J\fRオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 +.PP +\fBjavadoc\fRを実行するときに、各引数ファイルのパスとファイル名の先頭に@文字を付けて渡します。\fBjavadoc\fRコマンドは、アットマーク(@)文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 +.PP +\fB例 1\fR +.br +単一の引数ファイル +.RS 4 +\fBargfile\fRという名前の1つの引数ファイルを使用して、すべての\fBjavadoc\fRコマンド引数を保持できます。\fBjavadoc @argfile\fR次の例に示すように、この引数ファイルには両方のファイルの内容が含まれています。 +.RE +.PP +\fB例 2\fR +.br +2つの引数ファイル +.RS 4 +次のように、2つの引数ファイルを作成できます。\fBjavadoc\fRコマンドのオプション用に1つ、パッケージ名またはソース・ファイル名用に1つです。次のリストでは行継続文字を使用していません。 .sp 次の内容を含む、optionsという名前のファイルを作成します。 .sp @@ -3310,16 +3447,17 @@ .RS 4 .\} .nf -\-d docs\-filelist -\-use -\-splitindex -\-windowtitle \*(AqJava SE 7 API Specification\*(Aq -\-doctitle \*(AqJava SE 7 API Specification\*(Aq -\-header \*(Aq<b>Java(TM) SE 7</b>\*(Aq -\-bottom \*(AqCopyright © 1993\-2011 Oracle and/or its affiliates\&. All rights reserved\&.\*(Aq -\-group "Core Packages" "java\&.*" -\-overview /java/pubs/ws/1\&.7\&.0/src/share/classes/overview\-core\&.html -\-sourcepath /java/pubs/ws/1\&.7\&.0/src/share/classes +\fB\-d docs\-filelist \fR +\fB\-use \fR +\fB\-splitindex\fR +\fB\-windowtitle \*(AqJava SE 7 API Specification\*(Aq\fR +\fB\-doctitle \*(AqJava SE 7 API Specification\*(Aq\fR +\fB\-header \*(Aq<b>Java(TM) SE 7</b>\*(Aq\fR +\fB\-bottom \*(AqCopyright © 1993\-2011 Oracle and/or its affiliates\&. All rights reserved\&.\*(Aq\fR +\fB\-group "Core Packages" "java\&.*"\fR +\fB\-overview /java/pubs/ws/1\&.7\&.0/src/share/classes/overview\-core\&.html\fR +\fB\-sourcepath /java/pubs/ws/1\&.7\&.0/src/share/classes\fR + .fi .if n \{\ .RE @@ -3330,170 +3468,199 @@ .RS 4 .\} .nf -com\&.mypackage1 -com\&.mypackage2 -com\&.mypackage3 +\fBcom\&.mypackage1\fR +\fBcom\&.mypackage2\fR +\fBcom\&.mypackage3\fR + .fi .if n \{\ .RE .\} -次のように、\fIjavadoc\fRコマンドを実行します。 +次のように、\fBjavadoc\fRコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc @options @packages +\fBjavadoc @options @packages\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, パスを使用した引数ファイル -.RS 4 -引数ファイルはパスを指定できますが、ファイル内のすべてのファイル名は、(\fIpath1\fRや\fIpath2\fRではなく)次のように現在の作業ディレクトリに相対的となります。 +\fB例 3\fR +.br +パスを使用した引数ファイル +.RS 4 +引数ファイルはパスを指定できますが、ファイル内のすべてのファイル名は、(\fBpath1\fRや\fBpath2\fRではなく)次のように現在の作業ディレクトリに相対的となります。 .sp .if n \{\ .RS 4 .\} .nf -javadoc @path1/options @path2/packages +\fBjavadoc @path1/options @path2/packages\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 4\fR, オプション引数 -.RS 4 -次に、\fIjavadoc\fRコマンドのオプションに対する引数を引数ファイルに格納する例を示します。長い引数を指定できるので、\fI\-bottom\fRオプションを使用します。次のようなテキスト引数を含む、bottomという名前のファイルを作成できます。 +\fB例 4\fR +.br +オプション引数 +.RS 4 +次に、\fBjavadoc\fRコマンドのオプションに対する引数を引数ファイルに格納する例を示します。長い引数を指定できるので、\fB\-bottom\fRオプションを使用します。次のようなテキスト引数を含む、bottomという名前のファイルを作成できます。 .sp .if n \{\ .RS 4 .\} .nf -<font size="\-1"> - <a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/> - Copyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&. <br/> - Oracle is a registered trademark of Oracle Corporation and/or its affiliates\&. - Other names may be trademarks of their respective owners\&.</font> +\fB<font size="\-1">\fR +\fB <a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/>\fR +\fB Copyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&. <br/>\fR +\fB Oracle is a registered trademark of Oracle Corporation and/or its affiliates\&.\fR +\fB Other names may be trademarks of their respective owners\&.</font>\fR + .fi .if n \{\ .RE .\} -\fIjavadoc\fRコマンドを次のように実行します。\fI javadoc \-bottom @bottom @packages\fR -.sp -\fI\-bottom\fRオプションを引数ファイルの最初に含めて、次のように\fIjavadoc\fRコマンドを実行することもできます。\fIjavadoc @bottom @packages\fR +\fBjavadoc\fRコマンドを次のように実行します。\fB javadoc \-bottom @bottom @packages\fR +.sp +\fB\-bottom\fRオプションを引数ファイルの最初に含めて、次のように\fBjavadoc\fRコマンドを実行することもできます。\fBjavadoc @bottom @packages\fR .RE .SH "JAVADOCコマンドの実行" .PP -\fIjavadoc\fRコマンドのリリース番号は\fIjavadoc \-J\-version\fRオプションで特定できます。出力ストリームには標準ドックレットのリリース番号が含まれます。\fI\-quiet\fRオプションで無効にできます。 -.PP -Java言語で記述されたプログラムから\fIjavadoc\fRコマンドを起動するには公開プログラマティック・インタフェースを使用します。このインタフェースは\fIcom\&.sun\&.tools\&.javadoc\&.Main\fRにあります(また\fIjavadoc\fRコマンドは再入可能です)。詳細は、標準ドックレット +\fBjavadoc\fRコマンドのリリース番号は\fBjavadoc \-J\-version\fRオプションで特定できます。出力ストリームには標準ドックレットのリリース番号が含まれます。\fB\-quiet\fRオプションで無効にできます。 +.PP +Java言語で記述されたプログラムから\fBjavadoc\fRコマンドを起動するには公開プログラマティック・インタフェースを使用します。このインタフェースは\fBcom\&.sun\&.tools\&.javadoc\&.Main\fRにあります(また\fBjavadoc\fRコマンドは再入可能です)。詳細は、標準ドックレット (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/standard\-doclet\&.html#runningprogrammatically)を参照してください。 .PP -次の手順では、標準HTMLドックレットを呼び出します。カスタム・ドックレットを呼び出すには、\fI\-doclet\fRおよび\fI\-docletpath\fRオプションを使用しますドックレットの概要 +次の手順では、標準HTMLドックレットを呼び出します。カスタム・ドックレットを呼び出すには、\fB\-doclet\fRおよび\fB\-docletpath\fRオプションを使用しますドックレットの概要 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/doclet/overview\&.html)を参照してください .SS "簡単な例" .PP -\fIjavadoc\fRコマンドは、パッケージ全体に対して実行することも、個々のソース・ファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。 +\fBjavadoc\fRコマンドは、パッケージ全体に対して実行することも、個々のソース・ファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。 .PP 次の例では、ソース・ファイルは/home/src/java/awt/*\&.javaにあります。生成先ディレクトリは/home/htmlです。 -1つ以上のパッケージのドキュメント化.PP +.PP +1つ以上のパッケージのドキュメント化 +.PP パッケージをドキュメント化するには、そのパッケージのソース・ファイルを、そのパッケージと同じ名前のディレクトリ内に格納する必要があります。 .PP -パッケージ名が(\fIjava\&.awt\&.color\fRのようにドットで区切られた)複数の識別子から構成されている場合、後続の各識別子が下位のサブディレクトリ(ava/awt/colorなど)に対応している必要があります。 -.PP -1つのパッケージのための複数のソース・ファイルを、異なる場所にあるそのような2つのディレクトリ・ツリーに分けて格納することもできます。ただし、その場合は\fI\-sourcepath\fRによってその両方の場所を指定する必要があります。たとえば、src1/java/awt/colorとsrc2/java/awt/color。 -.PP -ディレクトリの変更(\fIcd\fRコマンドを使用)または\fI\-sourcepath\fRオプションにより、\fIjavadoc\fRコマンドを実行できます。次の例で両方の選択肢を示します。 -.PP -\fBExample 1\fR, 1つ以上のパッケージから再帰的に実行 -.RS 4 -この例では\fIjavadoc\fRコマンドが任意のディレクトリから実行できるように、\fI\-sourcepath\fRを使用し、再帰的処理のために\fI\-subpackages\fR -(1\&.4の新オプション)を使用します。これは、javaディレクトリのサブパッケージをたどりますが、\fIjava\&.net\fRと\fIjava\&.lang\fRをルートに持つパッケージは除外されます。\fIjava\&.lang\fRのサブパッケージである\fIjava\&.lang\&.ref\fRが除外される点に注意してください。また、他のパッケージ・ツリーを下方にたどるには、\fIjava:javax:org\&.xml\&.sax\fRのように、それらのパッケージの名前を\fI\-subpackages\fRの引数に追加します。 +パッケージ名が(\fBjava\&.awt\&.color\fRのようにドットで区切られた)複数の識別子から構成されている場合、後続の各識別子が下位のサブディレクトリ(ava/awt/colorなど)に対応している必要があります。 +.PP +1つのパッケージのための複数のソース・ファイルを、異なる場所にあるそのような2つのディレクトリ・ツリーに分けて格納することもできます。ただし、その場合は\fB\-sourcepath\fRによってその両方の場所を指定する必要があります。たとえば、src1/java/awt/colorとsrc2/java/awt/color。 +.PP +ディレクトリの変更(\fBcd\fRコマンドを使用)または\fB\-sourcepath\fRオプションにより、\fBjavadoc\fRコマンドを実行できます。次の例で両方の選択肢を示します。 +.PP +\fB例 1\fR +.br +1つ以上のパッケージから再帰的に実行 +.RS 4 +この例では\fBjavadoc\fRコマンドが任意のディレクトリから実行できるように、\fB\-sourcepath\fRを使用し、再帰的処理のために\fB\-subpackages\fR +(1\&.4の新オプション)を使用します。これは、javaディレクトリのサブパッケージをたどりますが、\fBjava\&.net\fRと\fBjava\&.lang\fRをルートに持つパッケージは除外されます。\fBjava\&.lang\fRのサブパッケージである\fBjava\&.lang\&.ref\fRが除外される点に注意してください。また、他のパッケージ・ツリーを下方にたどるには、\fBjava:javax:org\&.xml\&.sax\fRのように、それらのパッケージの名前を\fB\-subpackages\fRの引数に追加します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude +\fBjavadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 2\fR, ルートへの移動および明示的なパッケージの実行 -.RS 4 -完全修飾されたパッケージの親ディレクトリに移動します。次に、ドキュメント化する1つ以上のパッケージの名前を指定して\fIjavadoc\fRコマンドを実行します。 +\fB例 2\fR +.br +ルートへの移動および明示的なパッケージの実行 +.RS 4 +完全修飾されたパッケージの親ディレクトリに移動します。次に、ドキュメント化する1つ以上のパッケージの名前を指定して\fBjavadoc\fRコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -cd /home/src/ -javadoc \-d /home/html java\&.awt java\&.awt\&.event +\fBcd /home/src/\fR +\fBjavadoc \-d /home/html java\&.awt java\&.awt\&.event\fR + .fi .if n \{\ .RE .\} -また、他のパッケージ・ツリーを下方にたどるには、j\fIava:javax:org\&.xml\&.sax\fRのように、それらのパッケージの名前を\fI\-subpackages\fRの引数に追加します。 -.RE -.PP -\fBExample 3\fR, 1つのツリーの明示的なパッケージの任意のディレクトリから実行 -.RS 4 -この場合、現在のディレクトリがどこかは問題ではありません。\fIjavadoc\fRコマンドを実行し、最上位パッケージの親ディレクトリを指定して\fI\-sourcepath\fRオプションを使用します。ドキュメント化する1つ以上のパッケージの名前を指定します。 +また、他のパッケージ・ツリーを下方にたどるには、j\fBava:javax:org\&.xml\&.sax\fRのように、それらのパッケージの名前を\fB\-subpackages\fRの引数に追加します。 +.RE +.PP +\fB例 3\fR +.br +1つのツリーの明示的なパッケージの任意のディレクトリから実行 +.RS 4 +この場合、現在のディレクトリがどこかは問題ではありません。\fBjavadoc\fRコマンドを実行し、最上位パッケージの親ディレクトリを指定して\fB\-sourcepath\fRオプションを使用します。ドキュメント化する1つ以上のパッケージの名前を指定します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBjavadoc \-d /home/html \-sourcepath /home/src java\&.awt java\&.awt\&.event\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\fB例 4\fR +.br +複数のツリーの明示的なパッケージの任意のディレクトリから実行 +.RS 4 +\fBjavadoc\fRコマンドを実行し、各ツリーのルートへのパスのコロン区切りリストを指定して\fB\-sourcepath\fRオプションを使用します。ドキュメント化する1つ以上のパッケージの名前を指定します。指定したパッケージのすべてのソース・ファイルが、1つのルート・ディレクトリの下に存在する必要はありませんが、ソース・パスで指定された場所のどこかで見つかる必要があります。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d /home/html \-sourcepath /home/src java\&.awt java\&.awt\&.event +\fBjavadoc \-d /home/html \-sourcepath /home/src1:/home/src2 java\&.awt java\&.awt\&.event\fR + .fi .if n \{\ .RE .\} -.RE -.PP -\fBExample 4\fR, 複数のツリーの明示的なパッケージの任意のディレクトリから実行 -.RS 4 -\fIjavadoc\fRコマンドを実行し、各ツリーのルートへのパスのコロン区切りリストを指定して\fI\-sourcepath\fRオプションを使用します。ドキュメント化する1つ以上のパッケージの名前を指定します。指定したパッケージのすべてのソース・ファイルが、1つのルート・ディレクトリの下に存在する必要はありませんが、ソース・パスで指定された場所のどこかで見つかる必要があります。 +すべてのケースでj\fBava\&.awt\fRおよび\fBjava\&.awt\&.even\fRtパッケージ内の\fBpublic\fRおよび\fBprotected\fRクラスとインタフェースについて、HTML形式のドキュメントが生成され、指定された生成先ディレクトリにHTMLファイルが保存されます。2つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラス・ページという3つのHTMLフレームを持つことになります。 +.RE +.PP +1つ以上のクラスのドキュメント化 +.PP +また、1つ以上のソース・ファイルを渡して、\fBjavadoc\fRコマンドを実行することもできます。\fBjavadoc\fRは、次の2つの方法のいずれかで実行できます。1つはディレクトリを変更する方法(\fBcd\fRを使用)、もう1つはソース・ファイルへのパスを完全に指定する方法です。相対パスは、現在のディレクトリを起点とします。ソース・ファイルを渡すときは、\fB\-sourcepath\fRオプションは無視されます。アスタリスク(*)のようなコマンド行ワイルドカードを使用すると、クラスのグループを指定できます。 +.PP +\fB例 1\fR +.br +ソース・ディレクトリに変更 +.RS 4 +ソースを保持するディレクトリに変更します。次に、ドキュメント化する1つ以上のソース・ファイルの名前を指定して\fBjavadoc\fRコマンドを実行します。 +.sp +この例では、\fBButton\fRクラスと\fBCanvas\fRクラス、および名前が\fBGraphics\fRで始まるクラスについて、HTML形式のドキュメントが生成されます。パッケージ名ではなくソース・ファイルが\fBjavadoc\fRコマンドに引数として渡されているので、ドキュメントは、クラスのリストとメイン・ページという2つのフレームを持つことになります。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d /home/html \-sourcepath /home/src1:/home/src2 java\&.awt java\&.awt\&.event +\fBcd /home/src/java/awt\fR +\fBjavadoc \-d /home/html Button\&.java Canvas\&.java Graphics*\&.java\fR + .fi .if n \{\ .RE .\} -すべてのケースでj\fIava\&.awt\fRおよび\fIjava\&.awt\&.even\fRtパッケージ内の\fIpublic\fRおよび\fIprotected\fRクラスとインタフェースについて、HTML形式のドキュメントが生成され、指定された生成先ディレクトリにHTMLファイルが保存されます。2つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラス・ページという3つのHTMLフレームを持つことになります。 -.RE -1つ以上のクラスのドキュメント化.PP -また、1つ以上のソース・ファイルを渡して、\fIjavadoc\fRコマンドを実行することもできます。\fIjavadoc\fRは、次の2つの方法のいずれかで実行できます。1つはディレクトリを変更する方法(\fIcd\fRを使用)、もう1つはソース・ファイルへのパスを完全に指定する方法です。相対パスは、現在のディレクトリを起点とします。ソース・ファイルを渡すときは、\fI\-sourcepath\fRオプションは無視されます。アスタリスク(*)のようなコマンドライン・ワイルドカードを使用すると、クラスのグループを指定できます。 -.PP -\fBExample 1\fR, ソース・ディレクトリに変更 -.RS 4 -ソースを保持するディレクトリに変更します。次に、ドキュメント化する1つ以上のソース・ファイルの名前を指定して\fIjavadoc\fRコマンドを実行します。 -.sp -この例では、\fIButton\fRクラスと\fICanvas\fRクラス、および名前が\fIGraphics\fRで始まるクラスについて、HTML形式のドキュメントが生成されます。パッケージ名ではなくソース・ファイルが\fIjavadoc\fRコマンドに引数として渡されているので、ドキュメントは、クラスのリストとメイン・ページという2つのフレームを持つことになります。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -cd /home/src/java/awt -javadoc \-d /home/html Button\&.java Canvas\&.java Graphics*\&.java -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\fBExample 2\fR, パッケージのルート・ディレクトリに変更 +.RE +.PP +\fB例 2\fR +.br +パッケージのルート・ディレクトリに変更 .RS 4 これは、同じルートからの別のサブパッケージの個々のソース・ファイルをドキュメント化するのに役立ちます。パッケージのルート・ディレクトリに移り、各ソース・ファイルを、ルートからのパスとともに指定します。 .sp @@ -3501,143 +3668,157 @@ .RS 4 .\} .nf -cd /home/src/ -javadoc \-d /home/html java/awt/Button\&.java java/applet/Applet\&.java +\fBcd /home/src/\fR +\fBjavadoc \-d /home/html java/awt/Button\&.java java/applet/Applet\&.java\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, 任意のディレクトリからのファイルのドキュメント化 -.RS 4 -この場合、現在のディレクトリがどこかは問題ではありません。ドキュメント化するソース・ファイルへの絶対パス(または現在のディレクトリからの相対パス)を指定して\fIjavadoc\fRコマンドを実行します。 +\fB例 3\fR +.br +任意のディレクトリからのファイルのドキュメント化 +.RS 4 +この場合、現在のディレクトリがどこかは問題ではありません。ドキュメント化するソース・ファイルへの絶対パス(または現在のディレクトリからの相対パス)を指定して\fBjavadoc\fRコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d /home/html /home/src/java/awt/Button\&.java -/home/src/java/awt/Graphics*\&.java +\fBjavadoc \-d /home/html /home/src/java/awt/Button\&.java\fR +\fB/home/src/java/awt/Graphics*\&.java\fR + .fi .if n \{\ .RE .\} .RE -パッケージおよびクラスのドキュメント化.PP -パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に、前述の2つの例を組み合せた例を示します。\fI\-sourcepath\fRオプションは、パッケージへのパスに対しては使用できますが、個々のクラスへのパスに対しては使用できません。 +.PP +パッケージおよびクラスのドキュメント化 +.PP +パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に、前述の2つの例を組み合せた例を示します。\fB\-sourcepath\fRオプションは、パッケージへのパスに対しては使用できますが、個々のクラスへのパスに対しては使用できません。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d /home/html \-sourcepath /home/src java\&.awt -/home/src/java/applet/Applet\&.java +\fBjavadoc \-d /home/html \-sourcepath /home/src java\&.awt\fR +\fB/home/src/java/applet/Applet\&.java\fR + .fi .if n \{\ .RE .\} .SS "実際の例" .PP -次のコマンドラインおよび\fImakefile\fRバージョンの\fIjavadoc\fRコマンドをJavaプラットフォームAPIで実行します。Java SE 1\&.2で約1500個のpublicおよびprotectedクラスのドキュメントを生成するには、180MBのメモリーを使用します。どちらの例もオプションの引数で絶対パスが使用されているため、任意のディレクトリから同じ\fIjavadoc\fRコマンドを実行できます。 -コマンドラインの例.PP -次のコマンドは、一部のシェルに対して長すぎる可能性があります。この制限を回避するには、コマンドライン引数ファイルを使用します。または、シェル・スクリプトを記述します。 -.PP -この例では、\fIpackages\fRは処理するパッケージを含む名前で、\fIjava\&.applet\fR -\fIjava\&.lang\fRなどです。各オプションの、一重引用符で囲まれた引数の内側には、改行文字を挿入できません。たとえば、この例をコピー・アンド・ペーストする場合は、\fI\-bottom\fRオプションから改行文字を削除してください。 +次のコマンド行および\fBmakefile\fRバージョンの\fBjavadoc\fRコマンドをJavaプラットフォームAPIで実行します。Java SE 1\&.2で約1500個のpublicおよびprotectedクラスのドキュメントを生成するには、180MBのメモリーを使用します。どちらの例もオプションの引数で絶対パスが使用されているため、任意のディレクトリから同じ\fBjavadoc\fRコマンドを実行できます。 +.PP +コマンド行の例 +.PP +次のコマンドは、一部のシェルに対して長すぎる可能性があります。この制限を回避するには、コマンド行引数ファイルを使用します。または、シェル・スクリプトを記述します。 +.PP +この例では、\fBpackages\fRは処理するパッケージを含む名前で、\fBjava\&.applet\fR +\fBjava\&.lang\fRなどです。各オプションの、一重引用符で囲まれた引数の内側には、改行文字を挿入できません。たとえば、この例をコピー・アンド・ペーストする場合は、\fB\-bottom\fRオプションから改行文字を削除してください。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-sourcepath /java/jdk/src/share/classes \e -\-overview /java/jdk/src/share/classes/overview\&.html \e -\-d /java/jdk/build/api \e -\-use \e -\-splitIndex \e -\-windowtitle \*(AqJava Platform, Standard Edition 7 API Specification\*(Aq \e -\-doctitle \*(AqJava Platform, Standard Edition 7 API Specification\*(Aq \e -\-header \*(Aq<b>Java(TM) SE 7</b>\*(Aq \e -\-bottom \*(Aq<font size="\-1"> -<a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/> -Copyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&.<br/> -Oracle is a registered trademark of Oracle Corporation and/or its affiliates\&. -Other names may be trademarks of their respective owners\&.</font>\*(Aq \e -\-group "Core Packages" "java\&.*:com\&.sun\&.java\&.*:org\&.omg\&.*" \e -\-group "Extension Packages" "javax\&.*" \e -\-J\-Xmx180m \e -@packages +\fBjavadoc \-sourcepath /java/jdk/src/share/classes \e\fR +\fB\-overview /java/jdk/src/share/classes/overview\&.html \e\fR +\fB\-d /java/jdk/build/api \e\fR +\fB\-use \e\fR +\fB\-splitIndex \e\fR +\fB\-windowtitle \*(AqJava Platform, Standard Edition 7 API Specification\*(Aq \e\fR +\fB\-doctitle \*(AqJava Platform, Standard Edition 7 API Specification\*(Aq \e\fR +\fB\-header \*(Aq<b>Java(TM) SE 7</b>\*(Aq \e\fR +\fB\-bottom \*(Aq<font size="\-1">\fR +\fB<a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/>\fR +\fBCopyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&.<br/>\fR +\fBOracle is a registered trademark of Oracle Corporation and/or its affiliates\&.\fR +\fBOther names may be trademarks of their respective owners\&.</font>\*(Aq \e\fR +\fB\-group "Core Packages" "java\&.*:com\&.sun\&.java\&.*:org\&.omg\&.*" \e\fR +\fB\-group "Extension Packages" "javax\&.*" \e\fR +\fB\-J\-Xmx180m \e \fR +\fB@packages\fR + .fi .if n \{\ .RE .\} -プログラマティック・インタフェース.PP +.PP +プログラマティック・インタフェース +.PP Javadoc Access APIでは、新しいプロセスを実行しなくても、JavadocツールをJavaアプリケーションから直接起動できます。 .PP -たとえば、次の文はコマンド\fIjavadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude java\&.net:java\&.lang com\&.example\fRと同等です。 +たとえば、次の文はコマンド\fBjavadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude java\&.net:java\&.lang com\&.example\fRと同等です。 .sp .if n \{\ .RS 4 .\} .nf -import javax\&.tools\&.DocumentationTool; -import javax\&.tools\&.ToolProvider; - -public class JavaAccessSample{ - public static void main(String[] args){ - DocumentationTool javadoc = ToolProvider\&.getSystemDocumentationTool(); - int rc = javadoc\&.run( null, null, null, - "\-d", "/home/html", - "\-sourcepath", "home/src", - "\-subpackages", "java", - "\-exclude", "java\&.net:java\&.lang", - "com\&.example"); - } - } +\fBimport javax\&.tools\&.DocumentationTool;\fR +\fBimport javax\&.tools\&.ToolProvider;\fR + +\fBpublic class JavaAccessSample{\fR +\fB public static void main(String[] args){\fR +\fB DocumentationTool javadoc = ToolProvider\&.getSystemDocumentationTool();\fR +\fB int rc = javadoc\&.run( null, null, null,\fR +\fB "\-d", "/home/html",\fR +\fB "\-sourcepath", "home/src",\fR +\fB "\-subpackages", "java",\fR +\fB "\-exclude", "java\&.net:java\&.lang",\fR +\fB "com\&.example");\fR +\fB }\fR +\fB }\fR + .fi .if n \{\ .RE .\} .PP -\fIrun\fRメソッドの最初の3つの引数は、入力、標準出力、および標準エラー・ストリームを指定します。\fINull\fRは\fISystem\&.in\fR、\fISystem\&.out\fRおよび\fISystem\&.err\fRそれぞれのデフォルト値です。 +\fBrun\fRメソッドの最初の3つの引数は、入力、標準出力、および標準エラー・ストリームを指定します。\fBNull\fRは\fBSystem\&.in\fR、\fBSystem\&.out\fRおよび\fBSystem\&.err\fRそれぞれのデフォルト値です。 .SS "makefileの例" .PP ここでは、GNU -\fImakefile\fRの例を示します。\fImakefile\fRの引数は、一重引用符で囲みます。Windows -\fImakefile\fRの例については、Javadoc FAQの\fImakefiles\fRに関する項 +\fBmakefile\fRの例を示します。\fBmakefile\fRの引数は、一重引用符で囲みます。Windows +\fBmakefile\fRの例については、Javadoc FAQの\fBmakefiles\fRのセクション (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137483\&.html#makefiles)を参照してください .sp .if n \{\ .RS 4 .\} .nf -javadoc \-sourcepath $(SRCDIR) \e /* Sets path for source files */ - \-overview $(SRCDIR)/overview\&.html \e /* Sets file for overview text */ - \-d /java/jdk/build/api \e /* Sets destination directory */ - \-use \e /* Adds "Use" files */ - \-splitIndex \e /* Splits index A\-Z */ - \-windowtitle $(WINDOWTITLE) \e /* Adds a window title */ - \-doctitle $(DOCTITLE) \e /* Adds a doc title */ - \-header $(HEADER) \e /* Adds running header text */ - \-bottom $(BOTTOM) \e /* Adds text at bottom */ - \-group $(GROUPCORE) \e /* 1st subhead on overview page */ - \-group $(GROUPEXT) \e /* 2nd subhead on overview page */ - \-J\-Xmx180m \e /* Sets memory to 180MB */ - java\&.lang java\&.lang\&.reflect \e /* Sets packages to document */ - java\&.util java\&.io java\&.net \e - java\&.applet - -WINDOWTITLE = \*(AqJava(TM) SE 7 API Specification\*(Aq -DOCTITLE = \*(AqJava(TM) Platform Standard Edition 7 API Specification\*(Aq -HEADER = \*(Aq<b>Java(TM) SE 7</font>\*(Aq -BOTTOM = \*(Aq<font size="\-1"> - <a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/> - Copyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&.<br/> - Oracle is a registered trademark of Oracle Corporation and/or its affiliates\&. - Other names may be trademarks of their respective owners\&.</font>\*(Aq -GROUPCORE = \*(Aq"Core Packages" "java\&.*:com\&.sun\&.java\&.*:org\&.omg\&.*"\*(Aq -GROUPEXT = \*(Aq"Extension Packages" "javax\&.*"\*(Aq -SRCDIR = \*(Aq/java/jdk/1\&.7\&.0/src/share/classes\*(Aq +\fBjavadoc \-sourcepath $(SRCDIR) \e /* Sets path for source files */\fR +\fB \-overview $(SRCDIR)/overview\&.html \e /* Sets file for overview text */\fR +\fB \-d /java/jdk/build/api \e /* Sets destination directory */\fR +\fB \-use \e /* Adds "Use" files */\fR +\fB \-splitIndex \e /* Splits index A\-Z */\fR +\fB \-windowtitle $(WINDOWTITLE) \e /* Adds a window title */\fR +\fB \-doctitle $(DOCTITLE) \e /* Adds a doc title */\fR +\fB \-header $(HEADER) \e /* Adds running header text */\fR +\fB \-bottom $(BOTTOM) \e /* Adds text at bottom */\fR +\fB \-group $(GROUPCORE) \e /* 1st subhead on overview page */\fR +\fB \-group $(GROUPEXT) \e /* 2nd subhead on overview page */\fR +\fB \-J\-Xmx180m \e /* Sets memory to 180MB */\fR +\fB java\&.lang java\&.lang\&.reflect \e /* Sets packages to document */\fR +\fB java\&.util java\&.io java\&.net \e\fR +\fB java\&.applet\fR +\fB \fR +\fBWINDOWTITLE = \*(AqJava(TM) SE 7 API Specification\*(Aq\fR +\fBDOCTITLE = \*(AqJava(TM) Platform Standard Edition 7 API Specification\*(Aq\fR +\fBHEADER = \*(Aq<b>Java(TM) SE 7</font>\*(Aq\fR +\fBBOTTOM = \*(Aq<font size="\-1">\fR +\fB <a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/>\fR +\fB Copyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&.<br/>\fR +\fB Oracle is a registered trademark of Oracle Corporation and/or its affiliates\&.\fR +\fB Other names may be trademarks of their respective owners\&.</font>\*(Aq\fR +\fBGROUPCORE = \*(Aq"Core Packages" "java\&.*:com\&.sun\&.java\&.*:org\&.omg\&.*"\*(Aq\fR +\fBGROUPEXT = \*(Aq"Extension Packages" "javax\&.*"\*(Aq\fR +\fBSRCDIR = \*(Aq/java/jdk/1\&.7\&.0/src/share/classes\*(Aq\fR + .fi .if n \{\ .RE @@ -3652,7 +3833,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-windowtitle\fRオプションを省略すると、\fIjavadoc\fRコマンドによってドキュメント・タイトルがウィンドウ・タイトルにコピーされます。\fI\-windowtitle\fRオプションのテキストは、\fI\-doctitle\fRオプションと同じですが、HTMLタグは含まれません。これは、HTMLタグが、ウィンドウ・タイトル内にそのままのテキストとして表示されるのを防ぐためです。 +\fB\-windowtitle\fRオプションを省略すると、\fBjavadoc\fRコマンドによってドキュメント・タイトルがウィンドウ・タイトルにコピーされます。\fB\-windowtitle\fRオプションのテキストは、\fB\-doctitle\fRオプションと同じですが、HTMLタグは含まれません。これは、HTMLタグが、ウィンドウ・タイトル内にそのままのテキストとして表示されるのを防ぐためです。 .RE .sp .RS 4 @@ -3663,7 +3844,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-footer\fRオプションを省略すると、\fIjavadoc\fRコマンドによってヘッダー・テキストがフッターにコピーされます。 +\fB\-footer\fRオプションを省略すると、\fBjavadoc\fRコマンドによってヘッダー・テキストがフッターにコピーされます。 .RE .sp .RS 4 @@ -3674,7 +3855,7 @@ .sp -1 .IP \(bu 2.3 .\} -この例では必要ありませんが、\fI\-classpath\fRと\fI\-link\fRも重要なオプションです。 +この例では必要ありませんが、\fB\-classpath\fRと\fB\-link\fRも重要なオプションです。 .RE .SH "一般的なトラブルシューティング" .sp @@ -3686,7 +3867,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIjavadoc\fRコマンドは有効なクラス名を含むファイルのみを読み取ります。\fIjavadoc\fRコマンドがファイルの内容を正しく読み取っていない場合は、クラス名が有効であることを確認します。ソース・ファイルの処理を参照してください。 +\fBjavadoc\fRコマンドは有効なクラス名を含むファイルのみを読み取ります。\fBjavadoc\fRコマンドがファイルの内容を正しく読み取っていない場合は、クラス名が有効であることを確認します。ソース・ファイルの処理を参照してください。 .RE .sp .RS 4 @@ -3697,25 +3878,25 @@ .sp -1 .IP \(bu 2.3 .\} -共通の不具合およびトラブルシューティングのヒントについては、Javadoc FAQ +一般的なbugおよびトラブルシューティングのヒントについては、Javadoc FAQ (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137483\&.html)を参照してください。 .RE .SH "エラーと警告" .PP エラーおよび警告メッセージには、ファイル名と宣言行(ドキュメンテーション・コメント内の特定の行ではない)の行番号が含まれます。 .PP -たとえば、メッセージ\fI「エラー: Class1\&.javaを読み込めません」\fRは、\fIjavadoc\fRコマンドが\fIClass1\&.jav\fR\fIa\fRを現在のディレクトリにロードしようとしていることを意味します。クラス名はそのパス(絶対または相対)で表示されます。 +たとえば、メッセージ\fB「エラー: Class1\&.javaを読み込めません」\fRは、\fBjavadoc\fRコマンドが\fBClass1\&.jav\fR\fBa\fRを現在のディレクトリにロードしようとしていることを意味します。クラス名はそのパス(絶対または相対)で表示されます。 .SH "環境" .PP CLASSPATH .RS 4 -\fICLASSPATH\fRは、\fIjavadoc\fRコマンドがユーザー・クラス・ファイルの検出に使用するパスを提供する環境変数です。この環境変数は、\fI\-classpath\fRオプションによってオーバーライドされます。ディレクトリはセミコロン(Windowsの場合)またはコロン(Oracle Solarisの場合)で区切ります。 +\fBCLASSPATH\fRは、\fBjavadoc\fRコマンドがユーザー・クラス・ファイルの検出に使用するパスを提供する環境変数です。この環境変数は、\fB\-classpath\fRオプションによってオーバーライドされます。ディレクトリはセミコロン(Windowsの場合)またはコロン(Oracle Solarisの場合)で区切ります。 .sp \fBWindowsの例\fR: -\fI\&.;C:\eclasses;C:\ehome\ejava\eclasses\fR +\fB\&.;C:\eclasses;C:\ehome\ejava\eclasses\fR .sp \fBOracle Solarisの例\fR: -\fI\&.:/home/classes:/usr/local/java/classes\fR +\fB\&.:/home/classes:/usr/local/java/classes\fR .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/javah.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/javah.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: javah -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: javah +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "javah" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" javah \- JavaクラスからCヘッダーとソース・ファイルを生成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjavah\fR [ \fIoptions\fR ] f\fIully\-qualified\-class\-name \&.\&.\&.\fR +\fBjavah\fR [ \fIoptions\fR ] f\fIully\-qualified\-class\-name \&.\&.\&.\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIfully\-qualified\-class\-name\fR @@ -73,76 +75,76 @@ .RE .SH "説明" .PP -\fIjavah\fRコマンドは、ネイティブ・メソッドを実装するために必要なCヘッダーとソース・ファイルを生成します。作成されたヘッダーとソース・ファイルは、ネイティブ・ソース・コードからオブジェクトのインスタンス変数を参照するためにCプログラムによって使用されます。\fI\&.h\fRファイルは、対応するクラスと一致する配置を持つ\fIstruct\fR定義を含みます。\fIstruct\fRのフィールドは、クラスのインスタンス変数に対応します。 +\fBjavah\fRコマンドは、ネイティブ・メソッドを実装するために必要なCヘッダーとソース・ファイルを生成します。作成されたヘッダーとソース・ファイルは、ネイティブ・ソース・コードからオブジェクトのインスタンス変数を参照するためにCプログラムによって使用されます。\fB\&.h\fRファイルは、対応するクラスと一致する配置を持つ\fBstruct\fR定義を含みます。\fBstruct\fRのフィールドは、クラスのインスタンス変数に対応します。 .PP -ヘッダー・ファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\fIjavah\fRコマンドに渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダー・ファイル名と構造体名の両方の先頭に付加されます。下線(_)が名前の区切り文字として使用されます。 +ヘッダー・ファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\fBjavah\fRコマンドに渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダー・ファイル名と構造体名の両方の先頭に付加されます。下線(_)が名前の区切り文字として使用されます。 .PP -デフォルトでは\fIjavah\fRコマンドは、コマンドラインにリストされる各クラスのヘッダー・ファイルを作成し、現在のディレクトリにファイルを置きます。ソース・ファイルを作成するには、\fI\-stubs\fRオプションを使用してください。1つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\fI\-o\fRオプションを使用してください。 +デフォルトでは\fBjavah\fRコマンドは、コマンド行にリストされる各クラスのヘッダー・ファイルを作成し、現在のディレクトリにファイルを置きます。ソース・ファイルを作成するには、\fB\-stubs\fRオプションを使用してください。1つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\fB\-o\fRオプションを使用してください。 .PP -Java Native Interface (JNI)はヘッダー情報またはスタブ・ファイルを必要としません。\fIjavah\fRコマンドは引き続きJNI形式のネイティブ・メソッドに必要なネイティブ・メソッド関数プロトタイプの生成に使用できます。\fIjavah\fRコマンドはデフォルトでJNI形式の出力を生成し、その結果を\fI\&.h\fRファイルに格納します。 +Java Native Interface (JNI)はヘッダー情報またはスタブ・ファイルを必要としません。\fBjavah\fRコマンドは引き続きJNI形式のネイティブ・メソッドに必要なネイティブ・メソッド関数プロトタイプの生成に使用できます。\fBjavah\fRコマンドはデフォルトでJNI形式の出力を生成し、その結果を\fB\&.h\fRファイルに格納します。 .SH "オプション" .PP \-o \fIoutputfile\fR .RS 4 -コマンドラインにリストされたすべてのクラスに対して、結果のヘッダーまたはソース・ファイルを連結して出力ファイルに格納します。\fI\-o\fRまたは\fI\-d\fRのどちらかのみ使用できます。 +コマンド行にリストされたすべてのクラスに対して、結果のヘッダーまたはソース・ファイルを連結して出力ファイルに格納します。\fB\-o\fRまたは\fB\-d\fRのどちらかのみ使用できます。 .RE .PP \-d \fIdirectory\fR .RS 4 -\fIjavah\fRがヘッダー・ファイルまたはスタブ・ファイルを保存する、ディレクトリを設定します。\fI\-d\fRまたは\fI\-o\fRのどちらかのみ使用できます。 +\fBjavah\fRがヘッダー・ファイルまたはスタブ・ファイルを保存する、ディレクトリを設定します。\fB\-d\fRまたは\fB\-o\fRのどちらかのみ使用できます。 .RE .PP \-stubs .RS 4 -\fIjavah\fRコマンドが、Javaオブジェクト・ファイルからC宣言を生成します。 +\fBjavah\fRコマンドが、Javaオブジェクト・ファイルからC宣言を生成します。 .RE .PP \-verbose .RS 4 -詳細出力を指定し、作成ファイルの状態に関するメッセージを、\fIjavah\fRコマンドが\fI標準出力\fRに出力します。 +詳細出力を指定し、作成ファイルの状態に関するメッセージを、\fBjavah\fRコマンドが\fB標準出力\fRに出力します。 .RE .PP \-help .RS 4 -\fIjavah\fRの使用方法についてのヘルプ・メッセージを出力します。 +\fBjavah\fRの使用方法についてのヘルプ・メッセージを出力します。 .RE .PP \-version .RS 4 -\fIjavah\fRコマンドのリリース情報を出力します。 +\fBjavah\fRコマンドのリリース情報を出力します。 .RE .PP \-jni .RS 4 -JNI形式のネイティブ・メソッド機能プロトタイプを含む出力ファイルを、\fIjavah\fRコマンドが作成します。これは標準出力であるため、\fI\-jni\fRの使用はオプションです。 +JNI形式のネイティブ・メソッド機能プロトタイプを含む出力ファイルを、\fBjavah\fRコマンドが作成します。これは標準出力であるため、\fB\-jni\fRの使用はオプションです。 .RE .PP \-classpath \fIpath\fR .RS 4 -クラスを探すために\fIjavah\fRコマンドが使用するパスを指定します。デフォルトまたは\fICLASSPATH\fR環境変数の設定をオーバーライドします。ディレクトリはOracle Solarisの場合はコロンで、Windowsの場合はセミコロンで区切られます。パスの一般的な形式は次のようになります。 +クラスを探すために\fBjavah\fRコマンドが使用するパスを指定します。デフォルトまたは\fBCLASSPATH\fR環境変数の設定をオーバーライドします。ディレクトリはOracle Solarisの場合はコロンで、Windowsの場合はセミコロンで区切られます。パスの一般的な形式は次のようになります。 .sp \fBOracle Solaris\fRの場合: .sp \&.:\fIyour\-path\fR .sp 例: -\fI\&.:/home/avh/classes:/usr/local/java/classes\fR +\fB\&.:/home/avh/classes:/usr/local/java/classes\fR .sp \fBWindows\fRの場合: .sp \&.;\fIyour\-path\fR .sp 例: -\fI\&.;C:\eusers\edac\eclasses;C:\etools\ejava\eclasses\fR +\fB\&.;C:\eusers\edac\eclasses;C:\etools\ejava\eclasses\fR .sp -便宜上、*のベース名を含むクラス・パス要素は、\fI\&.jar\fRまたは\fI\&.JAR\fRを拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます。 +便宜上、*のベース名を含むクラス・パス要素は、\fB\&.jar\fRまたは\fB\&.JAR\fRを拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます。 .sp -たとえば、ディレクトリ\fImydir\fRに\fIa\&.jar\fRと\fIb\&.JAR\fRが含まれている場合、クラス・パス要素\fImydir/*\fRは\fIA\fR\fI\&.jar:b\&.JAR\fRに展開されますが、JARファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべてのJARファイルが含まれます。*からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\fICLASSPATH\fR環境変数も、定義時には同様に展開されます。クラス・パスのワイルドカードの展開は、Java仮想マシン(JVM)の開始前に行われます。Javaプログラムは、環境を問い合せる場合を除き、展開されていないワイルドカードを参照しません。たとえば、\fISystem\&.getenv("CLASSPATH")\fRをコールして問い合せる場合です。 +たとえば、ディレクトリ\fBmydir\fRに\fBa\&.jar\fRと\fBb\&.JAR\fRが含まれている場合、クラス・パス要素\fBmydir/*\fRは\fBA\fR\fB\&.jar:b\&.JAR\fRに展開されますが、JARファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべてのJARファイルが含まれます。*からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\fBCLASSPATH\fR環境変数も、定義時には同様に展開されます。クラス・パスのワイルドカードの展開は、Java Virtual Machine (JVM)の開始前に行われます。Javaプログラムは、環境を問い合せる場合を除き、展開されていないワイルドカードを参照しません。たとえば、\fBSystem\&.getenv("CLASSPATH")\fRをコールして問い合せる場合です。 .RE .PP \-bootclasspath \fIpath\fR .RS 4 -ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\fIjre\elib\ert\&.jar\fRおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。 +ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\fBjre\elib\ert\&.jar\fRおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。 .RE .PP \-old @@ -157,7 +159,7 @@ .PP \-J\fIoption\fR .RS 4 -Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/javap.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/javap.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: javap -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,8 +21,16 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 -.TH "javap" "1" "2013年11月21日" "JDK 8" "基本ツール" +.\" Title: javap +.\" Language: Japanese +.\" Date: 2014年8月8日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 +.TH "javap" "1" "2014年8月8日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" javap \- 1つ以上のクラス・ファイルを逆アセンブルします。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjavap\fR [\fIoptions\fR] \fIclassfile\fR\&.\&.\&. +\fBjavap\fR [\fIoptions\fR] \fIclassfile\fR\&.\&.\&. .fi .if n \{\ .RE @@ -64,21 +66,25 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIclassfile\fR .RS 4 -注釈の処理対象となる、空白で区切った1つ以上のクラス(DocFooter\&.classなど)。クラス・パスで検出できるクラスを、ファイル名またはURL(\fIfile:///home/user/myproject/src/DocFooter\&.class\fRなど)で指定できます。 +注釈の処理対象となる、空白で区切った1つ以上のクラス(DocFooter\&.classなど)。クラス・パスで検出できるクラスを、ファイル名またはURL(\fBfile:///home/user/myproject/src/DocFooter\&.class\fRなど)で指定できます。 .RE .SH "説明" .PP -\fIjavap\fRコマンドは、1つまたは複数のクラス・ファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\fIjavap\fRコマンドは、そのパッケージ、渡されたクラスのprotectedおよびpublicのフィールドとメソッドを出力します。\fIjavap\fRコマンドはその出力を\fI標準出力\fRに表示します。 +\fBjavap\fRコマンドは、1つまたは複数のクラス・ファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\fBjavap\fRコマンドは、そのパッケージ、渡されたクラスのprotectedおよびpublicのフィールドとメソッドを出力します。\fBjavap\fRコマンドはその出力を\fB標準出力\fRに表示します。 .SH "オプション" .PP -\-help, \-\-help, \-? +\-help +.br +\-\-help +.br +\-? .RS 4 -\fIjavap\fRコマンドについてのヘルプ・メッセージを出力します。 +\fBjavap\fRコマンドについてのヘルプ・メッセージを出力します。 .RE .PP \-version @@ -101,7 +107,9 @@ protectedおよびpublicのクラスとメンバーのみを表示します。 .RE .PP -\-private, \-p +\-private +.br +\-p .RS 4 すべてのクラスとメンバーを表示します。 .RE @@ -114,8 +122,9 @@ .RS 4 .\} .nf -javap \-J\-version -javap \-J\-Djava\&.security\&.manager \-J\-Djava\&.security\&.policy=MyPolicy MyClassName +\fBjavap \-J\-version\fR +\fBjavap \-J\-Djava\&.security\&.manager \-J\-Djava\&.security\&.policy=MyPolicy MyClassName\fR + .fi .if n \{\ .RE @@ -135,7 +144,7 @@ .PP \-constants .RS 4 -\fIstatic final\fR定数を表示します。 +\fBstatic final\fR定数を表示します。 .RE .PP \-c @@ -150,135 +159,138 @@ .PP \-classpath \fIpath\fR .RS 4 -クラスを探すために\fIjavap\fRコマンドが使用するパスを指定します。デフォルトまたは\fICLASSPATH\fR環境変数の設定をオーバーライドします。 +クラスを探すために\fBjavap\fRコマンドが使用するパスを指定します。デフォルトまたは\fBCLASSPATH\fR環境変数の設定をオーバーライドします。 .RE .PP \-bootclasspath \fIpath\fR .RS 4 -ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\fIjre/lib/rt\&.jar\fRおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。 +ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\fBjre/lib/rt\&.jar\fRおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。 .RE .PP \-extdir \fIdirs\fR .RS 4 -インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能のデフォルト位置は\fIjava\&.ext\&.dirs\fRです。 +インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能のデフォルト位置は\fBjava\&.ext\&.dirs\fRです。 .RE .SH "例" .PP -次の\fIDocFooter\fRクラスをコンパイルします。 +次の\fBDocFooter\fRクラスをコンパイルします。 .sp .if n \{\ .RS 4 .\} .nf -import java\&.awt\&.*; -import java\&.applet\&.*; - -public class DocFooter extends Applet { - String date; - String email; +\fBimport java\&.awt\&.*;\fR +\fBimport java\&.applet\&.*;\fR +\fB \fR +\fBpublic class DocFooter extends Applet {\fR +\fB String date;\fR +\fB String email;\fR +\fB \fR +\fB public void init() {\fR +\fB resize(500,100);\fR +\fB date = getParameter("LAST_UPDATED");\fR +\fB email = getParameter("EMAIL");\fR +\fB }\fR +\fB \fR +\fB public void paint(Graphics g) {\fR +\fB g\&.drawString(date + " by ",100, 15);\fR +\fB g\&.drawString(email,290,15);\fR +\fB }\fR +\fB}\fR - public void init() { - resize(500,100); - date = getParameter("LAST_UPDATED"); - email = getParameter("EMAIL"); - } - - public void paint(Graphics g) { - g\&.drawString(date + " by ",100, 15); - g\&.drawString(email,290,15); - } -} .fi .if n \{\ .RE .\} .PP -\fIjavap DocFooter\&.class\fRコマンドからの出力は次を生成します。 +\fBjavap DocFooter\&.class\fRコマンドからの出力は次を生成します。 .sp .if n \{\ .RS 4 .\} .nf -Compiled from "DocFooter\&.java" -public class DocFooter extends java\&.applet\&.Applet { - java\&.lang\&.String date; - java\&.lang\&.String email; - public DocFooter(); - public void init(); - public void paint(java\&.awt\&.Graphics); -} +\fBCompiled from "DocFooter\&.java"\fR +\fBpublic class DocFooter extends java\&.applet\&.Applet {\fR +\fB java\&.lang\&.String date;\fR +\fB java\&.lang\&.String email;\fR +\fB public DocFooter();\fR +\fB public void init();\fR +\fB public void paint(java\&.awt\&.Graphics);\fR +\fB}\fR + .fi .if n \{\ .RE .\} .PP -\fIjavap \-c DocFooter\&.class\fRコマンドからの出力は次を生成します。 +\fBjavap \-c DocFooter\&.class\fRコマンドからの出力は次を生成します。 .sp .if n \{\ .RS 4 .\} .nf -Compiled from "DocFooter\&.java" -public class DocFooter extends java\&.applet\&.Applet { - java\&.lang\&.String date; - java\&.lang\&.String email; - - public DocFooter(); - Code: - 0: aload_0 - 1: invokespecial #1 // Method -java/applet/Applet\&."<init>":()V - 4: return - - public void init(); - Code: - 0: aload_0 - 1: sipush 500 - 4: bipush 100 - 6: invokevirtual #2 // Method resize:(II)V - 9: aload_0 - 10: aload_0 - 11: ldc #3 // String LAST_UPDATED - 13: invokevirtual #4 // Method - getParameter:(Ljava/lang/String;)Ljava/lang/String; - 16: putfield #5 // Field date:Ljava/lang/String; - 19: aload_0 - 20: aload_0 - 21: ldc #6 // String EMAIL - 23: invokevirtual #4 // Method - getParameter:(Ljava/lang/String;)Ljava/lang/String; - 26: putfield #7 // Field email:Ljava/lang/String; - 29: return - - public void paint(java\&.awt\&.Graphics); - Code: - 0: aload_1 - 1: new #8 // class java/lang/StringBuilder - 4: dup - 5: invokespecial #9 // Method - java/lang/StringBuilder\&."<init>":()V - 8: aload_0 - 9: getfield #5 // Field date:Ljava/lang/String; - 12: invokevirtual #10 // Method - java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder; - 15: ldc #11 // String by - 17: invokevirtual #10 // Method - java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder; - 20: invokevirtual #12 // Method - java/lang/StringBuilder\&.toString:()Ljava/lang/String; - 23: bipush 100 - 25: bipush 15 - 27: invokevirtual #13 // Method - java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V - 30: aload_1 - 31: aload_0 - 32: getfield #7 // Field email:Ljava/lang/String; - 35: sipush 290 - 38: bipush 15 - 40: invokevirtual #13 // Method -java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V - 43: return -} +\fBCompiled from "DocFooter\&.java"\fR +\fBpublic class DocFooter extends java\&.applet\&.Applet {\fR +\fB java\&.lang\&.String date;\fR +\fB java\&.lang\&.String email;\fR + +\fB public DocFooter();\fR +\fB Code:\fR +\fB 0: aload_0 \fR +\fB 1: invokespecial #1 // Method\fR +\fBjava/applet/Applet\&."<init>":()V\fR +\fB 4: return \fR + +\fB public void init();\fR +\fB Code:\fR +\fB 0: aload_0 \fR +\fB 1: sipush 500\fR +\fB 4: bipush 100\fR +\fB 6: invokevirtual #2 // Method resize:(II)V\fR +\fB 9: aload_0 \fR +\fB 10: aload_0 \fR +\fB 11: ldc #3 // String LAST_UPDATED\fR +\fB 13: invokevirtual #4 // Method\fR +\fB getParameter:(Ljava/lang/String;)Ljava/lang/String;\fR +\fB 16: putfield #5 // Field date:Ljava/lang/String;\fR +\fB 19: aload_0 \fR +\fB 20: aload_0 \fR +\fB 21: ldc #6 // String EMAIL\fR +\fB 23: invokevirtual #4 // Method\fR +\fB getParameter:(Ljava/lang/String;)Ljava/lang/String;\fR +\fB 26: putfield #7 // Field email:Ljava/lang/String;\fR +\fB 29: return \fR + +\fB public void paint(java\&.awt\&.Graphics);\fR +\fB Code:\fR +\fB 0: aload_1 \fR +\fB 1: new #8 // class java/lang/StringBuilder\fR +\fB 4: dup \fR +\fB 5: invokespecial #9 // Method\fR +\fB java/lang/StringBuilder\&."<init>":()V\fR +\fB 8: aload_0 \fR +\fB 9: getfield #5 // Field date:Ljava/lang/String;\fR +\fB 12: invokevirtual #10 // Method\fR +\fB java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;\fR +\fB 15: ldc #11 // String by \fR +\fB 17: invokevirtual #10 // Method\fR +\fB java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;\fR +\fB 20: invokevirtual #12 // Method\fR +\fB java/lang/StringBuilder\&.toString:()Ljava/lang/String;\fR +\fB 23: bipush 100\fR +\fB 25: bipush 15\fR +\fB 27: invokevirtual #13 // Method\fR +\fB java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V\fR +\fB 30: aload_1 \fR +\fB 31: aload_0 \fR +\fB 32: getfield #7 // Field email:Ljava/lang/String;\fR +\fB 35: sipush 290\fR +\fB 38: bipush 15\fR +\fB 40: invokevirtual #13 // Method\fR +\fBjava/awt/Graphics\&.drawString:(Ljava/lang/String;II)V\fR +\fB 43: return \fR +\fB}\fR + .fi .if n \{\ .RE @@ -293,6 +305,17 @@ .sp -1 .IP \(bu 2.3 .\} +java(1) +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} javac(1) .RE .sp @@ -304,7 +327,18 @@ .sp -1 .IP \(bu 2.3 .\} -java(1) +javadoc(1) +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +javah(1) .RE .sp .RS 4 @@ -326,18 +360,7 @@ .sp -1 .IP \(bu 2.3 .\} -javah(1) -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -javadoc(1) +jdeps(1) .RE .br 'pl 8.5i
--- a/src/linux/doc/man/ja/javaws.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/javaws.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: javaws -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java Web Startツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: javaws +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java Web Startツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "javaws" "1" "2013年11月21日" "JDK 8" "Java Web Startツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" javaws \- Java Web Startを起動します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjavaws\fR [ \fIrun\-options\fR ] \fIjnlp\fR +\fBjavaws\fR [ \fIrun\-options\fR ] \fIjnlp\fR .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjavaws\fR [ \fIcontrol\-options\fR ] +\fBjavaws\fR [ \fIcontrol\-options\fR ] .fi .if n \{\ .RE @@ -74,7 +76,7 @@ .PP \fIrun\-options\fR .RS 4 -コマンドライン\fI実行オプション\fR。\fI実行オプション\fRは任意の順序で指定できます。実行オプションを参照してください。 +コマンド行\fB実行オプション\fR。\fB実行オプション\fRは任意の順序で指定できます。実行オプションを参照してください。 .RE .PP \fIjnlp\fR @@ -84,18 +86,18 @@ .PP \fI制御オプション\fR .RS 4 -コマンドライン\fI制御オプション\fR。\fI制御オプション\fRは任意の順序で指定できます。制御オプションを参照してください。 +コマンド行\fB制御オプション\fR。\fB制御オプション\fRは任意の順序で指定できます。制御オプションを参照してください。 .RE .SH "説明" .PP \fB注意:\fR -\fIjavaws\fRコマンドは、Oracle Solarisでは使用できません。 +\fBjavaws\fRコマンドは、Oracle Solarisでは使用できません。 .PP -\fIjavaws\fRコマンドは、JNLPのリファレンス実装であるJava Web Startを起動します。Java Web Startは、ネットワーク上で動作するJavaアプリケーションおよびアプレットを起動します。 +\fBjavaws\fRコマンドは、JNLPのリファレンス実装であるJava Web Startを起動します。Java Web Startは、ネットワーク上で動作するJavaアプリケーションおよびアプレットを起動します。 .PP -JNLPファイルが指定されると、\fIjavaws\fRコマンドはJNLPファイルで指定したJavaアプリケーションまたはアプレットを起動します。 +JNLPファイルが指定されると、\fBjavaws\fRコマンドはJNLPファイルで指定したJavaアプリケーションまたはアプレットを起動します。 .PP -\fIjavaws\fR起動ツールには、現在のリリースでサポートされている1組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。 +\fBjavaws\fR起動ツールには、現在のリリースでサポートされている1組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。 .SH "実行オプション" .PP \-offline @@ -110,14 +112,14 @@ .PP \-open \fIarguments\fR .RS 4 -このオプションを指定すると、JNLPファイル内の引数が\fI\-open\fR -\fIarguments\fRに置き換わります。 +このオプションを指定すると、JNLPファイル内の引数が\fB\-open\fR +\fBarguments\fRに置き換わります。 .RE .PP \-print \fIarguments\fR .RS 4 -このオプションを指定すると、JNLPファイル内の引数が\fI\-print\fR -\fIarguments\fRに置き換わります。 +このオプションを指定すると、JNLPファイル内の引数が\fB\-print\fR +\fBarguments\fRに置き換わります。 .RE .PP \-online @@ -127,7 +129,7 @@ .PP \-wait .RS 4 -\fIjavaws\fRプロセスは、アプリケーションが終了するまで終了しません。Windowsプラットフォーム上では、このオプションは説明したとおりに機能しません。 +\fBjavaws\fRプロセスは、アプリケーションが終了するまで終了しません。Windowsプラットフォーム上では、このオプションは説明したとおりに機能しません。 .RE .PP \-verbose @@ -137,7 +139,7 @@ .PP \-J\fIoption\fR .RS 4 -Java仮想マシンにoptionを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineにoptionを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .PP \-system @@ -200,20 +202,20 @@ \-shortcut .RS 4 ユーザーがプロンプトを受け入れればショートカットをインストールします。このオプションは、 -\fI\-silent\fRオプションも使用しないと効果がありません。 +\fB\-silent\fRオプションも使用しないと効果がありません。 .RE .PP \-association .RS 4 ユーザーがプロンプトを受け入れればアソシエーションをインストールします。このオプションは、 -\fI\-silent\fRオプションも使用しないと効果がありません。 +\fB\-silent\fRオプションも使用しないと効果がありません。 .RE .PP -\fB注意:\fR\fIjavaws \-shortcut \-uninstall\fR +\fB注意:\fR\fBjavaws \-shortcut \-uninstall\fR .SH "ファイル" .PP -ユーザーおよびシステム・キャッシュならびにdeployment\&.propertiesファイルの詳細は、構成ファイルおよびプロパティのデプロイメント -(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/deployment/deployment\-guide/properties\&.html)を参照してください +ユーザーおよびシステム・キャッシュならびにdeployment\&.propertiesファイルの詳細は、デプロイメント構成ファイルおよびプロパティ +(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jweb/jcp/properties\&.html)を参照してください .SH "関連項目" .sp .RS 4
--- a/src/linux/doc/man/ja/jcmd.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jcmd.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jcmd -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2012, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jcmd +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jcmd" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jcmd \- 実行中のJava仮想マシン(JVM)に診断コマンド・リクエストを送信します。 +.SH "名前" +jcmd \- 実行中のJava Virtual Machine (JVM)に診断コマンド・リクエストを送信します。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjcmd\fR [\fI\-l\fR|\fI\-h\fR|\fI\-help\fR] +\fBjcmd\fR [\fB\-l\fR|\fB\-h\fR|\fB\-help\fR] .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjcmd\fR \fIpid\fR|\fImain\-class\fR \fIPerfCounter\&.print\fR +\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fBPerfCounter\&.print\fR .fi .if n \{\ .RE @@ -76,7 +78,7 @@ .RS 4 .\} .nf -\fIjcmd\fR \fIpid\fR|\fImain\-class\fR \fI\-f\fR \fIfilename\fR +\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fB\-f\fR \fIfilename\fR .fi .if n \{\ .RE @@ -86,21 +88,21 @@ .RS 4 .\} .nf -\fIjcmd\fR \fIpid\fR|\fImain\-class\fR \fIcommand\fR[ \fIarguments\fR] +\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fIcommand\fR[ \fIarguments\fR] .fi .if n \{\ .RE .\} .SH "説明" .PP -\fIjcmd\fRユーティリティは、JVMに診断コマンド・リクエストを送信するために使用されます。これはJVMが稼働しているのと同じマシンで使用し、JVMの起動に使用したものと同じ有効ユーザーおよびグループ識別子を持っている必要があります。 +\fBjcmd\fRユーティリティは、JVMに診断コマンド・リクエストを送信するために使用されます。これはJVMが稼働しているのと同じマシンで使用し、JVMの起動に使用したものと同じ有効ユーザーおよびグループ識別子を持っている必要があります。 .PP \fB注意:\fR -リモート・マシンから、または別の識別子で診断コマンドを起動するには、\fIcom\&.sun\&.management\&.DiagnosticCommandMBean\fRインタフェースを使用できます。\fIDiagnosticCommandMBean\fRインタフェースの詳細は、http://download\&.java\&.net/jdk8/docs/jre/api/management/extension/com/sun/management/DiagnosticCommandMBean\&.htmlにあるAPIドキュメントを参照してください。 +リモート・マシンから、または別の識別子で診断コマンドを起動するには、\fBcom\&.sun\&.management\&.DiagnosticCommandMBean\fRインタフェースを使用できます。\fBDiagnosticCommandMBean\fRインタフェースの詳細は、http://docs\&.oracle\&.com/javase/8/docs/jre/api/management/extension/com/sun/management/DiagnosticCommandMBean\&.htmlにあるAPIドキュメントを参照してください。 .PP -\fIjcmd\fRを引数なしまたは\fI\- l\fRオプションを指定して実行した場合は、実行中のJavaプロセス識別子のリストが、メイン・クラスおよびプロセスの起動に使用されたコマンドライン引数とともに出力されます。\fI\-h\fRまたは\fI\-help\fRオプションを指定して\fIjcmd\fRを実行すると、ツールのヘルプ・メッセージが出力されます。 +\fBjcmd\fRを引数なしまたは\fB\- l\fRオプションを指定して実行した場合は、実行中のJavaプロセス識別子のリストが、メイン・クラスおよびプロセスの起動に使用されたコマンド行引数とともに出力されます。\fB\-h\fRまたは\fB\-help\fRオプションを指定して\fBjcmd\fRを実行すると、ツールのヘルプ・メッセージが出力されます。 .PP -プロセス識別子(\fIpid\fR)またはメイン・クラス(\fImain\-class\fR)を最初の引数として指定した場合、\fIjcmd\fRは、識別子を指定した場合はJavaプロセスに、メイン・クラスの名前を指定した場合はすべてのJavaプロセスに診断コマンド・リクエストを送信します。プロセス識別子として\fI0\fRを指定して、すべての使用可能なJavaプロセスに診断コマンド・リクエストを送信することもできます。診断コマンド・リクエストとして、次のいずれかを使用します。 +プロセス識別子(\fIpid\fR)またはメイン・クラス(\fImain\-class\fR)を最初の引数として指定した場合、\fBjcmd\fRは、識別子を指定した場合はJavaプロセスに、メイン・クラスの名前を指定した場合はすべてのJavaプロセスに診断コマンド・リクエストを送信します。プロセス識別子として\fB0\fRを指定して、すべての使用可能なJavaプロセスに診断コマンド・リクエストを送信することもできます。診断コマンド・リクエストとして、次のいずれかを使用します。 .PP Perfcounter\&.print .RS 4 @@ -109,15 +111,15 @@ .PP \-f \fIfilename\fR .RS 4 -診断コマンドを読み取り、指定したJavaプロセスに送信するファイルの名前。\fI\-f\fRオプションでのみ使用します。ファイル内の各コマンドは、1行で記述する必要があります。番号記号(\fI#\fR)で始まる行は無視されます。すべての行が読み取られるか、\fIstop\fRキーワードを含む行が読み取られると、ファイルの処理が終了します。 +診断コマンドを読み取り、指定したJavaプロセスに送信するファイルの名前。\fB\-f\fRオプションでのみ使用します。ファイル内の各コマンドは、1行で記述する必要があります。番号記号(\fB#\fR)で始まる行は無視されます。すべての行が読み取られるか、\fBstop\fRキーワードを含む行が読み取られると、ファイルの処理が終了します。 .RE .PP \fIcommand\fR [\fIarguments\fR] .RS 4 -指定されたJavaプロセスに送信するコマンド。指定したプロセスで使用できる診断コマンドのリストは、このプロセスに対して\fIhelp\fRコマンドを送信すれば表示されます。各診断コマンドに独自の引数セットがあります。コマンドの説明、構文および使用可能な引数のリストを表示するには、\fIhelp\fRコマンドの引数としてコマンド名を使用します。 +指定されたJavaプロセスに送信するコマンド。指定したプロセスで使用できる診断コマンドのリストは、このプロセスに対して\fBhelp\fRコマンドを送信すれば表示されます。各診断コマンドに独自の引数セットがあります。コマンドの説明、構文および使用可能な引数のリストを表示するには、\fBhelp\fRコマンドの引数としてコマンド名を使用します。 .sp \fB注意:\fR -引数にスペースが含まれている場合は、一重引用符または二重引用符(\fI\*(Aq\fRまたは\fI"\fR)で囲む必要があります。加えて、オペレーティング・システム・シェルが引用符を処理しないように、バックスラッシュ(\fI\e\fR)で一重引用符または二重引用符をエスケープする必要があります。または、これらの引数を一重引用符で囲んでから、二重引用符で囲むこともできます(または二重引用符で囲んでから、一重引用符で囲む)。 +引数にスペースが含まれている場合は、一重引用符または二重引用符(\fB\*(Aq\fRまたは\fB"\fR)で囲む必要があります。加えて、オペレーティング・システム・シェルが引用符を処理しないように、バックスラッシュ(\fB\e\fR)で一重引用符または二重引用符をエスケープする必要があります。または、これらの引数を一重引用符で囲んでから、二重引用符で囲むこともできます(または二重引用符で囲んでから、一重引用符で囲む)。 .RE .SH "オプション" .PP @@ -125,17 +127,19 @@ .PP \-f \fIfilename\fR .RS 4 -指定されたファイルからコマンドを読み取ります。このオプションは、最初の引数としてプロセス識別子またはメイン・クラスを指定する場合にのみ使用できます。ファイル内の各コマンドは、1行で記述する必要があります。番号記号(\fI#\fR)で始まる行は無視されます。すべての行が読み取られるか、\fIstop\fRキーワードを含む行が読み取られると、ファイルの処理が終了します。 +指定されたファイルからコマンドを読み取ります。このオプションは、最初の引数としてプロセス識別子またはメイン・クラスを指定する場合にのみ使用できます。ファイル内の各コマンドは、1行で記述する必要があります。番号記号(\fB#\fR)で始まる行は無視されます。すべての行が読み取られるか、\fBstop\fRキーワードを含む行が読み取られると、ファイルの処理が終了します。 .RE .PP -\-h, \-help +\-h +.br +\-help .RS 4 ヘルプ・メッセージが出力されます。 .RE .PP \-l .RS 4 -実行中のJavaプロセス識別子のリストをメイン・クラスおよびコマンドライン引数とともに出力します。 +実行中のJavaプロセス識別子のリストをメイン・クラスおよびコマンド行引数とともに出力します。 .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/jconsole.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jconsole.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jconsole -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Javaトラブルシューティング、プロファイリング、モニタリングおよび管理ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jconsole +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Javaトラブルシューティング、プロファイリング、モニタリングおよび管理ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jconsole" "1" "2013年11月21日" "JDK 8" "Javaトラブルシューティング、プロファイリング、モニタリン" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jconsole \- Javaアプリケーションを監視および管理するためのグラフィカル・コンソールを開始します。 +.SH "名前" +jconsole \- Javaアプリケーションをモニターおよび管理するためのグラフィカル・コンソールを開始します。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjconsole\fR [ \fIoptions\fR ] [ connection \&.\&.\&. ] +\fBjconsole\fR [ \fIoptions\fR ] [ connection \&.\&.\&. ] .fi .if n \{\ .RE @@ -64,24 +66,24 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP connection = \fIpid\fR | \fIhost\fR:\fIport\fR | \fIjmxURL\fR .RS 4 -\fIpid\fR値はローカルのJava仮想マシン(JVM)のプロセスIDです。JVMは\fIjconsole\fRコマンドを実行しているユーザーIDと同じユーザーIDで実行する必要があります。\fIhost:port\fR値はJVMが動作しているホスト・システムの名前と、JVMが開始したときにシステム・プロパティ\fIcom\&.sun\&.management\&.jmxremote\&.port\fRで指定したポート番号です。\fIjmxUrl\fR値は、JMXServiceURLで記述されている、接続されるJMXエージェントのアドレスです。 +\fBpid\fR値はローカルのJava Virtual Machine (JVM)のプロセスIDです。JVMは\fBjconsole\fRコマンドを実行しているユーザーIDと同じユーザーIDで実行する必要があります。\fBhost:port\fR値はJVMが動作しているホスト・システムの名前と、JVMが開始したときにシステム・プロパティ\fBcom\&.sun\&.management\&.jmxremote\&.port\fRで指定したポート番号です。\fBjmxUrl\fR値は、JMXServiceURLで記述されている、接続されるJMXエージェントのアドレスです。 .sp -\fIconnection\fRパラメータの詳細は、JMXテクノロジを使用したモニタリングおよび管理 +\fBconnection\fRパラメータの詳細は、JMXテクノロジを使用したモニタリングおよび管理 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/agent\&.html)を参照してください .sp -\fIJMXServiceURL\fRクラスの説明( +\fBJMXServiceURL\fRクラスの説明( http://docs\&.oracle\&.com/javase/8/docs/api/javax/management/remote/JMXServiceURL\&.html)も参照してください .RE .SH "説明" .PP -\fIjconsole\fRコマンドは、ローカル・マシンまたはリモート・マシン上のJavaアプリケーションと仮想マシンの監視と管理を行うグラフィカル・コンソール・ツールを起動します。 +\fBjconsole\fRコマンドは、ローカル・マシンまたはリモート・マシン上のJavaアプリケーションと仮想マシンをモニターおよび管理するグラフィカル・コンソール・ツールを起動します。 .PP -Windows上では、\fIjconsole\fRコマンドはコンソール・ウィンドウと関連付けられていません。ただし、\fIjconsole\fRコマンドが失敗すると、エラー情報を示すダイアログ・ボックスが表示されます。 +Windows上では、\fBjconsole\fRコマンドはコンソール・ウィンドウと関連付けられていません。ただし、\fBjconsole\fRコマンドが失敗すると、エラー情報を示すダイアログ・ボックスが表示されます。 .SH "オプション" .PP \-interval\fI=n\fR @@ -91,12 +93,12 @@ .PP \-notile .RS 4 -最初にウィンドウをタイリングしません(複数接続の場合)。 +最初はウィンドウをタイル表示しません(複数接続の場合)。 .RE .PP \-pluginpath \fIplugins\fR .RS 4 -\fIJConsole\fRプラグインを検索するディレクトリまたはJARファイルのリストを指定します。\fIplugins\fRパスには\fIMETA\-INF/services/com\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fRという名前のプロバイダ構成ファイルを含んでいる必要があり、これにはプラグインごとに1行が含まれています。その行は\fIcom\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fRクラスを実装しているクラスの完全修飾クラス名を指定します。 +\fBJConsole\fRプラグインを検索するディレクトリまたはJARファイルのリストを指定します。\fIplugins\fRパスには\fBMETA\-INF/services/com\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fRという名前のプロバイダ構成ファイルを含んでいる必要があり、これにはプラグインごとに1行が含まれています。その行は\fBcom\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fRクラスを実装しているクラスの完全修飾クラス名を指定します。 .RE .PP \-version @@ -111,7 +113,7 @@ .PP \-J\fIflag\fR .RS 4 -\fIjconsole\fRコマンドを実行したJVMに\fIflag\fRを渡します。 +\fBjconsole\fRコマンドを実行したJVMに\fBflag\fRを渡します。 .RE .SH "関連項目" .sp @@ -148,7 +150,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIJMXServiceURL\fRクラスの説明( +\fBJMXServiceURL\fRクラスの説明( http://docs\&.oracle\&.com/javase/8/docs/api/javax/management/remote/JMXServiceURL\&.html) .RE .br
--- a/src/linux/doc/man/ja/jdb.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jdb.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jdb -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jdb +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jdb" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jdb \- Javaプラットフォーム・プログラムの不具合を検出および修正します。 +.SH "名前" +jdb \- Javaプラットフォーム・プログラムのbugを検出および修正します。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjdb\fR [\fIoptions\fR] [\fIclassname\fR] [\fIarguments\fR] +\fBjdb\fR [\fIoptions\fR] [\fIclassname\fR] [\fIarguments\fR] .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIclass\fRname @@ -74,67 +76,70 @@ .PP \fIarguments\fR .RS 4 -classの\fImain()\fRメソッドに渡す引数。 +classの\fBmain()\fRメソッドに渡す引数。 .RE .SH "説明" .PP -Javaデバッガ(JDB)は、Javaクラス用の簡単なコマンドライン・デバッガです。\fIjdb\fRコマンドとそのオプションはJDBを呼び出します。\fIjdb\fRコマンドは、JDBA (Java Platform Debugger Architecture)を視覚的に実行し、ローカルまたはリモートのJava仮想マシン(JVM)の検査とデバッグを行うことができます。Java Platform Debugger Architecture (JDBA) +Javaデバッガ(JDB)は、Javaクラス用の簡単なコマンド行デバッガです。\fBjdb\fRコマンドとそのオプションはJDBを呼び出します。\fBjdb\fRコマンドは、JDBA (Java Platform Debugger Architecture)を視覚的に実行し、ローカルまたはリモートのJava Virtual Machine (JVM)の検査とデバッグを行うことができます。Java Platform Debugger Architecture (JDBA) (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jpda/index\&.html)を参照してください。 .SS "JDBセッションの開始" .PP -JDBセッションを開始するには様々な方法があります。最も頻繁に使用されるのは、デバッグするアプリケーションのメイン・クラスを使用して、JDBから新しいJVMを起動する方法です。コマンドラインで、\fIjava\fRコマンドのかわりに\fIjdb\fRコマンドを入力します。たとえば、アプリケーションのメイン・クラスが\fIMyClass\fRの場合は、JDB環境でデバッグするときに次のコマンドを使用します。 +JDBセッションを開始するには様々な方法があります。最も頻繁に使用されるのは、デバッグするアプリケーションのメイン・クラスを使用して、JDBから新しいJVMを起動する方法です。コマンド行で、\fBjava\fRコマンドのかわりに\fBjdb\fRコマンドを入力します。たとえば、アプリケーションのメイン・クラスが\fBMyClass\fRの場合は、JDB環境でデバッグするときに次のコマンドを使用します。 .sp .if n \{\ .RS 4 .\} .nf -jdb MyClass +\fBjdb MyClass\fR + .fi .if n \{\ .RE .\} .PP -この方法で起動すると、\fIjdb\fRコマンドは、指定されたパラメータを使用して2つ目のJVMを呼び出します。次に、指定されたクラスをロードして、クラスの最初の命令を実行する前にJVMを停止させます。 +この方法で起動すると、\fBjdb\fRコマンドは、指定されたパラメータを使用して2つ目のJVMを呼び出します。次に、指定されたクラスをロードして、クラスの最初の命令を実行する前にJVMを停止させます。 .PP -\fIjdb\fRコマンドのもう1つの使用方法は、すでに実行中のJVMにjdbを接続することです。\fIjdb\fRコマンドが接続するVMを、その実行中に起動するための構文を次に示します。これは、インプロセス・デバッグ用ライブラリをロードし、接続の種類を指定します。 +\fBjdb\fRコマンドのもう1つの使用方法は、すでに実行中のJVMにjdbを接続することです。\fBjdb\fRコマンドが接続するVMを、その実行中に起動するための構文を次に示します。これは、インプロセス・デバッグ用ライブラリをロードし、接続の種類を指定します。 .sp .if n \{\ .RS 4 .\} .nf -java \-agentlib:jdwp=transport=dt_socket,server=y,suspend=n MyClass +\fBjava \-agentlib:jdwp=transport=dt_socket,server=y,suspend=n MyClass\fR + .fi .if n \{\ .RE .\} .PP -次のコマンドを使用して、\fIjdb\fRコマンドをJVMに接続できます。 +次のコマンドを使用して、\fBjdb\fRコマンドをJVMに接続できます。 .sp .if n \{\ .RS 4 .\} .nf -jdb \-attach 8000 +\fBjdb \-attach 8000\fR + .fi .if n \{\ .RE .\} .PP -この場合、\fIjdb\fRコマンドは新しいJVMを起動するかわりに既存のJVMに接続されるため、\fIjdb\fRコマンドラインに\fIMyClass\fR引数は指定しません。 +この場合、\fBjdb\fRコマンドは新しいJVMを起動するかわりに既存のJVMに接続されるため、\fBjdb\fRコマンド行に\fBMyClass\fR引数は指定しません。 .PP -デバッガをJVMに接続するには他にも様々な方法があり、すべて\fIjdb\fRコマンドでサポートされています。接続オプションについては、Java Platform Debugger Architectureのドキュメントを参照してください。 +デバッガをJVMに接続するには他にも様々な方法があり、すべて\fBjdb\fRコマンドでサポートされています。接続オプションについては、Java Platform Debugger Architectureのドキュメントを参照してください。 .SS "基本jdbコマンド" .PP -基本的な\fIjdb\fRコマンドの一覧を示します。JDBがサポートするコマンドはこれ以外にもあり、それらは\fI\-help\fRオプションを使用して表示できます。 +基本的な\fBjdb\fRコマンドの一覧を示します。JDBがサポートするコマンドはこれ以外にもあり、それらは\fB\-help\fRオプションを使用して表示できます。 .PP helpまたは? .RS 4 -\fIhelp\fRまたは\fI?\fRコマンドは、認識されたコマンドのリストに簡潔な説明を付けて表示します。 +\fBhelp\fRまたは\fB?\fRコマンドは、認識されたコマンドのリストに簡潔な説明を付けて表示します。 .RE .PP run .RS 4 -JDBを起動してブレークポイントを設定したあとに、\fIrun\fRコマンドを使用して、デバッグするアプリケーションの実行を開始できます。\fIrun\fRコマンドは、既存のVMに接続している場合とは異なり、デバッグするアプリケーションが\fIjdb\fRから起動したときにのみ使用できます。 +JDBを起動してブレークポイントを設定したあとに、\fBrun\fRコマンドを使用して、デバッグするアプリケーションの実行を開始できます。\fBrun\fRコマンドは、既存のVMに接続している場合とは異なり、デバッグするアプリケーションが\fBjdb\fRから起動したときにのみ使用できます。 .RE .PP cont @@ -147,19 +152,20 @@ Javaオブジェクトおよびプリミティブ値を表示します。プリミティブ型の変数またはフィールドの場合には、実際の値が出力されます。オブジェクトの場合には、短い説明が出力されます。オブジェクトの詳細を取得する方法を探すには、dumpコマンドを参照してください。 .sp \fB注意:\fR -ローカル変数を表示するには、含んでいるクラスが\fIjavac \-g\fRオプションを使用してコンパイルされている必要があります。 +ローカル変数を表示するには、含んでいるクラスが\fBjavac \-g\fRオプションを使用してコンパイルされている必要があります。 .sp -\fIprint\fRコマンドは、次に示すような、メソッド呼出しを使用したものなど、多くの簡単なJava式をサポートします。 +\fBprint\fRコマンドは、次に示すような、メソッド呼出しを使用したものなど、多くの簡単なJava式をサポートします。 .sp .if n \{\ .RS 4 .\} .nf -print MyClass\&.myStaticField -print myObj\&.myInstanceField -print i + j + k (i, j, k are primities and either fields or local variables) -print myObj\&.myMethod() (if myMethod returns a non\-null) -print new java\&.lang\&.String("Hello")\&.length() +\fBprint MyClass\&.myStaticField\fR +\fBprint myObj\&.myInstanceField\fR +\fBprint i + j + k (i, j, k are primities and either fields or local variables)\fR +\fBprint myObj\&.myMethod() (if myMethod returns a non\-null)\fR +\fBprint new java\&.lang\&.String("Hello")\&.length()\fR + .fi .if n \{\ .RE @@ -168,18 +174,19 @@ .PP dump .RS 4 -プリミティブ値の場合、\fIdump\fRコマンドは\fIprint\fRコマンドと同一です。オブジェクトの場合、\fIdump\fRコマンドでは、オブジェクト内に定義されている各フィールドの現在の値が出力されます。staticフィールドとinstanceフィールドが出力されます。\fIdump\fRコマンドでは、\fIprint\fRコマンドと同じ式がサポートされます。 +プリミティブ値の場合、\fBdump\fRコマンドは\fBprint\fRコマンドと同一です。オブジェクトの場合、\fBdump\fRコマンドでは、オブジェクト内に定義されている各フィールドの現在の値が出力されます。staticフィールドとinstanceフィールドが出力されます。\fBdump\fRコマンドでは、\fBprint\fRコマンドと同じ式がサポートされます。 .RE .PP threads .RS 4 -現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、および他のコマンドに使用できるインデックスが出力されます。この例では、スレッド・インデックスは4であり、スレッドは\fIjava\&.lang\&.Thread\fRのインスタンスで、スレッドの名前は\fImain\fRであり、現在実行中です。 +現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、および他のコマンドに使用できるインデックスが出力されます。この例では、スレッド・インデックスは4であり、スレッドは\fBjava\&.lang\&.Thread\fRのインスタンスで、スレッドの名前は\fBmain\fRであり、現在実行中です。 .sp .if n \{\ .RS 4 .\} .nf -4\&. (java\&.lang\&.Thread)0x1 main running +\fB4\&. (java\&.lang\&.Thread)0x1 main running\fR + .fi .if n \{\ .RE @@ -188,16 +195,16 @@ .PP thread .RS 4 -現在のスレッドにするスレッドを選択します。多くの\fIjdb\fRコマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、threadsコマンドで説明したスレッド・インデックスとともに指定します。 +現在のスレッドにするスレッドを選択します。多くの\fBjdb\fRコマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、threadsコマンドで説明したスレッド・インデックスとともに指定します。 .RE .PP where .RS 4 -引数を指定しないで\fIwhere\fRコマンドを実行すると、現在のスレッドのスタックがダンプされます。\fIwhere\fR -\fIall\fRコマンドは、現在のスレッド・グループにあるスレッドのスタックをすべてダンプします。\fIwhere\fR -\fIthreadindex\fRコマンドは、指定されたスレッドのスタックをダンプします。 +引数を指定しないで\fBwhere\fRコマンドを実行すると、現在のスレッドのスタックがダンプされます。\fBwhere\fR +\fBall\fRコマンドは、現在のスレッド・グループにあるスレッドのスタックをすべてダンプします。\fBwhere\fR +\fBthreadindex\fRコマンドは、指定されたスレッドのスタックをダンプします。 .sp -現在のスレッドが(ブレークポイントか\fIsuspend\fRコマンドによって)中断している場合は、ローカル変数とフィールドは\fIprint\fRコマンドと\fIdump\fRコマンドで表示できます。\fIup\fRコマンドと\fIdown\fRコマンドで、どのスタック・フレームを現在のスタック・フレームにするかを選ぶことができます。 +現在のスレッドが(ブレークポイントか\fBsuspend\fRコマンドによって)中断している場合は、ローカル変数とフィールドは\fBprint\fRコマンドと\fBdump\fRコマンドで表示できます。\fBup\fRコマンドと\fBdown\fRコマンドで、どのスタック・フレームを現在のスタック・フレームにするかを選ぶことができます。 .RE .SS "ブレークポイント" .PP @@ -211,7 +218,7 @@ .sp -1 .IP \(bu 2.3 .\} -コマンド\fIstop at MyClass:22\fRは、\fIMyClass\fRが含まれるソース・ファイルの22行目の最初の命令にブレークポイントを設定します。 +コマンド\fBstop at MyClass:22\fRは、\fBMyClass\fRが含まれるソース・ファイルの22行目の最初の命令にブレークポイントを設定します。 .RE .sp .RS 4 @@ -222,7 +229,7 @@ .sp -1 .IP \(bu 2.3 .\} -コマンド\fIstop in java\&.lang\&.String\&.length\fRは、メソッド\fIjava\&.lang\&.String\&.length\fRの先頭にブレークポイントを設定します。 +コマンド\fBstop in java\&.lang\&.String\&.length\fRは、メソッド\fBjava\&.lang\&.String\&.length\fRの先頭にブレークポイントを設定します。 .RE .sp .RS 4 @@ -233,26 +240,26 @@ .sp -1 .IP \(bu 2.3 .\} -コマンド\fIstop in MyClass\&.<clinit>\fRは、\fI<clinit>\fRを使用して\fIMyClass\fRの静的初期化コードを特定します。 +コマンド\fBstop in MyClass\&.<clinit>\fRは、\fB<clinit>\fRを使用して、\fBMyClass\fRの静的初期化コードを特定します。 .RE .PP -メソッドがオーバーロードされている場合には、メソッドの引数の型も指定して、ブレークポイントに対して適切なメソッドが選択されるようにする必要があります。たとえば、\fIMyClass\&.myMethod(int,java\&.lang\&.String)\fRまたは\fIMyClass\&.myMethod()\fRと指定します。 +メソッドがオーバーロードされている場合には、メソッドの引数の型も指定して、ブレークポイントに対して適切なメソッドが選択されるようにする必要があります。たとえば、\fBMyClass\&.myMethod(int,java\&.lang\&.String)\fRまたは\fBMyClass\&.myMethod()\fRと指定します。 .PP -\fIclear\fRコマンドは、\fIclear MyClass:45\fRのような構文を使用してブレークポイントを削除します。\fIclear\fRを使用するか、引数を指定しないで\fIstop\fRコマンドを使用すると、現在設定されているすべてのブレークポイントが表示されます。\fIcont\fRコマンドは実行を継続します。 +\fBclear\fRコマンドは、\fBclear MyClass:45\fRのような構文を使用してブレークポイントを削除します。\fBclear\fRを使用するか、引数を指定しないで\fBstop\fRコマンドを使用すると、現在設定されているすべてのブレークポイントが表示されます。\fBcont\fRコマンドは実行を継続します。 .SS "ステップ実行" .PP -\fIstep\fRコマンドは、現在のスタック・フレームまたは呼び出されたメソッド内で、次の行を実行します。\fInext\fRコマンドは、現在のスタック・フレームの次の行を実行します。 +\fBstep\fRコマンドは、現在のスタック・フレームまたは呼び出されたメソッド内で、次の行を実行します。\fBnext\fRコマンドは、現在のスタック・フレームの次の行を実行します。 .SS "例外" .PP -スローしているスレッドの呼出しスタック上のどこにも\fIcatch\fR文がない場合に例外が発生すると、JVMは通常、例外トレースを出力して終了します。ただし、JDB環境で実行している場合は、違反のスロー時にJDBに制御が戻ります。次に、\fIjdb\fRコマンドを使用して例外の原因を診断します。 +スローしているスレッドの呼出しスタック上のどこにも\fBcatch\fR文がない場合に例外が発生すると、JVMは通常、例外トレースを出力して終了します。ただし、JDB環境で実行している場合は、違反のスロー時にJDBに制御が戻ります。次に、\fBjdb\fRコマンドを使用して例外の原因を診断します。 .PP -たとえば、\fIcatch java\&.io\&.FileNotFoundException\fRまたは\fIcatch\fR -\fImypackage\&.BigTroubleException\fRのように\fIcatch\fRコマンドを使用すると、デバッグされたアプリケーションは、他の例外がスローされたときに停止します。例外が特定のクラスまたはサブクラスのインスタンスの場合は、アプリケーションは例外がスローされた場所で停止します。 +たとえば、\fBcatch java\&.io\&.FileNotFoundException\fRまたは\fBcatch\fR +\fBmypackage\&.BigTroubleException\fRのように\fBcatch\fRコマンドを使用すると、デバッグされたアプリケーションは、他の例外がスローされたときに停止します。例外が特定のクラスまたはサブクラスのインスタンスの場合は、アプリケーションは例外がスローされた場所で停止します。 .PP -\fIignore\fRコマンドを使用すると、以前の\fIcatch\fRコマンドの効果が無効になります。\fIignore\fRコマンドでは、デバッグされるJVMは特定の例外を無視せず、デバッガのみを無視します。 +\fBignore\fRコマンドを使用すると、以前の\fBcatch\fRコマンドの効果が無効になります。\fBignore\fRコマンドでは、デバッグされるJVMは特定の例外を無視せず、デバッガのみを無視します。 .SH "オプション" .PP -コマンドラインで\fIjava\fRコマンドのかわりに\fIjdb\fRコマンドを使用する場合、\fIjdb\fRコマンドは、\fI\-D\fR、\fI\-classpath\fR、\fI\-X\fRなど、\fIjava\fRコマンドと同じ数のオプションを受け入れます。\fIjdb\fRコマンドは、その他に次のリストにあるオプションを受け入れます。 +コマンド行で\fBjava\fRコマンドのかわりに\fBjdb\fRコマンドを使用する場合、\fBjdb\fRコマンドは、\fB\-D\fR、\fB\-classpath\fR、\fB\-X\fRなど、\fBjava\fRコマンドと同じ数のオプションを受け入れます。\fBjdb\fRコマンドは、その他に次のリストにあるオプションを受け入れます。 .PP デバッグを行うJVMにデバッガを接続するための代替機構を提供するために、その他のオプションがサポートされています。これらの接続の代替に関する詳細なドキュメントは、Java Platform Debugger Architecture (JPDA) (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jpda/index\&.html)を参照してください @@ -279,7 +286,7 @@ .PP \-launch .RS 4 -デバッグするアプリケーションをJDBの起動後ただちに起動します。\fI\-launch\fRオプションにより、\fIrun\fRコマンドが必要なくなります。デバッグするアプリケーションは、起動後、初期アプリケーション・クラスがロードされる直前に停止します。その時点で、必要なブレークポイントを設定し、\fIcont\fRコマンドを使用して実行を継続できます。 +デバッグするアプリケーションをJDBの起動後ただちに起動します。\fB\-launch\fRオプションにより、\fBrun\fRコマンドが必要なくなります。デバッグするアプリケーションは、起動後、初期アプリケーション・クラスがロードされる直前に停止します。その時点で、必要なブレークポイントを設定し、\fBcont\fRコマンドを使用して実行を継続できます。 .RE .PP \-listconnectors @@ -294,7 +301,7 @@ .PP \-dbgtrace [\fIflags\fR] .RS 4 -\fIjdb\fRコマンドのデバッグの情報を出力します。 +\fBjdb\fRコマンドのデバッグの情報を出力します。 .RE .PP \-tclient @@ -309,7 +316,7 @@ .PP \-J\fIoption\fR .RS 4 -JVMに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +JVMに\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "デバッグ対象のプロセスに転送されるオプション" .PP
--- a/src/linux/doc/man/ja/jdeps.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jdeps.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jdeps -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2013, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jdeps +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jdeps" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jdeps \- Javaクラス依存性アナライザ。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjdeps\fR [\fIoptions\fR] \fIclasses\fR \&.\&.\&. +\fBjdeps\fR [\fIoptions\fR] \fIclasses\fR \&.\&.\&. .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIclasses\fR @@ -73,20 +75,24 @@ .RE .SH "説明" .PP -\fIjdeps\fRコマンドは、Javaクラス・ファイルのパッケージレベルまたはクラスレベルの依存性を示します。入力クラスには、\fI\&.class\fRファイルのパス名、ディレクトリ、JARファイル、またはすべてのクラス・ファイルを分析するための完全修飾クラス名を指定できます。オプションにより出力が決定します。デフォルトでは、\fIjdeps\fRはシステム出力に依存関係を出力します。DOT言語で依存関係を生成できます(\fI\-dotoutput\fRオプションを参照)。 +\fBjdeps\fRコマンドは、Javaクラス・ファイルのパッケージレベルまたはクラスレベルの依存性を示します。入力クラスには、\fB\&.class\fRファイルのパス名、ディレクトリ、JARファイル、またはすべてのクラス・ファイルを分析するための完全修飾クラス名を指定できます。オプションにより出力が決定します。デフォルトでは、\fBjdeps\fRはシステム出力に依存関係を出力します。DOT言語で依存関係を生成できます(\fB\-dotoutput\fRオプションを参照)。 .SH "オプション" .PP \-dotoutput <\fIdir\fR> .RS 4 -DOTファイル出力の宛先ディレクトリ。指定した場合は\fIjdeps\fRは<\fIarchive\-file\-name\fR>\&.dotという名前の分析済みアーカイブごとに依存関係をリストする1つのdotファイルを生成し、アーカイブ間の依存関係をリストするsummary\&.dotという名前のサマリー・ファイルも生成します。 +DOTファイル出力の宛先ディレクトリ。指定した場合、\fBjdeps\fRは<\fIarchive\-file\-name\fR>\&.dotという名前の分析済アーカイブごとに依存関係をリストする1つのdotファイルを生成し、アーカイブ間の依存関係をリストするsummary\&.dotという名前のサマリー・ファイルも生成します。 .RE .PP -\-s, \-summary +\-s +.br +\-summary .RS 4 依存関係のサマリーのみを出力します。 .RE .PP -\-v, \-verbose +\-v +.br +\-verbose .RS 4 すべてのクラスレベルの依存関係を出力します。 .RE @@ -101,46 +107,56 @@ 同じアーカイブ内の依存関係を除き、クラスレベルの依存関係を出力します。 .RE .PP -\-cp <\fIpath\fR>, \-classpath <\fIpath\fR> +\-cp <\fIpath\fR> +.br +\-classpath <\fIpath\fR> .RS 4 クラス・ファイルの検索場所を指定します。 .sp Setting the Class Path も参照してください。 .RE .PP -\-p <\fIpkg name\fR>, \-package <\fIpkg name\fR> +\-p <\fIpkg name\fR> +.br +\-package <\fIpkg name\fR> .RS 4 -指定したパッケージの依存関係を検出します。異なるパッケージに対してこのオプションを複数回指定できます。\fI\-p\fRオプションと\fI\-e\fRオプションを同時に指定することはできません。 +指定したパッケージの依存関係を検出します。異なるパッケージに対してこのオプションを複数回指定できます。\fB\-p\fRオプションと\fB\-e\fRオプションを同時に指定することはできません。 .RE .PP -\-e <\fIregex\fR>, \-regex <\fIregex\fR> +\-e <\fIregex\fR> +.br +\-regex <\fIregex\fR> .RS 4 -指定した正規表現パターンと一致するパッケージの依存関係を検出します。\fI\-p\fRオプションと\fI\-e\fRオプションを同時に指定することはできません。 +指定した正規表現パターンと一致するパッケージの依存関係を検出します。\fB\-p\fRオプションと\fB\-e\fRオプションを同時に指定することはできません。 .RE .PP \-include <\fIregex\fR> .RS 4 -分析をパターンに一致するクラスに制限します。このオプションは、分析するクラスのリストをフィルタします。依存関係にパターンを適用する\fI\-p\fRおよび\fI\-e\fRとともに使用できます。 +分析をパターンに一致するクラスに制限します。このオプションは、分析するクラスのリストをフィルタします。依存関係にパターンを適用する\fB\-p\fRおよび\fB\-e\fRとともに使用できます。 .RE .PP \-jdkinternals .RS 4 -JDKの内部APIのクラスレベルの依存関係を検出します。デフォルトでは、\fI\-include\fRオプションを指定しないかぎり、\fI\-classpath\fRオプションおよび入力ファイルに指定されたすべてのクラスを分析します。このオプションは、\fI\-p\fRオプション、\fI\-e\fRオプションおよび\fI\-s\fRオプションとともに使用できません。 +JDKの内部APIのクラスレベルの依存関係を検出します。デフォルトでは、\fB\-include\fRオプションを指定しないかぎり、\fB\-classpath\fRオプションおよび入力ファイルに指定されたすべてのクラスを分析します。このオプションは、\fB\-p\fRオプション、\fB\-e\fRオプションおよび\fB\-s\fRオプションとともに使用できません。 .sp \fB警告\fR: JDKの内部APIは、今後のリリースでアクセスできなくなる可能性があります。 .RE .PP -\-P, \-profile +\-P +.br +\-profile .RS 4 パッケージを含むプロファイルまたはファイルを表示します。 .RE .PP \-apionly .RS 4 -フィールド・タイプ、メソッド・パラメータ・タイプ、戻りタイプ、チェックされた例外タイプを含むパブリック・クラスの\fIpublic\fRおよび\fIprotected\fRメンバーの署名からの依存関係など、分析をAPIに制限します。 +フィールド・タイプ、メソッド・パラメータ・タイプ、戻りタイプ、チェックされた例外タイプを含むパブリック・クラスの\fBpublic\fRおよび\fBprotected\fRメンバーの署名からの依存関係など、分析をAPIに制限します。 .RE .PP -\-R, \-recursive +\-R +.br +\-recursive .RS 4 すべての依存関係を再帰的に走査します。 .RE @@ -150,9 +166,13 @@ バージョン情報を出力します。 .RE .PP -\-h, \-?, \-help +\-h +.br +\-? +.br +\-help .RS 4 -\fIjdeps\fRに関するヘルプ・メッセージを出力します。 +\fBjdeps\fRに関するヘルプ・メッセージを出力します。 .RE .SH "例" .PP @@ -162,24 +182,25 @@ .RS 4 .\} .nf -$ jdeps demo/jfc/Notepad/Notepad\&.jar +\fB$ jdeps demo/jfc/Notepad/Notepad\&.jar\fR +\fB \fR +\fBdemo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar\fR +\fB <unnamed> (Notepad\&.jar)\fR +\fB \-> java\&.awt \fR +\fB \-> java\&.awt\&.event \fR +\fB \-> java\&.beans \fR +\fB \-> java\&.io \fR +\fB \-> java\&.lang \fR +\fB \-> java\&.net \fR +\fB \-> java\&.util \fR +\fB \-> java\&.util\&.logging \fR +\fB \-> javax\&.swing \fR +\fB \-> javax\&.swing\&.border \fR +\fB \-> javax\&.swing\&.event \fR +\fB \-> javax\&.swing\&.text \fR +\fB \-> javax\&.swing\&.tree \fR +\fB \-> javax\&.swing\&.undo \fR -demo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar - <unnamed> (Notepad\&.jar) - \-> java\&.awt - \-> java\&.awt\&.event - \-> java\&.beans - \-> java\&.io - \-> java\&.lang - \-> java\&.net - \-> java\&.util - \-> java\&.util\&.logging - \-> javax\&.swing - \-> javax\&.swing\&.border - \-> javax\&.swing\&.event - \-> javax\&.swing\&.text - \-> javax\&.swing\&.tree - \-> javax\&.swing\&.undo .fi .if n \{\ .RE @@ -191,115 +212,119 @@ .RS 4 .\} .nf -$ jdeps \-profile demo/jfc/Notepad/Notepad\&.jar -demo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar (Full JRE) - <unnamed> (Notepad\&.jar) - \-> java\&.awt Full JRE - \-> java\&.awt\&.event Full JRE - \-> java\&.beans Full JRE - \-> java\&.io compact1 - \-> java\&.lang compact1 - \-> java\&.net compact1 - \-> java\&.util compact1 - \-> java\&.util\&.logging compact1 - \-> javax\&.swing Full JRE - \-> javax\&.swing\&.border Full JRE - \-> javax\&.swing\&.event Full JRE - \-> javax\&.swing\&.text Full JRE - \-> javax\&.swing\&.tree Full JRE - \-> javax\&.swing\&.undo Full JRE +\fB$ jdeps \-profile demo/jfc/Notepad/Notepad\&.jar \fR +\fBdemo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar (Full JRE)\fR +\fB <unnamed> (Notepad\&.jar)\fR +\fB \-> java\&.awt Full JRE\fR +\fB \-> java\&.awt\&.event Full JRE\fR +\fB \-> java\&.beans Full JRE\fR +\fB \-> java\&.io compact1\fR +\fB \-> java\&.lang compact1\fR +\fB \-> java\&.net compact1\fR +\fB \-> java\&.util compact1\fR +\fB \-> java\&.util\&.logging compact1\fR +\fB \-> javax\&.swing Full JRE\fR +\fB \-> javax\&.swing\&.border Full JRE\fR +\fB \-> javax\&.swing\&.event Full JRE\fR +\fB \-> javax\&.swing\&.text Full JRE\fR +\fB \-> javax\&.swing\&.tree Full JRE\fR +\fB \-> javax\&.swing\&.undo Full JRE\fR + .fi .if n \{\ .RE .\} .PP -tools\&.jarファイル内の\fIcom\&.sun\&.tools\&.jdeps\&.Main\fRクラスなど、特定のクラスパス内の特定のクラスの直接依存関係の分析。 +tools\&.jarファイル内の\fBcom\&.sun\&.tools\&.jdeps\&.Main\fRクラスなど、特定のクラスパス内の特定のクラスの直接依存関係の分析。 .sp .if n \{\ .RS 4 .\} .nf -$ jdeps \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main -lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar - com\&.sun\&.tools\&.jdeps (tools\&.jar) - \-> java\&.io - \-> java\&.lang +\fB$ jdeps \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main\fR +\fBlib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar\fR +\fB com\&.sun\&.tools\&.jdeps (tools\&.jar)\fR +\fB \-> java\&.io \fR +\fB \-> java\&.lang \fR + .fi .if n \{\ .RE .\} .PP -\fI\-verbose:class\fRオプションを使用して、クラスレベル依存関係を検索するか\fI\-v\fRまたは\fI\-verbose\fRオプションを使用して同じJARファイルからの依存関係を含めます。 +\fB\-verbose:class\fRオプションを使用して、クラスレベル依存関係を検索するか\fB\-v\fRまたは\fB\-verbose\fRオプションを使用して同じJARファイルからの依存関係を含めます。 .sp .if n \{\ .RS 4 .\} .nf -$ jdeps \-verbose:class \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main +\fB$ jdeps \-verbose:class \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main\fR +\fB \fR +\fBlib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar\fR +\fB com\&.sun\&.tools\&.jdeps\&.Main (tools\&.jar)\fR +\fB \-> java\&.io\&.PrintWriter \fR +\fB \-> java\&.lang\&.Exception \fR +\fB \-> java\&.lang\&.Object \fR +\fB \-> java\&.lang\&.String \fR +\fB \-> java\&.lang\&.System \fR -lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar - com\&.sun\&.tools\&.jdeps\&.Main (tools\&.jar) - \-> java\&.io\&.PrintWriter - \-> java\&.lang\&.Exception - \-> java\&.lang\&.Object - \-> java\&.lang\&.String - \-> java\&.lang\&.System .fi .if n \{\ .RE .\} .PP -\fI\-R\fRまたは\fI\-recursive\fRオプションを使用して、\fIcom\&.sun\&.tools\&.jdeps\&.Main\fRクラスの推移的な依存関係を分析します。 +\fB\-R\fRまたは\fB\-recursive\fRオプションを使用して、\fBcom\&.sun\&.tools\&.jdeps\&.Main\fRクラスの推移的な依存関係を分析します。 .sp .if n \{\ .RS 4 .\} .nf -$ jdeps \-R \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main -lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar - com\&.sun\&.tools\&.classfile (tools\&.jar) - \-> java\&.io - \-> java\&.lang - \-> java\&.lang\&.reflect - \-> java\&.nio\&.charset - \-> java\&.nio\&.file - \-> java\&.util - \-> java\&.util\&.regex - com\&.sun\&.tools\&.jdeps (tools\&.jar) - \-> java\&.io - \-> java\&.lang - \-> java\&.nio\&.file - \-> java\&.nio\&.file\&.attribute - \-> java\&.text - \-> java\&.util - \-> java\&.util\&.jar - \-> java\&.util\&.regex - \-> java\&.util\&.zip -/usr/java/jre/lib/jce\&.jar \-> /usr/java/jre/lib/rt\&.jar - javax\&.crypto (jce\&.jar) - \-> java\&.io - \-> java\&.lang - \-> java\&.lang\&.reflect - \-> java\&.net - \-> java\&.nio - \-> java\&.security - \-> java\&.security\&.cert - \-> java\&.security\&.spec - \-> java\&.util - \-> java\&.util\&.concurrent - \-> java\&.util\&.jar - \-> java\&.util\&.regex - \-> java\&.util\&.zip - \-> javax\&.security\&.auth - \-> sun\&.security\&.jca JDK internal API (rt\&.jar) - \-> sun\&.security\&.util JDK internal API (rt\&.jar) - javax\&.crypto\&.spec (jce\&.jar) - \-> java\&.lang - \-> java\&.security\&.spec - \-> java\&.util -/usr/java/jre/lib/rt\&.jar \-> /usr/java/jre/lib/jce\&.jar - java\&.security (rt\&.jar) - \-> javax\&.crypto +\fB$ jdeps \-R \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main\fR +\fBlib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar\fR +\fB com\&.sun\&.tools\&.classfile (tools\&.jar)\fR +\fB \-> java\&.io \fR +\fB \-> java\&.lang \fR +\fB \-> java\&.lang\&.reflect \fR +\fB \-> java\&.nio\&.charset \fR +\fB \-> java\&.nio\&.file \fR +\fB \-> java\&.util \fR +\fB \-> java\&.util\&.regex \fR +\fB com\&.sun\&.tools\&.jdeps (tools\&.jar)\fR +\fB \-> java\&.io \fR +\fB \-> java\&.lang \fR +\fB \-> java\&.nio\&.file \fR +\fB \-> java\&.nio\&.file\&.attribute \fR +\fB \-> java\&.text \fR +\fB \-> java\&.util \fR +\fB \-> java\&.util\&.jar \fR +\fB \-> java\&.util\&.regex \fR +\fB \-> java\&.util\&.zip \fR +\fB/usr/java/jre/lib/jce\&.jar \-> /usr/java/jre/lib/rt\&.jar\fR +\fB javax\&.crypto (jce\&.jar)\fR +\fB \-> java\&.io \fR +\fB \-> java\&.lang \fR +\fB \-> java\&.lang\&.reflect \fR +\fB \-> java\&.net \fR +\fB \-> java\&.nio \fR +\fB \-> java\&.security \fR +\fB \-> java\&.security\&.cert \fR +\fB \-> java\&.security\&.spec \fR +\fB \-> java\&.util \fR +\fB \-> java\&.util\&.concurrent \fR +\fB \-> java\&.util\&.jar \fR +\fB \-> java\&.util\&.regex \fR +\fB \-> java\&.util\&.zip \fR +\fB \-> javax\&.security\&.auth \fR +\fB \-> sun\&.security\&.jca JDK internal API (rt\&.jar)\fR +\fB \-> sun\&.security\&.util JDK internal API (rt\&.jar)\fR +\fB javax\&.crypto\&.spec (jce\&.jar)\fR +\fB \-> java\&.lang \fR +\fB \-> java\&.security\&.spec \fR +\fB \-> java\&.util \fR +\fB/usr/java/jre/lib/rt\&.jar \-> /usr/java/jre/lib/jce\&.jar\fR +\fB java\&.security (rt\&.jar)\fR +\fB \-> javax\&.crypto\fR + .fi .if n \{\ .RE @@ -311,41 +336,43 @@ .RS 4 .\} .nf -$ jdeps \-dotoutput dot demo/jfc/Notepad/Notepad\&.jar +\fB$ jdeps \-dotoutput dot demo/jfc/Notepad/Notepad\&.jar\fR + .fi .if n \{\ .RE .\} .PP -\fIjdeps\fRは、\fI\-dotoutput\fRオプションで指定されたdotディレクトリに<\fIfilename\fR>\&.dotという名前のdotファイルを特定のJARファイルごとに作成し、JARファイル間の依存関係をリストするsummary\&.dotという名前のサマリー・ファイルも作成します +\fBjdeps\fRは、\fB\-dotoutput\fRオプションで指定されたdotディレクトリに<\fIfilename\fR>\&.dotという名前のdotファイルを特定のJARファイルごとに作成し、JARファイル間の依存関係をリストするsummary\&.dotという名前のサマリー・ファイルも作成します .sp .if n \{\ .RS 4 .\} .nf -$ cat dot/Notepad\&.jar\&.dot -digraph "Notepad\&.jar" { - // Path: demo/jfc/Notepad/Notepad\&.jar - "<unnamed>" \-> "java\&.awt"; - "<unnamed>" \-> "java\&.awt\&.event"; - "<unnamed>" \-> "java\&.beans"; - "<unnamed>" \-> "java\&.io"; - "<unnamed>" \-> "java\&.lang"; - "<unnamed>" \-> "java\&.net"; - "<unnamed>" \-> "java\&.util"; - "<unnamed>" \-> "java\&.util\&.logging"; - "<unnamed>" \-> "javax\&.swing"; - "<unnamed>" \-> "javax\&.swing\&.border"; - "<unnamed>" \-> "javax\&.swing\&.event"; - "<unnamed>" \-> "javax\&.swing\&.text"; - "<unnamed>" \-> "javax\&.swing\&.tree"; - "<unnamed>" \-> "javax\&.swing\&.undo"; -} +\fB$ cat dot/Notepad\&.jar\&.dot \fR +\fBdigraph "Notepad\&.jar" {\fR +\fB // Path: demo/jfc/Notepad/Notepad\&.jar\fR +\fB "<unnamed>" \-> "java\&.awt";\fR +\fB "<unnamed>" \-> "java\&.awt\&.event";\fR +\fB "<unnamed>" \-> "java\&.beans";\fR +\fB "<unnamed>" \-> "java\&.io";\fR +\fB "<unnamed>" \-> "java\&.lang";\fR +\fB "<unnamed>" \-> "java\&.net";\fR +\fB "<unnamed>" \-> "java\&.util";\fR +\fB "<unnamed>" \-> "java\&.util\&.logging";\fR +\fB "<unnamed>" \-> "javax\&.swing";\fR +\fB "<unnamed>" \-> "javax\&.swing\&.border";\fR +\fB "<unnamed>" \-> "javax\&.swing\&.event";\fR +\fB "<unnamed>" \-> "javax\&.swing\&.text";\fR +\fB "<unnamed>" \-> "javax\&.swing\&.tree";\fR +\fB "<unnamed>" \-> "javax\&.swing\&.undo";\fR +\fB}\fR +\fB \fR +\fB$ cat dot/summary\&.dot\fR +\fBdigraph "summary" {\fR +\fB "Notepad\&.jar" \-> "rt\&.jar";\fR +\fB}\fR -$ cat dot/summary\&.dot -digraph "summary" { - "Notepad\&.jar" \-> "rt\&.jar"; -} .fi .if n \{\ .RE
--- a/src/linux/doc/man/ja/jhat.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jhat.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jhat -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2006, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jhat +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jhat" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jhat \- Javaヒープを分析します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjhat\fR [ \fIoptions\fR ] \fIheap\-dump\-file\fR +\fBjhat\fR [ \fIoptions\fR ] \fIheap\-dump\-file\fR .fi .if n \{\ .RE @@ -64,16 +66,16 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIheap\-dump\-file\fR .RS 4 -ブラウズ対象となるJavaバイナリ・ヒープ・ダンプ・ファイル。複数のヒープ・ダンプを含むダンプ・ファイルの場合、\fImyfile\&.hprof#3\fRのようにファイル名の後に\fI#<number>\fRを付加することで、ファイル内の特定のダンプを指定できます。 +ブラウズ対象となるJavaバイナリ・ヒープ・ダンプ・ファイル。複数のヒープ・ダンプを含むダンプ・ファイルの場合、\fBmyfile\&.hprof#3\fRのようにファイル名の後に\fB#<number>\fRを付加することで、ファイル内の特定のダンプを指定できます。 .RE .SH "説明" .PP -\fIjhat\fRコマンドはJavaヒープ・ダンプ・ファイルを解析し、Webサーバーを開始します。\fIjhat\fRコマンドを使用して、お気に入りのブラウザでヒープ・ダンプを参照できます。\fIjhat\fRコマンドは、既知のクラス\fIMyClass\fRのすべてのインスタンスを表示するなどの事前設計済の問合せやObject Query Language (OQL)をサポートします。ヒープ・ダンプの問合せを除き、OQLはSQLに似ています。OQLのヘルプには、\fIjhat\fRコマンドによって表示されるOQLヘルプ・ページからアクセスできます。デフォルト・ポートを使用する場合、OQLのヘルプはhttp://localhost:7000/oqlhelp/で利用可能です。 +\fBjhat\fRコマンドはJavaヒープ・ダンプ・ファイルを解析し、Webサーバーを開始します。\fBjhat\fRコマンドを使用して、お気に入りのブラウザでヒープ・ダンプを参照できます。\fBjhat\fRコマンドは、既知のクラス\fBMyClass\fRのすべてのインスタンスを表示するなどの事前設計済の問合せやObject Query Language (OQL)をサポートします。ヒープ・ダンプの問合せを除き、OQLはSQLに似ています。OQLのヘルプには、\fBjhat\fRコマンドによって表示されるOQLヘルプ・ページからアクセスできます。デフォルト・ポートを使用する場合、OQLのヘルプはhttp://localhost:7000/oqlhelp/で利用可能です。 .PP Javaのヒープ・ダンプを生成するには、次のいくつかの方法があります。 .sp @@ -85,7 +87,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIjmap \-dump\fRオプションを使用して実行時にヒープ・ダンプを取得します。jmap(1)を参照してください。 +\fBjmap \-dump\fRオプションを使用して実行時にヒープ・ダンプを取得します。jmap(1)を参照してください。 .RE .sp .RS 4 @@ -96,7 +98,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIjconsole\fRオプションを使用して\fIHotSpotDiagnosticMXBean\fR経由で実行時にヒープ・ダンプを取得します。jconsole(1)および\fIHotSpotDiagnosticMXBean\fRのインタフェースの説明( +\fBjconsole\fRオプションを使用して\fBHotSpotDiagnosticMXBean\fR経由で実行時にヒープ・ダンプを取得します。jconsole(1)および\fBHotSpotDiagnosticMXBean\fRのインタフェースの説明( http://docs\&.oracle\&.com/javase/8/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean\&.html)を参照してください。 .RE .sp @@ -108,8 +110,8 @@ .sp -1 .IP \(bu 2.3 .\} -ヒープ・ダンプは、\fI\-XX:+HeapDumpOnOutOfMemoryError\fR -Java仮想マシン(JVM)オプションを指定することで、\fIOutOfMemoryError\fRがスローされたときに生成されます。 +ヒープ・ダンプは、\fB\-XX:+HeapDumpOnOutOfMemoryError\fR +Java Virtual Machine (JVM)オプションを指定することで、\fBOutOfMemoryError\fRがスローされたときに生成されます。 .RE .sp .RS 4 @@ -120,29 +122,29 @@ .sp -1 .IP \(bu 2.3 .\} -\fIhprof\fRコマンドを使用します。HPROF: Heap/CPUプロファイリング・ツール +\fBhprof\fRコマンドを使用します。HPROF: Heap/CPUプロファイリング・ツール (http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/hprof\&.html)を参照してください .RE .SH "オプション" .PP \-stack false|true .RS 4 -オブジェクト割当呼出しスタックの追跡を無効にします。ヒープ・ダンプ内で割当サイト情報が使用できない場合、このフラグを\fIfalse\fRに設定する必要があります。デフォルトは\fItrue\fRです。 +オブジェクト割当呼出しスタックの追跡を無効にします。ヒープ・ダンプ内で割当サイト情報が使用できない場合、このフラグを\fBfalse\fRに設定する必要があります。デフォルトは\fBtrue\fRです。 .RE .PP \-refs false|true .RS 4 -オブジェクトへの参照の追跡を無効にします。デフォルトは\fItrue\fRです。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ(指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる)が計算されます。 +オブジェクトへの参照の追跡を無効にします。デフォルトは\fBtrue\fRです。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ(指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる)が計算されます。 .RE .PP \-port \fIport\-number\fR .RS 4 -\fIjhat\fRのHTTPサーバーのポートを設定します。デフォルトは7000です。 +\fBjhat\fRのHTTPサーバーのポートを設定します。デフォルトは7000です。 .RE .PP \-exclude \fIexclude\-file\fR .RS 4 -到達可能なオブジェクトの問合せから除外する必要があるデータ・メンバーの一覧を含むファイルを指定します。たとえば、このファイルに\fIjava\&.lang\&.String\&.value\fRが含まれていた場合、特定のオブジェクト\fIo\fRから到達可能なオブジェクトのリストを計算する際に、\fIjava\&.lang\&.String\&.value\fRフィールドに関連する参照パスが考慮されなくなります。 +到達可能なオブジェクトの問合せから除外する必要があるデータ・メンバーの一覧を含むファイルを指定します。たとえば、このファイルに\fBjava\&.lang\&.String\&.value\fRが含まれていた場合、特定のオブジェクト\fBo\fRから到達可能なオブジェクトのリストを計算する際に、\fBjava\&.lang\&.String\&.value\fRフィールドに関連する参照パスが考慮されなくなります。 .RE .PP \-baseline \fIexclude\-file\fR @@ -172,7 +174,7 @@ .PP \-J\fIflag\fR .RS 4 -\fIjhat\fRコマンドを実行しているJava仮想マシンに\fIflag\fRを渡します。たとえば、512Mバイトの最大ヒープ・サイズを使用するには、\fI\-J\-Xmx512m\fRとします。 +\fBjhat\fRコマンドを実行しているJava Virtual Machineに\fBflag\fRを渡します。たとえば、512Mバイトの最大ヒープ・サイズを使用するには、\fB\-J\-Xmx512m\fRとします。 .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/jinfo.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jinfo.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jinfo -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jinfo +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jinfo" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jinfo \- 構成情報を生成します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjinfo\fR [ \fIoption\fR ] \fIpid\fR +\fBjinfo\fR [ \fIoption\fR ] \fIpid\fR .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjinfo\fR [ \fIoption \fR] \fIexecutable core\fR +\fBjinfo\fR [ \fIoption \fR] \fIexecutable core\fR .fi .if n \{\ .RE @@ -76,7 +78,7 @@ .RS 4 .\} .nf -\fIjinfo\fR [ \fIoption \fR] \fI[ servier\-id ] remote\-hostname\-or\-IP\fR +\fBjinfo\fR [ \fIoption \fR] \fI[ servier\-id ] remote\-hostname\-or\-IP\fR .fi .if n \{\ .RE @@ -84,7 +86,7 @@ .PP \fIオプション\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIpid\fR @@ -104,7 +106,7 @@ .PP \fIremote\-hostname\-or\-IP\fR .RS 4 -リモート・デバッグ・サーバーの\fIホスト名\fRまたは\fIIP\fRアドレス。jsadebugd(1)を参照してください。 +リモート・デバッグ・サーバーの\fBホスト名\fRまたは\fBIP\fRアドレス。jsadebugd(1)を参照してください。 .RE .PP \fIserver\-id\fR @@ -113,35 +115,35 @@ .RE .SH "説明" .PP -\fIjinfo\fRコマンドは、指定されたJavaプロセスやコア・ファイルまたはリモート・デバッグ・サーバーのJava構成情報を出力します。構成情報には、Javaシステム・プロパティとJava仮想マシン(JVM)のコマンドライン・フラグが含まれています。指定されたプロセスが64ビットJVM上で実行されている場合、\fI\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fIjinfo\fR -\fI\-J\-d64 \-sysprops pid\fR。 +\fBjinfo\fRコマンドは、指定されたJavaプロセスやコア・ファイルまたはリモート・デバッグ・サーバーのJava構成情報を出力します。構成情報には、Javaシステム・プロパティとJava Virtual Machine (JVM)のコマンド行フラグが含まれています。指定されたプロセスが64ビットJVM上で実行されている場合、\fB\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fBjinfo\fR +\fB\-J\-d64 \-sysprops pid\fR。 .PP -このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。たとえば、\fIset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fRです。 +このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fBdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fBPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。たとえば、\fBset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fRです。 .SH "オプション" .PP no\-option .RS 4 -コマンドライン・フラグを、システム・プロパティ名と値のペアとともに出力します。 +コマンド行フラグを、システム・プロパティ名と値のペアとともに出力します。 .RE .PP \-flag \fIname\fR .RS 4 -指定されたコマンドライン・フラグの名前と値を出力します。 +指定されたコマンド行フラグの名前と値を出力します。 .RE .PP \-flag \fI[+|\-]name\fR .RS 4 -指定されたブール型のコマンドライン・フラグを有効または無効にします。 +指定されたブール型のコマンド行フラグを有効または無効にします。 .RE .PP \-flag \fIname=value\fR .RS 4 -指定されたコマンドライン・フラグを指定された値に設定します。 +指定されたコマンド行フラグを指定された値に設定します。 .RE .PP \-flags .RS 4 -JVMに渡されるコマンドライン・フラグを出力します。 +JVMに渡されるコマンド行フラグを出力します。 .RE .PP \-sysprops
--- a/src/linux/doc/man/ja/jjs.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jjs.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jjs -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jjs +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jjs" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jjs \- Nashornエンジンを呼び出します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjjs\fR [\fIoptions\fR] [\fIscript\-files\fR] [\-\- \fIarguments\fR] +\fB\fBjjs\fR\fR\fB [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIscript\-files\fR\fR\fB] [\-\- \fR\fB\fIarguments\fR\fR\fB]\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -空白文字で区切られた、\fIjjs\fRコマンドの1つ以上のオプション。詳細は、オプションを参照してください。 +空白文字で区切られた、\fBjjs\fRコマンドの1つ以上のオプション。詳細は、オプションを参照してください。 .RE .PP \fIscript\-files\fR @@ -74,53 +76,61 @@ .PP \fIarguments\fR .RS 4 -二重ハイフン・マーカー(\fI\-\-\fR)の後のすべての値が、引数としてスクリプトまたは対話型シェルに渡されます。これらの値には\fIarguments\fRプロパティを使用してアクセスできます(Example 3を参照してください)。 +二重ハイフン・マーカー(\fB\-\-\fR)の後のすべての値が、引数としてスクリプトまたは対話型シェルに渡されます。これらの値には\fBarguments\fRプロパティを使用してアクセスできます(Example 3を参照してください)。 .RE .SH "説明" .PP -\fIjjs\fRコマンドライン・ツールを使用してNashornエンジンを呼び出します。これを使用して、1つまたは複数のスクリプト・ファイルを解釈したり、対話型シェルを実行することができます。 +\fBjjs\fRコマンド行ツールを使用してNashornエンジンを呼び出します。これを使用して、1つまたは複数のスクリプト・ファイルを解釈したり、対話型シェルを実行することができます。 .SH "オプション" .PP -\fIjjs\fRコマンドのオプションはスクリプトがNashornによって解釈される条件を制御します。 +\fBjjs\fRコマンドのオプションはスクリプトがNashornによって解釈される条件を制御します。 .PP -\-ccs=\fIsize\fR, \-\-class\-cache\-size=\fIsize\fR +\-ccs=\fIsize\fR +.br +\-\-class\-cache\-size=\fIsize\fR .RS 4 -クラス・キャッシュ・サイズをバイト単位で設定します。キロバイト(KB)を示すために\fIk\fRまたは\fIK\fRの文字を追加し、メガバイト(MB)を示すために\fIm\fRまたは\fIM\fRの文字を追加し、ギガバイト(GB)を示すために\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、クラス・キャッシュ・サイズは50バイトに設定されます。次の例は、1024バイト(1 KB)に設定する方法を示します。 +クラス・キャッシュ・サイズをバイト単位で設定します。キロバイト(KB)を示すために\fBk\fRまたは\fBK\fRの文字を追加し、メガバイト(MB)を示すために\fBm\fRまたは\fBM\fRの文字を追加し、ギガバイト(GB)を示すために\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、クラス・キャッシュ・サイズは50バイトに設定されます。次の例は、1024バイト(1 KB)に設定する方法を示します。 .sp .if n \{\ .RS 4 .\} .nf -\-css=100 -\-css=1k +\fB\-css=100\fR +\fB\-css=1k\fR + .fi .if n \{\ .RE .\} .RE .PP -\-co, \-\-compile\-only +\-co +.br +\-\-compile\-only .RS 4 スクリプトを実行せずにコンパイルします。 .RE .PP -\-cp \fIpath\fR, \-\-classpath \fIpath\fR +\-cp \fIpath\fR +.br +\-\-classpath \fIpath\fR .RS 4 サポートするクラスへのパスを指定します。複数のパスを設定するには、このオプションを繰り返すか、または各パスをコロン(:)で区切ります。 .RE .PP \-D\fIname\fR=\fIvalue\fR .RS 4 -プロパティ名に値を割り当てることで、スクリプトに渡すシステム・プロパティを設定します。次の例で、対話型モードでNashornを呼び出して、\fImyValue\fRを\fImyKey\fRという名前のプロパティに割り当てる方法を示します。 +プロパティ名に値を割り当てることで、スクリプトに渡すシステム・プロパティを設定します。次の例で、対話型モードでNashornを呼び出して、\fBmyValue\fRを\fBmyKey\fRという名前のプロパティに割り当てる方法を示します。 .sp .if n \{\ .RS 4 .\} .nf ->> \fBjjs \-DmyKey=myValue\fR -jjs> \fBjava\&.lang\&.System\&.getProperty("myKey")\fR -myValue -jjs> +\fB>> \fR\fB\fBjjs \-DmyKey=myValue\fR\fR +\fBjjs> \fR\fB\fBjava\&.lang\&.System\&.getProperty("myKey")\fR\fR +\fBmyValue\fR +\fBjjs>\fR + .fi .if n \{\ .RE @@ -128,14 +138,16 @@ このオプションを繰り返し使用すると、複数のプロパティを設定できます。 .RE .PP -\-d=\fIpath\fR, \-\-dump\-debug\-dir=\fIpath\fR +\-d=\fIpath\fR +.br +\-\-dump\-debug\-dir=\fIpath\fR .RS 4 クラス・ファイルをダンプするディレクトリへのパスを指定します。 .RE .PP \-\-debug\-lines .RS 4 -クラス・ファイル内の行番号表を生成します。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-debug\-lines=false\fRを指定します。 +クラス・ファイル内の行番号表を生成します。デフォルトでは、このオプションは有効になっています。無効にするには\fB\-\-debug\-lines=false\fRを指定します。 .RE .PP \-\-debug\-locals @@ -143,14 +155,16 @@ クラス・ファイル内のローカル変数を生成します。 .RE .PP -\-doe, \-\-dump\-on\-error +\-doe +.br +\-\-dump\-on\-error .RS 4 エラーが発生したときに、フル・スタック・トレースを提供します。デフォルトでは、簡単なエラー・メッセージのみが出力されます。 .RE .PP \-\-early\-lvalue\-error .RS 4 -無効な左辺値式が早期エラーとして(つまり、コードが解析されるときに)報告されます。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-early\-lvalue\-error=false\fRを指定します。無効な場合、無効な左辺値式はコードが実行されるまで報告されません。 +無効な左辺値式が早期エラーとして(つまり、コードが解析されるときに)報告されます。デフォルトでは、このオプションは有効になっています。無効にするには\fB\-\-early\-lvalue\-error=false\fRを指定します。無効な場合、無効な左辺値式はコードが実行されるまで報告されません。 .RE .PP \-\-empty\-statements @@ -158,7 +172,9 @@ 空の文をJavaの抽象構文ツリーに保存します。 .RE .PP -\-fv, \-\-fullversion +\-fv +.br +\-\-fullversion .RS 4 完全なNashornバージョン文字列を出力します。 .RE @@ -178,28 +194,31 @@ スクリプトをJavaFXアプリケーションとして起動します。 .RE .PP -\-h, \-help +\-h +.br +\-help .RS 4 オプションのリストとその説明を出力します。 .RE .PP \-J\fIoption\fR .RS 4 -指定した\fIjava\fR起動オプションをJVMに渡します。次の例で、対話型モードでNashornを呼び出して、JVMによって使用される最大メモリーを4 GBに設定する方法を示します。 +指定した\fBjava\fR起動オプションをJVMに渡します。次の例で、対話型モードでNashornを呼び出して、JVMによって使用される最大メモリーを4 GBに設定する方法を示します。 .sp .if n \{\ .RS 4 .\} .nf ->> \fBjjs \-J\-Xmx4g\fR -jjs> \fBjava\&.lang\&.Runtime\&.getRuntime()\&.maxMemory()\fR -3817799680 -jjs> +\fB>> \fR\fB\fBjjs \-J\-Xmx4g\fR\fR +\fBjjs> \fR\fB\fBjava\&.lang\&.Runtime\&.getRuntime()\&.maxMemory()\fR\fR +\fB3817799680\fR +\fBjjs>\fR + .fi .if n \{\ .RE .\} -このオプションを繰り返し使用すると、複数の\fIjava\fRコマンド・オプションを渡すことができます。 +このオプションを繰り返し使用すると、複数の\fBjava\fRコマンド・オプションを渡すことができます。 .RE .PP \-\-lazy\-compilation @@ -209,7 +228,7 @@ .PP \-\-loader\-per\-compile .RS 4 -コンパイルごとに新しいクラス・ローダーを作成します。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-loader\-per\-compile=false\fRを指定します。 +コンパイルごとに新しいクラス・ローダーを作成します。デフォルトでは、このオプションは有効になっています。無効にするには\fB\-\-loader\-per\-compile=false\fRを指定します。 .RE .PP \-\-log=\fIsubsystem\fR:\fIlevel\fR @@ -220,7 +239,8 @@ .RS 4 .\} .nf -\-\-log=fields:finest,codegen:info +\fB\-\-log=fields:finest,codegen:info\fR + .fi .if n \{\ .RE @@ -259,7 +279,7 @@ .PP \-\-print\-no\-newline .RS 4 -その他の\fI\-\-print*\fRオプションで強制的に1行で出力します。 +その他の\fB\-\-print*\fRオプションで強制的に1行で出力します。 .RE .PP \-\-print\-parse @@ -272,7 +292,9 @@ 記号表を出力します。 .RE .PP -\-pcs, \-\-profile\-callsites +\-pcs +.br +\-\-profile\-callsites .RS 4 呼び出しサイトのプロファイル・データをダンプします。 .RE @@ -284,12 +306,12 @@ .PP \-\-stderr=\fIfilename\fR|\fIstream\fR|\fItty\fR .RS 4 -標準エラー・ストリームを指定したファイル、ストリーム(たとえば\fIstdout\fR)に、またはテキスト端末にリダイレクトします。 +標準エラー・ストリームを指定したファイル、ストリーム(たとえば\fBstdout\fR)に、またはテキスト端末にリダイレクトします。 .RE .PP \-\-stdout=\fIfilename\fR|\fIstream\fR|\fItty\fR .RS 4 -標準出力ストリームを指定したファイル、ストリーム(たとえば\fIstderr\fR)に、またはテキスト端末にリダイレクトします。 +標準出力ストリームを指定したファイル、ストリーム(たとえば\fBstderr\fR)に、またはテキスト端末にリダイレクトします。 .RE .PP \-strict @@ -297,12 +319,16 @@ 標準(ECMAScript Edition 5\&.1)への準拠を強化するstrictモードを有効にし、これにより共通のコーディング・エラーを簡単に検出できるようになります。 .RE .PP -\-t=\fIzone\fR, \-timezone=\fIzone\fR +\-t=\fIzone\fR +.br +\-timezone=\fIzone\fR .RS 4 -スクリプトの実行に対し指定したタイムゾーンを設定します。OSで設定されたタイムゾーンをオーバーライドし、\fIDate\fRオブジェクトで使用されます。 +スクリプトの実行に対し指定したタイム・ゾーンを設定します。OSで設定されたタイム・ゾーンをオーバーライドし、\fBDate\fRオブジェクトで使用されます。 .RE .PP -\-tcs=\fIparameter\fR, \-\-trace\-callsites=\fIparameter\fR +\-tcs=\fIparameter\fR +.br +\-\-trace\-callsites=\fIparameter\fR .RS 4 呼出しサイトのトレースのモードを有効にします。使用可能なパラメータは、次のとおりです。 .PP @@ -327,60 +353,71 @@ バイトコードを実行する前に検証します。 .RE .PP -\-v, \-version +\-v +.br +\-version .RS 4 Nashornバージョン文字列を出力します。 .RE .PP \-xhelp .RS 4 -コマンドライン・オプションの拡張ヘルプを出力します。 +コマンド行オプションの拡張ヘルプを出力します。 .RE .SH "例" .PP -\fBExample 1\fR, Nashornを使用したスクリプトの実行 +\fB例 1\fR +.br +Nashornを使用したスクリプトの実行 .RS 4 .sp .if n \{\ .RS 4 .\} .nf -jjs script\&.js +\fBjjs script\&.js\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 2\fR, 対話型モードでのNashornの実行 +\fB例 2\fR +.br +対話型モードでのNashornの実行 .RS 4 .sp .if n \{\ .RS 4 .\} .nf ->> \fBjjs\fR -jjs> \fBprintln("Hello, World!")\fR -Hello, World! -jjs> \fBquit()\fR ->> +\fB>> \fR\fB\fBjjs\fR\fR +\fBjjs> \fR\fB\fBprintln("Hello, World!")\fR\fR +\fBHello, World!\fR +\fBjjs> \fR\fB\fBquit()\fR\fR +\fB>>\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, Nashornへの引数の渡し +\fB例 3\fR +.br +Nashornへの引数の渡し .RS 4 .sp .if n \{\ .RS 4 .\} .nf ->> \fBjjs \-\- a b c\fR -jjs> \fBarguments\&.join(", ")\fR -a, b, c -jjs> +\fB>> \fR\fB\fBjjs \-\- a b c\fR\fR +\fBjjs> \fR\fB\fBarguments\&.join(", ")\fR\fR +\fBa, b, c\fR +\fBjjs>\fR + .fi .if n \{\ .RE @@ -388,7 +425,7 @@ .RE .SH "関連項目" .PP -\fIjrunscript\fR +\fBjrunscript\fR .br 'pl 8.5i 'bp
--- a/src/linux/doc/man/ja/jmap.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jmap.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jmap -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jmap +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jmap" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jmap \- プロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjmap\fR [ \fIoptions\fR ] \fIpid\fR +\fBjmap\fR [ \fIoptions\fR ] \fIpid\fR .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjmap\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR +\fBjmap\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR .fi .if n \{\ .RE @@ -76,7 +78,7 @@ .RS 4 .\} .nf -\fIjmap\fR [ \fIoptions\fR ] [ \fIpid\fR ] \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR +\fBjmap\fR [ \fIoptions\fR ] [ \fIpid\fR ] \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR .fi .if n \{\ .RE @@ -84,7 +86,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIpid\fR @@ -104,7 +106,7 @@ .PP \fIremote\-hostname\-or\-IP\fR .RS 4 -リモート・デバッグ・サーバーの\fIホスト名\fRまたは\fIIP\fRアドレス。jsadebugd(1)を参照してください。 +リモート・デバッグ・サーバーの\fBホスト名\fRまたは\fBIP\fRアドレス。jsadebugd(1)を参照してください。 .RE .PP \fIserver\-id\fR @@ -113,22 +115,22 @@ .RE .SH "説明" .PP -\fIjmap\fRコマンドは、指定されたプロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。指定されたプロセスが64ビットJava仮想マシン(JVM)上で実行されている場合、\fI\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fIjmap\fR -\fI\-J\-d64 \-heap pid\fR。 +\fBjmap\fRコマンドは、指定されたプロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。指定されたプロセスが64ビットJava Virtual Machine (JVM)上で実行されている場合、\fB\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fBjmap\fR +\fB\-J\-d64 \-heap pid\fR。 .PP \fB注意:\fR -このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用される\fIjvm\&.dll\fRの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。\fIset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR。 +このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fBdbgeng\&.dll\fRファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fBPATH\fR環境変数には、ターゲット・プロセスによって使用される\fBjvm\&.dll\fRの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。\fBset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR。 .SH "オプション" .PP -<オプションなし> +<no option> .RS 4 -オプションを使用しない場合、\fIjmap\fRコマンドは共用オブジェクト・マッピングを出力します。ターゲットJVMにロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズおよび共用オブジェクト・ファイルのフルパスが出力されます。この動作は、Oracle Solaris -\fIpmap\fRユーティリティと類似しています。 +オプションを使用しない場合、\fBjmap\fRコマンドは共用オブジェクト・マッピングを出力します。ターゲットJVMにロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズおよび共用オブジェクト・ファイルのフルパスが出力されます。この動作は、Oracle Solaris +\fBpmap\fRユーティリティと類似しています。 .RE .PP \-dump:[live,] format=b, file=\fIfilename\fR .RS 4 -Javaヒープを\fIhprof\fRバイナリ形式で\fIfilename\fRにダンプします。\fIlive\fRサブオプションはオプションですが、指定した場合、ヒープ内のアクティブなオブジェクトのみがダンプされます。ヒープ・ダンプを参照するには、jhat(1)コマンドを使用して生成されたファイルを読み取ります。 +Javaヒープを\fBhprof\fRバイナリ形式で\fBfilename\fRにダンプします。\fBlive\fRサブオプションはオプションですが、指定した場合、ヒープ内のアクティブなオブジェクトのみがダンプされます。ヒープ・ダンプを参照するには、jhat(1)コマンドを使用して生成されたファイルを読み取ります。 .RE .PP \-finalizerinfo @@ -143,7 +145,7 @@ .PP \-histo[:live] .RS 4 -ヒープのヒストグラムを出力します。Javaクラスごとに、オブジェクトの数、バイト単位でのメモリー・サイズ、および完全修飾クラス名が出力されます。JVMの内部クラス名はアスタリスク(*)の接頭辞を付けて出力されます。\fIlive\fRサブオプションが指定された場合、アクティブなオブジェクトのみがカウントされます。 +ヒープのヒストグラムを出力します。Javaクラスごとに、オブジェクトの数、バイト単位でのメモリー・サイズ、および完全修飾クラス名が出力されます。JVMの内部クラス名はアスタリスク(*)の接頭辞を付けて出力されます。\fBlive\fRサブオプションが指定された場合、アクティブなオブジェクトのみがカウントされます。 .RE .PP \-clstats @@ -153,7 +155,7 @@ .PP \-F .RS 4 -強制します。PIDが応答しないときに、このオプションを\fIjmap \-dump\fRまたは\fIjmap \-histo\fRオプションとともに使用します。このモードでは、\fIlive\fRサブオプションはサポートされません。 +強制します。PIDが応答しないときに、このオプションを\fBjmap \-dump\fRまたは\fBjmap \-histo\fRオプションとともに使用します。このモードでは、\fBlive\fRサブオプションはサポートされません。 .RE .PP \-h @@ -168,7 +170,7 @@ .PP \-J\fIflag\fR .RS 4 -\fIjmap\fRコマンドを実行しているJava仮想マシンに\fIflag\fRを渡します。 +\fBjmap\fRコマンドを実行しているJava Virtual Machineに\fBflag\fRを渡します。 .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/jps.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jps.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jps -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: モニタリング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jps +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: モニタリング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jps" "1" "2013年11月21日" "JDK 8" "モニタリング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jps \- ターゲット・システム上で計測されたJava仮想マシン(JVM)を一覧表示します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjps\fR [ \fIoptions\fR ] [ \fIhostid\fR ] +\fBjps\fR [ \fIoptions\fR ] [ \fIhostid\fR ] .fi .if n \{\ .RE @@ -64,41 +66,41 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIhostid\fR .RS 4 -プロセス・レポートを生成するホストの識別子。\fIhostid\fRには、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプション・コンポーネントを含めることができます。ホスト識別子を参照してください。 +プロセス・レポートを生成するホストの識別子。\fBhostid\fRには、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプション・コンポーネントを含めることができます。ホスト識別子を参照してください。 .RE .SH "説明" .PP -\fIjps\fRコマンドは、ターゲット・システム上で計測されたJava HotSpot VMを一覧表示します。このコマンドで表示できるレポート情報は、アクセス権を持ったJVMに関するものに限定されます。 +\fBjps\fRコマンドは、ターゲット・システム上で計測されたJava HotSpot VMを一覧表示します。このコマンドで表示できるレポート情報は、アクセス権を持ったJVMに関するものに限定されます。 .PP -\fIhostid\fRを指定せずに\fIjps\fRコマンドを実行した場合、ローカル・ホストで計測されたJVMが検索されます。\fIhostid\fRを指定して起動した場合、指定されたプロトコルとポートを使用して、指定されたホスト上のJVMを検索します。\fIjstatd\fRプロセスがターゲット・ホスト上で実行されていると想定されます。 +\fBhostid\fRを指定せずに\fBjps\fRコマンドを実行した場合、ローカル・ホストで計測されたJVMが検索されます。\fBhostid\fRを指定して起動した場合、指定されたプロトコルとポートを使用して、指定されたホスト上のJVMを検索します。\fBjstatd\fRプロセスがターゲット・ホスト上で実行されていると想定されます。 .PP -\fIjps\fRコマンドは、ターゲット・システムで計測された各JVMについて、ローカルVM識別子、つまり\fIlvmid\fRをレポートします。\fIlvmid\fRは、一般的にはJVMプロセスに対するオペレーティング・システムのプロセス識別子ですが、必ずしもそうであるとは限りません。オプションを指定しない場合、\fIjps\fRによって、各Javaアプリケーションの\fIlvmid\fRが一覧表示され、それぞれにアプリケーションのクラス名またはJARファイル名が簡単な形式で示されます。この簡単な形式のクラス名とJARファイル名では、クラスのパッケージ情報またはJARファイル・パス情報が省略されています。 +\fBjps\fRコマンドは、ターゲット・システムで計測された各JVMについて、ローカルVM識別子、つまり\fBlvmid\fRをレポートします。\fBlvmid\fRは、一般的にはJVMプロセスに対するオペレーティング・システムのプロセス識別子ですが、必ずしもそうであるとは限りません。オプションを指定しない場合、\fBjps\fRによって、各Javaアプリケーションの\fBlvmid\fRが一覧表示され、それぞれにアプリケーションのクラス名またはJARファイル名が簡単な形式で示されます。この簡単な形式のクラス名とJARファイル名では、クラスのパッケージ情報またはJARファイル・パス情報が省略されています。 .PP -\fIjps\fRコマンドは、Java起動ツールを使用してmainメソッドに渡されるクラス名と引数を検索します。独自の起動ツールを使用してターゲットJVMを起動した場合は、\fImain\fRメソッドに渡されるクラス名またはJARファイル名と引数は利用できません。この場合、\fIjps\fRコマンドは、\fImain\fRメソッドに渡されるクラス名またはJARファイル名と引数に対して、文字列\fIUnknown\fRを出力します。 +\fBjps\fRコマンドは、Java起動ツールを使用してmainメソッドに渡されるクラス名と引数を検索します。独自の起動ツールを使用してターゲットJVMを起動した場合は、\fBmain\fRメソッドに渡されるクラス名またはJARファイル名と引数は利用できません。この場合、\fBjps\fRコマンドは、\fBmain\fRメソッドに渡されるクラス名またはJARファイル名と引数に対して、文字列\fBUnknown\fRを出力します。 .PP -\fIjps\fRコマンドで生成されるJVMのリストは、このコマンドを実行するプリンシパルに与えられたアクセス権に基づき、制限される場合があります。このコマンドは、オペレーティング・システム独自のアクセス制御機構による決定に基づいて、プリンシパルにアクセス権が与えられているJVMのみを一覧表示します。 +\fBjps\fRコマンドで生成されるJVMのリストは、このコマンドを実行するプリンシパルに与えられたアクセス権に基づき、制限される場合があります。このコマンドは、オペレーティング・システム独自のアクセス制御機構による決定に基づいて、プリンシパルにアクセス権が与えられているJVMのみを一覧表示します。 .SH "オプション" .PP -\fIjps\fRコマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。 +\fBjps\fRコマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。 .PP \-q .RS 4 -クラス名、JARファイル名、および\fImain\fRメソッドに渡された引数の出力を抑制し、ローカルVM識別子の一覧のみを生成します。 +クラス名、JARファイル名、および\fBmain\fRメソッドに渡された引数の出力を抑制し、ローカルVM識別子の一覧のみを生成します。 .RE .PP \-m .RS 4 -\fImain\fRメソッドに渡される引数を出力します。この出力は、組み込まれているJVMに対して\fInull\fRになることもあります。 +\fBmain\fRメソッドに渡される引数を出力します。この出力は、組み込まれているJVMに対して\fBnull\fRになることもあります。 .RE .PP \-l .RS 4 -アプリケーションの\fImain\fRクラスのフル・パッケージ名、またはアプリケーションのJARファイルへのフルパス名を出力します。 +アプリケーションの\fBmain\fRクラスのフル・パッケージ名、またはアプリケーションのJARファイルへのフルパス名を出力します。 .RE .PP \-v @@ -111,19 +113,20 @@ クラス名、JARファイル名、およびmaiメソッドに渡された引数の出力を抑制し、ローカルVM識別子の一覧のみを生成します。 .RE .PP -\-J\fIoption\fR +\-J\fBoption\fR .RS 4 -JVMに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fIオプション\fRを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +JVMに\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fBオプション\fRを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "ホスト識別子" .PP -ホスト識別子、つまり\fIhostid\fRは、ターゲット・システムを示す文字列です。\fIhostid\fR文字列の構文は、URIの構文に対応しています。 +ホスト識別子、つまり\fBhostid\fRは、ターゲット・システムを示す文字列です。\fBhostid\fR文字列の構文は、URIの構文に対応しています。 .sp .if n \{\ .RS 4 .\} .nf -[protocol:][[//]hostname][:port][/servername] +\fB[protocol:][[//]hostname][:port][/servername]\fR + .fi .if n \{\ .RE @@ -131,45 +134,46 @@ .PP \fIprotocol\fR .RS 4 -通信プロトコルです。\fIprotocol\fRが省略され、\fIhostname\fRが指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカル・プロトコルになります。プロトコルが省略され、ホスト名が指定されている場合は、デフォルト・プロトコルは\fIrmi\fRになります。 +通信プロトコルです。\fBprotocol\fRが省略され、\fBhostname\fRが指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカル・プロトコルになります。プロトコルが省略され、ホスト名が指定されている場合は、デフォルト・プロトコルは\fBrmi\fRになります。 .RE .PP hostname .RS 4 -ターゲット・ホストを示すホスト名またはIPアドレスです。\fIhostname\fRパラメータが省略されている場合は、ターゲット・ホストはローカル・ホストになります。 +ターゲット・ホストを示すホスト名またはIPアドレスです。\fBhostname\fRパラメータが省略されている場合は、ターゲット・ホストはローカル・ホストになります。 .RE .PP port .RS 4 -リモート・サーバーと通信するためのデフォルト・ポートです。\fIhostname\fRパラメータが省略されているか、\fIprotocol\fRパラメータが、最適化されたローカル・プロトコルを指定している場合、\fIport\fRパラメータは無視されます。それ以外の場合、\fIport\fRパラメータの扱いは、実装によって異なります。デフォルトの -\fIrmi\fRプロトコルの場合、\fIport\fRパラメータは、リモート・ホスト上のrmiregistryのポート番号を示します。\fIport\fRパラメータが省略されているか、\fIprotocol\fRパラメータが\fIrmi\fRを示している場合、デフォルトのrmiregistryポート(1099)が使用されます。 +リモート・サーバーと通信するためのデフォルト・ポートです。\fBhostname\fRパラメータが省略されているか、\fBprotocol\fRパラメータが、最適化されたローカル・プロトコルを指定している場合、\fBport\fRパラメータは無視されます。それ以外の場合、\fBport\fRパラメータの扱いは、実装によって異なります。デフォルトの +\fBrmi\fRプロトコルの場合、\fBport\fRパラメータは、リモート・ホスト上のrmiregistryのポート番号を示します。\fBport\fRパラメータが省略されているか、\fBprotocol\fRパラメータが\fBrmi\fRを示している場合、デフォルトのrmiregistryポート(1099)が使用されます。 .RE .PP servername .RS 4 -このパラメータの扱いは、実装によって異なります。最適化されたローカル・プロトコルの場合、このフィールドは無視されます。\fIrmi\fRプロトコルの場合、このパラメータは、リモート・ホスト上のRMIリモート・オブジェクトの名前を示す文字列になります。詳細は、\fIjstatd\fRコマンドの\fI\-n\fRオプションを参照してください。 +このパラメータの扱いは、実装によって異なります。最適化されたローカル・プロトコルの場合、このフィールドは無視されます。\fBrmi\fRプロトコルの場合、このパラメータは、リモート・ホスト上のRMIリモート・オブジェクトの名前を示す文字列になります。詳細は、\fBjstatd\fRコマンドの\fB\-n\fRオプションを参照してください。 .RE .SH "出力フォーマット" .PP -\fIjps\fRコマンドの出力は、次のパターンに従います。 +\fBjps\fRコマンドの出力は、次のパターンに従います。 .sp .if n \{\ .RS 4 .\} .nf -lvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ] +\fBlvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ]\fR + .fi .if n \{\ .RE .\} .PP -すべての出力トークンは空白文字で区切られます。\fIarg\fR値の中で空白を使用すると、実際の定位置パラメータに引数をマッピングしようとするときに、あいまいになります。 +すべての出力トークンは空白文字で区切られます。\fBarg\fR値の中で空白を使用すると、実際の定位置パラメータに引数をマッピングしようとするときに、あいまいになります。 .PP \fB注意:\fR -将来のリリースでこの形式は変更される可能性があるため、\fIjps\fRの出力を解析するスクリプトは作成しないことをお薦めします。\fIjps\fR出力を解析するスクリプトを作成すると、このツールの将来のリリースで、作成したスクリプトの変更が必要になる可能性があります。 +将来のリリースでこの形式は変更される可能性があるため、\fBjps\fRの出力を解析するスクリプトは作成しないことをお薦めします。\fBjps\fR出力を解析するスクリプトを作成すると、このツールの将来のリリースで、作成したスクリプトの変更が必要になる可能性があります。 .SH "例" .PP -この項では、\fIjps\fRコマンドの例を示します。 +この項では、\fBjps\fRコマンドの例を示します。 .PP ローカル・ホスト上で計測されたJVMを一覧表示する場合: .sp @@ -177,38 +181,41 @@ .RS 4 .\} .nf -jps -18027 Java2Demo\&.JAR -18032 jps -18005 jstat +\fBjps\fR +\fB18027 Java2Demo\&.JAR\fR +\fB18032 jps\fR +\fB18005 jstat\fR + .fi .if n \{\ .RE .\} .PP -次の例では、リモート・ホスト上で計測されたJVMを一覧表示します。この例では、\fIjstat\fRサーバーと、その内部RMIレジストリまたは別の外部rmiregistryプロセスのいずれかが、リモート・ホストのデフォルト・ポート(ポート1099)で実行されていると想定しています。また、ローカル・ホストが、リモート・ホストへの有効なアクセス権を持っていることも想定しています。この例には、\fI\-l\fRオプションも含まれ、クラス名またはJARファイル名を詳細な形式で出力します。 +次の例では、リモート・ホスト上で計測されたJVMを一覧表示します。この例では、\fBjstat\fRサーバーと、その内部RMIレジストリまたは別の外部rmiregistryプロセスのいずれかが、リモート・ホストのデフォルト・ポート(ポート1099)で実行されていると想定しています。また、ローカル・ホストが、リモート・ホストへの有効なアクセス権を持っていることも想定しています。この例には、\fB\-l\fRオプションも含まれ、クラス名またはJARファイル名を詳細な形式で出力します。 .sp .if n \{\ .RS 4 .\} .nf -jps \-l remote\&.domain -3002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR -2857 sun\&.tools\&.jstatd\&.jstatd +\fBjps \-l remote\&.domain\fR +\fB3002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR\fR +\fB2857 sun\&.tools\&.jstatd\&.jstatd\fR + .fi .if n \{\ .RE .\} .PP -次の例では、RMIレジストリにデフォルトではないポートを使用して、リモート・ホスト上で計測されたJVMを一覧表示します。この例では、内部RMIレジストリがポート2002にバインドされた\fIjstatd\fRサーバーが、リモート・ホスト上で実行されていると想定しています。また、\fI\-m\fRオプションを使用して、一覧表示されたそれぞれのJavaアプリケーションの\fImain\fRメソッドに渡される引数を組み込んでいます。 +次の例では、RMIレジストリにデフォルトではないポートを使用して、リモート・ホスト上で計測されたJVMを一覧表示します。この例では、内部RMIレジストリがポート2002にバインドされた\fBjstatd\fRサーバーが、リモート・ホスト上で実行されていると想定しています。また、\fB\-m\fRオプションを使用して、一覧表示されたそれぞれのJavaアプリケーションの\fBmain\fRメソッドに渡される引数を組み込んでいます。 .sp .if n \{\ .RS 4 .\} .nf -jps \-m remote\&.domain:2002 -3002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR -3102 sun\&.tools\&.jstatd\&.jstatd \-p 2002 +\fBjps \-m remote\&.domain:2002\fR +\fB3002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR\fR +\fB3102 sun\&.tools\&.jstatd\&.jstatd \-p 2002\fR + .fi .if n \{\ .RE
--- a/src/linux/doc/man/ja/jrunscript.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jrunscript.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jrunscript -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: スクリプティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2006, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jrunscript +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: スクリプティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jrunscript" "1" "2013年11月21日" "JDK 8" "スクリプティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jrunscript \- 対話型モードとバッチ・モードをサポートするコマンドライン・スクリプト・シェルを実行します。このコマンドは試験的なもので、サポートされていません。 +.SH "名前" +jrunscript \- 対話型モードとバッチ・モードをサポートするコマンド行スクリプト・シェルを実行します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjrunscript\fR [\fIoptions\fR] [\fIarguments\fR] +\fBjrunscript\fR [\fIoptions\fR] [\fIarguments\fR] .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIarguments\fR @@ -73,7 +75,7 @@ .RE .SH "説明" .PP -\fIjrunscript\fRコマンドは、言語に依存しないコマンドライン・スクリプト・シェルです。\fIjrunscript\fRは、対話型(read\-eval\-print)モードとバッチ(\fI\-f\fRオプション)・モードの両方のスクリプト実行をサポートします。デフォルトの使用言語はJavaScriptですが、\fI\-l\fRオプションを使用すれば他の言語も指定できます。\fIjrunscript\fRコマンドは、Javaとスクリプト言語との通信を使用して探求的なプログラミング・スタイルをサポートします。 +\fBjrunscript\fRコマンドは、言語に依存しないコマンド行スクリプト・シェルです。\fBjrunscript\fRは、対話型(read\-eval\-print)モードとバッチ(\fB\-f\fRオプション)・モードの両方のスクリプト実行をサポートします。デフォルトの使用言語はJavaScriptですが、\fB\-l\fRオプションを使用すれば他の言語も指定できます。\fBjrunscript\fRコマンドは、Javaとスクリプト言語との通信を使用して探求的なプログラミング・スタイルをサポートします。 .SH "オプション" .PP \-classpath \fIpath\fR @@ -83,8 +85,8 @@ .PP \-cp \fIpath\fR .RS 4 -\fI\-classpath\fR -\fIpath\fRと同じです。 +\fB\-classpath\fR +\fBpath\fRと同じです。 .RE .PP \-D\fIname\fR=\fIvalue\fR @@ -94,17 +96,17 @@ .PP \-J\fIflag\fR .RS 4 -\fIflag\fRを、\fIjrunscript\fRコマンドが実行されているJava仮想マシンに直接渡します。 +\fBflag\fRを、\fBjrunscript\fRコマンドが実行されているJava Virtual Machineに直接渡します。 .RE .PP \-I \fIlanguage\fR .RS 4 -指定されたスクリプト言語を使用します。デフォルトではJavaScriptが使用されます。他のスクリプト言語を使用するには、\fI\-cp\fRまたは\fI\-classpath\fRオプションを使用して、対応するスクリプト・エンジンのJARファイルを指定する必要があります。 +指定されたスクリプト言語を使用します。デフォルトではJavaScriptが使用されます。他のスクリプト言語を使用するには、\fB\-cp\fRまたは\fB\-classpath\fRオプションを使用して、対応するスクリプト・エンジンのJARファイルを指定する必要があります。 .RE .PP \-e \fIscript\fR .RS 4 -指定されたスクリプトを評価します。このオプションを使用すれば、コマンドラインにすべてが指定された1行スクリプトを実行できます。 +指定されたスクリプトを評価します。このオプションを使用すれば、コマンド行にすべてが指定された1行スクリプトを実行できます。 .RE .PP \-encoding \fIencoding\fR @@ -138,7 +140,7 @@ .RE .SH "引数" .PP -argumentsが存在していて、かつ\fI\-e\fR、\fI\-f\fRのいずれのオプションも使用されなかった場合、最初の引数がスクリプト・ファイルとなり、他の引数が存在する場合はスクリプトに渡されます。argumentsと、\fI\-e\fRまたは\fI\-f\fRオプションが使用されている場合、すべてのargumentsがスクリプトに渡されます。arguments、\fI\-e\fR、\fI\-f\fRがどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、\fIarguments\fRという名前の\fIString\fR配列型のエンジン変数を使用します。 +argumentsが存在していて、かつ\fB\-e\fR、\fB\-f\fRのいずれのオプションも使用されなかった場合、最初の引数がスクリプト・ファイルとなり、他の引数が存在する場合はスクリプトに渡されます。argumentsと、\fB\-e\fRまたは\fB\-f\fRオプションが使用されている場合、すべてのargumentsがスクリプトに渡されます。arguments、\fB\-e\fR、\fB\-f\fRがどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、\fBarguments\fRという名前の\fBString\fR配列型のエンジン変数を使用します。 .SH "例" .SS "インライン・スクリプトの実行" .sp @@ -146,8 +148,9 @@ .RS 4 .\} .nf -jrunscript \-e "print(\*(Aqhello world\*(Aq)" -jrunscript \-e "cat(\*(Aqhttp://www\&.example\&.com\*(Aq)" +\fBjrunscript \-e "print(\*(Aqhello world\*(Aq)"\fR +\fBjrunscript \-e "cat(\*(Aqhttp://www\&.example\&.com\*(Aq)"\fR + .fi .if n \{\ .RE @@ -158,7 +161,8 @@ .RS 4 .\} .nf -jrunscript \-l js \-f test\&.js +\fBjrunscript \-l js \-f test\&.js\fR + .fi .if n \{\ .RE @@ -169,38 +173,41 @@ .RS 4 .\} .nf -jrunscript -js> print(\*(AqHello World\en\*(Aq); -Hello World -js> 34 + 55 -89\&.0 -js> t = new java\&.lang\&.Thread(function() { print(\*(AqHello World\en\*(Aq); }) -Thread[Thread\-0,5,main] -js> t\&.start() -js> Hello World +\fBjrunscript\fR +\fBjs> print(\*(AqHello World\en\*(Aq);\fR +\fBHello World\fR +\fBjs> 34 + 55\fR +\fB89\&.0\fR +\fBjs> t = new java\&.lang\&.Thread(function() { print(\*(AqHello World\en\*(Aq); })\fR +\fBThread[Thread\-0,5,main]\fR +\fBjs> t\&.start()\fR +\fBjs> Hello World\fR +\fB \fR +\fBjs>\fR -js> .fi .if n \{\ .RE .\} .SS "スクリプト引数を指定したスクリプト・ファイルの実行" .PP -test\&.jsファイルはスクリプト・ファイルです。\fIarg1\fR、\fIarg2\fRおよび\fIarg3\fRの各引数がスクリプトに渡されます。スクリプトはarguments配列を使用してこれらの引数にアクセスできます。 +test\&.jsファイルはスクリプト・ファイルです。\fBarg1\fR、\fBarg2\fRおよび\fBarg3\fRの各引数がスクリプトに渡されます。スクリプトはarguments配列を使用してこれらの引数にアクセスできます。 .sp .if n \{\ .RS 4 .\} .nf -jrunscript test\&.js arg1 arg2 arg3 +\fBjrunscript test\&.js arg1 arg2 arg3\fR + .fi .if n \{\ .RE .\} .SH "関連項目" .PP -JavaScriptが使用される場合、ユーザー定義スクリプトを評価する前に、\fIjrunscript\fRコマンドはいくつかの組込み関数や組込みオブジェクトを初期化します。これらのJavaScriptの組込みについては、http://code\&.google\&.com/p/jsdoc\-toolkit/にある -JsDoc\-Toolkitを参照してください。 +JavaScriptを使用している場合、ユーザー定義スクリプトを評価する前に、\fBjrunscript\fRコマンドによって特定の組込み関数およびオブジェクトが初期化されます(これらについては、次のjrunscript JavaScript組込みのAPI仕様に記載されています)。 +.PP +http://docs\&.oracle\&.com/javase/7/docs/technotes/tools/share/jsdocs/overview\-summary\&.html .br 'pl 8.5i 'bp
--- a/src/linux/doc/man/ja/jsadebugd.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jsadebugd.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jsadebugd -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jsadebugd +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jsadebugd" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jsadebugd \- Javaプロセスまたはコア・ファイルに接続し、デバッグ・サーバーとして機能します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjsadebugd\fR \fIpid\fR [ \fIserver\-id\fR ] +\fBjsadebugd\fR \fIpid\fR [ \fIserver\-id\fR ] .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjsadebugd\fR \fIexecutable\fR \fIcore\fR [ \fIserver\-id\fR ] +\fBjsadebugd\fR \fIexecutable\fR \fIcore\fR [ \fIserver\-id\fR ] .fi .if n \{\ .RE @@ -93,23 +95,24 @@ .RE .SH "説明" .PP -\fIjsadebugd\fRコマンドは、Javaプロセスまたはコア・ファイルに接続し、デバッグ・サーバーとして機能します。\fIjstack\fR、\fIjmap\fRおよび\fIjinfo\fRなどのリモート・クライアントは、Java Remote Method Invocation (RMI)を使用しているサーバーに接続できます。\fIjsadebugd\fRコマンドを起動する前に、\fIrmiregistry\fRコマンドでRMIレジストリを次のように起動します。\fI$JAVA_HOME\fRはJDKのインストール・ディレクトリです。 +\fBjsadebugd\fRコマンドは、Javaプロセスまたはコア・ファイルに接続し、デバッグ・サーバーとして機能します。\fBjstack\fR、\fBjmap\fRおよび\fBjinfo\fRなどのリモート・クライアントは、Java Remote Method Invocation(RMI)を使用しているサーバーに接続できます。\fBjsadebugd\fRコマンドを起動する前に、\fBrmiregistry\fRコマンドでRMIレジストリを次のように起動します。\fI$JAVA_HOME\fRはJDKのインストール・ディレクトリです。 .sp .if n \{\ .RS 4 .\} .nf -rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi\&.jar +\fBrmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi\&.jar\fR + .fi .if n \{\ .RE .\} .PP -RMIレジストリが起動していない場合、\fIjsadebugd\fRコマンドはRMIレジストリを標準(1099)ポートで内部で起動します。デバッグ・サーバーは、\fISIGINT\fRを送信することにより停止できます。SIGINTを送信するには、\fB[Ctrl] + [C]\fRを押します。 +RMIレジストリが起動していない場合、\fBjsadebugd\fRコマンドはRMIレジストリを標準(1099)ポートで内部で起動します。デバッグ・サーバーは、\fBSIGINT\fRを送信することにより停止できます。SIGINTを送信するには、\fB[Ctrl] + [C]\fRを押します。 .PP \fB注意:\fR -このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。例: -\fIs\fR\fIet PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR +このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fBdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fBPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。例: +\fBs\fR\fBet PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR .SH "関連項目" .sp .RS 4
--- a/src/linux/doc/man/ja/jstack.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jstack.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jstack -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jstack +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jstack" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jstack \- Javaプロセス、コア・ファイルまたはリモート・デバッグ・サーバーに対するJavaスレッドのスタック・トレースを出力します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjstack\fR [ \fIoptions\fR ] \fIpid\fR +\fBjstack\fR [ \fIoptions\fR ] \fIpid\fR .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjstack\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR +\fBjstack\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR .fi .if n \{\ .RE @@ -76,7 +78,7 @@ .RS 4 .\} .nf -\fIjstack\fR [ \fIoptions\fR ] [ \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR +\fBjstack\fR [ \fIoptions\fR ] [ \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR .fi .if n \{\ .RE @@ -84,7 +86,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIpid\fR @@ -104,7 +106,7 @@ .PP \fIremote\-hostname\-or\-IP\fR .RS 4 -リモート・デバッグ・サーバーの\fIホスト名\fRまたは\fIIP\fRアドレス。jsadebugd(1)を参照してください。 +リモート・デバッグ・サーバーの\fBホスト名\fRまたは\fBIP\fRアドレス。jsadebugd(1)を参照してください。 .RE .PP \fIserver\-id\fR @@ -113,17 +115,18 @@ .RE .SH "説明" .PP -\fIjstack\fRコマンドは、指定されたJavaプロセス、コア・ファイルまたはリモート・デバッグ・サーバーに対するJavaスレッドのJavaスタック・トレースを出力します。Javaフレームごとに、フルクラス名、メソッド名、バイトコード・インデックス(bci)、および行番号(利用可能な場合)が出力されます。\fI\-m\fRオプションを使用すると、\fIjstack\fRコマンドは、すべてのスレッドのJavaフレームとネイティブ・フレームの両方を、プログラム・カウンタ(PC)とともに出力します。ネイティブ・フレームごとに、PCに最も近いネイティブ・シンボル(利用可能な場合)が出力されます。C++分解名は分解解除されません。C++名を分解解除するには、このコマンドの出力を\fIc++filt\fRにパイプします。指定されたプロセスが64ビットJava仮想マシン上で実行されている場合は、\fI\-J\-d64\fRオプションを指定する必要があります(例: -\fIjstack \-J\-d64 \-m pid\fR)。 +\fBjstack\fRコマンドは、指定されたJavaプロセス、コア・ファイルまたはリモート・デバッグ・サーバーに対するJavaスレッドのJavaスタック・トレースを出力します。Javaフレームごとに、フルクラス名、メソッド名、バイトコード・インデックス(bci)、および行番号(利用可能な場合)が出力されます。\fB\-m\fRオプションを使用すると、\fBjstack\fRコマンドは、すべてのスレッドのJavaフレームとネイティブ・フレームの両方を、プログラム・カウンタ(PC)とともに出力します。ネイティブ・フレームごとに、PCに最も近いネイティブ・シンボル(利用可能な場合)が出力されます。C++分解名は分解解除されません。C++名を分解解除するには、このコマンドの出力を\fBc++filt\fRにパイプします。指定されたプロセスが64ビットJava Virtual Machine上で実行されている場合は、\fB\-J\-d64\fRオプションを指定する必要があります(例: +\fBjstack \-J\-d64 \-m pid\fR)。 .PP \fB注意\fR -このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。dbgeng\&.dllファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。また、\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。 +このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。dbgeng\&.dllファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。また、\fBPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。 .sp .if n \{\ .RS 4 .\} .nf -set PATH=<jdk>\ejre\ebin\eclient;%PATH% +\fBset PATH=<jdk>\ejre\ebin\eclient;%PATH%\fR + .fi .if n \{\ .RE @@ -132,15 +135,15 @@ .PP \-F .RS 4 -\fIjstack\fR -[\fI\-l\fR] -\fIpid\fRが応答しない場合にスタック・ダンプを強制します。 +\fBjstack\fR +[\fB\-l\fR] +\fBpid\fRが応答しない場合にスタック・ダンプを強制します。 .RE .PP \-l .RS 4 -長形式のリスト。所有\fIjava\&.util\&.concurrent\fRの所有できるシンクロナイザの一覧など、ロックについての追加情報を印刷します。http://docs\&.oracle\&.com/javase/8/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer\&.htmlにある -\fIAbstractOwnableSynchronizer\fRクラス記述を参照してください +長形式のリスト。所有\fBjava\&.util\&.concurrent\fRの所有できるシンクロナイザの一覧など、ロックについての追加情報を印刷します。http://docs\&.oracle\&.com/javase/8/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer\&.htmlにある +\fBAbstractOwnableSynchronizer\fRクラス記述を参照してください .RE .PP \-m @@ -157,9 +160,9 @@ .RS 4 ヘルプ・メッセージが出力されます。 .RE -.SH "既知の不具合" +.SH "既知のBUG" .PP -混合モードのスタック・トレースでは、\fI\-m\fRオプションはリモート・デバッグ・サーバーでは機能しません。 +混合モードのスタック・トレースでは、\fB\-m\fRオプションはリモート・デバッグ・サーバーでは機能しません。 .SH "関連項目" .sp .RS 4
--- a/src/linux/doc/man/ja/jstat.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jstat.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jstat -.\" Language: English -.\" Date: 2011年5月10日 -.\" SectDesc: モニタリング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jstat +.\" Language: Japanese +.\" Date: 2011年5月10日 +.\" SectDesc: モニタリング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jstat" "1" "2011年5月10日" "JDK 8" "モニタリング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jstat \- Java仮想マシン(JVM)の統計を監視します。このコマンドは試験的なもので、サポートされていません。 +.SH "名前" +jstat \- Java Virtual Machine (JVM)の統計をモニターします。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjstat\fR [ \fIgeneralOption\fR | \fIoutputOptions vmid\fR [ \fIinterval\fR[s|ms] [ \fIcount \fR] ] +\fBjstat\fR [ \fIgeneralOption\fR | \fIoutputOptions vmid\fR [ \fIinterval\fR[s|ms] [ \fIcount \fR] ] .fi .if n \{\ .RE @@ -64,12 +66,12 @@ .PP \fIgeneralOption\fR .RS 4 -単独で使用する一般的なコマンドライン・オプションです(\fI\-help\fRまたは\fI\-options\fR)。一般的なオプションを参照してください。 +単独で使用する一般的なコマンド行オプションです(\fB\-help\fRまたは\fB\-options\fR)。一般的なオプションを参照してください。 .RE .PP \fIoutputOptions\fR .RS 4 -単一の\fIstatOption\fRと\fI\-t\fR、\fI\-h\fRおよび\fI\-J\fRのいずれかのオプションで構成される1つ以上の出力オプション。出力オプションを参照してください。 +単一の\fBstatOption\fRと\fB\-t\fR、\fB\-h\fRおよび\fB\-J\fRのいずれかのオプションで構成される1つ以上の出力オプション。出力オプションを参照してください。 .RE .PP \fIvmid\fR @@ -80,35 +82,37 @@ .RS 4 .\} .nf -[protocol:][//]lvmid[@hostname[:port]/servername] +\fB[protocol:][//]lvmid[@hostname[:port]/servername]\fR + .fi .if n \{\ .RE .\} -\fIvmid\fR文字列の構文は、URIの構文に対応しています。\fIvmid\fR文字列は、ローカルJVMを表す単純な整数から、通信プロトコル、ポート番号、および他の実装固有の値を示す複雑な構造まで、様々に異なります。仮想マシン識別子を参照してください。 +\fBvmid\fR文字列の構文は、URIの構文に対応しています。\fBvmid\fR文字列は、ローカルJVMを表す単純な整数から、通信プロトコル、ポート番号、および他の実装固有の値を示す複雑な構造まで、様々に異なります。仮想マシン識別子を参照してください。 .RE .PP \fIinterval\fR [s|ms] .RS 4 -秒(s)またはミリ秒(ms)のうち指定した単位でのサンプリング間隔です。デフォルトの単位はミリ秒です。正の整数にする必要があります。指定した場合、\fIjstat\fRコマンドは各間隔で出力を生成します。 +秒(s)またはミリ秒(ms)のうち指定した単位でのサンプリング間隔です。デフォルトの単位はミリ秒です。正の整数にする必要があります。指定した場合、\fBjstat\fRコマンドは各間隔で出力を生成します。 .RE .PP \fIcount\fR .RS 4 -表示するサンプル数です。デフォルト値は無限で、ターゲットJVMが終了するまで、または\fIjstat\fRコマンドが終了するまで、\fIjstat\fRコマンドは統計データを表示します。この値は、正の整数である必要があります。 +表示するサンプル数です。デフォルト値は無限で、ターゲットJVMが終了するまで、または\fBjstat\fRコマンドが終了するまで、\fBjstat\fRコマンドは統計データを表示します。この値は、正の整数である必要があります。 .RE .SH "説明" .PP -\fIjstat\fRコマンドは、設置されているJava HotSpot VMのパフォーマンス統計データを表示します。ターゲットJVMは、仮想マシン識別子または\fIvmid\fRオプションによって識別されます。 +\fBjstat\fRコマンドは、設置されているJava HotSpot VMのパフォーマンス統計データを表示します。ターゲットJVMは、仮想マシン識別子または\fBvmid\fRオプションによって識別されます。 .SH "仮想マシン識別子" .PP -\fIvmid\fR文字列の構文は、URIの構文に対応しています。 +\fBvmid\fR文字列の構文は、URIの構文に対応しています。 .sp .if n \{\ .RS 4 .\} .nf -[protocol:][//]lvmid[@hostname[:port]/servername] +\fB[protocol:][//]lvmid[@hostname[:port]/servername]\fR + .fi .if n \{\ .RE @@ -116,12 +120,12 @@ .PP \fIprotocol\fR .RS 4 -通信プロトコルです。\fIprotocol\fR値が省略され、ホスト名が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカル・プロトコルになります。\fIprotocol\fR値が省略され、ホスト名が指定されている場合は、デフォルト・プロトコルは\fIrmi\fRになります。 +通信プロトコルです。\fIprotocol\fR値が省略され、ホスト名が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカル・プロトコルになります。\fIprotocol\fR値が省略され、ホスト名が指定されている場合は、デフォルト・プロトコルは\fBrmi\fRになります。 .RE .PP \fIlvmid\fR .RS 4 -ターゲットJVMのローカル仮想マシン識別子です。\fIlvmid\fRは、システム上のJVMを一意に識別するプラットフォーム固有の値です。\fIlvmid\fRは、仮想マシン識別子の唯一の必須要素です。\fIlvmid\fRは、一般的にはターゲットJVMプロセスに対するオペレーティング・システムのプロセス識別子ですが、必ずしもそうであるとは限りません。\fIjps\fRコマンドを使用して、\fIlvmid\fRを特定できます。また、UNIXプラットフォームでは\fIps\fRコマンドを使用して、WindowsではWindowsタスク・マネージャを使用して、\fIlvmid\fRを特定できます。 +ターゲットJVMのローカル仮想マシン識別子です。\fBlvmid\fRは、システム上のJVMを一意に識別するプラットフォーム固有の値です。\fBlvmid\fRは、仮想マシン識別子の唯一の必須要素です。\fBlvmid\fRは、一般的にはターゲットJVMプロセスに対するオペレーティング・システムのプロセス識別子ですが、必ずしもそうであるとは限りません。\fBjps\fRコマンドを使用して、\fBlvmid\fRを特定できます。また、Solaris、LinuxおよびOS Xプラットフォームでは\fBps\fRコマンドを使用して、WindowsではWindowsタスク・マネージャを使用して、\fBlvmid\fRを特定できます。 .RE .PP \fIhostname\fR @@ -131,16 +135,16 @@ .PP \fIport\fR .RS 4 -リモート・サーバーと通信するためのデフォルト・ポートです。\fIhostname\fR値が省略されているか、最適化されたローカル・プロトコルが\fIprotocol\fR値に指定されている場合、\fIport\fR値は無視されます。それ以外の場合、\fIport\fRパラメータの扱いは、実装によって異なります。デフォルトの\fIrmi\fRプロトコルの場合、ポート値は、リモート・ホスト上のrmiregistryのポート番号を示します。\fIport\fR値が省略され、\fIprotocol\fR値で\fIrmi\fRが指定されている場合、デフォルトのrmiregistryポート(1099)が使用されます。 +リモート・サーバーと通信するためのデフォルト・ポートです。\fIhostname\fR値が省略されているか、最適化されたローカル・プロトコルが\fIprotocol\fR値に指定されている場合、\fIport\fR値は無視されます。それ以外の場合、\fBport\fRパラメータの扱いは、実装によって異なります。デフォルトの\fBrmi\fRプロトコルの場合、ポート値は、リモート・ホスト上のrmiregistryのポート番号を示します。\fIport\fR値が省略され、\fIprotocol\fR値で\fBrmi\fRが指定されている場合、デフォルトのrmiregistryポート(1099)が使用されます。 .RE .PP \fIservername\fR .RS 4 -\fIservername\fRパラメータの扱いは、実装によって異なります。最適化されたローカル・プロトコルの場合、このフィールドは無視されます。\fIrmi\fRプロトコルの場合、これは、リモート・ホスト上のRMIリソース・オブジェクトの名前を表します。 +\fBservername\fRパラメータの扱いは、実装によって異なります。最適化されたローカル・プロトコルの場合、このフィールドは無視されます。\fBrmi\fRプロトコルの場合、これは、リモート・ホスト上のRMIリソース・オブジェクトの名前を表します。 .RE .SH "オプション" .PP -\fIjstat\fRコマンドは、一般的なオプションと出力オプションの2つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、\fIjstat\fRコマンドは簡単な使用率およびバージョン情報を表示します。出力オプションによって、統計データ出力の内容と形式が決まります。 +\fBjstat\fRコマンドは、一般的なオプションと出力オプションの2つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、\fBjstat\fRコマンドは簡単な使用率およびバージョン情報を表示します。出力オプションによって、統計データ出力の内容と形式が決まります。 .PP すべてのオプションとその機能は、将来のリリースで変更または廃止される可能性があります。 .SS "一般的なオプション" @@ -158,44 +162,44 @@ .RE .SS "出力オプション" .PP -一般的なオプションを指定しない場合に、出力オプションを指定できます。出力オプションは、\fIjstat\fRコマンドの出力の内容と形式を決定し、単一の\fIstatOption\fRといずれかの出力オプション(\fI\-h\fR、\fI\-t\fRおよび\fI\-J\fR)で構成されます。\fIstatOption\fRは最初に記述する必要があります。 +一般的なオプションを指定しない場合に、出力オプションを指定できます。出力オプションは、\fBjstat\fRコマンドの出力の内容と形式を決定し、単一の\fBstatOption\fRといずれかの出力オプション(\fB\-h\fR、\fB\-t\fRおよび\fB\-J\fR)で構成されます。\fBstatOption\fRは最初に記述する必要があります。 .PP -出力は、各列が空白で区切られた表の形式になります。タイトルを含むヘッダー行によって、各列の意味がわかります。ヘッダーの表示頻度を設定するには、\fI\-h\fRオプションを使用します。列のヘッダー名は、様々なオプション間で一貫性が保たれています。一般に、2つのオプションで同じ名前の列が使用されていれば、2つの列のデータ・ソースは同じです。 +出力は、各列が空白で区切られた表の形式になります。タイトルを含むヘッダー行によって、各列の意味がわかります。ヘッダーの表示頻度を設定するには、\fB\-h\fRオプションを使用します。列のヘッダー名は、様々なオプション間で一貫性が保たれています。一般に、2つのオプションで同じ名前の列が使用されていれば、2つの列のデータ・ソースは同じです。 .PP -\fI\-t\fRオプションを使用すると、Timestampというラベルの付いたタイムスタンプの列が、出力の最初の列として表示されます。Timestamp列には、ターゲットJVMの起動からの経過時間が、秒単位で表示されます。タイムスタンプの精度は、様々な要因によって異なり、大量の負荷のかかったシステムでのスレッド・スケジュールの遅延により変動します。 +\fB\-t\fRオプションを使用すると、Timestampというラベルの付いたタイムスタンプの列が、出力の最初の列として表示されます。Timestamp列には、ターゲットJVMの起動からの経過時間が、秒単位で表示されます。タイムスタンプの精度は、様々な要因によって異なり、大量の負荷のかかったシステムでのスレッド・スケジュールの遅延により変動します。 .PP -intervalおよびcountパラメータを使用して、\fIjstat\fRコマンドがその出力を表示する頻度と回数をそれぞれ指定します。 +intervalおよびcountパラメータを使用して、\fBjstat\fRコマンドがその出力を表示する頻度と回数をそれぞれ指定します。 .PP \fB注意:\fR -将来のリリースでこの形式は変更される可能性があるため、\fIjstat\fRコマンドの出力を解析するスクリプトは作成しなでください。\fIjstat\fRコマンドの出力を解析するスクリプトを作成する場合は、このツールの将来のリリースで、そのスクリプトを変更する必要があることに留意してください。 +将来のリリースでこの形式は変更される可能性があるため、\fBjstat\fRコマンドの出力を解析するスクリプトは作成しなでください。\fBjstat\fRコマンドの出力を解析するスクリプトを作成する場合は、このツールの将来のリリースで、そのスクリプトを変更する必要があることに留意してください。 .PP \-\fIstatOption\fR .RS 4 -\fIjstat\fRコマンドが表示する統計データ情報を指定します。次に、利用可能なオプションの一覧を示します。特定のプラットフォーム・インストールのオプションを一覧表示するには、一般的なオプションの\fI\-options\fRを使用します。Statオプションおよび出力を参照してください。 +\fBjstat\fRコマンドが表示する統計データ情報を指定します。次に、利用可能なオプションの一覧を示します。特定のプラットフォーム・インストールのオプションを一覧表示するには、一般的なオプションの\fB\-options\fRを使用します。Statオプションおよび出力を参照してください。 .sp -\fIclass\fR: クラス・ローダーの動作に関する統計データを表示します。 +\fBclass\fR: クラス・ローダーの動作に関する統計データを表示します。 .sp -\fIcompiler\fR: Java HotSpot VM Just\-in\-Timeコンパイラの動作に関する統計データを表示します。 +\fBcompiler\fR: Java HotSpot VM Just\-in\-Timeコンパイラの動作に関する統計データを表示します。 .sp -\fIgc\fR: ガベージ・コレクトされたヒープの動作に関する統計データを表示します。 +\fBgc\fR: ガベージ・コレクトされたヒープの動作に関する統計データを表示します。 .sp -\fIgccapacity\fR: 世代ごとの容量と対応する領域に関する統計データを表示します。 +\fBgccapacity\fR: 世代ごとの容量と対応する領域に関する統計データを表示します。 .sp -\fIgccause\fR: ガベージ・コレクション統計データのサマリー(\fI\-gcutil\fRと同じ)と、直前および現在(適用可能な場合)のガベージ・コレクション・イベントの原因を表示します。 +\fBgccause\fR: ガベージ・コレクション統計データのサマリー(\fB\-gcutil\fRと同じ)と、直前および現在(適用可能な場合)のガベージ・コレクション・イベントの原因を表示します。 .sp -\fIgcnew\fR: New世代の動作に関する統計データを表示します。 +\fBgcnew\fR: New世代の動作に関する統計データを表示します。 .sp -\fIgcnewcapacity\fR: New世代のサイズと対応する領域に関する統計データを表示します。 +\fBgcnewcapacity\fR: New世代のサイズと対応する領域に関する統計データを表示します。 .sp -\fIgcold\fR: Old世代の動作とメタスペースに関する統計データを表示します。 +\fBgcold\fR: Old世代の動作とメタスペースに関する統計データを表示します。 .sp -\fIgcoldcapacity\fR: Old世代のサイズに関する統計データを表示します。 +\fBgcoldcapacity\fR: Old世代のサイズに関する統計データを表示します。 .sp -\fIgcmetacapacity\fR: メタスペースのサイズに関する統計データを表示します。 +\fBgcmetacapacity\fR: メタスペースのサイズに関する統計データを表示します。 .sp -\fIgcutil\fR: ガベージ・コレクションのサマリーに関する統計データを表示します。 +\fBgcutil\fR: ガベージ・コレクションのサマリーに関する統計データを表示します。 .sp -\fIprintcompilation\fR: Java HotSpot VMコンパイル・メソッドの統計データを表示します。 +\fBprintcompilation\fR: Java HotSpot VMコンパイル・メソッドの統計データを表示します。 .RE .PP \-h \fIn\fR @@ -210,150 +214,150 @@ .PP \-J\fIjavaOption\fR .RS 4 -\fIjavaOption\fRをJavaアプリケーション起動ツールに渡します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。オプションの完全なリストについては、java(1)を参照してください。 +\fBjavaOption\fRをJavaアプリケーション起動ツールに渡します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。オプションの完全なリストについては、java(1)を参照してください。 .RE .SS "Statオプションおよび出力" .PP -次の情報は、\fIjstat\fRコマンドが各\fIstatOption\fRについて出力する列をまとめたものです。 +次の情報は、\fBjstat\fRコマンドが各\fIstatOption\fRについて出力する列をまとめたものです。 .PP \-class \fIoption\fR .RS 4 クラス・ローダーの統計データ。 .sp -\fILoaded\fR: ロードされたクラスの数。 +\fBLoaded\fR: ロードされたクラスの数。 .sp -\fIBytes\fR: ロードされたKBの数。 +\fBBytes\fR: ロードされたKBの数。 .sp -\fIUnloaded\fR: アンロードされたクラスの数。 +\fBUnloaded\fR: アンロードされたクラスの数。 .sp -\fIBytes\fR: アンロードされたKBの数。 +\fBBytes\fR: アンロードされたKBの数。 .sp -\fITime\fR: クラスのロードやアンロード処理に要した時間。 +\fBTime\fR: クラスのロードやアンロード処理に要した時間。 .RE .PP \-compiler \fIoption\fR .RS 4 Java HotSpot VM Just\-in\-Timeコンパイラの統計データ。 .sp -\fICompiled\fR: 実行されたコンパイル・タスクの数。 +\fBCompiled\fR: 実行されたコンパイル・タスクの数。 .sp -\fIFailed\fR: 失敗したコンパイル・タスクの数。 +\fBFailed\fR: 失敗したコンパイル・タスクの数。 .sp -\fIInvalid\fR: 無効にされたコンパイル・タスクの数。 +\fBInvalid\fR: 無効にされたコンパイル・タスクの数。 .sp -\fITime\fR: コンパイル・タスクの実行に要した時間。 +\fBTime\fR: コンパイル・タスクの実行に要した時間。 .sp -\fIFailedType\fR: 最後に失敗したコンパイルのコンパイル・タイプ。 +\fBFailedType\fR: 最後に失敗したコンパイルのコンパイル・タイプ。 .sp -\fIFailedMethod\fR: 最後に失敗したコンパイルのクラス名とメソッド。 +\fBFailedMethod\fR: 最後に失敗したコンパイルのクラス名とメソッド。 .RE .PP \-gc \fIoption\fR .RS 4 ガベージ・コレクトされたヒープの統計データ。 .sp -\fIS0C\fR: Survivor領域0の現在の容量(KB)。 +\fBS0C\fR: Survivor領域0の現在の容量(KB)。 .sp -\fIS1C\fR: Survivor領域1の現在の容量(KB)。 +\fBS1C\fR: Survivor領域1の現在の容量(KB)。 .sp -\fIS0U\fR: Survivor領域0の使用率(KB)。 +\fBS0U\fR: Survivor領域0の使用率(KB)。 .sp -\fIS1U\fR: Survivor領域1の使用率(KB)。 +\fBS1U\fR: Survivor領域1の使用率(KB)。 .sp -\fIEC\fR: Eden領域の現在の容量(KB)。 +\fBEC\fR: Eden領域の現在の容量(KB)。 .sp -\fIEU\fR: Eden領域の使用率(KB)。 +\fBEU\fR: Eden領域の使用率(KB)。 .sp -\fIOC\fR: Old領域の現在の容量(KB)。 +\fBOC\fR: Old領域の現在の容量(KB)。 .sp -\fIOU\fR: Old領域の使用率(KB)。 +\fBOU\fR: Old領域の使用率(KB)。 .sp -\fIMC\fR: メタスペースの容量(KB)。 +\fBMC\fR: メタスペースの容量(KB)。 .sp -\fIMU\fR: メタスペースの使用率(KB)。 +\fBMU\fR: メタスペースの使用率(KB)。 .sp -\fIYGC\fR: 若い世代のガベージ・コレクション・イベントの数。 +\fBYGC\fR: 若い世代のガベージ・コレクション・イベントの数。 .sp -\fIYGCT\fR: 若い世代のガベージ・コレクション時間。 +\fBYGCT\fR: 若い世代のガベージ・コレクション時間。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .sp -\fIFGCT\fR: フルガベージ・コレクション時間。 +\fBFGCT\fR: フルガベージ・コレクション時間。 .sp -\fIGCT\fR: ガベージ・コレクション総時間。 +\fBGCT\fR: ガベージ・コレクション総時間。 .RE .PP \-gccapacity \fIoption\fR .RS 4 メモリー・プール世代および領域容量。 .sp -\fINGCMN\fR: New世代の最小容量(KB)。 +\fBNGCMN\fR: New世代の最小容量(KB)。 .sp -\fINGCMX\fR: New世代の最大容量(KB)。 +\fBNGCMX\fR: New世代の最大容量(KB)。 .sp -\fINGC\fR: New世代の現在の容量(KB)。 +\fBNGC\fR: New世代の現在の容量(KB)。 .sp -\fIS0C\fR: Survivor領域0の現在の容量(KB)。 +\fBS0C\fR: Survivor領域0の現在の容量(KB)。 .sp -\fIS1C\fR: Survivor領域1の現在の容量(KB)。 +\fBS1C\fR: Survivor領域1の現在の容量(KB)。 .sp -\fIEC\fR: Eden領域の現在の容量(KB)。 +\fBEC\fR: Eden領域の現在の容量(KB)。 .sp -\fIOGCMN\fR: Old世代の最小容量(KB)。 +\fBOGCMN\fR: Old世代の最小容量(KB)。 .sp -\fIOGCMX\fR: Old世代の最大容量(KB)。 +\fBOGCMX\fR: Old世代の最大容量(KB)。 .sp -\fIOGC\fR: Old世代の現在の容量(KB)。 +\fBOGC\fR: Old世代の現在の容量(KB)。 .sp -\fIOC\fR: Old領域の現在の容量(KB)。 +\fBOC\fR: Old領域の現在の容量(KB)。 .sp -\fIMCMN\fR: メタスペースの最小容量(KB)。 +\fBMCMN\fR: メタスペースの最小容量(KB)。 .sp -\fIMCMX\fR: メタスペースの最大容量(KB)。 +\fBMCMX\fR: メタスペースの最大容量(KB)。 .sp -\fIMC\fR: メタスペースの容量(KB)。 +\fBMC\fR: メタスペースの容量(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .RE .PP \-gccause \fIoption\fR .RS 4 -このオプションは、\fI\-gcutil\fRオプションと同じガベージ・コレクション統計データのサマリーを表示しますが、最後のガベージ・コレクション・イベントと(適用可能な場合は)現在のガベージ・コレクション・イベントの原因が含まれます。\fI\-gcutil\fRで一覧表示される列のほか、このオプションでは次の列が追加されます。 +このオプションは、\fB\-gcutil\fRオプションと同じガベージ・コレクション統計データのサマリーを表示しますが、最後のガベージ・コレクション・イベントと(適用可能な場合は)現在のガベージ・コレクション・イベントの原因が含まれます。\fB\-gcutil\fRで一覧表示される列のほか、このオプションでは次の列が追加されます。 .sp ガベージ・コレクション・イベントを含むガベージ・コレクション統計データ。 .sp -\fILGCC\fR: 最後のガベージ・コレクションの原因。 +\fBLGCC\fR: 最後のガベージ・コレクションの原因。 .sp -\fIGCC\fR: 現在のガベージ・コレクションの原因。 +\fBGCC\fR: 現在のガベージ・コレクションの原因。 .RE .PP \-gcnew \fIoption\fR .RS 4 New世代の統計データ。 .sp -\fIS0C\fR: Survivor領域0の現在の容量(KB)。 +\fBS0C\fR: Survivor領域0の現在の容量(KB)。 .sp -\fIS1C\fR: Survivor領域1の現在の容量(KB)。 +\fBS1C\fR: Survivor領域1の現在の容量(KB)。 .sp -\fIS0U\fR: Survivor領域0の使用率(KB)。 +\fBS0U\fR: Survivor領域0の使用率(KB)。 .sp -\fIS1U\fR: Survivor領域1の使用率(KB)。 +\fBS1U\fR: Survivor領域1の使用率(KB)。 .sp -\fITT\fR: 殿堂入りしきい値。 +\fBTT\fR: 殿堂入りしきい値。 .sp -\fIMTT\fR: 最大殿堂入りしきい値。 +\fBMTT\fR: 最大殿堂入りしきい値。 .sp -\fIDSS\fR: 適切なSurvivorサイズ(KB)。 +\fBDSS\fR: 適切なSurvivorサイズ(KB)。 .sp -\fIEC\fR: Eden領域の現在の容量(KB)。 +\fBEC\fR: Eden領域の現在の容量(KB)。 .sp -\fIEU\fR: Eden領域の使用率(KB)。 +\fBEU\fR: Eden領域の使用率(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIYGCT\fR: 若い世代のガベージ・コレクション時間。 +\fBYGCT\fR: 若い世代のガベージ・コレクション時間。 .RE .PP \-gcnewcapacity \fIoption\fR @@ -362,132 +366,132 @@ .sp NGCMN: New世代の最小容量(KB)。 .sp -\fINGCMX\fR: New世代の最大容量(KB)。 +\fBNGCMX\fR: New世代の最大容量(KB)。 .sp -\fINGC\fR: New世代の現在の容量(KB)。 +\fBNGC\fR: New世代の現在の容量(KB)。 .sp -\fIS0CMX\fR: Survivor領域0の最大容量(KB)。 +\fBS0CMX\fR: Survivor領域0の最大容量(KB)。 .sp -\fIS0C\fR: Survivor領域0の現在の容量(KB)。 +\fBS0C\fR: Survivor領域0の現在の容量(KB)。 .sp -\fIS1CMX\fR: Survivor領域1の最大容量(KB)。 +\fBS1CMX\fR: Survivor領域1の最大容量(KB)。 .sp -\fIS1C\fR: Survivor領域1の現在の容量(KB)。 +\fBS1C\fR: Survivor領域1の現在の容量(KB)。 .sp -\fIECMX\fR: Eden領域の最大容量(KB)。 +\fBECMX\fR: Eden領域の最大容量(KB)。 .sp -\fIEC\fR: Eden領域の現在の容量(KB)。 +\fBEC\fR: Eden領域の現在の容量(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .RE .PP \-gcold \fIoption\fR .RS 4 OldおよびPermanent世代の統計データ。 .sp -\fIMC\fR: メタスペースの容量(KB)。 +\fBMC\fR: メタスペースの容量(KB)。 .sp -\fIMU\fR: メタスペースの使用率(KB)。 +\fBMU\fR: メタスペースの使用率(KB)。 .sp -\fIOC\fR: Old領域の現在の容量(KB)。 +\fBOC\fR: Old領域の現在の容量(KB)。 .sp -\fIOU\fR: Old領域の使用率(KB)。 +\fBOU\fR: Old領域の使用率(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .sp -\fIFGCT\fR: フルガベージ・コレクション時間。 +\fBFGCT\fR: フルガベージ・コレクション時間。 .sp -\fIGCT\fR: ガベージ・コレクション総時間。 +\fBGCT\fR: ガベージ・コレクション総時間。 .RE .PP \-gcoldcapacity \fIoption\fR .RS 4 Old世代の統計データ。 .sp -\fIOGCMN\fR: Old世代の最小容量(KB)。 +\fBOGCMN\fR: Old世代の最小容量(KB)。 .sp -\fIOGCMX\fR: Old世代の最大容量(KB)。 +\fBOGCMX\fR: Old世代の最大容量(KB)。 .sp -\fIOGC\fR: Old世代の現在の容量(KB)。 +\fBOGC\fR: Old世代の現在の容量(KB)。 .sp -\fIOC\fR: Old領域の現在の容量(KB)。 +\fBOC\fR: Old領域の現在の容量(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .sp -\fIFGCT\fR: フルガベージ・コレクション時間。 +\fBFGCT\fR: フルガベージ・コレクション時間。 .sp -\fIGCT\fR: ガベージ・コレクション総時間。 +\fBGCT\fR: ガベージ・コレクション総時間。 .RE .PP \-gcmetacapacity \fIoption\fR .RS 4 Permanent世代の統計データ。 .sp -\fIMCMN\fR: メタスペースの最小容量(KB)。 +\fBMCMN\fR: メタスペースの最小容量(KB)。 .sp -\fIMCMX\fR: メタスペースの最大容量(KB)。 +\fBMCMX\fR: メタスペースの最大容量(KB)。 .sp -\fIMC\fR: メタスペースの容量(KB)。 +\fBMC\fR: メタスペースの容量(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .sp -\fIFGCT\fR: フルガベージ・コレクション時間。 +\fBFGCT\fR: フルガベージ・コレクション時間。 .sp -\fIGCT\fR: ガベージ・コレクション総時間。 +\fBGCT\fR: ガベージ・コレクション総時間。 .RE .PP \-gcutil \fIoption\fR .RS 4 ガベージ・コレクション統計データのサマリー .sp -\fIS0\fR: Survivor領域0の使用率(現在の容量に対するパーセンテージ)。 +\fBS0\fR: Survivor領域0の使用率(現在の容量に対するパーセンテージ)。 .sp -\fIS1\fR: Survivor領域1の使用率(現在の容量に対するパーセンテージ)。 +\fBS1\fR: Survivor領域1の使用率(現在の容量に対するパーセンテージ)。 .sp -\fIE\fR: Eden領域の使用率(現在の容量に対するパーセンテージ)。 +\fBE\fR: Eden領域の使用率(現在の容量に対するパーセンテージ)。 .sp -\fIO\fR: Old領域の使用率(現在の容量に対するパーセンテージ)。 +\fBO\fR: Old領域の使用率(現在の容量に対するパーセンテージ)。 .sp -\fIM\fR: メタスペースの使用率(領域の現在の容量に対するパーセンテージ)。 +\fBM\fR: メタスペースの使用率(領域の現在の容量に対するパーセンテージ)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIYGCT\fR: 若い世代のガベージ・コレクション時間。 +\fBYGCT\fR: 若い世代のガベージ・コレクション時間。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .sp -\fIFGCT\fR: フルガベージ・コレクション時間。 +\fBFGCT\fR: フルガベージ・コレクション時間。 .sp -\fIGCT\fR: ガベージ・コレクション総時間。 +\fBGCT\fR: ガベージ・コレクション総時間。 .RE .PP \-printcompilation \fIoption\fR .RS 4 Java HotSpot VMコンパイル・メソッドの統計データ。 .sp -\fICompiled\fR: 最近コンパイルされたメソッドで実行されたコンパイル・タスクの数。 +\fBCompiled\fR: 最近コンパイルされたメソッドで実行されたコンパイル・タスクの数。 .sp -\fISize\fR: 最近コンパイルされたメソッドのバイト・コードのバイト数。 +\fBSize\fR: 最近コンパイルされたメソッドのバイト・コードのバイト数。 .sp -\fIType\fR: 最近コンパイルされたメソッドのコンパイル・タイプ。 +\fBType\fR: 最近コンパイルされたメソッドのコンパイル・タイプ。 .sp -\fIMethod\fR: 最近コンパイルされたメソッドを特定するクラス名とメソッド名。クラス名では、名前空間の区切り文字として、ドット(\&.)のかわりにスラッシュ(/)が使用されます。メソッド名は、指定されたクラス内のメソッドです。これらの2つのフィールドの形式は、HotSpot -\fI\-XX:+PrintComplation\fRオプションと対応しています。 +\fBMethod\fR: 最近コンパイルされたメソッドを特定するクラス名とメソッド名。クラス名では、名前空間の区切り文字として、ドット(\&.)のかわりにスラッシュ(/)が使用されます。メソッド名は、指定されたクラス内のメソッドです。これらの2つのフィールドの形式は、HotSpot +\fB\-XX:+PrintCompilation\fRオプションと対応しています。 .RE .SH "例" .PP この項では、21891の\fIlvmid\fRを持つローカルJVMをモニタリングする例を示します。 .SS "gcutilオプション" .PP -この例では、lvmid 21891に接続して、250ミリ秒間隔で7つのサンプルを取得し、\-\fIgcutil\fRオプションでの指定に従って出力を表示します。 +この例では、lvmid 21891に接続して、250ミリ秒間隔で7つのサンプルを取得し、\-\fBgcutil\fRオプションでの指定に従って出力を表示します。 .PP この例の出力は、若い世代のコレクションが3番目と4番目のサンプル間で行われたことを示しています。コレクションには0\&.001秒かかっており、オブジェクトがEden領域(E)からOld領域(O)に昇格したため、Old領域の使用率は9\&.49%から9\&.51%に増加しています。Survivor領域は、コレクション前は12\&.44%が使用されていましたが、コレクション後の使用は7\&.74%のみです。 .sp @@ -495,22 +499,23 @@ .RS 4 .\} .nf -jstat \-gcutil 21891 250 7 - S0 S1 E O M YGC YGCT FGC FGCT GCT -0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 +\fBjstat \-gcutil 21891 250 7\fR +\fB S0 S1 E O M YGC YGCT FGC FGCT GCT\fR +\fB0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR + .fi .if n \{\ .RE .\} .SS "列ヘッダー文字列の繰返し" .PP -この例では、lvmid 21891に接続して、250ミリ秒間隔でサンプルを取得し、\fI\-gcutil\fRオプションでの指定に従って出力を表示します。さらに、\fI\-h3\fRオプションを使用して、データが3行表示されるごとに列ヘッダーを出力します。 +この例では、lvmid 21891に接続して、250ミリ秒間隔でサンプルを取得し、\fB\-gcutil\fRオプションでの指定に従って出力を表示します。さらに、\fB\-h3\fRオプションを使用して、データが3行表示されるごとに列ヘッダーを出力します。 .PP この例では、ヘッダー文字列の繰返しが表示されているほか、2番目と3番目のサンプル間でYoung GCが行われたことがわかります。この継続時間は0\&.001秒でした。このコレクションでは、Survivor領域0の使用率(S0U)が適切なSurvivorサイズ(DSS)を超過することになるアクティブ・データが検出されました。この結果、オブジェクトは、Old世代(この出力には非表示)へ昇格され、殿堂入りしきい値(TT)が、31から2へ降格されました。 .PP @@ -520,51 +525,54 @@ .RS 4 .\} .nf -jstat \-gcnew \-h3 21891 250 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT - 64\&.0 64\&.0 0\&.0 31\&.7 31 31 32\&.0 512\&.0 178\&.6 249 0\&.203 - 64\&.0 64\&.0 0\&.0 31\&.7 31 31 32\&.0 512\&.0 355\&.5 249 0\&.203 - 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 21\&.9 250 0\&.204 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT - 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 245\&.9 250 0\&.204 - 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 421\&.1 250 0\&.204 - 64\&.0 64\&.0 0\&.0 19\&.0 31 31 32\&.0 512\&.0 84\&.4 251 0\&.204 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT - 64\&.0 64\&.0 0\&.0 19\&.0 31 31 32\&.0 512\&.0 306\&.7 251 0\&.204 +\fBjstat \-gcnew \-h3 21891 250\fR +\fB S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT\fR +\fB 64\&.0 64\&.0 0\&.0 31\&.7 31 31 32\&.0 512\&.0 178\&.6 249 0\&.203\fR +\fB 64\&.0 64\&.0 0\&.0 31\&.7 31 31 32\&.0 512\&.0 355\&.5 249 0\&.203\fR +\fB 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 21\&.9 250 0\&.204\fR +\fB S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT\fR +\fB 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 245\&.9 250 0\&.204\fR +\fB 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 421\&.1 250 0\&.204\fR +\fB 64\&.0 64\&.0 0\&.0 19\&.0 31 31 32\&.0 512\&.0 84\&.4 251 0\&.204\fR +\fB S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT\fR +\fB 64\&.0 64\&.0 0\&.0 19\&.0 31 31 32\&.0 512\&.0 306\&.7 251 0\&.204\fR + .fi .if n \{\ .RE .\} .SS "サンプルごとのタイムスタンプの挿入" .PP -この例では、lvmid21891へ接続し、250ミリ秒間隔で3つのサンプルを取得しています。\fI\-t\fRオプションを使用して、最初の列にサンプルごとのタイムスタンプを表示しています。 +この例では、lvmid21891へ接続し、250ミリ秒間隔で3つのサンプルを取得しています。\fB\-t\fRオプションを使用して、最初の列にサンプルごとのタイムスタンプを表示しています。 .PP -Timestamp列には、ターゲットJVMの起動時からの経過時間が、秒単位でレポートされています。さらに、\fI\-gcoldcapacity\fR出力では、割当リクエストまたは昇格リクエストあるいはその両方を満たすためにヒープが拡張するたびに、Old世代の容量(OGC)とOld領域の容量(OC)とが増加していることがわかります。81番目のフル・ガベージ・コレクション(FGC)の後、Old世代の容量(OGC)は11,696 KBから13820 KBに増加しました。この世代(および領域)の最大容量は、60,544 KB (OGCMX)なので、まだ拡張できる余裕が残されています。 +Timestamp列には、ターゲットJVMの起動時からの経過時間が、秒単位でレポートされています。さらに、\fB\-gcoldcapacity\fR出力では、割当リクエストまたは昇格リクエストあるいはその両方を満たすためにヒープが拡張するたびに、Old世代の容量(OGC)とOld領域の容量(OC)とが増加していることがわかります。81番目のフル・ガベージ・コレクション(FGC)の後、Old世代の容量(OGC)は11,696 KBから13820 KBに増加しました。この世代(および領域)の最大容量は、60,544 KB (OGCMX)なので、まだ拡張できる余裕が残されています。 .sp .if n \{\ .RS 4 .\} .nf -Timestamp OGCMN OGCMX OGC OC YGC FGC FGCT GCT - 150\&.1 1408\&.0 60544\&.0 11696\&.0 11696\&.0 194 80 2\&.874 3\&.799 - 150\&.4 1408\&.0 60544\&.0 13820\&.0 13820\&.0 194 81 2\&.938 3\&.863 - 150\&.7 1408\&.0 60544\&.0 13820\&.0 13820\&.0 194 81 2\&.938 3\&.863 +\fBTimestamp OGCMN OGCMX OGC OC YGC FGC FGCT GCT\fR +\fB 150\&.1 1408\&.0 60544\&.0 11696\&.0 11696\&.0 194 80 2\&.874 3\&.799\fR +\fB 150\&.4 1408\&.0 60544\&.0 13820\&.0 13820\&.0 194 81 2\&.938 3\&.863\fR +\fB 150\&.7 1408\&.0 60544\&.0 13820\&.0 13820\&.0 194 81 2\&.938 3\&.863\fR + .fi .if n \{\ .RE .\} -.SS "リモートJVMのインストゥルメンテーションの監視" +.SS "リモートJVMのインストゥルメンテーションのモニター" .PP -この例は、\fI\-gcutil\fRオプションを使用して、remote\&.domainというシステム上のlvmid 40496に接続し、サンプルを秒単位で無期限に取得しています。 +この例は、\fB\-gcutil\fRオプションを使用して、remote\&.domainというシステム上のlvmid 40496に接続し、サンプルを秒単位で無期限に取得しています。 .PP -lvmidは、リモート・ホストの名前と結合されて、\fI40496@remote\&.domain\fRの\fIvmid\fRを構成しています。結果として、このvmidは、\fIrmi\fRプロトコルを使用して、リモート・ホスト上のデフォルトの\fIjstatd\fRサーバーと通信します。\fIjstatd\fRサーバーは、rmiregistryを使用して、デフォルトのrmiregistryポート(ポート1099)にバインドされた\fIremote\&.domain\fRに配置されます。 +lvmidは、リモート・ホストの名前と結合されて、\fB40496@remote\&.domain\fRの\fIvmid\fRを構成しています。結果として、このvmidは、\fBrmi\fRプロトコルを使用して、リモート・ホスト上のデフォルトの\fBjstatd\fRサーバーと通信します。\fBjstatd\fRサーバーは、rmiregistryを使用して、デフォルトのrmiregistryポート(ポート1099)にバインドされた\fBremote\&.domain\fRに配置されます。 .sp .if n \{\ .RS 4 .\} .nf -jstat \-gcutil 40496@remote\&.domain 1000 -\fI\&.\&.\&. output omitted\fR +\fBjstat \-gcutil 40496@remote\&.domain 1000\fR +\fB\fI\&.\&.\&. output omitted\fR\fR + .fi .if n \{\ .RE
--- a/src/linux/doc/man/ja/jstatd.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jstatd.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jstatd -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: モニタリング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jstatd +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: モニタリング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jstatd" "1" "2013年11月21日" "JDK 8" "モニタリング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jstatd \- Java仮想マシン(JVM)をモニターし、リモート・モニタリング・ツールがJVMに接続できるようにします。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjstatd\fR [ \fIoptions\fR ] +\fBjstatd\fR [ \fIoptions\fR ] .fi .if n \{\ .RE @@ -64,156 +66,164 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .SH "説明" .PP -\fIjstatd\fRコマンドは、計測されたJava HotSpot VMの作成と終了をモニターし、ローカル・システム上で実行されているJVMに、リモート・モニタリング・ツールが接続できるようにするためのインタフェースを提供するRMIサーバー・アプリケーションです。 +\fBjstatd\fRコマンドは、計測されたJava HotSpot VMの作成と終了をモニターし、ローカル・システム上で実行されているJVMに、リモート・モニタリング・ツールが接続できるようにするためのインタフェースを提供するRMIサーバー・アプリケーションです。 .PP -\fIjstatd\fRサーバーでは、ローカル・ホストにRMIレジストリが必要になります。\fIjstatd\fRサーバーはデフォルト・ポートで、または\fI\-p\fR -\fIport\fRオプションで指定したポートで、RMIレジストリに接続しようとします。RMIレジストリが見つからない場合、\fI\-p\fR -\fIport\fRオプションで指定されたポート、または\fI\-p\fR -\fIport\fRオプションが省略されている場合は、デフォルトRMIレジストリにバインドされた\fIjstatd\fRアプリケーション内に、1つのRMIレジストリが作成されます。内部RMIレジストリの作成は、\fI\-nr\fRオプションを指定することによって中止できます。 +\fBjstatd\fRサーバーでは、ローカル・ホストにRMIレジストリが必要になります。\fBjstatd\fRサーバーはデフォルト・ポートで、または\fB\-p\fR +\fBport\fRオプションで指定したポートで、RMIレジストリに接続しようとします。RMIレジストリが見つからない場合、\fB\-p\fR +\fBport\fRオプションで指定されたポート、または\fB\-p\fR +\fBport\fRオプションが省略されている場合は、デフォルトRMIレジストリにバインドされた\fBjstatd\fRアプリケーション内に、1つのRMIレジストリが作成されます。内部RMIレジストリの作成は、\fB\-nr\fRオプションを指定することによって中止できます。 .SH "オプション" .PP \-nr .RS 4 -既存のRMIレジストリが見つからない場合、\fIjstatd\fRプロセス内に内部RMIレジストリを作成しないようにします。 +既存のRMIレジストリが見つからない場合、\fBjstatd\fRプロセス内に内部RMIレジストリを作成しないようにします。 .RE .PP \-p \fIport\fR .RS 4 -RMIレジストリがあると予想されるポート番号です。見つからない場合は、\fI\-nr\fRオプションが指定されていなければ作成されます。 +RMIレジストリがあると予想されるポート番号です。見つからない場合は、\fB\-nr\fRオプションが指定されていなければ作成されます。 .RE .PP \-n \fIrminame\fR .RS 4 -RMIレジストリにおいて、リモートRMIオブジェクトがバインドされる名前です。デフォルト名は\fIJStatRemoteHost\fRです。複数の\fIjstatd\fRサーバーが同じホスト上で起動している場合、各サーバーのエクスポートしたRMIオブジェクトの名前は、このオプションを指定することによって、一意の名前にすることができます。ただし、このオプションを使用する場合、モニタリング・クライアントの\fIhostid\fRおよび\fIvmid\fR文字列に、その一意のサーバー名を含める必要があります。 +RMIレジストリにおいて、リモートRMIオブジェクトがバインドされる名前です。デフォルト名は\fBJStatRemoteHost\fRです。複数の\fBjstatd\fRサーバーが同じホスト上で起動している場合、各サーバーのエクスポートしたRMIオブジェクトの名前は、このオプションを指定することによって、一意の名前にすることができます。ただし、このオプションを使用する場合、モニタリング・クライアントの\fBhostid\fRおよび\fBvmid\fR文字列に、その一意のサーバー名を含める必要があります。 .RE .PP \-J\fIoption\fR .RS 4 -JVMに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fIオプション\fRを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +JVMに\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fBオプション\fRを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "セキュリティ" .PP -\fIjstatd\fRサーバーは、適切なネイティブ・アクセス権を持つJVMのみを監視できます。したがって、\fIjstatd\fRプロセスは、ターゲットJVMと同じユーザー資格で実行されている必要があります。UNIXベースのシステムにおけるrootユーザーなどの一部のユーザー資格は、システム上の任意のJVMによってエクスポートされたインストゥルメンテーションへのアクセス権を持っています。このような資格で実行されている\fIjstatd\fRプロセスは、システム上のすべてのJVMを監視できますが、セキュリティ上の別の問題が起こります。 +\fBjstatd\fRサーバーは、適切なネイティブ・アクセス権を持つJVMのみをモニターできます。したがって、\fBjstatd\fRプロセスは、ターゲットJVMと同じユーザー資格証明で実行されている必要があります。Solaris、LinuxおよびOS Xオペレーティング・システムにおけるrootユーザーなどの一部のユーザー資格証明は、システム上の任意のJVMによってエクスポートされたインストゥルメンテーションへのアクセス権を持っています。このような資格証明で実行されている\fBjstatd\fRプロセスは、システム上のすべてのJVMをモニターできますが、セキュリティ上の別の問題が起こります。 .PP -\fIjstatd\fRサーバーには、リモート・クライアントの認証機能がありません。そのため、\fIjstatd\fRサーバー・プロセスを実行すると、\fIjstatd\fRプロセスがアクセス権を持つすべてのJVMによるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境によっては望ましくない場合があるので、特に実稼働環境または安全でないネットワークでは、\fIjstatd\fRプロセスを起動する前に、ローカル・セキュリティ・ポリシーを検討する必要があります。 +\fBjstatd\fRサーバーには、リモート・クライアントの認証機能がありません。そのため、\fBjstatd\fRサーバー・プロセスを実行すると、\fBjstatd\fRプロセスがアクセス権を持つすべてのJVMによるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境によっては望ましくない場合があるので、特に本番環境またはセキュアでないネットワークでは、\fBjstatd\fRプロセスを起動する前に、ローカル・セキュリティ・ポリシーを検討する必要があります。 .PP -\fIjstatd\fRサーバーは、他のセキュリティ・マネージャがインストールされていない場合には、\fIRMISecurityPolicy\fRのインスタンスをインストールします。そのため、セキュリティ・ポリシー・ファイルを指定する必要があります。ポリシー・ファイルは、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある +\fBjstatd\fRサーバーは、他のセキュリティ・マネージャがインストールされていない場合には、\fBRMISecurityPolicy\fRのインスタンスをインストールします。そのため、セキュリティ・ポリシー・ファイルを指定する必要があります。ポリシー・ファイルは、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある 「デフォルトのPolicyの実装とポリシー・ファイルの構文」に準拠している必要があります .PP -次のポリシー・ファイルでは、セキュリティ例外を発生せずに\fIjstatd\fRサーバーを実行できます。このポリシーは、すべてのコード・ベースへのあらゆるアクセス権を認めるポリシーよりも自由度が低いですが、\fIjstatd\fRサーバーを実行するために最低限必要なアクセス権のみを認めるポリシーよりも自由度が高くなっています。 +次のポリシー・ファイルでは、セキュリティ例外を発生せずに\fBjstatd\fRサーバーを実行できます。このポリシーは、すべてのコード・ベースへのあらゆるアクセス権を認めるポリシーよりも自由度が低いですが、\fBjstatd\fRサーバーを実行するために最低限必要なアクセス権のみを認めるポリシーよりも自由度が高くなっています。 .sp .if n \{\ .RS 4 .\} .nf -grant codebase "file:${java\&.home}/\&.\&./lib/tools\&.jar" { - permission java\&.security\&.AllPermission; -}; +\fBgrant codebase "file:${java\&.home}/\&.\&./lib/tools\&.jar" { \fR +\fB permission java\&.security\&.AllPermission;\fR +\fB};\fR + .fi .if n \{\ .RE .\} .PP -このポリシー設定を使用するには、このテキストを\fIjstatd\&.all\&.policy\fRというファイルにコピーし、次のように\fIjstatd\fRサーバーを実行します。 +このポリシー設定を使用するには、このテキストを\fBjstatd\&.all\&.policy\fRというファイルにコピーし、次のように\fBjstatd\fRサーバーを実行します。 .sp .if n \{\ .RS 4 .\} .nf -jstatd \-J\-Djava\&.security\&.policy=jstatd\&.all\&.policy +\fBjstatd \-J\-Djava\&.security\&.policy=jstatd\&.all\&.policy\fR + .fi .if n \{\ .RE .\} .PP -より厳しいセキュリティを実施するサイトの場合、カスタム・ポリシー・ファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。ただし、このような方法は、IPアドレスの盗聴攻撃を受けやすくなります。セキュリティの問題について、カスタマイズしたポリシー・ファイルでも対処できない場合は、\fIjstatd\fRサーバーを実行せずに、\fIjstat\fRと\fIjps\fRツールをローカルで使用することが最も安全な方法になります。 +より厳しいセキュリティを実施するサイトの場合、カスタム・ポリシー・ファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。ただし、このような方法は、IPアドレスの盗聴攻撃を受けやすくなります。セキュリティの問題について、カスタマイズしたポリシー・ファイルでも対処できない場合は、\fBjstatd\fRサーバーを実行せずに、\fBjstat\fRと\fBjps\fRツールをローカルで使用することが最も安全な方法になります。 .SH "リモート・インタフェース" .PP -\fIjstatd\fRプロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書込みを行わないでください。 +\fBjstatd\fRプロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書込みを行わないでください。 .SH "例" .PP -次に、\fIjstatd\fRコマンドの例を示します。\fIjstatd\fRスクリプトによって、サーバーはバックグラウンドで自動的に起動します。 +次に、\fBjstatd\fRコマンドの例を示します。\fBjstatd\fRスクリプトによって、サーバーはバックグラウンドで自動的に起動します。 .SS "内部RMIレジストリ" .PP -この例は、内部RMIレジストリを使用したホストによる\fIjstatd\fRセッションの起動を表しています。この例では、デフォルトのRMIレジストリ・ポート(ポート1099)には、他のサーバーはバインドされていないと想定しています。 +この例は、内部RMIレジストリを使用した\fBjstatd\fRセッションの起動方法を表しています。この例では、デフォルトのRMIレジストリ・ポート(ポート1099)には、他のサーバーはバインドされていないと想定しています。 .sp .if n \{\ .RS 4 .\} .nf -jstatd \-J\-Djava\&.security\&.policy=all\&.policy +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy\fR + .fi .if n \{\ .RE .\} .SS "外部RMIレジストリ" .PP -この例は、外部RMIレジストリを使用した\fIjstatd\fRセッションの起動を表しています。 +この例は、外部RMIレジストリを使用した\fBjstatd\fRセッションの起動を表しています。 .sp .if n \{\ .RS 4 .\} .nf -rmiregistry& -jstatd \-J\-Djava\&.security\&.policy=all\&.policy +\fBrmiregistry&\fR +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy\fR + .fi .if n \{\ .RE .\} .PP -この例では、ポート2020の外部RMIレジストリを使用して\fIjstatd\fRセッションを起動します。 +この例では、ポート2020の外部RMIレジストリを使用して\fBjstatd\fRセッションを起動します。 .sp .if n \{\ .RS 4 .\} .nf -jrmiregistry 2020& -jstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020 +\fBjrmiregistry 2020&\fR +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020\fR + .fi .if n \{\ .RE .\} .PP -この例では、ポート2020の外部RMIレジストリを使用して、\fIAlternateJstatdServerName\fRにバインドされている\fIjstatd\fRセッションを起動します。 +この例では、ポート2020の外部RMIレジストリを使用して、\fBAlternateJstatdServerName\fRにバインドされている\fBjstatd\fRセッションを起動します。 .sp .if n \{\ .RS 4 .\} .nf -rmiregistry 2020& -jstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020 - \-n AlternateJstatdServerName +\fBrmiregistry 2020&\fR +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020\fR +\fB \-n AlternateJstatdServerName\fR + .fi .if n \{\ .RE .\} .SS "インプロセスRMIレジストリの作成の停止" .PP -この例では、外部RMIレジストリがない場合に作成しない\fIjstatd\fRセッションを起動します。この例では、RMIレジストリがすでに実行されていると想定しています。RMIレジストリが実行されていない場合、エラー・メッセージが表示されます。 +この例では、外部RMIレジストリがない場合に作成しない\fBjstatd\fRセッションを起動します。この例では、RMIレジストリがすでに実行されていると想定しています。RMIレジストリが実行されていない場合、エラー・メッセージが表示されます。 .sp .if n \{\ .RS 4 .\} .nf -jstatd \-J\-Djava\&.security\&.policy=all\&.policy \-nr +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy \-nr\fR + .fi .if n \{\ .RE .\} .SS "RMIロギングの有効化" .PP -この例では、RMIロギング機能を有効化して\fIjstatd\fRセッションを起動します。この方法は、トラブルシューティングまたはサーバー活動のモニタリングに役立ちます。 +この例では、RMIロギング機能を有効化して\fBjstatd\fRセッションを起動します。この方法は、トラブルシューティングまたはサーバー活動のモニタリングに役立ちます。 .sp .if n \{\ .RS 4 .\} .nf -jstatd \-J\-Djava\&.security\&.policy=all\&.policy - \-J\-Djava\&.rmi\&.server\&.logCalls=true +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy\fR +\fB \-J\-Djava\&.rmi\&.server\&.logCalls=true\fR + .fi .if n \{\ .RE
--- a/src/linux/doc/man/ja/jvisualvm.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/jvisualvm.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2008, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jvisualvm -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Javaトラブルシューティング、プロファイリング、モニタリングおよび管理ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2008, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jvisualvm +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Javaトラブルシューティング、プロファイリング、モニタリングおよび管理ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jvisualvm" "1" "2013年11月21日" "JDK 8" "Javaトラブルシューティング、プロファイリング、モニタリン" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jvisualvm \- Javaアプリケーションを視覚的に監視、トラブルシュートおよびプロファイルします。 +.SH "名前" +jvisualvm \- Javaアプリケーションを視覚的にモニターし、トラブルシューティングとプロファイリングを行います。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjvisualvm\fR [ \fIoptions\fR ] +\fBjvisualvm\fR [ \fIoptions\fR ] .fi .if n \{\ .RE @@ -64,15 +66,15 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .SH "説明" .PP -Java VisualVMは、指定されたJava仮想マシン(JVM)でJavaテクノロジ・ベースのアプリケーション(Javaアプリケーション)が実行されているときに、そのJavaアプリケーションに関する詳細な情報を提供する直感的なグラフィカル・ユーザー・インタフェースです。Java VisualVMという名前は、Java VisualVMがJVMソフトウェアに関する情報を視覚的に提供するという事実に由来しています。 +Java VisualVMは、指定されたJava Virtual Machine (JVM)でJavaテクノロジ・ベースのアプリケーション(Javaアプリケーション)が実行されているときに、そのJavaアプリケーションに関する詳細な情報を提供する直感的なグラフィカル・ユーザー・インタフェースです。Java VisualVMという名前は、Java VisualVMがJVMソフトウェアに関する情報を視覚的に提供するという事実に由来しています。 .PP -Java VisualVMは、いくつかのモニタリング、トラブルシューティングおよびプロファイリング・ユーティリティを1つのツールに統合します。たとえば、スタンドアロン・ツール\fIjmap\fR、\fIjinfo\fR、\fIjstat\fRおよび\fIjstack\fRで提供されている機能のほとんどが、Java VisualVMに組み込まれています。\fIjconsole\fRコマンドによって提供される一部の機能など、他の機能はオプションのプラグインとして追加できます。 +Java VisualVMは、いくつかのモニタリング、トラブルシューティングおよびプロファイリング・ユーティリティを1つのツールに統合します。たとえば、スタンドアロン・ツール\fBjmap\fR、\fBjinfo\fR、\fBjstat\fRおよび\fBjstack\fRで提供されている機能のほとんどが、Java VisualVMに組み込まれています。\fBjconsole\fRコマンドによって提供される一部の機能など、他の機能はオプションのプラグインとして追加できます。 .PP -Java VisualVMは、Javaアプリケーションの開発者がアプリケーションのトラブルシューティングを行ったり、アプリケーションのパフォーマンスを監視および改善したりするのに役立ちます。Java VisualVMを使用すると、開発者はヒープ・ダンプの生成および解析、メモリー・リークの特定、ガベージ・コレクションの実行および監視、およびメモリーとCPUの簡易プロファイリングの実行が可能になります。プラグインでJava VisualVMの機能を拡張できます。たとえば、\fIjconsole\fRコマンドのほとんどの機能は、「MBean」タブおよびJConsole Plug\-in Wrapperプラグインを介して使用できます。標準のJava VisualVMプラグインのカタログから選択するには、Java VisualVMメニューの\fB「ツール」\fR、\fB「プラグイン」\fRを選択します。 +Java VisualVMは、Javaアプリケーションの開発者がアプリケーションのトラブルシューティングを行ったり、アプリケーションのパフォーマンスをモニターおよび改善したりするのに役立ちます。Java VisualVMを使用すると、開発者はヒープ・ダンプの生成および解析、メモリー・リークの特定、ガベージ・コレクションの実行およびモニター、およびメモリーとCPUの簡易プロファイリングの実行が可能になります。プラグインでJava VisualVMの機能を拡張できます。たとえば、\fBjconsole\fRコマンドのほとんどの機能は、「MBean」タブおよびJConsole Plug\-in Wrapperプラグインを介して使用できます。標準のJava VisualVMプラグインのカタログから選択するには、Java VisualVMメニューの\fB「ツール」\fR、\fB「プラグイン」\fRを選択します。 .PP Java VisualVMを起動するには、次のコマンドを実行します。 .sp @@ -80,7 +82,8 @@ .RS 4 .\} .nf -% jvisualvm <options> +\fB% jvisualvm <options>\fR + .fi .if n \{\ .RE @@ -91,7 +94,7 @@ .PP \-J\fIjvm_option\fR .RS 4 -この\fIjvm_option\fRをJVMソフトウェアに渡します。 +この\fBjvm_option\fRをJVMソフトウェアに渡します。 .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/keytool.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/keytool.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: keytool -.\" Language: English -.\" Date: 2013年8月6日 -.\" SectDesc: セキュリティ・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: keytool +.\" Language: Japanese +.\" Date: 2013年8月6日 +.\" SectDesc: セキュリティ・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "keytool" "1" "2013年8月6日" "JDK 8" "セキュリティ・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" keytool \- 暗号化鍵、X\&.509証明書チェーンおよび信頼できる証明書を含むキーストア(データベース)を管理します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIkeytool\fR [\fIcommands\fR] +\fBkeytool\fR [\fIcommands\fR] .fi .if n \{\ .RE @@ -332,13 +334,13 @@ .RE .SH "説明" .PP -\fIkeytool\fRコマンドは、鍵と証明書を管理するためのユーティリティです。これにより、ユーザーは自分の公開鍵と秘密鍵のペアおよび関連する証明書を管理し、デジタル署名を使用した自己認証(他のユーザーまたはサービスに対して自分自身を認証すること)や、データの整合性と証明書に関するサービスを利用することができます。\fIkeytool\fRコマンドでは、通信しているピアの公開鍵をキャッシュすることもできます(証明書のフォームで)。 +\fBkeytool\fRコマンドは、鍵と証明書を管理するためのユーティリティです。これにより、ユーザーは自分の公開鍵と秘密鍵のペアおよび関連する証明書を管理し、デジタル署名を使用した自己認証(他のユーザーまたはサービスに対して自分自身を認証すること)や、データの整合性と証明書に関するサービスを利用することができます。\fBkeytool\fRコマンドでは、通信しているピアの公開鍵をキャッシュすることもできます(証明書のフォームで)。 .PP 証明書とは、あるエンティティ(人物、会社など)からのデジタル署名付きの文書のことです。証明書には、他のあるエンティティの公開鍵(およびその他の情報)が特別な値を持っていることが書かれています。(証明書を参照してください。)データにデジタル署名が付いている場合は、デジタル署名を検証することで、データの整合性およびデータが本物であることをチェックできます。データの整合性とは、データが変更されたり、改変されたりしていないことを意味します。また、データが本物であるとは、そのデータが、データを作成して署名したと称する人物から渡されたデータであることを意味します。 .PP -また、\fIkeytool\fRコマンドを使用すれば、対称暗号化/復号化(DES)で使用される秘密鍵およびパスフレーズを管理することもできます。 +また、\fBkeytool\fRコマンドを使用すれば、対称暗号化/復号化(DES)で使用される秘密鍵およびパスフレーズを管理することもできます。 .PP -\fIkeytool\fRコマンドは、鍵と証明書をキーストアに格納します。キーストアの別名を参照してください。 +\fBkeytool\fRコマンドは、鍵と証明書をキーストアに格納します。キーストアの別名を参照してください。 .SH "コマンドとオプションに関する注意" .PP 様々なコマンドとその説明については、コマンドを参照してください。 @@ -384,7 +386,7 @@ .sp -1 .IP \(bu 2.3 .\} -オプションを囲む中カッコは、そのオプションをコマンドラインで指定しなかった場合に、デフォルト値が使用されることを意味します。オプションのデフォルト値を参照してください。中カッコは、\fI\-v\fR、\fI\-rfc\fRおよび\fI\-J\fRオプションを囲むためにも使用されますが、これらのオプションはコマンドラインで指定された場合にのみ意味を持ちます。指定されていない場合以外、デフォルト値はありません。 +オプションを囲む中カッコは、そのオプションをコマンド行で指定しなかった場合に、デフォルト値が使用されることを意味します。オプションのデフォルト値を参照してください。中カッコは、\fB\-v\fR、\fB\-rfc\fRおよび\fB\-J\fRオプションを囲むためにも使用されますが、これらのオプションはコマンド行で指定された場合にのみ意味を持ちます。指定されていない場合以外、デフォルト値はありません。 .RE .sp .RS 4 @@ -395,7 +397,7 @@ .sp -1 .IP \(bu 2.3 .\} -オプションを囲む角カッコは、そのオプションをコマンドラインで指定しなかった場合に、値の入力を求められることを意味します。\fI\-keypass\fRオプションの場合、オプションをコマンドラインで指定しなかった場合は、\fIkeytool\fRコマンドがまずキーストアのパスワードを使用して非公開/秘密鍵の復元を試みます。この試みが失敗した場合、\fIkeytool\fRコマンドにより、非公開/秘密鍵のパスワードの入力を求められます。 +オプションを囲む角カッコは、そのオプションをコマンド行で指定しなかった場合に、値の入力を求められることを意味します。\fB\-keypass\fRオプションの場合、オプションをコマンド行で指定しなかった場合は、\fBkeytool\fRコマンドがまずキーストアのパスワードを使用して非公開/秘密鍵の復元を試みます。この試みが失敗した場合、\fBkeytool\fRコマンドにより、非公開/秘密鍵のパスワードの入力を求められます。 .RE .sp .RS 4 @@ -406,12 +408,12 @@ .sp -1 .IP \(bu 2.3 .\} -イタリック体の項目の実際の値(オプションの値)は、指定する必要があります。たとえば、\fI\-printcert\fRコマンドの形式は次のとおりです。 +イタリック体の項目の実際の値(オプションの値)は、指定する必要があります。たとえば、\fB\-printcert\fRコマンドの形式は次のとおりです。 .sp -\fIkeytool \-printcert {\-file cert_file} {\-v}\fR +\fBkeytool \-printcert {\-file cert_file} {\-v}\fR .sp -\fI\-printcert\fRコマンドを指定する場合は、\fIcert_file\fRを実際のファイル名で置き換えます。例: -\fIkeytool \-printcert \-file VScert\&.cer\fR +\fB\-printcert\fRコマンドを指定する場合は、\fBcert_file\fRを実際のファイル名で置き換えます。例: +\fBkeytool \-printcert \-file VScert\&.cer\fR .RE .sp .RS 4 @@ -433,7 +435,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-help\fRオプションがデフォルトです。\fIkeytool\fRコマンドは、\fIkeytool \-help\fRと同じです。 +\fB\-help\fRオプションがデフォルトです。\fBkeytool\fRコマンドは、\fBkeytool \-help\fRと同じです。 .RE .SH "オプションのデフォルト値" .PP @@ -443,38 +445,39 @@ .RS 4 .\} .nf -\-alias "mykey" - -\-keyalg - "DSA" (when using \-genkeypair) - "DES" (when using \-genseckey) - -\-keysize - 2048 (when using \-genkeypair and \-keyalg is "RSA") - 1024 (when using \-genkeypair and \-keyalg is "DSA") - 256 (when using \-genkeypair and \-keyalg is "EC") - 56 (when using \-genseckey and \-keyalg is "DES") - 168 (when using \-genseckey and \-keyalg is "DESede") +\fB\-alias "mykey"\fR +\fB \fR +\fB\-keyalg\fR +\fB "DSA" (when using \-genkeypair)\fR +\fB "DES" (when using \-genseckey)\fR +\fB \fR +\fB\-keysize\fR +\fB 2048 (when using \-genkeypair and \-keyalg is "RSA")\fR +\fB 1024 (when using \-genkeypair and \-keyalg is "DSA")\fR +\fB 256 (when using \-genkeypair and \-keyalg is "EC")\fR +\fB 56 (when using \-genseckey and \-keyalg is "DES")\fR +\fB 168 (when using \-genseckey and \-keyalg is "DESede")\fR +\fB \fR +\fB\-validity 90\fR +\fB \fR +\fB\-keystore <the file named \&.keystore in the user\*(Aqs home directory>\fR +\fB \fR +\fB\-storetype <the value of the "keystore\&.type" property in the\fR +\fB security properties file, which is returned by the static\fR +\fB getDefaultType method in java\&.security\&.KeyStore>\fR +\fB \fR +\fB\-file\fR +\fB stdin (if reading)\fR +\fB stdout (if writing)\fR +\fB \fR +\fB\-protected false\fR -\-validity 90 - -\-keystore <the file named \&.keystore in the user\*(Aqs home directory> - -\-storetype <the value of the "keystore\&.type" property in the - security properties file, which is returned by the static - getDefaultType method in java\&.security\&.KeyStore> - -\-file - stdin (if reading) - stdout (if writing) - -\-protected false .fi .if n \{\ .RE .\} .PP -公開/秘密鍵ペアの生成において、署名アルゴリズム(\fI\-sigalg\fRオプション)は、基になる秘密鍵のアルゴリズムから派生します。 +公開/秘密鍵ペアの生成において、署名アルゴリズム(\fB\-sigalg\fRオプション)は、基になる秘密鍵のアルゴリズムから派生します。 .sp .RS 4 .ie n \{\ @@ -484,7 +487,7 @@ .sp -1 .IP \(bu 2.3 .\} -基になる秘密鍵がDSAタイプである場合は、\fI\-sigalg\fRオプションのデフォルト値はSHA1withDSAになります。 +基になる秘密鍵がDSAタイプである場合は、\fB\-sigalg\fRオプションのデフォルト値はSHA1withDSAになります。 .RE .sp .RS 4 @@ -495,7 +498,7 @@ .sp -1 .IP \(bu 2.3 .\} -基になる秘密鍵がRSAタイプである場合は、\fI\-sigalg\fRオプションのデフォルト値はSHA256withRSAになります。 +基になる秘密鍵がRSAタイプである場合は、\fB\-sigalg\fRオプションのデフォルト値はSHA256withRSAになります。 .RE .sp .RS 4 @@ -506,16 +509,16 @@ .sp -1 .IP \(bu 2.3 .\} -基になる秘密鍵がECタイプである場合は、\fI\-sigalg\fRオプションのデフォルト値はSHA256withECDSAになります。 +基になる秘密鍵がECタイプである場合は、\fB\-sigalg\fRオプションのデフォルト値はSHA256withECDSAになります。 .RE .PP -\fI\-keyalg\fRおよび\fI\-sigalg\fR引数の完全なリストについては、 +\fB\-keyalg\fRおよび\fB\-sigalg\fR引数の完全なリストについては、 http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/CryptoSpec\&.html#AppAの「Java Cryptography Architecture (JCA) Reference Guide」を参照してください。 .SH "一般オプション" .PP -\fI\-v\fRオプションは、\fI\-help\fRコマンドを除くすべてのコマンドで使用できます。\fI\-v\fRオプションを指定した場合、コマンドは冗長モードで実行され、詳細な情報が出力されます。 +\fB\-v\fRオプションは、\fB\-help\fRコマンドを除くすべてのコマンドで使用できます。\fB\-v\fRオプションを指定した場合、コマンドは冗長モードで実行され、詳細な情報が出力されます。 .PP -任意のコマンドで指定できる\fI\-Jjavaoption\fR引数もあります。\fI\-Jjavaoption\fRを指定した場合、指定された\fIjavaoption\fR文字列がJavaインタプリタに直接渡されます。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンドラインで\fIjava \-h\fRまたは\fIjava \-X\fRと入力してください。 +任意のコマンドで指定できる\fB\-Jjavaoption\fR引数もあります。\fB\-Jjavaoption\fRを指定した場合、指定された\fBjavaoption\fR文字列がJavaインタプリタに直接渡されます。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンド行で\fBjava \-h\fRまたは\fBjava \-X\fRと入力してください。 .PP 次のオプションは、キーストアに対する操作を行うすべてのコマンドで指定できます。 .PP @@ -528,18 +531,18 @@ .RS 4 キーストアの場所を指定します。 .sp -特定の\fIkeytool\fRコマンドを実行する際に、JKS -\fIstoretype\fRが使用され、かつキーストア・ファイルがまだ存在していなかった場合、新しいキーストア・ファイルが作成されます。たとえば、\fIkeytool \-genkeypair\fRの呼出し時に\fI\-keystore\fRオプションが指定されなかった場合、\fI\&.keystore\fRという名前のデフォルト・キーストア・ファイルがユーザーのホーム・ディレクトリ内にまだ存在していなければ、そこに作成されます。同様に、\fI\-keystore ks_file\fRというオプションが指定されてもそのks_fileが存在しなかった場合、そのファイルが作成されます。JKS -\fIstoretype\fRの詳細は、\fIの\fRKeyStoreの実装キーストアの別名に関する項を参照してください。 +特定の\fBkeytool\fRコマンドを実行する際に、JKS +\fBstoretype\fRが使用され、かつキーストア・ファイルがまだ存在していなかった場合、新しいキーストア・ファイルが作成されます。たとえば、\fBkeytool \-genkeypair\fRの呼出し時に\fB\-keystore\fRオプションが指定されなかった場合、\fB\&.keystore\fRという名前のデフォルト・キーストア・ファイルがユーザーのホーム・ディレクトリ内にまだ存在していなければ、そこに作成されます。同様に、\fB\-keystore ks_file\fRというオプションが指定されてもそのks_fileが存在しなかった場合、そのファイルが作成されます。JKS +\fBstoretype\fRの詳細は、\fIの\fRKeyStoreの実装キーストアの別名に関する項を参照してください。 .sp -\fI\-keystore\fRオプションからの入力ストリームは、\fIKeyStore\&.load\fRメソッドに渡されます。URLとして\fINONE\fRが指定されている場合は、nullのストリームが\fIKeyStore\&.load\fRメソッドに渡されます。\fINONE\fRは、KeyStoreがファイルベースではない場合に指定してください。たとえば、ハードウェア・トークン・デバイス上に存在している場合などです。 +\fB\-keystore\fRオプションからの入力ストリームは、\fBKeyStore\&.load\fRメソッドに渡されます。URLとして\fBNONE\fRが指定されている場合は、nullのストリームが\fBKeyStore\&.load\fRメソッドに渡されます。\fBNONE\fRは、KeyStoreがファイルベースではない場合に指定してください。たとえば、ハードウェア・トークン・デバイス上に存在している場合などです。 .RE .PP \-storepass[:\fIenv\fR| :\fIfile\fR] argument .RS 4 キーストアの整合性を保護するために使用するパスワードを指定します。 .sp -修飾子\fIenv\fRまたは\fIfile\fRを指定しない場合、パスワードの値は\fIargument\fRになります。この値は、6文字以上にする必要があります。それ以外の場合、パスワードは次のようにして取得されます。 +修飾子\fBenv\fRまたは\fBfile\fRを指定しない場合、パスワードの値は\fBargument\fRになります。この値は、6文字以上にする必要があります。それ以外の場合、パスワードは次のようにして取得されます。 .sp .RS 4 .ie n \{\ @@ -549,8 +552,8 @@ .sp -1 .IP \(bu 2.3 .\} -\fIenv\fR: -\fIargument\fRという名前の環境変数からパスワードを取得します。 +\fBenv\fR: +\fBargument\fRという名前の環境変数からパスワードを取得します。 .RE .sp .RS 4 @@ -561,13 +564,13 @@ .sp -1 .IP \(bu 2.3 .\} -\fIfile\fR: argumentという名前のファイルからパスワードを取得します。 +\fBfile\fR: argumentという名前のファイルからパスワードを取得します。 .RE .sp \fB注意:\fR -\fI\-keypass\fR、\fI\-srckeypass\fR、\-\fIdestkeypass\fR、\fI\-srcstorepass\fR、\fI\-deststorepass\fRなどのパスワードを必要とするその他のオプションはすべて、\fIenv\fRおよび\fIfile\fR修飾子を受け付けます。パスワード・オプションと修飾子は、必ずコロン(:)で区切ってください。 +\fB\-keypass\fR、\fB\-srckeypass\fR、\-\fBdestkeypass\fR、\fB\-srcstorepass\fR、\fB\-deststorepass\fRなどのパスワードを必要とするその他のオプションはすべて、\fIenv\fRおよび\fIfile\fR修飾子を受け付けます。パスワード・オプションと修飾子は、必ずコロン(:)で区切ってください。 .sp -パスワードは、キーストアの内容にアクセスするすべてのコマンドで使用されます。この種のコマンドを実行するときに、コマンドラインで\fI\-storepass\fRオプションを指定しなかった場合は、パスワードの入力を求められます。 +パスワードは、キーストアの内容にアクセスするすべてのコマンドで使用されます。この種のコマンドを実行するときに、コマンド行で\fB\-storepass\fRオプションを指定しなかった場合は、パスワードの入力を求められます。 .sp キーストアから情報を取得する場合、パスワードは省略可能です。パスワードが指定されていない場合は、取得した情報の整合性を検証できず、警告が表示されます。 .RE @@ -584,75 +587,74 @@ .PP \-providerArg \fIprovider_arg\fR .RS 4 -\fI\-providerClass\fRオプションとともに使用され、\fIprovider_class_name\fRのコンストラクタのオプションの文字列入力引数を表します。 +\fB\-providerClass\fRオプションとともに使用され、\fBprovider_class_name\fRのコンストラクタのオプションの文字列入力引数を表します。 .RE .PP \-protected .RS 4 -\fItrue\fRまたは\fIfalse\fRのいずれか。パスワードを専用PINリーダーなどの保護された認証パス経由で指定する必要がある場合は、この値を\fItrue\fRに指定する必要があります。\fI\-importkeystore\fRコマンドには2つのキーストアが関連しているため、ソース・キーストアと宛先キーストアにそれぞれ次の2つのオプション、\fI\-srcprotected\fRと\-\fIdestprotected\fRが用意されています。 +\fBtrue\fRまたは\fBfalse\fRのいずれか。パスワードを専用PINリーダーなどの保護された認証パス経由で指定する必要がある場合は、この値を\fBtrue\fRに指定する必要があります。\fB\-importkeystore\fRコマンドには2つのキーストアが関連しているため、ソース・キーストアと宛先キーストアにそれぞれ次の2つのオプション、\fB\-srcprotected\fRと\-\fBdestprotected\fRが用意されています。 .RE .PP \-ext \fI{name{:critical} {=value}}\fR .RS 4 -X\&.509証明書エクステンションを示します。このオプションを\fI\-genkeypair\fRおよび\fI\-gencert\fRで使用して、生成される証明書または\fI\-certreq\fRにエクステンションを埋め込み、証明書リクエストでリクエストされるエクステンションを示すことができます。このオプションは複数回指定できます。\fIname\fR引数には、サポートされているエクステンション名(名前付きエクステンションを参照)または任意のOID番号を指定できます。指定されている場合、\fIvalue\fR引数はエクステンションの引数を指します。\fIvalue\fRを省略した場合、エクステンションのデフォルト値またはエクステンションが引数を必要としないことを示します。\fI:critical\fR修飾子が指定された場合、エクステンションの\fIisCritical\fR属性は\fItrue\fRで、指定されない場合は\fIfalse\fRです。\fI:critical\fRのかわりに\fI:c\fRを使用できます。 +X\&.509証明書エクステンションを示します。このオプションを\fB\-genkeypair\fRおよび\fB\-gencert\fRで使用して、生成される証明書または\fB\-certreq\fRにエクステンションを埋め込み、証明書リクエストでリクエストされるエクステンションを示すことができます。このオプションは複数回指定できます。\fBname\fR引数には、サポートされているエクステンション名(名前付きエクステンションを参照)または任意のOID番号を指定できます。指定されている場合、\fBvalue\fR引数はエクステンションの引数を指します。\fIvalue\fRを省略した場合、エクステンションのデフォルト値またはエクステンションが引数を必要としないことを示します。\fB:critical\fR修飾子が指定された場合、エクステンションの\fBisCritical\fR属性は\fBtrue\fRで、指定されない場合は\fBfalse\fRです。\fB:critical\fRのかわりに\fB:c\fRを使用できます。 .RE .SH "名前付きエクステンション" .PP -\fIkeytool\fRコマンドは、次の名前のエクステンションをサポートしています。名前の大/小文字は区別されません。 +\fBkeytool\fRコマンドは、次の名前のエクステンションをサポートしています。名前の大/小文字は区別されません。 .PP BCまたはBasicContraints .RS 4 -\fB値\fR: 完全な形式は次のとおりです: -\fIca:{true|false}[,pathlen:<len>]\fRまたは\fI<len>\fR(これは、\fIca:true,pathlen:<len>\fRの短縮形です)。<\fIlen\fR>を省略すると、\fIca:true\fRの意味になります。 +\fB値\fR: 完全な形式は、\fBca:{true|false}[,pathlen:<len>]\fRまたは\fB<len>\fR(\fBca:true,pathlen:<len>\fRの短縮形)です。<\fBlen\fR>を省略すると、\fBca:true\fRの意味になります。 .RE .PP KUまたはKeyUsage .RS 4 \fB値\fR: -\fIusage\fR(\fIusage\fR)*、\fIusage\fRには\fIdigitalSignature\fR、\fInonRepudiation\fR -(contentCommitment)、\fIkeyEncipherment\fR、\fIdataEncipherment\fR、\fIkeyAgreement\fR、\fIkeyCertSign\fR、\fIcRLSign\fR、\fIencipherOnly\fR、\fIdecipherOnly\fRのいずれかを指定できます。\fIusage\fR引数は、不明確にならないかぎり、最初の数文字(\fIdigitalSignature\fRの場合は\fIdig\fR)またはキャメルケース・スタイル(\fIdigitalSignature\fRの場合は\fIdS\fR、\fIcRLSign\fRの場合は\fIcRLS\fR)で省略表記できます。\fIusage\fR値は、大文字と小文字が区別されます。 +\fBusage\fR(\fBusage\fR)*、\fIusage\fRには\fBdigitalSignature\fR、\fBnonRepudiation\fR +(contentCommitment)、\fBkeyEncipherment\fR、\fBdataEncipherment\fR、\fBkeyAgreement\fR、\fBkeyCertSign\fR、\fBcRLSign\fR、\fBencipherOnly\fR、\fBdecipherOnly\fRのいずれかを指定できます。\fIusage\fR引数は、不明確にならないかぎり、最初の数文字(\fBdigitalSignature\fRの場合は\fBdig\fR)またはキャメルケース・スタイル(\fBdigitalSignature\fRの場合は\fBdS\fR、\fBcRLSign\fRの場合は\fBcRLS\fR)で省略表記できます。\fBusage\fR値は、大文字と小文字が区別されます。 .RE .PP EKUまたはExtendedKeyUsage .RS 4 \fB値\fR: -\fIusage\fR(\fIusage\fR)*、\fIusage\fRには\fIanyExtendedKeyUsage\fR、\fIserverAuth\fR、\fIclientAuth\fR、\fIcodeSigning\fR、\fIemailProtection\fR、\fItimeStamping\fR、\fIOCSPSigning\fRまたは任意の\fIOID文字列\fRのいずれかを指定できます。\fIusage\fR引数は、不明確にならないかぎり、最初の数文字またはキャメルケース・スタイルで省略表記できます。\fIusage\fR値は、大文字と小文字が区別されます。 +\fBusage\fR(\fBusage\fR)*、\fIusage\fRには\fBanyExtendedKeyUsage\fR、\fBserverAuth\fR、\fBclientAuth\fR、\fBcodeSigning\fR、\fBemailProtection\fR、\fBtimeStamping\fR、\fBOCSPSigning\fRまたは任意の\fIOID文字列\fRのいずれかを指定できます。\fIusage\fR引数は、不明確にならないかぎり、最初の数文字またはキャメルケース・スタイルで省略表記できます。\fBusage\fR値は、大文字と小文字が区別されます。 .RE .PP SANまたはSubjectAlternativeName .RS 4 \fB値\fR: -\fItype\fR:\fIvalue\fR -(t\fIype:value\fR)*、\fItype\fRには\fIEMAIL\fR、\fIURI\fR、\fIDNS\fR、\fIIP\fRまたは\fIOID\fRを指定できます。\fIvalue\fR引数は、\fItype\fRの文字列形式の値です。 +\fBtype\fR:\fBvalue\fR +(t\fBype:value\fR)*、\fBtype\fRには\fBEMAIL\fR、\fBURI\fR、\fBDNS\fR、\fBIP\fRまたは\fBOID\fRを指定できます。\fBvalue\fR引数は、\fBtype\fRの文字列形式の値です。 .RE .PP IANまたはIssuerAlternativeName .RS 4 \fB値\fR: -\fISubjectAlternativeName\fRと同じです。 +\fBSubjectAlternativeName\fRと同じです。 .RE .PP SIAまたはSubjectInfoAccess .RS 4 \fB値\fR: -\fImethod\fR:\fIlocation\-type\fR:\fIlocation\-value\fR -(\fImethod:location\-type\fR:\fIlocation\-value\fR)*、\fImethod\fRには\fItimeStamping\fR、\fIcaRepository\fRまたは任意のOIDを指定できます。\fIlocation\-type\fRおよび\fIlocation\-value\fR引数には、\fISubjectAlternativeName\fRエクステンションでサポートされる任意の\fItype\fR:\fIvalue\fRを指定できます。 +\fBmethod\fR:\fBlocation\-type\fR:\fBlocation\-value\fR +(\fBmethod:location\-type\fR:\fBlocation\-value\fR)*、\fBmethod\fRには\fBtimeStamping\fR、\fBcaRepository\fRまたは任意のOIDを指定できます。\fBlocation\-type\fRおよび\fBlocation\-value\fR引数には、\fBSubjectAlternativeName\fRエクステンションでサポートされる任意の\fBtype\fR:\fBvalue\fRを指定できます。 .RE .PP AIAまたはAuthorityInfoAccess .RS 4 \fB値\fR: -\fISubjectInfoAccess\fRと同じです。\fImethod\fR引数には、\fIocsp\fR、\fIcaIssuers\fRまたは任意のOIDを指定できます。 +\fBSubjectInfoAccess\fRと同じです。\fBmethod\fR引数には、\fBocsp\fR、\fBcaIssuers\fRまたは任意のOIDを指定できます。 .RE .PP -\fIname\fRがOIDの場合、OCTET STRINGタイプと長さのバイトを除外したエクステンションについては、値は\fIextnValue\fRの16進ダンプのDERエンコーディングです。HEX文字列では、標準の16進数(0\-9、a\-f、A\-F)以外の文字は無視されます。したがって、01:02:03:04と01020304の両方とも同一の値として受け付けられます。値がない場合、エクステンションの値フィールドは空になります。 +\fBname\fRがOIDの場合、OCTET STRINGタイプと長さのバイトを除外したエクステンションについては、値は\fBextnValue\fRの16進ダンプのDERエンコーディングです。HEX文字列では、標準の16進数(0\-9、a\-f、A\-F)以外の文字は無視されます。したがって、01:02:03:04と01020304の両方とも同一の値として受け付けられます。値がない場合、エクステンションの値フィールドは空になります。 .PP -\fI\-gencert\fRでのみ使用する\fIhonored\fRという特別な名前は、証明書リクエストに含まれるエクステンションを優先する方法を示します。この名前の値は、\fIall\fR(リクエストされるすべてのエクステンションが優先される)、\fIname{:[critical|non\-critical]}\fR(名前付きのエクステンションが優先されるが、別の\fIisCritical\fR属性を使用する)、および\fI\-name\fR(\fIall\fRとともに使用し、例外を示す)のカンマ区切りリストです。デフォルトでは、リクエストされるエクステンションは優先されません。 +\fB\-gencert\fRでのみ使用する\fBhonored\fRという特別な名前は、証明書リクエストに含まれるエクステンションを優先する方法を示します。この名前の値は、\fBall\fR(リクエストされるすべてのエクステンションが優先される)、\fBname{:[critical|non\-critical]}\fR(名前付きのエクステンションが優先されるが、別の\fBisCritical\fR属性を使用する)、および\fB\-name\fR(\fBall\fRとともに使用し、例外を示す)のカンマ区切りリストです。デフォルトでは、リクエストされるエクステンションは優先されません。 .PP -\fI\-ext honored\fRオプションに加え、別の名前の、またはOID -\fI\-ext\fRのオプションを指定した場合は、このエクステンションが、すでに優先されているエクステンションに追加されます。ただし、この名前(またはOID)を優先される値でも使用した場合は、その値と重要性がリクエストに含まれるものをオーバーライドします。 +\fB\-ext honored\fRオプションに加え、別の名前の、またはOID +\fB\-ext\fRのオプションを指定した場合は、このエクステンションが、すでに優先されているエクステンションに追加されます。ただし、この名前(またはOID)を優先される値でも使用した場合は、その値と重要性がリクエストに含まれるものをオーバーライドします。 .PP -\fIsubjectKeyIdentifier\fRエクステンションは常に作成されます。自己署名でない証明書の場合は、\fIauthorityKeyIdentifier\fRが作成されます。 +\fBsubjectKeyIdentifier\fRエクステンションは常に作成されます。自己署名でない証明書の場合は、\fBauthorityKeyIdentifier\fRが作成されます。 .PP \fB注意:\fR ユーザーは、エクステンション(および証明書の他のフィールド)の組合せによっては、インターネットの標準に準拠しない場合があることに注意してください。証明書の準拠に関する警告を参照してください。 @@ -660,57 +662,60 @@ .PP \-gencert .RS 4 -\fI{\-rfc} {\-infile infile} {\-outfile outfile} {\-alias alias} {\-sigalg sigalg} {\-dname dname} {\-startdate startdate {\-ext ext}* {\-validity valDays} [\-keypass keypass] {\-keystore keystore} [\-storepass storepass] {\-storetype storetype} {\-providername provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-rfc} {\-infile infile} {\-outfile outfile} {\-alias alias} {\-sigalg sigalg} {\-dname dname} {\-startdate startdate {\-ext ext}* {\-validity valDays} [\-keypass keypass] {\-keystore keystore} [\-storepass storepass] {\-storetype storetype} {\-providername provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -証明書リクエスト・ファイル(\fIkeytool\fR -\fI\-certreq\fRコマンドで作成可能)に対するレスポンスとして証明書を生成します。このコマンドは、\fIinfile\fRから(省略した場合は、標準入力から)リクエストを読み込み、別名の秘密鍵を使用してそのリクエストに署名して、X\&.509証明書を\fIoutfile\fRに(省略した場合は、標準出力に)出力します。\fI\-rfc\fRを指定した場合、出力形式はBASE64符号化のPEMになります。それ以外の場合は、バイナリDERが作成されます。 +証明書リクエスト・ファイル(\fBkeytool\fR +\fB\-certreq\fRコマンドで作成可能)に対するレスポンスとして証明書を生成します。このコマンドは、\fIinfile\fRから(省略した場合は、標準入力から)リクエストを読み込み、別名の秘密鍵を使用してそのリクエストに署名して、X\&.509証明書を\fIoutfile\fRに(省略した場合は、標準出力に)出力します。\fB\-rfc\fRを指定した場合、出力形式はBASE64符号化のPEMになります。それ以外の場合は、バイナリDERが作成されます。 .sp -\fIsigalg\fR値には、証明書に署名を付けるときに使用するアルゴリズムを指定します。\fIstartdate\fR引数は、証明書の有効開始日時です。\fIvalDays\fR引数は、証明書の有効日数を示します。 +\fBsigalg\fR値には、証明書に署名を付けるときに使用するアルゴリズムを指定します。\fBstartdate\fR引数は、証明書の有効開始日時です。\fBvalDays\fR引数は、証明書の有効日数を示します。 .sp -\fIdname\fRを指定すると、生成される証明書の主体として使用されます。それ以外の場合は、証明書リクエストからの名前が使用されます。 +\fBdname\fRを指定すると、生成される証明書の主体として使用されます。それ以外の場合は、証明書リクエストからの名前が使用されます。 .sp -\fIext\fR値は、証明書に埋め込まれるX\&.509エクステンションを示します。\fI\-ext\fRの構文については、一般オプションを参照してください。 +\fBext\fR値は、証明書に埋め込まれるX\&.509エクステンションを示します。\fB\-ext\fRの構文については、一般オプションを参照してください。 .sp -\fI\-gencert\fRオプションを使用すると、証明書チェーンを作成できます。次の例では、\fIe1\fRという証明書を作成します。この証明書の証明書チェーンには、3つの証明書が含まれています。 +\fB\-gencert\fRオプションを使用すると、証明書チェーンを作成できます。次の例では、\fBe1\fRという証明書を作成します。この証明書の証明書チェーンには、3つの証明書が含まれています。 .sp -次のコマンドは、\fIca\fR、\fIca1\fR、\fIca2\fRおよび\fIe1\fRの4つの鍵ペアを作成します。 +次のコマンドは、\fBca\fR、\fBca1\fR、\fBca2\fRおよび\fBe1\fRの4つの鍵ペアを作成します。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-alias ca \-dname CN=CA \-genkeypair -keytool \-alias ca1 \-dname CN=CA \-genkeypair -keytool \-alias ca2 \-dname CN=CA \-genkeypair -keytool \-alias e1 \-dname CN=E1 \-genkeypair +\fBkeytool \-alias ca \-dname CN=CA \-genkeypair\fR +\fBkeytool \-alias ca1 \-dname CN=CA \-genkeypair\fR +\fBkeytool \-alias ca2 \-dname CN=CA \-genkeypair\fR +\fBkeytool \-alias e1 \-dname CN=E1 \-genkeypair\fR + .fi .if n \{\ .RE .\} -次の2つのコマンドは、署名付き証明書のチェーンを作成します。\fIca\fRは\fIca1\fRに署名し、\fIca1\fRは\fIca2\fRに署名します。すべて自己発行です。 +次の2つのコマンドは、署名付き証明書のチェーンを作成します。\fBca\fRは\fBca1\fRに署名し、\fBca1\fRは\fBca2\fRに署名します。すべて自己発行です。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-alias ca1 \-certreq | - keytool \-alias ca \-gencert \-ext san=dns:ca1 | - keytool \-alias ca1 \-importcert - -keytool \-alias ca2 \-certreq | - $KT \-alias ca1 \-gencert \-ext san=dns:ca2 | - $KT \-alias ca2 \-importcert +\fBkeytool \-alias ca1 \-certreq |\fR +\fB keytool \-alias ca \-gencert \-ext san=dns:ca1 |\fR +\fB keytool \-alias ca1 \-importcert\fR + +\fBkeytool \-alias ca2 \-certreq |\fR +\fB $KT \-alias ca1 \-gencert \-ext san=dns:ca2 |\fR +\fB $KT \-alias ca2 \-importcert\fR + .fi .if n \{\ .RE .\} -次のコマンドは、証明書\fIe1\fRを作成してファイル\fIe1\&.cert\fRに格納します。この証明書は\fIca2\fRによって署名されます。その結果、\fIe1\fRの証明書チェーンには\fIca\fR、\fIca1\fRおよび\fIca2\fRが含まれることになります。 +次のコマンドは、証明書\fBe1\fRを作成してファイル\fBe1\&.cert\fRに格納します。この証明書は\fBca2\fRによって署名されます。その結果、\fBe1\fRの証明書チェーンには\fBca\fR、\fBca1\fRおよび\fBca2\fRが含まれることになります。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-alias e1 \-certreq | keytool \-alias ca2 \-gencert > e1\&.cert +\fBkeytool \-alias e1 \-certreq | keytool \-alias ca2 \-gencert > e1\&.cert\fR + .fi .if n \{\ .RE @@ -719,154 +724,155 @@ .PP \-genkeypair .RS 4 -\fI{\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-startdate value} {\-ext ext}* {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-startdate value} {\-ext ext}* {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp 鍵のペア(公開鍵および関連する秘密鍵)を生成します。公開鍵はX\&.509 v3自己署名証明書でラップされます。証明書は、単一の要素を持つ証明書チェーンとして格納されます。この証明書チェーンと秘密鍵は、aliasで特定される新しいキーストア・エントリに格納されます。 .sp -\fIkeyalg\fR値は鍵ペアの生成に使用するアルゴリズムを、\fIkeysize\fR値は生成する各鍵のサイズを、それぞれ指定します。\fIsigalg\fR値は、自己署名証明書に署名を付けるために使用するアルゴリズムを指定します。このアルゴリズムは\fIkeyalg\fR値と互換性がある必要があります。 +\fBkeyalg\fR値は鍵ペアの生成に使用するアルゴリズムを、\fBkeysize\fR値は生成する各鍵のサイズを、それぞれ指定します。\fBsigalg\fR値は、自己署名証明書に署名を付けるために使用するアルゴリズムを指定します。このアルゴリズムは\fBkeyalg\fR値と互換性がある必要があります。 .sp -\fIdname\fR値には、\fIalias\fR値に関連付け、自己署名証明書のissuerフィールドとsubjectフィールドとして使用するX\&.500識別名を指定します。コマンドラインで識別名を指定しなかった場合は、識別名の入力を求められます。 +\fBdname\fR値には、\fBalias\fR値に関連付け、自己署名証明書のissuerフィールドとsubjectフィールドとして使用するX\&.500識別名を指定します。コマンド行で識別名を指定しなかった場合は、識別名の入力を求められます。 .sp -\fIkeypass\fR値には、生成される鍵のペアのうち、秘密鍵を保護するのに使用するパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、\fI[Return]キー\fRを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\fIkeypass\fR値は、6文字以上にする必要があります。 +\fBkeypass\fR値には、生成される鍵のペアのうち、秘密鍵を保護するのに使用するパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\fBkeypass\fR値は、6文字以上にする必要があります。 .sp -\fIstartdate\fR値には、証明書の発行時刻を指定します。これは、X\&.509証明書の「Validity」フィールドの「Not Before」値とも呼ばれます。 +\fBstartdate\fR値には、証明書の発行時刻を指定します。これは、X\&.509証明書の「Validity」フィールドの「Not Before」値とも呼ばれます。 .sp オプションの値は、次の2つの形式のいずれかで設定できます。 .sp -\fI([+\-]nnn[ymdHMS])+\fR +\fB([+\-]nnn[ymdHMS])+\fR .sp -\fI[yyyy/mm/dd] [HH:MM:SS]\fR +\fB[yyyy/mm/dd] [HH:MM:SS]\fR .sp -最初の形式では、発行時刻は、指定される値の分、現在の時刻から移ります。指定される値は、一連の下位の値を連結したものになります。下位の各値で、プラス記号(「+」)は時間が進むことを、マイナス記号(「\-」)は時間が戻ることを意味しています。移る時間は\fInnn\fRで、単位は年、月、日、時間、分または秒です(それぞれ、1文字の\fIy\fR、\fIm\fR、\fId\fR、\fIH\fR、\fIM\fRまたは\fIS\fR」で示されています)。下位の各値で\fIjava\&.util\&.GregorianCalendar\&.add(int field, int amount)\fRメソッドを使用することで、発行時刻の追加の値が左から右へ計算されます。たとえば、指定すると、発行時刻は次のようになります。 +最初の形式では、発行時刻は、指定される値の分、現在の時刻から移ります。指定される値は、一連の下位の値を連結したものになります。下位の各値で、プラス記号(「+」)は時間が進むことを、マイナス記号(「\-」)は時間が戻ることを意味しています。移る時間は\fBnnn\fRで、単位は年、月、日、時間、分または秒です(それぞれ、1文字の\fBy\fR、\fBm\fR、\fBd\fR、\fBH\fR、\fBM\fRまたは\fBS\fR」で示されています)。下位の各値で\fBjava\&.util\&.GregorianCalendar\&.add(int field, int amount)\fRメソッドを使用することで、発行時刻の追加の値が左から右へ計算されます。たとえば、指定すると、発行時刻は次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -Calendar c = new GregorianCalendar(); -c\&.add(Calendar\&.YEAR, \-1); -c\&.add(Calendar\&.MONTH, 1); -c\&.add(Calendar\&.DATE, \-1); -return c\&.getTime() +\fBCalendar c = new GregorianCalendar();\fR +\fBc\&.add(Calendar\&.YEAR, \-1);\fR +\fBc\&.add(Calendar\&.MONTH, 1);\fR +\fBc\&.add(Calendar\&.DATE, \-1);\fR +\fBreturn c\&.getTime()\fR + .fi .if n \{\ .RE .\} -2番目の形式では、ユーザーは、年/月/日と時間:分:秒の2つの部分で厳密な開始時刻を設定します(地元の時間帯を使用)。ユーザーは、1つの部分のみを指定できます。これは、もう1つの部分は現在の日付(または時刻)と同じになるということです。ユーザーは、形式の定義に示されているように、桁数を厳密に指定する必要があります(短い場合は0で埋めます)。日付と時刻の両方が指定された状態で、2つの部分の間に空白文字が1つ(1つのみ)あります。時間は常に24時間形式で指定してください。 +2番目の形式では、ユーザーは、年/月/日と時間:分:秒の2つの部分からなる正確な発行時刻を設定します(ローカルのタイム・ゾーンを使用)。ユーザーは、1つの部分のみを指定できます。これは、もう1つの部分は現在の日付(または時刻)と同じになるということです。ユーザーは、形式の定義に示されているように、桁数を厳密に指定する必要があります(短い場合は0で埋めます)。日付と時刻の両方が指定された状態で、2つの部分の間に空白文字が1つ(1つのみ)あります。時間は常に24時間形式で指定してください。 .sp オプションを指定しないと、開始日付は現在の時刻になります。オプションは、最大で1回指定できます。 .sp -\fIvalDays\fRの値には、証明書の有効日数を指定します(\fI\-startdate\fRで指定された日付、または\fI\-startdate\fRが指定されていない場合は現在の日付から始まります)。 +\fBvalDays\fRの値には、証明書の有効日数を指定します(\fB\-startdate\fRで指定された日付、または\fB\-startdate\fRが指定されていない場合は現在の日付から始まります)。 .sp -このコマンドは、以前のリリースでは\fI\-genkey\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fI\-genkeypair\fRが優先されます。 +このコマンドは、以前のリリースでは\fB\-genkey\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fB\-genkeypair\fRが優先されます。 .RE .PP \-genseckey .RS 4 -\fI\-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB\-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -秘密鍵を生成し、それを新しい\fIKeyStore\&.SecretKeyEntry\fR(\fIalias\fRで特定される)内に格納します。 +秘密鍵を生成し、それを新しい\fBKeyStore\&.SecretKeyEntry\fR(\fBalias\fRで特定される)内に格納します。 .sp -\fIkeyalg\fR値は鍵ペアの生成に使用するアルゴリズムを、\fIkeysize\fR値は生成する各鍵のサイズを、それぞれ指定します。\fIkeypass\fR値は、秘密鍵を保護するパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、\fIkeystore\fRのパスワードと同じパスワードが鍵のパスワードに設定されます。\fIkeypass\fR値は、6文字以上にする必要があります。 +\fBkeyalg\fR値は鍵ペアの生成に使用するアルゴリズムを、\fBkeysize\fR値は生成する各鍵のサイズを、それぞれ指定します。\fBkeypass\fR値は、秘密鍵を保護するパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、\fBkeystore\fRのパスワードと同じパスワードが鍵のパスワードに設定されます。\fBkeypass\fR値は、6文字以上にする必要があります。 .RE .PP \-importcert .RS 4 -\fI\-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB\-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -ファイル\fIcert_file\fRから証明書または証明書チェーン(証明書チェーンの場合は、PKCS#7形式の応答または一連のX\&.509証明書で提供されるもの)を読み込み、\fIalias\fRによって特定される\fIkeystore\fRエントリに格納します。ファイルが指定されていない場合は、\fIstdin\fRから証明書または証明書チェーンを読み込みます。 +ファイル\fBcert_file\fRから証明書または証明書チェーン(証明書チェーンの場合は、PKCS#7形式の応答または一連のX\&.509証明書で提供されるもの)を読み込み、\fBalias\fRによって特定される\fBkeystore\fRエントリに格納します。ファイルが指定されていない場合は、\fBstdin\fRから証明書または証明書チェーンを読み込みます。 .sp -\fIkeytool\fRコマンドでは、X\&.509 v1、v2、v3の証明書、およびPKCS#7形式の証明書から構成されているPKCS#7形式の証明書チェーンをインポートできます。インポートするデータは、バイナリ符号化方式、または出力可能符号化方式(Base64符号化とも呼ばれる)のどちらかで提供する必要があります。出力可能符号化方式は、インターネットRFC 1421証明書符号化規格で定義されています。この符号化方式の場合、証明書は\fI\-\fR\fI\-\-\-\-BEGIN\fRで始まる文字列で開始され、\fI\-\-\-\-\-END\fRで始まる文字列で終了する必要があります。 +\fBkeytool\fRコマンドでは、X\&.509 v1、v2、v3の証明書、およびPKCS#7形式の証明書から構成されているPKCS#7形式の証明書チェーンをインポートできます。インポートするデータは、バイナリ符号化方式、または出力可能符号化方式(Base64符号化とも呼ばれる)のどちらかで提供する必要があります。出力可能符号化方式は、インターネットRFC 1421証明書符号化規格で定義されています。この符号化方式の場合、証明書は\fB\-\fR\fB\-\-\-\-BEGIN\fRで始まる文字列で開始され、\fB\-\-\-\-\-END\fRで始まる文字列で終了する必要があります。 .sp -証明書は、信頼できる証明書のリストに追加するため、および認証局(CA)に証明書署名リクエストを送信した結果としてCAから受信した証明書応答をインポートするため(コマンドの\fI\-certreq\fRオプションを参照)という2つの理由でインポートします。 +証明書は、信頼できる証明書のリストに追加するため、および認証局(CA)に証明書署名リクエストを送信した結果としてCAから受信した証明書応答をインポートするため(\fBの\fR\-certreqコマンドオプションを参照)という2つの理由でインポートします。 .sp -どちらのタイプのインポートを行うかは、\fI\-alias\fRオプションの値によって指定します。別名がキー・エントリをポイントしない場合、\fIkeytool\fRコマンドはユーザーが信頼できる証明書エントリを追加しようとしているものとみなします。この場合、別名がキーストア内に存在していないことが必要です。別名がすでに存在している場合、その別名の信頼できる証明書がすでに存在することになるので、\fIkeytool\fRコマンドはエラーを出力し、証明書のインポートを行いません。別名がキー・エントリをポイントする場合、\fIkeytool\fRコマンドはユーザーが証明書応答をインポートしようとしているものとみなします。 +どちらのタイプのインポートを行うかは、\fB\-alias\fRオプションの値によって指定します。別名がキー・エントリをポイントしない場合、\fBkeytool\fRコマンドはユーザーが信頼できる証明書エントリを追加しようとしているものとみなします。この場合、別名がキーストア内に存在していないことが必要です。別名がすでに存在している場合、その別名の信頼できる証明書がすでに存在することになるので、\fBkeytool\fRコマンドはエラーを出力し、証明書のインポートを行いません。別名がキー・エントリをポイントする場合、\fBkeytool\fRコマンドはユーザーが証明書応答をインポートしようとしているものとみなします。 .RE .PP \-importpassword .RS 4 -\fI{\-alias alias} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -パスフレーズをインポートし、\fIalias\fRで識別される新規\fIKeyStore\&.SecretKeyEntry\fRに格納します。パスフレーズは、標準入力ストリームを介して提供できます。または、ユーザーにそのプロンプトが表示されます。\fIkeypass\fRは、インポートされるパスフレーズの保護に使用されるパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、\fIkeystore\fRのパスワードと同じパスワードが鍵のパスワードに設定されます。\fIkeypass\fRは、6文字以上にする必要があります。 +パスフレーズをインポートし、\fBalias\fRで識別される新規\fBKeyStore\&.SecretKeyEntry\fRに格納します。パスフレーズは、標準入力ストリームを介して提供できます。または、ユーザーにそのプロンプトが表示されます。\fBkeypass\fRは、インポートされるパスフレーズの保護に使用されるパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、\fBkeystore\fRのパスワードと同じパスワードが鍵のパスワードに設定されます。\fBkeypass\fRは、6文字以上にする必要があります。 .RE .PP \-importkeystore .RS 4 -\fI{\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] } [\-destkeypass destkeypass] {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] } [\-destkeypass destkeypass] {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp ソース・キーストアからターゲット・キーストアへ、単一のエントリまたはすべてのエントリをインポートします。 .sp -\fI\-srcalias\fRオプションが指定された場合、このコマンドは、その別名で特定される単一のエントリをターゲット・キーストアにインポートします。\fIdestalias\fR経由でターゲット別名が指定されなかった場合、\fIsrcalias\fRがターゲット別名として使用されます。ソースのエントリがパスワードで保護されていた場合、\fIsrckeypass\fRを使用してそのエントリが回復されます。\fIsrckeypass\fRが指定されなかった場合、\fIkeytool\fRコマンドは\fIsrcstorepass\fRを使用してそのエントリを回復しようとします。\fIsrcstorepass\fRが指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ターゲットのエントリは\fIdestkeypass\fRによって保護されます。\fIdestkeypass\fRが指定されなかった場合、ターゲット・エントリはソース・エントリのパスワードによって保護されます。たとえば、ほとんどのサード・パーティ・ツールでは、PKCS #12キーストアで\fIstorepass\fRと\fIkeypass\fRが同じである必要があります。これらのツールのPKCS #12キーストアを作成する場合は、常に\fI\-destkeypass\fRと\fI\-deststorepass\fRが同じになるように指定します。 +\fB\-srcalias\fRオプションが指定された場合、このコマンドは、その別名で特定される単一のエントリをターゲット・キーストアにインポートします。\fBdestalias\fR経由でターゲット別名が指定されなかった場合、\fBsrcalias\fRがターゲット別名として使用されます。ソースのエントリがパスワードで保護されていた場合、\fBsrckeypass\fRを使用してそのエントリが回復されます。\fIsrckeypass\fRが指定されなかった場合、\fBkeytool\fRコマンドは\fBsrcstorepass\fRを使用してそのエントリを回復しようとします。\fBsrcstorepass\fRが指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ターゲットのエントリは\fBdestkeypass\fRによって保護されます。\fBdestkeypass\fRが指定されなかった場合、ターゲット・エントリはソース・エントリのパスワードによって保護されます。たとえば、ほとんどのサード・パーティ・ツールでは、PKCS #12キーストアで\fBstorepass\fRと\fBkeypass\fRが同じである必要があります。これらのツールのPKCS #12キーストアを作成する場合は、常に\fB\-destkeypass\fRと\fB\-deststorepass\fRが同じになるように指定します。 .sp -\fI\-srcalias\fRオプションが指定されなかった場合、ソース・キーストア内のすべてのエントリがターゲット・キーストア内にインポートされます。各ターゲット・エントリは対応するソース・エントリの別名の下に格納されます。ソースのエントリがパスワードで保護されていた場合、\fIsrcstorepass\fRを使用してそのエントリが回復されます。\fIsrcstorepass\fRが指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ソース・キーストア内のあるエントリ・タイプがターゲット・キーストアでサポートされていない場合や、あるエントリをターゲット・キーストアに格納する際にエラーが発生した場合、ユーザーはそのエントリをスキップして処理を続行するか、あるいは処理を中断するかの選択を求められます。ターゲット・エントリはソース・エントリのパスワードによって保護されます。 +\fB\-srcalias\fRオプションが指定されなかった場合、ソース・キーストア内のすべてのエントリがターゲット・キーストア内にインポートされます。各ターゲット・エントリは対応するソース・エントリの別名の下に格納されます。ソースのエントリがパスワードで保護されていた場合、\fBsrcstorepass\fRを使用してそのエントリが回復されます。\fBsrcstorepass\fRが指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ソース・キーストア内のあるエントリ・タイプがターゲット・キーストアでサポートされていない場合や、あるエントリをターゲット・キーストアに格納する際にエラーが発生した場合、ユーザーはそのエントリをスキップして処理を続行するか、または中止するかの選択を求められます。ターゲット・エントリはソース・エントリのパスワードによって保護されます。 .sp ターゲット別名がターゲット・キーストア内にすでに存在していた場合、ユーザーは、そのエントリを上書きするか、あるいは異なる別名の下で新しいエントリを作成するかの選択を求められます。 .sp -\fI\-noprompt\fRオプションを指定した場合、ユーザーは新しいターゲット別名の入力を求められません。既存のエントリがそのターゲット別名で上書きされます。インポートできないエントリはスキップされ、警告が出力されます。 +\fB\-noprompt\fRオプションを指定した場合、ユーザーは新しいターゲット別名の入力を求められません。既存のエントリがそのターゲット別名で上書きされます。インポートできないエントリはスキップされ、警告が出力されます。 .RE .PP \-printcertreq .RS 4 -\fI{\-file file}\fR +\fB{\-file file}\fR .sp -PKCS#10形式の証明書リクエストの内容を出力します。このリクエストは、\fIkeytool\fR -\fI\-certreq\fRコマンドで生成できます。このコマンドは、ファイルからリクエストを読み取ります。ファイルが存在しない場合、リクエストは標準入力から読み取られます。 +PKCS#10形式の証明書リクエストの内容を出力します。このリクエストは、\fBkeytool\fR +\fB\-certreq\fRコマンドで生成できます。このコマンドは、ファイルからリクエストを読み取ります。ファイルが存在しない場合、リクエストは標準入力から読み取られます。 .RE .PP \-certreq .RS 4 -\fI{\-alias alias} {\-dname dname} {\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} {\-dname dname} {\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp PKCS#10形式を使用して証明書署名リクエスト(CSR)を生成します。 .sp CSRは、証明書発行局(CA)に送信することを目的としたものです。CAは、証明書要求者を(通常はオフラインで)認証し、証明書または証明書チェーンを送り返します。この証明書または証明書チェーンは、キーストア内の既存の証明書チェーン(最初は1つの自己署名証明書から構成される)に置き換えて使用します。 .sp -aliasに関連付けられた秘密鍵は、PKCS#10証明書リクエストを作成するのに使用されます。秘密鍵にアクセスするには、正しいパスワードを指定する必要があります。コマンドラインで\fIkeypass\fRを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。\fIdname\fRが指定されている場合は、それがCSRで主体として使用されます。それ以外の場合は、別名に関連付けられたX\&.500識別名が使用されます。 +aliasに関連付けられた秘密鍵は、PKCS#10証明書リクエストを作成するのに使用されます。秘密鍵にアクセスするには、正しいパスワードを指定する必要があります。コマンド行で\fBkeypass\fRを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。\fBdname\fRが指定されている場合は、それがCSRで主体として使用されます。それ以外の場合は、別名に関連付けられたX\&.500識別名が使用されます。 .sp -\fIsigalg\fR値には、CSRに署名を付けるときに使用するアルゴリズムを指定します。 +\fBsigalg\fR値には、CSRに署名を付けるときに使用するアルゴリズムを指定します。 .sp -CSRは、ファイルcertreq_fileに格納されます。ファイルが指定されていない場合は、\fIstdout\fRにCSRが出力されます。 +CSRは、ファイルcertreq_fileに格納されます。ファイルが指定されていない場合は、\fBstdout\fRにCSRが出力されます。 .sp -CAからのレスポンスをインポートするには、\fIimportcert\fRコマンドを使用します。 +CAからのレスポンスをインポートするには、\fBimportcert\fRコマンドを使用します。 .RE .PP \-exportcert .RS 4 -\fI{\-alias alias} {\-file cert_file} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-rfc} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} {\-file cert_file} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-rfc} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -\fIalias\fRに関連付けられた証明書をキーストアから読み込み、ファイルcert_fileに格納します。ファイルが指定されていない場合は、\fIstdout\fRに証明書が出力されます。 +\fIalias\fRに関連付けられた証明書をキーストアから読み込み、ファイルcert_fileに格納します。ファイルが指定されていない場合は、\fBstdout\fRに証明書が出力されます。 .sp -デフォルトでは、証明書はバイナリ符号化で出力されます。\fI\-rfc\fRオプションが指定されている場合、出力可能符号化方式の出力はインターネットRFC 1421証明書符号化規格で定義されます。 +デフォルトでは、証明書はバイナリ符号化で出力されます。\fB\-rfc\fRオプションが指定されている場合、出力可能符号化方式の出力はインターネットRFC 1421証明書符号化規格で定義されます。 .sp -\fIalias\fRが、信頼できる証明書を参照している場合は、該当する証明書が出力されます。それ以外の場合、\fIalias\fRは、関連付けられた証明書チェーンを持つ鍵エントリを参照します。この場合は、チェーン内の最初の証明書が返されます。この証明書は、\fIalias\fRによって表されるエンティティの公開鍵を認証する証明書です。 +\fBalias\fRが、信頼できる証明書を参照している場合は、該当する証明書が出力されます。それ以外の場合、\fBalias\fRは、関連付けられた証明書チェーンを持つ鍵エントリを参照します。この場合は、チェーン内の最初の証明書が返されます。この証明書は、\fBalias\fRによって表されるエンティティの公開鍵を認証する証明書です。 .sp -このコマンドは、以前のリリースでは\fI\-export\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fI\-exportcert\fRが優先されます。 +このコマンドは、以前のリリースでは\fB\-export\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fB\-exportcert\fRが優先されます。 .RE .PP \-list .RS 4 -\fI{\-alias alias} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v | \-rfc} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v | \-rfc} {\-protected} {\-Jjavaoption}\fR .sp -\fIalias\fRで特定されるキーストア・エントリの内容を\fIstdout\fRに出力します。\fIalias\fRが指定されていない場合は、キーストア全体の内容が表示されます。 +\fBalias\fRで特定されるキーストア・エントリの内容を\fBstdout\fRに出力します。\fBalias\fRが指定されていない場合は、キーストア全体の内容が表示されます。 .sp このコマンドは、デフォルトでは証明書のSHA1フィンガープリントを表示します。 -\fI\-v\fRオプションが指定されている場合は、所有者、発行者、シリアル番号、拡張機能などの付加的な情報とともに、人間が読むことのできる形式で証明書が表示されます。\fI\-rfc\fRオプションが指定されている場合は、出力可能符号化方式で証明書の内容が出力されます。出力可能符号化方式は、インターネットRFC 1421証明書符号化規格で定義されています。 +\fB\-v\fRオプションが指定されている場合は、所有者、発行者、シリアル番号、拡張機能などの付加的な情報とともに、人間が読むことのできる形式で証明書が表示されます。\fB\-rfc\fRオプションが指定されている場合は、出力可能符号化方式で証明書の内容が出力されます。出力可能符号化方式は、インターネットRFC 1421証明書符号化規格で定義されています。 .sp -\fI\-v\fRオプションと\fI\-rfc\fRオプションを同時に指定することはできません。 +\fB\-v\fRオプションと\fB\-rfc\fRオプションを同時に指定することはできません。 .RE .PP \-printcert .RS 4 -\fI{\-file cert_file | \-sslserver host[:port]} {\-jarfile JAR_file {\-rfc} {\-v} {\-Jjavaoption}\fR +\fB{\-file cert_file | \-sslserver host[:port]} {\-jarfile JAR_file {\-rfc} {\-v} {\-Jjavaoption}\fR .sp -ファイルcert_file、host:portにあるSSLサーバー、または署名付きJARファイル\fIJAR_file\fR(\fI\-jarfile\fRオプションを指定)から証明書を読み込み、人間が読むことのできる形式で証明書の内容を表示します。ポートが指定されていない場合は、標準のHTTPSポート443が想定されます。\fI\-sslserver\fRおよび\-fileオプションを同時に指定することはできません。これに反する場合、エラーが報告されます。オプションが指定されていない場合は、\fIstdin\fRから証明書を読み込みます。 +ファイルcert_file、host:portにあるSSLサーバー、または署名付きJARファイル\fBJAR_file\fR(\fB\-jarfile\fRオプションを指定)から証明書を読み込み、人間が読むことのできる形式で証明書の内容を表示します。ポートが指定されていない場合は、標準のHTTPSポート443が想定されます。\fB\-sslserver\fRおよび\-fileオプションを同時に指定することはできません。それ以外の場合、エラーが報告されます。オプションが指定されていない場合は、\fBstdin\fRから証明書を読み込みます。 .sp -\fI\-rfc\fRが指定されている場合、\fIkeytool\fRコマンドは、インターネットRFC 1421証明書符号化標準で定義されているように、PEMモードで証明書を出力します。インターネットRFC 1421証明書符号化規格を参照してください。 +\fB\-rfc\fRが指定されている場合、\fBkeytool\fRコマンドは、インターネットRFC 1421証明書符号化標準で定義されているように、PEMモードで証明書を出力します。インターネットRFC 1421証明書符号化規格を参照してください。 .sp -ファイルまたは\fIstdin\fRから証明書を読み込む場合、その証明書は、インターネットRFC 1421証明書符号化標準で定義されているように、バイナリ符号化方式または出力可能符号化方式で表示できます。 +ファイルまたは\fBstdin\fRから証明書を読み込む場合、その証明書は、インターネットRFC 1421証明書符号化標準で定義されているように、バイナリ符号化方式または出力可能符号化方式で表示できます。 .sp -SSLサーバーがファイアウォールの背後にある場合は、\fI\-J\-Dhttps\&.proxyHost=proxyhost\fRおよび\fI\-J\-Dhttps\&.proxyPort=proxyport\fRオプションをコマンドラインで指定して、プロキシ・トンネリングを使用できます。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/jsse/JSSERefGuide\&.htmlの +SSLサーバーがファイアウォールの背後にある場合は、\fB\-J\-Dhttps\&.proxyHost=proxyhost\fRおよび\fB\-J\-Dhttps\&.proxyPort=proxyport\fRオプションをコマンド行で指定して、プロキシ・トンネリングを使用できます。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/jsse/JSSERefGuide\&.htmlの 「Java Secure Socket Extension (JSSE) Reference Guide」を参照してください .sp \fB注意:\fR @@ -875,9 +881,9 @@ .PP \-printcrl .RS 4 -\fI\-file crl_ {\-v}\fR +\fB\-file crl_ {\-v}\fR .sp -ファイル\fIcrl_\fRから証明書失効リスト(CRL)を読み込みます。CRLは、発行したCAによって失効されたデジタル証明書のリストです。CAは、\fIcrl_\fRを生成します。 +ファイル\fBcrl_\fRから証明書失効リスト(CRL)を読み込みます。CRLは、発行したCAによって失効されたデジタル証明書のリストです。CAは、\fBcrl_\fRを生成します。 .sp \fB注意:\fR このオプションはキーストアとは関係なく使用できます。 @@ -885,34 +891,34 @@ .PP \-storepasswd .RS 4 -\fI[\-new new_storepass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}\fR +\fB[\-new new_storepass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}\fR .sp -キーストアの内容の整合性を保護するために使用するパスワードを変更します。\fInew_storepass\fRには、新しいパスワードを指定します。new_storepassは、6文字以上である必要があります。 +キーストアの内容の整合性を保護するために使用するパスワードを変更します。\fBnew_storepass\fRには、新しいパスワードを指定します。new_storepassは、6文字以上である必要があります。 .RE .PP \-keypasswd .RS 4 -\fI{\-alias alias} [\-keypass old_keypass] [\-new new_keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}\fR +\fB{\-alias alias} [\-keypass old_keypass] [\-new new_keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}\fR .sp -\fIalias\fRによって特定される非公開/秘密鍵を保護するためのパスワードを、\fIold_keypass\fRから\fInew_keypass\fRに変更します。new_keypassは、6文字以上である必要があります。 +\fBalias\fRによって特定される非公開/秘密鍵を保護するためのパスワードを、\fBold_keypass\fRから\fBnew_keypass\fRに変更します。new_keypassは、6文字以上である必要があります。 .sp -コマンドラインで\fI\-keypass\fRオプションを指定しておらず、鍵のパスワードがキーストアのパスワードと異なる場合は、鍵のパスワードの入力を求められます。 +コマンド行で\fB\-keypass\fRオプションを指定しておらず、鍵のパスワードがキーストアのパスワードと異なる場合は、鍵のパスワードの入力を求められます。 .sp -コマンドラインで\fI\-new\fRオプションを指定しなかった場合は、新しいパスワードの入力を求められます。 +コマンド行で\fB\-new\fRオプションを指定しなかった場合は、新しいパスワードの入力を求められます。 .RE .PP \-delete .RS 4 -\fI[\-alias alias] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB[\-alias alias] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -\fIalias\fRによって特定されるエントリをキーストアから削除します。コマンドラインで別名を指定しなかった場合は、別名の入力を求められます。 +\fBalias\fRによって特定されるエントリをキーストアから削除します。コマンド行で別名を指定しなかった場合は、別名の入力を求められます。 .RE .PP \-changealias .RS 4 -\fI{\-alias alias} [\-destalias destalias] [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} [\-destalias destalias] [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -指定された\fIalias\fRから新しい別名\fIdestalias\fRへ、既存のキーストア・エントリを移動します。ターゲット別名を指定しなかった場合、ターゲット別名の入力を求められます。元のエントリがエントリ・パスワードで保護されていた場合、\fI\-keypass\fRオプションでそのパスワードを指定できます。鍵パスワードが指定されなかった場合、\fIstorepass\fR(指定された場合)がまず試みられます。その試みが失敗すると、ユーザーはパスワードの入力を求められます。 +指定された\fBalias\fRから新しい別名\fBdestalias\fRへ、既存のキーストア・エントリを移動します。ターゲット別名を指定しなかった場合、ターゲット別名の入力を求められます。元のエントリがエントリ・パスワードで保護されていた場合、\fB\-keypass\fRオプションでそのパスワードを指定できます。鍵パスワードが指定されなかった場合、\fBstorepass\fR(指定された場合)がまず試みられます。その試みが失敗すると、ユーザーはパスワードの入力を求められます。 .RE .PP \-help @@ -920,7 +926,7 @@ 基本的なコマンドとそのオプションの一覧を表示します。 .sp 特定のコマンドの詳細を参照するには、次のように入力してください: -\fIkeytool \-command_name \-help\fR。\fIcommand_name\fRはコマンドの名前です。 +\fBkeytool \-command_name \-help\fR。\fBcommand_name\fRはコマンドの名前です。 .RE .SH "例" .PP @@ -933,18 +939,19 @@ .RS 4 .\} .nf -keytool \-genkeypair \-dname "cn=Mark Jones, ou=Java, o=Oracle, c=US" - \-alias business \-keypass <new password for private key> - \-keystore /working/mykeystore - \-storepass <new password for keystore> \-validity 180 +\fBkeytool \-genkeypair \-dname "cn=Mark Jones, ou=Java, o=Oracle, c=US"\fR +\fB \-alias business \-keypass <new password for private key>\fR +\fB \-keystore /working/mykeystore\fR +\fB \-storepass <new password for keystore> \-validity 180\fR + .fi .if n \{\ .RE .\} .PP -コマンドは、workingディレクトリに\fImykeystore\fRという名前のキーストアを作成し(キーストアはまだ存在していないと仮定)、作成したキーストアに、\fI<new password for keystore>\fRで指定したパスワードを割り当てます。生成する公開鍵と秘密鍵のペアに対応するエンティティの「識別名」は、通称がMark Jones、組織単位がJava、組織がOracle、2文字の国番号がUSです。公開鍵と秘密鍵のサイズはどちらも1024ビットで、鍵の作成にはデフォルトのDSA鍵生成アルゴリズムを使用します。 +コマンドは、workingディレクトリに\fBmykeystore\fRという名前のキーストアを作成し(キーストアはまだ存在していないと仮定)、作成したキーストアに、\fB<new password for keystore>\fRで指定したパスワードを割り当てます。生成する公開鍵と秘密鍵のペアに対応するエンティティの「識別名」は、通称がMark Jones、組織単位がJava、組織がOracle、2文字の国番号がUSです。公開鍵と秘密鍵のサイズはどちらも1024ビットで、鍵の作成にはデフォルトのDSA鍵生成アルゴリズムを使用します。 .PP -このコマンドは、デフォルトのSHA1withDSA署名アルゴリズムを使用して、公開鍵と識別名情報を含む自己署名証明書を作成します。証明書の有効期間は180日です。証明書は、別名\fIbusiness\fRで特定されるキーストア・エントリ内の秘密鍵に関連付けられます。秘密鍵には、\fI<new password for private key>\fRで指定したパスワードが割り当てられます。 +このコマンドは、デフォルトのSHA1withDSA署名アルゴリズムを使用して、公開鍵と識別名情報を含む自己署名証明書を作成します。証明書の有効期間は180日です。証明書は、別名\fBbusiness\fRで特定されるキーストア・エントリ内の秘密鍵に関連付けられます。秘密鍵には、\fB<new password for private key>\fRで指定したパスワードが割り当てられます。 .PP オプションのデフォルト値を使用する場合、コマンドは大幅に短くなります。この場合、オプションは不要です。デフォルト値を持つオプションでは、オプションを指定しなければデフォルト値が使用されます。必須値の入力を求められます。使用可能な値は次のとおりです。 .sp @@ -952,15 +959,16 @@ .RS 4 .\} .nf -keytool \-genkeypair +\fBkeytool \-genkeypair\fR + .fi .if n \{\ .RE .\} .PP -この場合は、\fImykey\fRという別名でキーストア・エントリが作成され、新しく生成された鍵のペア、および90日間有効な証明書がこのエントリに格納されます。このエントリは、ホーム・ディレクトリ内の\fI\&.keystore\fRという名前のキーストアに置かれます。キーストアは、まだ存在していない場合に作成されます。識別名情報、キーストアのパスワードおよび秘密鍵のパスワードの入力を求められます。 +この場合は、\fBmykey\fRという別名でキーストア・エントリが作成され、新しく生成された鍵のペア、および90日間有効な証明書がこのエントリに格納されます。このエントリは、ホーム・ディレクトリ内の\fB\&.keystore\fRという名前のキーストアに置かれます。キーストアは、まだ存在していない場合に作成されます。識別名情報、キーストアのパスワードおよび秘密鍵のパスワードの入力を求められます。 .PP -以降では、オプションを指定しないで\fI\-genkeypair\fRコマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した\fI\-genkeypair\fRコマンドの値を入力したものとします。たとえば識別名には\fIcn=Mark Jones\fR、\fIou=Java\fR、\fIo=Oracle\fR、\fIc=US\fRと指定します。 +以降では、オプションを指定しないで\fB\-genkeypair\fRコマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した\fB\-genkeypair\fRコマンドの値を入力したものとします。たとえば識別名には\fBcn=Mark Jones\fR、\fBou=Java\fR、\fBo=Oracle\fR、\fBc=US\fRと指定します。 .SS "CAからの署名付き証明書のリクエスト" .PP 自己署名証明書を作成する鍵のペアの生成。証明書に証明書発行局(CA)の署名が付いていれば、他のユーザーから証明書が信頼される可能性も高くなります。CAの署名を取得するには、まず、証明書署名リクエスト(CSR)を生成します。たとえば、次のようにします。 @@ -969,18 +977,19 @@ .RS 4 .\} .nf -keytool \-certreq \-file MarkJ\&.csr +\fBkeytool \-certreq \-file MarkJ\&.csr\fR + .fi .if n \{\ .RE .\} .PP -CSR(デフォルト別名\fImykey\fRによって特定されるエンティティのCSR)が作成され、MarkJ\&.csrという名前のファイルに置かれます。このファイルをCA (VeriSignなど)に提出します。CAは要求者を(通常はオフラインで)認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CAが証明書のチェーンを返すこともあります。証明書のチェーンでは、各証明書がチェーン内のその前の署名者の公開鍵を認証します。 +CSR(デフォルト別名\fBmykey\fRによって特定されるエンティティのCSR)が作成され、MarkJ\&.csrという名前のファイルに置かれます。このファイルをCA (VeriSignなど)に提出します。CAは要求者を(通常はオフラインで)認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CAが証明書のチェーンを返すこともあります。証明書のチェーンでは、各証明書がチェーン内のその前の署名者の公開鍵を認証します。 .SS "CAからの証明書のインポート" .PP 作成した自己署名証明書は、証明書チェーンで置き換える必要があります。証明書チェーンでは、各証明書が、「ルート」CAを起点とするチェーン内の次の証明書の署名者の公開鍵を認証します。 .PP -CAからの証明書応答をインポートするには、キーストアか、\fIcacerts\fRキーストア・ファイル内に1つ以上の信頼できる証明書がある必要があります。\fIの\fR\-importcertコマンドを参照してください。 +CAからの証明書応答をインポートするには、キーストアか、\fBcacerts\fRキーストア・ファイル内に1つ以上の信頼できる証明書がある必要があります。コマンドの\fB\-importcert\fRを参照してください。 .sp .RS 4 .ie n \{\ @@ -1004,9 +1013,9 @@ 証明書応答が単一の証明書の場合は、発行CA(署名した)の証明書が必要です。その証明書が自己署名でない場合は、その署名者の証明書が必要であり、このようにして自己署名ルート証明書が必要になります。 .RE .PP -\fIcacerts\fRキーストア・ファイルは、いくつかのVeriSignルートCA証明書を含んだ状態で出荷されているので、VeriSignの証明書を、信頼できる証明書としてキーストア内にインポートする必要がない場合があります。ただし、他のCAに対して署名付き証明書をリクエストしていて、このCAの公開鍵を認証する証明書が、\fIcacerts\fRにまだ追加されていない場合は、該当するCAからの証明書を、「信頼できる証明書」としてインポートする必要があります。 +\fBcacerts\fRキーストア・ファイルは、いくつかのVeriSignルートCA証明書を含んだ状態で出荷されているので、VeriSignの証明書を、信頼できる証明書としてキーストア内にインポートする必要がない場合があります。ただし、他のCAに対して署名付き証明書をリクエストしていて、このCAの公開鍵を認証する証明書が、\fBcacerts\fRにまだ追加されていない場合は、該当するCAからの証明書を、「信頼できる証明書」としてインポートする必要があります。 .PP -通常、CAからの証明書は、自己署名証明書、または他のCAによって署名された証明書です(後者の場合は、該当する他のCAの公開鍵を認証する証明書が必要)。ABC, Inc\&.,がCAで、ABCから自己署名証明書であるA\fIBCCA\&.cer\fRという名前のファイルを取得したとします(この証明書はCAの公開鍵を認証します)。信頼できる証明書として証明書をインポートするときは、証明書が有効であることを確認する必要があります。まず、\fIkeytool \-printcert\fRコマンドまたは\fI\-noprompt\fRオプションなしの\fIkeytool \-importcert\fRコマンドでそれを表示し、表示された証明書のフィンガープリントが期待されるものと一致するかどうかを確認します。証明書を送信した人物に連絡し、この人物が提示した(または安全な公開鍵のリポジトリによって提示される)フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中で他の何者か(攻撃者など)による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。 +通常、CAからの証明書は、自己署名証明書、または他のCAによって署名された証明書です(後者の場合は、該当する他のCAの公開鍵を認証する証明書が必要)。ABC, Inc\&.,がCAで、ABCから自己署名証明書であるA\fBBCCA\&.cer\fRという名前のファイルを取得したとします(この証明書はCAの公開鍵を認証します)。信頼できる証明書として証明書をインポートするときは、証明書が有効であることを確認する必要があります。まず、\fBkeytool \-printcert\fRコマンドまたは\fB\-noprompt\fRオプションなしの\fBkeytool \-importcert\fRコマンドでそれを表示し、表示された証明書のフィンガープリントが期待されるものと一致するかどうかを確認します。証明書を送信した人物に連絡し、この人物が提示した(またはセキュアな公開鍵のリポジトリによって提示される)フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中で他の何者か(攻撃者など)による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。 .PP 証明書が有効であると信頼する場合は、次のコマンドでキーストアに追加できます。 .sp @@ -1014,16 +1023,17 @@ .RS 4 .\} .nf -keytool \-importcert \-alias abc \-file ABCCA\&.cer +\fBkeytool \-importcert \-alias abc \-file ABCCA\&.cer\fR + .fi .if n \{\ .RE .\} .PP -ABCCA\&.cerファイルのデータを含む信頼できる証明書のエントリがキーストア内に作成され、該当するエントリに\fIabc\fRという別名が割り当てられます。 +ABCCA\&.cerファイルのデータを含む信頼できる証明書のエントリがキーストア内に作成され、該当するエントリに\fBabc\fRという別名が割り当てられます。 .SS "CAからの証明書応答のインポート" .PP -証明書署名リクエストの提出先のCAの公開鍵を認証する証明書をインポートした後は(または同種の証明書がすでにcacertsファイル内に存在している場合は)、証明応答をインポートし、自己署名証明書を証明書チェーンで置き換えることができます。このチェーンは、CAの応答がチェーンの場合に、リクエストに対するレスポンスとしてCAから送り返された証明書チェーンです。また、CAの応答が単一の証明書の場合は、この証明応答と、インポート先のキーストア内または\fIcacerts\fRキーストアファイル内にすでに存在する信頼できる証明書とを使用して構築した証明書チェーンです。 +証明書署名リクエストの提出先のCAの公開鍵を認証する証明書をインポートした後は(または同種の証明書がすでにcacertsファイル内に存在している場合は)、証明応答をインポートし、自己署名証明書を証明書チェーンで置き換えることができます。このチェーンは、CAの応答がチェーンの場合に、リクエストに対するレスポンスとしてCAから送り返された証明書チェーンです。また、CAの応答が単一の証明書の場合は、この証明応答と、インポート先のキーストア内または\fBcacerts\fRキーストアファイル内にすでに存在する信頼できる証明書とを使用して構築した証明書チェーンです。 .PP たとえば、証明書署名リクエストをVeriSignに送信する場合、送り返された証明書の名前がVSMarkJ\&.cerだとすると、次のようにして応答をインポートできます。 .sp @@ -1031,31 +1041,33 @@ .RS 4 .\} .nf -keytool \-importcert \-trustcacerts \-file VSMarkJ\&.cer +\fBkeytool \-importcert \-trustcacerts \-file VSMarkJ\&.cer\fR + .fi .if n \{\ .RE .\} .SS "公開鍵を認証する証明書のエクスポート" .PP -\fIjarsigner\fRコマンドを使用してJava Archive (JAR)ファイルに署名する場合、このファイルを使用するクライアントは署名を認証する必要があります。クライアントが署名を認証する方法の1つに、まず自分の公開鍵の証明書を信頼できるエントリとしてクライアントのキーストアにインポートする方法があります。 +\fBjarsigner\fRコマンドを使用してJava Archive (JAR)ファイルに署名する場合、このファイルを使用するクライアントは署名を認証する必要があります。クライアントが署名を認証する方法の1つに、まず自分の公開鍵の証明書を信頼できるエントリとしてクライアントのキーストアにインポートする方法があります。 .PP -そのためには、証明書をエクスポートして、クライアントに提供します。例として、次のコマンドを使用して、MJ\&.cerという名前のファイルに証明書をコピーできます。このコマンドでは、エントリに別名\fImykey\fRがあると仮定しています。 +そのためには、証明書をエクスポートして、クライアントに提供します。例として、次のコマンドを使用して、MJ\&.cerという名前のファイルに証明書をコピーできます。このコマンドでは、エントリに別名\fBmykey\fRがあると仮定しています。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-exportcert \-alias mykey \-file MJ\&.cer +\fBkeytool \-exportcert \-alias mykey \-file MJ\&.cer\fR + .fi .if n \{\ .RE .\} .PP -証明書と署名付きJARファイルを入手したクライアントは、\fIjarsigner\fRコマンドを使用して署名を認証できます。 +証明書と署名付きJARファイルを入手したクライアントは、\fBjarsigner\fRコマンドを使用して署名を認証できます。 .SS "キーストアのインポート" .PP -コマンド\fIimportkeystore\fRを使用すれば、あるキーストアの全体を別のキーストア内にインポートできます。これは、鍵や証明書といったソースキーストア内のすべてのエントリが、単一のコマンドを使用してターゲットキーストア内にインポートされることを意味します。このコマンドを使用すれば、異なるタイプのキーストア内に含まれるエントリをインポートすることができます。インポート時には、ターゲット・キーストア内の新しいエントリはすべて、元と同じ別名および(秘密鍵や秘密鍵の場合は)保護用パスワードを持ちます。ソースキーストア内の非公開/秘密鍵をリカバリできない場合、\fIkeytool\fRコマンドはユーザーにパスワードの入力を求めます。このコマンドは、別名の重複を検出すると、ユーザーに新しい別名の入力を求めます。ユーザーは、新しい別名を指定することも、単純に既存の別名の上書きを\fIkeytool\fRコマンドに許可することもできます。 +コマンド\fBimportkeystore\fRを使用すれば、あるキーストアの全体を別のキーストア内にインポートできます。これは、鍵や証明書といったソースキーストア内のすべてのエントリが、単一のコマンドを使用してターゲットキーストア内にインポートされることを意味します。このコマンドを使用すれば、異なるタイプのキーストア内に含まれるエントリをインポートすることができます。インポート時には、ターゲット・キーストア内の新しいエントリはすべて、元と同じ別名および(秘密鍵や秘密鍵の場合は)保護用パスワードを持ちます。ソースキーストア内の非公開/秘密鍵をリカバリできない場合、\fBkeytool\fRコマンドはユーザーにパスワードの入力を求めます。このコマンドは、別名の重複を検出すると、ユーザーに新しい別名の入力を求めます。ユーザーは、新しい別名を指定することも、単純に既存の別名の上書きを\fBkeytool\fRコマンドに許可することもできます。 .PP たとえば、通常のJKSタイプのキーストアkey\&.jks内のエントリをPKCS#11タイプのハードウェア・ベースのキーストア内にインポートするには、次のコマンドを使用します。 .sp @@ -1063,59 +1075,62 @@ .RS 4 .\} .nf -keytool \-importkeystore - \-srckeystore key\&.jks \-destkeystore NONE - \-srcstoretype JKS \-deststoretype PKCS11 - \-srcstorepass <src keystore password> - \-deststorepass <destination keystore pwd> +\fBkeytool \-importkeystore\fR +\fB \-srckeystore key\&.jks \-destkeystore NONE\fR +\fB \-srcstoretype JKS \-deststoretype PKCS11\fR +\fB \-srcstorepass <src keystore password>\fR +\fB \-deststorepass <destination keystore pwd>\fR + .fi .if n \{\ .RE .\} .PP -また、\fIimportkeystore\fRコマンドを使用すれば、あるソース・キーストア内の単一のエントリをターゲット・キーストアにインポートすることもできます。この場合は、前例のオプションに加えて、インポートする別名を指定する必要があります。\fI\-srcalias\fRオプションを指定する場合には、ターゲット別名もコマンドラインから指定できるほか、秘密/秘密鍵の保護用パスワードやターゲット保護用パスワードも指定できます。その方法を示すコマンドを次に示します。 +また、\fBimportkeystore\fRコマンドを使用すれば、あるソース・キーストア内の単一のエントリをターゲット・キーストアにインポートすることもできます。この場合は、前例のオプションに加えて、インポートする別名を指定する必要があります。\fB\-srcalias\fRオプションを指定する場合には、ターゲット別名もコマンド行から指定できるほか、秘密/秘密鍵の保護用パスワードやターゲット保護用パスワードも指定できます。その方法を示すコマンドを次に示します。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-importkeystore - \-srckeystore key\&.jks \-destkeystore NONE - \-srcstoretype JKS \-deststoretype PKCS11 - \-srcstorepass <src keystore password> - \-deststorepass <destination keystore pwd> - \-srcalias myprivatekey \-destalias myoldprivatekey - \-srckeypass <source entry password> - \-destkeypass <destination entry password> - \-noprompt +\fBkeytool \-importkeystore\fR +\fB \-srckeystore key\&.jks \-destkeystore NONE\fR +\fB \-srcstoretype JKS \-deststoretype PKCS11\fR +\fB \-srcstorepass <src keystore password>\fR +\fB \-deststorepass <destination keystore pwd>\fR +\fB \-srcalias myprivatekey \-destalias myoldprivatekey\fR +\fB \-srckeypass <source entry password>\fR +\fB \-destkeypass <destination entry password>\fR +\fB \-noprompt\fR + .fi .if n \{\ .RE .\} .SS "SSLサーバーの証明書の生成" .PP -次に、3つのエンティティ、つまりルートCA(\fIroot\fR)、中間CA(\fIca\fR)およびSSLサーバー(\fIserver\fR)用の鍵ペアと証明書を生成する\fIkeytool\fRコマンドを示します。すべての証明書を同じキーストアに格納するようにしてください。これらの例では、RSAが推奨される鍵のアルゴリズムです。 +次に、3つのエンティティ、つまりルートCA(\fBroot\fR)、中間CA(\fBca\fR)およびSSLサーバー(\fBserver\fR)用の鍵ペアと証明書を生成する\fBkeytool\fRコマンドを示します。すべての証明書を同じキーストアに格納するようにしてください。これらの例では、RSAが推奨される鍵のアルゴリズムです。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-genkeypair \-keystore root\&.jks \-alias root \-ext bc:c -keytool \-genkeypair \-keystore ca\&.jks \-alias ca \-ext bc:c -keytool \-genkeypair \-keystore server\&.jks \-alias server - -keytool \-keystore root\&.jks \-alias root \-exportcert \-rfc > root\&.pem +\fBkeytool \-genkeypair \-keystore root\&.jks \-alias root \-ext bc:c\fR +\fBkeytool \-genkeypair \-keystore ca\&.jks \-alias ca \-ext bc:c\fR +\fBkeytool \-genkeypair \-keystore server\&.jks \-alias server\fR +\fB \fR +\fBkeytool \-keystore root\&.jks \-alias root \-exportcert \-rfc > root\&.pem\fR +\fB \fR +\fBkeytool \-storepass <storepass> \-keystore ca\&.jks \-certreq \-alias ca |\fR +\fB keytool \-storepass <storepass> \-keystore root\&.jks\fR +\fB \-gencert \-alias root \-ext BC=0 \-rfc > ca\&.pem\fR +\fBkeytool \-keystore ca\&.jks \-importcert \-alias ca \-file ca\&.pem\fR +\fB \fR +\fBkeytool \-storepass <storepass> \-keystore server\&.jks \-certreq \-alias server |\fR +\fB keytool \-storepass <storepass> \-keystore ca\&.jks \-gencert \-alias ca\fR +\fB \-ext ku:c=dig,kE \-rfc > server\&.pem\fR +\fBcat root\&.pem ca\&.pem server\&.pem |\fR +\fB keytool \-keystore server\&.jks \-importcert \-alias server\fR -keytool \-storepass <storepass> \-keystore ca\&.jks \-certreq \-alias ca | - keytool \-storepass <storepass> \-keystore root\&.jks - \-gencert \-alias root \-ext BC=0 \-rfc > ca\&.pem -keytool \-keystore ca\&.jks \-importcert \-alias ca \-file ca\&.pem - -keytool \-storepass <storepass> \-keystore server\&.jks \-certreq \-alias server | - keytool \-storepass <storepass> \-keystore ca\&.jks \-gencert \-alias ca - \-ext ku:c=dig,kE \-rfc > server\&.pem -cat root\&.pem ca\&.pem server\&.pem | - keytool \-keystore server\&.jks \-importcert \-alias server .fi .if n \{\ .RE @@ -1129,10 +1144,10 @@ .PP キーストアのエントリ .RS 4 -キーストアには異なるタイプのエントリを含めることができます。\fIkeytool\fRコマンドで最も適用範囲の広いエントリ・タイプは、次の2つです。 +キーストアには異なるタイプのエントリを含めることができます。\fBkeytool\fRコマンドで最も適用範囲の広いエントリ・タイプは、次の2つです。 .sp \fB鍵のエントリ\fR -\- 各エントリは、非常に重要な暗号化の鍵の情報を保持します。この情報は、許可していないアクセスを防ぐために、保護された形で格納されます。一般に、この種のエントリとして格納される鍵は、秘密鍵か、対応する公開鍵の証明書チェーンを伴う秘密鍵です。証明書チェーンを参照してください。\fIkeytool\fRコマンドがこの両方のタイプのエントリを処理できるのに対し、\fIjarsigner\fRツールは後者のタイプのエントリ、つまり秘密鍵とそれに関連付けられた証明書チェーンのみを処理します。 +\- 各エントリは、非常に重要な暗号化の鍵の情報を保持します。この情報は、許可していないアクセスを防ぐために、保護された形で格納されます。一般に、この種のエントリとして格納される鍵は、秘密鍵か、対応する公開鍵の証明書チェーンを伴う秘密鍵です。証明書チェーンを参照してください。\fBkeytool\fRコマンドがこの両方のタイプのエントリを処理できるのに対し、\fBjarsigner\fRツールは後者のタイプのエントリ、つまり秘密鍵とそれに関連付けられた証明書チェーンのみを処理します。 .sp \fB信頼できる証明書のエントリ\fR: 各エントリは、第三者からの公開鍵証明書を1つ含んでいます。このエントリは、信頼できる証明書と呼ばれます。それは、証明書内の公開鍵が、証明書のSubject(所有者)によって特定されるアイデンティティに由来するものであることを、キーストアの所有者が信頼するからです。証明書の発行者は、証明書に署名を付けることによって、その内容を保証します。 .RE @@ -1141,81 +1156,86 @@ .RS 4 キーストアのすべてのエントリ(鍵および信頼できる証明書エントリ)は、一意の別名を介してアクセスされます。 .sp -別名を指定するのは、\fI\-genseckey\fRコマンドを使用して秘密鍵を生成したり、\fI\-genkeypair\fRコマンドを使用して鍵ペア(公開鍵と秘密鍵)を生成したり、\fI\-importcert\fRコマンドを使用して証明書または証明書チェーンを信頼できる証明書のリストに追加するなど、特定のエンティティをキーストアに追加する場合です。これ以後、\fIkeytool\fRコマンドでエンティティを参照する場合は、このときに指定した別名を使用する必要があります。 +別名を指定するのは、\fB\-genseckey\fRコマンドを使用して秘密鍵を生成したり、\fB\-genkeypair\fRコマンドを使用して鍵ペア(公開鍵と秘密鍵)を生成したり、\fB\-importcert\fRコマンドを使用して証明書または証明書チェーンを信頼できる証明書のリストに追加するなど、特定のエンティティをキーストアに追加する場合です。これ以後、\fBkeytool\fRコマンドでエンティティを参照する場合は、このときに指定した別名を使用する必要があります。 .sp -たとえば、\fIduke\fRという別名を使用して新しい公開鍵と秘密鍵のペアを生成し、公開鍵を自己署名証明書でラップするとします。この場合は、次のコマンドを実行します。証明書チェーンを参照してください。 +たとえば、\fBduke\fRという別名を使用して新しい公開鍵と秘密鍵のペアを生成し、公開鍵を自己署名証明書でラップするとします。この場合は、次のコマンドを実行します。証明書チェーンを参照してください。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-genkeypair \-alias duke \-keypass dukekeypasswd +\fBkeytool \-genkeypair \-alias duke \-keypass dukekeypasswd\fR + .fi .if n \{\ .RE .\} -この例では、初期パスワードとして\fIdukekeypasswd\fRを指定しています。以後、別名\fIduke\fRに関連付けられた秘密鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。Dukeの秘密鍵のパスワードをあとから変更するには、次のコマンドを実行します。 +この例では、初期パスワードとして\fBdukekeypasswd\fRを指定しています。以後、別名\fBduke\fRに関連付けられた秘密鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。Dukeの秘密鍵のパスワードをあとから変更するには、次のコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-keypasswd \-alias duke \-keypass dukekeypasswd \-new newpass +\fBkeytool \-keypasswd \-alias duke \-keypass dukekeypasswd \-new newpass\fR + .fi .if n \{\ .RE .\} -パスワードが、\fIdukekeypasswd\fRから\fInewpass\fRに変更されます。テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンドラインで指定しなかった場合は、パスワードの入力を求められます。 +パスワードが、\fBdukekeypasswd\fRから\fBnewpass\fRに変更されます。テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。 .RE .PP キーストアの実装 .RS 4 -\fIjava\&.security\fRパッケージで提供されている\fIKeyStore\fRクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定のタイプのキーストアを対象とする複数の異なる実装が存在可能です。 +\fBjava\&.security\fRパッケージで提供されている\fBKeyStore\fRクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定のタイプのキーストアを対象とする複数の異なる実装が存在可能です。 .sp -現在、\fIkeytool\fRと\fIjarsigner\fRの2つのコマンドライン・ツールと、Policy Toolという名前のGUIベースのツールが、キーストアの実装を使用しています。\fIKeyStore\fRクラスは\fIpublic\fRであるため、ユーザーはKeyStoreを使用した他のセキュリティ・アプリケーションも作成できます。 +現在、\fBkeytool\fRと\fBjarsigner\fRの2つのコマンド行ツールと、Policy Toolという名前のGUIベースのツールが、キーストアの実装を使用しています。\fBKeyStore\fRクラスは\fBpublic\fRであるため、ユーザーはKeyStoreを使用した他のセキュリティ・アプリケーションも作成できます。 .sp キーストアには、Oracleが提供する組込みのデフォルトの実装があります。これは、JKSという名前の独自のキーストア・タイプ(形式)を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の秘密鍵は個別のパスワードによって保護され、キーストア全体の整合性も(秘密鍵とは別の)パスワードによって保護されます。 .sp -キーストアの実装は、プロバイダベースです。具体的には、\fIKeyStore\fRによって提供されるアプリケーション・インタフェースがサービス・プロバイダ・インタフェース(SPI)に基づいて実装されます。つまり、対応する\fIKeystoreSpi\fR抽象クラス(これも\fIjava\&.security\fRパッケージに含まれています)があり、このクラスが、プロバイダが実装する必要のあるService Provider Interfaceのメソッドを定義しています。ここで、\fIプロバイダ\fRとは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。キーストアの実装を提供するには、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/HowToImplAProvider\&.htmlにある -Java暗号化アーキテクチャのプロバイダの実装方法で説明しているように、クライアントはプロバイダを実装し、\fIKeystoreSpi\fRサブクラスの実装を提供する必要があります。 +キーストアの実装は、プロバイダベースです。具体的には、\fBKeyStore\fRによって提供されるアプリケーション・インタフェースがサービス・プロバイダ・インタフェース(SPI)に基づいて実装されます。つまり、対応する\fBKeystoreSpi\fR抽象クラス(これも\fBjava\&.security\fRパッケージに含まれています)があり、このクラスが、プロバイダが実装する必要のあるService Provider Interfaceのメソッドを定義しています。ここで、\fIプロバイダ\fRとは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。キーストアの実装を提供するには、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/HowToImplAProvider\&.htmlにある +Java暗号化アーキテクチャのプロバイダの実装方法で説明しているように、クライアントはプロバイダを実装し、\fBKeystoreSpi\fRサブクラスの実装を提供する必要があります。 .sp -アプリケーションでは、\fIKeyStore\fRクラスが提供する\fIgetInstance\fRファクトリ・メソッドを使用することで、様々なプロバイダから異なるタイプのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストアの整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 +アプリケーションでは、\fBKeyStore\fRクラスが提供する\fBgetInstance\fRファクトリ・メソッドを使用することで、様々なプロバイダから異なるタイプのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストアの整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 .sp -\fIkeytool\fRコマンドは、任意のファイルベースのキーストア実装で動作します。コマンド・ラインで渡されたキーストアの場所をファイル名として扱って、\fIFileInputStream\fRに変換し、ここからキーストア情報をロードします。\fIjarsigner\fRおよび\fIpolicytool\fRコマンドは、URLで指定できる任意の場所からキーストアを読み取ることができます。 +\fBkeytool\fRコマンドは、任意のファイルベースのキーストア実装で動作します。コマンド行で渡されたキーストアの場所をファイル名として扱って、\fBFileInputStream\fRに変換し、ここからキーストア情報をロードします。\fBjarsigner\fRおよび\fBpolicytool\fRコマンドは、URLで指定できる任意の場所からキーストアを読み取ることができます。 .sp -\fIkeytool\fRと\fIjarsigner\fRの場合、\fI\-storetype\fRオプションを使用してコマンドラインでキーストアのタイプを指定できます。Policy Toolの場合は、「キーストア」メニューによってキーストアのタイプを指定できます。 +\fBkeytool\fRと\fBjarsigner\fRの場合、\fB\-storetype\fRオプションを使用してコマンド行でキーストアのタイプを指定できます。Policy Toolの場合は、「キーストア」メニューによってキーストアのタイプを指定できます。 .sp -ユーザーがキーストアのタイプを明示的に指定しなかった場合、セキュリティ・プロパティ・ファイルで指定された\fIkeystore\&.type\fRプロパティの値に基づいて、ツールによってキーストアの実装が選択されます。このセキュリティ・プロパティ・ファイルは\fIjava\&.security\fRと呼ばれ、Windowsではセキュリティ・プロパティ・ディレクトリ\fIjava\&.home\elib\esecurity\fR、Oracle Solarisでは\fIjava\&.home/lib/security\fRにあります。\fIjava\&.home\fRは、実行時環境のディレクトリです。\fIjre\fRディレクトリは、SDKまたはJava Runtime Environment (JRE)の最上位のディレクトリにあります。 +ユーザーがキーストアのタイプを明示的に指定しなかった場合、セキュリティ・プロパティ・ファイルで指定された\fBkeystore\&.type\fRプロパティの値に基づいて、ツールによってキーストアの実装が選択されます。このセキュリティ・プロパティ・ファイルは\fBjava\&.security\fRと呼ばれ、Windowsではセキュリティ・プロパティ・ディレクトリ\fBjava\&.home\elib\esecurity\fR、Oracle Solarisでは\fBjava\&.home/lib/security\fRにあります。\fBjava\&.home\fRは、実行時環境のディレクトリです。\fBjre\fRディレクトリは、SDKまたはJava Runtime Environment (JRE)の最上位のディレクトリにあります。 .sp -各ツールは、\fIkeystore\&.type\fRの値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。そのプロバイダからのキーストアの実装を使用します。\fIKeyStore\fRクラスに定義されているstaticメソッド\fIgetDefaultType\fRを使用すると、アプリケーションやアプレットから\fIkeystore\&.type\fRプロパティの値を取得できます。次のコードは、デフォルトのキーストア・タイプ(\fIkeystore\&.type\fRプロパティで指定されたタイプ)のインスタンスを生成します。 +各ツールは、\fBkeystore\&.type\fRの値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。そのプロバイダからのキーストアの実装を使用します。\fBKeyStore\fRクラスに定義されているstaticメソッド\fBgetDefaultType\fRを使用すると、アプリケーションやアプレットから\fBkeystore\&.type\fRプロパティの値を取得できます。次のコードは、デフォルトのキーストア・タイプ(\fBkeystore\&.type\fRプロパティで指定されたタイプ)のインスタンスを生成します。 .sp .if n \{\ .RS 4 .\} .nf -KeyStore keyStore = KeyStore\&.getInstance(KeyStore\&.getDefaultType()); +\fBKeyStore keyStore = KeyStore\&.getInstance(KeyStore\&.getDefaultType());\fR + .fi .if n \{\ .RE .\} -デフォルトのキーストア・タイプは\fIjks\fRで、これはOracleが提供する独自のタイプのキーストアの実装です。これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。 +デフォルトのキーストア・タイプは\fBjks\fRで、これはOracleが提供する独自のタイプのキーストアの実装です。これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。 .sp .if n \{\ .RS 4 .\} .nf -keystore\&.type=jks +\fBkeystore\&.type=jks\fR + .fi .if n \{\ .RE .\} -各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。たとえば、\fIpkcs12\fRと呼ばれるキーストアのタイプのキーストアの実装を提供するプロバイダ・パッケージがある場合、行を次のように変更します。 +各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。たとえば、\fBpkcs12\fRと呼ばれるキーストアのタイプのキーストアの実装を提供するプロバイダ・パッケージがある場合、行を次のように変更します。 .sp .if n \{\ .RS 4 .\} .nf -keystore\&.type=pkcs12 +\fBkeystore\&.type=pkcs12\fR + .fi .if n \{\ .RE @@ -1242,9 +1262,9 @@ .sp 公開鍵暗号化では、ユーザーの公開鍵にアクセスする必要があります。大規模なネットワーク環境では、互いに通信しているエンティティ間で以前の関係が引続き確立されていると仮定したり、使用されているすべての公開鍵を収めた信頼できるリポジトリが存在すると仮定したりすることは不可能です。このような公開鍵の配布に関する問題を解決するために証明書が考案されました。現在では、証明書発行局(CA)が信頼できる第三者として機能します。CAは、他のエンティティの証明書に署名する(発行する)行為を、信頼して任されているエンティティ(企業など)です。CAは法律上の契約に拘束されるので、有効かつ信頼できる証明書のみを作成するものとして扱われます。VeriSign、Thawte、Entrustをはじめ、多くの公的な証明書発行局が存在します。 .sp -Microsoftの認証サーバー、EntrustのCA製品などを所属組織内で利用すれば、独自の証明書発行局を運営することも可能です。\fIkeytool\fRコマンドを使用すると、証明書の表示、インポートおよびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。 +Microsoftの認証サーバー、EntrustのCA製品などを所属組織内で利用すれば、独自の証明書発行局を運営することも可能です。\fBkeytool\fRコマンドを使用すると、証明書の表示、インポートおよびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。 .sp -現在、\fIkeytool\fRコマンドはX\&.509証明書を対象にしています。 +現在、\fBkeytool\fRコマンドはX\&.509証明書を対象にしています。 .RE .PP X\&.509証明書 @@ -1253,13 +1273,13 @@ .sp すべてのX\&.509証明書は、署名の他に次のデータを含んでいます。 .sp -\fBバージョン\fR: 証明書に適用されるX\&.509規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。今のところ、3つのバージョンが定義されています。\fIkeytool\fRコマンドでは、v1、v2、v3の証明書をインポートおよびエクスポートできます。v3の証明書を生成します。 +\fBバージョン\fR: 証明書に適用されるX\&.509規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。今のところ、3つのバージョンが定義されています。\fBkeytool\fRコマンドでは、v1、v2、v3の証明書をインポートおよびエクスポートできます。v3の証明書を生成します。 .sp X\&.509 Version 1は、1988年から利用されて広く普及しており、最も一般的です。 .sp X\&.509 Version 2では、Subjectや発行者の名前をあとで再利用できるようにするために、Subjectと発行者の一意識別子の概念が導入されました。ほとんどの証明書プロファイル文書では、名前を再使用しないことと、証明書で一意の識別子を使用しないことが、強く推奨されています。Version 2の証明書は、広くは使用されていません。 .sp -X\&.509 Version 3は最も新しい(1996年)規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。一般的なエクステンションとしては、KeyUsage(\fI署名専用\fRなど、鍵の使用を特定の目的に制限する)、AlternativeNames(DNS名、電子メール・アドレス、IPアドレスなど、他のアイデンティティを公開鍵に関連付けることができる)などがあります。エクステンションには、criticalというマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、criticalとマークされ、\fIkeyCertSign\fRが設定されたKeyUsageエクステンションが証明書に含まれている場合、この証明書をSSL通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する秘密鍵が証明書の署名専用として指定されており、SSLでは使用できないためです。 +X\&.509 Version 3は最も新しい(1996年)規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。一般的なエクステンションとしては、KeyUsage(\fB署名専用\fRなど、鍵の使用を特定の目的に制限する)、AlternativeNames(DNS名、電子メール・アドレス、IPアドレスなど、他のアイデンティティを公開鍵に関連付けることができる)などがあります。エクステンションには、criticalというマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、criticalとマークされ、\fBkeyCertSign\fRが設定されたKeyUsageエクステンションが証明書に含まれている場合、この証明書をSSL通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する秘密鍵が証明書の署名専用として指定されており、SSLでは使用できないためです。 .sp \fBシリアル番号\fR: 証明書を作成したエンティティは、そのエンティティが発行する他の証明書と区別するために、証明書にシリアル番号を割り当てます。この情報は、様々な方法で使用されます。たとえば、証明書が取り消されると、シリアル番号が証明書失効リスト(CRL)に格納されます。 .sp @@ -1275,7 +1295,8 @@ .RS 4 .\} .nf -CN=Java Duke, OU=Java Software Division, O=Oracle Corporation, C=US +\fBCN=Java Duke, OU=Java Software Division, O=Oracle Corporation, C=US\fR + .fi .if n \{\ .RE @@ -1287,51 +1308,52 @@ .PP 証明書チェーン .RS 4 -\fIkeytool\fRコマンドでは、秘密鍵および関連する証明書チェーンを含むキーストアの鍵エントリを作成し、管理することができます。このようなエントリでは、秘密鍵に対応する公開鍵は、チェーンの最初の証明書に含まれています。 +\fBkeytool\fRコマンドでは、秘密鍵および関連する証明書チェーンを含むキーストアの鍵エントリを作成し、管理することができます。このようなエントリでは、秘密鍵に対応する公開鍵は、チェーンの最初の証明書に含まれています。 .sp -鍵を初めて作成すると、自己署名証明書という1つの要素のみを含むチェーンが開始されます。\fIの\fR\-genkeypairコマンドを参照してください。自己署名証明書は発行者(署名者)が主体と同じです。主体は、その公開鍵が証明書によって認証されるエンティティです。\fI\-genkeypair\fRコマンドを呼び出して新しい公開鍵と秘密鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。 +鍵を初めて作成すると、自己署名証明書という1つの要素のみを含むチェーンが開始されます。コマンドの\fB\-genkeypair\fRを参照してください。自己署名証明書は発行者(署名者)が主体と同じです。主体は、その公開鍵が証明書によって認証されるエンティティです。\fB\-genkeypair\fRコマンドを呼び出して新しい公開鍵と秘密鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。 .sp -この後、証明書署名リクエスト(CSR)が\fI\-certreq\fRコマンドで生成されて、CSRが証明書発行局(CA)に送信されると、CAからのレスポンスが\fI\-importcert\fRでインポートされ、元の自己署名証明書は証明書チェーンによって置き換えられます。コマンドの\fI\-certreq\fRおよび\fI\-importcert\fRオプションを参照してください。チェーンの最後にあるのは、Subjectの公開鍵を認証したCAが発行した証明書(応答)です。チェーン内のその前の証明書は、CAの公開鍵を認証する証明書です。 +この後、証明書署名リクエスト(CSR)が\fB\-certreq\fRコマンドで生成されて、CSRが証明書発行局(CA)に送信されると、CAからのレスポンスが\fB\-importcert\fRでインポートされ、元の自己署名証明書は証明書チェーンによって置き換えられます。\fBの\fR\-certreq\fBおよび\fR\-importcertコマンドオプションを参照してください。チェーンの最後にあるのは、Subjectの公開鍵を認証したCAが発行した証明書(応答)です。チェーン内のその前の証明書は、CAの公開鍵を認証する証明書です。 .sp CAの公開鍵を認証する証明書は、多くの場合、自己署名証明書(つまりCAが自身の公開鍵を認証した証明書)であり、これはチェーンの最初の証明書になります。場合によっては、CAが証明書のチェーンを返すこともあります。この場合、チェーン内の最後の証明書(CAによって署名され、鍵エントリの公開鍵を認証する証明書)に変わりはありませんが、チェーン内のその前の証明書は、CSRの送信先のCAとは別のCAによって署名され、CSRの送信先のCAの公開鍵を認証する証明書になります。チェーン内のその前の証明書は、次のCAの鍵を認証する証明書になります。以下同様に、自己署名された「ルート」証明書に達するまでチェーンが続きます。したがって、チェーン内の(最初の証明書以後の)各証明書では、チェーン内の次の証明書の署名者の公開鍵が認証されていることになります。 .sp 多くのCAは、チェーンをサポートせずに発行済の証明書のみを返します。特に、中間のCAが存在しないフラットな階層構造の場合は、その傾向が顕著です。このような場合は、キーストアにすでに格納されている信頼できる証明書情報から、証明書チェーンを確立する必要があります。 .sp -別の応答形式(PKCS#7で定義されている形式)では、発行済証明書に加え、証明書チェーンのサポートが含まれています。\fIkeytool\fRコマンドでは、どちらの応答形式も扱うことができます。 +別の応答形式(PKCS#7で定義されている形式)では、発行済証明書に加え、証明書チェーンのサポートが含まれています。\fBkeytool\fRコマンドでは、どちらの応答形式も扱うことができます。 .sp -トップレベル(ルート)CAの証明書は、自己署名証明書です。ただし、ルートの公開鍵への信頼は、ルート証明書自体からではなく、新聞など他のソースから取得されます。これは、VeriSignルートCAなどの識別名を使用して、誰でも自己署名型証明書を生成できるためです。ルートCAの公開鍵は広く知られています。ルートCAの公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。つまり、証明書は、ルートCAの公開鍵を運ぶ「媒体」として利用されるのみです。ルートCAの証明書をキーストアに追加するときは、\fI\-printcert\fRオプションを使用して、その前に証明書の内容を表示し、表示されたフィンガープリントと、新聞やルートCAのWebページなどから入手した既知のフィンガープリントとを比較する必要があります。 +トップレベル(ルート)CAの証明書は、自己署名証明書です。ただし、ルートの公開鍵への信頼は、ルート証明書自体からではなく、新聞など他のソースから取得されます。これは、VeriSignルートCAなどの識別名を使用して、誰でも自己署名型証明書を生成できるためです。ルートCAの公開鍵は広く知られています。ルートCAの公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。つまり、証明書は、ルートCAの公開鍵を運ぶ「媒体」として利用されるのみです。ルートCAの証明書をキーストアに追加するときは、\fB\-printcert\fRオプションを使用して、その前に証明書の内容を表示し、表示されたフィンガープリントと、新聞やルートCAのWebページなどから入手した既知のフィンガープリントとを比較する必要があります。 .RE .PP cacerts証明書ファイル .RS 4 -\fIcacerts\fRという名前の証明書ファイルは、Windowsではセキュリティ・プロパティ・ディレクトリ\fIjava\&.home\elib\esecurity\fR、Oracle Solarisでは\fIjava\&.home/lib/security\fRに置かれています。\fIjava\&.home\fRは、実行環境のディレクトリ(SDKの\fIjre\fRディレクトリまたはJREの最上位ディレクトリ)です。 +\fBcacerts\fRという名前の証明書ファイルは、Windowsではセキュリティ・プロパティ・ディレクトリ\fBjava\&.home\elib\esecurity\fR、Oracle Solarisでは\fBjava\&.home/lib/security\fRに置かれています。\fBjava\&.home\fRは、実行環境のディレクトリ(SDKの\fBjre\fRディレクトリまたはJREの最上位ディレクトリ)です。 .sp -\fIcacerts\fRファイルは、CAの証明書を含む、システム全体のキーストアです。システム管理者は、キーストア・タイプに\fIjks\fRを指定することで、\fIkeytool\fRコマンドを使用してこのファイルの構成と管理を行うことができます。\fIcacerts\fRキーストア・ファイルは、ルートCA証明書のデフォルト・セットを含んだ状態で出荷されています。デフォルトの証明書を一覧表示するには、次のコマンドを使用します。 +\fBcacerts\fRファイルは、CAの証明書を含む、システム全体のキーストアです。システム管理者は、キーストア・タイプに\fBjks\fRを指定することで、\fBkeytool\fRコマンドを使用してこのファイルの構成と管理を行うことができます。\fBcacerts\fRキーストア・ファイルは、ルートCA証明書のデフォルト・セットを含んだ状態で出荷されています。デフォルトの証明書を一覧表示するには、次のコマンドを使用します。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-list \-keystore java\&.home/lib/security/cacerts +\fBkeytool \-list \-keystore java\&.home/lib/security/cacerts\fR + .fi .if n \{\ .RE .\} -\fIcacerts\fRキーストア・ファイルの初期パスワードは、\fIchangeit\fRです。システム管理者は、SDKのインストール後、このファイルのパスワードとデフォルト・アクセス権を変更する必要があります。 +\fBcacerts\fRキーストア・ファイルの初期パスワードは、\fBchangeit\fRです。システム管理者は、SDKのインストール後、このファイルのパスワードとデフォルト・アクセス権を変更する必要があります。 .sp \fB注意:\fR -\fIcacerts\fRファイルを確認することが重要です。\fIcacerts\fRファイル内のCAは、署名および他のエンティティへの証明書発行のためのエンティティとして信頼されるため、\fIcacerts\fRファイルの管理は慎重に行う必要があります。\fIcacerts\fRファイルには、信頼するCAの証明書のみが含まれている必要があります。ユーザーは、自身の責任において、\fIcacerts\fRファイルにバンドルされている信頼できるルートCA証明書を検証し、信頼性に関する独自の決定を行います。 +\fBcacerts\fRファイルを確認することが重要です。\fBcacerts\fRファイル内のCAは、署名および他のエンティティへの証明書発行のためのエンティティとして信頼されるため、\fBcacerts\fRファイルの管理は慎重に行う必要があります。\fBcacerts\fRファイルには、信頼するCAの証明書のみが含まれている必要があります。ユーザーは、自身の責任において、\fBcacerts\fRファイルにバンドルされている信頼できるルートCA証明書を検証し、信頼性に関する独自の決定を行います。 .sp -信頼できないCA証明書を\fIcacerts\fRファイルから削除するには、\fIkeytool\fRコマンドの\fIdelete\fRオプションを使用します。\fIcacerts\fRファイルはJREのインストール・ディレクトリにあります。このファイルを編集するアクセス権がない場合は、システム管理者に連絡してください +信頼できないCA証明書を\fBcacerts\fRファイルから削除するには、\fBkeytool\fRコマンドの\fBdelete\fRオプションを使用します。\fBcacerts\fRファイルはJREのインストール・ディレクトリにあります。このファイルを編集するアクセス権がない場合は、システム管理者に連絡してください .RE .PP インターネットRFC 1421証明書符号化規格 .RS 4 多くの場合、証明書は、バイナリ符号化ではなく、インターネットRFC 1421規格で定義されている出力可能符号化方式を使用して格納されます。Base 64符号化とも呼ばれるこの証明書形式では、電子メールやその他の機構を通じて、他のアプリケーションに証明書を容易にエクスポートできます。 .sp -\fI\-importcert\fRと\fI\-printcert\fRコマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。\fI\-exportcert\fRコマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。ただし、\fI\-rfc\fRオプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 +\fB\-importcert\fRと\fB\-printcert\fRコマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。\fB\-exportcert\fRコマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。ただし、\fB\-rfc\fRオプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 .sp -\fI\-list\fRコマンドでは、デフォルトで証明書のSHA1フィンガープリントが出力されます。\fI\-v\fRオプションが指定されている場合、証明書は人が理解できる形式で出力されます。\fI\-rfc\fRオプションが指定されている場合、証明書は出力可能符号化方式で出力されます。 +\fB\-list\fRコマンドでは、デフォルトで証明書のSHA1フィンガープリントが出力されます。\fB\-v\fRオプションが指定されている場合、証明書は人が理解できる形式で出力されます。\fB\-rfc\fRオプションが指定されている場合、証明書は出力可能符号化方式で出力されます。 .sp 出力可能符号化方式で符号化された証明書は、次のテキストで始まり、次のテキストで終了します。 .sp @@ -1339,11 +1361,12 @@ .RS 4 .\} .nf -\-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\- - -encoded certificate goes here\&. - -\-\-\-\-\-END CERTIFICATE\-\-\-\-\- +\fB\-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\-\fR + +\fBencoded certificate goes here\&. \fR + +\fB\-\-\-\-\-END CERTIFICATE\-\-\-\-\-\fR + .fi .if n \{\ .RE @@ -1352,7 +1375,7 @@ .PP X\&.500識別名 .RS 4 -X\&.500識別名は、エンティティを特定するために使用されます。たとえば、X\&.509証明書の\fIsubject\fRフィールドと\fIissuer\fR(署名者)フィールドで指定される名前は、X\&.500識別名です。\fIkeytool\fRコマンドは、次のサブパートをサポートしています。 +X\&.500識別名は、エンティティを特定するために使用されます。たとえば、X\&.509証明書の\fBsubject\fRフィールドと\fBissuer\fR(署名者)フィールドで指定される名前は、X\&.500識別名です。\fBkeytool\fRコマンドは、次のサブパートをサポートしています。 .sp \fBcommonName\fR: Susan Jonesなど、人の通称。 .sp @@ -1364,13 +1387,14 @@ .sp \fBcountry\fR: 2文字の国コード。CHなど。 .sp -識別名文字列を\fI\-dname\fRオプションの値として指定する場合(たとえば\fI\-genkeypair\fRコマンドに)、文字列は次の形式にする必要があります。 +識別名文字列を\fB\-dname\fRオプションの値として指定する場合(たとえば\fB\-genkeypair\fRコマンドに)、文字列は次の形式にする必要があります。 .sp .if n \{\ .RS 4 .\} .nf -CN=cName, OU=orgUnit, O=org, L=city, S=state, C=countryCode +\fBCN=cName, OU=orgUnit, O=org, L=city, S=state, C=countryCode\fR + .fi .if n \{\ .RE @@ -1381,12 +1405,13 @@ .RS 4 .\} .nf -CN=commonName -OU=organizationUnit -O=organizationName -L=localityName -S=stateName -C=country +\fBCN=commonName\fR +\fBOU=organizationUnit\fR +\fBO=organizationName\fR +\fBL=localityName\fR +\fBS=stateName\fR +\fBC=country\fR + .fi .if n \{\ .RE @@ -1397,7 +1422,8 @@ .RS 4 .\} .nf -CN=Mark Smith, OU=Java, O=Oracle, L=Cupertino, S=California, C=US +\fBCN=Mark Smith, OU=Java, O=Oracle, L=Cupertino, S=California, C=US\fR + .fi .if n \{\ .RE @@ -1408,8 +1434,9 @@ .RS 4 .\} .nf -keytool \-genkeypair \-dname "CN=Mark Smith, OU=Java, O=Oracle, L=Cupertino, -S=California, C=US" \-alias mark +\fBkeytool \-genkeypair \-dname "CN=Mark Smith, OU=Java, O=Oracle, L=Cupertino,\fR +\fBS=California, C=US" \-alias mark\fR + .fi .if n \{\ .RE @@ -1422,66 +1449,73 @@ .RS 4 .\} .nf -CN=Steve Meier, OU=Java, O=Oracle, C=US +\fBCN=Steve Meier, OU=Java, O=Oracle, C=US\fR + .fi .if n \{\ .RE .\} -識別名文字列の値にカンマが含まれる場合に、コマンドラインで文字列を指定するときには、次のようにカンマをバックスラッシュ文字(\e)でエスケープする必要があります。 +識別名文字列の値にカンマが含まれる場合に、コマンド行で文字列を指定するときには、次のようにカンマをバックスラッシュ文字(\e)でエスケープする必要があります。 .sp .if n \{\ .RS 4 .\} .nf -cn=Peter Schuster, ou=Java\e, Product Development, o=Oracle, c=US +\fBcn=Peter Schuster, ou=Java\e, Product Development, o=Oracle, c=US\fR + .fi .if n \{\ .RE .\} -識別名文字列をコマンドラインで指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンドラインで識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、カンマをバックスラッシュ(\e)でエスケープする必要はありません。 +識別名文字列をコマンド行で指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンド行で識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、カンマをバックスラッシュ(\e)でエスケープする必要はありません。 .RE .SH "警告" .SS "信頼できる証明書のインポート警告" .PP \fB重要\fR: 信頼できる証明書として証明書をインポートする前に、証明書の内容を慎重に調べてください。 -Windowsの例:.PP -まず、\fI\-noprompt\fRオプションを指定せずに\fI\-printcert\fRコマンドまたは\fI\-importcert\fRコマンドを使用して、証明書を表示します。表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致することを確認します。たとえば、証明書が送られてきて、この証明書を\fI\etmp\ecert\fRという名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\fI\-printcert\fRコマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 +.PP +Windowsの例: +.PP +まず、\fB\-noprompt\fRオプションを指定せずに\fB\-printcert\fRコマンドまたは\fB\-importcert\fRコマンドを使用して、証明書を表示します。表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致することを確認します。たとえば、証明書が送られてきて、この証明書を\fB\etmp\ecert\fRという名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\fB\-printcert\fRコマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 .sp .if n \{\ .RS 4 .\} .nf - keytool \-printcert \-file \etmp\ecert - Owner: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll - Issuer: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll - Serial Number: 59092b34 - Valid from: Thu Sep 25 18:01:13 PDT 1997 until: Wed Dec 24 17:01:13 PST 1997 - Certificate Fingerprints: - MD5: 11:81:AD:92:C8:E5:0E:A2:01:2E:D4:7A:D7:5F:07:6F - SHA1: 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE - SHA256: 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90: - 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4 +\fB keytool \-printcert \-file \etmp\ecert\fR +\fB Owner: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll\fR +\fB Issuer: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll\fR +\fB Serial Number: 59092b34\fR +\fB Valid from: Thu Sep 25 18:01:13 PDT 1997 until: Wed Dec 24 17:01:13 PST 1997\fR +\fB Certificate Fingerprints:\fR +\fB MD5: 11:81:AD:92:C8:E5:0E:A2:01:2E:D4:7A:D7:5F:07:6F\fR +\fB SHA1: 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE\fR +\fB SHA256: 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90:\fR +\fB 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4\fR .fi .if n \{\ .RE .\} -Oracle Solarisの例:.PP -まず、\fI\-noprompt\fRオプションを指定せずに\fI\-printcert\fRコマンドまたは\fI\-importcert\fRコマンドを使用して、証明書を表示します。表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致することを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を\fI/tmp/cert\fRという名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\fI\-printcert\fRコマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 +.PP +Oracle Solarisの例: +.PP +まず、\fB\-noprompt\fRオプションを指定せずに\fB\-printcert\fRコマンドまたは\fB\-importcert\fRコマンドを使用して、証明書を表示します。表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致することを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を\fB/tmp/cert\fRという名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\fB\-printcert\fRコマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 .sp .if n \{\ .RS 4 .\} .nf - keytool \-printcert \-file /tmp/cert - Owner: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll - Issuer: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll - Serial Number: 59092b34 - Valid from: Thu Sep 25 18:01:13 PDT 1997 until: Wed Dec 24 17:01:13 PST 1997 - Certificate Fingerprints: - MD5: 11:81:AD:92:C8:E5:0E:A2:01:2E:D4:7A:D7:5F:07:6F - SHA1: 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE - SHA256: 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90: - 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4 +\fB keytool \-printcert \-file /tmp/cert\fR +\fB Owner: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll\fR +\fB Issuer: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll\fR +\fB Serial Number: 59092b34\fR +\fB Valid from: Thu Sep 25 18:01:13 PDT 1997 until: Wed Dec 24 17:01:13 PST 1997\fR +\fB Certificate Fingerprints:\fR +\fB MD5: 11:81:AD:92:C8:E5:0E:A2:01:2E:D4:7A:D7:5F:07:6F\fR +\fB SHA1: 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE\fR +\fB SHA256: 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90:\fR +\fB 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4\fR + .fi .if n \{\ .RE @@ -1490,27 +1524,27 @@ 次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中で他の何者か(攻撃者など)による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの(攻撃的意図を持つクラス・ファイルを含んだJARファイルなど)を信頼することになります。 .PP \fB注意:\fR -証明書をインポートする前に\fI\-printcert\fRコマンドを実行する必要はありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に、\fI\-importcert\fRコマンドによって証明書の情報が表示され、確認を求めるメッセージが表示されるためです。ユーザーはインポート操作を停止できます。ただし、これを実行できるのは、\fI\-noprompt\fRオプションを指定せずに\fI\-importcert\fRコマンドを呼び出す場合のみです。\fI\-noprompt\fRオプションが指定されている場合、ユーザーとの対話は行われません。 +証明書をインポートする前に\fB\-printcert\fRコマンドを実行する必要はありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に、\fB\-importcert\fRコマンドによって証明書の情報が表示され、確認を求めるメッセージが表示されるためです。ユーザーはインポート操作を停止できます。ただし、これを実行できるのは、\fB\-noprompt\fRオプションを指定せずに\fB\-importcert\fRコマンドを呼び出す場合のみです。\fB\-noprompt\fRオプションが指定されている場合、ユーザーとの対話は行われません。 .SS "パスワード警告" .PP -キーストアに対する操作を行うほとんどのコマンドでは、ストアのパスワードが必要です。また、一部のコマンドでは、非公開/秘密鍵のパスワードが必要になることがあります。パスワードはコマンドラインで指定できます(\fI\-storepass\fRオプションと\fI\-keypass\fRオプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンドラインで指定しなかった場合は、パスワードの入力を求められます。 +キーストアに対する操作を行うほとんどのコマンドでは、ストアのパスワードが必要です。また、一部のコマンドでは、非公開/秘密鍵のパスワードが必要になることがあります。パスワードはコマンド行で指定できます(\fB\-storepass\fRオプションと\fB\-keypass\fRオプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。 .SS "証明書の準拠に関する警告" .PP インターネット標準RFC 5280では、X\&.509証明書の準拠に関するプロファイルが定義されており、証明書のフィールドおよびエクステンションに有効な値および値の組合せが記載されています。標準については、 http://tools\&.ietf\&.org/rfc/rfc5280\&.txtを参照してください .PP -\fIkeytool\fRコマンドでは、これらのルールすべてが適用されるわけではないため、標準に準拠しない証明書を生成できます。標準に準拠しない証明書は、JREや他のアプリケーションで拒否されることがあります。ユーザーは、\fI\-dname\fRや\fI\-ext\fRなどで適正なオプションを指定するようにしてください。 +\fBkeytool\fRコマンドでは、これらのルールすべてが適用されるわけではないため、標準に準拠しない証明書を生成できます。標準に準拠しない証明書は、JREや他のアプリケーションで拒否されることがあります。ユーザーは、\fB\-dname\fRや\fB\-ext\fRなどで適正なオプションを指定するようにしてください。 .SH "注意" .SS "新しい信頼できる証明書のインポート" .PP -\fIkeytool\fRコマンドは、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使用して、インポートする証明書から(ルートCAの)自己署名証明書に至るまでの信頼のチェーンの構築を試みます。 +\fBkeytool\fRコマンドは、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使用して、インポートする証明書から(ルートCAの)自己署名証明書に至るまでの信頼のチェーンの構築を試みます。 .PP -\fI\-trustcacerts\fRオプションを指定した場合、追加の証明書は信頼できるすなわち\fIcacerts\fRという名前のファイルに含まれる証明書のチェーンとみなされます。 +\fB\-trustcacerts\fRオプションを指定した場合、追加の証明書は信頼できるすなわち\fBcacerts\fRという名前のファイルに含まれる証明書のチェーンとみなされます。 .PP -\fIkeytool\fRコマンドが、インポートする証明書から自己署名証明書(キーストアまたは\fIcacerts\fRファイルに含まれている自己署名証明書)に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザーに確認を求めます。この場合は、表示された証明書のフィンガープリントと、他のなんらかの(信頼できる)情報源(証明書の所有者など)から入手したフィンガープリントとを比較します。信頼できる証明書として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。信頼できる証明書のインポート警告を参照してください。インポート操作は、証明書を確認する時点で中止できます。\fI\-noprompt\fRオプションが指定されている場合、ユーザーとの対話は行われません。 +\fBkeytool\fRコマンドが、インポートする証明書から自己署名証明書(キーストアまたは\fBcacerts\fRファイルに含まれている自己署名証明書)に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザーに確認を求めます。この場合は、表示された証明書のフィンガープリントと、他のなんらかの(信頼できる)情報源(証明書の所有者など)から入手したフィンガープリントとを比較します。信頼できる証明書として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。信頼できる証明書のインポート警告を参照してください。インポート操作は、証明書を確認する時点で中止できます。\fB\-noprompt\fRオプションが指定されている場合、ユーザーとの対話は行われません。 .SS "証明書応答のインポート" .PP -証明書応答をインポートするときは、キーストア内の信頼できる証明書、および(\fI\-trustcacert\fR\fIs\fRオプションが指定されている場合は)\fIcacerts\fRキーストア・ファイルで構成された証明書を使用して証明書応答が検査されます。cacerts証明書ファイルを参照してください。 +証明書応答をインポートするときは、キーストア内の信頼できる証明書、および(\fB\-trustcacert\fR\fBs\fRオプションが指定されている場合は)\fBcacerts\fRキーストア・ファイルで構成された証明書を使用して証明書応答が検査されます。cacerts証明書ファイルを参照してください。 .PP 証明書応答が信頼できるかどうかを決定する方法は次のとおりです。 .sp @@ -1522,7 +1556,7 @@ .sp -1 .IP \(bu 2.3 .\} -証明書応答が単一のX\&.509証明書である場合、\fIkeytool\fRコマンドは、証明書応答から(ルートCAの)自己署名証明書に至るまでの信頼チェーンの確立を試みます。証明書応答と、証明書応答の認証に使用される証明書の階層構造は、aliasの新しい証明書チェーンを形成します。信頼チェーンが確立されない場合、証明書応答はインポートされません。この場合、\fIkeytool\fRコマンドは証明書を出力せず、ユーザーに検証を求めるプロンプトを表示します。ユーザーが証明書応答の信頼性を判断するのは非常に難しいためです。 +証明書応答が単一のX\&.509証明書である場合、\fBkeytool\fRコマンドは、証明書応答から(ルートCAの)自己署名証明書に至るまでの信頼チェーンの確立を試みます。証明書応答と、証明書応答の認証に使用される証明書の階層構造は、aliasの新しい証明書チェーンを形成します。信頼チェーンが確立されない場合、証明書応答はインポートされません。この場合、\fBkeytool\fRコマンドは証明書を出力せず、ユーザーに検証を求めるプロンプトを表示します。ユーザーが証明書応答の信頼性を判断するのは非常に難しいためです。 .RE .sp .RS 4 @@ -1533,12 +1567,12 @@ .sp -1 .IP \(bu 2.3 .\} -証明書応答がPKCS#7形式の証明書チェーンまたは一連のX\&.509証明書である場合、チェーンは、ユーザーの証明書が最初に、0以上のCA証明書がその次にくるように並べられます。チェーンが自己署名のルートCA証明書で終わり、\fI \-trustcacerts\fRオプションが指定されている場合、\fIkeytool\fRコマンドは、その証明書と、キーストア内または\fIcacerts\fRキーストア・ファイル内の信頼できるすべての証明書を照合しようとします。チェーンが自己署名のルートCA証明書で終わっておらず、\fI\-trustcacerts\fRオプションが指定されている場合、\fIkeytool\fRコマンドは、キーストア内または\fIcacerts\fRキーストア・ファイル内の信頼できる証明書から自己署名のルートCA証明書を見つけてそれをチェーンの末尾に追加しようとします。その証明書が見つからず、\fI\-noprompt\fRオプションが指定されていない場合は、チェーン内の最後の証明書の情報が出力され、ユーザーは確認を求められます。 +証明書応答がPKCS#7形式の証明書チェーンまたは一連のX\&.509証明書である場合、チェーンは、ユーザーの証明書が最初に、0以上のCA証明書がその次にくるように並べられます。チェーンが自己署名のルートCA証明書で終わり、\fB \-trustcacerts\fRオプションが指定されている場合、\fBkeytool\fRコマンドは、その証明書と、キーストア内または\fBcacerts\fRキーストア・ファイル内の信頼できるすべての証明書を照合しようとします。チェーンが自己署名のルートCA証明書で終わっておらず、\fB\-trustcacerts\fRオプションが指定されている場合、\fBkeytool\fRコマンドは、キーストア内または\fBcacerts\fRキーストア・ファイル内の信頼できる証明書から自己署名のルートCA証明書を見つけてそれをチェーンの末尾に追加しようとします。その証明書が見つからず、\fB\-noprompt\fRオプションが指定されていない場合は、チェーン内の最後の証明書の情報が出力され、ユーザーは確認を求められます。 .RE .PP -証明書応答内の公開鍵が\fIalias\fRですでに格納されているユーザーの公開鍵に一致した場合、古い証明書チェーンが応答内の新しい証明書チェーンで置き換えられます。以前の証明書チェーンを有効な\fIkeypass\fRで置き換えることができるのは、エントリの秘密鍵を保護するためのパスワードを指定した場合のみです。パスワードを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。 +証明書応答内の公開鍵が\fBalias\fRですでに格納されているユーザーの公開鍵に一致した場合、古い証明書チェーンが応答内の新しい証明書チェーンで置き換えられます。以前の証明書チェーンを有効な\fBkeypass\fRで置き換えることができるのは、エントリの秘密鍵を保護するためのパスワードを指定した場合のみです。パスワードを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。 .PP -このコマンドは、以前のリリースでは\fI\-import\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fI\-importcert\fRが優先されます。 +このコマンドは、以前のリリースでは\fB\-import\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fB\-importcert\fRが優先されます。 .SH "関連項目" .sp .RS 4
--- a/src/linux/doc/man/ja/native2ascii.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/native2ascii.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: native2ascii -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 国際化ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: native2ascii +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 国際化ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "native2ascii" "1" "2013年11月21日" "JDK 8" "国際化ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" native2ascii \- サポートされている任意の文字エンコーディングの文字を含むファイルを、ASCIIおよびUnicodeでエスケープされたファイルに変換して(またはその逆)、ローカライズ可能なアプリケーションを作成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fInative2ascii\fR [ \fIinputfile\fR ] [ \fIoutputfile\fR ] +\fBnative2ascii\fR [ \fIinputfile\fR ] [ \fIoutputfile\fR ] .fi .if n \{\ .RE @@ -73,9 +75,9 @@ .RE .SH "説明" .PP -\fInative2ascii\fRコマンドは、ASCIIキャラクタ・セットに含まれないすべての文字にUnicodeエスケープ(\fI\eu\fR\fIxxxx\fR)表記法を使用して、Java Runtime Environment (JRE)でサポートされているエンコードされたファイルを、ASCIIでエンコードされたファイルに変換します。このプロセスは、ISO\-8859\-1文字セットに含まれない文字が含まれているプロパティ・ファイルで必要です。このツールは、その逆の変換を実行することもできます。 +\fBnative2ascii\fRコマンドは、ASCII文字セットに含まれないすべての文字にUnicodeエスケープ(\fB\eu\fR\fIxxxx\fR)表記法を使用して、Java Runtime Environment (JRE)でサポートされているエンコードされたファイルを、ASCIIでエンコードされたファイルに変換します。このプロセスは、ISO\-8859\-1文字セットに含まれない文字が含まれているプロパティ・ファイルで必要です。このツールは、その逆の変換を実行することもできます。 .PP -\fIoutputfile\fR値を省略した場合、標準出力に出力されます。さらに、\fIinputfile\fR値を省略した場合、標準入力から入力されます。 +\fBoutputfile\fR値を省略した場合、標準出力に出力されます。さらに、\fBinputfile\fR値を省略した場合、標準入力から入力されます。 .SH "オプション" .PP \-reverse @@ -85,13 +87,13 @@ .PP \-encoding \fIencoding_name\fR .RS 4 -変換処理で使用する文字エンコーディングの名前を指定します。このオプションが存在しない場合は、デフォルトの文字エンコーディング(\fIjava\&.nio\&.charset\&.Charset\&.defaultCharset\fRメソッドで定義された)が使用されます。\fIencoding_name\fR文字列は、JREでサポートされている文字エンコーディングの名前にする必要があります。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/intl/encoding\&.doc\&.htmlにある +変換処理で使用する文字エンコーディングの名前を指定します。このオプションが存在しない場合は、デフォルトの文字エンコーディング(\fBjava\&.nio\&.charset\&.Charset\&.defaultCharset\fRメソッドで定義された)が使用されます。\fBencoding_name\fR文字列は、JREでサポートされている文字エンコーディングの名前にする必要があります。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/intl/encoding\&.doc\&.htmlにある 「サポートされているエンコーディング」を参照してください .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシン(JVM)に\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machine (JVM)に\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .br 'pl 8.5i
--- a/src/linux/doc/man/ja/orbd.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/orbd.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: orbd -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java IDLおよびRMI-IIOPツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: orbd +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java IDLおよびRMI-IIOPツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "orbd" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" orbd \- CORBA環境のサーバーにある永続オブジェクトをクライアントから検索して呼び出せるようにします。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIorbd\fR [ \fIoptions\fR ] +\fBorbd\fR [ \fIoptions\fR ] .fi .if n \{\ .RE @@ -64,11 +66,11 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .SH "説明" .PP -\fIorbd\fRコマンドを使用すると、CORBA環境のサーバーにある永続オブジェクトをクライアントから透過的に検索して呼び出すことができます。orbdツールに含まれるサーバー・マネージャを使用すると、クライアントはCORBA環境でサーバー上にある永続オブジェクトを透過的に検索して呼び出すことができます。永続サーバーは、ネーミング・サービスに永続オブジェクト参照を発行する際、サーバーのポート番号のかわりにORBDのポート番号をオブジェクト参照に含めます。永続オブジェクト参照のオブジェクト参照にORBDポート番号を含めることには、次のような利点があります。 +\fBorbd\fRコマンドを使用すると、CORBA環境のサーバーにある永続オブジェクトをクライアントから透過的に検索して呼び出すことができます。orbdツールに含まれるサーバー・マネージャを使用すると、クライアントはCORBA環境でサーバー上にある永続オブジェクトを透過的に検索して呼び出すことができます。永続サーバーは、ネーミング・サービスに永続オブジェクト参照を発行する際、サーバーのポート番号のかわりにORBDのポート番号をオブジェクト参照に含めます。永続オブジェクト参照のオブジェクト参照にORBDポート番号を含めることには、次のような利点があります。 .sp .RS 4 .ie n \{\ @@ -92,14 +94,14 @@ クライアントは一度のみネーミング・サービスのオブジェクト参照をルックアップする必要がありますが、その後はサーバーのライフ・サイクルによる変更とは無関係にこの参照を利用することができます。 .RE .PP -ORBDのサーバー・マネージャにアクセスするには、\fIservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースです。サーバー・マネージャの詳細は、サーバー・マネージャを参照してください。 +ORBDのサーバー・マネージャにアクセスするには、\fBservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンド行インタフェースです。サーバー・マネージャの詳細は、サーバー・マネージャを参照してください。 .PP -\fIorbd\fRを起動すると、ネーミング・サービスも起動されます。ネーミング・サービスの詳細。ネーミング・サービスの起動と停止を参照してください。 +\fBorbd\fRを起動すると、ネーミング・サービスも起動されます。ネーミング・サービスの詳細。ネーミング・サービスの起動と停止を参照してください。 .SH "オプション" .PP \-ORBInitialPort \fInameserverport\fR .RS 4 -必須。ネーム・サーバーを起動するポートの番号を指定します。\fIorbd\fRは、起動されると、このポート上で着信リクエストをリスニングします。Oracle Solarisソフトウェアでは、1024より小さいポートでプロセスを開始する場合、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 +必須。ネーム・サーバーを起動するポートの番号を指定します。\fBorbd\fRは、起動されると、このポート上で着信リクエストをリスニングします。Oracle Solarisソフトウェアでは、1024より小さいポートでプロセスを開始する場合、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 .RE .SS "必須でないオプション" .PP @@ -110,22 +112,22 @@ .PP \-defaultdb \fIdirectory\fR .RS 4 -ORBD永続格納ディレクトリ\fIorb\&.db\fRが作成されるベース・ディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は\fI\&./orb\&.db\fRになります。 +ORBD永続格納ディレクトリ\fBorb\&.db\fRが作成されるベース・ディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は\fB\&./orb\&.db\fRになります。 .RE .PP \-serverPollingTime \fImilliseconds\fR .RS 4 -\fIservertool\fRを使用して登録された永続サーバーのヘルス状態をORBDがチェックする間隔を指定します。デフォルト値は1000ミリ秒です。\fImilliseconds\fRに指定する値は、有効な正の整数にする必要があります。 +\fBservertool\fRを使用して登録された永続サーバーのヘルス状態をORBDがチェックする間隔を指定します。デフォルト値は1000ミリ秒です。\fBmilliseconds\fRに指定する値は、有効な正の整数にする必要があります。 .RE .PP \-serverStartupDelay milliseconds .RS 4 -\fIservertool\fRを使用して登録された永続サーバーを再起動してから、位置転送の例外を送信するまでのORBDの待機時間を指定します。デフォルト値は1000ミリ秒です。\fImilliseconds\fRに指定する値は、有効な正の整数にする必要があります。 +\fBservertool\fRを使用して登録された永続サーバーを再起動してから、位置転送の例外を送信するまでのORBDの待機時間を指定します。デフォルト値は1000ミリ秒です。\fBmilliseconds\fRに指定する値は、有効な正の整数にする必要があります。 .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SS "ネーミング・サービスの起動と停止" .PP @@ -135,17 +137,18 @@ .PP 永続ネーミング・サービスは、ネーミング・コンテキストに対して永続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBDを再起動すると、永続ネーミング・サービスはネーミング・コンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングがそのまま(永続的に)保持されるようにします。 .PP -下位互換性のため、旧リリースのJDKに同梱されていた一時ネーミング・サービス\fItnameserv\fRが、今回のリリースのJava SEにも同梱されています。一時ネーム・サービスでは、ネーム・サービスの実行中にのみネーミング・コンテキストが保持されます。サービスが中断されると、ネーミング・コンテキスト・グラフは失われます。 +後方互換性のため、旧リリースのJDKに同梱されていた一時ネーミング・サービス\fBtnameserv\fRが、今回のリリースのJava SEにも同梱されています。一時ネーム・サービスでは、ネーム・サービスの実行中にのみネーミング・コンテキストが保持されます。サービスが中断されると、ネーミング・コンテキスト・グラフは失われます。 .PP -\fI\-ORBInitialPort\fR引数は、\fIorbd\fRの必須のコマンドライン引数で、ネーミング・サービスが実行されるポートの番号を設定するために使用されます。次の手順では、Java IDL Object Request Broker Daemon用にポート1050を使用できることを前提としています。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。必要であれば別のポートに変更してください。 +\fB\-ORBInitialPort\fR引数は、\fBorbd\fRの必須のコマンド行引数で、ネーミング・サービスが実行されるポートの番号を設定するために使用されます。次の手順では、Java IDL Object Request Broker Daemon用にポート1050を使用できることを前提としています。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。必要であれば別のポートに変更してください。 .PP -UNIXコマンド・シェルで\fIorbd\fRを起動するには、次のように入力します。 +Solaris、LinuxまたはOS Xコマンド・シェルから\fBorbd\fRを開始するには、次のように入力します。 .sp .if n \{\ .RS 4 .\} .nf -orbd \-ORBInitialPort 1050& +\fBorbd \-ORBInitialPort 1050&\fR + .fi .if n \{\ .RE @@ -157,7 +160,8 @@ .RS 4 .\} .nf -start orbd \-ORBInitialPort 1050 +\fBstart orbd \-ORBInitialPort 1050\fR + .fi .if n \{\ .RE @@ -169,85 +173,89 @@ .RS 4 .\} .nf -Properties props = new Properties(); -props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050"); -props\&.put("org\&.omg\&.CORBA\&.ORBInitialHost", "MyHost"); -ORB orb = ORB\&.init(args, props); +\fBProperties props = new Properties();\fR +\fBprops\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fR +\fBprops\&.put("org\&.omg\&.CORBA\&.ORBInitialHost", "MyHost");\fR +\fBORB orb = ORB\&.init(args, props);\fR + .fi .if n \{\ .RE .\} .PP -この例では、ネーミング・サービスは、ホスト\fIMyHost\fRのポート1050上で実行されます。別の方法として、コマンドラインからサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンドライン・オプションを使用して、\fIHelloApplication\fRを起動できます。 +この例では、ネーミング・サービスは、ホスト\fBMyHost\fRのポート1050上で実行されます。別の方法として、コマンド行からサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンド行オプションを使用して、\fBHelloApplication\fRを起動できます。 .sp .if n \{\ .RS 4 .\} .nf -java HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost +\fBjava HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost\fR + .fi .if n \{\ .RE .\} .PP -ネーミング・サービスを停止するには、適切なオペレーティング・システム・コマンドを使用します。たとえば、Oracle Solaris上で\fIpkill\fR -\fIorbd\fRを実行したり、\fIorbd\fRが動作中のDOSウィンドウで\fB[Ctrl]+[C]\fRキーを押します。一時ネーミング・サービスの場合は、サービスが終了されると、ネーミング・サービスに登録された名前が消去される場合があります。Java IDLネーム・サービスは、明示的に停止されるまで実行されます。 +ネーミング・サービスを停止するには、適切なオペレーティング・システム・コマンドを使用します。たとえば、Oracle Solaris上で\fBpkill\fR +\fBorbd\fRを実行したり、\fBorbd\fRが動作中のDOSウィンドウで\fB[Ctrl]+[C]\fRキーを押します。一時ネーミング・サービスの場合は、サービスが終了されると、ネーミング・サービスに登録された名前が消去される場合があります。Java IDLネーム・サービスは、明示的に停止されるまで実行されます。 .PP ORBDに付属するネーミング・サービスの詳細は、 http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlの「Naming Service」を参照してください .SH "サーバー・マネージャ" .PP -ORBDのサーバー・マネージャにアクセスして、永続サーバーを実行するには、\fIservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースです。\fIservertool\fRを使用してサーバーを起動する場合は、\fIorbd\fRが実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカル・コンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。 +ORBDのサーバー・マネージャにアクセスして、永続サーバーを実行するには、\fBservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンド行インタフェースです。\fBservertool\fRを使用してサーバーを起動する場合は、\fBorbd\fRが実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカル・コンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。 .PP http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlExample\&.htmlの 「Java IDL: The "Hello World" Example」を参照してください .PP -この例では、チュートリアルの手順に従って\fIidlj\fRコンパイラと\fIjavac\fRコンパイラを実行します。ORBDのサーバー・マネージャを実行するには、次の手順に従ってアプリケーションを実行します。 +この例では、チュートリアルの手順に従って\fBidlj\fRコンパイラと\fBjavac\fRコンパイラを実行します。ORBDのサーバー・マネージャを実行するには、次の手順に従ってアプリケーションを実行します。 .PP -\fIorbd\fRを起動します。 +\fBorbd\fRを起動します。 .PP -UNIXコマンド・シェルで次のように入力します: -\fIorbd \-ORBInitialPort 1050\fR。 +Solaris、LinuxまたはOS Xコマンド・シェルで、次のように入力します: +\fBorbd \-ORBInitialPort 1050\fR .PP MS\-DOSシステム・プロンプト(Windows)で次のように入力します: -\fIs\fR\fItart orbd \-ORBInitialPort 105\fR\fI0\fR +\fBs\fR\fBtart orbd \-ORBInitialPort 105\fR\fB0\fR .PP -ポート1050はネーム・サーバーを実行するポートです。\fI\-ORBInitialPort\fRオプションは必須コマンドライン引数です。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 +ポート1050はネーム・サーバーを実行するポートです。\fB\-ORBInitialPort\fRオプションは必須コマンド行引数です。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 .PP -\fIservertool\fRを起動します: -\fIservertool \-ORBInitialPort 1050\fR。 +\fBservertool\fRを起動します: +\fBservertool \-ORBInitialPort 1050\fR。 .PP -前回の手順とネーム・サーバー(\fIorbd\fR)のポートが同じであることを確認します。たとえば\fI\-ORBInitialPort 1050\&.\fRのようになります。\fIservertool\fRは、ネーム・サーバーと同じポート上で起動する必要があります。 +前回の手順とネーム・サーバー(\fBorbd\fR)のポートが同じであることを確認します。たとえば\fB\-ORBInitialPort 1050\&.\fRのようになります。\fBservertool\fRは、ネーム・サーバーと同じポート上で起動する必要があります。 .PP -\fIservertool\fRコマンドライン・インタフェースで、\fIservertool\fRプロンプトから\fIHello\fRサーバーを起動します。 +\fBservertool\fRコマンド行インタフェースで、\fBservertool\fRプロンプトから\fBHello\fRサーバーを起動します。 .sp .if n \{\ .RS 4 .\} .nf -servertool > register \-server HelloServer \-classpath \&. \-applicationName - HelloServerApName +\fBservertool > register \-server HelloServer \-classpath \&. \-applicationName\fR +\fB HelloServerApName\fR + .fi .if n \{\ .RE .\} .PP -\fIservertool\fRによってサーバーが登録されて、\fIHelloServerApName\fRという名前がサーバーに割り当てられ、登録されているすべてのサーバー一覧とともにサーバーIDが表示されます。他の端末ウィンドウまたはプロンプトからクライアント・アプリケーションを実行します。 +\fBservertool\fRによってサーバーが登録されて、\fBHelloServerApName\fRという名前がサーバーに割り当てられ、登録されているすべてのサーバー一覧とともにサーバーIDが表示されます。他の端末ウィンドウまたはプロンプトからクライアント・アプリケーションを実行します。 .sp .if n \{\ .RS 4 .\} .nf -java HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost +\fBjava HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost\fR + .fi .if n \{\ .RE .\} .PP -この例の\fI\-ORBInitialHost localhost\fRは省略することができます。ネーム・サーバーが\fIHello\fRクライアントとして同一ホスト上で動作しているからです。ネーム・サーバーが別のホストで実行されている場合は、\-\fIORBInitialHost nameserverhost\fRオプションを使用してIDLネーム・サーバーが実行されているホストを指定します。前の手順で行われたとおりにネーム・サーバー(\fIorbd\fR)ポートを指定します(例: -\fI\-ORBInitialPort 1050\fR)。ORBDのサーバー・マネージャの操作が終了したら、ネーム・サーバー(\fIorbd\fR)と\fIservertool\fRを停止するか終了してください。MS\-DOSプロンプトで\fIorbd\fRをシャットダウンするには、サーバーを実行しているウィンドウを選択して\fB[Ctrl]+[C]\fRキーを押します。 +この例の\fB\-ORBInitialHost localhost\fRは省略することができます。ネーム・サーバーが\fBHello\fRクライアントとして同一ホスト上で動作しているからです。ネーム・サーバーが別のホストで実行されている場合は、\-\fBORBInitialHost nameserverhost\fRオプションを使用してIDLネーム・サーバーが実行されているホストを指定します。前の手順で行われたとおりにネーム・サーバー(\fBorbd\fR)ポートを指定します(例: +\fB\-ORBInitialPort 1050\fR)。ORBDのサーバー・マネージャの操作が終了したら、ネーム・サーバー(\fBorbd\fR)と\fBservertool\fRを停止するか終了してください。MS\-DOSプロンプトで\fBorbd\fRをシャットダウンするには、サーバーを実行しているウィンドウを選択して\fB[Ctrl]+[C]\fRキーを押します。 .PP -Oracle Solarisから\fIorbd\fRをシャットダウンするには、プロセスを検索して、\fIkill\fRコマンドで終了します。サーバーを明示的に停止するまでは、呼出し待機状態が続きます。\fIservertool\fRをシャットダウンするには、\fBquit\fRと入力してキーボードの\fB[Enter]\fRキーを押します。 +Oracle Solarisから\fBorbd\fRをシャットダウンするには、プロセスを検索して、\fBkill\fRコマンドで終了します。サーバーを明示的に停止するまでは、呼出し待機状態が続きます。\fBservertool\fRをシャットダウンするには、\fBquit\fRと入力してキーボードの\fB[Enter]\fRキーを押します。 .SH "関連項目" .sp .RS 4
--- a/src/linux/doc/man/ja/pack200.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/pack200.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: pack200 -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Javaデプロイメント・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: pack200 +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Javaデプロイメント・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "pack200" "1" "2013年11月21日" "JDK 8" "Javaデプロイメント・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" pack200 \- WebデプロイメントのためにJARファイルをpack200圧縮ファイルにパッケージします。 .SH "概要" .sp @@ -56,17 +58,17 @@ .RS 4 .\} .nf -\fIpack200\fR [\fIoptions\fR] \fIoutput\-file\fR \fIJAR\-file\fR +\fBpack200\fR [\fIoptions\fR] \fIoutput\-file\fR \fIJAR\-file\fR .fi .if n \{\ .RE .\} .PP -オプションは任意の順序で指定できます。コマンドラインまたはpropertiesファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 +オプションは任意の順序で指定できます。コマンド行またはpropertiesファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIoutput\-file\fR @@ -80,31 +82,35 @@ .RE .SH "説明" .PP -\fIpack200\fRコマンドは、Java gzipコンプレッサを使用してJARファイルをpack200圧縮ファイルに変換するJavaアプリケーションです。pack200ファイルは高圧縮のファイルで、直接デプロイでき、帯域幅の節約やダウンロード時間の短縮が可能です。 +\fBpack200\fRコマンドは、Java gzipコンプレッサを使用してJARファイルをpack200圧縮ファイルに変換するJavaアプリケーションです。pack200ファイルは高圧縮のファイルで、直接デプロイでき、帯域幅の節約やダウンロード時間の短縮が可能です。 .PP -\fIpack200\fRコマンドには、圧縮エンジンの設定や微調整を行うオプションがあります。一般的な使用方法を次の例に示します。\fImyarchive\&.pack\&.gz\fRがデフォルトの\fIpack200\fRコマンド設定で作成されます。 +\fBpack200\fRコマンドには、圧縮エンジンの設定や微調整を行うオプションがあります。一般的な使用方法を次の例に示します。\fBmyarchive\&.pack\&.gz\fRがデフォルトの\fBpack200\fRコマンド設定で作成されます。 .sp .if n \{\ .RS 4 .\} .nf -pack200 myarchive\&.pack\&.gz myarchive\&.jar +\fBpack200 myarchive\&.pack\&.gz myarchive\&.jar\fR + .fi .if n \{\ .RE .\} .SH "オプション" .PP -\-r, \-\-repack +\-r +.br +\-\-repack .RS 4 -JARファイルをパックした後アンパックして、JARファイルを生成します。生成されたファイルは\fIjarsigner\fR(1)ツールの入力ファイルとして使用できます。次の例では、myarchive\&.jarファイルをパックした後、アンパックします。 +JARファイルをパックした後アンパックして、JARファイルを生成します。生成されたファイルは\fBjarsigner\fR(1)ツールの入力ファイルとして使用できます。次の例では、myarchive\&.jarファイルをパックした後、アンパックします。 .sp .if n \{\ .RS 4 .\} .nf -pack200 \-\-repack myarchive\-packer\&.jar myarchive\&.jar -pack200 \-\-repack myarchive\&.jar +\fBpack200 \-\-repack myarchive\-packer\&.jar myarchive\&.jar\fR +\fBpack200 \-\-repack myarchive\&.jar\fR + .fi .if n \{\ .RE @@ -112,24 +118,29 @@ 次の例では、入力ファイル内のファイルの順序を保持します。 .RE .PP -\-g, \-\-no\-gzip +\-g +.br +\-\-no\-gzip .RS 4 -\fIpack200\fRファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲット・システムでは、対応する圧縮解除ツールを使用する必要があります。 +\fBpack200\fRファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲット・システムでは、対応する圧縮解除ツールを使用する必要があります。 .sp .if n \{\ .RS 4 .\} .nf -pack200 \-\-no\-gzip myarchive\&.pack myarchive\&.jar +\fBpack200 \-\-no\-gzip myarchive\&.pack myarchive\&.jar\fR + .fi .if n \{\ .RE .\} .RE .PP -\-G, \-\-strip\-debug +\-G +.br +\-\-strip\-debug .RS 4 -出力からデバッグ属性を削除します。これには、\fISourceFile\fR、\fILineNumberTable\fR、\fILocalVariableTable\fR、\fILocalVariableTypeTable\fRが含まれます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。 +出力からデバッグ属性を削除します。これには、\fBSourceFile\fR、\fBLineNumberTable\fR、\fBLocalVariableTable\fR、\fBLocalVariableTypeTable\fRが含まれます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。 .RE .PP \-\-keep\-file\-order @@ -137,15 +148,19 @@ 入力ファイル内のファイルの順序を保持します。これは、デフォルトの動作です。 .RE .PP -\-O, \-\-no\-keep\-file\-order +\-O +.br +\-\-no\-keep\-file\-order .RS 4 パック・ツールは、すべての要素を並べ替えて送信します。パック・ツールは、JARディレクトリ名を削除してダウンロード・サイズを削減することもできます。ただし、インデックスなど、特定のJARファイルの最適化機能が正常に動作しなくなることがあります。 .RE .PP -\-S\fIvalue\fR, \-\-segment\-limit=\fIvalue\fR +\-S\fIvalue\fR +.br +\-\-segment\-limit=\fIvalue\fR .RS 4 この値は、各アーカイブ・セグメントの予想ターゲット・サイズ\fIN\fR -(バイト単位)です。単一の入力ファイルの必要サイズが\fIN\fRバイトを超えると、独立したセグメントが割り当てられます。特殊なケースとして、値が\fI\-1\fRの場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が0の場合は、クラスごとにセグメントが1つずつ生成されます。アーカイブ・セグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。 +(バイト単位)です。単一の入力ファイルの必要サイズが\fIN\fRバイトを超えると、独立したセグメントが割り当てられます。特殊なケースとして、値が\fB\-1\fRの場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が0の場合は、クラスごとにセグメントが1つずつ生成されます。アーカイブ・セグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。 .sp 各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前と他の送信されるプロパティのサイズを計算して推測されます。 .sp @@ -154,136 +169,169 @@ この制限が課されていない10 MBのJARパック・ファイルは通常、約10%小さくパックされます。しかし、パック・ツールでより大きなJavaヒープ(セグメントの制限の約10倍)を必要とする場合もあります。 .RE .PP -\-E\fIvalue\fR, \-\-effort=\fIvalue\fR +\-E\fIvalue\fR +.br +\-\-effort=\fIvalue\fR .RS 4 -単一の10進数値を指定した場合、パック・ツールは、指定された圧縮率でアーカイブを圧縮します。レベル1の場合は、比較的短い圧縮時間で多少大きめのファイルが生成されますが、レベル9の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値0を指定した場合は、\fIpack200\fRコマンドは元のJARファイルを圧縮なしで直接コピーします。JSR 200標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。 +単一の10進数値を指定した場合、パック・ツールは、指定された圧縮率でアーカイブを圧縮します。レベル1の場合は、比較的短い圧縮時間で多少大きめのファイルが生成されますが、レベル9の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値0を指定した場合は、\fBpack200\fRコマンドは元のJARファイルを圧縮なしで直接コピーします。JSR 200標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。 .sp デフォルトは5です。この場合、標準的な時間で適切な圧縮が行われます。 .RE .PP -\-H\fIvalue\fR, \-\-deflate\-hint=\fIvalue\fR +\-H\fIvalue\fR +.br +\-\-deflate\-hint=\fIvalue\fR .RS 4 -入力情報を保存するというデフォルト値をオーバーライドします。転送されるアーカイブのサイズは大きくなる場合があります。指定可能な値は、\fItrue\fR、\fIfalse\fRまたは\fIkeep\fRです。 +入力情報を保存するというデフォルト値をオーバーライドします。転送されるアーカイブのサイズは大きくなる場合があります。指定可能な値は、\fBtrue\fR、\fBfalse\fRまたは\fBkeep\fRです。 .sp -\fIvalue\fRが\fItrue\fRまたはfalseの場合、\fIpacker200\fRコマンドは指定に従ってデフレーション・ヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーション・ヒントは転送されません。 +\fBvalue\fRが\fBtrue\fRまたはfalseの場合、\fBpacker200\fRコマンドは指定に従ってデフレーション・ヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーション・ヒントは転送されません。 .sp -\fIkeep\fR値は、入力JARで確認されたデフレーション・ヒントを保持します。これがデフォルトです。 +\fBkeep\fR値は、入力JARで確認されたデフレーション・ヒントを保持します。これがデフォルトです。 .RE .PP -\-m\fIvalue\fR, \-\-modification\-time=\fIvalue\fR +\-m\fIvalue\fR +.br +\-\-modification\-time=\fIvalue\fR .RS 4 -指定可能な値は\fIlatest\fRと\fIkeep\fRです。 +指定可能な値は\fBlatest\fRと\fBkeep\fRです。 .sp 値が最新の場合、パック・ツールは、元のアーカイブの使用可能なすべてのエントリのうちの最終更新時刻か、そのセグメントの使用可能なすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストール・ファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。 .sp -値が\fIkeep\fRの場合、入力JARで確認された変更時間が保持されます。これがデフォルトです。 +値が\fBkeep\fRの場合、入力JARで確認された変更時間が保持されます。これがデフォルトです。 .RE .PP -\-P\fIfile\fR, \-\-pass\-file=\fIfile\fR +\-P\fIfile\fR +.br +\-\-pass\-file=\fIfile\fR .RS 4 -ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰返し使用して、複数のファイルを指定できます。システム・ファイル・セパレータがJARファイル・セパレータのスラッシュ(/)に置き換えられる点を除き、パス名の変換は行われません。結果として得られるファイル名は、文字列として正確にJARファイルでの出現と一致している必要があります。\fIfile\fRにディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。 +ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰返し使用して、複数のファイルを指定できます。システム・ファイル・セパレータがJARファイル・セパレータのスラッシュ(/)に置き換えられる点を除き、パス名の変換は行われません。結果として得られるファイル名は、文字列として正確にJARファイルでの出現と一致している必要があります。\fBfile\fRにディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。 .RE .PP -\-U\fIaction\fR, \-\-unknown\-attribute=\fIaction\fR +\-U\fIaction\fR +.br +\-\-unknown\-attribute=\fIaction\fR .RS 4 -デフォルトの動作をオーバーライドします。つまり、不明な属性を含むクラス・ファイルが、指定した\fIaction\fRによって渡されます。アクションとして指定可能な値は、\fIerror\fR、\fIstrip\fRまたは\fIpass\fRです。 +デフォルトの動作をオーバーライドします。つまり、不明な属性を含むクラス・ファイルが、指定した\fBaction\fRによって渡されます。アクションとして指定可能な値は、\fBerror\fR、\fBstrip\fRまたは\fBpass\fRです。 .sp -値が\fIerror\fRの場合、\fIpack200\fRコマンド操作全体が失敗して適切な説明が表示されます。 +値が\fBerror\fRの場合、\fBpack200\fRコマンド操作全体が失敗して適切な説明が表示されます。 .sp -値が\fIstrip\fRの場合、属性は削除されます。Java仮想マシン(JVM)必須属性を削除すると、クラス・ローダーの障害が発生することがあります。 +値が\fBstrip\fRの場合、属性は削除されます。Java Virtual Machine (JVM)必須属性を削除すると、クラス・ローダーの障害が発生することがあります。 .sp -値が\fIpass\fRの場合、クラス全体が1つのリソースとして転送されます。 +値が\fBpass\fRの場合、クラス全体が1つのリソースとして転送されます。 .RE .PP -\-C\fIattribute\-name\fR=\fIlayout\fR, \-\-class\-attribute=\fIattribute\-name\fR=\fIaction\fR +\-C\fIattribute\-name\fR=\fIlayout\fR +.br +\-\-class\-attribute=\fIattribute\-name\fR=\fIaction\fR .RS 4 次のオプションを参照してください。 .RE .PP -\-F\fIattribute\-name\fR=\fIlayout\fR, \-\-field\-attribute=\fIattribute\-name\fR=\fIaction\fR +\-F\fIattribute\-name\fR=\fIlayout\fR +.br +\-\-field\-attribute=\fIattribute\-name\fR=\fIaction\fR .RS 4 次のオプションを参照してください。 .RE .PP -\-M\fIattribute\-name\fR=\fIlayout\fR, \-\-method\-attribute=\fIattribute\-name\fR=\fIaction\fR +\-M\fIattribute\-name\fR=\fIlayout\fR +.br +\-\-method\-attribute=\fIattribute\-name\fR=\fIaction\fR .RS 4 次のオプションを参照してください。 .RE .PP -\-D\fIattribute\-name\fR=\fIlayout\fR, \-\-code\-attribute=\fIattribute\-name\fR=\fIaction\fR +\-D\fIattribute\-name\fR=\fIlayout\fR +.br +\-\-code\-attribute=\fIattribute\-name\fR=\fIaction\fR .RS 4 -前述の4つのオプションでは、クラス・エンティティに\fIclass\-attribute\fR、\fIfield\-attribute\fR、\fImethod\-attribute\fRおよび\fIcode\-attribute\fRなどの属性のレイアウトを指定できます。\fIattribute\-name\fRには、これからレイアウトまたはアクションを定義する属性の名前を指定します。\fIaction\fRとして指定可能な値は、\fIsome\-layout\-string\fR、\fIerror\fR、\fIstrip\fR、\fIpass\fRです。 +前述の4つのオプションでは、クラス・エンティティに\fBclass\-attribute\fR、\fBfield\-attribute\fR、\fBmethod\-attribute\fRおよび\fBcode\-attribute\fRなどの属性のレイアウトを指定できます。\fIattribute\-name\fRには、これからレイアウトまたはアクションを定義する属性の名前を指定します。\fIaction\fRとして指定可能な値は、\fBsome\-layout\-string\fR、\fBerror\fR、\fBstrip\fR、\fBpass\fRです。 .sp -\fIsome\-layout\-string\fR: レイアウト言語はJSR 200仕様で定義されています。例: -\fI\-\-class\-attribute=SourceFile=RUH\fR。 +\fBsome\-layout\-string\fR: レイアウト言語はJSR 200仕様で定義されています。例: +\fB\-\-class\-attribute=SourceFile=RUH\fR。 .sp -値が\fIerror\fRの場合、\fIpack200\fR操作が失敗して説明が表示されます。 +値が\fBerror\fRの場合、\fBpack200\fR操作が失敗して説明が表示されます。 .sp -値が\fIstrip\fRの場合、属性が出力から削除されます。VM必須属性を削除するとクラス・ローダーの障害が発生することがあります。たとえば、\fI\-\-class\-attribute=CompilationID=pass\fRというこの属性を含むクラス・ファイルを転送します。パック・ツールは、その他のアクションを行いません。 +値が\fBstrip\fRの場合、属性が出力から削除されます。VM必須属性を削除するとクラス・ローダーの障害が発生することがあります。たとえば、\fB\-\-class\-attribute=CompilationID=pass\fRというこの属性を含むクラス・ファイルを転送します。パック・ツールは、その他のアクションを行いません。 .sp -値が\fIpass\fRの場合、クラス全体が1つのリソースとして転送されます。 +値が\fBpass\fRの場合、クラス全体が1つのリソースとして転送されます。 .RE .PP -\-f \fIpack\&.properties\fR, \-\-config\-file=\fIpack\&.properties\fR +\-f \fIpack\&.properties\fR +.br +\-\-config\-file=\fIpack\&.properties\fR .RS 4 -コマンドラインに、パック・ツールを初期化するためのJavaプロパティが含まれている構成ファイルを指定できます。 +コマンド行に、パック・ツールを初期化するためのJavaプロパティが含まれている構成ファイルを指定できます。 .sp .if n \{\ .RS 4 .\} .nf -pack200 \-f pack\&.properties myarchive\&.pack\&.gz myarchive\&.jar -more pack\&.properties -# Generic properties for the packer\&. -modification\&.time=latest -deflate\&.hint=false -keep\&.file\&.order=false -# This option will cause the files bearing new attributes to -# be reported as an error rather than passed uncompressed\&. -unknown\&.attribute=error -# Change the segment limit to be unlimited\&. -segment\&.limit=\-1 +\fBpack200 \-f pack\&.properties myarchive\&.pack\&.gz myarchive\&.jar\fR +\fBmore pack\&.properties\fR +\fB# Generic properties for the packer\&.\fR +\fBmodification\&.time=latest\fR +\fBdeflate\&.hint=false\fR +\fBkeep\&.file\&.order=false\fR +\fB# This option will cause the files bearing new attributes to\fR +\fB# be reported as an error rather than passed uncompressed\&.\fR +\fBunknown\&.attribute=error\fR +\fB# Change the segment limit to be unlimited\&.\fR +\fBsegment\&.limit=\-1\fR + .fi .if n \{\ .RE .\} .RE .PP -\-v, \-\-verbose +\-v +.br +\-\-verbose .RS 4 最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが作成されます。 .RE .PP -\-q, \-\-quiet +\-q +.br +\-\-quiet .RS 4 メッセージを表示せずに動作するように指定します。 .RE .PP -\-l\fIfilename\fR, \-\-log\-file=\fIfilename\fR +\-l\fIfilename\fR +.br +\-\-log\-file=\fIfilename\fR .RS 4 出力メッセージのログ・ファイルを指定します。 .RE .PP -\-?, \-h, \-\-help +\-? +.br +\-h +.br +\-\-help .RS 4 このコマンドに関するヘルプ情報を出力します。 .RE .PP -\-V, \-\-version +\-V +.br +\-\-version .RS 4 このコマンドに関するバージョン情報を出力します。 .RE .PP \-J\fIoption\fR .RS 4 -指定されたオプションをJava仮想マシンに渡します。詳細は、java(1)コマンドのリファレンス・ページを参照してください。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。 +指定されたオプションをJava Virtual Machineに渡します。詳細は、java(1)コマンドのリファレンス・ページを参照してください。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。 .RE .SH "終了ステータス" .PP 次の終了値が返されます: 正常終了の場合は0、エラーが発生した場合は0より大きい値。 .SH "注意" .PP -このコマンドと\fIpack\fR(1)を混同しないでください。\fIpack\fRおよび\fIpack200\fRコマンドは、別々の製品です。 +このコマンドと\fBpack\fR(1)を混同しないでください。\fBpack\fRおよび\fBpack200\fRコマンドは、別々の製品です。 .PP JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。 .SH "関連項目"
--- a/src/linux/doc/man/ja/policytool.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/policytool.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: policytool -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: セキュリティ・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: policytool +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: セキュリティ・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "policytool" "1" "2013年11月21日" "JDK 8" "セキュリティ・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" policytool \- ユーティリティGUI経由で取得したユーザー入力に基づいて、プレーン・テキストのポリシー・ファイルを読み書きします。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIpolicytool\fR [ \fI\-file\fR ] [ \fIfilename\fR ] +\fBpolicytool\fR [ \fB\-file\fR ] [ \fIfilename\fR ] .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \-file .RS 4 -ポリシー・ファイルを読み込むように\fIpolicytool\fRに指示します。 +ポリシー・ファイルを読み込むように\fBpolicytool\fRに指示します。 .RE .PP \fIfilename\fR @@ -80,32 +82,34 @@ .RS 4 .\} .nf -policytool +\fBpolicytool\fR + .fi .if n \{\ .RE .\} .PP -\fIpolicytool\fRコマンドを実行し、指定されたファイルをロードします: +\fBpolicytool\fRコマンドを実行し、指定されたファイルをロードします: .sp .if n \{\ .RS 4 .\} .nf -policytool\-file mypolicyfile +\fBpolicytool\-file mypolicyfile\fR + .fi .if n \{\ .RE .\} .SH "説明" .PP -\fIpolicytool\fRコマンドは、管理者のGUIを呼び出します。これにより、システム管理者はローカル・ポリシー・ファイルの内容を管理できるようになります。ポリシー・ファイルは\fI\&.policy\fR拡張子を持つプレーンテキスト・ファイルで、ドメイン別にリモート・リクエスタを権限オブジェクトにマップします。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある +\fBpolicytool\fRコマンドは、管理者のGUIを呼び出します。これにより、システム管理者はローカル・ポリシー・ファイルの内容を管理できるようになります。ポリシー・ファイルは\fB\&.policy\fR拡張子を持つプレーンテキスト・ファイルで、ドメイン別にリモート・リクエスタを権限オブジェクトにマップします。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある 「Default Policy Implementation and Policy File Syntax」を参照してください .SH "オプション" .PP \-file .RS 4 -ポリシー・ファイルを読み込むように\fIpolicytool\fRに指示します。 +ポリシー・ファイルを読み込むように\fBpolicytool\fRに指示します。 .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/rmic.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/rmic.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: rmic -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Remote Method Invocation (RMI)ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: rmic +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Remote Method Invocation (RMI)ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "rmic" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" rmic \- Java Remote Method Protocol (JRMP)またはInternet Inter\-Orb protocol (IIOP)を使用するリモート・オブジェクトのスタブ、スケルトンおよびTieクラスを生成します。Object Management Group (OMG)インタフェース定義言語(IDL)も生成します .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIrmic\fR [ \fIoptions\fR ] \fIpackage\-qualified\-class\-names\fR +\fBrmic\fR [ \fIoptions\fR ] \fIpackage\-qualified\-class\-names\fR .fi .if n \{\ .RE @@ -64,26 +66,27 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・\fIオプション\fR。オプションを参照してください。 +コマンド行\fBオプション\fR。オプションを参照してください。 .RE .PP \fIpackage\-qualified\-class\-names\fR .RS 4 パッケージを含むクラス名。例: -\fIjava\&.awt\&.Color\fR。 +\fBjava\&.awt\&.Color\fR。 .RE .SH "説明" .PP \fB非推奨に関する注意:\fR -Java Remote Method Protocol (JRMP)スタブおよびスケルトンの静的な生成のサポートは非推奨になりました。動的に生成されるJRMPスタブをかわりに使用して、JRMPベースのアプリケーションにこのツールを使用する必要性をなくすことをお薦めします。詳細は、\fIjava\&.rmi\&.server\&.UnicastRemoteObject\fR仕様(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/server/UnicastRemoteObject\&.html)を参照してください。 +Java Remote Method Protocol (JRMP)スタブおよびスケルトンの静的な生成のサポートは非推奨になりました。動的に生成されるJRMPスタブをかわりに使用して、JRMPベースのアプリケーションにこのツールを使用する必要性をなくすことをお薦めします。詳細は、\fBjava\&.rmi\&.server\&.UnicastRemoteObject\fR仕様(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/server/UnicastRemoteObject\&.html)を参照してください。 .PP -\fIrmic\fRコンパイラは、Java Remote Method Protocol (JRMP)とスタブおよびTieクラス・ファイル(IIOPプロトコル)を使用して、リモート・オブジェクトのスタブおよびスケルトン・クラス・ファイルを生成します。リモート・オブジェクトの実装クラスであるこれらのクラス・ファイルは、Javaプログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、\fIjava\&.rmi\&.Remote\fRインタフェースを実装するクラスです。\fIrmic\fRコマンドでのクラス名は、そのクラスが\fIjavac\fRコマンドでコンパイルが成功していて、かつ完全修飾パッケージ名である必要があります。たとえば、次に示すクラス・ファイル名\fIHelloImpl\fRで\fIrmic\fRコマンドを実行すると、helloサブディレクトリ(クラスのパッケージの名前の付いた)に\fIHelloImpl_Stub\&.class \fRファイルが作成されます。 +\fBrmic\fRコンパイラは、Java Remote Method Protocol (JRMP)とスタブおよびTieクラス・ファイル(IIOPプロトコル)を使用して、リモート・オブジェクトのスタブおよびスケルトン・クラス・ファイルを生成します。リモート・オブジェクトの実装クラスであるこれらのクラス・ファイルは、Javaプログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、\fBjava\&.rmi\&.Remote\fRインタフェースを実装するクラスです。\fBrmic\fRコマンドでのクラス名は、そのクラスが\fBjavac\fRコマンドでコンパイルが成功していて、かつ完全修飾パッケージ名である必要があります。たとえば、次に示すクラス・ファイル名\fBHelloImpl\fRで\fBrmic\fRコマンドを実行すると、helloサブディレクトリ(クラスのパッケージの名前の付いた)に\fBHelloImpl_Stub\&.class \fRファイルが作成されます。 .sp .if n \{\ .RS 4 .\} .nf -rmic hello\&.HelloImpl +\fBrmic hello\&.HelloImpl\fR + .fi .if n \{\ .RE @@ -95,9 +98,9 @@ .PP スタブとは、リモート・オブジェクトのクライアント側での代理です。スタブは、リモート・オブジェクトのメソッド呼出しを、実物のリモート・オブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモート・オブジェクトへの参照は、実際はローカル・スタブへの参照となります。 .PP -デフォルトで\fIrmic\fRコマンドは、1\&.2 JRMPスタブ・プロトコル・バージョンのみを使用するスタブ・クラスを生成します。これは、\fI\-v1\&.2\fRオプションを指定した場合と同じ動作です。リリース5\&.0以前では\fI\-vcompat\fRオプションがデフォルトでした。IIOPプロトコル用のスタブおよびTieクラスを生成するには\fI\-iiop\fRオプションを使用します。オプションを参照してください。 +デフォルトで\fBrmic\fRコマンドは、1\&.2 JRMPスタブ・プロトコル・バージョンのみを使用するスタブ・クラスを生成します。これは、\fB\-v1\&.2\fRオプションを指定した場合と同じ動作です。リリース5\&.0以前では\fB\-vcompat\fRオプションがデフォルトでした。IIOPプロトコル用のスタブおよびTieクラスを生成するには\fB\-iiop\fRオプションを使用します。オプションを参照してください。 .PP -スタブはリモート・インタフェースのみを実装し、リモート・オブジェクトが実装するローカル・インタフェースは実装していません。JRMPスタブはリモート・オブジェクトが実装するリモート・インタフェースと同じものを実装しているので、クライアントは、キャストや型チェックにJavaプログラミング言語に組み込まれた演算子を使用することができます。IIOPの場合は、\fIPortableRemoteObject\&.narrow\fRメソッドを使用する必要があります。 +スタブはリモート・インタフェースのみを実装し、リモート・オブジェクトが実装するローカル・インタフェースは実装していません。JRMPスタブはリモート・オブジェクトが実装するリモート・インタフェースと同じものを実装しているので、クライアントは、キャストや型チェックにJavaプログラミング言語に組み込まれた演算子を使用することができます。IIOPの場合は、\fBPortableRemoteObject\&.narrow\fRメソッドを使用する必要があります。 .SH "オプション" .PP \-bootclasspath \fIpath\fR @@ -107,8 +110,8 @@ .PP \-classpath path .RS 4 -\fIrmic\fRコマンドがクラスを探すためのパスを指定します。このオプションは、デフォルトや\fICLASSPATH\fR環境変数設定をオーバーライドします。ディレクトリはコロンで分割します。パスの一般的な形式は\fI\&.;<your_path>\fRです。例: -\fI\&.;/usr/local/java/classes\fR +\fBrmic\fRコマンドがクラスを探すためのパスを指定します。このオプションは、デフォルトや\fBCLASSPATH\fR環境変数設定をオーバーライドします。ディレクトリはコロンで分割します。パスの一般的な形式は\fB\&.;<your_path>\fRです。例: +\fB\&.;/usr/local/java/classes\fR .RE .PP \-d \fIdirectory\fR @@ -119,12 +122,13 @@ .RS 4 .\} .nf -rmic \-d /java/classes exampleclass\&.MyClass +\fBrmic \-d /java/classes exampleclass\&.MyClass\fR + .fi .if n \{\ .RE .\} -\fI\-d\fRオプションが指定されていない場合、デフォルトの動作は\fI\-d\fRが指定されていた場合と同じです。ターゲット・クラスのパッケージ階層が現在のディレクトリに作成され、stub/tie/skeletonファイルが格納されます。以前のリリースの\fIrmic\fRコマンドでは、\fI\-d\fRが指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていました。 +\fB\-d\fRオプションが指定されていない場合、デフォルトの動作は\fB\-d\fRが指定されていた場合と同じです。ターゲット・クラスのパッケージ階層が現在のディレクトリに作成され、stub/tie/skeletonファイルが格納されます。以前のリリースの\fBrmic\fRコマンドでは、\fB\-d\fRが指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていました。 .RE .PP \-extdirs \fIpath\fR @@ -139,10 +143,10 @@ .PP \-idl .RS 4 -\fIrmic\fRコマンドによって、指定したクラスおよび参照されたクラスのOMG IDLが生成されます。IDLでは、プログラミング言語に依存せずに、宣言するだけでオブジェクトのAPIを指定することができます。IDLは、メソッドおよびデータの仕様として使用します。CORBAバインディングを提供する任意の言語で、メソッドおよびデータの作成および呼出しを行うことができます。これらの言語には、JavaおよびC++が含まれています。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/mapping/jidlMapping\&.htmlの +\fBrmic\fRコマンドによって、指定したクラスおよび参照されたクラスのOMG IDLが生成されます。IDLでは、プログラミング言語に依存せずに、宣言するだけでオブジェクトのAPIを指定することができます。IDLは、メソッドおよびデータの仕様として使用します。CORBAバインディングを提供する任意の言語で、メソッドおよびデータの作成および呼出しを行うことができます。これらの言語には、JavaおよびC++が含まれています。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/mapping/jidlMapping\&.htmlの 「Java IDL: IDL to Java Language Mapping」を参照してください .sp -\fI\-idl\fRオプションを使用するときには、他のオプションも指定できます。 +\fB\-idl\fRオプションを使用するときには、他のオプションも指定できます。 .sp .RS 4 .ie n \{\ @@ -152,18 +156,7 @@ .sp -1 .IP \(bu 2.3 .\} -既存のスタブ/Tie/IDLが入力クラスよりも新しい場合でも、\fI\-always\fRまたは\fI\-alwaysgenerate\fRオプションは再生成を強制します。 -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fI\-factory\fRオプションは、生成されたIDLで\fIfactory\fRキーワードを使用します。 +既存のスタブ/Tie/IDLが入力クラスよりも新しい場合でも、\fB\-always\fRまたは\fB\-alwaysgenerate\fRオプションは再生成を強制します。 .RE .sp .RS 4 @@ -174,15 +167,7 @@ .sp -1 .IP \(bu 2.3 .\} -The -\fI\-idlModule\fR -from J\fIavaPackage[\&.class]\fR -\fItoIDLModule\fR -specifies -\fIIDLEntity\fR -package mapping, for example: -\fI\-idlModule\fR -\fImy\&.module my::real::idlmod\fR\&. +\fB\-factory\fRオプションは、生成されたIDLで\fBfactory\fRキーワードを使用します。 .RE .sp .RS 4 @@ -193,27 +178,39 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-idlFile\fR -\fIfromJavaPackage[\&.class] toIDLFile\fR -specifies -\fIIDLEntity\fR -file mapping, for example: -\fI\-idlFile test\&.pkg\&.X TEST16\&.idl\fR\&. +J\fBavaPackage[\&.class]\fR +\fBtoIDLModule\fRの\fB\-idlModule\fRは\fBIDLEntity\fRパッケージ・マッピングを指定します。例: +\fB\-idlModule\fR +\fBmy\&.module my::real::idlmod\fR +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fB\-idlFile\fR +\fBfromJavaPackage[\&.class] toIDLFile\fRは\fBIDLEntity\fRファイル・マッピングを指定します。例: +\fB\-idlFile test\&.pkg\&.X TEST16\&.idl\fR .RE .RE .PP \-iiop .RS 4 -\fIrmic\fRコマンドによって、JRMPのスタブとスケルトン・クラスのかわりに、IIOPのスタブとTieクラスが生成されます。スタブ・クラスは、リモート・オブジェクトのローカル・プロキシで、クライアントからサーバーに呼出しを送信するときに使用されます。各リモート・インタフェースにはスタブ・クラスが必要です。スタブ・クラスによってリモート・インタフェースが実装されます。クライアントでリモート・オブジェクトを参照するときは、スタブを参照することになります。タイ・クラスは、サーバー側で着呼を処理し、その呼出しを適切な実装クラスにディスパッチするときに使用されます。各実装クラスには、タイ・クラスが必要です。 +\fBrmic\fRコマンドによって、JRMPのスタブとスケルトン・クラスのかわりに、IIOPのスタブとTieクラスが生成されます。スタブ・クラスは、リモート・オブジェクトのローカル・プロキシで、クライアントからサーバーに呼出しを送信するときに使用されます。各リモート・インタフェースにはスタブ・クラスが必要です。スタブ・クラスによってリモート・インタフェースが実装されます。クライアントでリモート・オブジェクトを参照するときは、スタブを参照することになります。タイ・クラスは、サーバー側で着呼を処理し、その呼出しを適切な実装クラスにディスパッチするときに使用されます。各実装クラスには、タイ・クラスが必要です。 .sp -\fI\-iiop\fRを使用して\fIrmic\fRコマンドを呼び出すと、次の命名規則に準拠したスタブとTieが生成されます。 +\fB\-iiop\fRを使用して\fBrmic\fRコマンドを呼び出すと、次の命名規則に準拠したスタブとTieが生成されます。 .sp .if n \{\ .RS 4 .\} .nf -_<implementationName>_stub\&.class -_<interfaceName>_tie\&.class +\fB_<implementationName>_stub\&.class\fR +\fB_<interfaceName>_tie\&.class\fR + .fi .if n \{\ .RE @@ -227,7 +224,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-iiop\fRオプションを使用するときには、他のオプションも指定できます。 +\fB\-iiop\fRオプションを使用するときには、他のオプションも指定できます。 .RE .sp .RS 4 @@ -238,7 +235,7 @@ .sp -1 .IP \(bu 2.3 .\} -既存のスタブ/Tie/IDLが入力クラスよりも新しい場合でも、\fI\-always\fRまたは\fI\-alwaysgenerate\fRオプションは再生成を強制します。 +既存のスタブ/Tie/IDLが入力クラスよりも新しい場合でも、\fB\-always\fRまたは\fB\-alwaysgenerate\fRオプションは再生成を強制します。 .RE .sp .RS 4 @@ -249,7 +246,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-nolocalstubs\fRオプションでは、同じプロセスのクライアントとサーバーに最適化されたスタブは作成されません。 +\fB\-nolocalstubs\fRオプションでは、同じプロセスのクライアントとサーバーに最適化されたスタブは作成されません。 .RE .sp .RS 4 @@ -260,7 +257,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-noValueMethods\fRオプションは\fI\-idl\fRオプションとともに使用する必要があります。\fI\-noValueMethods\fRオプションは、送信されるIDLに\fIvaluetype\fRメソッドおよび初期化子を追加できないようにします。このメソッドおよび初期化子は、valuetypeの場合はオプションです。\fI\-idl\fRオプションとともに\fI\-noValueMethods\fRオプションを指定しないかぎり生成されます。 +\fB\-noValueMethods\fRオプションは\fB\-idl\fRオプションとともに使用する必要があります。\fB\-noValueMethods\fRオプションは、送信されるIDLに\fBvaluetype\fRメソッドおよび初期化子を追加できないようにします。このメソッドおよび初期化子は、valuetypeの場合はオプションです。\fB\-idl\fRオプションとともに\fB\-noValueMethods\fRオプションを指定しないかぎり生成されます。 .RE .sp .RS 4 @@ -271,23 +268,23 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-poa\fRオプションは継承を\fIorg\&.omg\&.CORBA_2_3\&.portable\&.ObjectImpl\fRから\fIorg\&.omg\&.PortableServer\&.Servant\fRに変更します。ポータブル・オブジェクト・アダプタ(POA)の\fIPortableServer\fRモジュールは、ネイティブの\fIServant\fR型を定義します。Javaプログラミング言語では、\fIServant\fR型はJavaの\fIorg\&.omg\&.PortableServer\&.Servant\fRクラスにマップされます。これは、すべてのPOAサーバント実装のベース・クラスとして機能し、アプリケーション・プログラマが呼び出すことのできるいくつかのメソッド、およびPOAによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドを提供します。OMG IDL to Java Language Mapping Specification、CORBA V 2\&.3\&.1 ptc/00\-01\-08\&.pdfに準拠しています。 +\fB\-poa\fRオプションは継承を\fBorg\&.omg\&.CORBA_2_3\&.portable\&.ObjectImpl\fRから\fBorg\&.omg\&.PortableServer\&.Servant\fRに変更します。ポータブル・オブジェクト・アダプタ(POA)の\fBPortableServer\fRモジュールは、ネイティブの\fBServant\fR型を定義します。Javaプログラミング言語では、\fBServant\fR型はJavaの\fBorg\&.omg\&.PortableServer\&.Servant\fRクラスにマップされます。これは、すべてのPOAサーバント実装のベース・クラスとして機能し、アプリケーション・プログラマが呼び出すことのできるいくつかのメソッド、およびPOAによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドを提供します。OMG IDL to Java Language Mapping Specification、CORBA V 2\&.3\&.1 ptc/00\-01\-08\&.pdfに準拠しています。 .RE .RE .PP \-J .RS 4 -Javaコマンドとともに使用して、\fI\-J\fRオプションは\fI\-J\fRの後ろに続く引数をJavaインタプリタに渡します(\fI\-J\fRと引数の間にスペースは入れません)。 +Javaコマンドとともに使用して、\fB\-J\fRオプションは\fB\-J\fRの後ろに続く引数をJavaインタプリタに渡します(\fB\-J\fRと引数の間にスペースは入れません)。 .RE .PP \-keep or \-keepgenerated .RS 4 -スタブ、スケルトン、またはTieクラスのために生成された\fI\&.java\fRソース・ファイルを保持し、\fI\&.class\fRファイルと同じディレクトリに書き込みます。 +スタブ、スケルトン、またはTieクラスのために生成された\fB\&.java\fRソース・ファイルを保持し、\fB\&.class\fRファイルと同じディレクトリに書き込みます。 .RE .PP \-nowarn .RS 4 -警告をオフにします。\fI\-nowarn\fRオプションが使用される場合。コンパイラは警告を表示しません。 +警告をオフにします。\fB\-nowarn\fRオプションが使用される場合。コンパイラは警告を表示しません。 .RE .PP \-nowrite @@ -307,7 +304,7 @@ .PP \-v1\&.1 (非推奨) .RS 4 -1\&.1 JRMPスタブ・プロトコル・バージョンのみのスタブおよびスケルトン・クラスを生成します。\fI\-v1\&.1\fRオプションを使用できるのは、JDK 1\&.1から\fIrmic\fRコマンドで生成され、アップグレードできない(さらにダイナミック・クラス・ローディングを使用していない)、既存の静的デプロイされたスタブ・クラスに対し、直列化互換性のあるスタブ・クラスを生成する場合のみです。注意:このオプションは非推奨になりました。説明を参照してください。 +1\&.1 JRMPスタブ・プロトコル・バージョンのみのスタブおよびスケルトン・クラスを生成します。\fB\-v1\&.1\fRオプションを使用できるのは、JDK 1\&.1から\fBrmic\fRコマンドで生成され、アップグレードできない(さらにダイナミック・クラス・ローディングを使用していない)、既存の静的デプロイされたスタブ・クラスに対し、直列化互換性のあるスタブ・クラスを生成する場合のみです。注意:このオプションは非推奨になりました。説明を参照してください。 .RE .PP \-v1\&.2 (非推奨) @@ -319,7 +316,7 @@ CLASSPATH .RS 4 ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで区切られます。例: -\fI\&.:/usr/local/java/classes\fR +\fB\&.:/usr/local/java/classes\fR .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/rmid.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/rmid.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: rmid -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Remote Method Invocation (RMI)ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: rmid +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Remote Method Invocation (RMI)ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "rmid" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -rmid \- 起動システム・デーモンを開始すると、オブジェクトをJava仮想マシン(VM)に登録してアクティブ化できるようになります。 +.SH "名前" +rmid \- 起動システム・デーモンを開始すると、オブジェクトをJava Virtual Machine(VM)に登録してアクティブ化できるようになります。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIrmid\fR [\fIoptions\fR] +\fBrmid\fR [\fIoptions\fR] .fi .if n \{\ .RE @@ -64,48 +66,50 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .SH "説明" .PP -\fIrmid\fRコマンドは、起動システム・デーモンを開始します。起動システム・デーモンを開始してからでないと、アクティブ化可能オブジェクトをアクティブ化システムに登録したり、JVM内でアクティブ化したりすることができません。アクティブ化可能なオブジェクトを使用するプログラムの作成方法の詳細は、\fIアクティブ化の使用\fRに関するチュートリアル(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi/activation/overview\&.html)を参照してください +\fBrmid\fRコマンドは、起動システム・デーモンを開始します。起動システム・デーモンを開始してからでないと、アクティブ化可能オブジェクトをアクティブ化システムに登録したり、JVM内でアクティブ化したりすることができません。アクティブ化可能なオブジェクトを使用するプログラムの作成方法の詳細は、\fIアクティブ化の使用\fRに関するチュートリアル(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi/activation/overview\&.html)を参照してください .PP -\fIrmid\fRコマンドを実行し、次のようにセキュリティ・ポリシー・ファイルを指定して、デーモンを起動します。 +\fBrmid\fRコマンドを実行し、次のようにセキュリティ・ポリシー・ファイルを指定して、デーモンを起動します。 .sp .if n \{\ .RS 4 .\} .nf -rmid \-J\-Djava\&.security\&.policy=rmid\&.policy +\fBrmid \-J\-Djava\&.security\&.policy=rmid\&.policy\fR + .fi .if n \{\ .RE .\} .PP -\fIrmid\fRコマンドのOracleの実装を実行する場合、デフォルトでは、セキュリティ・ポリシー・ファイルを指定する必要があります。それは、\fIrmid\fRコマンドが起動グループ用にJVMを起動するために各\fIActivationGroupDesc\fR内の情報を使用できるかどうかを検証できるようにするためです特に、\fIActivationGroupDesc\fRコンストラクタに渡される\fICommandEnvironment\fRや任意のプロパティによって指定されるコマンドおよびオプションは、\fIrmid\fRコマンドのセキュリティ・ポリシー・ファイルの中で明示的に許可することが必要になりました。\fIsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値は、起動グループ用にJVMを起動するために\fIActivationGroupDesc\fR内の情報を使用できるかどうかを判断するときに\fIrmid\fRコマンドが使用するポリシーを決定します。詳細は、\-J\-Dsun\&.rmi\&.activation\&.execPolicy=policyオプションの説明を参照してください。 +\fBrmid\fRコマンドのOracleの実装を実行する場合、デフォルトでは、セキュリティ・ポリシー・ファイルを指定する必要があります。それは、\fBrmid\fRコマンドが起動グループ用にJVMを起動するために各\fBActivationGroupDesc\fR内の情報を使用できるかどうかを検証できるようにするためです特に、\fBActivationGroupDesc\fRコンストラクタに渡される\fBCommandEnvironment\fRや任意のプロパティによって指定されるコマンドおよびオプションは、\fBrmid\fRコマンドのセキュリティ・ポリシー・ファイルの中で明示的に許可することが必要になりました。\fBsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値は、起動グループ用にJVMを起動するために\fBActivationGroupDesc\fR内の情報を使用できるかどうかを判断するときに\fBrmid\fRコマンドが使用するポリシーを決定します。詳細は、\-J\-Dsun\&.rmi\&.activation\&.execPolicy=policyオプションの説明を参照してください。 .PP -\fIrmid\fRコマンドを実行すると、デフォルト・ポート1098でアクティベータと内部レジストリが起動され、\fIActivationSystem\fRがこの内部レジストリ内の名前\fIjava\&.rmi\&.activation\&.ActivationSystem\fRにバインドされます。 +\fBrmid\fRコマンドを実行すると、デフォルト・ポート1098でアクティベータと内部レジストリが起動され、\fBActivationSystem\fRがこの内部レジストリ内の名前\fBjava\&.rmi\&.activation\&.ActivationSystem\fRにバインドされます。 .PP -レジストリに他のポートを指定するには、\fIrmid\fRコマンドの実行時に\fI\-port\fRオプションを指定する必要があります。たとえば、次のコマンドは、レジストリのデフォルト・ポート1099で、起動システム・デーモンとレジストリを起動します。 +レジストリに他のポートを指定するには、\fBrmid\fRコマンドの実行時に\fB\-port\fRオプションを指定する必要があります。たとえば、次のコマンドは、レジストリのデフォルト・ポート1099で、起動システム・デーモンとレジストリを起動します。 .sp .if n \{\ .RS 4 .\} .nf -rmid \-J\-Djava\&.security\&.policy=rmid\&.policy \-port 1099 +\fBrmid \-J\-Djava\&.security\&.policy=rmid\&.policy \-port 1099\fR + .fi .if n \{\ .RE .\} .SH "必要に応じてRMIDを開始" .PP -\fIrmid\fRをコマンドラインから開始するには、\fIinetd\fR -(Oracle Solarisの場合)、または\fIxinetd\fR -(Linuxの場合)を構成して\fIrmid\fRを必要に応じて開始する方法もあります。 +\fBrmid\fRをコマンド行から開始するには、\fBinetd\fR +(Oracle Solarisの場合)、または\fBxinetd\fR +(Linuxの場合)を構成して\fBrmid\fRを必要に応じて開始する方法もあります。 .PP -RMIDを開始すると、\fISystem\&.inheritedChannel\fRメソッドを呼び出して、継承されたチャンネル(\fIinetd\fR/\fIxinetd\fRから継承)を取得しようとします。継承されたチャンネルがnullであるか、\fIjava\&.nio\&.channels\&.ServerSocketChannel\fRのインスタンスでなかった場合、RMIDはそのチャンネルは\fIinetd\fR/\fIxinetd\fRによって起動されたものではないと判断し、前述のように起動します。 +RMIDを開始すると、\fBSystem\&.inheritedChannel\fRメソッドを呼び出して、継承されたチャンネル(\fBinetd\fR/\fBxinetd\fRから継承)を取得しようとします。継承されたチャンネルがnullであるか、\fBjava\&.nio\&.channels\&.ServerSocketChannel\fRのインスタンスでなかった場合、RMIDはそのチャンネルは\fBinetd\fR/\fBxinetd\fRによって起動されたものではないと判断し、前述のように起動します。 .PP -継承されたチャンネルが\fIServerSocketChannel\fRインスタンスである場合は、RMIDはエクスポートするリモート・オブジェクト、つまり\fIjava\&.rmi\&.activation\&.ActivationSystem\fRがバインドされているレジストリと\fIjava\&.rmi\&.activation\&.Activator\fRリモート・オブジェクトに対するリクエストを受信するサーバー・ソケットとして、\fIServerSocketChannel\fRから取得した\fIjava\&.net\&.ServerSocket\fRを使用します。このモードでは、RMIDの動作は、次のことを除いて、コマンドラインから起動した場合と同じです。 +継承されたチャンネルが\fBServerSocketChannel\fRインスタンスである場合は、RMIDはエクスポートするリモート・オブジェクト、つまり\fBjava\&.rmi\&.activation\&.ActivationSystem\fRがバインドされているレジストリと\fBjava\&.rmi\&.activation\&.Activator\fRリモート・オブジェクトに対するリクエストを受信するサーバー・ソケットとして、\fBServerSocketChannel\fRから取得した\fBjava\&.net\&.ServerSocket\fRを使用します。このモードでは、RMIDの動作は、次のことを除いて、コマンド行から起動した場合と同じです。 .sp .RS 4 .ie n \{\ @@ -115,7 +119,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fISystem\&.err\fRに対する出力は、ファイルにリダイレクトされる。このファイルは\fIjava\&.io\&.tmpdir\fRシステム・プロパティで指定されるディレクトリ(通常は\fI/var/tmp\fRまたは\fI/tmp\fR)にある。ファイル名の接頭辞は\fIrmid\-err\fRで、接尾辞は\fItmp\fRである。 +\fBSystem\&.err\fRに対する出力は、ファイルにリダイレクトされる。このファイルは\fBjava\&.io\&.tmpdir\fRシステム・プロパティで指定されるディレクトリ(通常は\fB/var/tmp\fRまたは\fB/tmp\fR)にある。ファイル名の接頭辞は\fBrmid\-err\fRで、接尾辞は\fBtmp\fRである。 .RE .sp .RS 4 @@ -126,7 +130,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-port\fRオプションは使用できません。このオプションが指定されている場合、RMIDはエラー・メッセージが表示されて終了します。 +\fB\-port\fRオプションは使用できません。このオプションが指定されている場合、RMIDはエラー・メッセージが表示されて終了します。 .RE .sp .RS 4 @@ -137,34 +141,36 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-log\fRオプションは必須。このオプションが指定されていない場合、RMIDはエラー・メッセージが表示されて終了します。 +\fB\-log\fRオプションは必須。このオプションが指定されていない場合、RMIDはエラー・メッセージが表示されて終了します。 .RE .PP -必要に応じてサービスを開始するように構成する方法の詳細は、\fIinetd\fR -(Oracle Solarisの場合)、または\fIxinetd\fR +必要に応じてサービスを開始するように構成する方法の詳細は、\fBinetd\fR +(Oracle Solarisの場合)、または\fBxinetd\fR (Linux)のマニュアル・ページを参照してください。 .SH "オプション" .PP \-C\fIオプション\fR .RS 4 -\fIrmid\fRコマンドの子プロセス(起動グループ)が作成されたときに、それぞれの子プロセスにコマンドライン引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム・デーモンによって生成される各仮想マシンにプロパティを渡すことができます。 +\fBrmid\fRコマンドの子プロセス(起動グループ)が作成されたときに、それぞれの子プロセスにコマンド行引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム・デーモンによって生成される各仮想マシンにプロパティを渡すことができます。 .sp .if n \{\ .RS 4 .\} .nf -rmid \-C\-Dsome\&.property=value +\fBrmid \-C\-Dsome\&.property=value\fR + .fi .if n \{\ .RE .\} -コマンドライン引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のコマンドでは、すべての子JVMでserver\-callロギングが可能です。 +コマンド行引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のコマンドでは、すべての子JVMでserver\-callロギングが可能です。 .sp .if n \{\ .RS 4 .\} .nf -rmid \-C\-Djava\&.rmi\&.server\&.logCalls=true +\fBrmid \-C\-Djava\&.rmi\&.server\&.logCalls=true\fR + .fi .if n \{\ .RE @@ -173,13 +179,14 @@ .PP \-J\fIoption\fR .RS 4 -RMIDを実行しているJavaインタプリタに渡すオプションを指定します。たとえば、\fIrmid\fRコマンドが\fIrmid\&.policy\fRという名前のポリシー・ファイルを使用するように指定するには、\fIrmid\fRのコマンドラインで\fI\-J\fRオプションを使用して、\fIjava\&.security\&.policy\fRプロパティを定義します。次に例を示します。 +RMIDを実行しているJavaインタプリタに渡すオプションを指定します。たとえば、\fBrmid\fRコマンドが\fBrmid\&.policy\fRという名前のポリシー・ファイルを使用するように指定するには、\fBrmid\fRのコマンド行で\fB\-J\fRオプションを使用して、\fBjava\&.security\&.policy\fRプロパティを定義します。次に例を示します。 .sp .if n \{\ .RS 4 .\} .nf -rmid \-J\-Djava\&.security\&.policy\-rmid\&.policy +\fBrmid \-J\-Djava\&.security\&.policy\-rmid\&.policy\fR + .fi .if n \{\ .RE @@ -188,7 +195,7 @@ .PP \-J\-Dsun\&.rmi\&.activation\&.execPolicy=\fIpolicy\fR .RS 4 -起動グループが実行されることになるJVMの起動に使用するコマンドおよびコマンドライン・オプションをチェックするために、RMIDが採用するポリシーを指定します。このオプションは、Java RMI起動デーモンのOracleの実装のみに存在することに注意してください。コマンドラインにこのプロパティを指定しない場合、結果は\fI\-J\-Dsun\&.rmi\&.activation\&.execPolicy=default\fRを指定した場合と同じになります。\fIpolicy\fRに指定可能な値は、\fIdefault\fR、\fIpolicyClassName\fRまたは\fInone\fRです。 +起動グループが実行されることになるJVMの起動に使用するコマンドおよびコマンド行オプションをチェックするために、RMIDが採用するポリシーを指定します。このオプションは、Java RMI起動デーモンのOracleの実装のみに存在することに注意してください。コマンド行にこのプロパティを指定しない場合、結果は\fB\-J\-Dsun\&.rmi\&.activation\&.execPolicy=default\fRを指定した場合と同じになります。\fBpolicy\fRに指定可能な値は、\fBdefault\fR、\fBpolicyClassName\fRまたは\fBnone\fRです。 .sp .RS 4 .ie n \{\ @@ -200,65 +207,66 @@ .\} デフォルト .sp -\fIdefault\fRまたは未指定値の\fIexecPolicy\fRの場合、\fIrmid\fRコマンドが実行できるのは、\fIrmid\fRコマンドが使用するセキュリティ・ポリシー・ファイルの中で、実行する権限が\fIrmid\fRに与えられているコマンドおよびコマンドライン・オプションのみです。デフォルトの実行ポリシーで使用できるのは、デフォルトの起動グループ実装のみです。 +\fBdefault\fRまたは未指定値の\fBexecPolicy\fRの場合、\fBrmid\fRコマンドが実行できるのは、\fBrmid\fRコマンドが使用するセキュリティ・ポリシー・ファイルの中で、実行する権限が\fBrmid\fRに与えられているコマンドおよびコマンド行オプションのみです。デフォルトの実行ポリシーで使用できるのは、デフォルトの起動グループ実装のみです。 .sp -\fIrmid\fRコマンドは、起動グループ用のJVMを起動するときに、そのグループについて登録された起動グループ記述子である\fIActivationGroupDesc\fR内の情報を使用します。グループ記述子は、\fIActivationGroupDesc\&.CommandEnvironment\fRを指定します(省略可能)。これには、起動グループを開始するコマンドと、そのコマンドラインに追加できるコマンドライン・オプションが含まれています。デフォルトでは、\fIrmid\fRコマンドは\fIjava\&.home\fRにある\fIjava\fRコマンドを使用します。グループ記述子には、コマンドラインにオプションとして追加されるプロパティ・オーバーライドも含まれます(\fI\-D<property>=<value>\fRとして定義されます)。\fIcom\&.sun\&.rmi\&.rmid\&.ExecPermission\fR権限は\fIrmid\fRコマンドに、起動グループを開始するためにグループ記述子の\fICommandEnvironment\fRで指定されたコマンドを実行する権限を付与します。\fIcom\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR権限は起動グループの開始時に、グループ記述子でプロパティ・オーバーライドとして、または\fICommandEnvironment\fRでオプションとして指定されたコマンドライン・オプションを、\fIrmid\fRコマンドが使用することを許可します。\fIrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を付与する場合、権限\fIExecPermission\fRおよび\fIExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります。 +\fBrmid\fRコマンドは、起動グループ用のJVMを起動するときに、そのグループについて登録された起動グループ記述子である\fBActivationGroupDesc\fR内の情報を使用します。グループ記述子は、\fBActivationGroupDesc\&.CommandEnvironment\fRを指定します(省略可能)。これには、起動グループを開始するコマンドと、そのコマンド行に追加できるコマンド行オプションが含まれています。デフォルトでは、\fBrmid\fRコマンドは\fBjava\&.home\fRにある\fBjava\fRコマンドを使用します。グループ記述子には、コマンド行にオプションとして追加されるプロパティ・オーバーライドも含まれます(\fB\-D<property>=<value>\fRとして定義されます)。\fBcom\&.sun\&.rmi\&.rmid\&.ExecPermission\fR権限は\fBrmid\fRコマンドに、起動グループを開始するためにグループ記述子の\fBCommandEnvironment\fRで指定されたコマンドを実行する権限を付与します。\fBcom\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR権限は起動グループの開始時に、グループ記述子でプロパティ・オーバーライドとして、または\fBCommandEnvironment\fRでオプションとして指定されたコマンド行オプションを、\fBrmid\fRコマンドが使用することを許可します。\fBrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を付与する場合、権限\fBExecPermission\fRおよび\fBExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります。 .sp \fBExecPermission\fR .sp -\fIExecPermission\fRクラスは、起動グループを開始するために\fIrmid\fRコマンドが特定のコマンドを実行する権限を表します。 +\fBExecPermission\fRクラスは、起動グループを開始するために\fBrmid\fRコマンドが特定のコマンドを実行する権限を表します。 .sp \fB構文\fR: -\fIExecPermission\fRの名前は、\fIrmid\fRコマンドに実行を許可するコマンドのパス名です。スラッシュ(/)およびアスタリスク(*)で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。スラッシュはファイル区切り文字\fIFile\&.separatorChar\fRです。スラッシュ(/)およびマイナス符号(\-)で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ(再帰的に)を示します。パス名に特別なトークン\fI<<ALL FILES>>\fRを指定した場合は、任意のファイルを示します。 +\fBExecPermission\fRの名前は、\fBrmid\fRコマンドに実行を許可するコマンドのパス名です。スラッシュ(/)およびアスタリスク(*)で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。スラッシュはファイル区切り文字\fBFile\&.separatorChar\fRです。スラッシュ(/)およびマイナス符号(\-)で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ(再帰的に)を示します。特殊なトークン\fB<<ALL FILES>>\fRで構成されるパス名は、どのファイルとも一致します。 .sp パス名にアスタリスク(*)を指定した場合は、現在のディレクトリ内のすべてのファイルを示します。パス名にマイナス符号(\-)を指定した場合は、現在のディレクトリ内のすべてのファイルおよび(再帰的に)現在のディレクトリに含まれるすべてのファイルとサブディレクトリを示します。 .sp \fBExecOptionPermission\fR .sp -\fIExecOptionPermission\fRクラスは、起動グループを開始するときに\fIrmid\fRコマンドで特定のコマンドライン・オプションを使用できる権限を表します。\fIExecOptionPermission\fRの名前は、コマンドライン・オプションの値です。 +\fBExecOptionPermission\fRクラスは、起動グループを開始するときに\fBrmid\fRコマンドで特定のコマンド行オプションを使用できる権限を表します。\fBExecOptionPermission\fRの名前は、コマンド行オプションの値です。 .sp \fB構文\fR: オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカード・マッチを表します。アスタリスク(*)は、オプション名そのものとして使用できます。つまり、任意のオプションを表すことができます。また、オプション名の末尾に使用することもできます。ただし、ドット(\&.)か等号(=)の直後にアスタリスク(*)を指定する必要があります。 .sp 例: -\fI*\fRや\fI\-Dmydir\&.*\fRや\fI\-Da\&.b\&.c=*\fRは有効ですが、\fI*mydir\fRや\fI\-Da*b\fRや\fIab*\fRは無効です。 +\fB*\fRや\fB\-Dmydir\&.*\fRや\fB\-Da\&.b\&.c=*\fRは有効ですが、\fB*mydir\fRや\fB\-Da*b\fRや\fBab*\fRは無効です。 .sp \fBrmidのポリシー・ファイル\fR .sp -\fIrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を許可する場合は、権限\fIExecPermission\fRおよび\fIExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります(汎用的に)。これらの権限をチェックするのは\fIrmid\fRコマンドのみなので、これらの権限を汎用的に付与しても安全です。 +\fBrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を許可する場合は、権限\fBExecPermission\fRおよび\fBExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります(汎用的に)。これらの権限をチェックするのは\fBrmid\fRコマンドのみなので、これらの権限を汎用的に付与しても安全です。 .sp -\fIrmid\fRコマンドに各種の実行権限を付与するポリシー・ファイルの例を、次に示します。 +\fBrmid\fRコマンドに各種の実行権限を付与するポリシー・ファイルの例を、次に示します。 .sp .if n \{\ .RS 4 .\} .nf -grant { - permission com\&.sun\&.rmi\&.rmid\&.ExecPermission - "/files/apps/java/jdk1\&.7\&.0/solaris/bin/java"; - - permission com\&.sun\&.rmi\&.rmid\&.ExecPermission - "/files/apps/rmidcmds/*"; +\fBgrant {\fR +\fB permission com\&.sun\&.rmi\&.rmid\&.ExecPermission\fR +\fB "/files/apps/java/jdk1\&.7\&.0/solaris/bin/java";\fR +\fB \fR +\fB permission com\&.sun\&.rmi\&.rmid\&.ExecPermission\fR +\fB "/files/apps/rmidcmds/*";\fR +\fB \fR +\fB permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR +\fB "\-Djava\&.security\&.policy=/files/policies/group\&.policy";\fR +\fB \fR +\fB permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR +\fB "\-Djava\&.security\&.debug=*";\fR +\fB \fR +\fB permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR +\fB "\-Dsun\&.rmi\&.*";\fR +\fB};\fR - permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission - "\-Djava\&.security\&.policy=/files/policies/group\&.policy"; - - permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission - "\-Djava\&.security\&.debug=*"; - - permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission - "\-Dsun\&.rmi\&.*"; -}; .fi .if n \{\ .RE .\} -最初に付与されている権限は、\fIrmid\fRコマンドに対し、パス名により明示的に指定される\fIjava\fRコマンドの1\&.7\&.0リリースの実行を許可します。デフォルトでは、\fIjava\&.home\fRにあるバージョンの\fIjava\fRコマンドを使用します。\fIrmid\fRコマンドが使用するのと同じバージョンが使用されるため、そのコマンドは、ポリシー・ファイルで指定する必要はありません。2番目の権限は、\fIrmid\fRコマンドに対して、ディレクトリ\fI/files/apps/rmidcmds\fR内の任意のコマンドの実行権限を許可します。 +最初に付与されている権限は、\fBrmid\fRコマンドに対し、パス名により明示的に指定される\fBjava\fRコマンドの1\&.7\&.0リリースの実行を許可します。デフォルトでは、\fBjava\&.home\fRにあるバージョンの\fBjava\fRコマンドを使用します。\fBrmid\fRコマンドが使用するのと同じバージョンが使用されるため、そのコマンドは、ポリシー・ファイルで指定する必要はありません。2番目の権限は、\fBrmid\fRコマンドに対して、ディレクトリ\fB/files/apps/rmidcmds\fR内の任意のコマンドの実行権限を許可します。 .sp -3番目に付与されている権限\fIExecOptionPermission\fRは、\fIrmid\fRコマンドに対して、セキュリティ・ポリシー・ファイルを\fI/files/policies/group\&.policy\fRとして定義している起動グループの開始を許可します。次の権限は、起動グループが\fIjava\&.security\&.debug property\fRを使用することを許可しています。最後の権限は、起動グループが\fIsun\&.rmi property\fR名の階層内の任意のプロパティを使用することを許可しています。 +3番目に付与されている権限\fBExecOptionPermission\fRは、\fBrmid\fRコマンドに対して、セキュリティ・ポリシー・ファイルを\fB/files/policies/group\&.policy\fRとして定義している起動グループの開始を許可します。次の権限は、起動グループが\fBjava\&.security\&.debug property\fRを使用することを許可しています。最後の権限は、起動グループが\fBsun\&.rmi property\fR名の階層内の任意のプロパティを使用することを許可しています。 .sp -ポリシー・ファイルを指定して\fIrmid\fRコマンドを起動するには、\fIrmid\fRのコマンドラインで\fIjava\&.security\&.policy\fRプロパティを指定する必要があります。次に例を示します。 +ポリシー・ファイルを指定して\fBrmid\fRコマンドを起動するには、\fBrmid\fRのコマンド行で\fBjava\&.security\&.policy\fRプロパティを指定する必要があります。次に例を示します。 .sp -\fIrmid \-J\-Djava\&.security\&.policy=rmid\&.policy\fR\&. +\fBrmid \-J\-Djava\&.security\&.policy=rmid\&.policy\fR\&. .RE .sp .RS 4 @@ -271,21 +279,22 @@ .\} <policyClassName> .sp -デフォルトの動作では十分な柔軟性が得られない場合、管理者は、\fIrmid\fRの起動時に、\fIcheckExecCommand\fRメソッドが所属するクラスの名前を指定して、\fIrmid\fRコマンドが実行するコマンドをチェックすることができます。 +デフォルトの動作では十分な柔軟性が得られない場合、管理者は、\fBrmid\fRの起動時に、\fBcheckExecCommand\fRメソッドが所属するクラスの名前を指定して、\fBrmid\fRコマンドが実行するコマンドをチェックすることができます。 .sp -\fIpolicyClassName\fRには、引数なしのコンストラクタを持ち、次のような\fIcheckExecCommand\fRメソッドを実装しているpublicクラスを指定します。 +\fBpolicyClassName\fRには、引数なしのコンストラクタを持ち、次のような\fBcheckExecCommand\fRメソッドを実装しているpublicクラスを指定します。 .sp .if n \{\ .RS 4 .\} .nf - public void checkExecCommand(ActivationGroupDesc desc, String[] command) - throws SecurityException; +\fB public void checkExecCommand(ActivationGroupDesc desc, String[] command)\fR +\fB throws SecurityException;\fR + .fi .if n \{\ .RE .\} -起動グループを開始する前に、\fIrmid\fRコマンドは、ポリシーの\fIcheckExecCommand\fRメソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。\fIcheckExecCommand\fRが\fISecurityException\fRをスローすると、\fIrmid\fRコマンドはその起動グループを開始せず、オブジェクトの起動を試行している呼出し側には\fIActivationException\fRがスローされます。 +起動グループを開始する前に、\fBrmid\fRコマンドは、ポリシーの\fBcheckExecCommand\fRメソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。\fBcheckExecCommand\fRが\fBSecurityException\fRをスローすると、\fBrmid\fRコマンドはその起動グループを開始せず、オブジェクトの起動を試行している呼出し側には\fBActivationException\fRがスローされます。 .RE .sp .RS 4 @@ -298,28 +307,29 @@ .\} none .sp -\fIsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値が\fInone\fRの場合、\fIrmid\fRコマンドは、起動グループを開始するコマンドをまったく検証しません。 +\fBsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値が\fBnone\fRの場合、\fBrmid\fRコマンドは、起動グループを開始するコマンドをまったく検証しません。 .RE .RE .PP \-log \fIdir\fR .RS 4 -起動システム・デーモンがデータベースおよび関連情報を書き込むのに使用するディレクトリの名前を指定します。デフォルトでは、\fIrmid\fRコマンドを実行したディレクトリに、logというログ・ディレクトリが作成されます。 +起動システム・デーモンがデータベースおよび関連情報を書き込むのに使用するディレクトリの名前を指定します。デフォルトでは、\fBrmid\fRコマンドを実行したディレクトリに、logというログ・ディレクトリが作成されます。 .RE .PP \-port \fIport\fR .RS 4 -レジストリが使用するポートを指定します。起動システム・デーモンは、このレジストリの中で、\fIjava\&.rmi\&.activation\&.ActivationSystem\fRという名前で\fIActivationSystem\fRをバインドします。ローカル・マシン上の\fIActivationSystem\fRは、次のように\fINaming\&.lookup\fRメソッドを呼び出すことによって取得できます。 +レジストリが使用するポートを指定します。起動システム・デーモンは、このレジストリの中で、\fBjava\&.rmi\&.activation\&.ActivationSystem\fRという名前で\fBActivationSystem\fRをバインドします。ローカル・マシン上の\fBActivationSystem\fRは、次のように\fBNaming\&.lookup\fRメソッドを呼び出すことによって取得できます。 .sp .if n \{\ .RS 4 .\} .nf -import java\&.rmi\&.*; - import java\&.rmi\&.activation\&.*; +\fBimport java\&.rmi\&.*; \fR +\fB import java\&.rmi\&.activation\&.*;\fR +\fB \fR +\fB ActivationSystem system; system = (ActivationSystem)\fR +\fB Naming\&.lookup("//:port/java\&.rmi\&.activation\&.ActivationSystem");\fR - ActivationSystem system; system = (ActivationSystem) - Naming\&.lookup("//:port/java\&.rmi\&.activation\&.ActivationSystem"); .fi .if n \{\ .RE @@ -328,14 +338,14 @@ .PP \-stop .RS 4 -\fI\-port\fRオプションによって指定されたポートの、現在の\fIrmid\fRコマンドの呼出しを停止します。ポートが指定されていない場合は、このオプションはポート1098で実行されている\fIrmid\fRの呼出しを停止します。 +\fB\-port\fRオプションによって指定されたポートの、現在の\fBrmid\fRコマンドの呼出しを停止します。ポートが指定されていない場合は、このオプションはポート1098で実行されている\fBrmid\fRの呼出しを停止します。 .RE .SH "環境変数" .PP CLASSPATH .RS 4 ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで区切られます。例: -\fI\&.:/usr/local/java/classes\fR +\fB\&.:/usr/local/java/classes\fR .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/rmiregistry.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/rmiregistry.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: rmiregistry -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Remote Method Invocation (RMI)ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: rmiregistry +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Remote Method Invocation (RMI)ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "rmiregistry" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" rmiregistry \- 現在のホストの指定したポート上にリモート・オブジェクト・レジストリを開始します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIrmiregistry\fR [ \fIport\fR ] +\fBrmiregistry\fR [ \fIport\fR ] .fi .if n \{\ .RE @@ -64,17 +66,18 @@ .PP \fIport\fR .RS 4 -リモート・オブジェクト・レジストリを開始する現在のホスト上の\fIport\fRの数。 +リモート・オブジェクト・レジストリを開始する現在のホスト上の\fBport\fRの数。 .RE .SH "説明" .PP -\fIrmiregistry\fRコマンドは、現在のホストの指定したポート上にリモート・オブジェクト・レジストリを作成し、開始します。portの指定を省略した場合、レジストリはポート1099で開始します。\fIrmiregistry\fRコマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。次に例を示します。 +\fBrmiregistry\fRコマンドは、現在のホストの指定したポート上にリモート・オブジェクト・レジストリを作成し、開始します。portの指定を省略した場合、レジストリはポート1099で開始します。\fBrmiregistry\fRコマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。次に例を示します。 .sp .if n \{\ .RS 4 .\} .nf -rmiregistry & +\fBrmiregistry &\fR + .fi .if n \{\ .RE @@ -84,14 +87,14 @@ .PP レジストリは、一般的に、最初のリモート・オブジェクトの位置を指定します。そこで、アプリケーションはメソッドを呼び出す必要があります。その後、そのオブジェクトはアプリケーション指定のサポートを提供し、他のオブジェクトを探します。 .PP -\fIjava\&.rmi\&.registry\&.LocateRegistry\fRクラスのメソッドは、ローカル・ホスト、またはローカル・ホストとポートで動作するレジストリを取得するために使用されます。 +\fBjava\&.rmi\&.registry\&.LocateRegistry\fRクラスのメソッドは、ローカル・ホスト、またはローカル・ホストとポートで動作するレジストリを取得するために使用されます。 .PP -\fIjava\&.rmi\&.Naming\fRクラスのURLベース・メソッドはレジストリに対して操作を実行し、任意のホストおよびローカル・ホストでのリモート・オブジェクトの検索に使用できます。単純名(文字列)をリモート・オブジェクトにバインドし、新しい名前をリモート・オブジェクトに再バインドし(古いバインドをオーバーライド)、リモート・オブジェクトをアンバインドし、レジストリにバインドされているURLをリスト表示します。 +\fBjava\&.rmi\&.Naming\fRクラスのURLベース・メソッドはレジストリに対して操作を実行し、任意のホストおよびローカル・ホストでのリモート・オブジェクトの検索に使用できます。単純名(文字列)をリモート・オブジェクトにバインドし、新しい名前をリモート・オブジェクトに再バインドし(古いバインドをオーバーライド)、リモート・オブジェクトをアンバインドし、レジストリにバインドされているURLをリスト表示します。 .SH "オプション" .PP \-J .RS 4 -Javaオプションとともに使用して、\fI\-J\fRの後ろに続くオプションをJavaインタプリタに引き渡します(\fI\-J\fRとオプションの間にスペースは入れません)。 +Javaオプションとともに使用して、\fB\-J\fRの後ろに続くオプションをJavaインタプリタに引き渡します(\fB\-J\fRとオプションの間にスペースは入れません)。 .RE .SH "関連項目" .sp @@ -114,7 +117,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI「java\&.rmi\&.registry\&.LocateRegistry」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/registry/LocateRegistry\&.html) +\fB「java\&.rmi\&.registry\&.LocateRegistry」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/registry/LocateRegistry\&.html) .RE .sp .RS 4 @@ -125,7 +128,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI「java\&.rmi\&.Naming class description」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/Naming\&.html) +\fB「java\&.rmi\&.Naming class description」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/Naming\&.html) .RE .br 'pl 8.5i
--- a/src/linux/doc/man/ja/schemagen.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/schemagen.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: schemagen -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java Webサービス・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: schemagen +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java Webサービス・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "schemagen" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" schemagen \- Javaクラス内で参照されているネームスペースごとにスキーマを生成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIschemagen\fR [ \fIoptions\fR ] \fIjava\-files\fR +\fBschemagen\fR [ \fIoptions\fR ] \fIjava\-files\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIjava\-files\fR @@ -76,40 +78,41 @@ スキーマ・ジェネレータは、Javaクラス内で参照されているネームスペースごとに1つのスキーマ・ファイルを作成します。現在、生成されるスキーマ・ファイルの名前は制御できません。スキーマ・ファイル名を制御する場合は、http://jaxb\&.java\&.net/nonav/2\&.2\&.3u1/docs/schemagenTask\&.htmlにある 「Using SchemaGen with Ant」を参照してください .PP -プラットフォームのbinディレクトリにある適切な\fIschemagen\fRシェル・スクリプトを使用して、スキーマ・ジェネレータを起動します。現在のスキーマ・ジェネレータは、Javaソース・ファイルとクラス・ファイルのいずれも処理できます。 +プラットフォームのbinディレクトリにある適切な\fBschemagen\fRシェル・スクリプトを使用して、スキーマ・ジェネレータを起動します。現在のスキーマ・ジェネレータは、Javaソース・ファイルとクラス・ファイルのいずれも処理できます。 .sp .if n \{\ .RS 4 .\} .nf -schemagen\&.sh Foo\&.java Bar\&.java \&.\&.\&. -Note: Writing schema1\&.xsd +\fBschemagen\&.sh Foo\&.java Bar\&.java \&.\&.\&.\fR +\fBNote: Writing schema1\&.xsd\fR + .fi .if n \{\ .RE .\} .PP -javaファイルが他のクラスを参照している場合、それらのクラスにシステム\fICLASSPATH\fR環境変数でアクセスできる必要があります。または、クラス・パス・オプションを指定して\fIschemagen\fRコマンド・ラインで指定する必要があります。オプションを参照してください。参照されるファイルにアクセスできない、または参照されるファイルが指定されていない場合、スキーマの生成時にエラーが表示されます。 +javaファイルが他のクラスを参照している場合、それらのクラスにシステム\fBCLASSPATH\fR環境変数でアクセスできる必要があります。または、クラス・パス・オプションを指定して\fBschemagen\fRコマンド行で指定する必要があります。オプションを参照してください。参照されるファイルにアクセスできない、または参照されるファイルが指定されていない場合、スキーマの生成時にエラーが表示されます。 .SH "オプション" .PP \-d \fIpath\fR .RS 4 -\fIschemagen\fRコマンドがプロセッサ生成および\fIjavac\fR生成クラス・ファイルを配置する場所。 +\fBschemagen\fRコマンドがプロセッサ生成および\fBjavac\fR生成クラス・ファイルを配置する場所。 .RE .PP \-cp \fIpath\fR .RS 4 -\fIschemagen\fRコマンドがユーザー指定ファイルを配置する場所。 +\fBschemagen\fRコマンドがユーザー指定ファイルを配置する場所。 .RE .PP \-classpath \fIpath\fR .RS 4 -\fIschemagen\fRコマンドがユーザー指定ファイルを配置する場所。 +\fBschemagen\fRコマンドがユーザー指定ファイルを配置する場所。 .RE .PP \-encoding \fIencoding\fR .RS 4 -\fIapt\fRまたは\fIjavac\fRコマンドの呼出しに使用するエンコーディングを指定します。 +\fBapt\fRまたは\fBjavac\fRコマンドの呼出しに使用するエンコーディングを指定します。 .RE .PP \-episode \fIfile\fR
--- a/src/linux/doc/man/ja/serialver.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/serialver.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: serialver -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Remote Method Invocation (RMI)ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: serialver +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Remote Method Invocation (RMI)ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "serialver" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" serialver \- 指定したクラスのシリアル・バージョンUIDを戻します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIserialver\fR [ \fIoptions\fR ] [ \fIclassnames\fR ] +\fBserialver\fR [ \fIoptions\fR ] [ \fIclassnames\fR ] .fi .if n \{\ .RE @@ -64,16 +66,16 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIclassnames\fR .RS 4 -\fIserialVersionUID\fRを戻すクラスです。 +\fBserialVersionUID\fRを戻すクラスです。 .RE .SH "説明" .PP -\fIserialver\fRコマンドは、1つ以上のクラスの\fIserialVersionUID\fRを、展開しているクラスへコピーするのに適した形式で返します。引数なしで呼び出された場合、\fIserialver\fRコマンドは使用率行を出力します。 +\fBserialver\fRコマンドは、1つ以上のクラスの\fBserialVersionUID\fRを、展開しているクラスへコピーするのに適した形式で返します。引数なしで呼び出された場合、\fBserialver\fRコマンドは使用率行を出力します。 .SH "オプション" .PP \-classpath \fIpath\-files\fR @@ -83,22 +85,23 @@ .PP \-show .RS 4 -簡単なユーザー・インタフェースを表示します。完全指定のクラス名を入力して、Enterキーか「表示」ボタンを押し、\fIserialVersionUID\fRを表示します。 +簡単なユーザー・インタフェースを表示します。完全指定のクラス名を入力して、Enterキーか「表示」ボタンを押し、\fBserialVersionUID\fRを表示します。 .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシンに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineに\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "注意" .PP -\fIserialver\fRコマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティ・マネージャの設定は行いません。信頼できないクラスとともに\fIserialver\fRコマンドを実行する場合には、次のオプションを使用してセキュリティ・マネージャを設定できます。 +\fBserialver\fRコマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティ・マネージャの設定は行いません。信頼できないクラスとともに\fBserialver\fRコマンドを実行する場合には、次のオプションを使用してセキュリティ・マネージャを設定できます。 .sp .if n \{\ .RS 4 .\} .nf -\-J\-Djava\&.security\&.manager +\fB\-J\-Djava\&.security\&.manager\fR + .fi .if n \{\ .RE @@ -110,7 +113,8 @@ .RS 4 .\} .nf -\-J\-Djava\&.security\&.policy=<policy file> +\fB\-J\-Djava\&.security\&.policy=<policy file>\fR + .fi .if n \{\ .RE @@ -137,7 +141,7 @@ .IP \(bu 2.3 .\} http://docs\&.oracle\&.com/javase/8/docs/api/java/io/ObjectStreamClass\&.htmlにある -\fIjava\&.io\&.ObjectStream\fRクラス記述 +\fBjava\&.io\&.ObjectStream\fRクラス記述 .RE .br 'pl 8.5i
--- a/src/linux/doc/man/ja/servertool.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/servertool.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: servertool -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java IDLおよびRMI-IIOPツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: servertool +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java IDLおよびRMI-IIOPツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "servertool" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" servertool \- 開発者が永続サーバーを登録、登録解除、起動、停止するための使いやすいユーザー・インタフェースを提供します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIservertool\fR \-ORBInitialPort \fInameserverport\fR [ \fIoptions\fR ] [ \fIcommands \fR] +\fBservertool\fR \-ORBInitialPort \fInameserverport\fR [ \fIoptions\fR ] [ \fIcommands \fR] .fi .if n \{\ .RE @@ -64,35 +66,35 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP commands .RS 4 -コマンドライン・コマンド。コマンドを参照してください。 +コマンド行コマンド。コマンドを参照してください。 .RE .PP -\fIservertool\fR\fIservertool >\fR\fIservertool >\fR +\fBservertool\fR\fBservertool >\fR\fBservertool >\fR .SH "説明" .PP -\fIservertool\fRコマンドは、開発者が永続サーバーを登録、登録解除、起動、停止するためのコマンドライン・インタフェースを提供します。コマンドライン・コマンドを使用すると、サーバーに関する様々な統計情報を取得できます。コマンドを参照してください。 +\fBservertool\fRコマンドは、開発者が永続サーバーを登録、登録解除、起動、停止するためのコマンド行インタフェースを提供します。コマンド行コマンドを使用すると、サーバーに関する様々な統計情報を取得できます。コマンドを参照してください。 .SH "オプション" .PP \-ORBInitialHost \fInameserverhost\fR .RS 4 -このオプションは必須です。ネーム・サーバーが実行され、着信リクエストをリスニングするホスト・マシンを指定します。\fInameserverhost\fR値は、\fIorb\fRが実行され、リクエストをリスニングしているポートを指定する必要があります。このオプションを指定しない場合、値はデフォルトで\fIlocalhost\fRに設定されます。\fIorbd\fRと\fIservertool\fRが異なるマシン上で実行されている場合は、\fIorbd\fRが実行されているホストの名前またはIPアドレスを指定する必要があります。 +このオプションは必須です。ネーム・サーバーが実行され、着信リクエストをリスニングするホスト・マシンを指定します。\fBnameserverhost\fR値は、\fBorb\fRが実行され、リクエストをリスニングしているポートを指定する必要があります。このオプションを指定しない場合、値はデフォルトで\fBlocalhost\fRに設定されます。\fBorbd\fRと\fBservertool\fRが異なるマシン上で実行されている場合は、\fBorbd\fRが実行されているホストの名前またはIPアドレスを指定する必要があります。 .sp \fB注意:\fR -Oracle Solarisでは、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。\fInameserverport\fR値には、1024以上のポート番号を使用することをお薦めします。 +Oracle Solarisでは、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。\fBnameserverport\fR値には、1024以上のポート番号を使用することをお薦めします。 .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "コマンド" .PP -\fIservertool\fRコマンドは、コマンドライン・コマンドを使用して、または使用せずに起動できます。 +\fBservertool\fRコマンドは、コマンド行コマンドを使用して、または使用せずに起動できます。 .sp .RS 4 .ie n \{\ @@ -102,8 +104,8 @@ .sp -1 .IP \(bu 2.3 .\} -\fIservertool\fRの起動時にコマンドを指定しなかった場合、コマンドライン・ツールにコマンド入力を求める\fIservertool\fRプロンプトが表示されます: -\fIservertool >\fR。 +\fBservertool\fRの起動時にコマンドを指定しなかった場合、コマンド行ツールにコマンド入力を求める\fBservertool\fRプロンプトが表示されます: +\fBservertool >\fR。 .RE .sp .RS 4 @@ -114,23 +116,23 @@ .sp -1 .IP \(bu 2.3 .\} -\fIservertool\fRの起動時にコマンドを指定した場合、Java IDL Server Toolが起動してコマンドを実行し、終了します。 +\fBservertool\fRの起動時にコマンドを指定した場合、Java IDL Server Toolが起動してコマンドを実行し、終了します。 .RE .PP register \-server \fIserver\-class\-name\fR \-classpath \fIclasspath\-to\-server\fR [ \-applicationName \fIapplication\-name\fR \-args \fIargs\-to\-server\fR \-vmargs \fIflags\-for\-JVM\fR ] .RS 4 -Object Request Broker Daemon (ORBD)に新規永続サーバーを登録します。サーバーが未登録の場合、登録してアクティブ化します。このコマンドによって、\fI\-server\fRオプションで識別されるサーバーの\fIメイン\fR・クラス内でインストール・メソッドが呼び出されます。このインストール・メソッドは、\fIpublic static void install(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。インストール・メソッドはオプションであり、開発者はデータベース・スキーマの作成など独自のサーバー・インストール動作を指定できます。 +Object Request Broker Daemon (ORBD)に新規永続サーバーを登録します。サーバーが未登録の場合、登録してアクティブ化します。このコマンドによって、\fB\-server\fRオプションで識別されるサーバーの\fBメイン\fR・クラス内でインストール・メソッドが呼び出されます。このインストール・メソッドは、\fBpublic static void install(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。インストール・メソッドはオプションであり、開発者はデータベース・スキーマの作成など独自のサーバー・インストール動作を指定できます。 .RE .PP unregister \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR .RS 4 -サーバーIDまたはアプリケーション名で、サーバーをORBDから登録解除します。このコマンドによって、\fI\-server\fRオプションで識別されるサーバーの\fIメイン\fR・クラス内でアンインストール・メソッドが呼び出されます。 -\fIuninstall\fRメソッドは、\fIpublic static void uninstall(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。\fIuninstall\fRメソッドはオプションであり、開発者は\fIinstall\fRメソッドの動作の取消など、独自のサーバー・アンインストール動作を指定できます。 +サーバーIDまたはアプリケーション名で、サーバーをORBDから登録解除します。このコマンドによって、\fB\-server\fRオプションで識別されるサーバーの\fBメイン\fR・クラス内でアンインストール・メソッドが呼び出されます。 +\fBuninstall\fRメソッドは、\fBpublic static void uninstall(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。\fBuninstall\fRメソッドはオプションであり、開発者は\fBinstall\fRメソッドの動作の取消など、独自のサーバー・アンインストール動作を指定できます。 .RE .PP getserverid \-applicationName \fIapplication\-name\fR .RS 4 -\fIapplication\-name\fR値に対応するサーバーIDを返します。 +\fBapplication\-name\fR値に対応するサーバーIDを返します。 .RE .PP list @@ -150,22 +152,22 @@ .PP locate \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR [ \-endpointType \fIendpointType\fR ] .RS 4 -登録されたサーバーで作成したすべてのORBの特定のタイプについてエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fIendpointType\fR値が指定されていない場合、サーバーのORBごとに関連付けられているplainタイプまたはnon\-protectedタイプのエンドポイントが返されます。 +登録されたサーバーで作成したすべてのORBの特定のタイプについてエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fBendpointType\fR値が指定されていない場合、サーバーのORBごとに関連付けられているplainタイプまたはnon\-protectedタイプのエンドポイントが返されます。 .RE .PP locateperorb \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR [ \-orbid \fIORB\-name\fR ] .RS 4 -登録されたサーバーの特定のObject Request Broker (ORB)で登録されたエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fIorbid\fRが指定されていない場合、デフォルト値の\fI""\fRが\fIorbid\fRに割り当てられます。ORBが空文字列の\fIorbid\fRで作成されている場合、登録したポートがすべて返されます。 +登録されたサーバーの特定のObject Request Broker (ORB)で登録されたエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fBorbid\fRが指定されていない場合、デフォルト値の\fB""\fRが\fBorbid\fRに割り当てられます。ORBが空文字列の\fBorbid\fRで作成されている場合、登録したポートがすべて返されます。 .RE .PP orblist \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR .RS 4 -サーバー上に定義されたORBの\fIORBId\fRを一覧表示します。\fIORBId\fRはサーバーで作成されたORBの文字列名です。サーバーが実行されていない場合、アクティブ化されます。 +サーバー上に定義されたORBの\fBORBId\fRを一覧表示します。\fBORBId\fRはサーバーで作成されたORBの文字列名です。サーバーが実行されていない場合、アクティブ化されます。 .RE .PP shutdown \-serverid \fIserver\-id\fR | \-applicationName application\-name .RS 4 -ORBDに登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\fI\-serverid\fRパラメータまたは\fI\-applicationName\fRパラメータで指定されたクラス内に定義された\fIshutdown\fRメソッドも呼び出されてサーバー・プロセスを停止します。 +ORBDに登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\fB\-serverid\fRパラメータまたは\fB\-applicationName\fRパラメータで指定されたクラス内に定義された\fBshutdown\fRメソッドも呼び出されてサーバー・プロセスを停止します。 .RE .PP startup \-serverid \fIserver\-id\fR | \-applicationName application\-name @@ -175,12 +177,12 @@ .PP help .RS 4 -\fIservertool\fRコマンドを介してサーバーが利用できるすべてのコマンドをリストします。 +\fBservertool\fRコマンドを介してサーバーが利用できるすべてのコマンドをリストします。 .RE .PP quit .RS 4 -\fIservertool\fRコマンドを終了します。 +\fBservertool\fRコマンドを終了します。 .RE .SH "関連項目" .sp
--- a/src/linux/doc/man/ja/tnameserv.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/tnameserv.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: tnameserv -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java IDLおよびRMI-IIOPツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1999, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: tnameserv +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java IDLおよびRMI-IIOPツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "tnameserv" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" tnameserv \- インタフェース定義言語(IDL)。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fItnameserve\fR \fI\-ORBInitialPort\fR [ \fInameserverport\fR ] +\fBtnameserve\fR \fB\-ORBInitialPort\fR [ \fInameserverport\fR ] .fi .if n \{\ .RE @@ -64,16 +66,16 @@ .PP \-ORBInitialPort \fInameserverport\fR .RS 4 -ネーミング・サービスがORBの\fIresolve_initial_references\fRメソッドと\fIlist_initial_references\fRメソッドの実装に使用するブートストラップ・プロトコルをリスニングする初期ポートです。 +ネーミング・サービスがORBの\fBresolve_initial_references\fRメソッドと\fBlist_initial_references\fRメソッドの実装に使用するブートストラップ・プロトコルをリスニングする初期ポートです。 .RE .SH "説明" .PP -Java IDLには、Object Request Broker Daemon (ORBD)が含まれます。ORBDは、ブートストラップ・サービス、一時ネーミング・サービス、永続ネーミング・サービスおよびサーバー・マネージャを含むデーモン・プロセスです。Java IDLのすべてのチュートリアルではORBDを使用していますが、一時ネーミング・サービスを使用する例では、\fIorbd\fRのかわりに\fItnameserv\fRを使用できます。 +Java IDLには、Object Request Broker Daemon (ORBD)が含まれます。ORBDは、ブートストラップ・サービス、一時ネーミング・サービス、永続ネーミング・サービスおよびサーバー・マネージャを含むデーモン・プロセスです。Java IDLのすべてのチュートリアルではORBDを使用していますが、一時ネーミング・サービスを使用する例では、\fBorbd\fRのかわりに\fBtnameserv\fRを使用できます。 .PP -http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlにある -orbd(1)または「Naming Service」を参照してください。 +orbd(1)http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.html +にあるまたは「Naming Service」を参照してください。 .PP -CORBAのCOS (Common Object Services)ネーミング・サービスは、ファイル・システムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDLの一時ネーム・サービスである\fItnameserv\fRは、COSネーム・サービスの仕様を単純な形で実装したものです。 +CORBAのCOS (Common Object Services)ネーミング・サービスは、ファイル・システムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDLの一時ネーム・サービスである\fBtnameserv\fRは、COSネーム・サービスの仕様を単純な形で実装したものです。 .PP オブジェクト参照はネームスペースに名前で格納され、オブジェクト参照と名前のペアは、それぞれネーム・バインディングと呼ばれます。ネーム・バインディングはネーミング・コンテキストに組み込むことができます。ネーミング・コンテキストはネーム・バインディングであり、ファイル・システムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは初期ネーミング・コンテキストの下に格納されます。初期ネーミング・コンテキストは、ネームスペースの唯一の永続バインディングです。Java IDLネーミング・サービス・プロセスを停止して再起動すると、残りのネームスペースは失われます。 .PP @@ -81,28 +83,30 @@ .SS "ネーミング・サービスの起動" .PP Java IDLネーム・サービスは、ネーム・サービスを使用するアプリケーションまたはアプレットより前に起動しておく必要があります。Java IDL製品をインストールすると、Java IDLネーミング・サービスを起動するスクリプト(Oracle Solaris: -\fItnameserv\fR)または実行可能ファイル(Windows: -\fItnameserv\&.exe\fR)が作成されます。バックグラウンドで動作するように、ネーム・サービスを起動してください。 +\fBtnameserv\fR)または実行可能ファイル(Windows: +\fBtnameserv\&.exe\fR)が作成されます。バックグラウンドで動作するように、ネーム・サービスを起動してください。 .PP -特に指定しない場合、Java IDLネーミング・サービスは、ORBの\fIresolve_initial_references\fRメソッドと\fIlist_initial_references methods\fRメソッドの実装に使用するブートストラップ・プロトコルに対してポート900でリスニングします。 +特に指定しない場合、Java IDLネーミング・サービスは、ORBの\fBresolve_initial_references\fRメソッドと\fBlist_initial_references methods\fRメソッドの実装に使用するブートストラップ・プロトコルに対してポート900でリスニングします。 .sp .if n \{\ .RS 4 .\} .nf -tnameserv \-ORBInitialPort nameserverport& +\fBtnameserv \-ORBInitialPort nameserverport&\fR + .fi .if n \{\ .RE .\} .PP -ネーム・サーバー・ポートを指定しない場合、デフォルトでポート900が使用されます。Oracle Solarisソフトウェアの実行時、1024より小さいポートでプロセスを開始する場合は、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。1050のように別のポートを指定し、ネーム・サービスをバックグラウンドで実行するには、UNIXコマンド・シェルで次のように入力します。 +ネーム・サーバー・ポートを指定しない場合、デフォルトでポート900が使用されます。Oracle Solarisソフトウェアの実行時、1024より小さいポートでプロセスを開始する場合は、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。1050のように別のポートを指定し、ネーム・サービスをバックグラウンドで実行するには、Solaris、LinuxまたはOS Xコマンド・シェルで次のように入力します。 .sp .if n \{\ .RS 4 .\} .nf -tnameserv \-ORBInitialPort 1050& +\fBtnameserv \-ORBInitialPort 1050&\fR + .fi .if n \{\ .RE @@ -114,69 +118,73 @@ .RS 4 .\} .nf -start tnameserv \-ORBInitialPort 1050 +\fBstart tnameserv \-ORBInitialPort 1050\fR + .fi .if n \{\ .RE .\} .PP -ネーム・サーバーのクライアントには、新しいポート番号を知らせる必要があります。これを行うには、ORBオブジェクトの作成時に\fIorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティに新しいポート番号を設定します。 +ネーム・サーバーのクライアントには、新しいポート番号を知らせる必要があります。これを行うには、ORBオブジェクトの作成時に\fBorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティに新しいポート番号を設定します。 .SS "異なるホスト上でのサーバーとクライアントの実行" .PP Java IDLとRMI\-IIOPのほとんどのチュートリアルでは、ネーミング・サービス、サーバーおよびクライアントはすべて開発用のマシン上で実行されます。実際にデプロイメントする場合には、クライアントとサーバーを、ネーミング・サービスとは異なるホスト・マシン上で実行することが多くなります。 .PP -クライアントとサーバーがネーム・サービスを見つけるには、クライアントとサーバーが、ネーム・サービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の\fIorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティと\fIorg\&.omg\&.CORBA\&.ORBInitialHost\fRプロパティをネーム・サービスが実行されているポートの番号とマシンの名前に設定します。この例は、「Getting Started Using RMI\-IIOP」 +クライアントとサーバーがネーム・サービスを見つけるには、クライアントとサーバーが、ネーム・サービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の\fBorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティと\fBorg\&.omg\&.CORBA\&.ORBInitialHost\fRプロパティをネーム・サービスが実行されているポートの番号とマシンの名前に設定します。この例は、「Getting Started Using RMI\-IIOP」 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi\-iiop/rmiiiopexample\&.html)に示されています .PP -コマンドライン・オプション\fI\-ORBInitialPort nameserverport#\fRと\fI\-ORBInitialHost nameserverhostname\fRを使用して、クライアントとサーバーに対してネーミング・サービスを探す場所を指定することもできます。コマンドライン・オプションを使用してこれを行う方法の1つの例は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/tutorial/jidl2machines\&.htmlの「Java IDL: The Hello World Example on Two Machines」 +コマンド行オプション\fB\-ORBInitialPort nameserverport#\fRと\fB\-ORBInitialHost nameserverhostname\fRを使用して、クライアントとサーバーに対してネーミング・サービスを探す場所を指定することもできます。コマンド行オプションを使用してこれを行う方法の1つの例は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/tutorial/jidl2machines\&.htmlの「Java IDL: The Hello World Example on Two Machines」 を参照してください .PP -たとえば、一時ネーム・サービス\fItnameserv\fRが、ホスト\fInameserverhost\fRのポート1050上で実行されているとします。さらに、クライアントがホスト\fIclienthost\fR上で実行され、サーバーはホスト\fIserverhost\fR上で実行されているとします。 +たとえば、一時ネーム・サービス\fBtnameserv\fRが、ホスト\fBnameserverhost\fRのポート1050上で実行されているとします。さらに、クライアントがホスト\fBclienthost\fR上で実行され、サーバーはホスト\fBserverhost\fR上で実行されているとします。 .PP -ホスト\fInameserverhost\fR上で\fItnameserv\fRを起動します。 +ホスト\fBnameserverhost\fR上で\fBtnameserv\fRを起動します。 .sp .if n \{\ .RS 4 .\} .nf -tnameserv \-ORBInitialPort 1050 +\fBtnameserv \-ORBInitialPort 1050\fR + .fi .if n \{\ .RE .\} .PP -\fIserverhost\fR上でサーバーを起動します。 +\fBserverhost\fR上でサーバーを起動します。 .sp .if n \{\ .RS 4 .\} .nf -java Server \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost +\fBjava Server \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost\fR + .fi .if n \{\ .RE .\} .PP -\fIclienthost\fR上でクライアントを起動します。 +\fBclienthost\fR上でクライアントを起動します。 .sp .if n \{\ .RS 4 .\} .nf -java Client \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost +\fBjava Client \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost\fR + .fi .if n \{\ .RE .\} .SS "ネーミング・サービスの停止" .PP -Java IDLネーミング・サービスを停止するには、Unixの場合は、\fIkill\fRなどのオペレーティング・システムのコマンドを使用し、Windowsの場合は、\fI[Ctrl]+[C]\fRキーを使用します。ネーミング・サービスを明示的に停止するまでは、呼出し待機状態が続きます。サービスを終了させると、Java IDLネーム・サービスに登録されている名前は失われます。 +Java IDLネーミング・サービスを停止するには、Solaris、LinuxまたはOS Xの場合は、\fBkill\fRなどのオペレーティング・システムのコマンドを使用し、Windowsの場合は、\fB[Ctrl]+[C]\fRキーを使用します。ネーミング・サービスを明示的に停止するまでは、呼出し待機状態が続きます。サービスを終了させると、Java IDLネーム・サービスに登録されている名前は失われます。 .SH "オプション" .PP \-J\fIoption\fR .RS 4 -Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "例" .SS "ネームスペースへのオブジェクトの追加" @@ -187,115 +195,122 @@ .RS 4 .\} .nf -Initial Naming Context - plans - Personal - calendar - schedule +\fBInitial Naming Context\fR +\fB plans\fR +\fB Personal\fR +\fB calendar\fR +\fB schedule\fR + .fi .if n \{\ .RE .\} .PP -この例で、\fIplans\fRはオブジェクト参照、\fIPersonal\fRは\fIcalendar\fRと\fIschedule\fRの2つのオブジェクト参照を含むネーミング・コンテキストです。 +この例で、\fBplans\fRはオブジェクト参照、\fBPersonal\fRは\fBcalendar\fRと\fBschedule\fRの2つのオブジェクト参照を含むネーミング・コンテキストです。 .sp .if n \{\ .RS 4 .\} .nf -import java\&.util\&.Properties; -import org\&.omg\&.CORBA\&.*; -import org\&.omg\&.CosNaming\&.*; +\fBimport java\&.util\&.Properties;\fR +\fBimport org\&.omg\&.CORBA\&.*;\fR +\fBimport org\&.omg\&.CosNaming\&.*;\fR +\fB \fR +\fBpublic class NameClient {\fR -public class NameClient { - - public static void main(String args[]) { - - try { +\fB public static void main(String args[]) {\fR + +\fB try {\fR + .fi .if n \{\ .RE .\} .PP -ネーミング・サービスの起動で、\fInameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。 +ネーミング・サービスの起動で、\fBnameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。 .sp .if n \{\ .RS 4 .\} .nf - Properties props = new Properties(); - props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050"); - ORB orb = ORB\&.init(args, props); +\fB Properties props = new Properties();\fR +\fB props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fR +\fB ORB orb = ORB\&.init(args, props);\fR + .fi .if n \{\ .RE .\} .PP -次のコードでは、初期ネーミング・コンテキストを取得し、それを\fIctx\fRに代入します。2行目では、\fIctx\fRをダミーのオブジェクト参照\fIobjref\fRにコピーします。このobjrefには、あとで様々な名前を割り当ててネームスペースに追加します。 +次のコードでは、初期ネーミング・コンテキストを取得し、それを\fBctx\fRに代入します。2行目では、\fBctx\fRをダミーのオブジェクト参照\fBobjref\fRにコピーします。このobjrefには、あとで様々な名前を割り当ててネームスペースに追加します。 .sp .if n \{\ .RS 4 .\} .nf - NamingContext ctx = - NamingContextHelper\&.narrow( - orb\&.resolve_initial_references("NameService")); - NamingContext objref = ctx; +\fB NamingContext ctx =\fR +\fB NamingContextHelper\&.narrow(\fR +\fB orb\&.resolve_initial_references("NameService"));\fR +\fB NamingContext objref = ctx;\fR + .fi .if n \{\ .RE .\} .PP -次のコードでは、\fItext\fRタイプの名前\fIplans\fRを作成し、それをダミーのオブジェクト参照にバインドします。その後、\fIrebind\fRメソッドを使用して初期ネーミング・コンテキストの下に\fIplans\fRを追加しています。\fIrebind\fRメソッドを使用すれば、\fIbind\fRメソッドを使用した場合に発生する例外を発生させずに、このプログラムを何度も繰返し実行できます。 +次のコードでは、\fBtext\fRタイプの名前\fBplans\fRを作成し、それをダミーのオブジェクト参照にバインドします。その後、\fBrebind\fRメソッドを使用して初期ネーミング・コンテキストの下に\fBplans\fRを追加しています。\fBrebind\fRメソッドを使用すれば、\fBbind\fRメソッドを使用した場合に発生する例外を発生させずに、このプログラムを何度も繰返し実行できます。 .sp .if n \{\ .RS 4 .\} .nf - NameComponent nc1 = new NameComponent("plans", "text"); - NameComponent[] name1 = {nc1}; - ctx\&.rebind(name1, objref); - System\&.out\&.println("plans rebind successful!"); +\fB NameComponent nc1 = new NameComponent("plans", "text");\fR +\fB NameComponent[] name1 = {nc1};\fR +\fB ctx\&.rebind(name1, objref);\fR +\fB System\&.out\&.println("plans rebind successful!");\fR + .fi .if n \{\ .RE .\} .PP -次のコードでは、\fIdirectory\fRタイプの\fIPersonal\fRというネーミング・コンテキストを作成します。その結果得られるオブジェクト参照\fIctx2\fRを\fIname\fRにバインドし、初期ネーミング・コンテキストに追加します。 +次のコードでは、\fBdirectory\fRタイプの\fBPersonal\fRというネーミング・コンテキストを作成します。その結果得られるオブジェクト参照\fBctx2\fRを\fBname\fRにバインドし、初期ネーミング・コンテキストに追加します。 .sp .if n \{\ .RS 4 .\} .nf - NameComponent nc2 = new NameComponent("Personal", "directory"); - NameComponent[] name2 = {nc2}; - NamingContext ctx2 = ctx\&.bind_new_context(name2); - System\&.out\&.println("new naming context added\&.\&."); +\fB NameComponent nc2 = new NameComponent("Personal", "directory");\fR +\fB NameComponent[] name2 = {nc2};\fR +\fB NamingContext ctx2 = ctx\&.bind_new_context(name2);\fR +\fB System\&.out\&.println("new naming context added\&.\&.");\fR + .fi .if n \{\ .RE .\} .PP -残りのコードでは、ダミーのオブジェクト参照を\fIschedule\fRと\fIcalendar\fRという名前でネーミング・コンテキスト\fIPersonal\fR(\fIctx2\fR)にバインドします。 +残りのコードでは、ダミーのオブジェクト参照を\fBschedule\fRと\fBcalendar\fRという名前でネーミング・コンテキスト\fBPersonal\fR(\fBctx2\fR)にバインドします。 .sp .if n \{\ .RS 4 .\} .nf - NameComponent nc3 = new NameComponent("schedule", "text"); - NameComponent[] name3 = {nc3}; - ctx2\&.rebind(name3, objref); - System\&.out\&.println("schedule rebind successful!"); +\fB NameComponent nc3 = new NameComponent("schedule", "text");\fR +\fB NameComponent[] name3 = {nc3};\fR +\fB ctx2\&.rebind(name3, objref);\fR +\fB System\&.out\&.println("schedule rebind successful!");\fR +\fB \fR +\fB NameComponent nc4 = new NameComponent("calender", "text");\fR +\fB NameComponent[] name4 = {nc4};\fR +\fB ctx2\&.rebind(name4, objref);\fR +\fB System\&.out\&.println("calender rebind successful!");\fR +\fB } catch (Exception e) {\fR +\fB e\&.printStackTrace(System\&.err);\fR +\fB }\fR +\fB }\fR +\fB}\fR - NameComponent nc4 = new NameComponent("calender", "text"); - NameComponent[] name4 = {nc4}; - ctx2\&.rebind(name4, objref); - System\&.out\&.println("calender rebind successful!"); - } catch (Exception e) { - e\&.printStackTrace(System\&.err); - } - } -} .fi .if n \{\ .RE @@ -308,29 +323,31 @@ .RS 4 .\} .nf -import java\&.util\&.Properties; -import org\&.omg\&.CORBA\&.*; -import org\&.omg\&.CosNaming\&.*; +\fBimport java\&.util\&.Properties;\fR +\fBimport org\&.omg\&.CORBA\&.*;\fR +\fBimport org\&.omg\&.CosNaming\&.*;\fR +\fB \fR +\fBpublic class NameClientList {\fR -public class NameClientList { - - public static void main(String args[]) { - - try { +\fB public static void main(String args[]) {\fR + +\fB try {\fR + .fi .if n \{\ .RE .\} .PP -ネーミング・サービスの起動で、\fInameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。 +ネーミング・サービスの起動で、\fBnameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。 .sp .if n \{\ .RS 4 .\} .nf - Properties props = new Properties(); - props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050"); - ORB orb = ORB\&.init(args, props); +\fB Properties props = new Properties();\fR +\fB props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fR +\fB ORB orb = ORB\&.init(args, props);\fR + .fi .if n \{\ .RE @@ -342,36 +359,39 @@ .RS 4 .\} .nf - NamingContext nc = - NamingContextHelper\&.narrow( - orb\&.resolve_initial_references("NameService")); +\fB NamingContext nc =\fR +\fB NamingContextHelper\&.narrow(\fR +\fB orb\&.resolve_initial_references("NameService"));\fR + .fi .if n \{\ .RE .\} .PP -\fIlist\fRメソッドは、ネーミング・コンテキストのバインディングをリストします。この場合、最大1000個までのバインディングが初期ネーミング・コンテキストから\fIBindingListHolder\fRに返されます。残りのバインディングは、\fIBindingIteratorHolder\fRに返されます。 +\fBlist\fRメソッドは、ネーミング・コンテキストのバインディングをリストします。この場合、最大1000個までのバインディングが初期ネーミング・コンテキストから\fBBindingListHolder\fRに返されます。残りのバインディングは、\fBBindingIteratorHolder\fRに返されます。 .sp .if n \{\ .RS 4 .\} .nf - BindingListHolder bl = new BindingListHolder(); - BindingIteratorHolder blIt= new BindingIteratorHolder(); - nc\&.list(1000, bl, blIt); +\fB BindingListHolder bl = new BindingListHolder();\fR +\fB BindingIteratorHolder blIt= new BindingIteratorHolder();\fR +\fB nc\&.list(1000, bl, blIt);\fR + .fi .if n \{\ .RE .\} .PP -次のコードでは、返された\fIBindingListHolder\fRからバインディングの配列を取得します。バインディングがない場合は、プログラムが終了します。 +次のコードでは、返された\fBBindingListHolder\fRからバインディングの配列を取得します。バインディングがない場合は、プログラムが終了します。 .sp .if n \{\ .RS 4 .\} .nf - Binding bindings[] = bl\&.value; - if (bindings\&.length == 0) return; +\fB Binding bindings[] = bl\&.value;\fR +\fB if (bindings\&.length == 0) return;\fR + .fi .if n \{\ .RE @@ -383,27 +403,28 @@ .RS 4 .\} .nf - for (int i=0; i < bindings\&.length; i++) { - - // get the object reference for each binding - org\&.omg\&.CORBA\&.Object obj = nc\&.resolve(bindings[i]\&.binding_name); - String objStr = orb\&.object_to_string(obj); - int lastIx = bindings[i]\&.binding_name\&.length\-1; +\fB for (int i=0; i < bindings\&.length; i++) {\fR +\fB \fR +\fB // get the object reference for each binding\fR +\fB org\&.omg\&.CORBA\&.Object obj = nc\&.resolve(bindings[i]\&.binding_name);\fR +\fB String objStr = orb\&.object_to_string(obj);\fR +\fB int lastIx = bindings[i]\&.binding_name\&.length\-1;\fR +\fB \fR +\fB // check to see if this is a naming context\fR +\fB if (bindings[i]\&.binding_type == BindingType\&.ncontext) {\fR +\fB System\&.out\&.println("Context: " +\fR +\fB bindings[i]\&.binding_name[lastIx]\&.id);\fR +\fB } else {\fR +\fB System\&.out\&.println("Object: " +\fR +\fB bindings[i]\&.binding_name[lastIx]\&.id);\fR +\fB }\fR +\fB }\fR +\fB } catch (Exception e) {\fR +\fB e\&.printStackTrace(System\&.err)\fR +\fB }\fR +\fB }\fR +\fB}\fR - // check to see if this is a naming context - if (bindings[i]\&.binding_type == BindingType\&.ncontext) { - System\&.out\&.println("Context: " + - bindings[i]\&.binding_name[lastIx]\&.id); - } else { - System\&.out\&.println("Object: " + - bindings[i]\&.binding_name[lastIx]\&.id); - } - } - } catch (Exception e) { - e\&.printStackTrace(System\&.err) - } - } -} .fi .if n \{\ .RE
--- a/src/linux/doc/man/ja/unpack200.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/unpack200.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: unpack200 -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Javaデプロイメント・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: unpack200 +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Javaデプロイメント・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "unpack200" "1" "2013年11月21日" "JDK 8" "Javaデプロイメント・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -unpack200 \- pack200(1)で作成されたパック・ファイルを、WebデプロイメントのためにJARファイルに変換します。 +.SH "名前" +unpack200 \- \fBpack200\fR(1)で作成されたパック・ファイルを、WebデプロイメントのためにJARファイルに変換します。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIunpack200\fR [ \fIoptions\fR ] input\-file \fIJAR\-file\fR +\fBunpack200\fR [ \fIoptions\fR ] input\-file \fIJAR\-file\fR .fi .if n \{\ .RE @@ -64,12 +66,12 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIinput\-file\fR .RS 4 -入力ファイルの名前。pack200 gzipファイルかpack200ファイルを指定できます。入力ファイルには、\fIpack200\fR(1)で作成されたJARファイルを指定することもできます(手間は\fI0\fRです)。この場合、入力ファイルの内容はPack2000マーカーで出力JARファイルにコピーされます。 +入力ファイルの名前。pack200 gzipファイルかpack200ファイルを指定できます。入力ファイルには、\fBpack200\fR(1)で作成されたJARファイルを指定することもできます(手間は\fB0\fRです)。この場合、入力ファイルの内容はPack2000マーカーで出力JARファイルにコピーされます。 .RE .PP \fIJAR\-file\fR @@ -78,13 +80,14 @@ .RE .SH "説明" .PP -\fIunpack200\fRコマンドは、\fIpack200\fR\fI(1)\fRで作成されたパック・ファイルをJARファイルに変換するネイティブ実装です。一般的な使用方法は次のとおりです。次の例では、デフォルトの\fIunpack200\fRコマンド設定で、\fImyarchive\&.jar\fRファイルが\fImyarchive\&.pack\&.gz\fRから作成されます。 +\fBunpack200\fRコマンドは、\fBpack200\fR\fB(1)\fRで作成されたパック・ファイルをJARファイルに変換するネイティブ実装です。一般的な使用方法は次のとおりです。次の例では、デフォルトの\fBunpack200\fRコマンド設定で、\fBmyarchive\&.jar\fRファイルが\fBmyarchive\&.pack\&.gz\fRから作成されます。 .sp .if n \{\ .RS 4 .\} .nf -unpack200 myarchive\&.pack\&.gz myarchive\&.jar +\fBunpack200 myarchive\&.pack\&.gz myarchive\&.jar\fR + .fi .if n \{\ .RE @@ -93,7 +96,7 @@ .PP \-Hvalue \-\-deflate\-hint=\fIvalue\fR .RS 4 -JARファイル内のすべてのエントリに\fItrue\fR、\fIfalse\fRまたは\fIkeep\fRのデフレーションを設定します。デフォルト・モードは\fIkeep\fRです。値が\fItrue\fRまたは\fIfalse\fR場合、\fI\-\-deflate=hint\fRオプションはデフォルトの動作をオーバーライドして、出力JARファイル内のすべてのエントリのデフレーション・モードが設定されます。 +JARファイル内のすべてのエントリに\fBtrue\fR、\fBfalse\fRまたは\fBkeep\fRのデフレーションを設定します。デフォルト・モードは\fBkeep\fRです。値が\fBtrue\fRまたは\fBfalse\fR場合、\fB\-\-deflate=hint\fRオプションはデフォルトの動作をオーバーライドして、出力JARファイル内のすべてのエントリのデフレーション・モードが設定されます。 .RE .PP \-r \-\-remove\-pack\-file @@ -118,21 +121,21 @@ .PP \-? \-h \-\-help .RS 4 -\fIunpack200\fRコマンドに関するヘルプ情報を出力します。 +\fBunpack200\fRコマンドに関するヘルプ情報を出力します。 .RE .PP \-V \-\-version .RS 4 -\fIunpack200\fRコマンドに関するバージョン情報を出力します。 +\fBunpack200\fRコマンドに関するバージョン情報を出力します。 .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシンにoptionを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineにoptionを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "注意" .PP -このコマンドと\fIunpack\fRコマンドを混同しないでください。これらは別製品です。 +このコマンドと\fBunpack\fRコマンドを混同しないでください。これらは別製品です。 .PP JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。 .SH "終了ステータス" @@ -181,8 +184,9 @@ .sp -1 .IP \(bu 2.3 .\} -「Pack200 and Compression」 -(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/deployment/deployment\-guide/pack200\&.html) +「Compression Formats for Network Deployment」 + +http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jweb/networking/compression_formats\&.html .RE .sp .RS 4
--- a/src/linux/doc/man/ja/wsgen.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/wsgen.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: wsgen -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java Webサービス・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: wsgen +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java Webサービス・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "wsgen" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" wsgen \- Webサービスのエンドポイント実装(SEI)クラスを読取り、Webサービスのデプロイメントと呼出しに必要なすべてのアーティファクトを生成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIwsgen\fR [ \fIoptions\fR ] \fISEI\fR +\fBwsgen\fR [ \fIoptions\fR ] \fISEI\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fISEI\fR @@ -73,18 +75,19 @@ .RE .SH "説明" .PP -\fIwsgen\fRコマンドは、JAX\-WS Webサービスで使用されるJAX\-WSポータブル・アーティファクトを生成します。このツールは、Webサービスのエンドポイント・クラスを読取り、Webサービスのデプロイメントと呼出しに必要なすべてのアーティファクトを生成します。JAXWS 2\&.1\&.1 RIでは\fIwsgen\fR +\fBwsgen\fRコマンドは、JAX\-WS Webサービスで使用されるJAX\-WSポータブル・アーティファクトを生成します。このツールは、Webサービスのエンドポイント・クラスを読取り、Webサービスのデプロイメントと呼出しに必要なすべてのアーティファクトを生成します。JAXWS 2\&.1\&.1 RIでは\fBwsgen\fR Antタスクも提供されます。 http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.htmlのJAX\-WS (wsgen)ページのToolsタブを参照してください。 .PP -\fIwsgen\fRコマンドを起動するには、次を行います。 +\fBwsgen\fRコマンドを起動するには、次を行います。 .sp .if n \{\ .RS 4 .\} .nf -export JAXWS_HOME=/pathto/jaxws\-ri -$JAXWS_HOME/bin/wsgen\&.sh \-help +\fBexport JAXWS_HOME=/pathto/jaxws\-ri\fR +\fB$JAXWS_HOME/bin/wsgen\&.sh \-help\fR + .fi .if n \{\ .RE @@ -113,7 +116,7 @@ .PP \-help .RS 4 -\fIwsgen\fRコマンドに関するヘルプ・メッセージを表示します。 +\fBwsgen\fRコマンドに関するヘルプ・メッセージを表示します。 .RE .PP \-keep @@ -123,7 +126,7 @@ .PP \-r \fIdirectory\fR .RS 4 -このオプションを\fI\-wsdl\fRオプションとともに使用して、WSDLなど生成されたリソース・ファイルを配置する場所を指定します。 +このオプションを\fB\-wsdl\fRオプションとともに使用して、WSDLなど生成されたリソース・ファイルを配置する場所を指定します。 .RE .PP \-s \fIdirectory\fR @@ -145,41 +148,43 @@ .RS 4 エンドポイントをデプロイする前に確認するWSDLファイルを生成するオプション・コマンド。WSDLファイルには、サービスを呼び出す方法、パラメータに必要な値、返されるデータ構造についてのコンピュータで読取り可能な記述が含まれます。 .sp -デフォルトでは\fIwsgen\fRコマンドはWSDLファイルを生成しません。\fIprotocol\fR値は省略可能であり、WSDLバインディング(\fIwsdl:binding\fR)で使用するプロトコルを指定するために使用されます。有効なプロトコルは、\fIsoap1\&.1\fRと\fIXsoap1\&.2\fRです。デフォルトは\fIsoap1\&.1\fRです。\fIXsoap1\&.2\fRプロトコルは標準ではないため、\fI\-extension\fRオプションとともにのみ使用可能です。 +デフォルトでは\fBwsgen\fRコマンドはWSDLファイルを生成しません。\fBprotocol\fR値は省略可能であり、WSDLバインディング(\fBwsdl:binding\fR)で使用するプロトコルを指定するために使用されます。有効なプロトコルは、\fBsoap1\&.1\fRと\fBXsoap1\&.2\fRです。デフォルトは\fBsoap1\&.1\fRです。\fBXsoap1\&.2\fRプロトコルは標準ではないため、\fB\-extension\fRオプションとともにのみ使用可能です。 .RE .PP \-servicename \fIname\fR .RS 4 -\fI\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLサービス(\fIwsdl:service\fR)名を指定します。例: -\fI\-servicename "{http://mynamespace/}MyService"\fR。 +\fB\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLサービス(\fBwsdl:service\fR)名を指定します。例: +\fB\-servicename "{http://mynamespace/}MyService"\fR。 .RE .PP \-portname \fIname\fR .RS 4 -\fI\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLポート(\fIwsdl:port\fR)名を指定します。例: -\fI\-portname "{http://mynamespace/}MyPort"\fR。 +\fB\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLポート(\fBwsdl:port\fR)名を指定します。例: +\fB\-portname "{http://mynamespace/}MyPort"\fR。 .RE .SH "例" .PP -次の例では、Stockディレクトリ内に\fI@WebService\fR注釈を持つ\fIStockService\fRのラッパー・クラスを生成します。 +次の例では、Stockディレクトリ内に\fB@WebService\fR注釈を持つ\fBStockService\fRのラッパー・クラスを生成します。 .sp .if n \{\ .RS 4 .\} .nf -wsgen \-d stock \-cp myclasspath stock\&.StockService +\fBwsgen \-d stock \-cp myclasspath stock\&.StockService\fR + .fi .if n \{\ .RE .\} .PP -次の例では、SOAP 1\&.1 WSDLおよび\fI@WebService\fR注釈を持つ\fIstock\&.StockService\fRクラスのスキーマを生成します。 +次の例では、SOAP 1\&.1 WSDLおよび\fB@WebService\fR注釈を持つ\fBstock\&.StockService\fRクラスのスキーマを生成します。 .sp .if n \{\ .RS 4 .\} .nf -wsgen \-wsdl \-d stock \-cp myclasspath stock\&.StockService +\fBwsgen \-wsdl \-d stock \-cp myclasspath stock\&.StockService\fR + .fi .if n \{\ .RE @@ -191,7 +196,8 @@ .RS 4 .\} .nf -wsgen \-wsdl:Xsoap1\&.2 \-d stock \-cp myclasspath stock\&.StockService +\fBwsgen \-wsdl:Xsoap1\&.2 \-d stock \-cp myclasspath stock\&.StockService \fR + .fi .if n \{\ .RE
--- a/src/linux/doc/man/ja/wsimport.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/wsimport.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: wsimport -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java Webサービス・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: wsimport +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java Webサービス・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "wsimport" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" wsimport \- Webアプリケーション・アーカイブ(WAR)ファイルにパッケージできるJAX\-WSポータブル・アーティファクトを生成して、Antタスクを指定します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIwsimport\fR [ \fIoptions\fR ] \fIwsdl\fR +\fBwsimport\fR [ \fIoptions\fR ] \fIwsdl\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIwsdl\fR @@ -73,7 +75,7 @@ .RE .SH "説明" .PP -\fIwsimport\fRコマンドは、次のJAX\-WSポータブル・アーティファクトを生成します。これらのアーティファクトは、デプロイするWSDLおよびスキーマ・ドキュメントおよびエンドポイント実装とともに、WARファイルにパッケージできます。\fIwsimport\fRコマンドでは\fIwsimport\fR +\fBwsimport\fRコマンドは、次のJAX\-WSポータブル・アーティファクトを生成します。これらのアーティファクトは、デプロイするWSDLおよびスキーマ・ドキュメントおよびエンドポイント実装とともに、WARファイルにパッケージできます。\fBwsimport\fRコマンドでは\fBwsimport\fR Antタスクも提供されます。 http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.htmlのWsimport Ant TaskページのToolsタブを参照してください。 .sp @@ -107,7 +109,7 @@ .sp -1 .IP \(bu 2.3 .\} -例外クラスは\fIwsdl:fault\fRからマップされます(存在する場合) +例外クラスは\fBwsdl:fault\fRからマップされます(存在する場合) .RE .sp .RS 4 @@ -118,7 +120,7 @@ .sp -1 .IP \(bu 2.3 .\} -非同期レスポンスBeanはレスポンス\fIwsdl:message\fRから派生します(存在する場合) +非同期レスポンスBeanはレスポンス\fBwsdl:message\fRから派生します(存在する場合) .RE .sp .RS 4 @@ -132,7 +134,7 @@ JAXBが生成する値タイプ(スキーマのタイプからマップされたJavaクラス) .RE .PP -\fIwsgen\fRコマンドを起動するには、次を行います。 +\fBwsgen\fRコマンドを起動するには、次を行います。 .PP \fBOracle Solaris/Linux\fR: .sp @@ -140,7 +142,8 @@ .RS 4 .\} .nf -/bin/wsimport\&.sh \-help +\fB/bin/wsimport\&.sh \-help\fR + .fi .if n \{\ .RE @@ -152,7 +155,8 @@ .RS 4 .\} .nf -\ebin\ewsimport\&.bat \-help +\fB\ebin\ewsimport\&.bat \-help\fR + .fi .if n \{\ .RE @@ -166,18 +170,18 @@ .PP \-b \fIpath\fR .RS 4 -外部JAX\-WSまたはJAXBバインディング・ファイルを指定します。\fI\-b\fRオプションで複数のJAX\-WSおよびJAXBバインディング・ファイルを指定できます。これらのファイルを使用して、パッケージ名、Bean名などをカスタマイズできます。JAX\-WSおよびJAXBバインディング・ファイルの詳細は、 +外部JAX\-WSまたはJAXBバインディング・ファイルを指定します。\fB\-b\fRオプションで複数のJAX\-WSおよびJAXBバインディング・ファイルを指定できます。これらのファイルを使用して、パッケージ名、Bean名などをカスタマイズできます。JAX\-WSおよびJAXBバインディング・ファイルの詳細は、 http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.htmlのWSDL CustomizationのUsers Guideタブを参照してください .RE .PP \-B \fIjaxbOption\fR .RS 4 -JAXBスキーマ・コンパイラに\fIjaxbOption\fRオプションを渡します。 +JAXBスキーマ・コンパイラに\fBjaxbOption\fRオプションを渡します。 .RE .PP \-catalog .RS 4 -外部エンティティ参照を解決するカタログ・ファイルを指定します。\fI\-catalog\fRオプションは、TR9401、XCatalog、OASIS XML Catalogの各形式をサポートしています。http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/catalog\-support\&.htmlの +外部エンティティ参照を解決するカタログ・ファイルを指定します。\fB\-catalog\fRオプションは、TR9401、XCatalog、OASIS XML Catalogの各形式をサポートしています。http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/catalog\-support\&.htmlの Catalog SupportページのUsers Guideタブを参照してください。 .RE .PP @@ -188,7 +192,7 @@ .PP \-help .RS 4 -\fIwsimport\fRコマンドに関するヘルプ・メッセージを表示します。 +\fBwsimport\fRコマンドに関するヘルプ・メッセージを表示します。 .RE .PP \-httpproxy: \fIhost\fR:\fIport\fR @@ -223,7 +227,7 @@ .PP \-wsdllocation \fIlocation\fR .RS 4 -\fI@WebServiceClient\&.wsdlLocation\fRの値を指定します。 +\fB@WebServiceClient\&.wsdlLocation\fRの値を指定します。 .RE .PP \-target @@ -233,11 +237,11 @@ .PP \-quiet .RS 4 -\fIwsimport\fRコマンド出力を抑制します。 +\fBwsimport\fRコマンド出力を抑制します。 .RE .PP -\fI\-b\fRオプションを使用して、複数の\fIJAX\-WS\fRおよび\fIJAXB\fRバインディング・ファイルを指定できます。これらのファイルを使用して、パッケージ名やBean名など、様々なものをカスタマイズできます。\fIJAX\-WS\fRおよび\fIJAXB\fRバインディング・ファイルの詳細は、 -https://jax\-ws\&.dev\&.java\&.net/nonav/2\&.1\&.1/docs/customizations\&.htmlのJAXBタブを参照してください +\fB\-b\fRオプションを使用して、複数の\fBJAX\-WS\fRおよび\fBJAXB\fRバインディング・ファイルを指定できます。これらのファイルを使用して、パッケージ名やBean名など、様々なものをカスタマイズできます。\fBJAX\-WS\fRおよび\fBJAXB\fRバインディング・ファイルの詳細は、 +https://jax\-ws\&.java\&.net/nonav/2\&.1\&.2/docs/customizations\&.htmlのカスタマイズ・ドキュメントを参照してください .SH "非標準オプション" .PP \-XadditionalHeaders @@ -249,7 +253,7 @@ .RS 4 認証情報を含むファイルを指定するWSDL URIです。このURIの形式は次のとおりです。 .sp -http://\fIuser\-name\fR:\fIpassword\fR@\fIhost\-name\fR/\fIweb\-service\-name\fR>?wsdl +http://\fIuser\-name\fR:\fBpassword\fR@\fIhost\-name\fR/\fIweb\-service\-name\fR>?wsdl\&. .RE .PP \-Xdebug @@ -268,13 +272,14 @@ .RE .SH "例" .PP -次の例では、Javaアーティファクトを生成し、\fIhttp://stockquote\&.example\&.com/quote?wsdl\fRをインポートしてアーティファクトをコンパイルします。 +次の例では、Javaアーティファクトを生成し、\fBhttp://stockquote\&.example\&.com/quote?wsdl\fRをインポートしてアーティファクトをコンパイルします。 .sp .if n \{\ .RS 4 .\} .nf -wsimport \-p stockquote http://stockquote\&.example\&.com/quote?wsdl +\fBwsimport \-p stockquote http://stockquote\&.example\&.com/quote?wsdl\fR + .fi .if n \{\ .RE
--- a/src/linux/doc/man/ja/xjc.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/linux/doc/man/ja/xjc.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: xjc -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java Webサービス・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: xjc +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java Webサービス・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "xjc" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" xjc \- XMLスキーマ・ファイルを完全注釈付きのJavaクラスにコンパイルします。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIxjc\fR [ \fIoptions\fR ] \fIschema\fR \fIfile/URL/dir/jar\fR \&.\&.\&. [\fI\-b\fR \fIbindinfo\fR ] \&.\&.\&. +\fBxjc\fR [ \fIoptions\fR ] \fBschema\fR \fIfile/URL/dir/jar\fR \&.\&.\&. [\fB\-b\fR \fIbindinfo\fR ] \&.\&.\&. .fi .if n \{\ .RE @@ -64,12 +66,12 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP schema \fIfile/URL/dir/jar \&.\&.\&.\fR .RS 4 -XMLスキーマ・ファイルの場所。\fIdir\fRが指定されている場合は、すべてのスキーマ・ファイルがコンパイルされます。\fIjar\fRが指定されている場合は、\fI/META\-INF/sun\-jaxb\&.episode\fRバインディング・ファイルがコンパイルされます。 +XMLスキーマ・ファイルの場所。\fBdir\fRが指定されている場合は、すべてのスキーマ・ファイルがコンパイルされます。\fBjar\fRが指定されている場合は、\fB/META\-INF/sun\-jaxb\&.episode\fRバインディング・ファイルがコンパイルされます。 .RE .PP \-b \fIbindinfo\fR @@ -78,7 +80,7 @@ .RE .SH "説明" .PP -プラットフォームのbinディレクトリにある適切な\fIxjc\fRシェル・スクリプトを使用して、バインディング・コンパイラを起動します。バインディング・コンパイラを実行するAntタスクもあります。http://jaxb\&.java\&.net/nonav/2\&.1\&.3/docs/xjcTask\&.htmlの +プラットフォームのbinディレクトリにある適切な\fBxjc\fRシェル・スクリプトを使用して、バインディング・コンパイラを起動します。バインディング・コンパイラを実行するAntタスクもあります。http://jaxb\&.java\&.net/nonav/2\&.1\&.3/docs/xjcTask\&.htmlの Using the XJC with Antを参照してください .SH "オプション" .sp @@ -111,13 +113,13 @@ .PP \-extension .RS 4 -デフォルトでは、XJCバインディング・コンパイラは、JAXB仕様のCompatibilityの章で説明されているルールを厳密に強制します。付録E\&.2には、JAXB v1\&.0で完全にはサポートされていない一連のW3C XMLスキーマ機能が定義されています。場合によっては、このスイッチで有効になる\fI\-extension\fRモードでそれらの機能が使用できる場合があります。また、デフォルトの厳密なモードでは、仕様に定義されているバインディング・カスタマイズのみが使用できます。\fI\-extension\fRスイッチを指定すれば、JAXB Vendor Extensionを使用できます。 +デフォルトでは、XJCバインディング・コンパイラは、JAXB仕様のCompatibilityの章で説明されているルールを厳密に強制します。付録E\&.2には、JAXB v1\&.0で完全にはサポートされていない一連のW3C XMLスキーマ機能が定義されています。場合によっては、このスイッチで有効になる\fB\-extension\fRモードでそれらの機能が使用できる場合があります。また、デフォルトの厳密なモードでは、仕様に定義されているバインディング・カスタマイズのみが使用できます。\fB\-extension\fRスイッチを指定すれば、JAXB Vendor Extensionを使用できます。 .RE .PP \-b \fIfile\fR .RS 4 -処理する外部バインディング・ファイルを1つまたは複数指定します。バインディング・ファイルごとに\fI\-b\fRスイッチを指定する必要があります。外部バインディング・ファイルの構文は柔軟です。複数のスキーマのカスタマイズが含まれる1つのバインディング・ファイルを使用したり、それらのカスタマイズを複数のバインディング・ファイルに分割したりできます。次に例を示します。\fIxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings123\&.xjb\fR -\fIxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings1\&.xjb \-b bindings2\&.xjb \-b bindings3\&.xjb\fRまた、コマンドラインにスキーマ・ファイルとバインディング・ファイルを指定する順番は任意です。 +処理する外部バインディング・ファイルを1つまたは複数指定します。バインディング・ファイルごとに\fB\-b\fRスイッチを指定する必要があります。外部バインディング・ファイルの構文は柔軟です。複数のスキーマのカスタマイズが含まれる1つのバインディング・ファイルを使用したり、それらのカスタマイズを複数のバインディング・ファイルに分割したりできます。次に例を示します。\fBxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings123\&.xjb\fR +\fBxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings1\&.xjb \-b bindings2\&.xjb \-b bindings3\&.xjb\fRまた、コマンド行にスキーマ・ファイルとバインディング・ファイルを指定する順番は任意です。 .RE .PP \-d \fIdir\fR @@ -127,17 +129,17 @@ .PP \-p \fIpkg\fR .RS 4 -このコマンドライン・オプションでターゲット・パッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディング・カスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。 +このコマンド行オプションでターゲット・パッケージを指定した場合、パッケージ名に対するすべてのバインディング・カスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。 .RE .PP \-httpproxy \fIproxy\fR .RS 4 -\fI[user[:password]@]proxyHost[:proxyPort]\fR形式でHTTPまたはHTTPSプロキシを指定します。古い\fI\-host\fRおよび\fI\-port\fRオプションは、下位互換性のために引き続きRIでサポートされますが、非推奨となりました。このオプションで指定されたパスワードは、topコマンドを使用する他のユーザーが表示できる引数です。セキュリティを高めるには、\fI\-httpproxyfile\fRを使用してください。 +\fI[user[:password]@]proxyHost[:proxyPort]\fR形式でHTTPまたはHTTPSプロキシを指定します。古い\fB\-host\fRおよび\fB\-port\fRオプションは、後方互換性のために引き続きRIでサポートされますが、非推奨となりました。このオプションで指定されたパスワードは、topコマンドを使用する他のユーザーが表示できる引数です。セキュリティを高めるには、\fB\-httpproxyfile\fRを使用してください。 .RE .PP \-httpproxyfile file .RS 4 -ファイルを使用して、HTTPまたはHTTPSプロキシを指定します。形式は\fI\-httpproxy\fRオプションと同じですが、このファイル内に指定されたパスワードを他のユーザーが表示することはできません。 +ファイルを使用して、HTTPまたはHTTPSプロキシを指定します。形式は\fB\-httpproxy\fRオプションと同じですが、このファイル内に指定されたパスワードを他のユーザーが表示することはできません。 .RE .PP \-classpath arg @@ -158,12 +160,12 @@ .PP \-npa .RS 4 -\fI**/package\-info\&.java\fRへのパッケージ・レベルの注釈の生成を抑制します。このスイッチを使用して生成するコードでは、これらの注釈が他の生成済クラスに内部化されます。 +\fB**/package\-info\&.java\fRへのパッケージ・レベルの注釈の生成を抑制します。このスイッチを使用して生成するコードでは、これらの注釈が他の生成済クラスに内部化されます。 .RE .PP \-no\-header .RS 4 -多少のメモとタイムスタンプを含むファイル・ヘッダー・コメントの生成を抑制します。これを使用すると、生成されたコードと\fIdiff\fRコマンドとの互換性がより強くなります。 +多少のメモとタイムスタンプを含むファイル・ヘッダー・コメントの生成を抑制します。これを使用すると、生成されたコードと\fBdiff\fRコマンドとの互換性がより強くなります。 .RE .PP \-target 2\&.0 @@ -218,7 +220,7 @@ .PP \fIschema file/URL/dir\fR .RS 4 -コンパイル対象となる1つまたは複数のスキーマ・ファイルを指定します。ディレクトリを指定する場合、\fIxjc\fRコマンドはすべてのスキーマ・ファイルをスキャンしてコンパイルします。 +コンパイル対象となる1つまたは複数のスキーマ・ファイルを指定します。ディレクトリを指定する場合、\fBxjc\fRコマンドはすべてのスキーマ・ファイルをスキャンしてコンパイルします。 .RE .SS "非標準オプション" .PP @@ -229,12 +231,12 @@ .PP \-Xsync\-methods .RS 4 -生成されたすべてのメソッド・シグニチャに\fIsynchronized\fRキーワードが含められます。 +生成されたすべてのメソッド・シグニチャに\fBsynchronized\fRキーワードが含められます。 .RE .PP \-mark\-generated .RS 4 -生成されたコードに注釈\fI@javax\&.annotation\&.Generated\fRを付けます。 +生成されたコードに注釈\fB@javax\&.annotation\&.Generated\fRを付けます。 .RE .PP \-episode file @@ -245,21 +247,21 @@ .PP \-host & \-port .RS 4 -これらのオプションは\fI\-httpproxy\fRオプションで置き換えられました。これらのオプションは、下位互換性を確保するためにサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。 +これらのオプションは\fB\-httpproxy\fRオプションで置き換えられました。これらのオプションは、後方互換性を確保するためにサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。 .RE .PP \-use\-runtime .RS 4 -JAXB 2\&.0仕様では、移植性のあるランタイム環境が定義されたため、JAXB RIが\fI**/impl/runtime \fRパッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。 +JAXB 2\&.0仕様では、移植性のあるランタイム環境が定義されたため、JAXB RIが\fB**/impl/runtime \fRパッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。 .RE .PP \-source .RS 4 -\fI\-source\fR互換性スイッチは、JAXB 2\&.0の最初のEarly Access版で導入されました。このスイッチはJAXB 2\&.0の今後のリリースから削除されます。1\&.0\&.xコードを生成する必要がある場合は、1\&.0\&.xコード・ベースのインストールを使用してください。 +\fB\-source\fR互換性スイッチは、JAXB 2\&.0の最初のEarly Access版で導入されました。このスイッチはJAXB 2\&.0の今後のリリースから削除されます。1\&.0\&.xコードを生成する必要がある場合は、1\&.0\&.xコード・ベースのインストールを使用してください。 .RE .SH "コンパイラの制限" .PP -通常は、関連するすべてのスキーマを、同じバインディング・コンパイラ・スイッチを指定して1つの単位としてコンパイルするのが最も安全です。\fIxjc\fRコマンドの実行時には、次の制限リストに留意してください。これらの問題のほとんどは、\fIxjc\fRコマンドを何度か呼び出して複数のスキーマをコンパイルする場合にのみ当てはまります。 +通常は、関連するすべてのスキーマを、同じバインディング・コンパイラ・スイッチを指定して1つの単位としてコンパイルするのが最も安全です。\fBxjc\fRコマンドの実行時には、次の制限リストに留意してください。これらの問題のほとんどは、\fBxjc\fRコマンドを何度か呼び出して複数のスキーマをコンパイルする場合にのみ当てはまります。 .PP 複数のスキーマを同時にコンパイルする場合は、ターゲットのJavaパッケージ名に次の優先順位のルールが適用されることに注意してください。 .sp @@ -271,7 +273,7 @@ .sp -1 .IP " 1." 4.2 .\} -\fI\-p\fRオプションが最も優先されます。 +\fB\-p\fRオプションが最も優先されます。 .RE .sp .RS 4 @@ -293,7 +295,7 @@ .sp -1 .IP " 3." 4.2 .\} -\fItargetNamespace\fRが宣言されている場合は、\fIt\fR\fIargetNamespace\fRを仕様で定義されているJavaパッケージ名のアルゴリズムに適用します。 +\fBtargetNamespace\fRが宣言されている場合は、\fBt\fR\fBargetNamespace\fRを仕様で定義されているJavaパッケージ名のアルゴリズムに適用します。 .RE .sp .RS 4 @@ -304,7 +306,7 @@ .sp -1 .IP " 4." 4.2 .\} -\fItargetNamespace\fRが宣言されていない場合は、\fIgenerated\fRという名前のハードコードされたパッケージを使用します。 +\fBtargetNamespace\fRが宣言されていない場合は、\fBgenerated\fRという名前のハードコードされたパッケージを使用します。 .RE .PP 1つのネームスペースが複数の\fIjaxb:schemaBindings\fRを持つことはできないため、異なるJavaパッケージにコンパイラされる同一ターゲット・ネームスペースが2つのスキーマを持つことはできません。
--- a/src/macosx/classes/com/apple/laf/AquaComboBoxPopup.java Mon Jul 07 16:55:22 2014 +0400 +++ b/src/macosx/classes/com/apple/laf/AquaComboBoxPopup.java Mon Jul 14 11:15:04 2014 -0700 @@ -120,10 +120,6 @@ public void show() { final int startItemCount = comboBox.getItemCount(); - if (startItemCount == 0) { - return; - } - final Rectangle popupBounds = adjustPopupAndGetBounds(); if (popupBounds == null) return; // null means don't show
--- a/src/share/classes/com/sun/accessibility/internal/resources/accessibility_zh_TW.properties Mon Jul 07 16:55:22 2014 +0400 +++ b/src/share/classes/com/sun/accessibility/internal/resources/accessibility_zh_TW.properties Mon Jul 14 11:15:04 2014 -0700 @@ -44,7 +44,7 @@ popupmenu=\u5373\u73FE\u5F0F\u529F\u80FD\u8868 progressbar=\u9032\u5EA6\u5217 pushbutton=\u4E0B\u58D3\u6309\u9215 -radiobutton=\u55AE\u9078\u9215 +radiobutton=\u5713\u9215 rootpane=root \u7A97\u683C rowheader=\u5217\u6A19\u984C scrollbar=\u6372\u8EF8
--- a/src/share/classes/com/sun/tools/example/debug/tty/TTYResources_ja.java Mon Jul 07 16:55:22 2014 +0400 +++ b/src/share/classes/com/sun/tools/example/debug/tty/TTYResources_ja.java Mon Jul 14 11:15:04 2014 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2001, 2014, 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 @@ -82,7 +82,7 @@ {"Can only trace", "'methods'\u3001'method exit'\u307E\u305F\u306F'method exits'\u306E\u307F\u30C8\u30EC\u30FC\u30B9\u3067\u304D\u307E\u3059"}, {"cannot redefine existing connection", "{0}\u306F\u65E2\u5B58\u306E\u63A5\u7D9A\u3092\u518D\u5B9A\u7FA9\u3067\u304D\u307E\u305B\u3093"}, {"Cannot assign to a method invocation", "\u30E1\u30BD\u30C3\u30C9\u547C\u51FA\u3057\u306B\u5272\u5F53\u3066\u3067\u304D\u307E\u305B\u3093"}, - {"Cannot specify command line with connector:", "\u30B3\u30CD\u30AF\u30BF\u3067\u30B3\u30DE\u30F3\u30C9\u30E9\u30A4\u30F3\u3092\u6307\u5B9A\u3067\u304D\u307E\u305B\u3093: {0}"}, + {"Cannot specify command line with connector:", "\u30B3\u30CD\u30AF\u30BF\u3067\u30B3\u30DE\u30F3\u30C9\u884C\u3092\u6307\u5B9A\u3067\u304D\u307E\u305B\u3093: {0}"}, {"Cannot specify target vm arguments with connector:", "\u30B3\u30CD\u30AF\u30BF\u3067\u30BF\u30FC\u30B2\u30C3\u30C8VM\u5F15\u6570\u3092\u6307\u5B9A\u3067\u304D\u307E\u305B\u3093: {0}"}, {"Class containing field must be specified.", "\u30D5\u30A3\u30FC\u30EB\u30C9\u3092\u542B\u3080\u30AF\u30E9\u30B9\u3092\u6307\u5B9A\u3059\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059\u3002"}, {"Class:", "\u30AF\u30E9\u30B9: {0}"},
--- a/src/share/classes/com/sun/tools/jdi/resources/jdi_ja.properties Mon Jul 07 16:55:22 2014 +0400 +++ b/src/share/classes/com/sun/tools/jdi/resources/jdi_ja.properties Mon Jul 14 11:15:04 2014 -0700 @@ -5,9 +5,9 @@ raw.command.label = \u30B3\u30DE\u30F3\u30C9 raw.address = raw\u30B3\u30DE\u30F3\u30C9\u5B9F\u884C\u5F8C\u306B\u63A5\u7D9A\u3092\u30EA\u30B9\u30CB\u30F3\u30B0\u3059\u308B\u30A2\u30C9\u30EC\u30B9 raw.address.label = \u30A2\u30C9\u30EC\u30B9 -raw.quote = \u5358\u4E00\u306E\u30B3\u30DE\u30F3\u30C9\u30E9\u30A4\u30F3\u5F15\u6570\u5185\u306B\u30B9\u30DA\u30FC\u30B9\u3067\u533A\u5207\u3089\u308C\u305F\u30C6\u30AD\u30B9\u30C8\u3092\u7D50\u3073\u4ED8\u3051\u308B\u305F\u3081\u306B\u4F7F\u7528\u3055\u308C\u308B\u6587\u5B57 +raw.quote = \u5358\u4E00\u306E\u30B3\u30DE\u30F3\u30C9\u884C\u5F15\u6570\u5185\u306B\u30B9\u30DA\u30FC\u30B9\u3067\u533A\u5207\u3089\u308C\u305F\u30C6\u30AD\u30B9\u30C8\u3092\u7D50\u3073\u4ED8\u3051\u308B\u305F\u3081\u306B\u4F7F\u7528\u3055\u308C\u308B\u6587\u5B57 raw.quote.label = \u5F15\u7528\u7B26 -raw.description = \u30E6\u30FC\u30B6\u30FC\u304C\u6307\u5B9A\u3057\u305F\u30B3\u30DE\u30F3\u30C9\u30E9\u30A4\u30F3\u3092\u4F7F\u7528\u3057\u3066\u30BF\u30FC\u30B2\u30C3\u30C8\u3092\u8D77\u52D5\u3057\u3001\u63A5\u7D9A\u3057\u307E\u3059 +raw.description = \u30E6\u30FC\u30B6\u30FC\u304C\u6307\u5B9A\u3057\u305F\u30B3\u30DE\u30F3\u30C9\u884C\u3092\u4F7F\u7528\u3057\u3066\u30BF\u30FC\u30B2\u30C3\u30C8\u3092\u8D77\u52D5\u3057\u3001\u63A5\u7D9A\u3057\u307E\u3059 sun.home = SDK\u306E\u30DB\u30FC\u30E0\u30FB\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u307E\u305F\u306F\u3001\u30A2\u30D7\u30EA\u30B1\u30FC\u30B7\u30E7\u30F3\u306E\u8D77\u52D5\u306B\u4F7F\u7528\u3055\u308C\u308B\u5B9F\u884C\u74B0\u5883 sun.home.label = \u30DB\u30FC\u30E0 sun.options = \u8D77\u52D5\u3059\u308BVM\u306E\u30AA\u30D7\u30B7\u30E7\u30F3 @@ -16,11 +16,11 @@ sun.main.label = \u30E1\u30A4\u30F3 sun.init_suspend = \u30E1\u30A4\u30F3\u306E\u5B9F\u884C\u524D\u306B\u3059\u3079\u3066\u306E\u30B9\u30EC\u30C3\u30C9\u304C\u4E2D\u65AD\u3055\u308C\u307E\u3059\u3002 sun.init_suspend.label = \u4E2D\u65AD -sun.quote = \u5358\u4E00\u306E\u30B3\u30DE\u30F3\u30C9\u30E9\u30A4\u30F3\u5F15\u6570\u5185\u306B\u30B9\u30DA\u30FC\u30B9\u3067\u533A\u5207\u3089\u308C\u305F\u30C6\u30AD\u30B9\u30C8\u3092\u7D50\u3073\u4ED8\u3051\u308B\u305F\u3081\u306B\u4F7F\u7528\u3055\u308C\u308B\u6587\u5B57 +sun.quote = \u5358\u4E00\u306E\u30B3\u30DE\u30F3\u30C9\u884C\u5F15\u6570\u5185\u306B\u30B9\u30DA\u30FC\u30B9\u3067\u533A\u5207\u3089\u308C\u305F\u30C6\u30AD\u30B9\u30C8\u3092\u7D50\u3073\u4ED8\u3051\u308B\u305F\u3081\u306B\u4F7F\u7528\u3055\u308C\u308B\u6587\u5B57 sun.quote.label = \u5F15\u7528\u7B26 sun.vm_exec = Java VM\u8D77\u52D5\u30C4\u30FC\u30EB\u540D sun.vm_exec.label = \u8D77\u52D5\u30C4\u30FC\u30EB -sun.description = Sun\u306EJava VM\u30B3\u30DE\u30F3\u30C9\u30E9\u30A4\u30F3\u3092\u4F7F\u7528\u3057\u3066\u30BF\u30FC\u30B2\u30C3\u30C8\u3092\u8D77\u52D5\u3057\u3001\u63A5\u7D9A\u3057\u307E\u3059 +sun.description = Sun\u306EJava VM\u30B3\u30DE\u30F3\u30C9\u884C\u3092\u4F7F\u7528\u3057\u3066\u30BF\u30FC\u30B2\u30C3\u30C8\u3092\u8D77\u52D5\u3057\u3001\u63A5\u7D9A\u3057\u307E\u3059 generic_attaching.address = VM\u306B\u63A5\u7D9A\u3059\u308B\u30A2\u30C9\u30EC\u30B9 generic_attaching.address.label = \u30A2\u30C9\u30EC\u30B9 generic_attaching.timeout = \u63A5\u7D9A\u3092\u5F85\u3064\u9593\u306E\u30BF\u30A4\u30E0\u30A2\u30A6\u30C8
--- a/src/share/classes/javax/swing/PopupFactory.java Mon Jul 07 16:55:22 2014 +0400 +++ b/src/share/classes/javax/swing/PopupFactory.java Mon Jul 14 11:15:04 2014 -0700 @@ -232,7 +232,8 @@ case HEAVY_WEIGHT_POPUP: Popup popup = getHeavyWeightPopup(owner, contents, ownerX, ownerY); if ((AccessController.doPrivileged(OSInfo.getOSTypeAction()) == - OSInfo.OSType.MACOSX) && (EmbeddedFrame.getAppletIfAncestorOf(owner) != null)) { + OSInfo.OSType.MACOSX) && (owner != null) && + (EmbeddedFrame.getAppletIfAncestorOf(owner) != null)) { ((HeavyWeightPopup)popup).setCacheEnabled(false); } return popup;
--- a/src/share/classes/sun/rmi/rmic/resources/rmic_ja.properties Mon Jul 07 16:55:22 2014 +0400 +++ b/src/share/classes/sun/rmi/rmic/resources/rmic_ja.properties Mon Jul 14 11:15:04 2014 -0700 @@ -91,8 +91,8 @@ rmic.warnings=\u8B66\u544A{0}\u500B rmic.1warning=\u8B66\u544A1\u500B rmic.done_in=[{0}\u30DF\u30EA\u79D2\u3067\u5B8C\u4E86] -rmic.no.memory=\u30B3\u30F3\u30D1\u30A4\u30E9\u306B\u30E1\u30E2\u30EA\u30FC\u304C\u4E0D\u8DB3\u3057\u3066\u3044\u307E\u3059\u3002"-J-Xmx<size>"\u30B3\u30DE\u30F3\u30C9\u30E9\u30A4\u30F3\u30FB\u30AA\u30D7\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3057\u3066\u3001\u6700\u5927\u30D2\u30FC\u30D7\u30FB\u30B5\u30A4\u30BA\u3092\u5897\u3084\u3057\u3066\u304F\u3060\u3055\u3044\u3002 -rmic.stack.overflow=\u30B3\u30F3\u30D1\u30A4\u30E9\u306B\u30B9\u30BF\u30C3\u30AF\u7A7A\u9593\u304C\u4E0D\u8DB3\u3057\u3066\u3044\u307E\u3059\u3002"-J-Xss<size>"\u30B3\u30DE\u30F3\u30C9\u30E9\u30A4\u30F3\u30FB\u30AA\u30D7\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3057\u3066\u3001Java\u30B9\u30BF\u30C3\u30AF\u306B\u5272\u308A\u5F53\u3066\u308B\u30E1\u30E2\u30EA\u30FC\u3092\u5897\u3084\u3057\u3066\u304F\u3060\u3055\u3044\u3002 +rmic.no.memory=\u30B3\u30F3\u30D1\u30A4\u30E9\u306B\u30E1\u30E2\u30EA\u30FC\u304C\u4E0D\u8DB3\u3057\u3066\u3044\u307E\u3059\u3002"-J-Xmx<size>"\u30B3\u30DE\u30F3\u30C9\u884C\u30AA\u30D7\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3057\u3066\u3001\u6700\u5927\u30D2\u30FC\u30D7\u30FB\u30B5\u30A4\u30BA\u3092\u5897\u3084\u3057\u3066\u304F\u3060\u3055\u3044\u3002 +rmic.stack.overflow=\u30B3\u30F3\u30D1\u30A4\u30E9\u306B\u30B9\u30BF\u30C3\u30AF\u7A7A\u9593\u304C\u4E0D\u8DB3\u3057\u3066\u3044\u307E\u3059\u3002"-J-Xss<size>"\u30B3\u30DE\u30F3\u30C9\u884C\u30AA\u30D7\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3057\u3066\u3001Java\u30B9\u30BF\u30C3\u30AF\u306B\u5272\u308A\u5F53\u3066\u308B\u30E1\u30E2\u30EA\u30FC\u3092\u5897\u3084\u3057\u3066\u304F\u3060\u3055\u3044\u3002 rmic.class.not.found=\u30AF\u30E9\u30B9{0}\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002 rmic.missing.property=\u30D7\u30ED\u30D1\u30C6\u30A3generator.class.{0}\u304C\u3042\u308A\u307E\u305B\u3093 rmic.cannot.instantiate=\u30AF\u30E9\u30B9{0}\u306E\u30A4\u30F3\u30B9\u30BF\u30F3\u30B9\u3092\u751F\u6210\u3067\u304D\u307E\u305B\u3093
--- a/src/share/classes/sun/security/tools/keytool/Resources_de.java Mon Jul 07 16:55:22 2014 +0400 +++ b/src/share/classes/sun/security/tools/keytool/Resources_de.java Mon Jul 14 11:15:04 2014 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2014, 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 @@ -72,7 +72,7 @@ {"Imports.entries.from.a.JDK.1.1.x.style.identity.database", "Importiert Eintr\u00E4ge aus einer Identity-Datenbank im JDK 1.1.x-Stil"}, //-identitydb {"Imports.a.certificate.or.a.certificate.chain", - "Importiert ein Zertifikat oder eine Zertifikatkette"}, //-importcert + "Importiert ein Zertifikat oder eine Zertifikatskette"}, //-importcert {"Imports.a.password", "Importiert ein Kennwort"}, //-importpass {"Imports.one.or.all.entries.from.another.keystore", @@ -304,7 +304,7 @@ "{0}, {1,date}, "}, {"alias.", "{0}, "}, {"Entry.type.type.", "Eintragstyp: {0}"}, - {"Certificate.chain.length.", "Zertifikatkettenl\u00E4nge: "}, + {"Certificate.chain.length.", "Zertifikatskettenl\u00E4nge: "}, {"Certificate.i.1.", "Zertifikat[{0,number,integer}]:"}, {"Certificate.fingerprint.SHA1.", "Zertifikat-Fingerprint (SHA1): "}, {"Keystore.type.", "Keystore-Typ: "}, @@ -388,9 +388,9 @@ {"Certificate.reply.does.not.contain.public.key.for.alias.", "Zertifikatantwort enth\u00E4lt keinen Public Key f\u00FCr <{0}>"}, {"Incomplete.certificate.chain.in.reply", - "Unvollst\u00E4ndige Zertifikatkette in Antwort"}, + "Unvollst\u00E4ndige Zertifikatskette in Antwort"}, {"Certificate.chain.in.reply.does.not.verify.", - "Zertifikatkette in Antwort verifiziert nicht: "}, + "Zertifikatskette in Antwort verifiziert nicht: "}, {"Top.level.certificate.in.reply.", "Zertifikat der obersten Ebene in Antwort:\n"}, {".is.not.trusted.", "... ist nicht vertrauensw\u00FCrdig. "},
--- a/src/solaris/doc/sun/man/man1/ja/appletviewer.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/appletviewer.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: appletviewer -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: appletviewer +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "appletviewer" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" appletviewer \- Webブラウザの外側でアプレットを実行します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIappletviewer\fR [\fIoptions\fR] \fIurl\fR\&.\&.\&. +\fBappletviewer\fR [\fIoptions\fR] \fIurl\fR\&.\&.\&. .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -空白で区切られたコマンドライン・オプション。オプションを参照してください。 +空白で区切られたコマンド行オプション。オプションを参照してください。 .RE .PP \fIurl\fR @@ -73,20 +75,20 @@ .RE .SH "説明" .PP -\fIappletviewer\fRコマンドは\fIurls\fRに指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。urlsによって参照されたドキュメントが、\fIOBJECT\fR、\fIEMBED\fRまたは\fIAPPLET\fRタグでどのアプレットも参照していない場合、\fIappletviewer\fRコマンドは何も行いません。\fIappletviewer\fRコマンドでサポートされるHTMLタグの詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/appletviewertags\&.htmlにある +\fBappletviewer\fRコマンドは\fIurls\fRに指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。urlsによって参照されたドキュメントが、\fBOBJECT\fR、\fBEMBED\fRまたは\fBAPPLET\fRタグでどのアプレットも参照していない場合、\fBappletviewer\fRコマンドは何も行いません。\fBappletviewer\fRコマンドでサポートされるHTMLタグの詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/appletviewertags\&.htmlにある アプレット・ビューア・タグを参照してください。 .PP -\fIappletviewer\fRコマンドは、RFC2396で定義されたエスケープ・メカニズムに従ってエンコードされたURLを必要とします。サポートされるのは、エンコードされたURLのみです。ただし、ファイル名については、RFC2396の仕様に従ってエンコードを解除しておく必要があります。 +\fBappletviewer\fRコマンドは、RFC2396で定義されたエスケープ・メカニズムに従ってエンコードされたURLを必要とします。サポートされるのは、エンコードされたURLのみです。ただし、ファイル名については、RFC2396の仕様に従ってエンコードを解除しておく必要があります。 .PP \fB注意:\fR The -\fIappletviewer\fRコマンドは開発専用です。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/aboutCodeSamples\&.htmlにある +\fBappletviewer\fRコマンドは開発専用です。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/aboutCodeSamples\&.htmlにある サンプル/テスト・アプリケーションおよびコードについてを参照してください。 .SH "オプション" .PP \-debug .RS 4 -\fIjdb\fRコマンドを使用してJavaデバッガでアプレット・ビューアを開始して、ドキュメント中のアプレットをデバッグします。 +\fBjdb\fRコマンドを使用してJavaデバッガでアプレット・ビューアを開始して、ドキュメント中のアプレットをデバッグします。 .RE .PP \-encoding \fIencoding\-name\fR @@ -96,7 +98,7 @@ .PP \-J\fIjavaoption\fR .RS 4 -文字列\fIjavaoption\fRは、アプレット・ビューアを実行するJavaインタプリタに1つの引数として渡されます。引数にスペースを含めないでください。複数の引数は、すべてが接頭辞\fI\-J\fRで始まる必要があります。これは、コンパイラの実行環境またはメモリー使用の調整に有効です。 +文字列\fBjavaoption\fRは、アプレット・ビューアを実行するJavaインタプリタに1つの引数として渡されます。引数にスペースを含めないでください。複数の引数は、すべてが接頭辞\fB\-J\fRで始まる必要があります。これは、コンパイラの実行環境またはメモリー使用の調整に有効です。 .RE .PP
--- a/src/solaris/doc/sun/man/man1/ja/extcheck.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/extcheck.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: extcheck -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: extcheck +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "extcheck" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" extcheck \- ターゲットのJavaアーカイブ(JAR)ファイルと現在インストールされている拡張機能のJARファイル間のバージョンの競合を検出します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIextcheck\fR [\fIoptions\fR] \fItargetfile\&.jar\fR +\fBextcheck\fR [\fIoptions\fR] \fItargetfile\&.jar\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fItargetfile\&.jar\fR @@ -73,13 +75,13 @@ .RE .SH "説明" .PP -\fIextcheck\fRコマンドは、指定されたJARファイルのタイトルおよびバージョンがJava SE SDKにインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティを使用して、同じバージョンまたはより新しいバージョンの拡張機能がすでにインストールされていないかどうかを調べることができます。 +\fBextcheck\fRコマンドは、指定されたJARファイルのタイトルおよびバージョンがJava SE SDKにインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティを使用して、同じバージョンまたはより新しいバージョンの拡張機能がすでにインストールされていないかどうかを調べることができます。 .PP -\fIextcheck\fRコマンドは、\fItargetfile\&.jar\fRファイルのマニフェスト内のヘッダーSpecification\-titleおよびSpecification\-versionを、拡張機能ディレクトリ内に現在インストールされているすべてのJARファイル内の対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、Oracle Solarisの場合は\fIjre/lib/ext\fR、Windowsの場合は\fI\ejre\elib\eext\fRです。\fIextcheck\fRコマンドは、\fIjava\&.lang\&.Package\&.isCompatibleWith\fRメソッドと同様の方法でバージョン番号を比較します。 +\fBextcheck\fRコマンドは、\fBtargetfile\&.jar\fRファイルのマニフェスト内のヘッダーSpecification\-titleおよびSpecification\-versionを、拡張機能ディレクトリ内に現在インストールされているすべてのJARファイル内の対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、Oracle Solarisの場合は\fBjre/lib/ext\fR、Windowsの場合は\fB\ejre\elib\eext\fRです。\fBextcheck\fRコマンドは、\fBjava\&.lang\&.Package\&.isCompatibleWith\fRメソッドと同様の方法でバージョン番号を比較します。 .PP 競合が検出されない場合、リターン・コードは0です。 .PP -拡張機能ディレクトリ内のいずれかのJARファイルのマニフェストに、同一の\fISpecification\-title\fR、および同一またはより新しい\fISpecification\-version\fR番号がある場合は、ゼロでないエラー・コードが返されます。\fItargetfile\&.jar\fRのマニフェスト・ファイルに\fISpecification\-title\fRまたは\fISpecification\-version\fR属性がない場合も、ゼロでないエラー・コードが返されます。 +拡張機能ディレクトリ内のいずれかのJARファイルのマニフェストに、同一の\fBSpecification\-title\fR、および同一またはより新しい\fBSpecification\-version\fR番号がある場合は、ゼロでないエラー・コードが返されます。\fBtargetfile\&.jar\fRのマニフェスト・ファイルに\fBSpecification\-title\fRまたは\fBSpecification\-version\fR属性がない場合も、ゼロでないエラー・コードが返されます。 .SH "オプション" .PP \-verbose @@ -89,7 +91,7 @@ .PP \-J\fIoption\fR .RS 4 -Java仮想マシン(JVM)に\fIoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machine (JVM)に\fIoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/idlj.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/idlj.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: idlj -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java IDLおよびRMI-IIOPツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: idlj +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java IDLおよびRMI-IIOPツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "idlj" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" idlj \- 指定されたインタフェース定義言語(IDL)ファイルに対してJavaバインディングを生成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIidlj\fR [ \fIoptions\fR ] \fIidlfile\fR +\fBidlj\fR [ \fIoptions\fR ] \fIidlfile\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。optionsの順番は任意ですが、\fIidlfile\fRよりも前に指定する必要があります。 +コマンド行オプション。オプションを参照してください。optionsの順番は任意ですが、\fBidlfile\fRよりも前に指定する必要があります。 .RE .PP \fIidlfile\fR @@ -76,16 +78,17 @@ IDL\-to\-Javaコンパイラは、指定されたIDLファイルに対してJavaバインディングを生成します。バインディングの詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/mapping/jidlMapping\&.htmlにある Java IDL: Java言語マッピングへのIDLを参照してください。 .PP -IDL\-to\-Javaコンパイラの以前のリリースの中には、\fIidltojava\fRという名前だったものがあります。 +IDL\-to\-Javaコンパイラの以前のリリースの中には、\fBidltojava\fRという名前だったものがあります。 .SS "クライアント・バインディングおよびサーバー・バインディングの発行" .PP -次の\fIidlj\fRコマンドは、クライアント側バインディングを含む\fIMy\&.idl\fRという名前のIDLファイルを生成します。 +次の\fBidlj\fRコマンドは、クライアント側バインディングを含む\fBMy\&.idl\fRという名前のIDLファイルを生成します。 .sp .if n \{\ .RS 4 .\} .nf -idlj My\&.idl +\fBidlj My\&.idl\fR + .fi .if n \{\ .RE @@ -97,7 +100,8 @@ .RS 4 .\} .nf -idlj \-fclient My\&.idl +\fBidlj \-fclient My\&.idl\fR + .fi .if n \{\ .RE @@ -109,7 +113,8 @@ .RS 4 .\} .nf -idlg \-fserver My\&.idl +\fBidlg \-fserver My\&.idl\fR + .fi .if n \{\ .RE @@ -121,102 +126,78 @@ .RS 4 .\} .nf -idlj \-fclient \-fserver My\&.idl -idlj \-fall My\&.idl +\fBidlj \-fclient \-fserver My\&.idl\fR +\fBidlj \-fall My\&.idl\fR + .fi .if n \{\ .RE .\} .PP サーバー側で可能なモデルは2つあります。移殖可能サーバント継承モデルとTieモデルです。Tie委譲モデルを参照してください。 -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fB移殖可能サーバント継承モデル\fR -.ps -1 -.br +.PP +\fB移殖可能サーバント継承モデル\fR. デフォルトのサーバー側のモデルは、移殖可能サーバント継承モデルです。\fBMy\&.idl\fR内で\fBMy\fRインタフェースが定義されている場合は、\fBMyPOA\&.java\fRというファイルが生成されます。\fBMy\fRインタフェースの実装を提供する必要があり、\fBMy\fRインタフェースは\fBMyPOA\fRクラスから継承する必要があります。\fBMyPOA\&.java\fRは、http://docs\&.oracle\&.com/javase/8/docs/api/org/omg/PortableServer/Servant\&.htmlにある +\fBorg\&.omg\&.PortableServer\&.Servant\fRクラスを拡張するストリームベースのスケルトンです。 .PP -デフォルトのサーバー側のモデルは、移殖可能サーバント継承モデルです。\fIMy\&.idl\fR内で\fIMy\fRインタフェースが定義されている場合は、\fIMyPOA\&.java\fRというファイルが生成されます。\fIMy\fRインタフェースの実装を提供する必要があり、\fIMy\fRインタフェースは\fIMyPOA\fRクラスから継承する必要があります。\fIMyPOA\&.java\fRは、http://docs\&.oracle\&.com/javase/8/docs/api/org/omg/PortableServer/Servant\&.htmlにある -\fIorg\&.omg\&.PortableServer\&.Servant\fRクラスを拡張するストリームベースのスケルトンです。 +\fBMy\fRインタフェースは、スケルトンが実装するIDLインタフェースに関連付けられている\fBcallHandler\fRインタフェースと操作インタフェースを実装します。 .PP -\fIMy\fRインタフェースは、スケルトンが実装するIDLインタフェースに関連付けられている\fIcallHandler\fRインタフェースと操作インタフェースを実装します。 -.PP -ポータブル・オブジェクト・アダプタ(POA)の\fIPortableServer\fRモジュールは、ネイティブの\fIServant\fR型を定義します。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/POA\&.htmlにある +ポータブル・オブジェクト・アダプタ(POA)の\fBPortableServer\fRモジュールは、ネイティブの\fBServant\fR型を定義します。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/POA\&.htmlにある ポータブル・オブジェクト・アダプタ(POA)を参照してください。 .PP -Javaプログラミング言語では、\fIServant\fR型はJavaの\fIorg\&.omg\&.PortableServer\&.Servant\fRクラスにマップされます。これは、すべてのPOAサーバント実装のベース・クラスとして機能し、アプリケーション・プログラマが呼び出すことのできるいくつかのメソッド、およびPOAによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドを提供します。 +Javaプログラミング言語では、\fBServant\fR型はJavaの\fBorg\&.omg\&.PortableServer\&.Servant\fRクラスにマップされます。これは、すべてのPOAサーバント実装のベース・クラスとして機能し、アプリケーション・プログラマが呼び出すことのできるいくつかのメソッド、およびPOAによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドを提供します。 .PP -継承モデルのもう1つのオプションは、\fI\-oldImplBase\fRフラグを使用して、Java SE 1\&.4より前のリリースのJavaプログラミング言語と互換性のあるサーバー側バインディングを生成することです。\-\fIoldImplBase\fRフラグは非標準で、これらのAPIは非推奨です。このフラグを使用するのは、Java SE 1\&.3で記述された既存のサーバーとの互換性が必要な場合のみです。その場合、既存のmakeファイルを変更して、\fI\-oldImplBase\fRフラグを\fIidlj\fRコンパイラに追加する必要があります。それ以外の場合、POAベースのサーバー側マッピングが生成されます。下位互換性のあるサーバー側バインディングを生成するには、次を実行します。 -.sp .5v -.RE +継承モデルのもう1つのオプションは、\fB\-oldImplBase\fRフラグを使用して、Java SE 1\&.4より前のリリースのJavaプログラミング言語と互換性のあるサーバー側バインディングを生成することです。\-\fBoldImplBase\fRフラグは非標準で、これらのAPIは非推奨です。このフラグを使用するのは、Java SE 1\&.3で記述された既存のサーバーとの互換性が必要な場合のみです。その場合、既存のmakeファイルを変更して、\fB\-oldImplBase\fRフラグを\fBidlj\fRコンパイラに追加する必要があります。それ以外の場合、POAベースのサーバー側マッピングが生成されます。後方互換性のあるサーバー側バインディングを生成するには、次を実行します。 .sp .if n \{\ .RS 4 .\} .nf -idlj \-fclient \-fserver \-oldImplBase My\&.idl -idlj \-fall \-oldImplBase My\&.idl +\fBidlj \-fclient \-fserver \-oldImplBase My\&.idl\fR +\fBidlj \-fall \-oldImplBase My\&.idl\fR + .fi .if n \{\ .RE .\} .PP -\fIMy\&.idl\fR内で\fIMy\fRインタフェースが定義されている場合は、\fI_MyImplBase\&.java\fRというファイルが生成されます。\fIMy\fRインタフェースの実装を提供する必要があり、\fIMy\fRインタフェースは\fI_MyImplBase\fRクラスから継承する必要があります。 -.if n \{\ -.sp -.\} -.RS 4 -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.br -.ps +1 -\fBTie委譲モデル\fR -.ps -1 -.br +\fBMy\&.idl\fR内で\fBMy\fRインタフェースが定義されている場合は、\fB_MyImplBase\&.java\fRというファイルが生成されます。\fBMy\fRインタフェースの実装を提供する必要があり、\fBMy\fRインタフェースは\fB_MyImplBase\fRクラスから継承する必要があります。 .PP -もう1つのサーバー側モデルは、Tieモデルと呼ばれるものです。このサーバー側モデルは、委譲モデルです。Tieとスケルトンを同時に生成することはできないため、それらは別々に生成する必要があります。次のコマンドによって、Tieモデル用のバインディングが生成されます。 -.sp .5v -.RE +\fBTie委譲モデル\fR. もう1つのサーバー側モデルは、Tieモデルと呼ばれるものです。このサーバー側モデルは、委譲モデルです。Tieとスケルトンを同時に生成することはできないため、それらは別々に生成する必要があります。次のコマンドによって、Tieモデル用のバインディングが生成されます。 .sp .if n \{\ .RS 4 .\} .nf -idlj \-fall My\&.idl -idlj \-fallTIE My\&.idl +\fBidlj \-fall My\&.idl\fR +\fBidlj \-fallTIE My\&.idl\fR + .fi .if n \{\ .RE .\} .PP -\fIMy\fRインタフェースの場合、2番目のコマンドにより、\fIMyPOATie\&.java\fRが生成されます。\fIMyPOATie\fRクラスへのコンストラクタは、delegateを取ります。この例では、デフォルトのPOAモデルを使用しているため、コンストラクタにもPOAが必要です。delegateに対して実装を提供する必要がありますが、この実装は\fIMyOperations\fRインタフェースから継承する必要があるのみで、その他のクラスから継承する必要はありません。これをORBと一緒に使用するには、たとえば次のように\fIMyPOATie\fRクラス内で実装をラップする必要があります。 +\fBMy\fRインタフェースの場合、2番目のコマンドにより、\fBMyPOATie\&.java\fRが生成されます。\fBMyPOATie\fRクラスへのコンストラクタは、delegateを取ります。この例では、デフォルトのPOAモデルを使用しているため、コンストラクタにもPOAが必要です。delegateに対して実装を提供する必要がありますが、この実装は\fBMyOperations\fRインタフェースから継承する必要があるのみで、その他のクラスから継承する必要はありません。これをORBと一緒に使用するには、たとえば次のように\fBMyPOATie\fRクラス内で実装をラップする必要があります。 .sp .if n \{\ .RS 4 .\} .nf -ORB orb = ORB\&.init(args, System\&.getProperties()); - -// Get reference to rootpoa & activate the POAManager -POA rootpoa = (POA)orb\&.resolve_initial_references("RootPOA"); -rootpoa\&.the_POAManager()\&.activate(); +\fBORB orb = ORB\&.init(args, System\&.getProperties());\fR +\fB \fR +\fB// Get reference to rootpoa & activate the POAManager\fR +\fBPOA rootpoa = (POA)orb\&.resolve_initial_references("RootPOA");\fR +\fBrootpoa\&.the_POAManager()\&.activate();\fR +\fB \fR +\fB// create servant and register it with the ORB\fR +\fBMyServant myDelegate = new MyServant();\fR +\fBmyDelegate\&.setORB(orb); \fR +\fB \fR +\fB// create a tie, with servant being the delegate\&.\fR +\fBMyPOATie tie = new MyPOATie(myDelegate, rootpoa);\fR +\fB \fR +\fB// obtain the objectRef for the tie\fR +\fBMy ref = tie\&._this(orb);\fR -// create servant and register it with the ORB -MyServant myDelegate = new MyServant(); -myDelegate\&.setORB(orb); - -// create a tie, with servant being the delegate\&. -MyPOATie tie = new MyPOATie(myDelegate, rootpoa); - -// obtain the objectRef for the tie -My ref = tie\&._this(orb); .fi .if n \{\ .RE @@ -230,146 +211,154 @@ .RS 4 .\} .nf -idlj \-oldImplBase \-fall My\&.idl -idlj \-oldImplBase \-fallTIE My\&.idl +\fBidlj \-oldImplBase \-fall My\&.idl\fR +\fBidlj \-oldImplBase \-fallTIE My\&.idl\fR + .fi .if n \{\ .RE .\} .PP -\fIMy\fRインタフェースの場合、これにより、\fIMy_Tie\&.java\fRが生成されます。\fIMy_Tie\fRクラスへのコンストラクタは、\fIimpl\fRオブジェクトを取ります。\fIimpl\fRに対して実装を提供する必要がありますが、その実装は\fIHelloOperations\fRインタフェースから継承する必要があるのみで、その他のクラスから継承する必要はありません。しかし、これをORBと一緒に使用するには、たとえば次のように\fIMy_Tie\fR内で実装をラップする必要があります。 +\fBMy\fRインタフェースの場合、これにより、\fBMy_Tie\&.java\fRが生成されます。\fBMy_Tie\fRクラスへのコンストラクタは、\fBimpl\fRオブジェクトを取ります。\fBimpl\fRに対して実装を提供する必要がありますが、その実装は\fBHelloOperations\fRインタフェースから継承する必要があるのみで、その他のクラスから継承する必要はありません。しかし、これをORBと一緒に使用するには、たとえば次のように\fBMy_Tie\fR内で実装をラップする必要があります。 .sp .if n \{\ .RS 4 .\} .nf -ORB orb = ORB\&.init(args, System\&.getProperties()); - -// create servant and register it with the ORB -MyServant myDelegate = new MyServant(); -myDelegate\&.setORB(orb); +\fBORB orb = ORB\&.init(args, System\&.getProperties());\fR -// create a tie, with servant being the delegate\&. -MyPOATie tie = new MyPOATie(myDelegate); +\fB// create servant and register it with the ORB\fR +\fBMyServant myDelegate = new MyServant();\fR +\fBmyDelegate\&.setORB(orb); \fR +\fB \fR +\fB// create a tie, with servant being the delegate\&.\fR +\fBMyPOATie tie = new MyPOATie(myDelegate);\fR +\fB \fR +\fB// obtain the objectRef for the tie\fR +\fBMy ref = tie\&._this(orb);\fR -// obtain the objectRef for the tie -My ref = tie\&._this(orb); .fi .if n \{\ .RE .\} .SS "発行されたファイルの代替位置の指定" .PP -発行されたファイルを現在のディレクトリ以外のディレクトリに置くには、\fIi\fR\fIdlj \-td /altdir My\&.idl\fRのコマンドでコンパイラを呼び出します。 +発行されたファイルを現在のディレクトリ以外のディレクトリに置くには、\fBi\fR\fBdlj \-td /altdir My\&.idl\fRのコマンドでコンパイラを呼び出します。 .PP -\fIMy\fRインタフェースの場合、バインディングは、\fI\&./My\&.java\fRではなく、\fI/altdir/My\&.java\fRなどに発行されます。 +\fBMy\fRインタフェースの場合、バインディングは、\fB\&./My\&.java\fRではなく、\fB/altdir/My\&.java\fRなどに発行されます。 .SS "インクルード・ファイルの代替位置の指定" .PP -\fIMy\&.idl\fRファイルが別の\fIidl\fRファイルである\fIMyOther\&.idl\fRをインクルードする場合、コンパイラでは、\fIMyOther\&.idl\fRファイルがローカル・ディレクトリに存在することを前提としています。たとえば、それが\fI/includes\fRにある場合は、次のようなコマンドでコンパイラを呼び出します。 +\fBMy\&.idl\fRファイルが別の\fBidl\fRファイルである\fBMyOther\&.idl\fRをインクルードする場合、コンパイラでは、\fBMyOther\&.idl\fRファイルがローカル・ディレクトリに存在することを前提としています。たとえば、それが\fB/includes\fRにある場合は、次のようなコマンドでコンパイラを呼び出します。 .sp .if n \{\ .RS 4 .\} .nf -idlj \-i /includes My\&.idl +\fBidlj \-i /includes My\&.idl\fR + .fi .if n \{\ .RE .\} .PP -たとえば、\fI/moreIncludes\fRにある\fIAnother\&.idl\fRも\fIMy\&.idl\fRにインクルードされているのであれば、次のようなコマンドでコンパイラを呼び出します。 +たとえば、\fB/moreIncludes\fRにある\fBAnother\&.idl\fRも\fBMy\&.idl\fRにインクルードされているのであれば、次のようなコマンドでコンパイラを呼び出します。 .sp .if n \{\ .RS 4 .\} .nf -idlj \-i /includes \-i /moreIncludes My\&.idl +\fBidlj \-i /includes \-i /moreIncludes My\&.idl\fR + .fi .if n \{\ .RE .\} .PP -このような形式の\fIinclude\fRは長くなるため、インクルード・ファイルを検索する場所をコンパイラに指示するための別の方法が用意されています。この方法は、環境変数の考え方と似ています。\fICLASSPATH\fR変数に一覧表示されているディレクトリ内にidl\&.configという名前のファイルを作成します。その\fIidl\&.config\fRの中に、次のような形式の行を入れます。 +このような形式の\fBinclude\fRは長くなるため、インクルード・ファイルを検索する場所をコンパイラに指示するための別の方法が用意されています。この方法は、環境変数の考え方と似ています。\fBCLASSPATH\fR変数に一覧表示されているディレクトリ内にidl\&.configという名前のファイルを作成します。その\fBidl\&.config\fRの中に、次のような形式の行を入れます。 .sp .if n \{\ .RS 4 .\} .nf -includes=/includes;/moreIncludes +\fBincludes=/includes;/moreIncludes\fR + .fi .if n \{\ .RE .\} .PP -コンパイラは、このファイルを検索し、インクルード・リストを読み込みます。この例では、ディレクトリの間の区切り文字はセミコロン(;)になっています。この区切り文字は、プラットフォームによって異なります。Windowsプラットフォームではセミコロンを使用し、UNIXプラットフォームではコロンを使用するなどです。 +コンパイラは、このファイルを検索し、インクルード・リストを読み込みます。この例では、ディレクトリの間の区切り文字はセミコロン(;)になっています。この区切り文字は、プラットフォームによって異なります。Windowsプラットフォームではセミコロンを使用し、Solaris、LinuxおよびOS Xプラットフォームではコロンを使用します。 .SS "インクルード・ファイルに対するバインディングの発行" .PP -デフォルトでは、コマンドラインに指定した\fIidl\fRファイルで定義されているインタフェースや構造体などについてのみ、Javaバインディングが生成されます。インクルードされたファイルで定義されている型については生成されません。たとえば、次の2つの\fIidl\fRファイルについて考えてみます。 +デフォルトでは、コマンド行に指定した\fBidl\fRファイルで定義されているインタフェースや構造体などについてのみ、Javaバインディングが生成されます。インクルードされたファイルで定義されている型については生成されません。たとえば、次の2つの\fBidl\fRファイルについて考えてみます。 .sp .if n \{\ .RS 4 .\} .nf -My\&.idl file: +\fBMy\&.idl file:\fR +\fB \fR +\fB#include <MyOther\&.idl>\fR +\fBinterface My\fR +\fB{\fR +\fB};\fR +\fB \fR +\fBMyOther\&.idl file:\fR +\fB \fR +\fBinterface MyOther\fR +\fB{\fR +\fB};\fR -#include <MyOther\&.idl> -interface My -{ -}; - -MyOther\&.idl file: - -interface MyOther -{ -}; .fi .if n \{\ .RE .\} .PP -デフォルトのルールに関して警告があります。グローバル・スコープに表示される\fI#include\fR文は、前述のとおりに処理されます。これらの\fI#include\fR文は、インポート文と見なすことができます。囲まれたスコープ内に表示される\fI#include\fR文は、本当の意味での\fI#include\fR文として処理されます。つまり、インクルードされたファイルにあるコードが、元のファイルにそのまま表示されているかのように処理され、それに対してJavaバインディングが発行されます。次はその例です。 +デフォルトのルールに関して警告があります。グローバル・スコープに表示される\fB#include\fR文は、前述のとおりに処理されます。これらの\fB#include\fR文は、インポート文と見なすことができます。囲まれたスコープ内に表示される\fB#include\fR文は、本当の意味での\fB#include\fR文として処理されます。つまり、インクルードされたファイルにあるコードが、元のファイルにそのまま表示されているかのように処理され、それに対してJavaバインディングが発行されます。次はその例です。 .sp .if n \{\ .RS 4 .\} .nf -My\&.idl file: - -#include <MyOther\&.idl> -interface My -{ - #include <Embedded\&.idl> -}; +\fBMy\&.idl file:\fR +\fB \fR +\fB#include <MyOther\&.idl>\fR +\fBinterface My\fR +\fB{\fR +\fB #include <Embedded\&.idl>\fR +\fB};\fR +\fB \fR +\fBMyOther\&.idl file:\fR +\fB \fR +\fBinterface MyOther\fR +\fB{\fR +\fB};\fR +\fB \fR +\fBEmbedded\&.idl\fR +\fB \fR +\fBenum E {one, two, three};\fR -MyOther\&.idl file: - -interface MyOther -{ -}; - -Embedded\&.idl - -enum E {one, two, three}; .fi .if n \{\ .RE .\} .PP -\fI idlj My\&.idl \fRを実行して、Javaファイルの次のリストを生成します。インポート文とみなされる\fI#include\fRに定義されていたため、\fIMyOther\&.java\fRは生成されませんでした。ただし、本当の意味での\fI#include\fRで定義されていたため、\fIE\&.java\fRは生成されました。\fIEmbedded\&.idl\fRファイルが\fIMy\fRインタフェースのスコープ内にインクルードされているため、\fIMy\fRのスコープ内(つまり、\fIMyPackage\fR内)に生成されています。\fI\-emitAll\fRフラグを使用した場合、インクルードされたすべてのファイルにあるすべての型が発行されます。 +\fB idlj My\&.idl \fRを実行して、Javaファイルの次のリストを生成します。インポート文とみなされる\fB#include\fRに定義されていたため、\fBMyOther\&.java\fRは生成されませんでした。ただし、本当の意味での\fB#include\fRで定義されていたため、\fBE\&.java\fRは生成されました。\fBEmbedded\&.idl\fRファイルが\fBMy\fRインタフェースのスコープ内にインクルードされているため、\fBMy\fRのスコープ内(つまり、\fBMyPackage\fR内)に生成されています。\fB\-emitAll\fRフラグを使用した場合、インクルードされたすべてのファイルにあるすべての型が発行されます。 .sp .if n \{\ .RS 4 .\} .nf -\&./MyHolder\&.java -\&./MyHelper\&.java -\&./_MyStub\&.java -\&./MyPackage -\&./MyPackage/EHolder\&.java -\&./MyPackage/EHelper\&.java -\&./MyPackage/E\&.java -\&./My\&.java +\fB\&./MyHolder\&.java\fR +\fB\&./MyHelper\&.java\fR +\fB\&./_MyStub\&.java\fR +\fB\&./MyPackage\fR +\fB\&./MyPackage/EHolder\&.java\fR +\fB\&./MyPackage/EHelper\&.java\fR +\fB\&./MyPackage/E\&.java\fR +\fB\&./My\&.java\fR + .fi .if n \{\ .RE @@ -382,49 +371,51 @@ .RS 4 .\} .nf -Widgets\&.idl file: +\fBWidgets\&.idl file:\fR +\fB \fR +\fBmodule Widgets\fR +\fB{\fR +\fB interface W1 {\&.\&.\&.};\fR +\fB interface W2 {\&.\&.\&.};\fR +\fB};\fR -module Widgets -{ - interface W1 {\&.\&.\&.}; - interface W2 {\&.\&.\&.}; -}; .fi .if n \{\ .RE .\} .PP -IDL\-to\-Javaコンパイラを介してこのファイルを実行した場合、W1およびW2に対するJavaバインディングは、\fIWidgets\fRパッケージ内に格納されます。業界の慣例によると、会社のパッケージは、\fIcom\&.<company name>\fRという名前のパッケージ内に置くことになっています。この慣例に従うには、パッケージ名を\fIcom\&.abc\&.Widgets\fRにする必要があります。このパッケージ接頭辞をWidgetsモジュールに付加するには、次のコマンドを実行します。 +IDL\-to\-Javaコンパイラを介してこのファイルを実行した場合、W1およびW2に対するJavaバインディングは、\fBWidgets\fRパッケージ内に格納されます。業界の慣例によると、会社のパッケージは、\fBcom\&.<company name>\fRという名前のパッケージ内に置くことになっています。この慣例に従うには、パッケージ名を\fBcom\&.abc\&.Widgets\fRにする必要があります。このパッケージ接頭辞をWidgetsモジュールに付加するには、次のコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -idlj \-pkgPrefix Widgets com\&.abc Widgets\&.idl +\fBidlj \-pkgPrefix Widgets com\&.abc Widgets\&.idl\fR + .fi .if n \{\ .RE .\} .PP -Widgets\&.idlをインクルードしているIDLファイルがある場合は、そのコマンドにも\fI\-pkgPrefix\fRフラグが必要です。このフラグを指定しないと、そのIDLファイルは、\fIcom\&.abc\&.Widgets\fRパッケージではなく、\fIWidgets\fRパッケージを検索することになります。 +Widgets\&.idlをインクルードしているIDLファイルがある場合は、そのコマンドにも\fB\-pkgPrefix\fRフラグが必要です。このフラグを指定しないと、そのIDLファイルは、\fBcom\&.abc\&.Widgets\fRパッケージではなく、\fBWidgets\fRパッケージを検索することになります。 .PP -接頭辞が必要なパッケージがいくつもある場合は、前述のidl\&.configファイルで接頭辞を指定するのが簡単です。パッケージ接頭辞の各行は、\fIPkgPrefix\&.<type>=<prefix>\fRの形式である必要があります。前述の例の行では、\fIPkgPrefix\&.Widgets=com\&.abc\fRになります。このオプションは、リポジトリIDには影響しません。 +接頭辞が必要なパッケージがいくつもある場合は、前述のidl\&.configファイルで接頭辞を指定するのが簡単です。各パッケージの接頭辞行は、\fBPkgPrefix\&.<type>=<prefix>\fRの形式にする必要があります。前述の例の行では、\fBPkgPrefix\&.Widgets=com\&.abc\fRになります。このオプションは、リポジトリIDには影響しません。 .SS "コンパイル前のシンボルの定義" .PP -コンパイル用のシンボルがIDLファイル内で定義されていない場合は、そのシンボルを定義する必要があります。これは、たとえば、バインディング内にデバッグ・コードを組み入れるときに使用します。コマンド\fIidlj \-d MYDEF My\&.idl \fRは、My\&.idl内に行\fI#define MYDEF\fRを配置した場合と同等になります。 +コンパイル用のシンボルがIDLファイル内で定義されていない場合は、そのシンボルを定義する必要があります。これは、たとえば、バインディング内にデバッグ・コードを組み入れるときに使用します。コマンド\fBidlj \-d MYDEF My\&.idl \fRは、My\&.idl内に行\fB#define MYDEF\fRを配置した場合と同等になります。 .SS "既存のバインディングの保持" .PP -Javaバインディング・ファイルがすでに存在する場合は、\fI\-keep\fRフラグを指定すると、コンパイラによる上書きを回避できます。デフォルトでは、すでに存在するかどうかにかかわらず、すべてのファイルが生成されます。これらのファイルをカスタマイズした場合(ただし、それらの内容が正確であるとき以外はカスタマイズは避ける)、\fI\-keep\fRオプションは有用です。コマンド\fIidlj \-keep My\&.idl\fRは、すでに存在しないすべてのクライアント側バインディングを発行します。 +Javaバインディング・ファイルがすでに存在する場合は、\fB\-keep\fRフラグを指定すると、コンパイラによる上書きを回避できます。デフォルトでは、すでに存在するかどうかにかかわらず、すべてのファイルが生成されます。これらのファイルをカスタマイズした場合(ただし、それらの内容が正確であるとき以外はカスタマイズは避ける)、\fB\-keep\fRオプションは有用です。コマンド\fBidlj \-keep My\&.idl\fRは、すでに存在しないすべてのクライアント側バインディングを発行します。 .SS "コンパイルの進捗状況の表示" .PP -IDL\-to\-Javaコンパイラは、実行の各段階で状態メッセージを生成します。\fI\-v\fRオプションを使用して、\fIidlj \-v My\&.idl\fRのような冗長モードをアクティブ化します。 +IDL\-to\-Javaコンパイラは、実行の各段階で状態メッセージを生成します。\fB\-v\fRオプションを使用して、\fBidlj \-v My\&.idl\fRのような冗長モードをアクティブ化します。 .PP デフォルトでは、コンパイラは冗長モードでは実行されません。 .SS "バージョン情報の表示" .PP -IDL\-to\-Javaコンパイラのビルド・バージョンを表示するには、コマンドライン\fIidlj \-version\fRで\fI\-version\fRオプションを指定します。 +IDL\-to\-Javaコンパイラのビルド・バージョンを表示するには、コマンド行\fBidlj \-version\fRで\fB\-version\fRオプションを指定します。 .PP -バージョン情報は、コンパイラによって生成されたバインディング内にも書き込まれています。このオプションをコマンドラインに指定すると、それ以外のオプションを指定しても、すべて無視されます。 +バージョン情報は、コンパイラによって生成されたバインディング内にも書き込まれています。このオプションをコマンド行に指定すると、それ以外のオプションを指定しても、すべて無視されます。 .SH "オプション" .PP \-d \fIsymbol\fR @@ -435,7 +426,8 @@ .RS 4 .\} .nf -#define \fIsymbol\fR +\fB#define \fR\fB\fIsymbol\fR\fR + .fi .if n \{\ .RE @@ -444,12 +436,12 @@ .PP \-demitAll .RS 4 -\fI#include\fRファイル内で定義されているものも含めて、すべての型を発行します。 +\fB#include\fRファイル内で定義されているものも含めて、すべての型を発行します。 .RE .PP \-fside .RS 4 -発行するバインディングを定義します。\fIside\fRパラメータには、\fIclient\fR、\fIserver\fR、\fIserverTIE\fR、\fIall\fRまたは\fIallTIE\fRを指定できます。\fI\-fserverTIE\fRまたは\fI\-fallTIE\fRオプションを指定すると、委譲モデル・スケルトンが発行されます。フラグを指定しない場合、\fI\-fclient\fRにデフォルト設定されます。 +発行するバインディングを定義します。\fBside\fRパラメータには、\fBclient\fR、\fBserver\fR、\fBserverTIE\fR、\fBall\fRまたは\fBallTIE\fRを指定できます。\fB\-fserverTIE\fRまたは\fB\-fallTIE\fRオプションを指定すると、委譲モデル・スケルトンが発行されます。フラグを指定しない場合、\fB\-fclient\fRにデフォルト設定されます。 .RE .PP \-i \fIinclude\-path\fR @@ -469,17 +461,17 @@ .PP \-oldImplBase .RS 4 -1\&.4より前のJDK ORBと互換性のあるスケルトンを生成します。デフォルトでは、POA継承モデルのサーバー側バインディングが生成されます。このオプションを指定すると、\fIImplBase\fR継承モデルのクラスであるサーバー側バインディングが生成されるので、以前のリリースのJavaプログラミング言語との下位互換性が得られます。 +1\&.4より前のJDK ORBと互換性のあるスケルトンを生成します。デフォルトでは、POA継承モデルのサーバー側バインディングが生成されます。このオプションを指定すると、\fBImplBase\fR継承モデルのクラスであるサーバー側バインディングが生成されるので、以前のリリースのJavaプログラミング言語との後方互換性が得られます。 .RE .PP \-pkgPrefix \fItype\fR \fIprefix\fR .RS 4 -\fItype\fRがファイル・スコープで検出された場合は、その型に対して生成されるすべてのファイルについて、生成されるJavaパッケージ名に\fIprefix\fRという接頭辞が付加されます。typeは、トップレベル・モジュールの単純名か、どのモジュールよりも外側で定義されたIDL型の単純名のどちらかです。 +\fBtype\fRがファイル・スコープで検出された場合は、その型に対して生成されるすべてのファイルについて、生成されるJavaパッケージ名に\fBprefix\fRという接頭辞が付加されます。typeは、トップレベル・モジュールの単純名か、どのモジュールよりも外側で定義されたIDL型の単純名のどちらかです。 .RE .PP \-pkgTranslate \fItype\fR \fIpackage\fR .RS 4 -識別子の中にモジュール名typeが検出されると、生成されるJavaパッケージ内のすべてのファイルについて、識別子の中のその名前がpackageで置き換えられます。最初に\fIpkgPrefix\fRの変更が行われます。typeの値は、トップレベルのモジュールの単純名、またはすべてのモジュールの外部で定義されたIDL型の単純名で、完全なパッケージ名に正確に一致する必要があります。 +識別子の中にモジュール名typeが検出されると、生成されるJavaパッケージ内のすべてのファイルについて、識別子の中のその名前がpackageで置き換えられます。最初に\fBpkgPrefix\fRの変更が行われます。typeの値は、トップレベルのモジュールの単純名、またはすべてのモジュールの外部で定義されたIDL型の単純名で、完全なパッケージ名に正確に一致する必要があります。 .sp 複数の変換が識別子に一致する場合、次の例に示すように、最も長い一致が選択されます。 .sp @@ -489,7 +481,8 @@ .RS 4 .\} .nf -pkgTranslate type pkg \-pkgTranslate type2\&.baz pkg2\&.fizz +\fBpkgTranslate type pkg \-pkgTranslate type2\&.baz pkg2\&.fizz\fR + .fi .if n \{\ .RE @@ -500,22 +493,23 @@ .RS 4 .\} .nf -type => pkg -type\&.ext => pkg\&.ext -type\&.baz => pkg2\&.fizz -type2\&.baz\&.pkg => pkg2\&.fizz\&.pkg +\fBtype => pkg\fR +\fBtype\&.ext => pkg\&.ext\fR +\fBtype\&.baz => pkg2\&.fizz\fR +\fBtype2\&.baz\&.pkg => pkg2\&.fizz\&.pkg\fR + .fi .if n \{\ .RE .\} -パッケージ名\fIorg\fR、\fIorg\fR\&.o\fImg\fR、または\fIorg\&.omg\fRのサブパッケージは、変換できません。これらのパッケージ名を変換しようとすると、互換性のないコードが生成され、\fI\-pkgTranslate\fRの後の最初の引数としてそれらのパッケージを使用すると、エラーとして扱われます。 +パッケージ名\fBorg\fR、\fBorg\fR\&.o\fBmg\fR、または\fBorg\&.omg\fRのサブパッケージは、変換できません。これらのパッケージ名を変換しようとすると、互換性のないコードが生成され、\fB\-pkgTranslate\fRの後の最初の引数としてそれらのパッケージを使用すると、エラーとして扱われます。 .RE .PP \-skeletonName \fIxxx%yyy\fR .RS 4 -\fIxxx%yyy\fRが、スケルトンに名前を付けるパターンとして使用されます。デフォルトは次のとおりです。\fIPOA\fRベース・クラスの場合は\fI%POA\fR -(\fI\-fserver\fRまたは\fI\-fall\fR)、\fIoldImplBase\fRクラスの場合は\fI_%ImplBase\fR -(\-\fIoldImplBase\fR)および(\fI\-fserver\fRまたは\fI\-fall\fR))。 +\fBxxx%yyy\fRが、スケルトンに名前を付けるパターンとして使用されます。デフォルトは次のとおりです。\fBPOA\fRベース・クラスの場合は\fB%POA\fR +(\fB\-fserver\fRまたは\fB\-fall\fR)、\fBoldImplBase\fRクラスの場合は\fB_%ImplBase\fR +(\-\fBoldImplBase\fR)および(\fB\-fserver\fRまたは\fB\-fall\fR))。 .RE .PP \-td \fIdir\fR @@ -525,10 +519,10 @@ .PP \-tieName \fIxxx%yyy\fR .RS 4 -パターンに従って、\fIxxx%yyy\fRを使用します。デフォルトは次のとおりです。\fIPOA\fRベース・クラスの場合は\fI%POA\fR -(\fI\-fserverTieまたは\-fallTie\fR)、\fIoldImplBase\fR -tieクラスの場合は\fI_%Tie\fR -(\-\fIoldImplBase\fR)および(\fI\-fserverTie\fRまたは\fI\-fallTie\fR))。 +パターンに従って、\fBxxx%yyy\fRを使用します。デフォルトは次のとおりです。\fBPOA\fRベース・クラスの場合は\fB%POA\fR +(\fB\-fserverTieまたは\-fallTie\fR)、\fBoldImplBase\fR +tieクラスの場合は\fB_%Tie\fR +(\-\fBoldImplBase\fR)および(\fB\-fserverTie\fRまたは\fB\-fallTie\fR))。 .RE .PP \-nowarn、\-verbose @@ -542,13 +536,13 @@ .RE .SH "制限事項" .PP -グローバル・スコープ内のエスケープされた識別子は、IDLプリミティブ型の\fIObject\fRまたは\fIValueBase\fRと同じ綴りにしないでください。これは、シンボル表がこれらの識別子でプリロードされているためです。これらの再定義を許可すると、元の定義が上書きされます。これは、おそらく恒久的な制約です。 +グローバル・スコープ内のエスケープされた識別子は、IDLプリミティブ型の\fBObject\fRまたは\fBValueBase\fRと同じ綴りにしないでください。これは、シンボル表がこれらの識別子でプリロードされているためです。これらの再定義を許可すると、元の定義が上書きされます。これは、おそらく恒久的な制約です。 .PP -\fIfixed\fRというIDL型はサポートされていません。 +\fBfixed\fRというIDL型はサポートされていません。 .SH "既知の問題" .PP -グローバル識別子についてインポートが生成されません。予期されないローカル\fIimpl\fRオブジェクトを呼び出すと、例外を受け取ります。しかし、その原因は、\fIServerDelegate\fR -DSIコード内の\fINullPointerException\fRにあるようです。 +グローバル識別子についてインポートが生成されません。予期されないローカル\fBimpl\fRオブジェクトを呼び出すと、例外を受け取ります。しかし、その原因は、\fBServerDelegate\fR +DSIコード内の\fBNullPointerException\fRにあるようです。 .br 'pl 8.5i 'bp
--- a/src/solaris/doc/sun/man/man1/ja/jar.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jar.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jar -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jar +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jar" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,72 +50,77 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jar \- Java Archive (JAR)ファイルを操作します。 .SH "概要" +.PP JARファイルの作成 .sp .if n \{\ .RS 4 .\} .nf -\fIjar c\fR[\fIefmMnv0\fR] [\fIentrypoint\fR] [\fIjarfile\fR] [\fImanifest\fR] [\fI\-C\fR \fIdir\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] +\fBjar c\fR[\fBefmMnv0\fR] [\fIentrypoint\fR] [\fIjarfile\fR] [\fImanifest\fR] [\fB\-C\fR \fIdir\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] .fi .if n \{\ .RE .\} +.PP JARファイルの更新 .sp .if n \{\ .RS 4 .\} .nf -\fIjar u\fR[\fIefmMnv0\fR] [\fIentrypoint\fR] [\fIjarfile\fR] [\fImanifest\fR] [\fI\-C\fR \fIdir\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] +\fBjar u\fR[\fBefmMnv0\fR] [\fIentrypoint\fR] [\fIjarfile\fR] [\fImanifest\fR] [\fB\-C\fR \fIdir\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] .fi .if n \{\ .RE .\} +.PP JARファイルの抽出 .sp .if n \{\ .RS 4 .\} .nf -\fIjar\fR \fIx\fR[\fIvf\fR] [\fIjarfile\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] +\fBjar\fR \fBx\fR[\fBvf\fR] [\fIjarfile\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] .fi .if n \{\ .RE .\} +.PP JARファイルのコンテンツのリスト .sp .if n \{\ .RS 4 .\} .nf -\fIjar\fR \fIt\fR[\fIvf\fR] [\fIjarfile\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] +\fBjar\fR \fBt\fR[\fBvf\fR] [\fIjarfile\fR] \fIfile\fR \&.\&.\&. [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] .fi .if n \{\ .RE .\} +.PP JARファイルへの索引の追加 .sp .if n \{\ .RS 4 .\} .nf -\fIjar\fR \fIi\fR \fIjarfile\fR [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] +\fBjar\fR \fBi\fR \fIjarfile\fR [\-J\fIoption\fR \&.\&.\&.] [@\fIarg\-file\fR \&.\&.\&.] .fi .if n \{\ .RE .\} .SH "説明" .PP -\fIjar\fRコマンドは、ZIPおよびZLIB圧縮形式に基づく汎用のアーカイブおよび圧縮ツールです。ただし、\fIjar\fRコマンドは、主にいくつかのJavaアプレットやアプリケーションを単一のアーカイブにパッケージ化するように設計されました。アプレットやアプリケーションのコンポーネント(ファイル、イメージ、およびサウンド)が1つのアーカイブに結合されていると、Javaエージェント(ブラウザなど)は、それらのコンポーネントを1回のHTTPトランザクションでダウンロードすることができ、コンポーネントごとに新しい接続が不要になります。これにより、ダウンロード時間が大幅に短縮されます。また、\fIjar\fRコマンドはファイルの圧縮も行うため、ダウンロード時間がさらに短縮されます。また、\fIjar\fRコマンドによって、ファイル内の個々のエントリにアプレット作成者による署名を書き込めるため、配布元の認証が可能になります。JARファイルは、圧縮されているかどうかにかかわらず、クラス・パスのエントリとして使用できます。 +\fBjar\fRコマンドは、ZIPおよびZLIB圧縮形式に基づく汎用のアーカイブおよび圧縮ツールです。ただし、\fBjar\fRコマンドは、主にいくつかのJavaアプレットやアプリケーションを単一のアーカイブにパッケージ化するように設計されました。アプレットやアプリケーションのコンポーネント(ファイル、イメージ、およびサウンド)が1つのアーカイブに結合されていると、Javaエージェント(ブラウザなど)は、それらのコンポーネントを1回のHTTPトランザクションでダウンロードすることができ、コンポーネントごとに新しい接続が不要になります。これにより、ダウンロード時間が大幅に短縮されます。また、\fBjar\fRコマンドはファイルの圧縮も行うため、ダウンロード時間がさらに短縮されます。また、\fBjar\fRコマンドによって、ファイル内の個々のエントリにアプレット作成者による署名を書き込めるため、配布元の認証が可能になります。JARファイルは、圧縮されているかどうかにかかわらず、クラス・パスのエントリとして使用できます。 .PP -\fIjar\fRコマンドの構文は、\fItar\fRコマンドの構文に似ています。必須の\fI操作の引数\fRの1つで定義された複数の操作モードがあります。他の引数は、操作の動作を変更する\fIオプション\fR、または操作を実行するために必要な\fIオペランド\fRを使用します。 +\fBjar\fRコマンドの構文は、\fBtar\fRコマンドの構文に似ています。必須の\fI操作の引数\fRの1つで定義された複数の操作モードがあります。他の引数は、操作の動作を変更する\fIオプション\fR、または操作を実行するために必要な\fIオペランド\fRを使用します。 .SH "操作の引数" .PP -\fIjar\fRコマンドを使用する場合は、次の操作の引数のいずれかを指定して実行される操作を選択する必要があります。コマンドラインで他の1文字のオプションと混在させることができますが、通常、操作の引数は指定される最初の引数です。 +\fBjar\fRコマンドを使用する場合は、次の操作の引数のいずれかを指定して実行される操作を選択する必要があります。コマンド行で他の1文字のオプションと混在させることができますが、通常、操作の引数は指定される最初の引数です。 .PP c .RS 4 @@ -145,15 +152,16 @@ .PP e .RS 4 -\fIentrypoint\fRオペランドで指定されるクラスを、実行可能JARファイルにバンドルされるスタンドアロンJavaアプリケーションのエントリ・ポイントに設定します。このオプションを使用すると、マニフェスト・ファイル内の\fIMain\-Class\fR属性値が作成またはオーバーライドされます。\fIe\fRオプションは、JARファイルの作成時(\fIc\fR)または更新時(\fIu\fR)に使用できます。 +\fIentrypoint\fRオペランドで指定されるクラスを、実行可能JARファイルにバンドルされるスタンドアロンJavaアプリケーションのエントリ・ポイントに設定します。このオプションを使用すると、マニフェスト・ファイル内の\fBMain\-Class\fR属性値が作成またはオーバーライドされます。\fBe\fRオプションは、JARファイルの作成時(\fBc\fR)または更新時(\fBu\fR)に使用できます。 .sp -たとえば、次のコマンドでは、\fIMain\&.jar\fRアーカイブが\fIMain\&.class\fRファイルとともに作成されますが、その際、マニフェスト内の\fIMain\-Class\fR属性値は\fIMain\fRに設定されます。 +たとえば、次のコマンドでは、\fBMain\&.jar\fRアーカイブが\fBMain\&.class\fRファイルとともに作成されますが、その際、マニフェスト内の\fBMain\-Class\fR属性値は\fBMain\fRに設定されます。 .sp .if n \{\ .RS 4 .\} .nf -jar cfe Main\&.jar Main Main\&.class +\fBjar cfe Main\&.jar Main Main\&.class\fR + .fi .if n \{\ .RE @@ -164,19 +172,21 @@ .RS 4 .\} .nf -java \-jar Main\&.jar +\fBjava \-jar Main\&.jar\fR + .fi .if n \{\ .RE .\} -あるパッケージ内にエントリ・ポイントのクラス名が含まれている場合、ドット(\&.)またはスラッシュ(/)のいずれかを区切り文字として使用できます。たとえば、\fIMain\&.class\fRが\fImydir\fRという名前のパッケージに含まれている場合、エントリ・ポイントは次のいずれかの方法で指定できます。 +あるパッケージ内にエントリ・ポイントのクラス名が含まれている場合、ドット(\&.)またはスラッシュ(/)のいずれかを区切り文字として使用できます。たとえば、\fBMain\&.class\fRが\fBmydir\fRという名前のパッケージに含まれている場合、エントリ・ポイントは次のいずれかの方法で指定できます。 .sp .if n \{\ .RS 4 .\} .nf -jar \-cfe Main\&.jar mydir/Main mydir/Main\&.class -jar \-cfe Main\&.jar mydir\&.Main mydir/Main\&.class +\fBjar \-cfe Main\&.jar mydir/Main mydir/Main\&.class\fR +\fBjar \-cfe Main\&.jar mydir\&.Main mydir/Main\&.class\fR + .fi .if n \{\ .RE @@ -190,7 +200,7 @@ .nr an-break-flag 1 .br .ps +1 -\fBNote\fR +\fB注記\fR .ps -1 .br .TS @@ -198,7 +208,7 @@ l. T{ 注意 -特定のマニフェストにも\fIMain\-Class\fR属性が含まれている場合に\fIm\fRオプションと\fIe\fRオプションの両方を同時に指定すると、\fIMain\-Class\fRの指定があいまいになります。このあいまいさによってエラーが発生し、\fIjar\fRコマンドの作成や更新の操作が終了します。 +特定のマニフェストにも\fBMain\-Class\fR属性が含まれている場合に\fBm\fRオプションと\fBe\fRオプションの両方を同時に指定すると、\fBMain\-Class\fRの指定があいまいになります。このあいまいさによってエラーが発生し、\fBjar\fRコマンドの作成や更新の操作が終了します。 T} .TE .sp 1 @@ -208,26 +218,26 @@ .PP f .RS 4 -\fIjarfile\fRオペランドで指定されたファイルを、作成(\fIc\fR)、更新(\fIu\fR)、抽出(\fIx\fR)または表示(\fIt\fR)されるJARファイルの名前に設定します。\fIf\fRオプションおよび\fIjarfile\fRオペランドを省略すると、\fIjar\fRコマンドに、\fIstdin\fRからのJARファイル名を受け入れるか(\fIx\fRおよび\fIt\fRの場合)、JARファイルを\fIstdout\fRに送信すること(\fIc\fRおよび\fIu\fRの場合)が指示されます。 +\fIjarfile\fRオペランドで指定されたファイルを、作成(\fBc\fR)、更新(\fBu\fR)、抽出(\fBx\fR)または表示(\fBt\fR)されるJARファイルの名前に設定します。\fBf\fRオプションおよび\fIjarfile\fRオペランドを省略すると、\fBjar\fRコマンドに、\fBstdin\fRからのJARファイル名を受け入れるか(\fBx\fRおよび\fBt\fRの場合)、JARファイルを\fBstdout\fRに送信すること(\fBc\fRおよび\fBu\fRの場合)が指示されます。 .RE .PP m .RS 4 -(\fIMETA\-INF/MANIFEST\&.MF\fRのアーカイブにある) -\fIjar\fRコマンドのマニフェスト・ファイルの\fImanifest\fRオペランドで指定されたファイルから、属性の名前と値のペアを含めます。\fIjar\fRコマンドは、同じ名前のエントリがすでに存在する場合を除き、属性の名前と値をJARファイルに追加します。同じ名前のエントリがすでに存在する場合、\fIjar\fRコマンドは属性の値を更新します。\fIm\fRオプションは、JARファイルの作成時(\fIc\fR)または更新時(\fIu\fR)に使用できます。 +(\fBMETA\-INF/MANIFEST\&.MF\fRのアーカイブにある) +\fBjar\fRコマンドのマニフェスト・ファイルの\fBmanifest\fRオペランドで指定されたファイルから、属性の名前と値のペアを含めます。\fBjar\fRコマンドは、同じ名前のエントリがすでに存在する場合を除き、属性の名前と値をJARファイルに追加します。同じ名前のエントリがすでに存在する場合、\fBjar\fRコマンドは属性の値を更新します。\fBm\fRオプションは、JARファイルの作成時(\fBc\fR)または更新時(\fBu\fR)に使用できます。 .sp -デフォルトのマニフェスト・ファイルには含まれないマニフェストに、特別な目的の名前\-値の属性ペアを追加できます。たとえば、ベンダー情報、リリース情報、パッケージ・シーリングを指定する属性、またはJARにバンドルされたアプリケーションを実行可能にするための属性を追加できます。\fIm\fRオプションの使用例は、http://docs\&.oracle\&.com/javase/tutorial/deployment/jar/index\&.htmlにある +デフォルトのマニフェスト・ファイルには含まれないマニフェストに、特別な目的の名前\-値の属性ペアを追加できます。たとえば、ベンダー情報、リリース情報、パッケージ・シーリングを指定する属性、またはJARにバンドルされたアプリケーションを実行可能にするための属性を追加できます。\fBm\fRオプションの使用例は、http://docs\&.oracle\&.com/javase/tutorial/deployment/jar/index\&.htmlにある プログラムのパッケージ化に関する項を参照してください。 .RE .PP M .RS 4 -マニフェスト・ファイル・エントリを作成しない(\fIc\fRおよび\fIu\fRの場合)か、またはマニフェスト・ファイル・エントリが存在する場合は削除します(\fIu\fRの場合)。\fIM\fRオプションは、JARファイルの作成時(\fIc\fR)または更新時(\fIu\fR)に使用できます。 +マニフェスト・ファイル・エントリを作成しない(\fBc\fRおよび\fBu\fRの場合)か、またはマニフェスト・ファイル・エントリが存在する場合は削除します(\fBu\fRの場合)。\fBM\fRオプションは、JARファイルの作成時(\fBc\fR)または更新時(\fBu\fR)に使用できます。 .RE .PP n .RS 4 -JARファイルの作成(\fIc\fR)時に、このオプションは、コンテンツがpack200(1)コマンドのパックおよびアンパック操作の影響を受けないようにアーカイブを正規化します。この正規化を使用しない場合、署名付きJARの署名は無効になります。 +JARファイルの作成(\fBc\fR)時に、このオプションは、コンテンツがpack200(1)コマンドのパックおよびアンパック操作の影響を受けないようにアーカイブを正規化します。この正規化を使用しない場合、署名付きJARの署名は無効になります。 .RE .PP v @@ -237,46 +247,48 @@ .PP 0 .RS 4 -(ゼロ) ZIP圧縮を使用しないでJARファイルを作成(\fIc\fR)または更新(\fIu\fR)します。 +(ゼロ) ZIP圧縮を使用しないでJARファイルを作成(\fBc\fR)または更新(\fBu\fR)します。 .RE .PP \-C \fIdir\fR .RS 4 -JARファイルの作成(\fIc\fR)または更新(\fIu\fR)時に、このオプションは\fIfile\fRオペランドで指定されたファイルの処理中にディレクトリを一時的に変更します。この操作は、UNIX -\fItar\fRユーティリティの\fI\-C\fRオプションと同様になることを目的としています。たとえば、次のコマンドによって、\fIclasses\fRディレクトリに変更され、そのディレクトリから\fImy\&.jar\fRに\fIBar\&.class\fRファイルが追加されます。 +JARファイルの作成(\fBc\fR)または更新(\fBu\fR)時に、このオプションは\fIfile\fRオペランドで指定されたファイルの処理中にディレクトリを一時的に変更します。この操作は、\fBtar\fRユーティリティの\fB\-C\fRオプションと同様になることを目的としています。たとえば、次のコマンドによって、\fBclasses\fRディレクトリに変更され、そのディレクトリから\fBmy\&.jar\fRに\fBBar\&.class\fRファイルが追加されます。 .sp .if n \{\ .RS 4 .\} .nf -jar uf my\&.jar \-C classes Bar\&.class +\fBjar uf my\&.jar \-C classes Bar\&.class\fR + .fi .if n \{\ .RE .\} -次のコマンドでは、\fIclasses\fRディレクトリに移動し、classesディレクトリ内のすべてのファイルを\fImy\&.jar\fRに追加します(JARファイルには\fIclasses\fRディレクトリを作成しません)。次に元のディレクトリに戻ってから、\fIbin\fRディレクトリに移動し、\fIXyz\&.class\fRを\fImy\&.jar\fRに追加します。 +次のコマンドでは、\fBclasses\fRディレクトリに移動し、classesディレクトリ内のすべてのファイルを\fBmy\&.jar\fRに追加します(JARファイルには\fBclasses\fRディレクトリを作成しません)。次に元のディレクトリに戻ってから、\fBbin\fRディレクトリに移動し、\fBXyz\&.class\fRを\fBmy\&.jar\fRに追加します。 .sp .if n \{\ .RS 4 .\} .nf -jar uf my\&.jar \-C classes \&. \-C bin Xyz\&.class +\fBjar uf my\&.jar \-C classes \&. \-C bin Xyz\&.class\fR + .fi .if n \{\ .RE .\} -\fIclasses\fRに\fIbar1\fRファイルと\fIbar2\fRファイルが含まれている場合、前述のコマンドを実行した後、JARファイルには次のものが含まれます。 +\fBclasses\fRに\fBbar1\fRファイルと\fBbar2\fRファイルが含まれている場合、前述のコマンドを実行した後、JARファイルには次のものが含まれます。 .sp .if n \{\ .RS 4 .\} .nf -% \fIjar tf my\&.jar\fR -META\-INF/ -META\-INF/MANIFEST\&.MF -bar1 -bar2 -Xyz\&.class +\fB% \fR\fB\fBjar tf my\&.jar\fR\fR +\fBMETA\-INF/\fR +\fBMETA\-INF/MANIFEST\&.MF\fR +\fBbar1\fR +\fBbar2\fR +\fBXyz\&.class\fR + .fi .if n \{\ .RE @@ -285,69 +297,72 @@ .PP \-J\fIoption\fR .RS 4 -指定したJVMオプションを、JREがJARファイルを実行する際に使用するように設定します。JVMオプションは、java(1)コマンドのリファレンス・ページで説明されています。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。 +指定したJVMオプションを、JREがJARファイルを実行する際に使用するように設定します。JVMオプションは、java(1)コマンドのリファレンス・ページで説明されています。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。 .RE .SH "オペランド" .PP -次のオペランドは、\fIjar\fRコマンドで認識されます。 +次のオペランドは、\fBjar\fRコマンドで認識されます。 .PP \fIfile\fR .RS 4 -JARファイルの作成(\fIc\fR)または更新(\fIu\fR)時に、\fIfile\fRオペランドは、アーカイブに追加する必要のあるファイルまたはディレクトリのパスと名前を定義します。JARファイルの抽出(\fIx\fR)またはコンテンツのリスト(\fIt\fR)時に、\fIfile\fRオペランドは抽出またはリストするファイルのパスと名前を定義します。少なくとも1つの有効なファイルまたはディレクトリを指定する必要があります。複数の\fIfile\fRオペランドを空白で区切ります。\fIentrypoint\fR、\fIjarfile\fRまたは\fImanifest\fRオペランドが使用される場合は、その後に\fIfile\fRオペランドを指定する必要があります。 +JARファイルの作成(\fBc\fR)または更新(\fBu\fR)時に、\fIfile\fRオペランドは、アーカイブに追加する必要のあるファイルまたはディレクトリのパスと名前を定義します。JARファイルの抽出(\fBx\fR)またはコンテンツのリスト(\fBt\fR)時に、\fIfile\fRオペランドは抽出またはリストするファイルのパスと名前を定義します。少なくとも1つの有効なファイルまたはディレクトリを指定する必要があります。複数の\fIfile\fRオペランドを空白で区切ります。\fIentrypoint\fR、\fIjarfile\fRまたは\fImanifest\fRオペランドが使用される場合は、その後に\fIfile\fRオペランドを指定する必要があります。 .RE .PP \fIentrypoint\fR .RS 4 -JARファイルの作成(\fIc\fR)または更新(\fIu\fR)時に、\fIentrypoint\fRオペランドは、実行可能JARファイルにバンドルされているスタンドアロンJavaアプリケーションのエントリ・ポイントとなるクラスの名前を定義します。\fIe\fRオプションが存在する場合は\fIentrypoint\fRオペランドを指定する必要があります。 +JARファイルの作成(\fBc\fR)または更新(\fBu\fR)時に、\fIentrypoint\fRオペランドは、実行可能JARファイルにバンドルされているスタンドアロンJavaアプリケーションのエントリ・ポイントとなるクラスの名前を定義します。\fBe\fRオプションが存在する場合は\fIentrypoint\fRオペランドを指定する必要があります。 .RE .PP \fIjarfile\fR .RS 4 -作成(\fIc\fR)、更新(\fIu\fR)、抽出(\fIx\fR)または表示(\fIt\fR)するファイルの名前を定義します。\fIf\fRオプションが存在する場合は\fIjarfile\fRオペランドを指定する必要があります。\fIf\fRオプションおよび\fIjarfile\fRオペランドを省略すると、\fIjar\fRコマンドに、\fIstdin\fRからのJARファイル名を受け入れるか(\fIx\fRおよび\fIt\fRの場合)、JARファイルを\fIstdout\fRに送信すること(\fIc\fRおよび\fIu\fRの場合)が指示されます。 +作成(\fBc\fR)、更新(\fBu\fR)、抽出(\fBx\fR)または表示(\fBt\fR)するファイルの名前を定義します。\fBf\fRオプションが存在する場合は\fIjarfile\fRオペランドを指定する必要があります。\fBf\fRオプションおよび\fIjarfile\fRオペランドを省略すると、\fBjar\fRコマンドに、\fBstdin\fRからのJARファイル名を受け入れるか(\fBx\fRおよび\fBt\fRの場合)、JARファイルを\fBstdout\fRに送信すること(\fBc\fRおよび\fBu\fRの場合)が指示されます。 .sp -JARファイルを索引付け(\fIi\fR)する場合は、\fIf\fRオプションを指定しないで\fIjarfile\fRオペランドを指定します。 +JARファイルを索引付け(\fBi\fR)する場合は、\fBf\fRオプションを指定しないで\fIjarfile\fRオペランドを指定します。 .RE .PP \fImanifest\fR .RS 4 -JARファイルの作成(\fIc\fR)または更新(\fIu\fR)時に、\fImanifest\fRオペランドはJARファイルの\fIMANIFEST\&.MF\fRに含める属性の名前と値を持つ既存のマニフェスト・ファイルを定義します。\fIf\fRオプションが存在する場合は\fImanifest\fRオペランドを指定する必要があります。 +JARファイルの作成(\fBc\fR)または更新(\fBu\fR)時に、\fImanifest\fRオペランドはJARファイルの\fBMANIFEST\&.MF\fRに含める属性の名前と値を持つ既存のマニフェスト・ファイルを定義します。\fBf\fRオプションが存在する場合は\fImanifest\fRオペランドを指定する必要があります。 .RE .PP \fI@arg\-file\fR .RS 4 -\fIjar\fRコマンドを短縮または簡素化するには、別のテキスト・ファイル内の引数を指定し、接頭辞としてアットマーク(@)を付けて\fIjar\fRコマンドに渡すことができます。\fIjar\fRコマンドは、アットマーク文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 +\fBjar\fRコマンドを短縮または簡素化するには、別のテキスト・ファイル内の引数を指定し、接頭辞としてアットマーク(@)を付けて\fBjar\fRコマンドに渡すことができます。\fBjar\fRコマンドは、アットマーク文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 .sp -引数ファイルには、\fIjar\fRコマンドのオプションと引数(引数ファイルをサポートしない起動ツールに渡される\fI\-J\fRオプションを除く)を含めることができます。ファイル内の引数は、空白または改行文字で区切ることができます。引数ファイル内のファイル名は、\fIjar\fRコマンドを実行できる現在のディレクトリに対して相対的であり、引数ファイルの場所に対しては相対的ではありません。通常はオペレーティング・システム・シェルによって展開されるアスタリスク(*)などのワイルドカードは展開されません。 +引数ファイルには、\fBjar\fRコマンドのオプションと引数(引数ファイルをサポートしない起動ツールに渡される\fB\-J\fRオプションを除く)を含めることができます。ファイル内の引数は、空白または改行文字で区切ることができます。引数ファイル内のファイル名は、\fBjar\fRコマンドを実行できる現在のディレクトリに対して相対的であり、引数ファイルの場所に対しては相対的ではありません。通常はオペレーティング・システム・シェルによって展開されるアスタリスク(*)などのワイルドカードは展開されません。 .sp -次の例は、\fIfind\fRコマンドによる現在のディレクトリ出力からのファイル名で\fIclasses\&.list\fRファイルを作成する方法を示します。 +次の例は、\fBfind\fRコマンドによる現在のディレクトリ出力からのファイル名で\fBclasses\&.list\fRファイルを作成する方法を示します。 .sp .if n \{\ .RS 4 .\} .nf -find \&. \-name \*(Aq*\&.class\*(Aq \-print > classes\&.list +\fBfind \&. \-name \*(Aq*\&.class\*(Aq \-print > classes\&.list\fR + .fi .if n \{\ .RE .\} -\fIjar\fRコマンドを実行し、\fI@arg\-file\fR構文を使用して\fIclasses\&.list\fRファイルを渡すことができます。 +\fBjar\fRコマンドを実行し、\fI@arg\-file\fR構文を使用して\fBclasses\&.list\fRファイルを渡すことができます。 .sp .if n \{\ .RS 4 .\} .nf -jar cf my\&.jar @classes\&.list +\fBjar cf my\&.jar @classes\&.list\fR + .fi .if n \{\ .RE .\} -引数ファイルはパスを指定できますが、相対パスが記述された引数ファイル内のすべてのファイル名は、渡されたパスに対して相対的ではなく、\fIjar\fRコマンドの現在の作業ディレクトリに相対的となります。たとえば、次のようになります。 +引数ファイルはパスを指定できますが、相対パスが記述された引数ファイル内のすべてのファイル名は、渡されたパスに対して相対的ではなく、\fBjar\fRコマンドの現在の作業ディレクトリに相対的となります。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -jar @dir/classes\&.list +\fBjar @dir/classes\&.list\fR + .fi .if n \{\ .RE @@ -355,86 +370,95 @@ .RE .SH "注意" .PP -\fIe\fR、\fIf\fRおよび\fIm\fRオプションは、\fIentrypoint\fR、\fIjarfile\fRおよび\fImanifest\fRオペランドと同じ順序でコマンドラインに出現する必要があります。 +\fBe\fR、\fBf\fRおよび\fBm\fRオプションは、\fIentrypoint\fR、\fIjarfile\fRおよび\fImanifest\fRオペランドと同じ順序でコマンド行に出現する必要があります。 .sp .if n \{\ .RS 4 .\} .nf -jar cmef myManifestFile MyMainClass myFile\&.jar *\&.class +\fBjar cmef myManifestFile MyMainClass myFile\&.jar *\&.class\fR + .fi .if n \{\ .RE .\} .SH "例" .PP -\fBExample 1\fR, 冗長な出力による現在のディレクトリからのすべてのファイルの追加 +\fB例 1\fR +.br +冗長な出力による現在のディレクトリからのすべてのファイルの追加 .RS 4 .sp .if n \{\ .RS 4 .\} .nf -% ls -1\&.au Animator\&.class monkey\&.jpg -2\&.au Wave\&.class spacemusic\&.au -3\&.au at_work\&.gif - -% jar cvf bundle\&.jar * -added manifest -adding: 1\&.au(in = 2324) (out= 67)(deflated 97%) -adding: 2\&.au(in = 6970) (out= 90)(deflated 98%) -adding: 3\&.au(in = 11616) (out= 108)(deflated 99%) -adding: Animator\&.class(in = 2266) (out= 66)(deflated 97%) -adding: Wave\&.class(in = 3778) (out= 81)(deflated 97%) -adding: at_work\&.gif(in = 6621) (out= 89)(deflated 98%) -adding: monkey\&.jpg(in = 7667) (out= 91)(deflated 98%) -adding: spacemusic\&.au(in = 3079) (out= 73)(deflated 97%) +\fB% ls\fR +\fB1\&.au Animator\&.class monkey\&.jpg\fR +\fB2\&.au Wave\&.class spacemusic\&.au\fR +\fB3\&.au at_work\&.gif\fR + +\fB% jar cvf bundle\&.jar *\fR +\fBadded manifest\fR +\fBadding: 1\&.au(in = 2324) (out= 67)(deflated 97%)\fR +\fBadding: 2\&.au(in = 6970) (out= 90)(deflated 98%)\fR +\fBadding: 3\&.au(in = 11616) (out= 108)(deflated 99%)\fR +\fBadding: Animator\&.class(in = 2266) (out= 66)(deflated 97%)\fR +\fBadding: Wave\&.class(in = 3778) (out= 81)(deflated 97%)\fR +\fBadding: at_work\&.gif(in = 6621) (out= 89)(deflated 98%)\fR +\fBadding: monkey\&.jpg(in = 7667) (out= 91)(deflated 98%)\fR +\fBadding: spacemusic\&.au(in = 3079) (out= 73)(deflated 97%)\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 2\fR, サブディレクトリからのファイルの追加 +\fB例 2\fR +.br +サブディレクトリからのファイルの追加 .RS 4 .sp .if n \{\ .RS 4 .\} .nf -% ls \-F -audio/ classes/ images/ -% jar cvf bundle\&.jar audio classes images -added manifest -adding: audio/(in = 0) (out= 0)(stored 0%) -adding: audio/1\&.au(in = 2324) (out= 67)(deflated 97%) -adding: audio/2\&.au(in = 6970) (out= 90)(deflated 98%) -adding: audio/3\&.au(in = 11616) (out= 108)(deflated 99%) -adding: audio/spacemusic\&.au(in = 3079) (out= 73)(deflated 97%) -adding: classes/(in = 0) (out= 0)(stored 0%) -adding: classes/Animator\&.class(in = 2266) (out= 66)(deflated 97%) -adding: classes/Wave\&.class(in = 3778) (out= 81)(deflated 97%) -adding: images/(in = 0) (out= 0)(stored 0%) -adding: images/monkey\&.jpg(in = 7667) (out= 91)(deflated 98%) -adding: images/at_work\&.gif(in = 6621) (out= 89)(deflated 98%) - -% ls \-F -audio/ bundle\&.jar classes/ images/ +\fB% ls \-F\fR +\fBaudio/ classes/ images/\fR +\fB% jar cvf bundle\&.jar audio classes images\fR +\fBadded manifest\fR +\fBadding: audio/(in = 0) (out= 0)(stored 0%)\fR +\fBadding: audio/1\&.au(in = 2324) (out= 67)(deflated 97%)\fR +\fBadding: audio/2\&.au(in = 6970) (out= 90)(deflated 98%)\fR +\fBadding: audio/3\&.au(in = 11616) (out= 108)(deflated 99%)\fR +\fBadding: audio/spacemusic\&.au(in = 3079) (out= 73)(deflated 97%)\fR +\fBadding: classes/(in = 0) (out= 0)(stored 0%)\fR +\fBadding: classes/Animator\&.class(in = 2266) (out= 66)(deflated 97%)\fR +\fBadding: classes/Wave\&.class(in = 3778) (out= 81)(deflated 97%)\fR +\fBadding: images/(in = 0) (out= 0)(stored 0%)\fR +\fBadding: images/monkey\&.jpg(in = 7667) (out= 91)(deflated 98%)\fR +\fBadding: images/at_work\&.gif(in = 6621) (out= 89)(deflated 98%)\fR + +\fB% ls \-F\fR +\fBaudio/ bundle\&.jar classes/ images/\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, JARのコンテンツのリスト +\fB例 3\fR +.br +JARのコンテンツのリスト .RS 4 .sp .if n \{\ .RS 4 .\} .nf -% jar tf bundle\&.jar +\fB% jar tf bundle\&.jar\fR .fi .if n \{\ .RE @@ -444,45 +468,50 @@ .RS 4 .\} .nf -META\-INF/ -META\-INF/MANIFEST\&.MF -audio/1\&.au -audio/2\&.au -audio/3\&.au -audio/spacemusic\&.au -classes/Animator\&.class -classes/Wave\&.class -images/monkey\&.jpg -images/at_work\&.gif +\fBMETA\-INF/\fR +\fBMETA\-INF/MANIFEST\&.MF\fR +\fBaudio/1\&.au\fR +\fBaudio/2\&.au\fR +\fBaudio/3\&.au\fR +\fBaudio/spacemusic\&.au\fR +\fBclasses/Animator\&.class\fR +\fBclasses/Wave\&.class\fR +\fBimages/monkey\&.jpg\fR +\fBimages/at_work\&.gif\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 4\fR, 索引の追加 +\fB例 4\fR +.br +索引の追加 .RS 4 -株式取引のアプリケーションの相互依存クラスを、\fImain\&.jar\fR、\fIbuy\&.jar\fRおよび\fIsell\&.jar\fRの3つのJARファイルに分割する場合、\fIi\fRオプションを使用します。\fImain\&.jar\fRマニフェスト内の\fIClass\-Path\fR属性を指定する場合、\fIi\fRオプションを使用して、アプリケーションのクラス・ロードの速度を向上できます。 +株式取引のアプリケーションの相互依存クラスを、\fBmain\&.jar\fR、\fBbuy\&.jar\fRおよび\fBsell\&.jar\fRの3つのJARファイルに分割する場合、\fBi\fRオプションを使用します。\fBmain\&.jar\fRマニフェスト内の\fBClass\-Path\fR属性を指定する場合、\fBi\fRオプションを使用して、アプリケーションのクラス・ロードの速度を向上できます。 .sp .if n \{\ .RS 4 .\} .nf -Class\-Path: buy\&.jar sell\&.jar -jar i main\&.jar +\fBClass\-Path: buy\&.jar sell\&.jar\fR +\fBjar i main\&.jar\fR + .fi .if n \{\ .RE .\} -\fIINDEX\&.LIST\fRファイルが\fIMETA\-INF\fRディレクトリに挿入されます。これにより、アプリケーションのクラス・ローダーによってクラスまたはリソースの検索が行われるときに、指定したJARファイルがダウンロードされるようになります。 +\fBINDEX\&.LIST\fRファイルが\fBMETA\-INF\fRディレクトリに挿入されます。これにより、アプリケーションのクラス・ローダーによってクラスまたはリソースの検索が行われるときに、指定したJARファイルがダウンロードされるようになります。 .sp -アプリケーションのクラス・ローダーは、このファイルに格納されている情報を使用して、効率的にクラスをロードします。ディレクトリをコピーするには、最初に\fIdir1\fR内のファイルを\fIstdout\fRに圧縮してから、\fIstdin\fRから\fIdir2\fRにパイプラインを作成して抽出します(\fI\-f\fRオプションは両方の\fIjar\fRコマンドで省略します)。 +アプリケーションのクラス・ローダーは、このファイルに格納されている情報を使用して、効率的にクラスをロードします。ディレクトリをコピーするには、最初に\fBdir1\fR内のファイルを\fBstdout\fRに圧縮してから、\fBstdin\fRから\fBdir2\fRにパイプラインを作成して抽出します(\fB\-f\fRオプションは両方の\fBjar\fRコマンドで省略します)。 .sp .if n \{\ .RS 4 .\} .nf -(cd dir1; jar c \&.) | (cd dir2; jar x) +\fB(cd dir1; jar c \&.) | (cd dir2; jar x)\fR + .fi .if n \{\ .RE
--- a/src/solaris/doc/sun/man/man1/ja/jarsigner.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jarsigner.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jarsigner -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: セキュリティ・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jarsigner +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: セキュリティ・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jarsigner" "1" "2013年11月21日" "JDK 8" "セキュリティ・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jarsigner \- Javaアーカイブ(JAR)ファイルに対して署名および検証を行います。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjarsigner\fR [ \fIoptions\fR ] \fIjar\-file\fR \fIalias\fR +\fBjarsigner\fR [ \fIoptions\fR ] \fIjar\-file\fR \fIalias\fR .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjarsigner\fR \fI\-verify\fR [ \fIoptions\fR ] \fIjar\-file\fR [\fIalias \&.\&.\&.\fR] +\fBjarsigner\fR \fB\-verify\fR [ \fIoptions\fR ] \fIjar\-file\fR [\fIalias \&.\&.\&.\fR] .fi .if n \{\ .RE @@ -74,30 +76,30 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \-verify .RS 4 -\fI\-verify\fRオプションでは、JARファイル名の後に0個以上のキーストア別名を指定できます。\fI\-verify\fRオプションが指定された場合、\fIjarsigner\fRコマンドでは、JARファイル内の各署名付きエンティティの検証に使用される証明書が、いずれかのキーストア別名に一致することをチェックします。別名は、\fI\-keystore\fRで指定されたキーストア内またはデフォルトのキーストア内に定義されます。 +\fB\-verify\fRオプションでは、JARファイル名の後に0個以上のキーストア別名を指定できます。\fB\-verify\fRオプションが指定された場合、\fBjarsigner\fRコマンドでは、JARファイル内の各署名付きエンティティの検証に使用される証明書が、いずれかのキーストア別名に一致することをチェックします。別名は、\fB\-keystore\fRで指定されたキーストア内またはデフォルトのキーストア内に定義されます。 .sp -\fI\-strict\fRオプションも指定した場合、\fIjarsigner\fRコマンドにより重大な警告が検出されると、メッセージ「jarが検証されました。署名者エラー」が表示されます。 +\fB\-strict\fRオプションも指定した場合、\fBjarsigner\fRコマンドにより重大な警告が検出されると、メッセージ「jarが検証されました。署名者エラー」が表示されます。 .RE .PP \fIjar\-file\fR .RS 4 署名されるJARファイル。 .sp -\fI\-strict\fRオプションも指定した場合、\fIjarsigner\fRコマンドにより重大な警告が検出されると、メッセージ「jarは署名されました \- 署名者エラーがあります。」というメッセージが表示されます。 +\fB\-strict\fRオプションも指定した場合、\fBjarsigner\fRコマンドにより重大な警告が検出されると、メッセージ「jarは署名されました \- 署名者エラーがあります。」というメッセージが表示されます。 .RE .PP \fIalias\fR .RS 4 -別名は、\fI\-keystore\fRで指定されたキーストア内またはデフォルトのキーストア内に定義されます。 +別名は、\fB\-keystore\fRで指定されたキーストア内またはデフォルトのキーストア内に定義されます。 .RE .SH "説明" .PP -\fIjarsigner\fRツールには、次の2つの目的があります。 +\fBjarsigner\fRツールには、次の2つの目的があります。 .sp .RS 4 .ie n \{\ @@ -121,7 +123,7 @@ 署名付きJARファイルの署名と整合性を検証する目的。 .RE .PP -JAR機能を使用すると、クラス・ファイル、イメージ、サウンドおよびその他のデジタル・データを単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。\fIjar\fRという名前のツールを使用して、開発者はJARファイルを作成できます。(技術的な観点から言えば、すべてのZIPファイルもJARファイルとみなすことができます。ただし、\fIjar\fRコマンドによって作成されたJARファイル、または\fIjarsigner\fRコマンドによって処理されたJARファイルには、\fIMETA\-INF/MANIFEST\&.MF\fRファイルも含まれています。) +JAR機能を使用すると、クラス・ファイル、イメージ、サウンドおよびその他のデジタル・データを単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。\fBjar\fRという名前のツールを使用して、開発者はJARファイルを作成できます。(技術的な観点から言えば、すべてのZIPファイルもJARファイルとみなすことができます。ただし、\fBjar\fRコマンドによって作成されたJARファイル、または\fBjarsigner\fRコマンドによって処理されたJARファイルには、\fBMETA\-INF/MANIFEST\&.MF\fRファイルも含まれています。) .PP デジタル署名は、なんらかのデータ(署名の対象となるデータ)、およびエンティティ(人、会社など)の秘密鍵から計算されるビットの文字列です。手書きの署名同様、デジタル署名には多くの利点があります。 .sp @@ -171,97 +173,101 @@ .PP ファイルに対してエンティティの署名を生成するには、まず、エンティティは、そのエンティティに関連する公開鍵/秘密鍵のペアと、公開鍵を認証する1つ以上の証明書を持つ必要があります。証明書とは、あるエンティティからのデジタル署名付きの文書で、別のエンティティの公開鍵が特定の値を持つことを示しています。 .PP -\fIjarsigner\fRコマンドは、キーストアからの鍵と証明書情報を使用して、JARファイルのデジタル署名を生成します。キーストアは、秘密鍵、および対応する公開鍵を認証する、秘密鍵に関連したX\&.509証明書チェーンのデータベースです。\fIkeytool\fRコマンドを使用して、キーストアを作成および管理します。 +\fBjarsigner\fRコマンドは、キーストアからの鍵と証明書情報を使用して、JARファイルのデジタル署名を生成します。キーストアは、秘密鍵、および対応する公開鍵を認証する、秘密鍵に関連したX\&.509証明書チェーンのデータベースです。\fBkeytool\fRコマンドを使用して、キーストアを作成および管理します。 .PP -\fIjarsigner\fRコマンドでは、エンティティの秘密鍵を使用して署名を生成します。署名付きJARファイルには、特に、ファイルへの署名に使用する秘密鍵に対応する公開鍵のキーストアからの証明書のコピーが含まれます。\fIjarsigner\fRコマンドでは、内部(署名ブロック・ファイル内)の証明書を使用して、署名付きJARファイルのデジタル署名を検証できます。 +\fBjarsigner\fRコマンドでは、エンティティの秘密鍵を使用して署名を生成します。署名付きJARファイルには、特に、ファイルへの署名に使用する秘密鍵に対応する公開鍵のキーストアからの証明書のコピーが含まれます。\fBjarsigner\fRコマンドでは、内部(署名ブロック・ファイル内)の証明書を使用して、署名付きJARファイルのデジタル署名を検証できます。 .PP -\fIjarsigner\fRコマンドでは、署名証明書の有効期間中にJARファイルが署名されたされたかどうかをシステムやデプロイヤ(Java Plug\-inを含む)がチェックできる、タイムスタンプを含む署名を生成できます。さらに、APIを使用すると、アプリケーションでタイムスタンプ情報を取得できます。 +\fBjarsigner\fRコマンドでは、署名証明書の有効期間中にJARファイルが署名されたされたかどうかをシステムやデプロイヤ(Java Plug\-inを含む)がチェックできる、タイムスタンプを含む署名を生成できます。さらに、APIを使用すると、アプリケーションでタイムスタンプ情報を取得できます。 .PP -現時点では、\fIjarsigner\fRコマンドでは、\fIjar\fRコマンドまたはZIPファイルによって作成されたJARファイルのみに署名できます。JARファイルはZIPファイルと同じですが、JARファイルには\fIMETA\-INF/MANIFEST\&.MF\fRファイルも含まれている点が異なります。\fIMETA\-INF/MANIFEST\&.MF\fRファイルは、\fIjarsigner\fRコマンドによってZIPファイルに署名する際に作成されます。 +現時点では、\fBjarsigner\fRコマンドでは、\fBjar\fRコマンドまたはZIPファイルによって作成されたJARファイルのみに署名できます。JARファイルはZIPファイルと同じですが、JARファイルには\fBMETA\-INF/MANIFEST\&.MF\fRファイルも含まれている点が異なります。\fBMETA\-INF/MANIFEST\&.MF\fRファイルは、\fBjarsigner\fRコマンドによってZIPファイルに署名する際に作成されます。 .PP -デフォルトの\fIjarsigner\fRコマンドの動作では、JARまたはZIPファイルに署名します。\fI\-verify\fRオプションを使用して、署名付きJARファイルを検証します。 +デフォルトの\fBjarsigner\fRコマンドの動作では、JARまたはZIPファイルに署名します。\fB\-verify\fRオプションを使用して、署名付きJARファイルを検証します。 .PP -\fIjarsigner\fRコマンドは、署名または検証の後に署名者の証明書の検証も試行します。検証エラーまたはその他の問題が発生すると、コマンドにより警告メッセージが生成されます。\fI\-strict\fRオプションを指定した場合、コマンドにより重大な警告がエラーとして処理されます。エラーと警告を参照してください。 +\fBjarsigner\fRコマンドは、署名または検証の後に署名者の証明書の検証も試行します。検証エラーまたはその他の問題が発生すると、コマンドにより警告メッセージが生成されます。\fB\-strict\fRオプションを指定した場合、コマンドにより重大な警告がエラーとして処理されます。エラーと警告を参照してください。 .SS "キーストアの別名" .PP キーストアのすべてのエンティティは、一意の別名を使用してアクセスされます。 .PP -\fIjarsigner\fRコマンドを使用してJARファイルに署名するときは、署名の生成に必要な秘密鍵を含むキーストア・エントリの別名を指定する必要があります。たとえば、次のコマンドでは、\fIworking\fRディレクトリの\fImystore\fRという名前のキーストアに含まれる別名\fIduke\fRに関連付けられた秘密鍵を使用して、\fIMyJARFile\&.jar\fRという名前のJARファイルに署名します。出力ファイルは指定されていないため、\fIMyJARFile\&.jar\fRは署名付きのJARファイルによって上書きされます。 +\fBjarsigner\fRコマンドを使用してJARファイルに署名するときは、署名の生成に必要な秘密鍵を含むキーストア・エントリの別名を指定する必要があります。たとえば、次のコマンドでは、\fBworking\fRディレクトリの\fBmystore\fRという名前のキーストアに含まれる別名\fBduke\fRに関連付けられた秘密鍵を使用して、\fBMyJARFile\&.jar\fRという名前のJARファイルに署名します。出力ファイルは指定されていないため、\fBMyJARFile\&.jar\fRは署名付きのJARファイルによって上書きされます。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-keystore /working/mystore \-storepass <keystore password> - \-keypass <private key password> MyJARFile\&.jar duke +\fBjarsigner \-keystore /working/mystore \-storepass <keystore password>\fR +\fB \-keypass <private key password> MyJARFile\&.jar duke\fR + .fi .if n \{\ .RE .\} .PP -キーストアはパスワードで保護されているので、ストアのパスワードを指定する必要があります。コマンドラインで指定しないと、入力を求められます。同様に、秘密鍵もキーストア内でパスワードによって保護されているため、秘密鍵のパスワードを指定する必要があります。コマンドラインでパスワードを指定していない場合、または指定したパスワートが保存されているパスワードと同じではない場合は、パスワードの入力を求められます。 +キーストアはパスワードで保護されているので、ストアのパスワードを指定する必要があります。コマンド行で指定しないと、入力を求められます。同様に、秘密鍵もキーストア内でパスワードによって保護されているため、秘密鍵のパスワードを指定する必要があります。コマンド行でパスワードを指定していない場合、または指定したパスワートが保存されているパスワードと同じではない場合は、パスワードの入力を求められます。 .SS "キーストアの場所" .PP -\fIjarsigner\fRコマンドには、使用するキーストアのURLを指定する\fI\-keystore\fRオプションがあります。キーストアはデフォルトで、\fIuser\&.home\fRシステム・プロパティで決まるユーザーのホーム・ディレクトリの\fI\&.keystore\fRという名前のファイル内に格納されます。 +\fBjarsigner\fRコマンドには、使用するキーストアのURLを指定する\fB\-keystore\fRオプションがあります。キーストアはデフォルトで、\fBuser\&.home\fRシステム・プロパティで決まるユーザーのホーム・ディレクトリの\fB\&.keystore\fRという名前のファイル内に格納されます。 .PP -Oracle Solarisシステムの場合、\fIuser\&.home\fRは、ユーザーのホーム・ディレクトリにデフォルト設定されます。 +Oracle Solarisシステムの場合、\fBuser\&.home\fRは、ユーザーのホーム・ディレクトリにデフォルト設定されます。 .PP -\fI\-keystore\fRオプションからの入力ストリームは、\fIKeyStore\&.load\fRメソッドに渡されます。URLとして\fINONE\fRが指定されている場合は、nullのストリームが\fIKeyStore\&.load\fRメソッドに渡されます。\fINONE\fRは、\fIKeyStore\fRクラスがファイルベースではない場合、たとえば、ハードウェア・トークン・デバイスに置かれている場合に指定します。 +\fB\-keystore\fRオプションからの入力ストリームは、\fBKeyStore\&.load\fRメソッドに渡されます。URLとして\fBNONE\fRが指定されている場合は、nullのストリームが\fBKeyStore\&.load\fRメソッドに渡されます。\fBNONE\fRは、\fBKeyStore\fRクラスがファイルベースではない場合、たとえば、ハードウェア・トークン・デバイスに置かれている場合に指定します。 .SS "キーストアの実装" .PP -\fIjava\&.security package\fRで提供されている\fIKeyStore\fRクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義された多くのインタフェースを提供します。複数の異なる固定実装を指定することができ、各実装は特定のタイプのキーストアを対象とします。 +\fBjava\&.security package\fRで提供されている\fBKeyStore\fRクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義された多くのインタフェースを提供します。複数の異なる固定実装を指定することができ、各実装は特定のタイプのキーストアを対象とします。 .PP -現在、キーストアの実装を使用する2つのコマンドライン・ツール(\fIkeytool\fRと\fIjarsigner\fR)、およびポリシー・ツールという名前の1つのGUIベースのツールがあります。\fIKeyStore\fRクラスは公開されているため、JDKユーザーは、それを使用する他のセキュリティ・アプリケーションを書き込むことができます。 +現在、キーストアの実装を使用する2つのコマンド行ツール(\fBkeytool\fRと\fBjarsigner\fR)、およびポリシー・ツールという名前の1つのGUIベースのツールがあります。\fBKeyStore\fRクラスは公開されているため、JDKユーザーは、それを使用する他のセキュリティ・アプリケーションを書き込むことができます。 .PP Oracleが提供する組込みのデフォルトの実装があります。これは、JKSという名前の独自のキーストア・タイプ(形式)を使用するもので、キーストアをファイルとして実装しています。組込みの実装では、各秘密鍵は個別のパスワードによって保護され、キーストア全体の整合性は(秘密鍵とは別の)パスワードによって保護されます。 .PP -キーストアの実装はプロバイダベースで、つまり、\fIKeyStore\fRクラスにより提供されるアプリケーション・インタフェースは、サービス・プロバイダ・インタフェース(SPI)に関して実装されます。対応する\fIKeystoreSpi\fR抽象クラスがあり、これも\fIjava\&.security package\fRに含まれています。このクラスが、プロバイダが実装する必要のあるサービス・プロバイダ・インタフェースのメソッドを定義しています。ここで、プロバイダとは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。キーストアの実装を提供するには、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/HowToImplAProvider\&.htmlにある -Java暗号化アーキテクチャのプロバイダの実装方法で説明しているように、クライアントはプロバイダを実装し、\fIKeystoreSpi\fRサブクラスの実装を提供する必要があります。 +キーストアの実装はプロバイダベースで、つまり、\fBKeyStore\fRクラスにより提供されるアプリケーション・インタフェースは、サービス・プロバイダ・インタフェース(SPI)に関して実装されます。対応する\fBKeystoreSpi\fR抽象クラスがあり、これも\fBjava\&.security package\fRに含まれています。このクラスが、プロバイダが実装する必要のあるサービス・プロバイダ・インタフェースのメソッドを定義しています。ここで、プロバイダとは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。キーストアの実装を提供するには、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/HowToImplAProvider\&.htmlにある +Java暗号化アーキテクチャのプロバイダの実装方法で説明しているように、クライアントはプロバイダを実装し、\fBKeystoreSpi\fRサブクラスの実装を提供する必要があります。 .PP -アプリケーションでは、\fIKeyStore\fRクラスの\fIgetInstance\fRファクトリ・メソッドを使用して、様々なプロバイダから異なるタイプのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の秘密鍵とキーストア自体の整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 +アプリケーションでは、\fBKeyStore\fRクラスの\fBgetInstance\fRファクトリ・メソッドを使用して、様々なプロバイダから異なるタイプのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の秘密鍵とキーストア自体の整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 .PP -\fIjarsigner\fRおよび\fIpolicytool\fRコマンドは、URLを使用して指定できる任意の場所からファイルベースのキーストアを読み取ることができます。また、これらのコマンドは、Windows上のMSCAPIおよびすべてのプラットフォーム上のPKCS11で提供されるような非ファイルベースのキーストアを読み取ることができます。 +\fBjarsigner\fRおよび\fBpolicytool\fRコマンドは、URLを使用して指定できる任意の場所からファイルベースのキーストアを読み取ることができます。また、これらのコマンドは、Windows上のMSCAPIおよびすべてのプラットフォーム上のPKCS11で提供されるような非ファイルベースのキーストアを読み取ることができます。 .PP -\fIjarsigner\fRコマンドおよび\fIkeytool\fRコマンドの場合、\fI\-storetype\fRオプションを使用して、コマンドラインでキーストアのタイプを指定できます。ポリシー・ツールの場合、\fB「キーストア」\fRメニューの\fB「編集」\fRコマンドを使用して、キーストアのタイプを指定できます。 +\fBjarsigner\fRコマンドおよび\fBkeytool\fRコマンドの場合、\fB\-storetype\fRオプションを使用して、コマンド行でキーストアのタイプを指定できます。ポリシー・ツールの場合、\fB「キーストア」\fRメニューの\fB「編集」\fRコマンドを使用して、キーストアのタイプを指定できます。 .PP -ユーザーがキーストアのタイプを明示的に指定しなかった場合、セキュリティ・プロパティ・ファイルで指定された\fIkeystore\&.type\fRプロパティの値に基づいて、ツールによってキーストアの実装が選択されます。このセキュリティ・プロパティ・ファイルは\fIjava\&.security\fRと呼ばれ、JDKセキュリティ・プロパティ・ディレクトリ\fIjava\&.home/lib/security\fR内に存在しています。ここで、\fIjava\&.home\fRは実行時環境のディレクトリです。\fIjre\fRディレクトリは、JDKまたはJava Runtime Environment (JRE)の最上位のディレクトリにあります。 +ユーザーがキーストアのタイプを明示的に指定しなかった場合、セキュリティ・プロパティ・ファイルで指定された\fBkeystore\&.type\fRプロパティの値に基づいて、ツールによってキーストアの実装が選択されます。このセキュリティ・プロパティ・ファイルは\fBjava\&.security\fRと呼ばれ、JDKセキュリティ・プロパティ・ディレクトリ\fBjava\&.home/lib/security\fR内に存在しています。ここで、\fBjava\&.home\fRは実行時環境のディレクトリです。\fBjre\fRディレクトリは、JDKまたはJava Runtime Environment (JRE)の最上位のディレクトリにあります。 .PP -各ツールは、\fIkeystore\&.type\fRの値を取得し、そのタイプのキーストアを実装しているプロバイダが見つかるまで、インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使用します。 +各ツールは、\fBkeystore\&.type\fRの値を取得し、そのタイプのキーストアを実装しているプロバイダが見つかるまで、インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使用します。 .PP -\fIKeyStore\fRクラスに定義されているstaticメソッド\fIgetDefaultType\fRを使用すると、アプリケーションやアプレットから\fIkeystore\&.type\fRプロパティの値を取得できます。次のコードの行では、\fIkeystore\&.type property\fRで指定された、デフォルトのキーストア・タイプのインスタンスを作成します。 +\fBKeyStore\fRクラスに定義されているstaticメソッド\fBgetDefaultType\fRを使用すると、アプリケーションやアプレットから\fBkeystore\&.type\fRプロパティの値を取得できます。次のコードの行では、\fBkeystore\&.type property\fRで指定された、デフォルトのキーストア・タイプのインスタンスを作成します。 .sp .if n \{\ .RS 4 .\} .nf -KeyStore keyStore = KeyStore\&.getInstance(KeyStore\&.getDefaultType()); +\fBKeyStore keyStore = KeyStore\&.getInstance(KeyStore\&.getDefaultType());\fR + .fi .if n \{\ .RE .\} .PP -デフォルトのキーストア・タイプは、\fIjks\fR +デフォルトのキーストア・タイプは、\fBjks\fR (Oracleが提供する独自のタイプのキーストアの実装)です。これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。 .sp .if n \{\ .RS 4 .\} .nf -keystore\&.type=jks +\fBkeystore\&.type=jks\fR + .fi .if n \{\ .RE .\} .PP -キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、\fIJKS\fRは\fIjks\fRと同じになります。 +キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、\fBJKS\fRは\fBjks\fRと同じになります。 .PP -ツールでデフォルト以外のキーストアの実装を使用するには、その行を変更して別のキーストアのタイプを指定します。たとえば、\fIpkcs12\fRと呼ばれるキーストアのタイプのキーストアの実装を提供するプロバイダ・パッケージがある場合、行を次のように変更します。 +ツールでデフォルト以外のキーストアの実装を使用するには、その行を変更して別のキーストアのタイプを指定します。たとえば、\fBpkcs12\fRと呼ばれるキーストアのタイプのキーストアの実装を提供するプロバイダ・パッケージがある場合、行を次のように変更します。 .sp .if n \{\ .RS 4 .\} .nf -keystore\&.type=pkcs12 +\fBkeystore\&.type=pkcs12\fR + .fi .if n \{\ .RE @@ -272,7 +278,7 @@ Java PKCS #11リファレンス・ガイドの「KeyTool」および「JarSigner」を参照してください。 .SS "サポートされるアルゴリズム" .PP -デフォルトで、\fIjarsigner\fRコマンドでは次のいずれかのアルゴリズムを使用してJARファイルに署名します。 +デフォルトで、\fBjarsigner\fRコマンドでは次のいずれかのアルゴリズムを使用してJARファイルに署名します。 .sp .RS 4 .ie n \{\ @@ -307,12 +313,12 @@ SHA256と楕円曲線デジタル署名アルゴリズム(ECDSA)を使用した楕円曲線(EC)暗号方式アルゴリズム .RE .PP -署名者の公開鍵と秘密鍵がDSA鍵である場合、\fIjarsigner\fRは\fISHA1withDSA\fRアルゴリズムを使用してJARファイルに署名します。署名者の鍵がRSA鍵である場合、\fIjarsigner\fRは\fISHA256withRSA\fRアルゴリズムを使用してJARファイルに署名しようとします。署名者の鍵がEC鍵である場合、\fIjarsigner\fRは\fISHA256withECDSA\fRアルゴリズムを使用してJARファイルに署名します。 +署名者の公開鍵と秘密鍵がDSA鍵である場合、\fBjarsigner\fRは\fBSHA1withDSA\fRアルゴリズムを使用してJARファイルに署名します。署名者の鍵がRSA鍵である場合、\fBjarsigner\fRは\fBSHA256withRSA\fRアルゴリズムを使用してJARファイルに署名しようとします。署名者の鍵がEC鍵である場合、\fBjarsigner\fRは\fBSHA256withECDSA\fRアルゴリズムを使用してJARファイルに署名します。 .PP -これらのデフォルトの署名アルゴリズムは、\fI\-sigalg\fRオプションを使用してオーバーライドできます。 +これらのデフォルトの署名アルゴリズムは、\fB\-sigalg\fRオプションを使用してオーバーライドできます。 .SS "署名付きJARファイル" .PP -\fIjarsigner\fRコマンドを使用してJARファイルに署名する場合、出力される署名付きJARファイルは入力JARファイルと同じですが、次の2つの追加ファイルがMETA\-INFディレクトリに置かれる点が異なります。 +\fBjarsigner\fRコマンドを使用してJARファイルに署名する場合、出力される署名付きJARファイルは入力JARファイルと同じですが、次の2つの追加ファイルがMETA\-INFディレクトリに置かれる点が異なります。 .sp .RS 4 .ie n \{\ @@ -322,7 +328,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\&.SF\fR拡張子の付いた署名ファイル +\fB\&.SF\fR拡張子の付いた署名ファイル .RE .sp .RS 4 @@ -333,14 +339,16 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\&.DSA\fR、\fI\&.RSA\fRまたは\fI\&.EC\fR拡張子の付いた署名ブロック・ファイル +\fB\&.DSA\fR、\fB\&.RSA\fRまたは\fB\&.EC\fR拡張子の付いた署名ブロック・ファイル .RE .PP -これら2つのファイルのベース・ファイル名は、\fI\-sigFile\fRオプションの値から作成されます。たとえば、オプションが\fI\-sigFile MKSIGN\fRの場合、ファイルは\fIMKSIGN\&.SF\fRおよび\fIMKSIGN\&.DSA\fRという名前になります。 +これら2つのファイルのベース・ファイル名は、\fB\-sigFile\fRオプションの値から作成されます。たとえば、オプションが\fB\-sigFile MKSIGN\fRの場合、ファイルは\fBMKSIGN\&.SF\fRおよび\fBMKSIGN\&.DSA\fRという名前になります。 +.PP +コマンド行で\fB\-sigfile\fRオプションを指定しなかった場合、\fB\&.SF\fRファイルと\fB\&.DSA\fRファイルのベース・ファイル名は、コマンド行で指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名に、署名ファイル名で使用できない文字が含まれている場合、ファイル名の作成時に、該当する文字が下線(_)文字に変換されます。有効な文字は、アルファベット、数字、下線およびハイフンです。 .PP -コマンドラインで\fI\-sigfile\fRオプションを指定しなかった場合、\fI\&.SF\fRファイルと\fI\&.DSA\fRファイルのベース・ファイル名は、コマンドラインで指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名に、署名ファイル名で使用できない文字が含まれている場合、ファイル名の作成時に、該当する文字が下線(_)文字に変換されます。有効な文字は、アルファベット、数字、下線およびハイフンです。 -署名ファイル.PP -署名ファイル(\fI\&.SF\fRファイル)は、\fIjarsigner\fRコマンドを使用してファイルに署名する際にJARファイルに常に含まれるマニフェスト・ファイルと似ています。JARファイルに含まれているソース・ファイルごとに、\fI\&.SF\fRファイルには、マニフェスト・ファイルにあるような、次に示す3つの行があります。 +署名ファイル +.PP +署名ファイル(\fB\&.SF\fRファイル)は、\fBjarsigner\fRコマンドを使用してファイルに署名する際にJARファイルに常に含まれるマニフェスト・ファイルと似ています。JARファイルに含まれているソース・ファイルごとに、\fB\&.SF\fRファイルには、マニフェスト・ファイルにあるような、次に示す3つの行があります。 .sp .RS 4 .ie n \{\ @@ -375,24 +383,27 @@ SHAダイジェストの値 .RE .PP -マニフェスト・ファイルでは、各ソース・ファイルのSHAダイジェストの値は、ソース・ファイルのバイナリ・データのダイジェスト(ハッシュ)になります。\fI\&.SF\fRファイルでは、指定されたソース・ファイルのダイジェストの値は、ソース・ファイルのマニフェスト・ファイル内のその3行のハッシュになります。 +マニフェスト・ファイルでは、各ソース・ファイルのSHAダイジェストの値は、ソース・ファイルのバイナリ・データのダイジェスト(ハッシュ)になります。\fB\&.SF\fRファイルでは、指定されたソース・ファイルのダイジェストの値は、ソース・ファイルのマニフェスト・ファイル内のその3行のハッシュになります。 .PP 署名ファイルには、デフォルトで、マニフェスト・ファイル全体のハッシュが格納されたヘッダーが含まれています。ヘッダーにはマニフェスト・ヘッダーのハッシュも含まれています。ヘッダーが存在すると、検証の最適化が有効になります。JARファイルの検証を参照してください。 -署名ブロック・ファイル.PP -\fI\&.SF\fRファイルには署名が付けられ、署名は署名ブロック・ファイルに置かれます。このファイルには、署名に使用された秘密鍵に対応する公開鍵を認証するキーストアからの証明書または証明書チェーンも、内部でエンコードされて含まれています。ファイルの拡張子は、使用されるダイジェスト・アルゴリズムに応じて、\fI\&.DSA\fR、\fI\&.RSA\fRまたは\fI\&.EC\fRになります。 +.PP +署名ブロック・ファイル +.PP +\fB\&.SF\fRファイルには署名が付けられ、署名は署名ブロック・ファイルに置かれます。このファイルには、署名に使用された秘密鍵に対応する公開鍵を認証するキーストアからの証明書または証明書チェーンも、内部でエンコードされて含まれています。ファイルの拡張子は、使用されるダイジェスト・アルゴリズムに応じて、\fB\&.DSA\fR、\fB\&.RSA\fRまたは\fB\&.EC\fRになります。 .SS "署名タイムスタンプ" .PP -\fIjarsigner\fRコマンドでは、JARファイルの署名時に署名タイムスタンプを生成および保存できます。さらに、\fIjarsigner\fRは代替署名機構をサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。オプションを参照してください。 +\fBjarsigner\fRコマンドでは、JARファイルの署名時に署名タイムスタンプを生成および保存できます。さらに、\fBjarsigner\fRは代替署名機構をサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。オプションを参照してください。 .sp .if n \{\ .RS 4 .\} .nf -\-tsa \fIurl\fR -\-tsacert \fIalias\fR -\-altsigner \fIclass\fR -\-altsignerpath \fIclasspathlist\fR -\-tsapolicyid \fIpolicyid\fR +\fB\-tsa \fR\fB\fIurl\fR\fR +\fB\-tsacert \fR\fB\fIalias\fR\fR +\fB\-altsigner \fR\fB\fIclass\fR\fR +\fB\-altsignerpath \fR\fB\fIclasspathlist\fR\fR +\fB\-tsapolicyid \fR\fB\fIpolicyid\fR\fR + .fi .if n \{\ .RE @@ -409,9 +420,9 @@ .sp -1 .IP " 1." 4.2 .\} -\fI\&.SF\fRファイルの署名を検証します。 +\fB\&.SF\fRファイルの署名を検証します。 .sp -検証では、各署名ブロック(\fI\&.DSA\fR)ファイルに格納された署名が、証明書(または証明書チェーン)も\fI\&.DSA\fRファイルに示される公開鍵に対応する秘密鍵を使用して生成されたことを確認します。また、署名が対応する署名(\fI\&.SF\fR)ファイルの有効な署名であることが確認され、それにより、\fI\&.SF\fRファイルが改ざんされていないことも確認されます。 +検証では、各署名ブロック(\fB\&.DSA\fR)ファイルに格納された署名が、証明書(または証明書チェーン)も\fB\&.DSA\fRファイルに示される公開鍵に対応する秘密鍵を使用して生成されたことを確認します。また、署名が対応する署名(\fB\&.SF\fR)ファイルの有効な署名であることが確認され、それにより、\fB\&.SF\fRファイルが改ざんされていないことも確認されます。 .RE .sp .RS 4 @@ -422,13 +433,13 @@ .sp -1 .IP " 2." 4.2 .\} -\fI\&.SF\fRファイル内の各エントリに示されるダイジェストを、マニフェスト内の対応する各セクションと突きあわせて検証します。 +\fB\&.SF\fRファイル内の各エントリに示されるダイジェストを、マニフェスト内の対応する各セクションと突きあわせて検証します。 .sp -\fI\&.SF\fRファイルには、マニフェスト・ファイル全体のハッシュが格納されたヘッダーがデフォルトで含まれています。ヘッダーが存在する場合、検証では、ヘッダー内のハッシュがマニフェスト・ファイルのハッシュと一致するかどうかを確認するためにチェックできます。一致する場合、検証は次の手順に進みます。 +\fB\&.SF\fRファイルには、マニフェスト・ファイル全体のハッシュが格納されたヘッダーがデフォルトで含まれています。ヘッダーが存在する場合、検証では、ヘッダー内のハッシュがマニフェスト・ファイルのハッシュと一致するかどうかを確認するためにチェックできます。一致する場合、検証は次の手順に進みます。 .sp -一致しない場合、\fI\&.SF\fRファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致することを確認するために、あまり最適化されていない検証が必要になります。署名ファイルを参照してください。 +一致しない場合、\fB\&.SF\fRファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致することを確認するために、あまり最適化されていない検証が必要になります。署名ファイルを参照してください。 .sp -\fI\&.SF\fRファイルのヘッダーに格納されたマニフェスト・ファイルのハッシュが、現在のマニフェスト・ファイルのハッシュに一致しない理由の1つは、署名および\fI\&.SF\fRファイルの生成後に、(\fIjar\fRツールを使用して)1つ以上のファイルがJARファイルに追加されたことです。\fIjar\fRツールを使用してファイルを追加した場合、新しいファイル用のセクションが追加されることにより、マニフェスト・ファイルは変更されますが、\fI\&.SF\fRファイルは変更されません。検証がまだ成功しているとみなされるのは、署名の生成以降にJARファイル内のどのファイルも変更されていない場合です。これが発生するのは、\fI\&.SF\fRファイルのヘッダー以外のセクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致する場合です。 +\fB\&.SF\fRファイルのヘッダーに格納されたマニフェスト・ファイルのハッシュが、現在のマニフェスト・ファイルのハッシュに一致しない理由の1つは、署名および\fB\&.SF\fRファイルの生成後に、(\fBjar\fRツールを使用して)1つ以上のファイルがJARファイルに追加されたことです。\fBjar\fRツールを使用してファイルを追加した場合、新しいファイル用のセクションが追加されることにより、マニフェスト・ファイルは変更されますが、\fB\&.SF\fRファイルは変更されません。検証がまだ成功しているとみなされるのは、署名の生成以降にJARファイル内のどのファイルも変更されていない場合です。これが発生するのは、\fB\&.SF\fRファイルのヘッダー以外のセクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致する場合です。 .RE .sp .RS 4 @@ -439,45 +450,46 @@ .sp -1 .IP " 3." 4.2 .\} -\fI\&.SF\fRファイル内にエントリを持つJARファイル内の各ファイルを読み取ります。読取り中にファイルのダイジェストを計算し、結果をマニフェスト・セクション内のこのファイルのダイジェストと比較します。ダイジェストは同じである必要があり、そうでない場合は検証が失敗します。 +\fB\&.SF\fRファイル内にエントリを持つJARファイル内の各ファイルを読み取ります。読取り中にファイルのダイジェストを計算し、結果をマニフェスト・セクション内のこのファイルのダイジェストと比較します。ダイジェストは同じである必要があり、そうでない場合は検証が失敗します。 .sp -検証プロセス中になんらかの重大な検証エラーが発生した場合、そのプロセスは停止され、セキュリティ例外がスローされます。\fIjarsigner\fRコマンドでは、例外を捕捉および表示します。 +検証プロセス中になんらかの重大な検証エラーが発生した場合、そのプロセスは停止され、セキュリティ例外がスローされます。\fBjarsigner\fRコマンドでは、例外を捕捉および表示します。 .RE .PP \fB注意:\fR -追加の警告(または、\fI\-strict\fRオプションを指定した場合はエラー)はすべて読む必要があります。同様に、証明が信頼できるかを決定するために、(\fI\-verbose\fRおよび\fI\-certs\fRオプションを指定して)証明書の内容も読む必要があります。 +追加の警告(または、\fB\-strict\fRオプションを指定した場合はエラー)はすべて読む必要があります。同様に、証明が信頼できるかを決定するために、(\fB\-verbose\fRおよび\fB\-certs\fRオプションを指定して)証明書の内容も読む必要があります。 .SS "1つのJARファイルを対象とする複数の署名" .PP -次のように、\fIjarsigner\fRコマンドをファイルで複数回実行し、実行のたびに異なるユーザーの別名を指定することによって、1つのJARファイルに複数のユーザーの署名を付けることができます。 +次のように、\fBjarsigner\fRコマンドをファイルで複数回実行し、実行のたびに異なるユーザーの別名を指定することによって、1つのJARファイルに複数のユーザーの署名を付けることができます。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner myBundle\&.jar susan -jarsigner myBundle\&.jar kevin +\fBjarsigner myBundle\&.jar susan\fR +\fBjarsigner myBundle\&.jar kevin\fR + .fi .if n \{\ .RE .\} .PP -JARファイルが複数回署名されている場合、そのJARファイルには、複数の\fI\&.SF\fRファイルと\fI\&.DSA\fRファイルが含まれており、1回の署名に対して1つのペアとなります。前述の例では、出力JARファイルには、次の名前のファイルが含まれています。 +JARファイルが複数回署名されている場合、そのJARファイルには、複数の\fB\&.SF\fRファイルと\fB\&.DSA\fRファイルが含まれており、1回の署名に対して1つのペアとなります。前述の例では、出力JARファイルには、次の名前のファイルが含まれています。 .sp .if n \{\ .RS 4 .\} .nf -SUSAN\&.SF -SUSAN\&.DSA -KEVIN\&.SF -KEVIN\&.DSA +\fBSUSAN\&.SF\fR +\fBSUSAN\&.DSA\fR +\fBKEVIN\&.SF\fR +\fBKEVIN\&.DSA\fR .fi .if n \{\ .RE .\} .SH "オプション" .PP -次の各項では、様々な\fIjarsigner\fRオプションについて説明します。次の標準に注意してください。 +次の各項では、様々な\fBjarsigner\fRオプションについて説明します。次の標準に注意してください。 .sp .RS 4 .ie n \{\ @@ -520,38 +532,40 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-storepass\fR、\fI\-keypass\fR、\fI\-sigfile\fR、\fI\-sigalg\fR、\fI\-digestalg\fR、\fI\-signedjar\fRおよびTSA関連のオプションを使用できるのは、JARファイルに署名する場合のみです。署名付きJARファイルを検証する場合ではありません。\fI\-keystore \fRオプションは、JARファイルの署名および検証に関連します。また、別名は、JARファイルの署名および検証時に指定します。 +\fB\-storepass\fR、\fB\-keypass\fR、\fB\-sigfile\fR、\fB\-sigalg\fR、\fB\-digestalg\fR、\fB\-signedjar\fRおよびTSA関連のオプションを使用できるのは、JARファイルに署名する場合のみです。署名付きJARファイルを検証する場合ではありません。\fB\-keystore \fRオプションは、JARファイルの署名および検証に関連します。また、別名は、JARファイルの署名および検証時に指定します。 .RE .PP \-keystore \fIurl\fR .RS 4 -キーストアの場所を示すURLを指定します。これにより、\fIuser\&.home\fRシステム・プロパティで決定されたユーザーのホーム・ディレクトリ内のファイル\fI\&.keystore\fRにデフォルト設定されます。 +キーストアの場所を示すURLを指定します。これにより、\fBuser\&.home\fRシステム・プロパティで決定されたユーザーのホーム・ディレクトリ内のファイル\fB\&.keystore\fRにデフォルト設定されます。 .sp キーストアは署名時には必要です。デフォルトのキーストアが存在しない場合、またはデフォルト以外のキーストアを使用する場合は、キーストアを明示的に指定する必要があります。 .sp -検証するときはキーストアは必要ありません。ただし、キーストアが指定されているか、あるいはデフォルトのキーストアが存在していて、さらに\fI\-verbose\fRオプションも指定されていた場合、JARファイルの検証に使用される証明書がそのキーストアに1つでも含まれているかどうかに関する追加情報が出力されます。 +検証するときはキーストアは必要ありません。ただし、キーストアが指定されているか、あるいはデフォルトのキーストアが存在していて、さらに\fB\-verbose\fRオプションも指定されていた場合、JARファイルの検証に使用される証明書がそのキーストアに1つでも含まれているかどうかに関する追加情報が出力されます。 .sp -\fI\-keystore\fR引数には、URLではなくファイル名とパスを指定でき、この場合、ファイル: URLと同じように処理されます。たとえば、次にように指定すると同等になります。 +\fB\-keystore\fR引数には、URLではなくファイル名とパスを指定でき、この場合、ファイル: URLと同じように処理されます。たとえば、次にように指定すると同等になります。 .sp .if n \{\ .RS 4 .\} .nf -\-keystore \fIfilePathAndName\fR -\-keystore file:\fIfilePathAndName\fR +\fB\-keystore \fR\fB\fIfilePathAndName\fR\fR +\fB\-keystore file:\fR\fB\fIfilePathAndName\fR\fR + .fi .if n \{\ .RE .\} -(JREの\fI$JAVA_HOME/lib/security directory\fRにある) -\fIjava\&.security\fRセキュリティ・プロパティ・ファイル内でSun PKCS #11プロバイダが構成された場合、\fIkeytool\fRおよび\fIjarsigner\fRツールはPKCS#11トークンに基づいて動作できます。次のオプションを指定します。 +(JREの\fB$JAVA_HOME/lib/security directory\fRにある) +\fBjava\&.security\fRセキュリティ・プロパティ・ファイル内でSun PKCS #11プロバイダが構成された場合、\fBkeytool\fRおよび\fBjarsigner\fRツールはPKCS#11トークンに基づいて動作できます。次のオプションを指定します。 .sp .if n \{\ .RS 4 .\} .nf -\-keystore NONE -\-storetype PKCS11 +\fB\-keystore NONE\fR +\fB\-storetype PKCS11\fR + .fi .if n \{\ .RE @@ -562,7 +576,8 @@ .RS 4 .\} .nf -keytool \-keystore NONE \-storetype PKCS11 \-list +\fBkeytool \-keystore NONE \-storetype PKCS11 \-list\fR + .fi .if n \{\ .RE @@ -571,17 +586,17 @@ .PP \-storetype \fIstoretype\fR .RS 4 -インスタンスを生成するキーストアのタイプを指定します。デフォルトのキーストア・タイプは、セキュリティ・プロパティ・ファイル内の\fIkeystore\&.type\fRプロパティの値で指定されたタイプです。この値は、\fIjava\&.security\&.KeyStore\fRのstatic -\fIgetDefaultType\fRメソッドによって返されます。 +インスタンスを生成するキーストアのタイプを指定します。デフォルトのキーストア・タイプは、セキュリティ・プロパティ・ファイル内の\fBkeystore\&.type\fRプロパティの値で指定されたタイプです。この値は、\fBjava\&.security\&.KeyStore\fRのstatic +\fBgetDefaultType\fRメソッドによって返されます。 .sp -\fI\-storepass\fRオプションを使用して、PCKS #11トークンのPINを指定することもできます。何も指定しない場合、\fIkeytool\fRおよび\fIjarsigner\fRコマンドによって、トークンPINの指定を求められます。トークンに保護された認証パス(専用のPINパッドや生体読取り機など)がある場合、\fI\-protected\fRオプションを指定する必要がありますが、パスワード・オプションは指定できません。 +\fB\-storepass\fRオプションを使用して、PCKS #11トークンのPINを指定することもできます。何も指定しない場合、\fBkeytool\fRおよび\fBjarsigner\fRコマンドによって、トークンPINの指定を求められます。トークンに保護された認証パス(専用のPINパッドや生体読取り機など)がある場合、\fB\-protected\fRオプションを指定する必要がありますが、パスワード・オプションは指定できません。 .RE .PP \-storepass[:env | :file] \fIargument\fR .RS 4 -キーストアにアクセスするのに必要なパスワードを指定します。これが必要なのは、JARファイルに署名を付けるときのみです(検証するときには不要です)。その場合、\fI\-storepass\fRオプションをコマンドラインで指定しないと、パスワードの入力を求められます。 +キーストアにアクセスするのに必要なパスワードを指定します。これが必要なのは、JARファイルに署名を付けるときのみです(検証するときには不要です)。その場合、\fB\-storepass\fRオプションをコマンド行で指定しないと、パスワードの入力を求められます。 .sp -修飾子\fIenv\fRまたは\fIfile\fRが指定されていない場合、パスワードの値は\fIargument\fRになります。それ以外の場合、パスワードは次のようにして取得されます。 +修飾子\fBenv\fRまたは\fBfile\fRが指定されていない場合、パスワードの値は\fIargument\fRになります。それ以外の場合、パスワードは次のようにして取得されます。 .sp .RS 4 .ie n \{\ @@ -591,8 +606,8 @@ .sp -1 .IP \(bu 2.3 .\} -\fIenv\fR: -\fIargument\fRという名前の環境変数からパスワードを取得します。 +\fBenv\fR: +\fBargument\fRという名前の環境変数からパスワードを取得します。 .RE .sp .RS 4 @@ -603,19 +618,19 @@ .sp -1 .IP \(bu 2.3 .\} -\fIfile\fR: -\fIargument\fRという名前のファイルからパスワードを取得します。 +\fBfile\fR: +\fBargument\fRという名前のファイルからパスワードを取得します。 .RE .sp \fB注意:\fR -テストを目的とする場合またはセキュリティ保護されたシステムを使用している場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。 +テストを目的とする場合またはセキュアなシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。 .RE .PP \-keypass [:env | :file] \fIargument\fR .RS 4 -コマンドラインで指定された別名に対応するキーストア・エントリの秘密鍵を保護するのに使用するパスワードを指定します。\fIjarsigner\fRを使用してJARファイルに署名を付けるときは、パスワードが必要です。コマンドラインでパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。 +コマンド行で指定された別名に対応するキーストア・エントリの秘密鍵を保護するのに使用するパスワードを指定します。\fBjarsigner\fRを使用してJARファイルに署名を付けるときは、パスワードが必要です。コマンド行でパスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる場合は、パスワードの入力を求められます。 .sp -修飾子\fIenv\fRまたは\fIfile\fRが指定されていない場合、パスワードの値は\fIargument\fRになります。それ以外の場合、パスワードは次のようにして取得されます。 +修飾子\fBenv\fRまたは\fBfile\fRが指定されていない場合、パスワードの値は\fBargument\fRになります。それ以外の場合、パスワードは次のようにして取得されます。 .sp .RS 4 .ie n \{\ @@ -625,8 +640,8 @@ .sp -1 .IP \(bu 2.3 .\} -\fIenv\fR: -\fIargument\fRという名前の環境変数からパスワードを取得します。 +\fBenv\fR: +\fBargument\fRという名前の環境変数からパスワードを取得します。 .RE .sp .RS 4 @@ -637,21 +652,21 @@ .sp -1 .IP \(bu 2.3 .\} -\fIfile\fR: -\fIargument\fRという名前のファイルからパスワードを取得します。 +\fBfile\fR: +\fBargument\fRという名前のファイルからパスワードを取得します。 .RE .sp \fB注意:\fR -テストを目的とする場合またはセキュリティ保護されたシステムを使用している場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。 +テストを目的とする場合またはセキュアなシステムを使用している場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。 .RE .PP \-sigfile \fIfile\fR .RS 4 -生成された\fI\&.SF\fRファイルおよび\fI\&.DSA\fRファイルに使用するベース・ファイル名を指定します。たとえば、ファイルが\fIDUKESIGN\fRの場合、生成される\fI\&.SF\fRおよび\fI\&.DSA\fRファイルは、\fIDUKESIGN\&.SF\fRおよび\fIDUKESIGN\&.DSA\fRという名前で、署名付きJARファイルの\fIMETA\-INF\fRディレクトリに格納されます。 +生成された\fB\&.SF\fRファイルおよび\fB\&.DSA\fRファイルに使用するベース・ファイル名を指定します。たとえば、ファイルが\fBDUKESIGN\fRの場合、生成される\fB\&.SF\fRおよび\fB\&.DSA\fRファイルは、\fBDUKESIGN\&.SF\fRおよび\fBDUKESIGN\&.DSA\fRという名前で、署名付きJARファイルの\fBMETA\-INF\fRディレクトリに格納されます。 .sp -ファイル内の文字は、セット\fIa\-zA\-Z0\-9_\-\fRから指定される必要があります。アルファベット、数字、下線およびハイフン文字のみを使用できます。\fI\&.SF\fRおよび\fI\&.DSA\fRのファイル名では、小文字はすべて大文字に変換されます。 +ファイル内の文字は、セット\fBa\-zA\-Z0\-9_\-\fRから指定される必要があります。アルファベット、数字、下線およびハイフン文字のみを使用できます。\fB\&.SF\fRおよび\fB\&.DSA\fRのファイル名では、小文字はすべて大文字に変換されます。 .sp -コマンドラインで\fI\-sigfile\fRオプションを指定しなかった場合、\fI\&.SF\fRファイルと\fI\&.DSA\fRファイルのベース・ファイル名は、コマンドラインで指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名に、署名ファイル名で無効な文字が含まれている場合、ファイル名を作成するために、該当する文字が下線(_)文字に変換されます。 +コマンド行で\fB\-sigfile\fRオプションを指定しなかった場合、\fB\&.SF\fRファイルと\fB\&.DSA\fRファイルのベース・ファイル名は、コマンド行で指定された別名の先頭の8文字をすべて大文字に変換したものになります。別名が8文字未満の場合は、別名がそのまま使用されます。別名に、署名ファイル名で無効な文字が含まれている場合、ファイル名を作成するために、該当する文字が下線(_)文字に変換されます。 .RE .PP \-sigalg \fIalgorithm\fR @@ -661,7 +676,7 @@ 標準的な署名アルゴリズム名のリストは、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/CryptoSpec\&.html#AppAにある Java Cryptography Architecture (JCA)リファレンス・ガイドの「付録A: 標準名」を参照してください。 .sp -このアルゴリズムには、JARファイルの署名に使用する秘密鍵との互換性が必要です。このオプションを指定しない場合、秘密鍵のタイプに応じて、\fISHA1withDSA\fR、\fISHA256withRSA\fRまたは\fISHA256withECDSA\fRが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\fI\-providerClass\fRオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドは失敗します。 +このアルゴリズムには、JARファイルの署名に使用する秘密鍵との互換性が必要です。このオプションを指定しない場合、秘密鍵のタイプに応じて、\fBSHA1withDSA\fR、\fBSHA256withRSA\fRまたは\fBSHA256withECDSA\fRが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\fB\-providerClass\fRオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドは失敗します。 .RE .PP \-digestalg \fIalgorithm\fR @@ -671,60 +686,61 @@ 標準的なメッセージ・ダイジェスト・アルゴリズム名のリストは、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/CryptoSpec\&.html#AppAにある Java Cryptography Architecture (JCA)リファレンス・ガイドの「付録A: 標準名」を参照してください。 .sp -このオプションを指定しない場合、\fISHA256\fRが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\fI\-providerClass\fRオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドは失敗します。 +このオプションを指定しない場合、\fBSHA256\fRが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、\fB\-providerClass\fRオプションを使用してそのようなプロバイダをユーザーが指定する必要があります。そうでない場合、コマンドは失敗します。 .RE .PP \-certs .RS 4 -コマンドラインで、\fI\-certs\fRオプションを\fI\-verify\fRおよび\fI\-verbose\fRオプションとともに指定した場合、JARファイルの各署名者の証明書情報が出力に含まれます。この情報には、署名者の公開鍵を証明する証明書(\fI\&.DSA\fRファイルに格納)のタイプの名前が含まれ、証明書がX\&.509証明書(\fIjava\&.security\&.cert\&.X509Certificate\fRのインスタンス)の場合、署名者の識別名が含まれます。 +コマンド行で、\fB\-certs\fRオプションを\fB\-verify\fRおよび\fB\-verbose\fRオプションとともに指定した場合、JARファイルの各署名者の証明書情報が出力に含まれます。この情報には、署名者の公開鍵を証明する証明書(\fB\&.DSA\fRファイルに格納)のタイプの名前が含まれ、証明書がX\&.509証明書(\fBjava\&.security\&.cert\&.X509Certificate\fRのインスタンス)の場合、署名者の識別名が含まれます。 .sp -キーストアの確認も行われます。コマンドラインでキーストアの値が指定されていない場合、デフォルトのキーストア・ファイル(ある場合)がチェックされます。署名者の公開鍵の証明書がキーストア内のエントリと一致する場合、その署名者のキーストアのエントリの別名が丸カッコ内に表示されます。 +キーストアの確認も行われます。コマンド行でキーストアの値が指定されていない場合、デフォルトのキーストア・ファイル(ある場合)がチェックされます。署名者の公開鍵の証明書がキーストア内のエントリと一致する場合、その署名者のキーストアのエントリの別名が丸カッコ内に表示されます。 .RE .PP \-certchain \fIfile\fR .RS 4 -コマンドラインで指定した別名によって表されるキーストア・エントリの秘密鍵に関連付けられた証明書チェーンが完全ではない場合に、使用する証明書チェーンを指定します。これは、証明書チェーン全体を保持するのに十分な領域がないハードウェア・トークン上にキーストアが格納されている場合に発生します。このファイルは一連の連結されたX\&.509証明書、PKCS#7形式の単一データ・ブロックのいずれかとなり、そのエンコーディング形式はバイナリ・エンコーディング形式、Internet RFC 1421標準で規定される印刷可能エンコーディング形式(Base64エンコーディングとも呼ばれる)のいずれかになります。インターネットRFC 1421証明書符号化規格およびhttp://tools\&.ietf\&.org/html/rfc1421を参照してください。 +コマンド行で指定した別名によって表されるキーストア・エントリの秘密鍵に関連付けられた証明書チェーンが完全ではない場合に、使用する証明書チェーンを指定します。これは、証明書チェーン全体を保持するのに十分な領域がないハードウェア・トークン上にキーストアが格納されている場合に発生します。このファイルは一連の連結されたX\&.509証明書、PKCS#7形式の単一データ・ブロックのいずれかとなり、そのエンコーディング形式はバイナリ・エンコーディング形式、Internet RFC 1421標準で規定される印刷可能エンコーディング形式(Base64エンコーディングとも呼ばれる)のいずれかになります。インターネットRFC 1421証明書符号化規格およびhttp://tools\&.ietf\&.org/html/rfc1421を参照してください。 .RE .PP \-verbose .RS 4 -コマンドラインで\fI\-verbose\fRオプションを指定した場合、冗長モードで動作し、このモードでは、\fIjarsigner\fRは、JARの署名または検証の進行状況に関する追加情報を出力します。 +コマンド行で\fB\-verbose\fRオプションを指定した場合、冗長モードで動作し、このモードでは、\fBjarsigner\fRは、JARの署名または検証の進行状況に関する追加情報を出力します。 .RE .PP \-internalsf .RS 4 -以前は、JARファイルの署名時に生成された\fI\&.DSA\fR -(署名ブロック)ファイルに、生成された\fI\&.SF\fRファイル(署名ファイル)のエンコードされた完全なコピーが含まれていました。 この動作は変更されました。出力JARファイル全体のサイズを小さくするために、デフォルトでは\fI\&.DSA\fRファイルには\fI\&.SF\fRファイルのコピーが含まれないようになっています。コマンドラインで\fI\-internalsf\fRを指定した場合、以前と同じように動作します。このオプションは、テストを行う場合に便利です。実際には、\fI\-internalsf\fRオプションは、オーバーヘッドが大きくなるため、使用しないでください。 +以前は、JARファイルの署名時に生成された\fB\&.DSA\fR +(署名ブロック)ファイルに、生成された\fB\&.SF\fRファイル(署名ファイル)のエンコードされた完全なコピーが含まれていました。 この動作は変更されました。出力JARファイル全体のサイズを小さくするために、デフォルトでは\fB\&.DSA\fRファイルには\fB\&.SF\fRファイルのコピーが含まれないようになっています。コマンド行で\fB\-internalsf\fRを指定した場合、以前と同じように動作します。このオプションは、テストを行う場合に便利です。実際には、\fB\-internalsf\fRオプションは、オーバーヘッドが大きくなるため、使用しないでください。 .RE .PP \-sectionsonly .RS 4 -コマンドラインで\fI\-sectionsonly\fRオプションを指定した場合、JARファイルの署名時に生成される\fI\&.SF\fRファイル(署名ファイル)には、マニフェスト・ファイル全体のハッシュを含むヘッダーは含まれません。これに含まれるのは、JARファイル内の各ソース・ファイルに関連する情報およびハッシュのみです。署名ファイルを参照してください。 +コマンド行で\fB\-sectionsonly\fRオプションを指定した場合、JARファイルの署名時に生成される\fB\&.SF\fRファイル(署名ファイル)には、マニフェスト・ファイル全体のハッシュを含むヘッダーは含まれません。これに含まれるのは、JARファイル内の各ソース・ファイルに関連する情報およびハッシュのみです。署名ファイルを参照してください。 .sp -デフォルトでは、最適化のために、このヘッダーが追加されます。ヘッダーが存在する場合、JARファイルを検証するたびに、検証では、まずヘッダー内のハッシュがマニフェスト・ファイル全体のハッシュと一致するかどうかを確認するためにチェックできます。一致する場合、検証は次の手順に進みます。一致しない場合、\fI\&.SF\fRファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するという、あまり最適化されていない検証を実行する必要があります。JARファイルの検証を参照してください。 +デフォルトでは、最適化のために、このヘッダーが追加されます。ヘッダーが存在する場合、JARファイルを検証するたびに、検証では、まずヘッダー内のハッシュがマニフェスト・ファイル全体のハッシュと一致するかどうかを確認するためにチェックできます。一致する場合、検証は次の手順に進みます。一致しない場合、\fB\&.SF\fRファイル内の各ソース・ファイル情報セクションのハッシュが、マニフェスト・ファイル内の対応するセクションのハッシュと一致するという、あまり最適化されていない検証を実行する必要があります。JARファイルの検証を参照してください。 .sp -\fI\-sectionsonly\fRオプションは、主にテスト用に使用されます。これを使用するとオーバーヘッドが大きくなるため、テスト用以外では使用しないでください。 +\fB\-sectionsonly\fRオプションは、主にテスト用に使用されます。これを使用するとオーバーヘッドが大きくなるため、テスト用以外では使用しないでください。 .RE .PP \-protected .RS 4 -\fItrue\fRまたは\fIfalse\fRのいずれかの値を指定できます。専用PINリーダーなどの保護された認証パスによってパスワードを指定する必要がある場合、\fItrue\fRを指定します。 +\fBtrue\fRまたは\fBfalse\fRのいずれかの値を指定できます。専用PINリーダーなどの保護された認証パスによってパスワードを指定する必要がある場合、\fBtrue\fRを指定します。 .RE .PP \-providerClass \fIprovider\-class\-name\fR .RS 4 -暗号化サービス・プロバイダが\fIjava\&.security\fRセキュリティ・プロパティ・ファイルに指定されていないときは、そのマスター・クラス・ファイルの名前を指定するときに使用されます。 +暗号化サービス・プロバイダが\fBjava\&.security\fRセキュリティ・プロパティ・ファイルに指定されていないときは、そのマスター・クラス・ファイルの名前を指定するときに使用されます。 .sp -\fI\-providerArg ConfigFilePath\fRオプションとともに使用し、\fIkeytool\fRおよび\fIjarsigner\fRツールは、プロバイダを動的にインストールし、トークン構成ファイルへのパスに\fIConfigFilePath\fRを使用します。次の例は、Oracle PKCS #11プロバイダがセキュリティ・プロパティ・ファイルに構成されていなかった場合に\fIPKCS #11\fRキーストアを一覧表示するコマンドを示しています。 +\fB\-providerArg ConfigFilePath\fRオプションとともに使用し、\fBkeytool\fRおよび\fBjarsigner\fRツールは、プロバイダを動的にインストールし、トークン構成ファイルへのパスに\fIConfigFilePath\fRを使用します。次の例は、Oracle PKCS #11プロバイダがセキュリティ・プロパティ・ファイルに構成されていなかった場合に\fBPKCS #11\fRキーストアを一覧表示するコマンドを示しています。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-keystore NONE \-storetype PKCS11 \e - \-providerClass sun\&.security\&.pkcs11\&.SunPKCS11 \e - \-providerArg /mydir1/mydir2/token\&.config \e - \-list +\fBjarsigner \-keystore NONE \-storetype PKCS11 \e\fR +\fB \-providerClass sun\&.security\&.pkcs11\&.SunPKCS11 \e\fR +\fB \-providerArg /mydir1/mydir2/token\&.config \e\fR +\fB \-list\fR + .fi .if n \{\ .RE @@ -733,17 +749,18 @@ .PP \-providerName \fIproviderName\fR .RS 4 -\fIjava\&.security\fRセキュリティ・プロパティ・ファイル内で2つ以上のプロバイダが構成された場合、\fI\-providerName\fRオプションを使用して、特定のプロバイダ・インスタンスを対象にすることができます。このオプションの引数は、プロバイダの名前です。 +\fBjava\&.security\fRセキュリティ・プロパティ・ファイル内で2つ以上のプロバイダが構成された場合、\fB\-providerName\fRオプションを使用して、特定のプロバイダ・インスタンスを対象にすることができます。このオプションの引数は、プロバイダの名前です。 .sp -Oracle PKCS #11プロバイダの場合、\fIproviderName\fRは\fISunPKCS11\-\fR\fITokenName\fRという形式になります。ここで、構成属性の表で詳細に説明されているように、\fITokenName\fRは、プロバイダ・インスタンスが構成された名前の接尾辞です。たとえば、次のコマンドは、名前接尾辞\fISmartCard\fRの\fIPKCS #11\fRキーストア・プロバイダ・インスタンスの内容を一覧表示します。 +Oracle PKCS #11プロバイダの場合、\fIproviderName\fRは\fBSunPKCS11\-\fR\fITokenName\fRという形式になります。ここで、構成属性の表で詳細に説明されているように、\fITokenName\fRは、プロバイダ・インスタンスが構成された名前の接尾辞です。たとえば、次のコマンドは、名前接尾辞\fBSmartCard\fRの\fBPKCS #11\fRキーストア・プロバイダ・インスタンスの内容を一覧表示します。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-keystore NONE \-storetype PKCS11 \e - \-providerName SunPKCS11\-SmartCard \e - \-list +\fBjarsigner \-keystore NONE \-storetype PKCS11 \e\fR +\fB \-providerName SunPKCS11\-SmartCard \e\fR +\fB \-list\fR + .fi .if n \{\ .RE @@ -752,41 +769,41 @@ .PP \-J\fIjavaoption\fR .RS 4 -指定された\fIjavaoption\fR文字列をJavaインタプリタに直接渡します。\fIjarsigner\fRコマンドは、インタプリタに対するラッパーです。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンドラインで\fIjava \-h\fRまたは\fIjava \-X\fRと入力してください。 +指定された\fIjavaoption\fR文字列をJavaインタプリタに直接渡します。\fBjarsigner\fRコマンドは、インタプリタに対するラッパーです。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンド行で\fBjava \-h\fRまたは\fBjava \-X\fRと入力してください。 .RE .PP \-tsa \fIurl\fR .RS 4 -\fI\-tsa http://example\&.tsa\&.url\fRがJARファイルの署名時にコマンドラインにある場合、署名のタイムスタンプが生成されます。URL -\fIhttp://example\&.tsa\&.url\fRは、Time Stamping Authority (TSA)の場所を特定し、\fI\-tsacert\fRオプションを指定して検出されたURLをオーバーライドします。\fI\-tsa\fRオプションでは、TSAの公開鍵証明書をキーストアに配置する必要はありません。 +\fB\-tsa http://example\&.tsa\&.url\fRがJARファイルの署名時にコマンド行にある場合、署名のタイムスタンプが生成されます。URL +\fBhttp://example\&.tsa\&.url\fRは、Time Stamping Authority (TSA)の場所を特定し、\fB\-tsacert\fRオプションを指定して検出されたURLをオーバーライドします。\fB\-tsa\fRオプションでは、TSAの公開鍵証明書をキーストアに配置する必要はありません。 .sp -タイムスタンプを生成するために、\fIjarsigner\fRは、RFC 3161で定義されているタイムスタンプ・プロトコル(TSP)を使用してTSAと通信します。成功すると、TSAによって返されたタイムスタンプ・トークンは、署名ブロック・ファイルの署名とともに保存されます。 +タイムスタンプを生成するために、\fBjarsigner\fRは、RFC 3161で定義されているタイムスタンプ・プロトコル(TSP)を使用してTSAと通信します。成功すると、TSAによって返されたタイムスタンプ・トークンは、署名ブロック・ファイルの署名とともに保存されます。 .RE .PP \-tsacert \fIalias\fR .RS 4 -\fI\-tsacert alias\fRがJARファイルの署名時にコマンドラインにある場合、署名のタイムスタンプが生成されます。別名は、キーストア内の有効なTSAの公開鍵証明書を特定します。エントリの証明書で、TSAの場所を特定するURLを含むSubject Information Access拡張機能が確認されます。 +\fB\-tsacert alias\fRがJARファイルの署名時にコマンド行にある場合、署名のタイムスタンプが生成されます。別名は、キーストア内の有効なTSAの公開鍵証明書を特定します。エントリの証明書で、TSAの場所を特定するURLを含むSubject Information Access拡張機能が確認されます。 .sp -\fI\-tsacert\fRオプションを使用する場合は、TSAの公開鍵証明書がキーストアに配置されている必要があります。 +\fB\-tsacert\fRオプションを使用する場合は、TSAの公開鍵証明書がキーストアに配置されている必要があります。 .RE .PP \-tsapolicyid \fIpolicyid\fR .RS 4 TSAサーバーに送信するポリシーIDを識別するオブジェクト識別子(OID)を指定します。このオプションを指定しない場合、ポリシーIDは送信されず、TSAサーバーはデフォルトのポリシーIDを選択します。 .sp -オブジェクト識別子は、ITU Telecommunication Standardization Sector (ITU\-T)標準であるX\&.696によって定義されます。これらの識別子は、通常、\fI1\&.2\&.3\&.4\fRなどの、負ではない数字のピリオド区切りのセットです。 +オブジェクト識別子は、ITU Telecommunication Standardization Sector (ITU\-T)標準であるX\&.696によって定義されます。これらの識別子は、通常、\fB1\&.2\&.3\&.4\fRなどの、負ではない数字のピリオド区切りのセットです。 .RE .PP \-altsigner \fIclass\fR .RS 4 -このオプションは、代替署名メカニズムを指定します。完全修飾クラス名は、\fIcom\&.sun\&.jarsigner\&.ContentSigner\fR抽象クラスを拡張するクラス・ファイルを識別します。このクラス・ファイルへのパスは、\fI\-altsignerpath\fRオプションによって定義されます。\fI\-altsigner\fRオプションを使用した場合、\fIjarsigner\fRコマンドでは、指定されたクラスによって提供される署名メカニズムを使用します。それ以外の場合、\fIjarsigner\fRコマンドはデフォルトの署名メカニズムを使用します。 +このオプションは、代替署名メカニズムを指定します。完全修飾クラス名は、\fBcom\&.sun\&.jarsigner\&.ContentSigner\fR抽象クラスを拡張するクラス・ファイルを識別します。このクラス・ファイルへのパスは、\fB\-altsignerpath\fRオプションによって定義されます。\fB\-altsigner\fRオプションを使用した場合、\fBjarsigner\fRコマンドでは、指定されたクラスによって提供される署名メカニズムを使用します。それ以外の場合、\fBjarsigner\fRコマンドはデフォルトの署名メカニズムを使用します。 .sp -たとえば、\fIcom\&.sun\&.sun\&.jarsigner\&.AuthSigner\fRという名前のクラスが提供する署名メカニズムを使用するには、jarsignerのオプション\fI\-altsigner com\&.sun\&.jarsigner\&.AuthSigner\fRを使用します。 +たとえば、\fBcom\&.sun\&.sun\&.jarsigner\&.AuthSigner\fRという名前のクラスが提供する署名メカニズムを使用するには、jarsignerのオプション\fB\-altsigner com\&.sun\&.jarsigner\&.AuthSigner\fRを使用します。 .RE .PP \-altsignerpath \fIclasspathlist\fR .RS 4 -クラス・ファイルおよびそれが依存するJARファイルへのパスを指定します。\fI\-altsigner\fRオプションを使用して、クラス・ファイル名を指定します。クラス・ファイルがJARファイル内にある場合、このオプションでは、そのJARファイルへのパスを指定します。 +クラス・ファイルおよびそれが依存するJARファイルへのパスを指定します。\fB\-altsigner\fRオプションを使用して、クラス・ファイル名を指定します。クラス・ファイルがJARファイル内にある場合、このオプションでは、そのJARファイルへのパスを指定します。 .sp 絶対パスまたは現在のディレクトリへの相対パスを指定できます。\fIclasspathlist\fRに複数のパスやJARファイルが含まれる場合、それらを、Oracle Solarisの場合はコロン(:)で、Windowsの場合はセミコロン(;)で、それぞれ区切ります。目的のクラスがすでに検索パス内にある場合は、このオプションは不要です。 .sp @@ -796,7 +813,8 @@ .RS 4 .\} .nf -\-altsignerpath /home/user/lib/authsigner\&.jar +\fB\-altsignerpath /home/user/lib/authsigner\&.jar\fR + .fi .if n \{\ .RE @@ -807,7 +825,8 @@ .RS 4 .\} .nf -\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/ +\fB\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fR + .fi .if n \{\ .RE @@ -821,23 +840,23 @@ .PP \-verbose \fIsuboptions\fR .RS 4 -検証処理の場合、\fI\-verbose\fRオプションには、表示する情報の量を決定するサブオプションを指定します。\fI\-certs\fRオプションも指定した場合、デフォルト・モード(またはサブオプション\fIall\fR)では、エントリが処理されるたびに各エントリが表示され、その後にJARファイルの各署名者の証明書情報も表示されます。\fI\-certs\fRおよび\fI\-verbose:grouped\fRサブオプションを指定した場合、同じ署名者情報を持つエントリが、その証明書情報とともに、グループ化されて表示されます。\fI\-certs\fRおよび\fI\-verbose:summary\fRサブオプションを指定した場合、同じ署名者情報を持つエントリが、その証明書情報とともに、グループ化されて表示されます。各エントリの詳細は、\fI1つのエントリ(以上)\fRにまとめられて表示されます。例を参照してください。 +検証処理の場合、\fB\-verbose\fRオプションには、表示する情報の量を決定するサブオプションを指定します。\fB\-certs\fRオプションも指定した場合、デフォルト・モード(またはサブオプション\fBall\fR)では、エントリが処理されるたびに各エントリが表示され、その後にJARファイルの各署名者の証明書情報も表示されます。\fB\-certs\fRおよび\fB\-verbose:grouped\fRサブオプションを指定した場合、同じ署名者情報を持つエントリが、その証明書情報とともに、グループ化されて表示されます。\fB\-certs\fRおよび\fB\-verbose:summary\fRサブオプションを指定した場合、同じ署名者情報を持つエントリが、その証明書情報とともに、グループ化されて表示されます。各エントリの詳細は、\fI1つのエントリ(以上)\fRにまとめられて表示されます。例を参照してください。 .RE .SH "エラーと警告" .PP -署名または検証プロセス中に、\fIjarsigner\fRコマンドで、様々なエラーまたは警告が発行される可能性があります。 +署名または検証プロセス中に、\fBjarsigner\fRコマンドで、様々なエラーまたは警告が発行される可能性があります。 .PP -障害がある場合、\fIjarsigner\fRコマンドはコード1で終了します。障害はないが、1つ以上の重大な警告がある場合、\fI\-strict\fRオプションが指定されて\fBいない\fR場合は、\fIjarsigner\fRコマンドはコード0で終了し、\fI\-strict\fRが指定されている場合は警告コードのOR値で終了します。情報警告のみがある、または警告がまったくない場合、コマンドは常にコード0で終了します。 +障害がある場合、\fBjarsigner\fRコマンドはコード1で終了します。障害はないが、1つ以上の重大な警告がある場合、\fB\-strict\fRオプションが指定されて\fBいない\fR場合は、\fBjarsigner\fRコマンドはコード0で終了し、\fB\-strict\fRが指定されている場合は警告コードのOR値で終了します。情報警告のみがある、または警告がまったくない場合、コマンドは常にコード0で終了します。 .PP -たとえば、エントリの署名に使用される証明書が期限切れで、ファイルの署名を許可しないKeyUsage拡張機能を使用している場合、\fI\-strict\fRオプションが指定されていると、\fIjarsigner\fRコマンドはコード12 (=4+8)で終了します。 +たとえば、エントリの署名に使用される証明書が期限切れで、ファイルの署名を許可しないKeyUsage拡張機能を使用している場合、\fB\-strict\fRオプションが指定されていると、\fBjarsigner\fRコマンドはコード12 (=4+8)で終了します。 .PP \fB注意:\fR -UNIXベースのオペレーティング・システムでは0から255までの値のみが有効のため、終了コードは再利用されます。 +Solaris、LinuxおよびOS Xでは0から255までの値のみが有効のため、終了コードは再利用されます。 .PP -次のセクションでは、\fIjarsigner\fRコマンドにより発行できるエラーおよび警告の名前、コード、説明を記述します。 +次のセクションでは、\fBjarsigner\fRコマンドにより発行できるエラーおよび警告の名前、コード、説明を記述します。 .SS "障害" .PP -コマンドライン解析エラー、JARファイルに署名する鍵ペアを検索できない、または署名付きJARファイルの検証失敗など(限定されません)、\fIjarsigner\fRコマンドの失敗理由。 +コマンド行解析エラー、JARファイルに署名する鍵ペアを検索できない、または署名付きJARファイルの検証失敗など(限定されません)、\fBjarsigner\fRコマンドの失敗理由。 .PP failure .RS 4 @@ -846,9 +865,9 @@ .SS "重大な警告" .PP \fB注意:\fR -\fI\-strict\fRオプションを指定した場合、重大な警告はエラーとして報告されます。 +\fB\-strict\fRオプションを指定した場合、重大な警告はエラーとして報告されます。 .PP -JARファイルの署名に使用する証明書にエラーがある、または署名付きJARファイルに他の問題があるなど、\fIjarsigner\fRコマンドが重大な警告を発行する理由。 +JARファイルの署名に使用する証明書にエラーがある、または署名付きJARファイルに他の問題があるなど、\fBjarsigner\fRコマンドが重大な警告を発行する理由。 .PP hasExpiredCert .RS 4 @@ -862,7 +881,7 @@ .PP chainNotValidated .RS 4 -コード4。このjarには、証明書チェーンが正しく検証できないエントリが含まれています。 +コード4。このjarには、証明書チェーンが検証されていないエントリが含まれています。 .RE .PP badKeyUsage @@ -905,27 +924,28 @@ .PP noTimestamp .RS 4 -このjarには、タイムスタンプを含まない署名が含まれています。タイムスタンプなしでは、署名者証明書の有効期限(\fIYYYY\-MM\-DD\fR)後または将来の取消日後、ユーザーはこのJARファイルを検証できない場合があります。 +このjarには、タイムスタンプを含まない署名が含まれています。タイムスタンプなしでは、署名者証明書の有効期限(\fBYYYY\-MM\-DD\fR)後または将来の取消日後、ユーザーはこのJARファイルを検証できない場合があります。 .RE .SH "例" .SS "JARファイルの署名" .PP -次のコマンドを使用して、キーストア別名が\fIworking\fRディレクトリの\fImystore\fRという名前のキーストアにある\fIjane\fRであるユーザーの秘密鍵でbundle\&.jarに署名し、署名付きJARファイルに\fIsbundle\&.jar\fRという名前を付けます。 +次のコマンドを使用して、キーストア別名が\fBworking\fRディレクトリの\fBmystore\fRという名前のキーストアにある\fBjane\fRであるユーザーの秘密鍵でbundle\&.jarに署名し、署名付きJARファイルに\fBsbundle\&.jar\fRという名前を付けます。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-keystore /working/mystore - \-storepass <keystore password> - \-keypass <private key password> - \-signedjar sbundle\&.jar bundle\&.jar jane +\fBjarsigner \-keystore /working/mystore\fR +\fB \-storepass <keystore password>\fR +\fB \-keypass <private key password>\fR +\fB \-signedjar sbundle\&.jar bundle\&.jar jane\fR + .fi .if n \{\ .RE .\} .PP -前述のコマンドでは\fI\-sigfile\fRが指定されていないため、署名付きJARファイルに格納される生成された\fI\&.SF\fRファイルおよび\fI\&.DSA\fRファイルの名前は、別名に基づいたデフォルトの名前になります。これらは、名前付きの\fIJANE\&.SF\fRおよび\fIJANE\&.DSA\fRです。 +前述のコマンドでは\fB\-sigfile\fRが指定されていないため、署名付きJARファイルに格納される生成された\fB\&.SF\fRファイルおよび\fB\&.DSA\fRファイルの名前は、別名に基づいたデフォルトの名前になります。これらは、名前付きの\fBJANE\&.SF\fRおよび\fBJANE\&.DSA\fRです。 .PP ストアのパスワードおよび秘密鍵のパスワードを求められる場合、前述のコマンドを短縮して、次のことを実行できます。 .sp @@ -933,8 +953,9 @@ .RS 4 .\} .nf -jarsigner \-keystore /working/mystore - \-signedjar sbundle\&.jar bundle\&.jar jane +\fBjarsigner \-keystore /working/mystore\fR +\fB \-signedjar sbundle\&.jar bundle\&.jar jane\fR + .fi .if n \{\ .RE @@ -946,19 +967,21 @@ .RS 4 .\} .nf -jarsigner \-signedjar sbundle\&.jar bundle\&.jar jane +\fBjarsigner \-signedjar sbundle\&.jar bundle\&.jar jane\fR + .fi .if n \{\ .RE .\} .PP -入力JARファイル(bundle\&.jar)を署名付きJARファイルで上書きする場合、次のように\fI\-signedjar\fRオプションを指定する必要はありません。 +入力JARファイル(bundle\&.jar)を署名付きJARファイルで上書きする場合、次のように\fB\-signedjar\fRオプションを指定する必要はありません。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner bundle\&.jar jane +\fBjarsigner bundle\&.jar jane\fR + .fi .if n \{\ .RE @@ -971,66 +994,69 @@ .RS 4 .\} .nf -jarsigner \-verify sbundle\&.jar +\fBjarsigner \-verify sbundle\&.jar\fR + .fi .if n \{\ .RE .\} .PP -検証が成功すると、\fIjar verified\fRが表示されます。そうでない場合は、エラー・メッセージが表示されます。\fI\-verbose\fRオプションを使用すると、詳細情報を取得できます。\fIjarsigner\fRを\fI\-verbose\fRオプションとともに使用するサンプルを、次に示します。 +検証が成功すると、\fBjar verified\fRが表示されます。そうでない場合は、エラー・メッセージが表示されます。\fB\-verbose\fRオプションを使用すると、詳細情報を取得できます。\fBjarsigner\fRを\fB\-verbose\fRオプションとともに使用するサンプルを、次に示します。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-verify \-verbose sbundle\&.jar +\fBjarsigner \-verify \-verbose sbundle\&.jar\fR +\fB \fR +\fB 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST\&.MF\fR +\fB 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.SF\fR +\fB 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.DSA\fR +\fB smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx\&.class\fR +\fB smk 849 Fri Sep 26 16:12:46 PDT 1997 test\&.class\fR +\fB \fR +\fB s = signature was verified\fR +\fB m = entry is listed in manifest\fR +\fB k = at least one certificate was found in keystore\fR +\fB \fR +\fB jar verified\&.\fR - 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST\&.MF - 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.SF - 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.DSA - smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx\&.class - smk 849 Fri Sep 26 16:12:46 PDT 1997 test\&.class - - s = signature was verified - m = entry is listed in manifest - k = at least one certificate was found in keystore - - jar verified\&. .fi .if n \{\ .RE .\} .SS "証明書情報を使用した検証" .PP -\fI\-certs\fRオプションを\fI\-verify\fRおよび\fI\-verbose\fRオプションとともに指定した場合、JARファイルの各署名者の証明書情報が出力に含まれます。この情報には、証明書タイプ、署名者の識別名情報(X\&.509証明書の場合)が含まれ、丸カッコ内には、JARファイルの公開鍵証明書がキーストア・エントリの公開鍵証明書に一致する場合の署名者のキーストア別名が含まれます。たとえば、次のようになります。 +\fB\-certs\fRオプションを\fB\-verify\fRおよび\fB\-verbose\fRオプションとともに指定した場合、JARファイルの各署名者の証明書情報が出力に含まれます。この情報には、証明書タイプ、署名者の識別名情報(X\&.509証明書の場合)が含まれ、丸カッコ内には、JARファイルの公開鍵証明書がキーストア・エントリの公開鍵証明書に一致する場合の署名者のキーストア別名が含まれます。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest\&.jar - - 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST\&.MF - 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.SF - 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.DSA - 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST\&.SF - 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST\&.DSA - smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst\&.class +\fBjarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest\&.jar\fR +\fB \fR +\fB 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST\&.MF\fR +\fB 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.SF\fR +\fB 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.DSA\fR +\fB 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST\&.SF\fR +\fB 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST\&.DSA\fR +\fB smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst\&.class\fR +\fB \fR +\fB X\&.509, CN=Test Group, OU=Java Software, O=Oracle, L=CUP, S=CA, C=US (javatest)\fR +\fB X\&.509, CN=Jane Smith, OU=Java Software, O=Oracle, L=cup, S=ca, C=us (jane)\fR +\fB \fR +\fB s = signature was verified\fR +\fB m = entry is listed in manifest\fR +\fB k = at least one certificate was found in keystore\fR +\fB \fR +\fB jar verified\&.\fR - X\&.509, CN=Test Group, OU=Java Software, O=Oracle, L=CUP, S=CA, C=US (javatest) - X\&.509, CN=Jane Smith, OU=Java Software, O=Oracle, L=cup, S=ca, C=us (jane) - - s = signature was verified - m = entry is listed in manifest - k = at least one certificate was found in keystore - - jar verified\&. .fi .if n \{\ .RE .\} .PP -署名者の証明書がX\&.509証明書ではない場合、識別名情報は表示されません。その場合には、証明書のタイプと別名のみが表示されます。たとえば、証明書がPGP証明書で、別名が\fIbob\fRである場合、\fIPGP, (bob)\fRを取得します。 +署名者の証明書がX\&.509証明書ではない場合、識別名情報は表示されません。その場合には、証明書のタイプと別名のみが表示されます。たとえば、証明書がPGP証明書で、別名が\fBbob\fRである場合、\fBPGP, (bob)\fRを取得します。 .SH "関連項目" .sp .RS 4
--- a/src/solaris/doc/sun/man/man1/ja/java.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/java.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: java -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,8 +21,16 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 -.TH "java" "1" "2013年11月21日" "JDK 8" "基本ツール" +.\" Title: java +.\" Language: Japanese +.\" Date: 2014年8月8日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 +.TH "java" "1" "2014年8月8日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" java \- Javaアプリケーションを起動します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjava\fR [\fIoptions\fR] \fIclassname\fR [\fIargs\fR] +\fBjava\fR [\fIoptions\fR] \fIclassname\fR [\fIargs\fR] .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjava\fR [\fIoptions\fR] \fI\-jar\fR \fIfilename\fR [\fIargs\fR] +\fBjava\fR [\fIoptions\fR] \fB\-jar\fR \fIfilename\fR [\fIargs\fR] .fi .if n \{\ .RE @@ -74,7 +76,7 @@ .PP \fIoptions\fR .RS 4 -空白で区切られたコマンドライン・オプション。オプションを参照してください。 +空白で区切られたコマンド行オプション。オプションを参照してください。 .RE .PP \fIclassname\fR @@ -84,37 +86,38 @@ .PP \fIfilename\fR .RS 4 -呼び出されるJavaアーカイブ(JAR)ファイルの名前。\fI\-jar\fRオプションと一緒にのみ使用します。 +呼び出されるJavaアーカイブ(JAR)ファイルの名前。\fB\-jar\fRオプションと一緒にのみ使用します。 .RE .PP \fIargs\fR .RS 4 -空白で区切られた\fImain()\fRメソッドに渡される引数。 +空白で区切られた\fBmain()\fRメソッドに渡される引数。 .RE .SH "説明" .PP -\fIjava\fRコマンドはJavaアプリケーションを開始します。Java Runtime Environment (JRE)を起動した後、指定したクラスをロードし、そのクラスの\fImain()\fRメソッドを呼び出すことにより、これを行います。このメソッドは、\fIpublic\fRおよび\fIstatic\fRとして宣言する必要があります。また、値は返せません。さらに、\fIString\fR配列をパラメータとして指定できる必要があります。メソッド宣言は次の形式を含みます。 +\fBjava\fRコマンドはJavaアプリケーションを開始します。Java Runtime Environment (JRE)を起動した後、指定したクラスをロードし、そのクラスの\fBmain()\fRメソッドを呼び出すことにより、これを行います。このメソッドは、\fIpublic\fRおよび\fIstatic\fRとして宣言する必要があります。また、値は返せません。さらに、\fBString\fR配列をパラメータとして指定できる必要があります。メソッド宣言は次の形式を含みます。 .sp .if n \{\ .RS 4 .\} .nf -public static void main(String[] args) +\fBpublic static void main(String[] args)\fR + .fi .if n \{\ .RE .\} .PP -\fIjava\fRコマンドを使用して、\fImain()\fRメソッドがあるか\fIjavafx\&.application\&.Application\fRを拡張するクラスをロードすることで、JavaFXアプリケーションを起動できます。後者の場合、起動ツールは\fIApplication\fRクラスのインスタンスを構成し、その\fIinit()\fRメソッドをコールし、\fIstart(javafx\&.stage\&.Stage)\fRメソッドをコールします。 +\fBjava\fRコマンドを使用して、\fBmain()\fRメソッドがあるか\fBjavafx\&.application\&.Application\fRを拡張するクラスをロードすることで、JavaFXアプリケーションを起動できます。後者の場合、起動ツールは\fBApplication\fRクラスのインスタンスを構成し、その\fBinit()\fRメソッドをコールし、\fBstart(javafx\&.stage\&.Stage)\fRメソッドをコールします。 .PP -デフォルトでは、\fIjava\fRコマンドのオプションではない最初の引数は、呼び出されるクラスの完全修飾名です。\fI\-jar\fRオプションを指定した場合、その引数は、アプリケーションのクラス・ファイルとリソース・ファイルを含むJARファイルの名前になります。起動クラスは、ソース・コードの\fIMain\-Class\fRマニフェスト・ヘッダーによって指定される必要があります。 +デフォルトでは、\fBjava\fRコマンドのオプションではない最初の引数は、呼び出されるクラスの完全修飾名です。\fB\-jar\fRオプションを指定した場合、その引数は、アプリケーションのクラス・ファイルとリソース・ファイルを含むJARファイルの名前になります。起動クラスは、ソース・コードの\fBMain\-Class\fRマニフェスト・ヘッダーによって指定される必要があります。 .PP JREは、ブートストラップ・クラス・パス、インストール済拡張機能およびユーザーのクラス・パスの3箇所から、起動クラス(およびアプリケーションで使用されている他のクラス)を検索します。 .PP -クラス・ファイル名またはJARファイル名の後の引数は、\fImain()\fRメソッドに渡されます。 +クラス・ファイル名またはJARファイル名の後の引数は、\fBmain()\fRメソッドに渡されます。 .SH "オプション" .PP -\fIjava\fRコマンドは、次のカテゴリに分類できる広範なオプションをサポートしています。 +\fBjava\fRコマンドは、次のカテゴリに分類できる広範なオプションをサポートしています。 .sp .RS 4 .ie n \{\ @@ -184,15 +187,15 @@ .PP 標準のオプションは、Java Virtual Machine (JVM)のすべての実装でサポートすることが保証されます。これらは、JREのバージョンの確認、クラス・パスの設定、冗長な出力の有効化などの一般的なアクションに使用されます。 .PP -標準以外のオプションは、Java HotSpot仮想マシンに固有の汎用オプションであるため、すべてのJVM実装でサポートされることは保証されず、変更される可能性があります。これらのオプションは\fI\-X\fRで開始します。 +標準以外のオプションは、Java HotSpot仮想マシンに固有の汎用オプションであるため、すべてのJVM実装でサポートされることは保証されず、変更される可能性があります。これらのオプションは\fB\-X\fRで開始します。 .PP -拡張オプションは、不用意に使用しないことをお薦めします。これらは、特定のシステム要件を持つことが多く、システム構成パラメータへの特権アクセスが必要な場合があるJava HotSpot仮想マシン操作の特定の領域を調整するために使用される開発者オプションです。これらは、すべてのJVM実装でサポートされることは保証されず、変更される可能性があります。拡張オプションは\fI\-XX\fRで始まります。 +拡張オプションは、不用意に使用しないことをお薦めします。これらは、特定のシステム要件を持つことが多く、システム構成パラメータへの特権アクセスが必要な場合があるJava HotSpot仮想マシン操作の特定の領域を調整するために使用される開発者オプションです。これらは、すべてのJVM実装でサポートされることは保証されず、変更される可能性があります。拡張オプションは\fB\-XX\fRで始まります。 .PP 最新リリースで非推奨または削除されるオプションを追跡するために、ドキュメントの最後に非推奨で削除されたオプションという名前のセクションがあります。 .PP -ブール・オプションは、デフォルトで無効になっている機能を有効にしたり、デフォルトで有効になっている機能を無効にするために使用されます。このようなオプションは、パラメータを必要としません。ブール値\fI\-XX\fRオプションは、プラス記号(\fI\-XX:+\fR\fIOptionName\fR)を使用して有効にし、マイナス記号(\fI\-XX:\-\fR\fIOptionName\fR)を使用して無効にします。 +ブール・オプションは、デフォルトで無効になっている機能を有効にしたり、デフォルトで有効になっている機能を無効にするために使用されます。このようなオプションは、パラメータを必要としません。ブール値\fB\-XX\fRオプションは、プラス記号(\fB\-XX:+\fR\fIOptionName\fR)を使用して有効にし、マイナス記号(\fB\-XX:\-\fR\fIOptionName\fR)を使用して無効にします。 .PP -引数が必要なオプションの場合、引数は、オプション名を空白、コロン(:)または等号(=)で区切ったものになるか、あるいは引数がオプションの後に直接続く場合もあります(正確な構文は各オプションによって異なります)。サイズをバイト単位で指定するよう求められている場合、接尾辞を使用しないか、あるいはキロバイト(KB)には接尾辞\fIk\fRまたは\fIK\fR、メガバイト(MB)には接尾辞\fIm\fRまたは\fIM\fR、ギガバイト(GB)には接尾辞\fIg\fRまたは\fIG\fRを使用します。たとえば、サイズを8GBに設定するには、\fI8g\fR、\fI8192m\fR、\fI8388608k\fRまたは\fI8589934592\fRのいずれかを引数として指定できます。パーセントの指定が必要な場合は、0から1の数値を使用します(たとえば、25%の場合は\fI0\&.25\fRを指定します)。 +引数が必要なオプションの場合、引数は、オプション名を空白、コロン(:)または等号(=)で区切ったものになるか、あるいは引数がオプションの後に直接続く場合もあります(正確な構文は各オプションによって異なります)。サイズをバイト単位で指定するよう求められている場合、接尾辞を使用しないか、あるいはキロバイト(KB)には接尾辞\fBk\fRまたは\fBK\fR、メガバイト(MB)には接尾辞\fBm\fRまたは\fBM\fR、ギガバイト(GB)には接尾辞\fBg\fRまたは\fBG\fRを使用します。たとえば、サイズを8GBに設定するには、\fB8g\fR、\fB8192m\fR、\fB8388608k\fRまたは\fB8589934592\fRのいずれかを引数として指定できます。パーセントの指定が必要な場合は、0から1の数値を使用します(たとえば、25%の場合は\fB0\&.25\fRを指定します)。 .SS "標準オプション" .PP これらは、JVMのすべての実装でサポートされる最も一般的に使用されるオプションです。 @@ -201,7 +204,7 @@ .RS 4 指定したネイティブ・エージェント・ライブラリをロードします。ライブラリ名の後に、ライブラリに固有のオプションのカンマ区切りリストを使用できます。 .sp -オプション\fI\-agentlib:foo\fRを指定した場合、JVMは、\fILD_LIBRARY_PATH\fRシステム変数(OS Xでは、この変数は\fIDYLD_LIBRARY_PATH\fRになります)で指定された場所に\fIlibfoo\&.so\fRという名前のライブラリをロードしようとします。 +オプション\fB\-agentlib:foo\fRを指定した場合、JVMは、\fBLD_LIBRARY_PATH\fRシステム変数(OS Xでは、この変数は\fBDYLD_LIBRARY_PATH\fRになります)で指定された場所に\fBlibfoo\&.so\fRという名前のライブラリをロードしようとします。 .sp 次の例では、スタックの深さ3で、20ミリ秒ごとにヒープ・プロファイリング・ツール(HPROF)ライブラリをロードして、サンプルのCPU情報を取得する方法を示します。 .sp @@ -209,7 +212,8 @@ .RS 4 .\} .nf -\-agentlib:hprof=cpu=samples,interval=20,depth=3 +\fB\-agentlib:hprof=cpu=samples,interval=20,depth=3\fR + .fi .if n \{\ .RE @@ -220,7 +224,8 @@ .RS 4 .\} .nf -\-agentlib:jdwp=transport=dt_socket,server=y,address=8000 +\fB\-agentlib:jdwp=transport=dt_socket,server=y,address=8000\fR + .fi .if n \{\ .RE @@ -235,7 +240,7 @@ .sp -1 .IP \(bu 2.3 .\} -http://docs\&.oracle\&.com/javase/8/docs/api/java/lang/instrument/package\-summary\&.htmlにある\fIjava\&.lang\&.instrument\fRパッケージの説明 +http://docs\&.oracle\&.com/javase/8/docs/api/java/lang/instrument/package\-summary\&.htmlにある\fBjava\&.lang\&.instrument\fRパッケージの説明 .RE .sp .RS 4 @@ -246,13 +251,13 @@ .sp -1 .IP \(bu 2.3 .\} -http://docs\&.oracle\&.com/javase/8/docs/platform/jvmti/jvmti\&.html#startingにあるJVMツール・インタフェース・ガイドのエージェントのコマンドライン・オプションに関する項 +http://docs\&.oracle\&.com/javase/8/docs/platform/jvmti/jvmti\&.html#startingにあるJVMツール・インタフェース・ガイドのエージェントのコマンド行オプションに関する項 .RE .RE .PP \-agentpath:\fIpathname\fR[=\fIoptions\fR] .RS 4 -絶対パス名で指定されたネイティブ・エージェント・ライブラリをロードします。このオプションは\fI\-agentlib\fRと同等ですが、ライブラリのフル・パスおよびファイル名を使用します。 +絶対パス名で指定されたネイティブ・エージェント・ライブラリをロードします。このオプションは\fB\-agentlib\fRと同等ですが、ライブラリのフル・パスおよびファイル名を使用します。 .RE .PP \-client @@ -266,7 +271,7 @@ \-D\fIproperty\fR=\fIvalue\fR .RS 4 システム・プロパティの値を設定します。\fIproperty\fR変数は、プロパティの名前を表す、空白のない文字列です。\fIvalue\fR変数は、プロパティの値を表す文字列です。\fIvalue\fRが空白を含む文字列の場合、それを引用符で囲みます(例: -\fI\-Dfoo="foo bar"\fR)。 +\fB\-Dfoo="foo bar"\fR)。 .RE .PP \-d32 @@ -278,79 +283,91 @@ .RS 4 アプリケーションを64ビット環境で実行します。64ビット環境がインストールされていないかサポートされていない場合は、エラーが報告されます。デフォルトでは、64ビット・システムが使用されている場合を除き、アプリケーションは32ビット環境で実行されます。 .sp -現在のところ、Java HotSpot Server VMのみが64ビットの操作をサポートしているため、\fI\-d64\fR使用時には\fI\-server\fRオプションが暗黙的に使用されます。\fI\-d64\fR使用時には、\fI\-client\fRオプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。 +現在のところ、Java HotSpot Server VMのみが64ビットの操作をサポートしているため、\fB\-d64\fR使用時には\fB\-server\fRオプションが暗黙的に使用されます。\fB\-d64\fR使用時には、\fB\-client\fRオプションは無視されます。この仕様は、将来のリリースでは変更になる可能性があります。 .RE .PP -\-disableassertions[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR], \-da[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] +\-disableassertions[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] +.br +\-da[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] .RS 4 アサーションを無効にします。デフォルトでは、アサーションはすべてのパッケージおよびクラスで無効になっています。 .sp -引数なしの\fI\-disableassertions\fR -(\fI\-da\fR)を指定すると、すべてのパッケージおよびクラスでアサーションが無効になります。\fI\&.\&.\&.\fRで終わる\fIpackagename\fR引数を指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として\fI\&.\&.\&.\fRのみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。\fIclassname\fR引数を指定すると、切替えによって、指定したクラス内でアサーションが無効になります。 +引数なしの\fB\-disableassertions\fR +(\fB\-da\fR)を指定すると、すべてのパッケージおよびクラスでアサーションが無効になります。\fB\&.\&.\&.\fRで終わる\fIpackagename\fR引数を指定すると、指定したパッケージとそのサブパッケージ内でアサーションが無効になります。引数として\fB\&.\&.\&.\fRのみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが無効になります。\fIclassname\fR引数を指定すると、切替えによって、指定したクラス内でアサーションが無効になります。 .sp -\fI\-disableassertions\fR -(\fI\-da\fR)オプションは、すべてのクラス・ローダーおよびシステム・クラスに適用されます(システム・クラスにはクラス・ローダーはありません)。このルールには1つ例外があります。オプションの引数が指定されていない場合は、システム・クラスに適用されません。これにより、システム・クラスを除くすべてのクラスでアサーションを簡単に無効にすることができます。\fI\-disablesystemassertions\fRオプションを使用すると、すべてのシステム・クラスでアサーションを無効にすることができます。 +\fB\-disableassertions\fR +(\fB\-da\fR)オプションは、すべてのクラス・ローダーおよびシステム・クラスに適用されます(システム・クラスにはクラス・ローダーはありません)。このルールには1つ例外があります。オプションの引数が指定されていない場合は、システム・クラスに適用されません。これにより、システム・クラスを除くすべてのクラスでアサーションを簡単に無効にすることができます。\fB\-disablesystemassertions\fRオプションを使用すると、すべてのシステム・クラスでアサーションを無効にすることができます。 .sp -特定のパッケージやクラスでアサーションを明示的に有効にするには、\fI\-enableassertions\fR -(\fI\-ea\fR)オプションを使用します。両方のオプションを同時に使用できます。たとえば、パッケージ\fIcom\&.wombat\&.fruitbat\fR -(およびそのサブパッケージ)ではアサーションを有効にして、クラス\fIcom\&.wombat\&.fruitbat\&.Brickbat\fRではアサーションを無効にして、\fIMyClass\fRアプリケーションを実行するには、次のコマンドを使用します。 +特定のパッケージやクラスでアサーションを明示的に有効にするには、\fB\-enableassertions\fR +(\fB\-ea\fR)オプションを使用します。両方のオプションを同時に使用できます。たとえば、パッケージ\fBcom\&.wombat\&.fruitbat\fR +(およびそのサブパッケージ)ではアサーションを有効にして、クラス\fBcom\&.wombat\&.fruitbat\&.Brickbat\fRではアサーションを無効にして、\fBMyClass\fRアプリケーションを実行するには、次のコマンドを使用します。 .sp .if n \{\ .RS 4 .\} .nf -java \-ea:com\&.wombat\&.fruitbat\&.\&.\&. \-da:com\&.wombat\&.fruitbat\&.Brickbat MyClass +\fBjava \-ea:com\&.wombat\&.fruitbat\&.\&.\&. \-da:com\&.wombat\&.fruitbat\&.Brickbat MyClass\fR + .fi .if n \{\ .RE .\} .RE .PP -\-disablesystemassertions, \-dsa +\-disablesystemassertions +.br +\-dsa .RS 4 すべてのシステム・クラス内でアサーションを無効にします。 .RE .PP -\-enableassertions[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR], \-ea[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] +\-enableassertions[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] +.br +\-ea[:[\fIpackagename\fR]\&.\&.\&.|:\fIclassname\fR] .RS 4 アサーションを有効にします。デフォルトでは、アサーションはすべてのパッケージおよびクラスで無効になっています。 .sp -引数なしの\fI\-enableassertions\fR -(\fI\-ea\fR)を指定すると、すべてのパッケージおよびクラスでアサーションが有効になります。\fI\&.\&.\&.\fRで終わる\fIpackagename\fR引数を指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として\fI\&.\&.\&.\fRのみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。\fIclassname\fR引数を指定すると、切替えによって、指定したクラス内でアサーションが有効になります。 +引数なしの\fB\-enableassertions\fR +(\fB\-ea\fR)を指定すると、すべてのパッケージおよびクラスでアサーションが有効になります。\fB\&.\&.\&.\fRで終わる\fIpackagename\fR引数を指定すると、指定したパッケージとそのサブパッケージ内でアサーションが有効になります。引数として\fB\&.\&.\&.\fRのみを指定すると、現在の作業ディレクトリにある名前のないパッケージ内でアサーションが有効になります。\fIclassname\fR引数を指定すると、切替えによって、指定したクラス内でアサーションが有効になります。 .sp -\fI\-enableassertions\fR -(\fI\-ea\fR)オプションは、すべてのクラス・ローダーおよびシステム・クラスに適用されます(システム・クラスにはクラス・ローダーはありません)。このルールには1つ例外があります。オプションの引数が指定されていない場合は、システム・クラスに適用されません。これにより、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。\fI\-enablesystemassertions\fRオプションは、すべてのシステム・クラスでアサーションを有効にする別のスイッチを提供します。 +\fB\-enableassertions\fR +(\fB\-ea\fR)オプションは、すべてのクラス・ローダーおよびシステム・クラスに適用されます(システム・クラスにはクラス・ローダーはありません)。このルールには1つ例外があります。オプションの引数が指定されていない場合は、システム・クラスに適用されません。これにより、システム・クラスを除くすべてのクラスでアサーションを簡単に有効にすることができます。\fB\-enablesystemassertions\fRオプションは、すべてのシステム・クラスでアサーションを有効にする別のスイッチを提供します。 .sp -特定のパッケージやクラスでアサーションを明示的に無効にするには、\fI\-disableassertions\fR -(\fI\-da\fR)オプションを使用します。単一コマンドにこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。たとえば、パッケージ\fIcom\&.wombat\&.fruitbat\fR -(およびそのサブパッケージ)でのみアサーションを有効にして、クラス\fIcom\&.wombat\&.fruitbat\&.Brickbat\fRではアサーションを無効にして、\fIMyClass\fRアプリケーションを実行するには、次のコマンドを使用します。 +特定のパッケージやクラスでアサーションを明示的に無効にするには、\fB\-disableassertions\fR +(\fB\-da\fR)オプションを使用します。単一コマンドにこれらのスイッチのインスタンスを複数指定した場合は、指定したスイッチが順番に処理されてからクラスがロードされます。たとえば、パッケージ\fBcom\&.wombat\&.fruitbat\fR +(およびそのサブパッケージ)でのみアサーションを有効にして、クラス\fBcom\&.wombat\&.fruitbat\&.Brickbat\fRではアサーションを無効にして、\fBMyClass\fRアプリケーションを実行するには、次のコマンドを使用します。 .sp .if n \{\ .RS 4 .\} .nf -java \-ea:com\&.wombat\&.fruitbat\&.\&.\&. \-da:com\&.wombat\&.fruitbat\&.Brickbat MyClass +\fBjava \-ea:com\&.wombat\&.fruitbat\&.\&.\&. \-da:com\&.wombat\&.fruitbat\&.Brickbat MyClass\fR + .fi .if n \{\ .RE .\} .RE .PP -\-enablesystemassertions, \-esa +\-enablesystemassertions +.br +\-esa .RS 4 すべてのシステム・クラス内でアサーションを有効にします。 .RE .PP -\-help, \-? +\-help +.br +\-? .RS 4 -実際にJVMを実行せずに、\fIjava\fRコマンドの使用状況情報を表示します。 +実際にJVMを実行せずに、\fBjava\fRコマンドの使用状況情報を表示します。 .RE .PP \-jar \fIfilename\fR .RS 4 -JARファイルにカプセル化されたプログラムを実行します。\fIfilename\fR引数は、使用するアプリケーションの開始点として機能する\fIpublic static void main(String[] args)\fRメソッドを定義する、\fIMain\-Class:\fR\fIclassname\fRという形式の1行を含むマニフェストを持つJARファイルの名前です。 +JARファイルにカプセル化されたプログラムを実行します。\fIfilename\fR引数は、使用するアプリケーションの開始点として機能する\fBpublic static void main(String[] args)\fRメソッドを定義する、\fBMain\-Class:\fR\fIclassname\fRという形式の1行を含むマニフェストを持つJARファイルの名前です。 .sp -\fI\-jar\fRオプションを使用すると、指定したJARファイルがすべてのユーザー・クラスのソースになり、クラス・パスの他の設定は無視されます。 +\fB\-jar\fRオプションを使用すると、指定したJARファイルがすべてのユーザー・クラスのソースになり、クラス・パスの他の設定は無視されます。 .sp JARファイルの詳細は、次のリソースを参照してください。 .sp @@ -391,7 +408,7 @@ .PP \-javaagent:\fIjarpath\fR[=\fIoptions\fR] .RS 4 -指定したJavaプログラミング言語エージェントをロードします。Javaアプリケーションのインストゥルメントの詳細は、http://docs\&.oracle\&.com/javase/8/docs/api/java/lang/instrument/package\-summary\&.htmlにあるJava APIドキュメントの\fIjava\&.lang\&.instrument\fRパッケージの説明を参照してください。 +指定したJavaプログラミング言語エージェントをロードします。Javaアプリケーションのインストゥルメントの詳細は、http://docs\&.oracle\&.com/javase/8/docs/api/java/lang/instrument/package\-summary\&.htmlにあるJava APIドキュメントの\fBjava\&.lang\&.instrument\fRパッケージの説明を参照してください。 .RE .PP \-jre\-restrict\-search @@ -414,18 +431,19 @@ .PP \-showversion .RS 4 -バージョン情報を表示し、アプリケーションの実行を続行します。このオプションは\fI\-version\fRオプションと同等ですが、\-versionはバージョン情報の表示後にJVMに終了を指示する点が異なります。 +バージョン情報を表示し、アプリケーションの実行を続行します。このオプションは\fB\-version\fRオプションと同等ですが、\-versionはバージョン情報の表示後にJVMに終了を指示する点が異なります。 .RE .PP \-splash:\fIimgname\fR .RS 4 -\fIimgname\fRで指定されたイメージを含むスプラッシュ画面を表示します。たとえば、アプリケーションの起動時に\fIimages\fRディレクトリの\fIsplash\&.gif\fRファイルを表示するには、次のオプションを使用します。 +\fIimgname\fRで指定されたイメージを含むスプラッシュ画面を表示します。たとえば、アプリケーションの起動時に\fBimages\fRディレクトリの\fBsplash\&.gif\fRファイルを表示するには、次のオプションを使用します。 .sp .if n \{\ .RS 4 .\} .nf -\-splash:images/splash\&.gif +\fB\-splash:images/splash\&.gif\fR + .fi .if n \{\ .RE @@ -449,29 +467,30 @@ .PP \-version .RS 4 -バージョン情報を表示してから終了します。このオプションは\fI\-showversion\fRオプションと同等ですが、\-showversionはバージョン情報の表示後にJVMに終了を指示しない点が異なります。 +バージョン情報を表示してから終了します。このオプションは\fB\-showversion\fRオプションと同等ですが、\-showversionはバージョン情報の表示後にJVMに終了を指示しない点が異なります。 .RE .PP \-version:\fIrelease\fR .RS 4 -アプリケーションの実行に使用するリリース・バージョンを指定します。コールされた\fIjava\fRコマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。 +アプリケーションの実行に使用するリリース・バージョンを指定します。コールされた\fBjava\fRコマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。 .sp \fIrelease\fR引数は、正確なバージョン文字列、または空白で区切られたバージョン文字列とバージョン範囲のリストを指定します。\fIバージョン文字列\fRは、次の形式で、開発者のバージョン番号を指定します: -\fI1\&.\fR\fIx\fR\fI\&.0_\fR\fIu\fR -(\fIx\fRはメジャー・バージョン番号、\fIu\fRは更新バージョン番号です)。\fIバージョン範囲\fRは、このバージョン以降を指定するにはバージョン文字列の後にプラス記号(\fI+\fR)を続けたもの、または一致する接頭辞を含む任意のバージョン文字列を指定するには一部のバージョン文字列の後にアスタリスク(\fI*\fR)を続けたもので構成されます。論理\fIOR\fRの組合せには空白、2つのバージョンの文字列/範囲の論理\fIAND\fRの組合せにはアンパサンド(\fI&\fR)を使用して、バージョン文字列とバージョン範囲を組み合せることができます。たとえば、クラスまたはJARファイルの実行にJRE 6u13 (1\&.6\&.0_13)または6u10 (1\&.6\&.0_10)以降の任意のJRE 6のいずれかを必要とする場合、次を指定します。 +\fB1\&.\fR\fIx\fR\fB\&.0_\fR\fIu\fR +(\fIx\fRはメジャー・バージョン番号、\fIu\fRは更新バージョン番号です)。\fIバージョン範囲\fRは、このバージョン以降を指定するにはバージョン文字列の後にプラス記号(\fB+\fR)を続けたもの、または一致する接頭辞を含む任意のバージョン文字列を指定するには一部のバージョン文字列の後にアスタリスク(\fB*\fR)を続けたもので構成されます。論理\fIOR\fRの組合せには空白、2つのバージョンの文字列/範囲の論理\fIAND\fRの組合せにはアンパサンド(\fB&\fR)を使用して、バージョン文字列とバージョン範囲を組み合せることができます。たとえば、クラスまたはJARファイルの実行にJRE 6u13 (1\&.6\&.0_13)または6u10 (1\&.6\&.0_10)以降の任意のJRE 6のいずれかを必要とする場合、次を指定します。 .sp .if n \{\ .RS 4 .\} .nf -\-version:"1\&.6\&.0_13 1\&.6* & 1\&.6\&.0_10+" +\fB\-version:"1\&.6\&.0_13 1\&.6* & 1\&.6\&.0_10+"\fR + .fi .if n \{\ .RE .\} 引用符が必要なのは、\fIrelease\fRパラメータに空白がある場合のみです。 .sp -JARファイルの場合は、バージョン要件をコマンドラインに指定するよりも、JARファイルのマニフェスト内に指定することが推奨されています。 +JARファイルの場合は、バージョン要件をコマンド行に指定するよりも、JARファイルのマニフェスト内に指定することが推奨されています。 .RE .SS "非標準オプション" .PP @@ -479,40 +498,35 @@ .PP \-X .RS 4 -使用可能なすべての\fI\-X\fRオプションのヘルプを表示します。 +使用可能なすべての\fB\-X\fRオプションのヘルプを表示します。 .RE .PP \-Xbatch .RS 4 -バックグラウンド・コンパイルを無効にします。デフォルトでは、JVMでは、バックグラウンド・コンパイルが終了するまで、メソッドをバックグラウンド・タスクとしてコンパイルし、インタプリタ・モードでメソッドを実行します。\fI\-Xbatch\fRフラグを指定すると、バックグラウンド・コンパイルが無効になり、すべてのメソッドのコンパイルが完了するまでフォアグラウンド・タスクとして処理されます。 +バックグラウンド・コンパイルを無効にします。デフォルトでは、JVMでは、バックグラウンド・コンパイルが終了するまで、メソッドをバックグラウンド・タスクとしてコンパイルし、インタプリタ・モードでメソッドを実行します。\fB\-Xbatch\fRフラグを指定すると、バックグラウンド・コンパイルが無効になり、すべてのメソッドのコンパイルが完了するまでフォアグラウンド・タスクとして処理されます。 .sp -このオプションは\fI\-XX:\-BackgroundCompilation\fRと同等です。 +このオプションは\fB\-XX:\-BackgroundCompilation\fRと同等です。 .RE .PP \-Xbootclasspath:\fIpath\fR .RS 4 ブート・クラス・ファイルを検索するディレクトリ、JARファイルおよびZIPアーカイブの、コロン(:)で区切られたリストを指定します。これらは、JDKに含まれるブート・クラス・ファイルのかわりに使用されます。 .sp -JREバイナリ・コード・ライセンスに違反するため、\fIrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 +JREバイナリ・コード・ライセンスに違反するため、\fBrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 .RE .PP \-Xbootclasspath/a:\fIpath\fR .RS 4 デフォルトのブートストラップ・クラス・パスの最後に追加するディレクトリ、JARファイルおよびZIPアーカイブの、コロン(:)で区切られたリストを指定します。 .sp -JREバイナリ・コード・ライセンスに違反するため、\fIrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 +JREバイナリ・コード・ライセンスに違反するため、\fBrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 .RE .PP \-Xbootclasspath/p:\fIpath\fR .RS 4 デフォルトのブートストラップ・クラス・パスの先頭に追加するディレクトリ、JARファイルおよびZIPアーカイブの、コロン(:)で区切られたリストを指定します。 .sp -JREバイナリ・コード・ライセンスに違反するため、\fIrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 -.RE -.PP -\-Xboundthreads -.RS 4 -ユーザー・レベルのスレッドをカーネル・スレッドにバインドします。 +JREバイナリ・コード・ライセンスに違反するため、\fBrt\&.jar\fRでクラスをオーバーライドする目的で、このオプションを使用するアプリケーションをデプロイしないでください。 .RE .PP \-Xcheck:jni @@ -522,14 +536,14 @@ .PP \-Xcomp .RS 4 -最初の呼出しでJavaコードおよびコンパイル・メソッドの解釈を無効にします。デフォルトでは、JITコンパイラは、10,000の解釈されたメソッド呼出しを実行して、効率的なコンパイルのための情報を収集します。効率を犠牲にしてコンパイルのパフォーマンスを向上させるには、\fI\-Xcomp\fRフラグを使用して、解釈されたメソッド呼出しを無効にします。 +最初の呼出しでメソッドのコンパイルを強制的に実行します。デフォルトでは、クライアントVM(\fB\-client\fR)は1,000の解釈されたメソッド呼出しを実行し、サーバーVM(\fB\-server\fR)は10,000の解釈されたメソッド呼出しを実行して、効率的なコンパイルのための情報を収集します。\fB\-Xcomp\fRオプションを指定すると、解釈されたメソッド呼出しが無効になり、効率を犠牲にしてコンパイルのパフォーマンスが向上します。 .sp -\fI\-XX:CompileThreshold\fRオプションを使用して、コンパイルの前に、解釈されたメソッド呼出しの数を変更することもできます。 +\fB\-XX:CompileThreshold\fRオプションを使用して、コンパイルの前に、解釈されたメソッド呼出しの数を変更することもできます。 .RE .PP \-Xdebug .RS 4 -何も行いません。下位互換性のために用意されています。 +何も行いません。後方互換性のために用意されています。 .RE .PP \-Xdiag @@ -542,11 +556,6 @@ クラス・ファイル形式の仕様への準拠を強化する、厳密なクラス・ファイル形式のチェックが有効になります。将来のリリースでは、より厳密なチェックがデフォルトになるため、新しいコードを開発するときには、開発者はこのフラグを使用することをお薦めします。 .RE .PP -\-Xincgc -.RS 4 -増分GCを有効にします。 -.RE -.PP \-Xint .RS 4 インタプリタ専用モードでアプリケーションを実行します。ネイティブ・コードへのコンパイルは無効になり、すべてのバイトコードがインタプリタによって実行されます。ジャスト・イン・タイム(JIT)コンパイラが提供するパフォーマンス上の利点は、このモードでは実現されません。 @@ -554,12 +563,12 @@ .PP \-Xinternalversion .RS 4 -\fI\-version\fRオプションより詳細なJVMバージョン情報を表示してから終了します。 +\fB\-version\fRオプションより詳細なJVMバージョン情報を表示してから終了します。 .RE .PP \-Xloggc:\fIfilename\fR .RS 4 -詳細なGCイベント情報をロギング用にリダイレクトするファイルを設定します。このファイルに書き込まれる情報は、記録された各イベントの前に行われる最初のGCイベント以降に経過した時間を指定した\fI\-verbose:gc\fRの出力と類似しています。\fI\-Xloggc\fRオプションは\fI\-verbose:gc\fRをオーバーライドします(これらの両方が同じ\fIjava\fRコマンドで指定された場合)。 +詳細なGCイベント情報をロギング用にリダイレクトするファイルを設定します。このファイルに書き込まれる情報は、記録された各イベントの前に行われる最初のGCイベント以降に経過した時間を指定した\fB\-verbose:gc\fRの出力と類似しています。\fB\-Xloggc\fRオプションは\fB\-verbose:gc\fRをオーバーライドします(これらの両方が同じ\fBjava\fRコマンドで指定された場合)。 .sp 例: .sp @@ -567,7 +576,8 @@ .RS 4 .\} .nf -\-Xloggc:garbage\-collection\&.log +\fB\-Xloggc:garbage\-collection\&.log\fR + .fi .if n \{\ .RE @@ -576,18 +586,19 @@ .PP \-Xmaxjitcodesize=\fIsize\fR .RS 4 -JITコンパイルされたコードの最大コード・キャッシュ・サイズ(バイト単位)を指定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、この値は48MBに設定されています。 +JITコンパイルされたコードの最大コード・キャッシュ・サイズ(バイト単位)を指定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、この値は48MBに設定されています。 .sp .if n \{\ .RS 4 .\} .nf -\-Xmaxjitcodesize=48m +\fB\-Xmaxjitcodesize=48m\fR + .fi .if n \{\ .RE .\} -このオプションは\fI\-XX:ReservedCodeCacheSize\fRと同等です。 +このオプションは\fB\-XX:ReservedCodeCacheSize\fRと同等です。 .RE .PP \-Xmixed @@ -597,7 +608,7 @@ .PP \-Xmn\fIsize\fR .RS 4 -若い世代(ナーサリ)のヒープの初期サイズおよび最大サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。 +若い世代(ナーサリ)のヒープの初期サイズおよび最大サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。 .sp ヒープの若い世代リージョンは新しいオブジェクトに使用されます。GCは、他のリージョンよりこのリージョンで、より頻繁に実行されます。若い世代のサイズが小さすぎる場合、多数のマイナー・ガベージ・コレクションが実行されます。サイズが大きすぎる場合、フル・ガベージ・コレクションのみが実行されますが、完了までに時間がかかることがあります。若い世代のサイズは、全体のヒープ・サイズの半分から4分の1の間にしておくことをお薦めします。 .sp @@ -607,19 +618,20 @@ .RS 4 .\} .nf -\-Xmn256m -\-Xmn262144k -\-Xmn268435456 +\fB\-Xmn256m\fR +\fB\-Xmn262144k\fR +\fB\-Xmn268435456\fR + .fi .if n \{\ .RE .\} -若い世代のヒープの初期サイズと最大サイズの両方を設定する\fI\-Xmn\fRオプションのかわりに、初期サイズの設定には\fI\-XX:NewSize\fRを、最大サイズの設定には\fI\-XX:MaxNewSize\fRを使用できます。 +若い世代のヒープの初期サイズと最大サイズの両方を設定する\fB\-Xmn\fRオプションのかわりに、初期サイズの設定には\fB\-XX:NewSize\fRを、最大サイズの設定には\fB\-XX:MaxNewSize\fRを使用できます。 .RE .PP \-Xms\fIsize\fR .RS 4 -ヒープの初期サイズ(バイト単位)を設定します。指定する値は、1MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。 +ヒープの初期サイズ(バイト単位)を設定します。指定する値は、1MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。 .sp 次の例では、割り当てられたメモリーのサイズを様々な単位を使用して6MBに設定する方法を示します。 .sp @@ -627,19 +639,20 @@ .RS 4 .\} .nf -\-Xms6291456 -\-Xms6144k -\-Xms6m +\fB\-Xms6291456\fR +\fB\-Xms6144k\fR +\fB\-Xms6m\fR + .fi .if n \{\ .RE .\} -このオプションを設定しない場合、初期サイズは、古い世代と若い世代に割り当てられたサイズの合計として設定されます。若い世代のヒープの初期サイズは、\fI\-Xmn\fRオプションまたは\fI\-XX:NewSize\fRオプションを使用して設定できます。 +このオプションを設定しない場合、初期サイズは、古い世代と若い世代に割り当てられたサイズの合計として設定されます。若い世代のヒープの初期サイズは、\fB\-Xmn\fRオプションまたは\fB\-XX:NewSize\fRオプションを使用して設定できます。 .RE .PP \-Xmx\fIsize\fR .RS 4 -メモリー割当てプールの最大サイズ(バイト単位)を指定します。指定する値は、2MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。サーバー・デプロイメントでは、\fI\-Xms\fRおよび\fI\-Xmx\fRは通常同じ値に設定されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 +メモリー割当てプールの最大サイズ(バイト単位)を指定します。指定する値は、2MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。サーバー・デプロイメントでは、\fB\-Xms\fRおよび\fB\-Xmx\fRは通常同じ値に設定されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 .sp 次の例では、割り当てられたメモリーの許可される最大サイズを様々な単位を使用して80MBに設定する方法を示します。 .sp @@ -647,26 +660,27 @@ .RS 4 .\} .nf -\-Xmx83886080 -\-Xmx81920k -\-Xmx80m +\fB\-Xmx83886080\fR +\fB\-Xmx81920k\fR +\fB\-Xmx80m\fR + .fi .if n \{\ .RE .\} -\fI\-Xmx\fRオプションは\fI\-XX:MaxHeapSize\fRと同等です。 +\fB\-Xmx\fRオプションは\fB\-XX:MaxHeapSize\fRと同等です。 .RE .PP \-Xnoclassgc .RS 4 クラスのガベージ・コレクション(GC)を無効にします。これにより、GC時間を節約でき、アプリケーション実行中の中断が短縮されます。 .sp -起動時に\fI\-Xnoclassgc\fRを指定すると、アプリケーション内のクラス・オブジェクトは、GCの間はそのまま残り、常にライブであるとみなされます。これにより、より多くのメモリーが永久に占有されることになり、注意して使用しないと、メモリー不足の例外がスローされます。 +起動時に\fB\-Xnoclassgc\fRを指定すると、アプリケーション内のクラス・オブジェクトは、GCの間はそのまま残り、常にライブであるとみなされます。これにより、より多くのメモリーが永久に占有されることになり、注意して使用しないと、メモリー不足の例外がスローされます。 .RE .PP \-Xprof .RS 4 -実行中のプログラムのプロファイルを生成し、プロファイル・データを標準出力に送信します。このオプションは、プログラム開発用のユーティリティとして提供されています。本番稼働システムでの使用を目的としたものではありません。 +実行中のプログラムをプロファイルし、プロファイリング・データを標準出力に送信します。このオプションは、プログラム開発用のユーティリティとして提供されています。本番稼働システムでの使用を目的としたものではありません。 .RE .PP \-Xrs @@ -675,13 +689,13 @@ .sp シャットダウン・フックは、JVMが突然終了した場合でも、シャットダウン時にユーザー・クリーンアップ・コード(データベース接続のクローズなど)を実行することによって、Javaアプリケーションのシャットダウンを順番に有効にします。 .sp -JVMは、予期しない終了のシャットダウン・フックを実装するためにシグナルをキャッチします。JVMは、\fISIGHUP\fR、\fISIGINT\fRおよび\fISIGTERM\fRを使用して、シャットダウン・フックの実行を開始します。 +JVMは、予期しない終了のシャットダウン・フックを実装するためにシグナルをキャッチします。JVMは、\fBSIGHUP\fR、\fBSIGINT\fRおよび\fBSIGTERM\fRを使用して、シャットダウン・フックの実行を開始します。 .sp -JVMは、デバッグの目的でスレッド・スタックをダンプするという機能を実現するために、同様のメカニズムを使用します。JVMは、スレッド・ダンプを実行するために\fISIGQUIT\fRを使用します。 +JVMは、デバッグの目的でスレッド・スタックをダンプするという機能を実現するために、同様のメカニズムを使用します。JVMは、スレッド・ダンプを実行するために\fBSIGQUIT\fRを使用します。 .sp -JVMを埋め込んでいるアプリケーションは、\fISIGINT\fRや\fISIGTERM\fRなどのシグナルを頻繁にトラップする必要があり、その結果、JVMのシグナル・ハンドラと衝突する可能性があります。\fI\-Xrs\fRオプションは、この問題に対処するために使用できます。\fI\-Xrs\fRが使用されている場合、\fISIGINT\fR、\fISIGTERM\fR、\fISIGHUP\fRおよび\fISIGQUIT\fRのシグナル・マスクはJVMによって変更されず、これらのシグナルのシグナル・ハンドラはインストールされません。 +JVMを埋め込んでいるアプリケーションは、\fBSIGINT\fRや\fBSIGTERM\fRなどのシグナルを頻繁にトラップする必要があり、その結果、JVMのシグナル・ハンドラと衝突する可能性があります。\fB\-Xrs\fRオプションは、この問題に対処するために使用できます。\fB\-Xrs\fRが使用されている場合、\fBSIGINT\fR、\fBSIGTERM\fR、\fBSIGHUP\fRおよび\fBSIGQUIT\fRのシグナル・マスクはJVMによって変更されず、これらのシグナルのシグナル・ハンドラはインストールされません。 .sp -\fI\-Xrs\fRを指定すると、次の2つの結果が生じます: +\fB\-Xrs\fRを指定すると、次の2つの結果が生じます: .sp .RS 4 .ie n \{\ @@ -691,7 +705,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fISIGQUIT\fRによるスレッド・ダンプは使用できません。 +\fBSIGQUIT\fRによるスレッド・ダンプは使用できません。 .RE .sp .RS 4 @@ -702,7 +716,7 @@ .sp -1 .IP \(bu 2.3 .\} -シャットダウン・フック処理の実行は、JVMが終了しようとしている時点で\fISystem\&.exit()\fRを呼び出すなどして、ユーザー・コード側で行う必要があります。 +シャットダウン・フック処理の実行は、JVMが終了しようとしている時点で\fBSystem\&.exit()\fRを呼び出すなどして、ユーザー・コード側で行う必要があります。 .RE .RE .PP @@ -758,7 +772,7 @@ .PP \-Xss\fIsize\fR .RS 4 -スレッドのスタック・サイズ(バイト単位)を設定します。KBを示す場合は文字\fIk\fRまたは\fIK\fR、MBを示す場合は文字\fIm\fRまたは\fIM\fR、GBを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値はプラットフォームによって異なります。 +スレッドのスタック・サイズ(バイト単位)を設定します。KBを示す場合は文字\fBk\fRまたは\fBK\fR、MBを示す場合は文字\fBm\fRまたは\fBM\fR、GBを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値はプラットフォームによって異なります。 .sp .RS 4 .ie n \{\ @@ -843,19 +857,20 @@ .RS 4 .\} .nf -\-Xss1m -\-Xss1024k -\-Xss1048576 +\fB\-Xss1m\fR +\fB\-Xss1024k\fR +\fB\-Xss1048576\fR + .fi .if n \{\ .RE .\} -このオプションは\fI\-XX:ThreadStackSize\fRと同等です。 +このオプションは\fB\-XX:ThreadStackSize\fRと同等です。 .RE .PP \-Xusealtsigs .RS 4 -JVM内部シグナルの\fISIGUSR1\fRおよび\fISIGUSR2\fRのかわりに、代替シグナルを使用します。このオプションは\fI\-XX:+UseAltSigs\fRと同等です。 +JVM内部シグナルの\fBSIGUSR1\fRおよび\fBSIGUSR2\fRのかわりに、代替シグナルを使用します。このオプションは\fB\-XX:+UseAltSigs\fRと同等です。 .RE .PP \-Xverify:\fImode\fR @@ -869,7 +884,7 @@ .PP remote .RS 4 -ネットワークを介してリモートでロードされるクラスのみを検証します。これは、\fI\-Xverify\fRオプションを指定しない場合のデフォルトの動作です。 +ネットワークを介してリモートでロードされるクラスのみを検証します。これは、\fB\-Xverify\fRオプションを指定しない場合のデフォルトの動作です。 .RE .PP all @@ -883,40 +898,47 @@ .PP \-XX:+DisableAttachMechanism .RS 4 -JVMにツールをアタッチするメカニズムを無効にするオプションを有効にします。デフォルトでは、このオプションは無効になっており、これは、アタッチ・メカニズムを有効にすると、\fIjcmd\fR、\fIjstack\fR、\fIjmap\fR、\fIjinfo\fRなどのツールを使用できることを意味します。 +JVMにツールをアタッチするメカニズムを無効にするオプションを有効にします。デフォルトでは、このオプションは無効になっており、これは、アタッチ・メカニズムを有効にすると、\fBjcmd\fR、\fBjstack\fR、\fBjmap\fR、\fBjinfo\fRなどのツールを使用できることを意味します。 .RE .PP \-XX:ErrorFile=\fIfilename\fR .RS 4 -リカバリ不能なエラーが発生した場合にエラー・データが書き込まれるパスおよびファイル名を指定します。デフォルトでは、このファイルは、現在の作業ディレクトリに作成され、名前は\fIhs_err_pid\fR\fIpid\fR\fI\&.log\fR -(\fIpid\fRはエラーの原因となったプロセスの識別子)になります。次の例では、デフォルトのログ・ファイルを設定する方法を示します(プロセスの識別子は\fI%p\fRとして指定されます)。 +リカバリ不能なエラーが発生した場合にエラー・データが書き込まれるパスおよびファイル名を指定します。デフォルトでは、このファイルは、現在の作業ディレクトリに作成され、名前は\fBhs_err_pid\fR\fIpid\fR\fB\&.log\fR +(\fIpid\fRはエラーの原因となったプロセスの識別子)になります。次の例では、デフォルトのログ・ファイルを設定する方法を示します(プロセスの識別子は\fB%p\fRとして指定されます)。 .sp .if n \{\ .RS 4 .\} .nf -\-XX:ErrorFile=\&./hs_err_pid%p\&.log +\fB\-XX:ErrorFile=\&./hs_err_pid%p\&.log\fR + .fi .if n \{\ .RE .\} -次の例では、エラー・ログを\fI/var/log/java/java_error\&.log\fRに設定する方法を示します。 +次の例では、エラー・ログを\fB/var/log/java/java_error\&.log\fRに設定する方法を示します。 .sp .if n \{\ .RS 4 .\} .nf -\-XX:ErrorFile=/var/log/java/java_error\&.log +\fB\-XX:ErrorFile=/var/log/java/java_error\&.log\fR + .fi .if n \{\ .RE .\} -(領域不足、権限の問題または別の問題により)指定したディレクトリにファイルを作成できない場合、ファイルはオペレーティング・システムの一時ディレクトリに作成されます。一時ディレクトリは\fI/tmp\fRです。 +(領域不足、権限の問題または別の問題により)指定したディレクトリにファイルを作成できない場合、ファイルはオペレーティング・システムの一時ディレクトリに作成されます。一時ディレクトリは\fB/tmp\fRです。 +.RE +.PP +\-XX:+FailOverToOldVerifier +.RS 4 +新しいタイプ・チェッカが失敗した場合の、古いベリファイアへの自動フェイルオーバーを有効にします。デフォルトでは、このオプションは無効になっており、最近のバイトコード・バージョンを使用したクラスには、これは無視されます(つまり、無効として処理されます)。古いバージョンのバイトコードを使用したクラスには、これを有効化できます。 .RE .PP \-XX:LargePageSizeInBytes=\fIsize\fR .RS 4 -Javaヒープに使用される大きいページの最大サイズ(バイト単位)を設定します。\fIsize\fR引数は、2の累乗(2、4、8、16、\&.\&.\&.)である必要があります。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、サイズは0に設定され、これは、JVMでは大きいページのサイズが自動的に選択されていることを意味します。 +Javaヒープに使用される大きいページの最大サイズ(バイト単位)を設定します。\fIsize\fR引数は、2の累乗(2、4、8、16、\&.\&.\&.)である必要があります。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、サイズは0に設定され、これは、JVMでは大きいページのサイズが自動的に選択されていることを意味します。 .sp 次の例では、大きいページのサイズを4メガバイト(MB)に設定する方法を示します。 .sp @@ -924,7 +946,8 @@ .RS 4 .\} .nf -\-XX:LargePageSizeInBytes=4m +\fB\-XX:LargePageSizeInBytes=4m\fR + .fi .if n \{\ .RE @@ -933,7 +956,7 @@ .PP \-XX:MaxDirectMemorySize=\fIsize\fR .RS 4 -新規I/O (\fIjava\&.nio\fRパッケージ)の直接バッファ割当ての最大合計サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、サイズは0に設定され、これは、JVMではNIOの直接バッファ割当てのサイズが自動的に選択されていることを意味します。 +新規I/O (\fBjava\&.nio\fRパッケージ)の直接バッファ割当ての最大合計サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、サイズは0に設定され、これは、JVMではNIOの直接バッファ割当てのサイズが自動的に選択されていることを意味します。 .sp 次の例では、NIOサイズを異なる単位で1024KBに設定する方法を示します。 .sp @@ -941,9 +964,10 @@ .RS 4 .\} .nf -\-XX:MaxDirectMemorySize=1m -\-XX:MaxDirectMemorySize=1024k -\-XX:MaxDirectMemorySize=1048576 +\fB\-XX:MaxDirectMemorySize=1m\fR +\fB\-XX:MaxDirectMemorySize=1024k\fR +\fB\-XX:MaxDirectMemorySize=1048576\fR + .fi .if n \{\ .RE @@ -956,7 +980,7 @@ .PP off .RS 4 -JVMのネイティブ・メモリー使用状況を追跡しません。これは、\fI\-XX:NativeMemoryTracking\fRオプションを指定しない場合のデフォルトの動作です。 +JVMのネイティブ・メモリー使用状況を追跡しません。これは、\fB\-XX:NativeMemoryTracking\fRオプションを指定しない場合のデフォルトの動作です。 .RE .PP summary @@ -966,7 +990,7 @@ .PP detail .RS 4 -JVMサブシステムによるメモリー使用状況のトラッキングに加えて、個々の\fICallSite\fR +JVMサブシステムによるメモリー使用状況のトラッキングに加えて、個々の\fBCallSite\fR (個々の仮想メモリー・リージョンおよびそのコミット済リージョン)によるメモリー使用状況を追跡します。 .RE .RE @@ -975,13 +999,14 @@ .RS 4 リカバリ不能なエラーが発生したときに実行する、カスタム・コマンドまたは一連のセミコロン区切りのコマンドを設定します。文字列に空白が含まれている場合は、引用符で囲む必要があります。 .sp -次の例では、\fI\-XX:OnError\fRオプションを使用してコア・イメージを作成するために\fIgcore\fRコマンドを実行する方法、およびリカバリ不能なエラーの場合にデバッガを起動してプロセスに接続する方法を示します(\fI%p\fRは現在のプロセスを指定します)。 +次の例では、\fB\-XX:OnError\fRオプションを使用してコア・イメージを作成するために\fBgcore\fRコマンドを実行する方法、およびリカバリ不能なエラーの場合にデバッガを起動してプロセスに接続する方法を示します(\fB%p\fRは現在のプロセスを指定します)。 .sp .if n \{\ .RS 4 .\} .nf -\-XX:OnError="gcore %p;dbx \- %p" +\fB\-XX:OnError="gcore %p;dbx \- %p"\fR + .fi .if n \{\ .RE @@ -990,17 +1015,22 @@ .PP \-XX:OnOutOfMemoryError=\fIstring\fR .RS 4 -\fIOutOfMemoryError\fR例外が最初にスローされたときに実行する、カスタム・コマンドまたは一連のセミコロン区切りのコマンドを設定します。文字列に空白が含まれている場合は、引用符で囲む必要があります。コマンド文字列の例は、\fI\-XX:OnError\fRオプションの説明を参照してください。 +\fBOutOfMemoryError\fR例外が最初にスローされたときに実行する、カスタム・コマンドまたは一連のセミコロン区切りのコマンドを設定します。文字列に空白が含まれている場合は、引用符で囲む必要があります。コマンド文字列の例は、\fB\-XX:OnError\fRオプションの説明を参照してください。 .RE .PP \-XX:+PrintCommandLineFlags .RS 4 -コマンドラインに表示された、人間工学的に選択したJVMフラグの印刷を有効にします。これは、ヒープ領域サイズや選択されたガベージ・コレクタなど、JVMによって設定されたエルゴノミック値を確認する場合に役立ちます。デフォルトでは、このオプションは無効であり、フラグは印刷されません。 +コマンド行に表示された、人間工学的に選択したJVMフラグの印刷を有効にします。これは、ヒープ領域サイズや選択されたガベージ・コレクタなど、JVMによって設定されたエルゴノミック値を確認する場合に役立ちます。デフォルトでは、このオプションは無効であり、フラグは印刷されません。 .RE .PP \-XX:+PrintNMTStatistics .RS 4 -ネイティブ・メモリーのトラッキングが有効な場合に、JVMの終了時に収集されたネイティブ・メモリーのトラッキング・データの印刷を有効にします(\fI\-XX:NativeMemoryTracking\fRを参照してください)。デフォルトでは、このオプションは無効であり、ネイティブ・メモリーのトラッキング・データは印刷されません。 +ネイティブ・メモリーのトラッキングが有効な場合に、JVMの終了時に収集されたネイティブ・メモリーのトラッキング・データの印刷を有効にします(\fB\-XX:NativeMemoryTracking\fRを参照してください)。デフォルトでは、このオプションは無効であり、ネイティブ・メモリーのトラッキング・データは印刷されません。 +.RE +.PP +\-XX:+RelaxAccessControlCheck +.RS 4 +ベリファイア内のアクセス制御チェックの量を減らします。デフォルトでは、このオプションは無効になっており、最近のバイトコード・バージョンを使用したクラスには、これは無視されます(つまり、無効として処理されます)。古いバージョンのバイトコードを使用したクラスには、これを有効化できます。 .RE .PP \-XX:+ShowMessageBoxOnError @@ -1010,7 +1040,7 @@ .PP \-XX:ThreadStackSize=\fIsize\fR .RS 4 -スレッドのスタック・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値はプラットフォームによって異なります。 +スレッドのスタック・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値はプラットフォームによって異なります。 .sp .RS 4 .ie n \{\ @@ -1095,14 +1125,15 @@ .RS 4 .\} .nf -\-XX:ThreadStackSize=1m -\-XX:ThreadStackSize=1024k -\-XX:ThreadStackSize=1048576 +\fB\-XX:ThreadStackSize=1m\fR +\fB\-XX:ThreadStackSize=1024k\fR +\fB\-XX:ThreadStackSize=1048576\fR + .fi .if n \{\ .RE .\} -このオプションは\fI\-Xss\fRと同等です。 +このオプションは\fB\-Xss\fRと同等です。 .RE .PP \-XX:+TraceClassLoading @@ -1132,14 +1163,14 @@ .PP \-XX:+UseAltSigs .RS 4 -JVM内部シグナルの\fISIGUSR1\fRおよび\fISIGUSR2\fRのかわりに、代替シグナルの使用を有効にします。デフォルトでは、このオプションは無効であり、代替シグナルは使用されません。このオプションは\fI\-Xusealtsigs\fRと同等です。 +JVM内部シグナルの\fBSIGUSR1\fRおよび\fBSIGUSR2\fRのかわりに、代替シグナルの使用を有効にします。デフォルトでは、このオプションは無効であり、代替シグナルは使用されません。このオプションは\fB\-Xusealtsigs\fRと同等です。 .RE .PP \-XX:+UseBiasedLocking .RS 4 バイアス・ロックの使用を有効にします。かなりの量の非競合の同期化がある一部のアプリケーションは、このフラグを有効にすると大幅な高速化が実現しますが、特定のパターンのロックがあるアプリケーションは、速度が低下することがあります。バイアス・ロックの方法の詳細は、http://www\&.oracle\&.com/technetwork/java/tuning\-139912\&.html#section4\&.2\&.5にあるJavaチューニングのホワイト・ペーパーの例を参照してください。 .sp -デフォルトでは、このオプションは無効であり、バイアス・ロックは使用されません。 +デフォルトでは、このオプションは有効になっています。 .RE .PP \-XX:+UseCompressedOops @@ -1151,19 +1182,19 @@ .PP \-XX:+UseLargePages .RS 4 -大きいページのメモリーの使用を有効にします。このオプションはデフォルトで有効になっています。大きいページのメモリーの使用を無効にするには、\fI\-XX:\-UseLargePages\fRを指定します。 +大きいページのメモリーの使用を有効にします。このオプションはデフォルトで有効になっています。大きいページのメモリーの使用を無効にするには、\fB\-XX:\-UseLargePages\fRを指定します。 .sp 詳細は、http://www\&.oracle\&.com/technetwork/java/javase/tech/largememory\-jsp\-137182\&.htmlにある大きいメモリー・ページ用のJavaサポートを参照してください。 .RE .PP \-XX:+UseMembar .RS 4 -スレッドの状態の遷移でメンバーの発行を有効にします。このオプションは、有効になっているPower PCおよびARMサーバーを除くすべてのプラットフォーム上で、デフォルトでは無効になっています。Power PCとARMのスレッド状態遷移に対するメンバーの発行を無効にするには、\fI\-XX:\-UseMembar\fRを指定します。 +スレッドの状態の遷移でメンバーの発行を有効にします。このオプションは、有効になっているARMサーバーを除くすべてのプラットフォーム上で、デフォルトでは無効になっています。(ARMサーバーでこのオプションを無効にしないことをお薦めします。) .RE .PP \-XX:+UsePerfData .RS 4 -\fIperfdata\fR機能を有効にします。このオプションはデフォルトで有効になっており、JVMのモニタリングおよびパフォーマンス・テストが可能になります。これを無効にすると、\fIhsperfdata_userid\fRディレクトリの作成を抑制します。\fIperfdata\fR機能を無効にするには、\fI\-XX:\-UsePerfData\fRを指定します。 +\fBperfdata\fR機能を有効にします。このオプションはデフォルトで有効になっており、JVMのモニタリングおよびパフォーマンス・テストが可能になります。これを無効にすると、\fBhsperfdata_userid\fRディレクトリの作成を抑制します。\fBperfdata\fR機能を無効にするには、\fB\-XX:\-UsePerfData\fRを指定します。 .RE .PP \-XX:+AllowUserSignalHandlers @@ -1187,530 +1218,20 @@ .RS 4 .\} .nf -\-XX:AllocateInstancePrefetchLines=1 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:AllocatePrefetchInstr=\fIinstruction\fR -.RS 4 -割当てポインタの前にプリフェッチするプリフェッチ命令を設定します。使用可能な値は0から3までです。値の背後にある実際の命令は、プラットフォームによって異なります。デフォルトでは、プリフェッチ命令は0に設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:AllocatePrefetchInstr=0 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:AllocatePrefetchStepSize=\fIsize\fR -.RS 4 -順次プリフェッチ命令のステップ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、ステップ・サイズは16バイトに設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:AllocatePrefetchStepSize=16 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+BackgroundCompilation -.RS 4 -バックグラウンド・コンパイルを有効にします。このオプションはデフォルトで有効になっています。バックグラウンド・コンパイルを無効にするには、\fI\-XX:\-BackgroundCompilation\fRを指定します(これは\fI\-Xbatch\fRを指定するのと同等です)。 -.RE -.PP -\-XX:CICompilerCount=\fIthreads\fR -.RS 4 -コンパイルに使用するコンパイラ・スレッドの数を設定します。デフォルトでは、スレッド数は、サーバーJVMの場合は2、クライアントJVMの場合は1に設定されており、層コンパイルが使用されている場合、コア数に合せて増減します。次の例では、スレッドの数を2に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CICompilerCount=2 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:CodeCacheMinimumFreeSpace=\fIsize\fR -.RS 4 -コンパイルに必要な最小空き領域(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。最小空き領域より少ない領域しか残っていない場合、コンパイルは停止します。デフォルトでは、このオプションは500KBに設定されています。次の例では、最小空き領域を1024MBに設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CodeCacheMinimumFreeSpace=1024m -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:CompileCommand=\fIcommand\fR,\fImethod\fR[,\fIoption\fR] -.RS 4 -メソッドで実行するコマンドを指定します。たとえば、コンパイル元から\fIString\fRクラスの\fIindexOf()\fRメソッドを実行するには、次を使用します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand=exclude,java/lang/String\&.indexOf -.fi -.if n \{\ -.RE -.\} -スラッシュ(\fI/\fR)で区切られたすべてのパッケージおよびサブパッケージを含む、完全クラス名を指定します。切取りと貼付けの操作を容易にするために、\fI\-XX:+PrintCompilation\fRオプションおよび\fI\-XX:+LogCompilation\fRオプションによって生成されるメソッド名の形式を使用することもできます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand=exclude,java\&.lang\&.String::indexOf -.fi -.if n \{\ -.RE -.\} -署名なしでメソッドを指定すると、コマンドは指定した名前を持つすべてのメソッドに適用されます。ただし、クラス・ファイル形式でメソッドの署名を指定することもできます。たとえば、コンパイル元から\fIString\fRクラスの\fIindexOf(String)\fRメソッドのみ除外するには、次を使用します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand=exclude,java/lang/String\&.indexOf(Ljava/lang/String;)I -.fi -.if n \{\ -.RE -.\} -また、クラス名およびメソッド名にワイルドカードとしてアスタリスク(*)を使用できます。たとえば、コンパイル元からすべてのクラスのすべての\fIindexOf()\fRメソッドを除外するには、次を使用します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand=exclude,*\&.indexOf -.fi -.if n \{\ -.RE -.\} -カンマとピリオドは空白の別名で、これにより、シェルを介してコンパイラ・コマンドを渡すことが容易になります。引数を引用符で囲むことで、空白をセパレータとして使用して\fI\-XX:CompileCommand\fRに引数を渡すことができます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand="exclude java/lang/String indexOf" -.fi -.if n \{\ -.RE -.\} -\fI\-XX:CompileCommand\fRオプションを使用してコマンドラインで渡されたコマンドを解析した後に、JITコンパイラは\fI\&.hotspot_compiler\fRファイルからコマンドを読み取ります。このファイルにコマンドを追加するか、または\fI\-XX:CompileCommandFile\fRオプションを使用して別のファイルを指定することができます。 -.sp -複数のコマンドを追加するには、\fI\-XX:CompileCommand\fRオプションを複数回指定するか、または改行セパレータ(\fI\en\fR)を使用して各引数を区切ります。次のコマンドを使用できます。 -.PP -break -.RS 4 -指定したメソッドのコンパイルの最初に停止するために、JVMのデバッグ時のブレークポイントを設定します。 -.RE -.PP -compileonly -.RS 4 -指定したメソッドを除いたすべてのメソッドを、コンパイルから除外します。別の方法として、\fI\-XX:CompileOnly\fRオプションを使用して複数のメソッドを指定できます。 -.RE -.PP -dontinline -.RS 4 -指定したメソッドをインライン化しないようにします。 -.RE -.PP -exclude -.RS 4 -指定したメソッドをコンパイルから除外します。 -.RE -.PP -help -.RS 4 -\fI\-XX:CompileCommand\fRオプションのヘルプ・メッセージを印刷します。 -.RE -.PP -inline -.RS 4 -指定したメソッドをインライン化しようとします。 -.RE -.PP -log -.RS 4 -指定したメソッドを除くすべてのメソッドに対して、(\fI\-XX:+LogCompilation\fRオプションを使用して)コンパイル・ロギングを除外します。デフォルトでは、コンパイルされたすべてのメソッドにロギングが実行されます。 -.RE -.PP -option -.RS 4 -このコマンドは、最後の引数(\fIoption\fR)のかわりに、指定したメソッドにJITコンパイル・オプションを渡すために使用できます。コンパイル・オプションは、メソッド名の後の末尾に設定されます。たとえば、\fIStringBuffer\fRクラスの\fIappend()\fRメソッドに対して\fIBlockLayoutByFrequency\fRオプションを有効にするには、次を使用します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileCommand=option,java/lang/StringBuffer\&.append,BlockLayoutByFrequency -.fi -.if n \{\ -.RE -.\} -カンマまたは空白で区切って、複数のコンパイル・オプションを指定できます。 -.RE -.PP -print -.RS 4 -指定したメソッドのコンパイル後に生成されたアセンブラ・コードを出力します。 -.RE -.PP -quiet -.RS 4 -コンパイル・コマンドを出力しません。デフォルトでは、\fI\-XX:CompileCommand\fRオプションを使用して指定したコマンドが出力されます。たとえば、\fIString\fRクラスの\fIindexOf()\fRメソッドのコンパイルから除外する場合、次が標準出力に出力されます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -CompilerOracle: exclude java/lang/String\&.indexOf -.fi -.if n \{\ -.RE -.\} -他の\fI\-XX:CompileCommand\fRオプションの前に\fI\-XX:CompileCommand=quiet\fRオプションを指定することによって、これを抑制できます。 -.RE -.RE -.PP -\-XX:CompileCommandFile=\fIfilename\fR -.RS 4 -JITコンパイラ・コマンドの読取り元のファイルを設定します。デフォルトでは、JITコンパイラによって実行されるコマンドを格納するために、\fI\&.hotspot_compiler\fRファイルが使用されます。 -.sp -コマンド・ファイルの各行は、コマンドが使用されるコマンド、クラス名およびメソッド名を表します。たとえば、次の行は、\fIString\fRクラスの\fItoString()\fRメソッドに対してアセンブリ・コードを出力します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -print java/lang/String toString -.fi -.if n \{\ -.RE -.\} -メソッドで実行するJITコンパイラのコマンドの指定の詳細は、\fI\-XX:CompileCommand\fRオプションを参照してください。 -.RE -.PP -\-XX:CompileOnly=\fImethods\fR -.RS 4 -コンパイルを制限する(カンマで区切られた)メソッドのリストを設定します。指定したメソッドのみがコンパイルされます。完全クラス名(パッケージおよびサブパッケージを含む)で各メソッドを指定します。たとえば、\fIString\fRクラスの\fIlength()\fRメソッドおよび\fIList\fRクラスの\fIsize()\fRメソッドのみをコンパイルするには、次を使用します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileOnly=java/lang/String\&.length,java/util/List\&.size -.fi -.if n \{\ -.RE -.\} -スラッシュ(\fI/\fR)で区切られたすべてのパッケージおよびサブパッケージを含む、完全クラス名を指定します。切取りと貼付けの操作を容易にするために、\fI\-XX:+PrintCompilation\fRオプションおよび\fI\-XX:+LogCompilation\fRオプションによって生成されるメソッド名の形式を使用することもできます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileOnly=java\&.lang\&.String::length,java\&.util\&.List::size +\fB\-XX:AllocateInstancePrefetchLines=1\fR + .fi .if n \{\ .RE .\} -ワイルドカードはサポートされていませんが、クラス名またはパッケージ名だけを指定してクラスまたはパッケージのすべてのメソッドをコンパイルすることも、メソッドだけを指定して任意のクラスのこの名前を持つメソッドをコンパイルすることもできます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileOnly=java/lang/String -\-XX:CompileOnly=java/lang -\-XX:CompileOnly=\&.length -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:CompileThreshold=\fIinvocations\fR -.RS 4 -コンパイル前に解釈されたメソッド呼出しの数を設定します。デフォルトでは、サーバーJVMでは、JITコンパイラは、10,000の解釈されたメソッド呼出しを実行して、効率的なコンパイルのための情報を収集します。クライアントJVMの場合、デフォルト設定は1,500呼出しです。次の例では、解釈されたメソッド呼出しの数を5,000に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CompileThreshold=5000 -.fi -.if n \{\ -.RE -.\} -\fI\-Xcomp\fRオプションを指定して、コンパイルの前に、Javaメソッドの解釈を完全に無効にすることができます。 -.RE -.PP -\-XX:+DoEscapeAnalysis -.RS 4 -エスケープ分析の使用を有効にします。このオプションはデフォルトで有効になっています。エスケープ分析の使用を無効にするには、\fI\-XX:\-DoEscapeAnalysis\fRを指定します。 -.RE -.PP -\-XX:+FailOverToOldVerifier -.RS 4 -新しいタイプ・チェッカが失敗した場合の、古いベリファイアへの自動フェイルオーバーを有効にします。デフォルトでは、このオプションは無効になっており、最近のバイトコード・バージョンを使用したクラスには、これは無視されます(つまり、無効として処理されます)。古いバージョンのバイトコードを使用したクラスには、これを有効化できます。 -.RE -.PP -\-XX:InitialCodeCacheSize=\fIsize\fR -.RS 4 -初期コード・キャッシュ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値は500KBに設定されています。次の例では、初期コード・キャッシュ・サイズを32KBに設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:InitialCodeCacheSize=32k -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+Inline -.RS 4 -メソッドのインライン化を有効にします。このオプションは、パフォーマンスを向上させるためにデフォルトで有効になっています。メソッドのインライン化を無効にするには、\fI\-XX:\-Inline\fRを指定します。 -.RE -.PP -\-XX:InlineSmallCode=\fIsize\fR -.RS 4 -インライン化が必要なコンパイルされたメソッドの最大コード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。指定したサイズより小さいサイズのコンパイルされたメソッドのみが、インライン化されます。デフォルトでは、最大コード・サイズは1000バイトに設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:InlineSmallCode=1000 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+LogCompilation -.RS 4 -現在の作業ディレクトリにある\fIhotspot\&.log\fRという名前のファイルへのコンパイル・アクティビティのロギングを有効にします。\fI\-XX:LogFile\fRオプションを使用して、異なるログ・ファイル・パスと名前を指定できます。 -.sp -デフォルトでは、このオプションは無効であり、コンパイル・アクティビティは記録されません。\fI\-XX:+LogCompilation\fRオプションは、診断JVMオプションのロックを解除する\fI\-XX:UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 -.sp -\fI\-XX:+PrintCompilation\fRオプションを使用して、メソッドをコンパイルするたびに、コンソールに出力されたメッセージを含む詳細な診断出力を有効化できます。 -.RE -.PP -\-XX:MaxInlineSize=\fIsize\fR -.RS 4 -インライン化するメソッドの最大バイトコード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、最大バイトコード・サイズは35バイトに設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:MaxInlineSize=35 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:MaxNodeLimit=\fInodes\fR -.RS 4 -単一のメソッドのコンパイル時に使用されるノードの最大数を設定します。デフォルトでは、ノードの最大数は65,000に設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:MaxNodeLimit=65000 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:MaxTrivialSize=\fIsize\fR -.RS 4 -インライン化する単純メソッドの最大バイトコード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、単純メソッドの最大バイトコード・サイズは6バイトに設定されています。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:MaxTrivialSize=6 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+OptimizeStringConcat -.RS 4 -\fIString\fR連結操作の最適化を有効にします。このオプションはデフォルトで有効になっています。\fIString\fR連結操作の最適化を無効にするには、\fI\-XX:\-OptimizeStringConcat\fRを指定します。 -.RE -.PP -\-XX:+PrintAssembly -.RS 4 -外部の\fIdisassembler\&.so\fRライブラリを使用して、バイトコード化されたネイティブのメソッドのアセンブリ・コードの出力を有効にします。これにより、生成されたコードを表示することができ、パフォーマンスの問題の診断に役立ちます。 -.sp -デフォルトでは、このオプションは無効であり、アセンブリ・コードは印刷されません。\fI\-XX:+PrintAssembly\fRオプションは、診断JVMオプションのロックを解除する\fI\-XX:UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 -.RE -.PP -\-XX:+PrintCompilation -.RS 4 -メソッドをコンパイルするたびに、コンソールにメッセージを出力することによって、JVMからの詳細な診断出力を有効にします。これにより、実際にコンパイルされるメソッドを確認できます。デフォルトでは、このオプションは無効であり、診断出力は印刷されません。 -.sp -\fI\-XX:+LogCompilation\fRオプションを使用して、コンパイル・アクティビティをファイルに記録することもできます。 -.RE -.PP -\-XX:+PrintInlining -.RS 4 -インライン化の決定内容の出力を有効にします。これにより、インライン化されるメソッドを確認できます。 -.sp -デフォルトでは、このオプションは無効であり、インライン化情報は出力されません。\fI\-XX:+PrintInlining\fRオプションは、診断JVMオプションのロックを解除する\fI\-XX:+UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 -.RE -.PP -\-XX:+RelaxAccessControlCheck -.RS 4 -ベリファイア内のアクセス制御チェックの量を減らします。デフォルトでは、このオプションは無効になっており、最近のバイトコード・バージョンを使用したクラスには、これは無視されます(つまり、無効として処理されます)。古いバージョンのバイトコードを使用したクラスには、これを有効化できます。 -.RE -.PP -\-XX:ReservedCodeCacheSize=\fIsize\fR -.RS 4 -JITコンパイルされたコードの最大コード・キャッシュ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。このオプションは\fI\-Xmaxjitcodesize\fRと同等です。 -.RE -.PP -\-XX:+TieredCompilation -.RS 4 -層コンパイルの使用を有効にします。デフォルトでは、このオプションは無効であり、層コンパイルは使用されません。 -.RE -.PP -\-XX:+UseCodeCacheFlushing -.RS 4 -コンパイラをシャットダウンする前に、コード・キャッシュのフラッシュを有効にします。このオプションはデフォルトで有効になっています。コンパイラをシャットダウンする前にコード・キャッシュのフラッシュを無効にするには\fI\-XX:\-UseCodeCacheFlushing\fRを指定します。 -.RE -.PP -\-XX:+UseCondCardMark -.RS 4 -カード表の更新前に、カードがすでにマークされているかどうかのチェックを有効にします。このオプションは、デフォルトでは無効になっており、複数のソケットを持つマシン上でのみ使用する必要があります。これにより、同時操作にかなり依存しているJavaアプリケーションのパフォーマンスが向上します。 -.RE -.PP -\-XX:+UseSuperWord -.RS 4 -スカラー演算のスーパーワード演算への変換を有効にします。このオプションはデフォルトで有効になっています。スカラー演算のスーパーワード演算への変換を無効にするには、\fI\-XX:\-UseSuperWord\fRを指定します。 -.RE -.SS "高度なサービスアビリティ・オプション" -.PP -これらのオプションは、システム情報を収集し、詳細なデバッグを実行する機能を提供します。 -.PP -\-XX:+ExtendedDTraceProbes -.RS 4 -パフォーマンスに影響を与える追加の\fIdtrace\fRツール・プローブを有効にします。デフォルトでは、このオプションは無効になっており、\fIdtrace\fRは標準プローブのみを実行します。 -.RE -.PP -\-XX:+HeapDumpOnOutOfMemory -.RS 4 -\fIjava\&.lang\&.OutOfMemoryError\fR例外がスローされた場合に、ヒープ・プロファイラ(HPROF)を使用して、現在のディレクトリ内のファイルへのJavaヒープのダンプを有効にします。\fI\-XX:HeapDumpPath\fRオプションを使用して、ヒープ・ダンプ・ファイルのパスおよび名前を明示的に設定できます。デフォルトでは、このオプションは無効であり、\fIOutOfMemoryError\fR例外がスローされた場合にヒープはダンプされません。 -.RE -.PP -\-XX:HeapDumpPath=\fIpath\fR -.RS 4 -\fI\-XX:+HeapDumpOnOutOfMemoryError\fRオプションが設定されている場合、ヒープ・プロファイラ(HPROF)が提供するヒープ・ダンプを書き込むパスおよびファイル名を設定します。デフォルトでは、このファイルは、現在の作業ディレクトリに作成され、名前は\fIjava_pid\fR\fIpid\fR\fI\&.hprof\fR -(\fIpid\fRはエラーの原因となったプロセスの識別子)になります。次の例では、デフォルトのファイルを明示的に設定する方法を示します(\fI%p\fRは現在のプロセスの識別子を表します)。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:HeapDumpPath=\&./java_pid%p\&.hprof -.fi -.if n \{\ -.RE -.\} -次の例では、ヒープ・ダンプ・ファイルを\fI/var/log/java/java_heapdump\&.hprof\fRに設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:HeapDumpPath=/var/log/java/java_heapdump\&.hprof -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:LogFile=\fIpath\fR -.RS 4 -ログ・データが書き込まれるパスおよびファイル名を設定します。デフォルトでは、ファイルは現在の作業ディレクトリに作成され、名前は\fIhotspot\&.log\fRです。 -.sp -次の例では、ログ・ファイルを\fI/var/log/java/hotspot\&.log\fRに設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:LogFile=/var/log/java/hotspot\&.log -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+PrintClassHistogram -.RS 4 -\fI[Control]+[C]\fRイベント(\fISIGTERM\fR)後にクラス・インスタンスのヒストグラムの印刷を有効にします。デフォルトでは、このオプションは無効です。 -.sp -このオプションを設定すると、\fIjmap \-histo\fRコマンド、または\fIjcmd \fR\fIpid\fR\fI GC\&.class_histogram\fRコマンド(\fIpid\fRは現在のJavaプロセスの識別子)を実行する場合と同じになります。 -.RE -.PP -\-XX:+PrintConcurrentLocks -.RS 4 -.sp -\fI[Control]+[C]\fRイベント(\fISIGTERM\fR)後に\fIjava\&.util\&.concurrent\fRロックの印刷を有効にします。デフォルトでは、このオプションは無効です。 -.sp -このオプションを設定すると、\fIjstack \-l\fRコマンド、または\fIjcmd \fR\fIpid\fR\fI Thread\&.print \-l\fRコマンド(\fIpid\fRは現在のJavaプロセスの識別子)を実行する場合と同じになります。 -.RE -.PP -\-XX:+UnlockDiagnosticVMOptions -.RS 4 -JVMの診断を目的としたオプションをアンロックします。デフォルトでは、このオプションは無効であり、診断オプションは使用できません。 -.RE -.SS "高度なガベージ・コレクション・オプション" -.PP -これらのオプションは、ガベージ・コレクション(GC)がJava HotSpot VMによってどのように実行されるかを制御します。 -.PP -\-XX:+AggressiveHeap -.RS 4 -Javaヒープの最適化を有効にします。これにより、コンピュータの構成(RAMおよびCPU)に基づいて、様々なパラメータが、メモリー割当てが集中した長時間実行ジョブに最適になるように設定されます。デフォルトでは、このオプションは無効であり、ヒープは最適化されません。 +Java HotSpot Server VMのみが、このオプションをサポートしています。 .RE .PP \-XX:AllocatePrefetchDistance=\fIsize\fR .RS 4 オブジェクト割当てのプリフェッチ距離のサイズ(バイト単位)を設定します。新規オブジェクトの値で書き込もうとするメモリーは、最後に割り当てられたオブジェクトのアドレスから、この距離までプリフェッチされます。各Javaスレッドには独自の割当てポイントがあります。 .sp -負の値は、プリフェッチ距離はプラットフォームに基づいて選択されることを示します。正の値は、プリフェッチするバイト数です。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値は\-1に設定されています。 +負の値は、プリフェッチ距離はプラットフォームに基づいて選択されることを示します。正の値は、プリフェッチするバイト数です。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値は\-1に設定されています。 .sp 次の例では、プリフェッチ距離を1024バイトに設定する方法を示します。 .sp @@ -1718,11 +1239,30 @@ .RS 4 .\} .nf -\-XX:AllocatePrefetchDistance=1024 +\fB\-XX:AllocatePrefetchDistance=1024\fR + .fi .if n \{\ .RE .\} +Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:AllocatePrefetchInstr=\fIinstruction\fR +.RS 4 +割当てポインタの前にプリフェッチするプリフェッチ命令を設定します。Java HotSpot Server VMのみが、このオプションをサポートしています。使用可能な値は0から3までです。値の背後にある実際の命令は、プラットフォームによって異なります。デフォルトでは、プリフェッチ命令は0に設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:AllocatePrefetchInstr=0\fR + +.fi +.if n \{\ +.RE +.\} +Java HotSpot Server VMのみが、このオプションをサポートしています。 .RE .PP \-XX:AllocatePrefetchLines=\fIlines\fR @@ -1735,11 +1275,30 @@ .RS 4 .\} .nf -\-XX:AllocatePrefetchLines=5 +\fB\-XX:AllocatePrefetchLines=5\fR + .fi .if n \{\ .RE .\} +Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:AllocatePrefetchStepSize=\fIsize\fR +.RS 4 +順次プリフェッチ命令のステップ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、ステップ・サイズは16バイトに設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:AllocatePrefetchStepSize=16\fR + +.fi +.if n \{\ +.RE +.\} +Java HotSpot Server VMのみが、このオプションをサポートしています。 .RE .PP \-XX:AllocatePrefetchStyle=\fIstyle\fR @@ -1765,16 +1324,565 @@ .RS 4 割当てプリフェッチ用のSPARCでBIS命令を使用します。 .RE +.sp +Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:+BackgroundCompilation +.RS 4 +バックグラウンド・コンパイルを有効にします。このオプションはデフォルトで有効になっています。バックグラウンド・コンパイルを無効にするには、\fB\-XX:\-BackgroundCompilation\fRを指定します(これは\fB\-Xbatch\fRを指定するのと同等です)。 +.RE +.PP +\-XX:CICompilerCount=\fIthreads\fR +.RS 4 +コンパイルに使用するコンパイラ・スレッドの数を設定します。デフォルトでは、スレッド数は、サーバーJVMの場合は2、クライアントJVMの場合は1に設定されており、層コンパイルが使用されている場合、コア数に合せて増減します。次の例では、スレッドの数を2に設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CICompilerCount=2\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:CodeCacheMinimumFreeSpace=\fIsize\fR +.RS 4 +コンパイルに必要な最小空き領域(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。最小空き領域より少ない領域しか残っていない場合、コンパイルは停止します。デフォルトでは、このオプションは500KBに設定されています。次の例では、最小空き領域を1024MBに設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CodeCacheMinimumFreeSpace=1024m\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:CompileCommand=\fIcommand\fR,\fImethod\fR[,\fIoption\fR] +.RS 4 +メソッドで実行するコマンドを指定します。たとえば、コンパイル元から\fBString\fRクラスの\fBindexOf()\fRメソッドを実行するには、次を使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand=exclude,java/lang/String\&.indexOf\fR + +.fi +.if n \{\ +.RE +.\} +スラッシュ(\fB/\fR)で区切られたすべてのパッケージおよびサブパッケージを含む、完全クラス名を指定します。切取りと貼付けの操作を容易にするために、\fB\-XX:+PrintCompilation\fRオプションおよび\fB\-XX:+LogCompilation\fRオプションによって生成されるメソッド名の形式を使用することもできます。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand=exclude,java\&.lang\&.String::indexOf\fR + +.fi +.if n \{\ +.RE +.\} +署名なしでメソッドを指定すると、コマンドは指定した名前を持つすべてのメソッドに適用されます。ただし、クラス・ファイル形式でメソッドの署名を指定することもできます。この場合、引数を引用符で囲む必要があり、囲まないと、シェルによりセミコロンがコマンドの終了として扱われます。たとえば、コンパイル元から\fBString\fRクラスの\fBindexOf(String)\fRメソッドのみ除外するには、次を使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand="exclude,java/lang/String\&.indexOf,(Ljava/lang/String;)I"\fR + +.fi +.if n \{\ +.RE +.\} +また、クラス名およびメソッド名にワイルドカードとしてアスタリスク(*)を使用できます。たとえば、コンパイル元からすべてのクラスのすべての\fBindexOf()\fRメソッドを除外するには、次を使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand=exclude,*\&.indexOf\fR + +.fi +.if n \{\ +.RE +.\} +カンマとピリオドは空白の別名で、これにより、シェルを介してコンパイラ・コマンドを渡すことが容易になります。引数を引用符で囲むことで、空白をセパレータとして使用して\fB\-XX:CompileCommand\fRに引数を渡すことができます。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand="exclude java/lang/String indexOf"\fR + +.fi +.if n \{\ +.RE +.\} +\fB\-XX:CompileCommand\fRオプションを使用してコマンド行で渡されたコマンドを解析した後に、JITコンパイラは\fB\&.hotspot_compiler\fRファイルからコマンドを読み取ります。このファイルにコマンドを追加するか、または\fB\-XX:CompileCommandFile\fRオプションを使用して別のファイルを指定することができます。 +.sp +複数のコマンドを追加するには、\fB\-XX:CompileCommand\fRオプションを複数回指定するか、または改行セパレータ(\fB\en\fR)を使用して各引数を区切ります。次のコマンドを使用できます。 +.PP +break +.RS 4 +指定したメソッドのコンパイルの最初に停止するために、JVMのデバッグ時のブレークポイントを設定します。 +.RE +.PP +compileonly +.RS 4 +指定したメソッドを除いたすべてのメソッドを、コンパイルから除外します。別の方法として、\fB\-XX:CompileOnly\fRオプションを使用して複数のメソッドを指定できます。 +.RE +.PP +dontinline +.RS 4 +指定したメソッドをインライン化しないようにします。 +.RE +.PP +exclude +.RS 4 +指定したメソッドをコンパイルから除外します。 +.RE +.PP +help +.RS 4 +\fB\-XX:CompileCommand\fRオプションのヘルプ・メッセージを印刷します。 +.RE +.PP +inline +.RS 4 +指定したメソッドをインライン化しようとします。 +.RE +.PP +log +.RS 4 +指定したメソッドを除くすべてのメソッドに対して、(\fB\-XX:+LogCompilation\fRオプションを使用して)コンパイル・ロギングを除外します。デフォルトでは、コンパイルされたすべてのメソッドにロギングが実行されます。 +.RE +.PP +option +.RS 4 +このコマンドは、最後の引数(\fIoption\fR)のかわりに、指定したメソッドにJITコンパイル・オプションを渡すために使用できます。コンパイル・オプションは、メソッド名の後の末尾に設定されます。たとえば、\fBStringBuffer\fRクラスの\fBappend()\fRメソッドに対して\fBBlockLayoutByFrequency\fRオプションを有効にするには、次を使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileCommand=option,java/lang/StringBuffer\&.append,BlockLayoutByFrequency\fR + +.fi +.if n \{\ +.RE +.\} +カンマまたは空白で区切って、複数のコンパイル・オプションを指定できます。 +.RE +.PP +print +.RS 4 +指定したメソッドのコンパイル後に生成されたアセンブラ・コードを出力します。 +.RE +.PP +quiet +.RS 4 +コンパイル・コマンドを出力しません。デフォルトでは、\fB\-XX:CompileCommand\fRオプションを使用して指定したコマンドが出力されます。たとえば、\fBString\fRクラスの\fBindexOf()\fRメソッドのコンパイルから除外する場合、次が標準出力に出力されます。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBCompilerOracle: exclude java/lang/String\&.indexOf\fR + +.fi +.if n \{\ +.RE +.\} +他の\fB\-XX:CompileCommand\fRオプションの前に\fB\-XX:CompileCommand=quiet\fRオプションを指定することによって、これを抑制できます。 +.RE +.RE +.PP +\-XX:CompileCommandFile=\fIfilename\fR +.RS 4 +JITコンパイラ・コマンドの読取り元のファイルを設定します。デフォルトでは、JITコンパイラによって実行されるコマンドを格納するために、\fB\&.hotspot_compiler\fRファイルが使用されます。 +.sp +コマンド・ファイルの各行は、コマンドが使用されるコマンド、クラス名およびメソッド名を表します。たとえば、次の行は、\fBString\fRクラスの\fBtoString()\fRメソッドに対してアセンブリ・コードを出力します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBprint java/lang/String toString\fR + +.fi +.if n \{\ +.RE +.\} +メソッドで実行するJITコンパイラのコマンドの指定の詳細は、\fB\-XX:CompileCommand\fRオプションを参照してください。 +.RE +.PP +\-XX:CompileOnly=\fImethods\fR +.RS 4 +コンパイルを制限する(カンマで区切られた)メソッドのリストを設定します。指定したメソッドのみがコンパイルされます。完全クラス名(パッケージおよびサブパッケージを含む)で各メソッドを指定します。たとえば、\fBString\fRクラスの\fBlength()\fRメソッドおよび\fBList\fRクラスの\fBsize()\fRメソッドのみをコンパイルするには、次を使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileOnly=java/lang/String\&.length,java/util/List\&.size\fR + +.fi +.if n \{\ +.RE +.\} +スラッシュ(\fB/\fR)で区切られたすべてのパッケージおよびサブパッケージを含む、完全クラス名を指定します。切取りと貼付けの操作を容易にするために、\fB\-XX:+PrintCompilation\fRオプションおよび\fB\-XX:+LogCompilation\fRオプションによって生成されるメソッド名の形式を使用することもできます。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileOnly=java\&.lang\&.String::length,java\&.util\&.List::size\fR + +.fi +.if n \{\ +.RE +.\} +ワイルドカードはサポートされていませんが、クラス名またはパッケージ名だけを指定してクラスまたはパッケージのすべてのメソッドをコンパイルすることも、メソッドだけを指定して任意のクラスのこの名前を持つメソッドをコンパイルすることもできます。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileOnly=java/lang/String\fR +\fB\-XX:CompileOnly=java/lang\fR +\fB\-XX:CompileOnly=\&.length\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:CompileThreshold=\fIinvocations\fR +.RS 4 +コンパイル前に解釈されたメソッド呼出しの数を設定します。デフォルトでは、サーバーJVMでは、JITコンパイラは、10,000の解釈されたメソッド呼出しを実行して、効率的なコンパイルのための情報を収集します。クライアントJVMの場合、デフォルト設定は1,500呼出しです。次の例では、解釈されたメソッド呼出しの数を5,000に設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:CompileThreshold=5000\fR + +.fi +.if n \{\ +.RE +.\} +\fB\-Xcomp\fRオプションを指定して、コンパイルの前に、Javaメソッドの解釈を完全に無効にすることができます。 +.RE +.PP +\-XX:+DoEscapeAnalysis +.RS 4 +エスケープ分析の使用を有効にします。このオプションはデフォルトで有効になっています。エスケープ分析の使用を無効にするには、\fB\-XX:\-DoEscapeAnalysis\fRを指定します。Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:InitialCodeCacheSize=\fIsize\fR +.RS 4 +初期コード・キャッシュ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値は500KBに設定されています。次の例では、初期コード・キャッシュ・サイズを32KBに設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:InitialCodeCacheSize=32k\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:+Inline +.RS 4 +メソッドのインライン化を有効にします。このオプションは、パフォーマンスを向上させるためにデフォルトで有効になっています。メソッドのインライン化を無効にするには、\fB\-XX:\-Inline\fRを指定します。 +.RE +.PP +\-XX:InlineSmallCode=\fIsize\fR +.RS 4 +インライン化が必要なコンパイルされたメソッドの最大コード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。指定したサイズより小さいサイズのコンパイルされたメソッドのみが、インライン化されます。デフォルトでは、最大コード・サイズは1000バイトに設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:InlineSmallCode=1000\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:+LogCompilation +.RS 4 +現在の作業ディレクトリにある\fBhotspot\&.log\fRという名前のファイルへのコンパイル・アクティビティのロギングを有効にします。\fB\-XX:LogFile\fRオプションを使用して、異なるログ・ファイル・パスと名前を指定できます。 +.sp +デフォルトでは、このオプションは無効であり、コンパイル・アクティビティは記録されません。\fB\-XX:+LogCompilation\fRオプションは、診断JVMオプションのロックを解除する\fB\-XX:UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 +.sp +\fB\-XX:+PrintCompilation\fRオプションを使用して、メソッドをコンパイルするたびに、コンソールに出力されたメッセージを含む詳細な診断出力を有効化できます。 +.RE +.PP +\-XX:MaxInlineSize=\fIsize\fR +.RS 4 +インライン化するメソッドの最大バイトコード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、最大バイトコード・サイズは35バイトに設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:MaxInlineSize=35\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:MaxNodeLimit=\fInodes\fR +.RS 4 +単一のメソッドのコンパイル時に使用されるノードの最大数を設定します。デフォルトでは、ノードの最大数は65,000に設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:MaxNodeLimit=65000\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:MaxTrivialSize=\fIsize\fR +.RS 4 +インライン化する単純メソッドの最大バイトコード・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、単純メソッドの最大バイトコード・サイズは6バイトに設定されています。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:MaxTrivialSize=6\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:+OptimizeStringConcat +.RS 4 +\fBString\fR連結操作の最適化を有効にします。このオプションはデフォルトで有効になっています。\fBString\fR連結操作の最適化を無効にするには、\fB\-XX:\-OptimizeStringConcat\fRを指定します。Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:+PrintAssembly +.RS 4 +外部の\fBdisassembler\&.so\fRライブラリを使用して、バイトコード化されたネイティブのメソッドのアセンブリ・コードの出力を有効にします。これにより、生成されたコードを表示することができ、パフォーマンスの問題の診断に役立ちます。 +.sp +デフォルトでは、このオプションは無効であり、アセンブリ・コードは印刷されません。\fB\-XX:+PrintAssembly\fRオプションは、診断JVMオプションのロックを解除する\fB\-XX:UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 +.RE +.PP +\-XX:+PrintCompilation +.RS 4 +メソッドをコンパイルするたびに、コンソールにメッセージを出力することによって、JVMからの詳細な診断出力を有効にします。これにより、実際にコンパイルされるメソッドを確認できます。デフォルトでは、このオプションは無効であり、診断出力は印刷されません。 +.sp +\fB\-XX:+LogCompilation\fRオプションを使用して、コンパイル・アクティビティをファイルに記録することもできます。 +.RE +.PP +\-XX:+PrintInlining +.RS 4 +インライン化の決定内容の出力を有効にします。これにより、インライン化されるメソッドを確認できます。 +.sp +デフォルトでは、このオプションは無効であり、インライン化情報は出力されません。\fB\-XX:+PrintInlining\fRオプションは、診断JVMオプションのロックを解除する\fB\-XX:+UnlockDiagnosticVMOptions\fRオプションとともに使用する必要があります。 +.RE +.PP +\-XX:ReservedCodeCacheSize=\fIsize\fR +.RS 4 +JITコンパイルされたコードの最大コード・キャッシュ・サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。このオプションは\fB\-Xmaxjitcodesize\fRと同等です。 +.RE +.PP +\-XX:+TieredCompilation +.RS 4 +層コンパイルの使用を有効にします。デフォルトでは、このオプションは有効になっています。Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:+UseAES +.RS 4 +Intel、AMDおよびSPARCハードウェアに対して、ハードウェアベースのAES組込みを有効化します。Intel Westmere (2010以降)、AMD Bulldozer (2011以降)およびSPARC (T4以降)が、サポートされているハードウェアです。UseAESは、UseAESIntrinsicsとともに使用します。 +.RE +.PP +\-XX:+UseAESIntrinsics +.RS 4 +UseAESとUseAESIntrinsicsフラグはデフォルトで有効化されており、Java HotSpot Server VM 32ビットおよび64ビットに対してのみサポートされています。ハードウェアベースのAES組込みを無効化するには、\fB\-XX:\-UseAES \-XX:\-UseAESIntrinsics\fRを指定します。たとえば、ハードウェアAESを有効化するには、次のフラグを使用します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:+UseAES \-XX:+UseAESIntrinsics\fR + +.fi +.if n \{\ +.RE +.\} +32ビットおよび64ビットに対してUseAESおよびUseAESIntrinsicsフラグをサポートするには、\fB\-server\fRオプションを使用してJava HotSpot Server VMを選択します。これらのフラグは、クライアントVMではサポートされていません。 +.RE +.PP +\-XX:+UseCodeCacheFlushing +.RS 4 +コンパイラをシャットダウンする前に、コード・キャッシュのフラッシュを有効にします。このオプションはデフォルトで有効になっています。コンパイラをシャットダウンする前にコード・キャッシュのフラッシュを無効にするには\fB\-XX:\-UseCodeCacheFlushing\fRを指定します。 +.RE +.PP +\-XX:+UseCondCardMark +.RS 4 +カード表の更新前に、カードがすでにマークされているかどうかのチェックを有効にします。このオプションは、デフォルトでは無効になっており、複数のソケットを持つマシン上でのみ使用する必要があります。これにより、同時操作にかなり依存しているJavaアプリケーションのパフォーマンスが向上します。Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.PP +\-XX:+UseSuperWord +.RS 4 +スカラー演算のスーパーワード演算への変換を有効にします。このオプションはデフォルトで有効になっています。スカラー演算のスーパーワード演算への変換を無効にするには、\fB\-XX:\-UseSuperWord\fRを指定します。Java HotSpot Server VMのみが、このオプションをサポートしています。 +.RE +.SS "試験的なJITコンパイラ・オプション" +.PP +この項のRestricted Transactional Memory (RTM)のロック機能に関連するオプションは試験的なもので、Java SE 8u20で正式にサポートされていません。これらを使用するには、\fB\-XX:+UnlockExperimentalVMOptions\fRオプションを有効化する必要があります。これらのオプションは、Transactional Synchronization Extensions (TSX)をサポートするx86 CPU上のJava HotSpot Server VMに対してのみ使用可能です。 +.PP +\-XX:RTMAbortRatio=\fIabort_ratio\fR +.RS 4 +RTM中止率は、すべての実行済RTMトランザクションに対するパーセンテージ(%)として指定されます。中止されたトランザクション数がこの率を超えた場合、コンパイルされたコードが非最適化されます。この率は、\fB\-XX:+UseRTMDeopt\fRオプションが有効な場合に使用されます。このオプションのデフォルト値は50です。つまり、すべてのトランザクションの50%が中止された場合、コンパイルされたコードが非最適化されます。 +.RE +.PP +\-XX:RTMRetryCount=\fInumber_of_retries\fR +.RS 4 +中止またはビジーの場合、RTMロック・コードは、標準のロック・メカニズムにフォールバックする前にこのオプションによって指定された回数再試行されます。このオプションのデフォルト値は5です。\fB\-XX:UseRTMLocking\fRオプションを有効化する必要があります。 +.RE +.PP +\-XX:+UseRTMDeopt +.RS 4 +中止率に応じて、RTMロックを自動調整します。この率は、\fB\-XX:RTMAbortRatio\fRオプションによって指定されます。中止されたトランザクション数が中止率を超えた場合、ロックを含むメソッドがすべてのロックで標準のロックとして非最適化および再コンパイルされます。このオプションは、デフォルトでは無効になっています。\fB\-XX:UseRTMLocking\fRオプションを有効化する必要があります。 +.RE +.PP +\-XX:+UseRTMLocking +.RS 4 +フォールバック・ハンドラとして標準のロック・メカニズムを使用して、展開されたすべてのロックに対してRestricted Transactional Memory (RTM)ロック・コードを生成します。このオプションは、デフォルトでは無効になっています。 +.sp +RTMは、x86命令セット拡張でマルチスレッド・アプリケーションの作成を容易にするIntelのTransactional Synchronization Extensions (TSX)の一部です。RTMでは、新しい命令 +\fBXBEGIN\fR、\fBXABORT\fR、\fBXEND\fRおよび\fBXTEST\fRが導入されています。\fBXBEGIN\fRおよび\fBXEND\fR命令は、トランザクションとして実行するための命令セットを囲みます。トランザクションの実行時に競合が見つからなかった場合、メモリーとレジスタの変更が、\fBXEND\fR命令で同時にコミットされます。\fBXABORT\fR命令ではトランザクションを明示的に中止でき、\fBXEND\fR命令では命令セットがトランザクション内で実行中かどうかを確認できます。 +.sp +トランザクションのロックは、別のスレッドが同じトランザクションにアクセスしようとしたときに展開されます。したがって、そのトランザクションへのアクセスを最初にリクエストしなかったスレッドはブロックされます。RTMでは、トランザクションが中止または失敗した場合のために、フォールバックの操作セットを指定する必要があります。RTMロックとは、TSXのシステムに委譲されているロックです。 +.sp +RTMにより、重要なリージョンにおいて衝突が少なく競合度の高いロックのパフォーマンスが向上されます(これは、複数のスレッドによって同時にアクセスできないコードです)。また、RTMにより、粗粒度ロックのパフォーマンスも向上されますが、一般的にマルチスレッド・アプリケーションでのパフォーマンスはよくありません。(粗粒度ロックとは、ロックの取得および解放のオーバーヘッドを最小化するために長い期間ロックを保持する戦略であり、一方、細粒度ロックとは必要な場合のみロックし可能なかぎり早期にロック解除することで最大限の並行処理の達成を試みる戦略です。)さらに、異なるスレッドによって使用されている軽度な競合ロックの場合、RTMにより、誤ったキャッシュ・ライン共有(キャッシュ・ライン・ピンポンとも呼ばれる)を削減できます。これは、異なるプロセッサからの複数のスレッドが異なるリソースにアクセスしている場合に発生しますが、リソースは同じキャッシュ・ラインを共有します。結果として、プロセッサは他のプロセッサのキャッシュ・ラインを繰り返し無効にし、これにより、キャッシュではなくメイン・メモリーからの読取りが強制されます。 +.RE +.SS "高度なサービスアビリティ・オプション" +.PP +これらのオプションは、システム情報を収集し、詳細なデバッグを実行する機能を提供します。 +.PP +\-XX:+ExtendedDTraceProbes +.RS 4 +パフォーマンスに影響を与える追加の\fBdtrace\fRツール・プローブを有効にします。デフォルトでは、このオプションは無効になっており、\fBdtrace\fRは標準プローブのみを実行します。 +.RE +.PP +\-XX:+HeapDumpOnOutOfMemory +.RS 4 +\fBjava\&.lang\&.OutOfMemoryError\fR例外がスローされた場合に、ヒープ・プロファイラ(HPROF)を使用して、現在のディレクトリ内のファイルへのJavaヒープのダンプを有効にします。\fB\-XX:HeapDumpPath\fRオプションを使用して、ヒープ・ダンプ・ファイルのパスおよび名前を明示的に設定できます。デフォルトでは、このオプションは無効であり、\fBOutOfMemoryError\fR例外がスローされた場合にヒープはダンプされません。 +.RE +.PP +\-XX:HeapDumpPath=\fIpath\fR +.RS 4 +\fB\-XX:+HeapDumpOnOutOfMemoryError\fRオプションが設定されている場合、ヒープ・プロファイラ(HPROF)が提供するヒープ・ダンプを書き込むパスおよびファイル名を設定します。デフォルトでは、このファイルは、現在の作業ディレクトリに作成され、名前は\fBjava_pid\fR\fIpid\fR\fB\&.hprof\fR +(\fIpid\fRはエラーの原因となったプロセスの識別子)になります。次の例では、デフォルトのファイルを明示的に設定する方法を示します(\fB%p\fRは現在のプロセスの識別子を表します)。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:HeapDumpPath=\&./java_pid%p\&.hprof\fR + +.fi +.if n \{\ +.RE +.\} +次の例では、ヒープ・ダンプ・ファイルを\fB/var/log/java/java_heapdump\&.hprof\fRに設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:HeapDumpPath=/var/log/java/java_heapdump\&.hprof\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:LogFile=\fIpath\fR +.RS 4 +ログ・データが書き込まれるパスおよびファイル名を設定します。デフォルトでは、ファイルは現在の作業ディレクトリに作成され、名前は\fBhotspot\&.log\fRです。 +.sp +次の例では、ログ・ファイルを\fB/var/log/java/hotspot\&.log\fRに設定する方法を示します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-XX:LogFile=/var/log/java/hotspot\&.log\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\-XX:+PrintClassHistogram +.RS 4 +\fB[Control]+[C]\fRイベント(\fBSIGTERM\fR)後にクラス・インスタンスのヒストグラムの印刷を有効にします。デフォルトでは、このオプションは無効です。 +.sp +このオプションを設定すると、\fBjmap \-histo\fRコマンド、または\fBjcmd \fR\fIpid\fR\fB GC\&.class_histogram\fRコマンド(\fIpid\fRは現在のJavaプロセスの識別子)を実行する場合と同じになります。 +.RE +.PP +\-XX:+PrintConcurrentLocks +.RS 4 +次の印刷を有効化します: j ロック(次の後) \- イベント。デフォルトでは、このオプションは無効です。 +.sp +\fB[Control]+[C]\fRイベント(\fBSIGTERM\fR)後に\fBjava\&.util\&.concurrent\fRロックの印刷を有効にします。デフォルトでは、このオプションは無効です。 +.sp +このオプションを設定すると、\fBjstack \-l\fRコマンド、または\fBjcmd \fR\fIpid\fR\fB Thread\&.print \-l\fRコマンド(\fIpid\fRは現在のJavaプロセスの識別子)を実行する場合と同じになります。 +.RE +.PP +\-XX:+UnlockDiagnosticVMOptions +.RS 4 +JVMの診断を目的としたオプションをアンロックします。デフォルトでは、このオプションは無効であり、診断オプションは使用できません。 +.RE +.SS "高度なガベージ・コレクション・オプション" +.PP +これらのオプションは、ガベージ・コレクション(GC)がJava HotSpot VMによってどのように実行されるかを制御します。 +.PP +\-XX:+AggressiveHeap +.RS 4 +Javaヒープの最適化を有効にします。これにより、コンピュータの構成(RAMおよびCPU)に基づいて、様々なパラメータが、メモリー割当てが集中した長時間実行ジョブに最適になるように設定されます。デフォルトでは、このオプションは無効であり、ヒープは最適化されません。 .RE .PP \-XX:+AlwaysPreTouch .RS 4 -JVMの初期化中にJavaヒープ上のすべてのページのタッチを有効にします。これにより、\fImain()\fRメソッドの入力前に、すべてのページがメモリーに取得されます。このオプションは、物理メモリーにマップされたすべての仮想メモリーを含む長時間実行のシステムをシミュレートするテストで使用できます。デフォルトでは、このオプションは無効になっており、JVMヒープ領域がいっぱいになると、すべてのページがコミットされます。 +JVMの初期化中にJavaヒープ上のすべてのページのタッチを有効にします。これにより、\fBmain()\fRメソッドの入力前に、すべてのページがメモリーに取得されます。このオプションは、物理メモリーにマップされたすべての仮想メモリーを含む長時間実行のシステムをシミュレートするテストで使用できます。デフォルトでは、このオプションは無効になっており、JVMヒープ領域がいっぱいになると、すべてのページがコミットされます。 .RE .PP \-XX:+CMSClassUnloadingEnabled .RS 4 -並行マークスイープ(CMS)ガベージ・コレクタを使用する場合に、アンロードするクラスを有効にします。このオプションはデフォルトで有効になっています。CMSガベージ・コレクタのクラス・アンロードを無効にするには、\fI\-XX:\-CMSClassUnloadingEnabled\fRを指定します。 +並行マークスイープ(CMS)ガベージ・コレクタを使用する場合に、アンロードするクラスを有効にします。このオプションはデフォルトで有効になっています。CMSガベージ・コレクタのクラス・アンロードを無効にするには、\fB\-XX:\-CMSClassUnloadingEnabled\fRを指定します。 .RE .PP \-XX:CMSExpAvgFactor=\fIpercent\fR @@ -1785,79 +1893,8 @@ .RS 4 .\} .nf -\-XX:CMSExpAvgFactor=15 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:CMSIncrementalDutyCycle=\fIpercent\fR -.RS 4 -並行コレクタの実行が許可されているマイナー・コレクション間の時間の割合(0から100まで)を設定します。\fI\-XX:+CMSIncrementalPacing\fRが有効な場合、デューティ・サイクルが自動的に設定され、このオプションは初期値のみを設定します。 -.sp -デフォルトでは、デューティ・サイクルは10%に設定されています。次の例では、デューティ・サイクルを20%に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CMSIncrementalDutyCycle=20 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:CMSIncrementalDutyCycleMin=\fIpercent\fR -.RS 4 -\fI\-XX:+CMSIncrementalPacing\fRが有効な場合にデューティ・サイクルの下限であるマイナー・コレクション間の時間の割合(0から100まで)を設定します。デフォルトでは、デューティ・サイクルの下限は0%に設定されています。次の例では、下限を10%に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CMSIncrementalDutyCycleMin=10 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+CMSIncrementalMode -.RS 4 -CMSコレクタの増分モードを有効にします。このオプションはデフォルトで無効になっており、2つ以下のGCスレッドを持つ構成にのみ有効にする必要があります。\fICMSIncremental\fRで始まるすべてのオプションは、このオプションが有効な場合のみ、適用されます。 -.RE -.PP -\-XX:CMSIncrementalOffset=\fIpercent\fR -.RS 4 -増分モードのデューティ・サイクルをマイナー・コレクション間で期間内に右に移動する時間の割合(0から100まで)を設定します。デフォルトでは、オフセットは0%に設定されています。次の例では、デューティ・サイクルのオフセットを25%に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CMSIncrementalOffset=25 -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\-XX:+CMSIncrementalPacing -.RS 4 -JVMの実行中に収集された統計に基づいて、増分モードのデューティ・サイクルの自動調整を有効にします。このオプションはデフォルトで有効になっています。増分モード・デューティ・サイクルの自動調整を無効にするには、\fI\-XX:\-CMSIncrementalPacing\fRを指定します。 -.RE -.PP -\-XX:CMSIncrementalSafetyFactor=\fIpercent\fR -.RS 4 -デューティ・サイクルを計算する際に、保守を追加するために使用される時間の割合(0から100まで)を設定します。デフォルトでは、安全係数は10%に設定されています。次の例では、安全係数を5%に設定する方法を示します。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -\-XX:CMSIncrementalSafetyFactor=5 +\fB\-XX:CMSExpAvgFactor=15\fR + .fi .if n \{\ .RE @@ -1866,7 +1903,7 @@ .PP \-XX:CMSInitiatingOccupancyFraction=\fIpercent\fR .RS 4 -CMS収集サイクルを開始する古い世代の占有率(0から100まで)を設定します。デフォルト値は\-1に設定されています。負の値(デフォルトを含む)は、\fI\-XX:CMSTriggerRatio\fRが開始占有率の値を定義するために使用されることを意味します。 +CMS収集サイクルを開始する古い世代の占有率(0から100まで)を設定します。デフォルト値は\-1に設定されています。負の値(デフォルトを含む)は、\fB\-XX:CMSTriggerRatio\fRが開始占有率の値を定義するために使用されることを意味します。 .sp 次の例では、占有率を20%に設定する方法を示します。 .sp @@ -1874,7 +1911,8 @@ .RS 4 .\} .nf -\-XX:CMSInitiatingOccupancyFraction=20 +\fB\-XX:CMSInitiatingOccupancyFraction=20\fR + .fi .if n \{\ .RE @@ -1888,7 +1926,7 @@ .PP \-XX:CMSTriggerRatio=\fIpercent\fR .RS 4 -CMS収集サイクルが開始する前に割り当てられる\fI\-XX:MinHeapFreeRatio\fRによって指定される値の割合(0から100まで)を設定します。デフォルト値は80%に設定されています。 +CMS収集サイクルが開始する前に割り当てられる\fB\-XX:MinHeapFreeRatio\fRによって指定される値の割合(0から100まで)を設定します。デフォルト値は80%に設定されています。 .sp 次の例では、占有率を75%に設定する方法を示します。 .sp @@ -1896,7 +1934,8 @@ .RS 4 .\} .nf -\-XX:CMSTriggerRatio=75 +\fB\-XX:CMSTriggerRatio=75\fR + .fi .if n \{\ .RE @@ -1913,7 +1952,8 @@ .RS 4 .\} .nf -\-XX:ConcGCThreads=2 +\fB\-XX:ConcGCThreads=2\fR + .fi .if n \{\ .RE @@ -1922,17 +1962,17 @@ .PP \-XX:+DisableExplicitGC .RS 4 -\fISystem\&.gc()\fRの呼出しの処理を無効にするオプションを有効にします。このオプションはデフォルトで無効になっており、これは\fISystem\&.gc()\fRへの呼出しが処理されることを意味します。\fISystem\&.gc()\fRの呼出しの処理が無効になっている場合、JVMは必要に応じてGCを実行します。 +\fBSystem\&.gc()\fRの呼出しの処理を無効にするオプションを有効にします。このオプションはデフォルトで無効になっており、これは\fBSystem\&.gc()\fRへの呼出しが処理されることを意味します。\fBSystem\&.gc()\fRの呼出しの処理が無効になっている場合、JVMは必要に応じてGCを実行します。 .RE .PP \-XX:+ExplicitGCInvokesConcurrent .RS 4 -\fISystem\&.gc()\fRリクエストを使用することによって、並行GCの呼出しを有効にします。このオプションはデフォルトで無効になっており、\fI\-XX:+UseConcMarkSweepGC\fRオプションとともに使用する場合のみ、有効にすることができます。 +\fBSystem\&.gc()\fRリクエストを使用することによって、並行GCの呼出しを有効にします。このオプションはデフォルトで無効になっており、\fB\-XX:+UseConcMarkSweepGC\fRオプションとともに使用する場合のみ、有効にすることができます。 .RE .PP \-XX:+ExplicitGCInvokesConcurrentAndUnloadsClasses .RS 4 -\fISystem\&.gc()\fRリクエストを使用し、並行GCサイクル中にクラスをアンロードすることによって、並行GCの呼出しを有効にします。このオプションはデフォルトで無効になっており、\fI\-XX:+UseConcMarkSweepGC\fRオプションとともに使用する場合のみ、有効にすることができます。 +\fBSystem\&.gc()\fRリクエストを使用し、並行GCサイクル中にクラスをアンロードすることによって、並行GCの呼出しを有効にします。このオプションはデフォルトで無効になっており、\fB\-XX:+UseConcMarkSweepGC\fRオプションとともに使用する場合のみ、有効にすることができます。 .RE .PP \-XX:G1HeapRegionSize=\fIsize\fR @@ -1945,7 +1985,8 @@ .RS 4 .\} .nf -\-XX:G1HeapRegionSize=16m +\fB\-XX:G1HeapRegionSize=16m\fR + .fi .if n \{\ .RE @@ -1967,7 +2008,8 @@ .RS 4 .\} .nf -\-XX:G1ReservePercent=20 +\fB\-XX:G1ReservePercent=20\fR + .fi .if n \{\ .RE @@ -1976,7 +2018,7 @@ .PP \-XX:InitialHeapSize=\fIsize\fR .RS 4 -メモリー割当てプールの初期サイズ(バイト単位)を設定します。指定する値は、0、または1MBより大きい1024の倍数のいずれかにする必要があります。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 +メモリー割当てプールの初期サイズ(バイト単位)を設定します。指定する値は、0、または1MBより大きい1024の倍数のいずれかにする必要があります。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 .sp 次の例では、割り当てられたメモリーのサイズを様々な単位を使用して6MBに設定する方法を示します。 .sp @@ -1984,19 +2026,20 @@ .RS 4 .\} .nf -\-XX:InitialHeapSize=6291456 -\-XX:InitialHeapSize=6144k -\-XX:InitialHeapSize=6m +\fB\-XX:InitialHeapSize=6291456\fR +\fB\-XX:InitialHeapSize=6144k\fR +\fB\-XX:InitialHeapSize=6m\fR + .fi .if n \{\ .RE .\} -このオプションを0に設定した場合、初期サイズは、古い世代と若い世代に割り当てられたサイズの合計として設定されます。若い世代のヒープのサイズは、\fI\-XX:NewSize\fRオプションを使用して設定できます。 +このオプションを0に設定した場合、初期サイズは、古い世代と若い世代に割り当てられたサイズの合計として設定されます。若い世代のヒープのサイズは、\fB\-XX:NewSize\fRオプションを使用して設定できます。 .RE .PP \-XX:InitialSurvivorRatio=\fIratio\fR .RS 4 -スループット・ガベージ・コレクタが使用するサバイバ領域の初期比を設定します(\fI\-XX:+UseParallelGC\fRおよび/または\fI\-XX:+UseParallelOldGC\fRオプションによって有効になります)。\fI\-XX:+UseParallelGC\fRオプションおよび\fI\-XX:+UseParallelOldGC\fRオプションを使用することによって、スループット・ガベージ・コレクタで適応サイズ指定をデフォルトで有効にします。初期値から始めて、アプリケーションの動作に従って、サバイバ領域がサイズ変更されます。(\fI\-XX:\-UseAdaptiveSizePolicy\fRオプションを使用して)適応サイズ指定を無効にした場合、\fI\-XX:SurvivorRatio\fRオプションを使用して、アプリケーションの実行全体のサバイバ領域のサイズを設定する必要があります。 +スループット・ガベージ・コレクタが使用するサバイバ領域の初期比を設定します(\fB\-XX:+UseParallelGC\fRおよび/または\fB\-XX:+UseParallelOldGC\fRオプションによって有効になります)。\fB\-XX:+UseParallelGC\fRオプションおよび\fB\-XX:+UseParallelOldGC\fRオプションを使用することによって、スループット・ガベージ・コレクタで適応サイズ指定をデフォルトで有効にします。初期値から始めて、アプリケーションの動作に従って、サバイバ領域がサイズ変更されます。(\fB\-XX:\-UseAdaptiveSizePolicy\fRオプションを使用して)適応サイズ指定を無効にした場合、\fB\-XX:SurvivorRatio\fRオプションを使用して、アプリケーションの実行全体のサバイバ領域のサイズを設定する必要があります。 .sp 次の式を使用して、若い世代のサイズ(Y)およびサバイバ領域の初期比(R)に基づいて、サバイバ領域の初期サイズ(S)を計算できます。 .sp @@ -2004,7 +2047,8 @@ .RS 4 .\} .nf -S=Y/(R+2) +\fBS=Y/(R+2)\fR + .fi .if n \{\ .RE @@ -2019,7 +2063,8 @@ .RS 4 .\} .nf -\-XX:InitialSurvivorRatio=4 +\fB\-XX:InitialSurvivorRatio=4\fR + .fi .if n \{\ .RE @@ -2036,7 +2081,8 @@ .RS 4 .\} .nf -\-XX:InitiatingHeapOccupancyPercent=75 +\fB\-XX:InitiatingHeapOccupancyPercent=75\fR + .fi .if n \{\ .RE @@ -2053,7 +2099,8 @@ .RS 4 .\} .nf -\-XX:MaxGCPauseMillis=500 +\fB\-XX:MaxGCPauseMillis=500\fR + .fi .if n \{\ .RE @@ -2062,7 +2109,7 @@ .PP \-XX:MaxHeapSize=\fIsize\fR .RS 4 -メモリー割当てプールの最大サイズ(バイト単位)を設定します。指定する値は、2MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。サーバー・デプロイメントでは、\fI\-XX:InitialHeapSize\fRおよび\fI\-XX:MaxHeapSize\fRは通常同じ値に設定されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 +メモリー割当てプールの最大サイズ(バイト単位)を設定します。指定する値は、2MBより大きい1024の倍数にする必要があります。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。デフォルト値は、実行時にシステム構成に基づいて選択されます。サーバー・デプロイメントでは、\fB\-XX:InitialHeapSize\fRおよび\fB\-XX:MaxHeapSize\fRは通常同じ値に設定されます。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/vm/gc\-ergonomics\&.htmlにあるガベージ・コレクタ・エルゴノミックを参照してください。 .sp 次の例では、割り当てられたメモリーの許可される最大サイズを様々な単位を使用して80MBに設定する方法を示します。 .sp @@ -2070,16 +2117,17 @@ .RS 4 .\} .nf -\-XX:MaxHeapSize=83886080 -\-XX:MaxHeapSize=81920k -\-XX:MaxHeapSize=80m +\fB\-XX:MaxHeapSize=83886080\fR +\fB\-XX:MaxHeapSize=81920k\fR +\fB\-XX:MaxHeapSize=80m\fR + .fi .if n \{\ .RE .\} Oracle Solaris 7およびOracle Solaris 8 SPARCプラットフォームの場合のこの値の上限は、およそ4,000MBからオーバーヘッドの量を引いたものです。Oracle Solaris 2\&.6およびx86プラットフォームの場合の上限は、およそ2,000MBからオーバーヘッドの量を引いたものです。Linuxプラットフォームの場合の上限は、およそ2,000MBからオーバーヘッドの量を引いたものです。 .sp -\fI\-XX:MaxHeapSize\fRオプションは\fI\-Xmx\fRと同等です。 +\fB\-XX:MaxHeapSize\fRオプションは\fB\-Xmx\fRと同等です。 .RE .PP \-XX:MaxHeapFreeRatio=\fIpercent\fR @@ -2092,7 +2140,8 @@ .RS 4 .\} .nf -\-XX:MaxHeapFreeRatio=75 +\fB\-XX:MaxHeapFreeRatio=75\fR + .fi .if n \{\ .RE @@ -2109,7 +2158,8 @@ .RS 4 .\} .nf -\-XX:MaxMetaspaceSize=256m +\fB\-XX:MaxMetaspaceSize=256m\fR + .fi .if n \{\ .RE @@ -2131,7 +2181,8 @@ .RS 4 .\} .nf -\-XX:MaxTenuringThreshold=10 +\fB\-XX:MaxTenuringThreshold=10\fR + .fi .if n \{\ .RE @@ -2153,7 +2204,8 @@ .RS 4 .\} .nf -\-XX:MinHeapFreeRatio=25 +\fB\-XX:MinHeapFreeRatio=25\fR + .fi .if n \{\ .RE @@ -2168,7 +2220,8 @@ .RS 4 .\} .nf -\-XX:NewRatio=1 +\fB\-XX:NewRatio=1\fR + .fi .if n \{\ .RE @@ -2177,7 +2230,7 @@ .PP \-XX:NewSize=\fIsize\fR .RS 4 -若い世代(ナーサリ)のヒープの初期サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。 +若い世代(ナーサリ)のヒープの初期サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。 .sp ヒープの若い世代リージョンは新しいオブジェクトに使用されます。GCは、他のリージョンよりこのリージョンで、より頻繁に実行されます。若い世代のサイズが小さすぎる場合、多数のマイナーGCが実行されます。サイズが大きすぎる場合、フルGCのみが実行されますが、完了までに時間がかかることがあります。若い世代のサイズは、全体のヒープ・サイズの半分から4分の1の間にしておくことをお薦めします。 .sp @@ -2187,14 +2240,15 @@ .RS 4 .\} .nf -\-XX:NewSize=256m -\-XX:NewSize=262144k -\-XX:NewSize=268435456 +\fB\-XX:NewSize=256m\fR +\fB\-XX:NewSize=262144k\fR +\fB\-XX:NewSize=268435456\fR + .fi .if n \{\ .RE .\} -\fI\-XX:NewSize\fRオプションは\fI\-Xmn\fRと同等です。 +\fB\-XX:NewSize\fRオプションは\fB\-Xmn\fRと同等です。 .RE .PP \-XX:ParallelGCThreads=\fIthreads\fR @@ -2207,7 +2261,8 @@ .RS 4 .\} .nf -\-XX:ParallelGCThreads=2 +\fB\-XX:ParallelGCThreads=2\fR + .fi .if n \{\ .RE @@ -2239,7 +2294,7 @@ 休止(たとえばGC休止など)が継続した時間の出力を有効にします。デフォルトでは、このオプションは無効です。 .RE .PP -\-XX+PrintGCDateStamp +\-XX:+PrintGCDateStamps .RS 4 GCごとの日付スタンプの出力を有効にします。デフォルトでは、このオプションは無効です。 .RE @@ -2254,11 +2309,16 @@ 個々のGCワーカー・スレッド・タスクごとのタイムスタンプの出力を有効にします。デフォルトでは、このオプションは無効です。 .RE .PP -\-XX:+PrintGCTimeStamp +\-XX:+PrintGCTimeStamps .RS 4 GCごとのタイムスタンプの出力を有効にします。デフォルトでは、このオプションは無効です。 .RE .PP +\-XX:+PrintStringDeduplicationStatistics +.RS 4 +詳細な重複除外統計を印刷します。デフォルトでは、このオプションは無効です。\fB\-XX:+UseStringDeduplication\fRオプションを参照してください。 +.RE +.PP \-XX:+PrintTenuringDistribution .RS 4 殿堂入り期間情報の出力を有効にします。次に、出力の例を示します。 @@ -2267,11 +2327,12 @@ .RS 4 .\} .nf -Desired survivor size 48286924 bytes, new threshold 10 (max 10) -\- age 1: 28992024 bytes, 28992024 total -\- age 2: 1366864 bytes, 30358888 total -\- age 3: 1425912 bytes, 31784800 total -\&.\&.\&. +\fBDesired survivor size 48286924 bytes, new threshold 10 (max 10)\fR +\fB\- age 1: 28992024 bytes, 28992024 total\fR +\fB\- age 2: 1366864 bytes, 30358888 total\fR +\fB\- age 3: 1425912 bytes, 31784800 total\fR +\fB\&.\&.\&.\fR + .fi .if n \{\ .RE @@ -2285,12 +2346,12 @@ .PP \-XX:+ScavengeBeforeFullGC .RS 4 -それぞれのフルGCの前に若い世代のGCを有効にします。このオプションはデフォルトで有効になっています。フルGCの前に若い世代のスカベンジを行うと、古い世代領域から若い世代領域へのアクセスが可能なオブジェクトの数を減らすことができるため、これを無効に\fIしない\fRことをお薦めします。各フルGCの前に若い世代のGCを無効にするには、\fI\-XX:\-ScavengeBeforeFullGC\fRを指定します。 +それぞれのフルGCの前に若い世代のGCを有効にします。このオプションはデフォルトで有効になっています。フルGCの前に若い世代のスカベンジを行うと、古い世代領域から若い世代領域へのアクセスが可能なオブジェクトの数を減らすことができるため、これを無効に\fIしない\fRことをお薦めします。各フルGCの前に若い世代のGCを無効にするには、\fB\-XX:\-ScavengeBeforeFullGC\fRを指定します。 .RE .PP \-XX:SoftRefLRUPolicyMSPerMB=\fItime\fR .RS 4 -ソフト・アクセスが可能なオブジェクトが最後に参照されてからヒープ上でアクティブなままになっている時間(ミリ秒単位)を設定します。デフォルト値は、ヒープ内の空きメガバイト当たりで1秒の存続期間です。\fI\-XX:SoftRefLRUPolicyMSPerMB\fRオプションは、現在のヒープ・サイズ(Java HotSpot Client VM用)または最大可能ヒープ・サイズ(Java HotSpot Server VM用)の1メガバイト当たりのミリ秒を表す整数値を受け入れます。この違いは、Client VMは、ヒープを大きくするのではなく、ソフト参照をフラッシュする傾向があるのに対し、Server VMは、ソフト参照をフラッシュするのではなく、ヒープを大きくする傾向があることを意味します。後者の場合、\fI\-Xmx\fRオプションの値は、ソフト参照がどのくらい迅速にガベージ・コレクションされるかに重要な影響を及ぼします。 +ソフト・アクセスが可能なオブジェクトが最後に参照されてからヒープ上でアクティブなままになっている時間(ミリ秒単位)を設定します。デフォルト値は、ヒープ内の空きメガバイト当たりで1秒の存続期間です。\fB\-XX:SoftRefLRUPolicyMSPerMB\fRオプションは、現在のヒープ・サイズ(Java HotSpot Client VM用)または最大可能ヒープ・サイズ(Java HotSpot Server VM用)の1メガバイト当たりのミリ秒を表す整数値を受け入れます。この違いは、Client VMは、ヒープを大きくするのではなく、ソフト参照をフラッシュする傾向があるのに対し、Server VMは、ソフト参照をフラッシュするのではなく、ヒープを大きくする傾向があることを意味します。後者の場合、\fB\-Xmx\fRオプションの値は、ソフト参照がどのくらい迅速にガベージ・コレクションされるかに重要な影響を及ぼします。 .sp 次の例では、値を2\&.5秒に設定する方法を示します。 .sp @@ -2298,13 +2359,19 @@ .RS 4 .\} .nf -\-XX:SoftRefLRUPolicyMSPerMB=2500 +\fB\-XX:SoftRefLRUPolicyMSPerMB=2500\fR + .fi .if n \{\ .RE .\} .RE .PP +\-XX:StringDeduplicationAgeThreshold=\fIthreshold\fR +.RS 4 +指定した期間に到達しつつある\fBString\fRオブジェクトは、重複除外の候補とみなされます。オブジェクトの期間は、オブジェクトがガベージ・コレクションで存続した回数の測定値です。これは、殿堂入りと呼ばれる場合もあります。\fB\-XX:+PrintTenuringDistribution\fRオプションを参照してください。この期間に到達する前に古いヒープ・リージョンに昇格された\fBString\fRオブジェクトは、常に重複除外の候補とみなされます。このオプションのデフォルト値は\fB3\fRです。\fB\-XX:+UseStringDeduplication\fRオプションを参照してください。 +.RE +.PP \-XX:SurvivorRatio=\fIratio\fR .RS 4 Eden領域のサイズとサバイバ領域のサイズとの比率を設定します。デフォルトでは、このオプションは8に設定されています。次の例では、Eden/サバイバ領域の比率を4に設定する方法を示します。 @@ -2313,7 +2380,8 @@ .RS 4 .\} .nf -\-XX:SurvivorRatio=4 +\fB\-XX:SurvivorRatio=4\fR + .fi .if n \{\ .RE @@ -2330,7 +2398,8 @@ .RS 4 .\} .nf -\-XX:TargetSurvivorRatio=30 +\fB\-XX:TargetSurvivorRatio=30\fR + .fi .if n \{\ .RE @@ -2339,7 +2408,7 @@ .PP \-XX:TLABSize=\fIsize\fR .RS 4 -スレッド・ローカルな割当てバッファ(TLAB)の初期サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fIk\fRまたは\fIK\fR、メガバイトを示す場合は文字\fIm\fRまたは\fIM\fR、ギガバイトを示す場合は文字\fIg\fRまたは\fIG\fRを追加します。このオプションが0に設定されている場合、JVMでは初期サイズが自動的に選択されます。 +スレッド・ローカルな割当てバッファ(TLAB)の初期サイズ(バイト単位)を設定します。キロバイトを示す場合は文字\fBk\fRまたは\fBK\fR、メガバイトを示す場合は文字\fBm\fRまたは\fBM\fR、ギガバイトを示す場合は文字\fBg\fRまたは\fBG\fRを追加します。このオプションが0に設定されている場合、JVMでは初期サイズが自動的に選択されます。 .sp 次の例では、TLABの初期サイズを512KBに設定する方法を示します。 .sp @@ -2347,7 +2416,8 @@ .RS 4 .\} .nf -\-XX:TLABSize=512k +\fB\-XX:TLABSize=512k\fR + .fi .if n \{\ .RE @@ -2356,7 +2426,7 @@ .PP \-XX:+UseAdaptiveSizePolicy .RS 4 -適応世代サイズ指定の使用を有効にします。このオプションはデフォルトで有効になっています。適応世代サイズ指定を無効にするには、\fI\-XX:\-UseAdaptiveSizePolicy\fRを指定し、メモリー割当てプールのサイズを明示的に設定します(\fI\-XX:SurvivorRatio\fRオプションを参考にしてください)。 +適応世代サイズ指定の使用を有効にします。このオプションはデフォルトで有効になっています。適応世代サイズ指定を無効にするには、\fB\-XX:\-UseAdaptiveSizePolicy\fRを指定し、メモリー割当てプールのサイズを明示的に設定します(\fB\-XX:SurvivorRatio\fRオプションを参考にしてください)。 .RE .PP \-XX:+UseCMSInitiatingOccupancyOnly @@ -2366,43 +2436,43 @@ .PP \-XX:+UseConcMarkSweepGC .RS 4 -古い世代へのCMSガベージ・コレクタの使用を有効にします。アプリケーションの待機時間の要件を、スループット(\fI\-XX:+UseParallelGC\fR)ガベージ・コレクタによって満たすことができない場合、CMSガベージ・コレクタを使用することをお薦めします。G1ガベージ・コレクタ(\fI\-XX:+UseG1GC\fR)は別の代替となります。 +古い世代へのCMSガベージ・コレクタの使用を有効にします。アプリケーションの待機時間の要件を、スループット(\fB\-XX:+UseParallelGC\fR)ガベージ・コレクタによって満たすことができない場合、CMSガベージ・コレクタを使用することをお薦めします。G1ガベージ・コレクタ(\fB\-XX:+UseG1GC\fR)は別の代替となります。 .sp -デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。このオプションを有効にすると、\fI\-XX:+UseParNewGC\fRオプションが自動的に設定されます。 +デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。このオプションが有効な場合、\fB\-XX:+UseParNewGC\fRオプションは自動的に設定され、無効化しない必要がありますが、理由はJDK 8では\fB\-XX:+UseConcMarkSweepGC \-XX:\-UseParNewGC\fRオプションの組合せが非推奨であるためです。 .RE .PP \-XX:+UseG1GC .RS 4 -G1ガベージ・コレクタの使用を有効にします。これはサーバー形式のガベージ・コレクタで、大量のRAMを持つマルチプロセッサ・マシンを対象としています。高い確率でGC休止時間の目標を達成し、同時に適切なスループットも維持します。G1コレクタは、GC待機時間の限定された要件(安定した予測可能な0\&.5秒未満の休止時間)を持つ、大きいヒープ(約6GB以上のサイズ)が必要なアプリケーションに推奨されます。 +ガベージファースト(G1)・ガベージ・コレクタの使用を有効にします。これはサーバー形式のガベージ・コレクタで、大量のRAMを持つマルチプロセッサ・マシンを対象としています。高い確率でGC休止時間の目標を達成し、同時に適切なスループットも維持します。G1コレクタは、GC待機時間の限定された要件(安定した予測可能な0\&.5秒未満の休止時間)を持つ、大きいヒープ(約6GB以上のサイズ)が必要なアプリケーションに推奨されます。 .sp デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。 .RE .PP \-XX:+UseGCOverheadLimit .RS 4 -\fIOutOfMemoryError\fR例外がスローされるまでに、GCでJVMによって要した時間の割合を制限するポリシーの使用を有効にします。デフォルトでは、このオプションは有効になっており、ガベージ・コレクションに合計時間の98%より多く費やされ、ヒープのリカバリが2%未満である場合、パラレルGCによって\fIOutOfMemoryError\fRがスローされます。ヒープが小さい場合、この機能は、アプリケーションが長期間ほとんどまたはまったく進捗なく実行している状態を回避するために使用できます。このオプションを無効にするには、\fI\-XX:\-UseGCOverheadLimit\fRを指定します。 +\fBOutOfMemoryError\fR例外がスローされるまでに、GCでJVMによって要した時間の割合を制限するポリシーの使用を有効にします。デフォルトでは、このオプションは有効になっており、ガベージ・コレクションに合計時間の98%より多く費やされ、ヒープのリカバリが2%未満である場合、パラレルGCによって\fBOutOfMemoryError\fRがスローされます。ヒープが小さい場合、この機能は、アプリケーションが長期間ほとんどまたはまったく進捗なく実行している状態を回避するために使用できます。このオプションを無効にするには、\fB\-XX:\-UseGCOverheadLimit\fRを指定します。 .RE .PP \-XX:+UseNUMA .RS 4 -アプリケーションで短い待機時間のメモリーの使用を増加させることで、不均一なメモリー・アーキテクチャ(NUMA)を使用したマシン上のアプリケーションのパフォーマンス最適化を有効にします。デフォルトでは、このオプションは無効になっており、NUMAに対する最適化は行われません。このオプションは、パラレル・ガベージ・コレクタ(\fI\-XX:+UseParallelGC\fR)が使用されている場合のみ使用可能です。 +アプリケーションで短い待機時間のメモリーの使用を増加させることで、不均一なメモリー・アーキテクチャ(NUMA)を使用したマシン上のアプリケーションのパフォーマンス最適化を有効にします。デフォルトでは、このオプションは無効になっており、NUMAに対する最適化は行われません。このオプションは、パラレル・ガベージ・コレクタ(\fB\-XX:+UseParallelGC\fR)が使用されている場合のみ使用可能です。 .RE .PP \-XX:+UseParallelGC .RS 4 複数のプロセッサを利用してアプリケーションのパフォーマンスを向上させる、パラレル・スカベンジ・ガベージ・コレクタ(スループット・コレクタとも呼ばれる)の使用を有効にします。 .sp -デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。これを有効にした場合、明示的に無効にしないかぎり、\fI\-XX:+UseParallelOldGC\fRオプションが自動的に有効になります。 +デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。これを有効にした場合、明示的に無効にしないかぎり、\fB\-XX:+UseParallelOldGC\fRオプションが自動的に有効になります。 .RE .PP \-XX:+UseParallelOldGC .RS 4 -フルGCへのパラレル・ガベージ・コレクタの使用を有効にします。デフォルトでは、このオプションは無効です。これを有効にすると、\fI\-XX:+UseParallelGC\fRオプションが自動的に有効になります。 +フルGCへのパラレル・ガベージ・コレクタの使用を有効にします。デフォルトでは、このオプションは無効です。これを有効にすると、\fB\-XX:+UseParallelGC\fRオプションが自動的に有効になります。 .RE .PP \-XX:+UseParNewGC .RS 4 -若い世代でのコレクションへのパラレル・スレッドの使用を有効にします。デフォルトでは、このオプションは無効です。\fI\-XX:+UseConcMarkSweepGC\fRオプションを設定すると、これは自動的に有効になります。 +若い世代でのコレクションへのパラレル・スレッドの使用を有効にします。デフォルトでは、このオプションは無効です。\fB\-XX:+UseConcMarkSweepGC\fRオプションを設定すると、これは自動的に有効になります。JDK 8では、\fB\-XX:+UseConcMarkSweepGC\fRオプションを指定せずに\fB\-XX:+UseParNewGC\fRオプションを使用することは非推奨です。 .RE .PP \-XX:+UseSerialGC @@ -2410,17 +2480,59 @@ シリアル・ガベージ・コレクタの使用を有効にします。ガベージ・コレクションから特別な機能を必要としない、小規模で単純なアプリケーションの場合には、これは一般に最適な選択です。デフォルトでは、このオプションは無効になっており、コレクタは、マシンの構成およびJVMのタイプに基づいて、自動的に選択されます。 .RE .PP +\-XX:+UseStringDeduplication +.RS 4 +文字列の重複除外を有効化します。デフォルトでは、このオプションは無効です。このオプションを使用するには、ガベージファースト(G1)・ガベージ・コレクタを有効にする必要があります。\fB\-XX:+UseG1GC\fRオプションを参照してください。 +.sp +多くの\fBString\fRオブジェクトが同じであるということから、\fIString deduplication\fRにより、Javaヒープ上の\fBString\fRオブジェクトのメモリー・フットプリントが削減されます。各\fBString\fRオブジェクトが独自の文字配列をポイントするのではなく、同一の\fBString\fRオブジェクトは同じ文字配列をポイントし共有できます。 +.RE +.PP \-XX:+UseTLAB .RS 4 -若い世代の領域でのスレッド・ローカルな割当てブロック(TLAB)の使用を有効にします。このオプションはデフォルトで有効になっています。TLABの使用を無効にするには、\fI\-XX:\-UseTLAB\fRを指定します。 +若い世代の領域でのスレッド・ローカルな割当てブロック(TLAB)の使用を有効にします。このオプションはデフォルトで有効になっています。TLABの使用を無効にするには、\fB\-XX:\-UseTLAB\fRを指定します。 .RE .SS "非推奨で削除されたオプション" .PP これらのオプションは、以前のリリースには含まれていましたが、以降は不要とみなされています。 .PP +\-Xincgc +.RS 4 +インクリメンタル・ガベージ・コレクションを有効にします。このオプションはJDK 8では非推奨で、それに代わるものはありません。 +.RE +.PP \-Xrun\fIlibname\fR .RS 4 -指定したデバッグ/プロファイルのライブラリをロードします。このオプションは、\fI\-agentlib\fRオプションに取って代わられました。 +指定したデバッグ/プロファイルのライブラリをロードします。このオプションは、\fB\-agentlib\fRオプションに取って代わられました。 +.RE +.PP +\-XX:CMSIncrementalDutyCycle=\fIpercent\fR +.RS 4 +並行コレクタの実行が許可されているマイナー・コレクション間の時間の割合(0から100まで)を設定します。\fB\-XX:+CMSIncrementalMode\fRオプションの非推奨を受けて、このオプションはJDK 8では非推奨となり、それに代わるものはありません。 +.RE +.PP +\-XX:CMSIncrementalDutyCycleMin=\fIpercent\fR +.RS 4 +\fB\-XX:+CMSIncrementalPacing\fRが有効な場合にデューティ・サイクルの下限であるマイナー・コレクション間の時間の割合(0から100まで)を設定します。\fB\-XX:+CMSIncrementalMode\fRオプションの非推奨を受けて、このオプションはJDK 8では非推奨となり、それに代わるものはありません。 +.RE +.PP +\-XX:+CMSIncrementalMode +.RS 4 +CMSコレクタの増分モードを有効にします。\fBCMSIncremental\fRで始まるその他のオプションとともに、このオプションはJDK 8では非推奨となり、それに代わるものはありません +.RE +.PP +\-XX:CMSIncrementalOffset=\fIpercent\fR +.RS 4 +増分モードのデューティ・サイクルをマイナー・コレクション間で期間内に右に移動する時間の割合(0から100まで)を設定します。\fB\-XX:+CMSIncrementalMode\fRオプションの非推奨を受けて、このオプションはJDK 8では非推奨となり、それに代わるものはありません。 +.RE +.PP +\-XX:+CMSIncrementalPacing +.RS 4 +JVMの実行中に収集された統計に基づいて、増分モードのデューティ・サイクルの自動調整を有効にします。\fB\-XX:+CMSIncrementalMode\fRオプションの非推奨を受けて、このオプションはJDK 8では非推奨となり、それに代わるものはありません。 +.RE +.PP +\-XX:CMSIncrementalSafetyFactor=\fIpercent\fR +.RS 4 +デューティ・サイクルを計算する際に、保守を追加するために使用される時間の割合(0から100まで)を設定します。\fB\-XX:+CMSIncrementalMode\fRオプションの非推奨を受けて、このオプションはJDK 8では非推奨となり、それに代わるものはありません。 .RE .PP \-XX:CMSInitiatingPermOccupancyFraction=\fIpercent\fR @@ -2430,12 +2542,12 @@ .PP \-XX:MaxPermSize=\fIsize\fR .RS 4 -永久世代領域の最大サイズ(バイト単位)を設定します。このオプションは、JDK 8で非推奨になり、\fI\-XX:MaxMetaspaceSize\fRオプションに取って代わられました。 +永久世代領域の最大サイズ(バイト単位)を設定します。このオプションは、JDK 8で非推奨になり、\fB\-XX:MaxMetaspaceSize\fRオプションに取って代わられました。 .RE .PP \-XX:PermSize=\fIsize\fR .RS 4 -超えた場合にはガベージ・コレクションをトリガーする、永久世代に割り当てられた領域(バイト単位)を設定します。このオプションは、JDK 8で非推奨になり、\fI\-XX:MetaspaceSize\fRオプションに取って代わられました。 +超えた場合にはガベージ・コレクションをトリガーする、永久世代に割り当てられた領域(バイト単位)を設定します。このオプションは、JDK 8で非推奨になり、\fB\-XX:MetaspaceSize\fRオプションに取って代わられました。 .RE .PP \-XX:+UseSplitVerifier @@ -2451,28 +2563,34 @@ .PP 次の例では、スループットの最適化またはレスポンス時間の短縮化のいずれかを行うための、試験的なチューニング・フラグの使用方法を示します。 .PP -\fBExample 1\fR, スループットを向上するためのチューニング +\fB例 1\fR +.br +スループットを向上するためのチューニング .RS 4 .sp .if n \{\ .RS 4 .\} .nf -java \-d64 \-server \-XX:+AggressiveOpts \-XX:+UseLargePages \-Xmn10g \-Xms26g \-Xmx26g +\fBjava \-d64 \-server \-XX:+AggressiveOpts \-XX:+UseLargePages \-Xmn10g \-Xms26g \-Xmx26g\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 2\fR, レスポンス時間を速くするためのチューニング +\fB例 2\fR +.br +レスポンス時間を速くするためのチューニング .RS 4 .sp .if n \{\ .RS 4 .\} .nf -java \-d64 \-XX:+UseG1GC \-Xms26g Xmx26g \-XX:MaxGCPauseMillis=500 \-XX:+PrintGCTimeStamp +\fBjava \-d64 \-XX:+UseG1GC \-Xms26g Xmx26g \-XX:MaxGCPauseMillis=500 \-XX:+PrintGCTimeStamp\fR + .fi .if n \{\ .RE @@ -2480,7 +2598,7 @@ .RE .SH "終了ステータス" .PP -通常、次の終了値が起動ツールから返されるのは、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいはJVMにより例外がスローされた場合です。ただし、Javaアプリケーションは、API呼出し\fISystem\&.exit(exitValue)\fRを使用して任意の値を返すことを選択することもできます。値は次のとおりです。 +通常、次の終了値が起動ツールから返されるのは、起動元が不正な引数で呼び出されたか、深刻なエラーが発生したか、あるいはJVMにより例外がスローされた場合です。ただし、Javaアプリケーションは、API呼出し\fBSystem\&.exit(exitValue)\fRを使用して任意の値を返すことを選択することもできます。値は次のとおりです。 .sp .RS 4 .ie n \{\ @@ -2490,7 +2608,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI0\fR: 正常終了 +\fB0\fR: 正常終了 .RE .sp .RS 4 @@ -2501,7 +2619,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI>0\fR: エラー発生 +\fB>0\fR: エラー発生 .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/javac.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/javac.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: javac -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,8 +21,16 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 -.TH "javac" "1" "2013年11月21日" "JDK 8" "基本ツール" +.\" Title: javac +.\" Language: Japanese +.\" Date: 2014年8月8日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 +.TH "javac" "1" "2014年8月8日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" javac \- Javaクラスおよびインタフェースの定義を読み取り、バイトコードおよびクラス・ファイルにコンパイルします。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjavac\fR [ \fIoptions\fR ] [ \fIsourcefiles\fR ] [ \fIclasses\fR] [ \fI@argfiles\fR ] +\fBjavac\fR [ \fIoptions\fR ] [ \fIsourcefiles\fR ] [ \fIclasses\fR] [ \fI@argfiles\fR ] .fi .if n \{\ .RE @@ -66,28 +68,28 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIsourcefiles\fR .RS 4 -コンパイルされる1つ以上のソース・ファイル(\fIMyClass\&.java\fRなど)。 +コンパイルされる1つ以上のソース・ファイル(\fBMyClass\&.java\fRなど)。 .RE .PP \fIclasses\fR .RS 4 -注釈の処理対象となる1つ以上のクラス(\fIMyPackage\&.MyClass\fRなど)。 +注釈の処理対象となる1つ以上のクラス(\fBMyPackage\&.MyClass\fRなど)。 .RE .PP \fI@argfiles\fR .RS 4 -オプションとソース・ファイルを一覧表示する1つ以上のファイル。このファイルの中では\fI\-J\fRオプションは指定できません。コマンドライン引数ファイルを参照してください。 +オプションとソース・ファイルを一覧表示する1つ以上のファイル。このファイルの中では\fB\-J\fRオプションは指定できません。コマンド行引数ファイルを参照してください。 .RE .SH "説明" .PP -\fIjavac\fRコマンドは、Javaプログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラス・ファイルにコンパイルします。\fIjavac\fRコマンドでは、Javaソース・ファイルおよびクラス内の注釈の処理もできます。 +\fBjavac\fRコマンドは、Javaプログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラス・ファイルにコンパイルします。\fBjavac\fRコマンドでは、Javaソース・ファイルおよびクラス内の注釈の処理もできます。 .PP -ソース・コードのファイル名を\fIjavac\fRに渡すには、2つの方法があります。 +ソース・コードのファイル名を\fBjavac\fRに渡すには、2つの方法があります。 .sp .RS 4 .ie n \{\ @@ -97,7 +99,7 @@ .sp -1 .IP \(bu 2.3 .\} -ソース・ファイルの数が少ない場合は、ファイル名をコマンドラインで指定します。 +ソース・ファイルの数が少ない場合は、ファイル名をコマンド行で指定します。 .RE .sp .RS 4 @@ -108,19 +110,19 @@ .sp -1 .IP \(bu 2.3 .\} -ソース・ファイルの数が多い場合は、ファイル内のファイル名を空白または改行で区切って指定します。\fIjavac\fRコマンドで、リスト・ファイル名の先頭にアットマーク(@)を使用します。 +ソース・ファイルの数が多い場合は、ファイル内のファイル名を空白または改行で区切って指定します。\fBjavac\fRコマンドで、リスト・ファイル名の先頭にアットマーク(@)を使用します。 .RE .PP -ソース・コードのファイル名は\&.java拡張子を、クラスのファイル名は\&.class拡張子を持っている必要があります。また、ソース・ファイルとクラス・ファイルのどちらも、該当するクラスに対応するルート名を持っている必要があります。たとえば、\fIMyClass\fRという名前のクラスは、\fIMyClass\&.java\fRという名前のソース・ファイルに記述されます。このソース・ファイルは、\fIMyClass\&.class\fRという名前のバイトコード・クラス・ファイルにコンパイルされます。 +ソース・コードのファイル名は\&.java拡張子を、クラスのファイル名は\&.class拡張子を持っている必要があります。また、ソース・ファイルとクラス・ファイルのどちらも、該当するクラスに対応するルート名を持っている必要があります。たとえば、\fBMyClass\fRという名前のクラスは、\fBMyClass\&.java\fRという名前のソース・ファイルに記述されます。このソース・ファイルは、\fBMyClass\&.class\fRという名前のバイトコード・クラス・ファイルにコンパイルされます。 .PP -内部クラスが定義されていると、追加のクラス・ファイルが生成されます。これらのクラス・ファイルの名前は、\fIMyClass$MyInnerClass\&.class\fRのように、内部クラス名と外部クラス名を組み合せたものになります。 +内部クラスが定義されていると、追加のクラス・ファイルが生成されます。これらのクラス・ファイルの名前は、\fBMyClass$MyInnerClass\&.class\fRのように、内部クラス名と外部クラス名を組み合せたものになります。 .PP -ソース・ファイルは、パッケージ・ツリーを反映したディレクトリ・ツリーに配置します。たとえば、すべてのソース・ファイルが\fI/workspace\fRにある場合、\fIcom\&.mysoft\&.mypack\&.MyClass\fRのソース・コードを、\fI/workspace/com/mysoft/mypack/MyClass\&.java\fRに格納します。 +ソース・ファイルは、パッケージ・ツリーを反映したディレクトリ・ツリーに配置します。たとえば、すべてのソース・ファイルが\fB/workspace\fRにある場合、\fBcom\&.mysoft\&.mypack\&.MyClass\fRのソース・コードを、\fB/workspace/com/mysoft/mypack/MyClass\&.java\fRに格納します。 .PP -デフォルトでは、コンパイラは、各クラス・ファイルを対応するソース・ファイルと同じディレクトリに格納します。\fI\-d\fRオプションを使用して、別の出力先ディレクトリを指定できます。 +デフォルトでは、コンパイラは、各クラス・ファイルを対応するソース・ファイルと同じディレクトリに格納します。\fB\-d\fRオプションを使用して、別の出力先ディレクトリを指定できます。 .SH "オプション" .PP -コンパイラには、現在の開発環境でサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来、変更される可能性があります。非標準オプションは、\fI\-X\fRオプションで始まります。 +コンパイラには、現在の開発環境でサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来、変更される可能性があります。非標準オプションは、\fB\-X\fRオプションで始まります。 .sp .RS 4 .ie n \{\ @@ -130,7 +132,7 @@ .sp -1 .IP \(bu 2.3 .\} -クロスコンパイル・オプションを参照してください。 +クロスコンパイル・オプションも参照してください .RE .sp .RS 4 @@ -141,22 +143,22 @@ .sp -1 .IP \(bu 2.3 .\} -非標準オプションを参照してください。 +非標準オプションも参照してください .RE .SS "標準オプション" .PP \-A\fIkey\fR[\fI=value\fR] .RS 4 -注釈プロセッサに渡すオプションを指定します。これらのオプションは、\fIjavac\fRが直接解釈するのではなく、それぞれのプロセッサで使用できるようになります。\fIkey\fRの値は、1つまたは複数の識別子をドット(\&.)で区切る必要があります。 +注釈プロセッサに渡すオプションを指定します。これらのオプションは、\fBjavac\fRが直接解釈するのではなく、それぞれのプロセッサで使用できるようになります。\fBkey\fRの値は、1つまたは複数の識別子をドット(\&.)で区切る必要があります。 .RE .PP \-cp \fIpath\fR or \-classpath \fIpath\fR .RS 4 -ユーザー・クラス・ファイル、および(オプションで)注釈プロセッサとソース・ファイルを検索する場所を指定します。このクラス・パスは\fICLASSPATH\fR環境変数のユーザー・クラス・パスをオーバーライドします。\fICLASSPATH\fR、\fI\-cp\fR、\fI\-classpath\fRのいずれも指定されていない場合、ユーザーの\fIクラス・パス\fRは、現在のディレクトリになります。Setting the Class Path を参照してください。 +ユーザー・クラス・ファイル、および(オプションで)注釈プロセッサとソース・ファイルを検索する場所を指定します。このクラス・パスは\fBCLASSPATH\fR環境変数のユーザー・クラス・パスをオーバーライドします。\fBCLASSPATH\fR、\fB\-cp\fR、\fB\-classpath\fRのいずれも指定されていない場合、ユーザーの\fIクラス・パス\fRは、現在のディレクトリになります。Setting the Class Path を参照してください。 .sp -\fI\-sourcepath\fRオプションが指定されていない場合、ソース・ファイルもユーザー・クラス・パスから検索されます。 +\fB\-sourcepath\fRオプションが指定されていない場合、ソース・ファイルもユーザー・クラス・パスから検索されます。 .sp -\fI\-processorpath\fRオプションが指定されていない場合、注釈プロセッサもクラス・パスから検索されます。 +\fB\-processorpath\fRオプションが指定されていない場合、注釈プロセッサもクラス・パスから検索されます。 .RE .PP \-Djava\&.ext\&.dirs=\fIdirectories\fR @@ -171,12 +173,12 @@ .PP \-d \fIdirectory\fR .RS 4 -クラス・ファイルの出力先ディレクトリを設定します。そのディレクトリは\fIjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、\fIjavac\fRは、パッケージ名を反映したサブディレクトリ内にクラス・ファイルを格納し、必要に応じてディレクトリを作成します。 +クラス・ファイルの出力先ディレクトリを設定します。そのディレクトリは\fBjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、\fBjavac\fRは、パッケージ名を反映したサブディレクトリ内にクラス・ファイルを格納し、必要に応じてディレクトリを作成します。 .sp -\fI\-d\fR -\fI/home/myclasses\fRと指定し、クラスの名前が\fIcom\&.mypackage\&.MyClass\fRである場合、クラス・ファイルは\fI/home/myclasses/com/mypackage/MyClass\&.class\fRになります。 +\fB\-d\fR +\fB/home/myclasses\fRと指定し、クラスの名前が\fBcom\&.mypackage\&.MyClass\fRである場合、クラス・ファイルは\fB/home/myclasses/com/mypackage/MyClass\&.class\fRになります。 .sp -\fI\-d\fRオプションが指定されなかった場合、\fIjavac\fRは、各クラス・ファイルを、その生成元となるソース・ファイルと同じディレクトリ内に格納します。 +\fI\-d\fRオプションが指定されなかった場合、\fBjavac\fRは、各クラス・ファイルを、その生成元となるソース・ファイルと同じディレクトリ内に格納します。 .sp \fB注意:\fR \fI\-d\fRオプションによって指定されたディレクトリは、ユーザー・クラス・パスに自動的に追加されません。 @@ -184,12 +186,12 @@ .PP \-deprecation .RS 4 -非推奨のメンバーまたはクラスが使用またはオーバーライドされるたびに、説明を表示します。\fI\-deprecation\fRオプションが指定されていない場合、\fIjavac\fRは、非推奨のメンバーまたはクラスを使用またはオーバーライドしているソース・ファイルのサマリーを表示します。\fI\-deprecation\fRオプションは、\fI\-Xlint:deprecation\fRの省略表記です。 +非推奨のメンバーまたはクラスが使用またはオーバーライドされるたびに、説明を表示します。\fB\-deprecation\fRオプションが指定されていない場合、\fBjavac\fRは、非推奨のメンバーまたはクラスを使用またはオーバーライドしているソース・ファイルのサマリーを表示します。\fB\-deprecation\fRオプションは、\fB\-Xlint:deprecation\fRの省略表記です。 .RE .PP \-encoding \fIencoding\fR .RS 4 -ソース・ファイルのエンコーディング名(EUC\-JPやUTF\-8など)を設定します。\fI\-encoding\fRオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。 +ソース・ファイルのエンコーディング名(EUC\-JPやUTF\-8など)を設定します。\fB\-encoding\fRオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。 .RE .PP \-endorseddirs \fIdirectories\fR @@ -199,7 +201,7 @@ .PP \-extdirs \fIdirectories\fR .RS 4 -\fIext\fRディレクトリの位置をオーバーライドします。directories変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各JARファイルから、クラス・ファイルが検索されます。検出されたすべてのJARファイルは、クラス・パスの一部になります。 +\fBext\fRディレクトリの位置をオーバーライドします。directories変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各JARファイルから、クラス・ファイルが検索されます。検出されたすべてのJARファイルは、クラス・パスの一部になります。 .sp クロスコンパイル(異なるJavaプラットフォームに実装されたブートストラップ・クラスや拡張機能クラスに対してコンパイルを行う)を実行する場合、このオプションには拡張機能クラスを含むディレクトリを指定します。詳細はクロスコンパイル・オプションを参照してください。 .RE @@ -241,30 +243,30 @@ .PP \-implicit:[\fIclass, none\fR] .RS 4 -暗黙的にロードされたソース・ファイルに対するクラス・ファイルの生成を制御します。クラス・ファイルを自動生成するには、\fI\-implicit:class\fRを使用します。クラス・ファイルの生成を抑制するには、\fI\-implicit:none\fRを使用します。このオプションが指定されなかった場合のデフォルト動作は、クラス・ファイルの自動生成になります。その場合、そのようなクラス・ファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。\fI\-implicit\fRオプションが明示的に設定された場合、警告は発行されません。型の検索を参照してください。 +暗黙的にロードされたソース・ファイルに対するクラス・ファイルの生成を制御します。クラス・ファイルを自動生成するには、\fB\-implicit:class\fRを使用します。クラス・ファイルの生成を抑制するには、\fB\-implicit:none\fRを使用します。このオプションが指定されなかった場合のデフォルト動作は、クラス・ファイルの自動生成になります。その場合、そのようなクラス・ファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。\fB\-implicit\fRオプションが明示的に設定された場合、警告は発行されません。型の検索を参照してください。 .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシン(JVM)に\fIoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machine (JVM)に\fBoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .sp \fB注意:\fR -\fICLASSPATH\fR、\fI\-classpath\fR、\fI\-bootclasspath\fRおよび\fI\-extdirs\fRオプションは、\fIjavac\fRの実行に使用されるクラスを指定しません。これらのオプションおよび変数を使用してコンパイラの実装をカスタマイズしようとすると、リスクが高く、多くの場合、必要な処理が実行されません。コンパイラの実装をカスタマイズする必要がある場合、\fI\-J\fRオプションを使用して、基礎となるJava起動ツールにオプションを渡します。 +\fICLASSPATH\fR、\fB\-classpath\fR、\fB\-bootclasspath\fRおよび\fB\-extdirs\fRオプションは、\fBjavac\fRの実行に使用されるクラスを指定しません。これらのオプションおよび変数を使用してコンパイラの実装をカスタマイズしようとすると、リスクが高く、多くの場合、必要な処理が実行されません。コンパイラの実装をカスタマイズする必要がある場合、\fB\-J\fRオプションを使用して、基礎となるJava起動ツールにオプションを渡します。 .RE .PP \-nowarn .RS 4 -警告メッセージを無効にします。このオプションは、\fI\-Xlint:none\fRオプションと同じように動作します。 +警告メッセージを無効にします。このオプションは、\fB\-Xlint:none\fRオプションと同じように動作します。 .RE .PP \-parameters .RS 4 -リフレクションAPIのメソッド\fIjava\&.lang\&.reflect\&.Executable\&.getParameters\fRが取得できるように、生成されるクラス・ファイル内のコンストラクタとメソッドの仮パラメータ名を格納します。 +リフレクションAPIのメソッド\fBjava\&.lang\&.reflect\&.Executable\&.getParameters\fRが取得できるように、生成されるクラス・ファイル内のコンストラクタとメソッドの仮パラメータ名を格納します。 .RE .PP \-proc: [\fInone\fR, \fIonly\fR] .RS 4 -注釈処理およびコンパイルを実行するかを制御します。\fI\-proc:none\fRは、注釈処理なしでコンパイルが実行されることを意味します。\fI\-proc:only\fRは、注釈処理のみが実行され、後続のコンパイルはまったく実行されないことを意味します。 +注釈処理およびコンパイルを実行するかを制御します。\fB\-proc:none\fRは、注釈処理なしでコンパイルが実行されることを意味します。\fB\-proc:only\fRは、注釈処理のみが実行され、後続のコンパイルはまったく実行されないことを意味します。 .RE .PP \-processor \fIclass1\fR [,\fIclass2\fR,\fIclass3\fR\&.\&.\&.] @@ -279,14 +281,14 @@ .PP \-s \fIdir\fR .RS 4 -生成されたソース・ファイルの格納先となるディレクトリを指定します。そのディレクトリは\fIjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、コンパイラは、パッケージ名を反映したサブディレクトリ内にソース・ファイルを格納し、必要に応じてディレクトリを作成します。 +生成されたソース・ファイルの格納先となるディレクトリを指定します。そのディレクトリは\fBjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、コンパイラは、パッケージ名を反映したサブディレクトリ内にソース・ファイルを格納し、必要に応じてディレクトリを作成します。 .sp -\fI\-s /home/mysrc\fRと指定し、クラスの名前が\fIcom\&.mypackage\&.MyClass\fRである場合、ソース・ファイルは\fI/home/mysrc/com/mypackage/MyClass\&.java\fRに格納されます。 +\fB\-s /home/mysrc\fRと指定し、クラスの名前が\fBcom\&.mypackage\&.MyClass\fRである場合、ソース・ファイルは\fB/home/mysrc/com/mypackage/MyClass\&.java\fRに格納されます。 .RE .PP \-source \fIrelease\fR .RS 4 -受け付けるソース・コードのバージョンを指定します。\fIrelease\fRには次の値を指定できます。 +受け付けるソース・コードのバージョンを指定します。\fBrelease\fRには次の値を指定できます。 .PP 1\&.3 .RS 4 @@ -320,13 +322,23 @@ .PP 1\&.7 .RS 4 -これがデフォルト値です。Java SE 7で導入された機能を含むコードを受け付けます。 +Java SE 7で導入された機能を含むコードを受け付けます。 .RE .PP 7 .RS 4 1\&.7と同義です。 .RE +.PP +1\&.8 +.RS 4 +これがデフォルト値です。Java SE 8で導入された機能を含むコードを受け付けます。 +.RE +.PP +8 +.RS 4 +1\&.8と同義です。 +.RE .RE .PP \-sourcepath \fIsourcepath\fR @@ -358,13 +370,13 @@ .RE .SS "クロスコンパイル・オプション" .PP -デフォルトでは、クラスのコンパイルは、\fIjavac\fRが添付されているプラットフォームのブートストラップ・クラスおよび拡張機能クラスに対して行われます。ただし、\fIjavac\fRは、異なるJavaプラットフォームに実装されたブートストラップ・クラスおよび拡張機能クラスに対してコンパイルを行うクロスコンパイルもサポートしています。クロスコンパイルを行う場合は、\fI\-bootclasspath\fRおよび\fI\-extdirs\fRオプションを使用することが重要です。 +デフォルトでは、クラスのコンパイルは、\fBjavac\fRが添付されているプラットフォームのブートストラップ・クラスおよび拡張機能クラスに対して行われます。ただし、\fBjavac\fRは、異なるJavaプラットフォームに実装されたブートストラップ・クラスおよび拡張機能クラスに対してコンパイルを行うクロスコンパイルもサポートしています。クロスコンパイルを行う場合は、\fB\-bootclasspath\fRおよび\fB\-extdirs\fRオプションを使用することが重要です。 .PP \-target \fIversion\fR .RS 4 -仮想マシンの指定されたリリースを対象とするクラス・ファイルを生成します。クラス・ファイルは、指定されたターゲット以降のリリースでは動作しますが、それより前のリリースのJVMでは動作しません。有効なターゲットは、1\&.1、1\&.2、1\&.3、1\&.4、1\&.5 (5も可)、1\&.6 (6も可)および1\&.7 (7も可)です。 +仮想マシンの指定されたリリースを対象とするクラス・ファイルを生成します。クラス・ファイルは、指定されたターゲット以降のリリースでは動作しますが、それより前のリリースのJVMでは動作しません。有効なターゲットは、1\&.1、1\&.2、1\&.3、1\&.4、1\&.5 (5も可)、1\&.6 (6も可)、1\&.7 (7も可)および1\&.8 (8も可)です。 .sp -\fI\-target\fRオプションのデフォルトは、\fI\-source\fRオプションの値によって異なります。 +\fB\-target\fRオプションのデフォルトは、\fB\-source\fRオプションの値によって異なります。 .sp .RS 4 .ie n \{\ @@ -374,7 +386,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションが指定されていない場合、\fI\-target\fRオプションの値は1\&.7です。 +\fB\-source\fRオプションが指定されていない場合、\fB\-target\fRオプションの値は1\&.8です。 .RE .sp .RS 4 @@ -385,7 +397,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションが1\&.2の場合、\fI\-target\fRオプションの値は1\&.4です。 +\fB\-source\fRオプションが1\&.2の場合、\fB\-target\fRオプションの値は1\&.4です。 .RE .sp .RS 4 @@ -396,7 +408,18 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションが1\&.3の場合、\fI\-target\fRオプションの値は1\&.4です。 +\fB\-source\fRオプションが1\&.3の場合、\fB\-target\fRオプションの値は1\&.4です。 +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fB\-source\fRオプションが1\&.5の場合、\fB\-target\fRオプションの値は1\&.8です。 .RE .sp .RS 4 @@ -407,7 +430,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションが1\&.5の場合、\fI\-target\fRオプションの値は1\&.7です。 +\fB\-source\fRオプションが1\&.6の場合、\fB\-target\fRオプションの値は1\&.8です。 .RE .sp .RS 4 @@ -418,7 +441,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションが1\&.6の場合、\fI\-target\fRオプションの値は1\&.7です。 +\fB\-source\fRオプションが1\&.7の場合、\fB\-target\fRオプションの値は1\&.8です。 .RE .sp .RS 4 @@ -429,7 +452,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-source\fRオプションの他のすべての値の場合、\fI\-target\fRオプションの値は、\fI\-source\fRオプションの値になります。 +\fB\-source\fRオプションの他のすべての値の場合、\fB\-target\fRオプションの値は、\fB\-source\fRオプションの値になります。 .RE .RE .PP @@ -439,9 +462,9 @@ .RE .SS "コンパクト・プロファイル・オプション" .PP -JDK 8以降から、\fIjavac\fRコンパイラはコンパクト・プロファイルをサポートします。コンパクト・プロファイルを使用すると、Javaプラットフォーム全体を必要としないアプリケーションは、デプロイ可能で、小さいフットプリントで実行できます。コンパクト・プロファイル機能は、アプリケーション・ストアからのアプリケーションのダウンロード時間を短縮するのに使用できます。この機能は、JREをバンドルするJavaアプリケーションの、よりコンパクトなデプロイメントに役立ちます。この機能は、小さいデバイスでも役立ちます。 +JDK 8以降から、\fBjavac\fRコンパイラはコンパクト・プロファイルをサポートします。コンパクト・プロファイルを使用すると、Javaプラットフォーム全体を必要としないアプリケーションは、デプロイ可能で、小さいフットプリントで実行できます。コンパクト・プロファイル機能は、アプリケーション・ストアからのアプリケーションのダウンロード時間を短縮するのに使用できます。この機能は、JREをバンドルするJavaアプリケーションの、よりコンパクトなデプロイメントに役立ちます。この機能は、小さいデバイスでも役立ちます。 .PP -サポートされているプロファイル値は、\fIcompact1\fR、\fIcompact2\fRおよび\fIcompact3\fRです。これらは、追加のレイヤーです。大きい番号の各コンパクト・プロファイルには、小さい番号の名前のプロファイル内のすべてのAPIが含まれます。 +サポートされているプロファイル値は、\fBcompact1\fR、\fBcompact2\fRおよび\fBcompact3\fRです。これらは、追加のレイヤーです。大きい番号の各コンパクト・プロファイルには、小さい番号の名前のプロファイル内のすべてのAPIが含まれます。 .PP \-profile .RS 4 @@ -451,7 +474,8 @@ .RS 4 .\} .nf -javac \-profile compact1 Hello\&.java +\fBjavac \-profile compact1 Hello\&.java\fR + .fi .if n \{\ .RE @@ -462,17 +486,18 @@ .RS 4 .\} .nf -cd jdk1\&.8\&.0/bin -\&./javac \-profile compact1 Paint\&.java -Paint\&.java:5: error: Applet is not available in profile \*(Aqcompact1\*(Aq -import java\&.applet\&.Applet; +\fBcd jdk1\&.8\&.0/bin\fR +\fB\&./javac \-profile compact1 Paint\&.java\fR +\fBPaint\&.java:5: error: Applet is not available in profile \*(Aqcompact1\*(Aq\fR +\fBimport java\&.applet\&.Applet;\fR + .fi .if n \{\ .RE .\} -この例では、\fIApplet\fRクラスを使用しないようにソースを変更することによって、エラーを修正できます。\-profileオプションを指定せずにコンパイルすることによって、エラーを修正することもできます。コンパイルは、Java SE APIの完全なセットに対して実行されます。(どのコンパクト・プロファイルにも、\fIApplet\fRクラスは含まれていません。) +この例では、\fBApplet\fRクラスを使用しないようにソースを変更することによって、エラーを修正できます。\-profileオプションを指定せずにコンパイルすることによって、エラーを修正することもできます。コンパイルは、Java SE APIの完全なセットに対して実行されます。(どのコンパクト・プロファイルにも、\fBApplet\fRクラスは含まれていません。) .sp -コンパクト・プロファイルを使用してコンパイルするための別の方法として、\fI\-bootclasspath\fRオプションを使用して、プロファイルのイメージを指定する\fIrt\&.jar\fRファイルへのパスを指定します。かわりに\fI\-profile\fRオプションを使用すると、プロファイル・イメージは、コンパイル時にシステム上に存在する必要がありません。これは、クロスコンパイル時に役立ちます。 +コンパクト・プロファイルを使用してコンパイルするための別の方法として、\fB\-bootclasspath\fRオプションを使用して、プロファイルのイメージを指定する\fBrt\&.jar\fRファイルへのパスを指定します。かわりに\fB\-profile\fRオプションを使用すると、プロファイル・イメージは、コンパイル時にシステム上に存在する必要がありません。これは、クロスコンパイル時に役立ちます。 .RE .SS "非標準オプション" .PP @@ -493,15 +518,16 @@ .PP \-Xdoclint:[\-]\fIgroup\fR [\fI/access\fR] .RS 4 -\fIgroup\fRの値が\fIaccessibility\fR、\fIsyntax\fR、\fIreference\fR、\fIhtml\fRまたは\fImissing\fRのいずれかである特定のチェック・グループを有効または無効にします。これらのチェック・グループの詳細は、\fIjavadoc\fRコマンドの\fI\-Xdoclint\fRオプションを参照してください。\fI\-Xdoclint\fRオプションは、\fIjavac\fRコマンドではデフォルトで無効になります。 +\fIgroup\fRの値が\fBaccessibility\fR、\fBsyntax\fR、\fBreference\fR、\fBhtml\fRまたは\fBmissing\fRのいずれかである特定のチェック・グループを有効または無効にします。これらのチェック・グループの詳細は、\fBjavadoc\fRコマンドの\fB\-Xdoclint\fRオプションを参照してください。\fB\-Xdoclint\fRオプションは、\fBjavac\fRコマンドではデフォルトで無効になります。 .sp -変数\fIaccess\fRは、\fI\-Xdoclint\fRオプションがチェックするクラスとメンバーの最小の可視性レベルを指定します。\fIpublic\fR、\fIprotected\fR、\fIpackage\fRおよび\fIprivate\fRの値(可視性の高い順)の1つを持つことができます。たとえば、次のオプションは、(protected、package、publicを含む) protected以上のアクセス・レベルを持つクラスおよびメンバーを(すべてのチェック・グループで)チェックします。 +変数\fIaccess\fRは、\fB\-Xdoclint\fRオプションがチェックするクラスとメンバーの最小の可視性レベルを指定します。\fBpublic\fR、\fBprotected\fR、\fBpackage\fRおよび\fBprivate\fRの値(可視性の高い順)の1つを持つことができます。たとえば、次のオプションは、(protected、package、publicを含む) protected以上のアクセス・レベルを持つクラスおよびメンバーを(すべてのチェック・グループで)チェックします。 .sp .if n \{\ .RS 4 .\} .nf -\-Xdoclint:all/protected +\fB\-Xdoclint:all/protected\fR + .fi .if n \{\ .RE @@ -512,7 +538,8 @@ .RS 4 .\} .nf -\-Xdoclint:all,\-html/package +\fB\-Xdoclint:all,\-html/package\fR + .fi .if n \{\ .RE @@ -551,7 +578,7 @@ .PP \-Xlint:\fI\-name\fR .RS 4 -警告名を無効にします。このオプションで無効にできる警告のリストを取得するには、\-Xlintオプションを使用した警告の有効化または無効化\-Xlint\fIオプションを使用した\fRを参照してください。 +警告名を無効にします。このオプションで無効にできる警告のリストを取得するには、\-Xlintオプションを使用した警告の有効化または無効化\-Xlint\fBオプションを使用した\fRを参照してください。 .RE .PP \-Xmaxerrs \fInumber\fR @@ -566,34 +593,34 @@ .PP \-Xstdout \fIfilename\fR .RS 4 -コンパイラのメッセージを、指定されたファイルに送信します。デフォルトでは、コンパイラのメッセージは\fISystem\&.err\fRに送られます。 +コンパイラのメッセージを、指定されたファイルに送信します。デフォルトでは、コンパイラのメッセージは\fBSystem\&.err\fRに送られます。 .RE .PP \-Xprefer:[\fInewer,source\fR] .RS 4 -ある型に対してソース・ファイルとクラス・ファイルの両方が見つかった場合、そのどちらのファイルを読み取るかを指定します。(型の検索を参照してください)。\fI\-Xprefer:newer\fRオプションを使用した場合、ある型に対するソース・ファイルとクラス・ファイルのうち新しい方が読み取られます(デフォルト)。\fI\-Xprefer:source\fRオプションを使用した場合、ソース・ファイルが読み取られます。\fISOURCE\fRの保存ポリシーを使用して宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\fI\-Xprefer:source\fRを使用してください。 +ある型に対してソース・ファイルとクラス・ファイルの両方が見つかった場合、そのどちらのファイルを読み取るかを指定します。(型の検索を参照してください)。\fB\-Xprefer:newer\fRオプションを使用した場合、ある型に対するソース・ファイルとクラス・ファイルのうち新しい方が読み取られます(デフォルト)。\fB\-Xprefer:source\fRオプションを使用した場合、ソース・ファイルが読み取られます。\fBSOURCE\fRの保存ポリシーを使用して宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\fB\-Xprefer:source\fRを使用してください。 .RE .PP \-Xpkginfo:[\fIalways\fR,\fIlegacy\fR,\fInonempty\fR] .RS 4 -javacがpackage\-info\&.javaファイルから\fIpackage\-info\&.class\fRファイルを生成するかどうかを制御します。このオプションで使用可能なmode引数は次のとおりです。 +javacがpackage\-info\&.javaファイルから\fBpackage\-info\&.class\fRファイルを生成するかどうかを制御します。このオプションで使用可能なmode引数は次のとおりです。 .PP always .RS 4 -すべての\fIpackage\-info\&.java\fRファイルの\fIpackage\-info\&.class\fRファイルを常に生成します。このオプションは、各\fI\&.java\fRファイルに対応する\fI\&.class\fRファイルがあることを確認するAntなどのビルド・システムを使用する場合に役立つことがあります。 +すべての\fBpackage\-info\&.java\fRファイルの\fBpackage\-info\&.class\fRファイルを常に生成します。このオプションは、各\fB\&.java\fRファイルに対応する\fB\&.class\fRファイルがあることを確認するAntなどのビルド・システムを使用する場合に役立つことがあります。 .RE .PP legacy .RS 4 -package\-info\&.javaに注釈が含まれる場合にのみ\fIpackage\-info\&.class\fRファイルを生成します。package\-info\&.javaにコメントのみ含まれる場合に\fIpackage\-info\&.class\fRファイルを生成しません。 +package\-info\&.javaに注釈が含まれる場合にのみ\fBpackage\-info\&.class\fRファイルを生成します。package\-info\&.javaにコメントのみ含まれる場合に\fBpackage\-info\&.class\fRファイルを生成しません。 .sp \fB注意:\fR -\fIpackage\-info\&.class\fRファイルは生成できますが、package\-info\&.javaファイル内のすべての注釈に\fIRetentionPolicy\&.SOURCE\fRがある場合は空になります。 +\fBpackage\-info\&.class\fRファイルは生成できますが、package\-info\&.javaファイル内のすべての注釈に\fBRetentionPolicy\&.SOURCE\fRがある場合は空になります。 .RE .PP nonempty .RS 4 -package\-info\&.javaに\fIRetentionPolicy\&.CLASS\fRまたは\fIRetentionPolicy\&.RUNTIME\fRとともに注釈が含まれる場合にのみ\fIpackage\-info\&.class\fRファイルを生成します。 +package\-info\&.javaに\fBRetentionPolicy\&.CLASS\fRまたは\fBRetentionPolicy\&.RUNTIME\fRとともに注釈が含まれる場合にのみ\fBpackage\-info\&.class\fRファイルを生成します。 .RE .RE .PP @@ -613,7 +640,7 @@ .RE .SH "-XLINTオプションを使用した警告の有効化または無効化" .PP -\fI\-Xlint:name\fRオプションを使用して警告\fIname\fRを有効にします。ここで、\fIname\fRは次の警告名のいずれかになります。\fI\-Xlint:\-name:\fRオプションを使用して、警告を無効化できます。 +\fB\-Xlint:name\fRオプションを使用して警告\fIname\fRを有効にします。ここで、\fBname\fRは次の警告名のいずれかになります。\fB\-Xlint:\-name:\fRオプションを使用して、警告を無効化できます。 .PP cast .RS 4 @@ -623,7 +650,8 @@ .RS 4 .\} .nf -String s = (String) "Hello!" +\fBString s = (String) "Hello!"\fR + .fi .if n \{\ .RE @@ -643,29 +671,31 @@ .RS 4 .\} .nf -java\&.util\&.Date myDate = new java\&.util\&.Date(); -int currentDay = myDate\&.getDay(); +\fBjava\&.util\&.Date myDate = new java\&.util\&.Date();\fR +\fBint currentDay = myDate\&.getDay();\fR + .fi .if n \{\ .RE .\} -メソッド\fIjava\&.util\&.Date\&.getDay\fRはJDK 1\&.1以降は非推奨になりました。 +メソッド\fBjava\&.util\&.Date\&.getDay\fRはJDK 1\&.1以降は非推奨になりました。 .RE .PP dep\-ann .RS 4 -\fI@deprecated\fR -Javadocコメントでドキュメント化されているが、\fI@Deprecated\fR注釈が付いていない項目について警告します。たとえば、次のようになります。 +\fB@deprecated\fR +Javadocコメントでドキュメント化されているが、\fB@Deprecated\fR注釈が付いていない項目について警告します。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -/** - * @deprecated As of Java SE 7, replaced by {@link #newMethod()} - */ -public static void deprecatedMethood() { } -public static void newMethod() { } +\fB/**\fR +\fB * @deprecated As of Java SE 7, replaced by {@link #newMethod()}\fR +\fB */\fR +\fBpublic static void deprecatedMethood() { }\fR +\fBpublic static void newMethod() { }\fR + .fi .if n \{\ .RE @@ -680,7 +710,8 @@ .RS 4 .\} .nf -int divideByZero = 42 / 0; +\fBint divideByZero = 42 / 0;\fR + .fi .if n \{\ .RE @@ -689,17 +720,18 @@ .PP empty .RS 4 -\fIif \fR文以降が空の文であることについて警告します。たとえば、次のようになります。 +\fBif \fR文以降が空の文であることについて警告します。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -class E { - void m() { - if (true) ; - } -} +\fBclass E {\fR +\fB void m() {\fR +\fB if (true) ;\fR +\fB }\fR +\fB}\fR + .fi .if n \{\ .RE @@ -714,48 +746,50 @@ .RS 4 .\} .nf -switch (x) { -case 1: - System\&.out\&.println("1"); - // No break statement here\&. -case 2: - System\&.out\&.println("2"); -} +\fBswitch (x) {\fR +\fBcase 1:\fR +\fB System\&.out\&.println("1");\fR +\fB // No break statement here\&.\fR +\fBcase 2:\fR +\fB System\&.out\&.println("2");\fR +\fB}\fR + .fi .if n \{\ .RE .\} -このコードのコンパイル時に\fI\-Xlint:fallthrough\fRオプションが使用されていた場合、コンパイラは、問題になっているケースの行番号とともに、caseにfall\-throughする可能性があることを示す警告を発行します。 +このコードのコンパイル時に\fB\-Xlint:fallthrough\fRオプションが使用されていた場合、コンパイラは、問題になっているケースの行番号とともに、caseにfall\-throughする可能性があることを示す警告を発行します。 .RE .PP finally .RS 4 -正常に完了できない\fIfinally\fR句について警告します。たとえば、次のようになります。 +正常に完了できない\fBfinally\fR句について警告します。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -public static int m() { - try { - throw new NullPointerException(); - } catch (NullPointerException(); { - System\&.err\&.println("Caught NullPointerException\&."); - return 1; - } finally { - return 0; - } - } +\fBpublic static int m() {\fR +\fB try {\fR +\fB throw new NullPointerException();\fR +\fB } catch (NullPointerException(); {\fR +\fB System\&.err\&.println("Caught NullPointerException\&.");\fR +\fB return 1;\fR +\fB } finally {\fR +\fB return 0;\fR +\fB }\fR +\fB }\fR + .fi .if n \{\ .RE .\} -この例では、コンパイラは\fIfinally\fRブロックに関する警告を生成します。\fIint\fRメソッドが呼び出されると、値0が返されます。\fIfinally\fRブロックは、\fItry\fRブロックが終了すると実行されます。この例では、制御が\fIcatch\fRブロックに移された場合、\fIint\fRメソッドは終了します。ただし、\fIfinally\fRブロックは実行される必要があるため、制御がメソッドの外部に移されていても、このブロックは実行されます。 +この例では、コンパイラは\fBfinally\fRブロックに関する警告を生成します。\fBint\fRメソッドが呼び出されると、値0が返されます。\fBfinally\fRブロックは、\fBtry\fRブロックが終了すると実行されます。この例では、制御が\fBcatch\fRブロックに移された場合、\fBint\fRメソッドは終了します。ただし、\fBfinally\fRブロックは実行される必要があるため、制御がメソッドの外部に移されていても、このブロックは実行されます。 .RE .PP options .RS 4 -コマンドライン・オプションの使用に関する問題について警告します。クロスコンパイル・オプションを参照してください。 +コマンド行オプションの使用に関する問題について警告します。クロスコンパイル・オプションを参照してください。 .RE .PP overrides @@ -766,14 +800,15 @@ .RS 4 .\} .nf -public class ClassWithVarargsMethod { - void varargsMethod(String\&.\&.\&. s) { } -} - -public class ClassWithOverridingMethod extends ClassWithVarargsMethod { - @Override - void varargsMethod(String[] s) { } -} +\fBpublic class ClassWithVarargsMethod {\fR +\fB void varargsMethod(String\&.\&.\&. s) { }\fR +\fB}\fR + +\fBpublic class ClassWithOverridingMethod extends ClassWithVarargsMethod {\fR +\fB @Override\fR +\fB void varargsMethod(String[] s) { }\fR +\fB}\fR + .fi .if n \{\ .RE @@ -784,25 +819,27 @@ .RS 4 .\} .nf -warning: [override] varargsMethod(String[]) in ClassWithOverridingMethod -overrides varargsMethod(String\&.\&.\&.) in ClassWithVarargsMethod; overriding -method is missing \*(Aq\&.\&.\&.\*(Aq +\fBwarning: [override] varargsMethod(String[]) in ClassWithOverridingMethod \fR +\fBoverrides varargsMethod(String\&.\&.\&.) in ClassWithVarargsMethod; overriding\fR +\fBmethod is missing \*(Aq\&.\&.\&.\*(Aq\fR + .fi .if n \{\ .RE .\} -コンパイラは、\fIvarargs\fRメソッドを検出すると、\fIvarargs\fRの仮パラメータを配列に変換します。メソッド\fIClassWithVarargsMethod\&.varargsMethod\fRでは、コンパイラは\fIvarargs\fRの仮パラメータ\fIString\&.\&.\&. s\fRを仮パラメータ\fIString[] s\fRに変換します。これは、メソッド\fIClassWithOverridingMethod\&.varargsMethod\fRの仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。 +コンパイラは、\fBvarargs\fRメソッドを検出すると、\fBvarargs\fRの仮パラメータを配列に変換します。メソッド\fBClassWithVarargsMethod\&.varargsMethod\fRでは、コンパイラは\fBvarargs\fRの仮パラメータ\fBString\&.\&.\&. s\fRを仮パラメータ\fBString[] s\fRに変換します。これは、メソッド\fBClassWithOverridingMethod\&.varargsMethod\fRの仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。 .RE .PP path .RS 4 -コマンドラインでの無効なパス要素と存在しないパス・ディレクトリについて警告します(クラス・パス、ソース・パスなどのパス関連)。このような警告を\fI@SuppressWarnings\fR注釈で抑制することはできません。たとえば、次のようになります。 +コマンド行での無効なパス要素と存在しないパス・ディレクトリについて警告します(クラス・パス、ソース・パスなどのパス関連)。このような警告を\fB@SuppressWarnings\fR注釈で抑制することはできません。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -javac \-Xlint:path \-classpath /nonexistentpath Example\&.java +\fBjavac \-Xlint:path \-classpath /nonexistentpath Example\&.java\fR + .fi .if n \{\ .RE @@ -819,21 +856,22 @@ .RS 4 .\} .nf -import java\&.util\&.*; -import javax\&.annotation\&.processing\&.*; -import javax\&.lang\&.model\&.*; -import\&.javaz\&.lang\&.model\&.element\&.*; - -@SupportedAnnotationTypes("NotAnno") -public class AnnoProc extends AbstractProcessor { - public boolean process(Set<? extends TypeElement> elems, RoundEnvironment renv){ - return true; - } - - public SourceVersion getSupportedSourceVersion() { - return SourceVersion\&.latest(); - } -} +\fBimport java\&.util\&.*;\fR +\fBimport javax\&.annotation\&.processing\&.*;\fR +\fBimport javax\&.lang\&.model\&.*;\fR +\fBimport\&.javaz\&.lang\&.model\&.element\&.*;\fR + +\fB@SupportedAnnotationTypes("NotAnno")\fR +\fBpublic class AnnoProc extends AbstractProcessor {\fR +\fB public boolean process(Set<? extends TypeElement> elems, RoundEnvironment renv){\fR +\fB return true;\fR +\fB }\fR + +\fB public SourceVersion getSupportedSourceVersion() {\fR +\fB return SourceVersion\&.latest();\fR +\fB }\fR +\fB}\fR + .fi .if n \{\ .RE @@ -844,88 +882,93 @@ .RS 4 .\} .nf -@interface Anno { } +\fB@interface Anno { }\fR +\fB \fR +\fB@Anno\fR +\fBclass AnnosWithoutProcessors { }\fR -@Anno -class AnnosWithoutProcessors { } .fi .if n \{\ .RE .\} -次のコマンドは、注釈プロセッサ\fIAnnoProc\fRをコンパイルし、この注釈プロセッサをソース・ファイル\fIAnnosWithoutProcessors\&.java\fRに対して実行します。 +次のコマンドは、注釈プロセッサ\fBAnnoProc\fRをコンパイルし、この注釈プロセッサをソース・ファイル\fBAnnosWithoutProcessors\&.java\fRに対して実行します。 .sp .if n \{\ .RS 4 .\} .nf -javac AnnoProc\&.java -javac \-cp \&. \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors\&.java -.fi -.if n \{\ -.RE -.\} -コンパイラがソース・ファイル\fIAnnosWithoutProcessors\&.java\fRに対して注釈プロセッサを実行すると、次の警告が生成されます。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -warning: [processing] No processor claimed any of these annotations: Anno +\fBjavac AnnoProc\&.java\fR +\fBjavac \-cp \&. \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors\&.java\fR .fi .if n \{\ .RE .\} -この問題を解決するために、クラス\fIAnnosWithoutProcessors\fRで定義および使用される注釈の名前を、\fIAnno\fRから\fINotAnno\fRに変更できます。 -.RE -.PP -rawtypes -.RS 4 -raw型に対する未検査操作について警告します。次の文では、\fIrawtypes\fR警告が生成されます。 +コンパイラがソース・ファイル\fBAnnosWithoutProcessors\&.java\fRに対して注釈プロセッサを実行すると、次の警告が生成されます。 .sp .if n \{\ .RS 4 .\} .nf -void countElements(List l) { \&.\&.\&. } +\fBwarning: [processing] No processor claimed any of these annotations: Anno\fR +\fB \fR .fi .if n \{\ .RE .\} -次の例では、\fIrawtypes\fR警告は生成されません。 +この問題を解決するために、クラス\fBAnnosWithoutProcessors\fRで定義および使用される注釈の名前を、\fBAnno\fRから\fBNotAnno\fRに変更できます。 +.RE +.PP +rawtypes +.RS 4 +raw型に対する未検査操作について警告します。次の文では、\fBrawtypes\fR警告が生成されます。 .sp .if n \{\ .RS 4 .\} .nf -void countElements(List<?> l) { \&.\&.\&. } +\fBvoid countElements(List l) { \&.\&.\&. }\fR + .fi .if n \{\ .RE .\} -\fIList\fRはraw型です。ただし、\fIList<?>\fRは、アンバウンド形式のワイルドカードのパラメータ化された型です。\fIList\fRはパラメータ化されたインタフェースであるため、常にその型引数を指定します。この例では、\fIList\fRの仮引数はアンバウンド形式のワイルドカード(\fI?\fR)を使用してその仮型パラメータとして指定されます。つまり、\fIcountElements\fRメソッドは\fIList\fRインタフェースのどのインスタンス化も受け付けることができます。 -.RE -.PP -Serial -.RS 4 -直列化可能クラスに\fIserialVersionUID\fR定義がないことを警告します。たとえば、次のようになります。 +次の例では、\fBrawtypes\fR警告は生成されません。 .sp .if n \{\ .RS 4 .\} .nf -public class PersistentTime implements Serializable -{ - private Date time; +\fBvoid countElements(List<?> l) { \&.\&.\&. }\fR - public PersistentTime() { - time = Calendar\&.getInstance()\&.getTime(); - } +.fi +.if n \{\ +.RE +.\} +\fBList\fRはraw型です。ただし、\fBList<?>\fRは、アンバウンド形式のワイルドカードのパラメータ化された型です。\fBList\fRはパラメータ化されたインタフェースであるため、常にその型引数を指定します。この例では、\fBList\fRの仮引数はアンバウンド形式のワイルドカード(\fB?\fR)を使用してその仮型パラメータとして指定されます。つまり、\fBcountElements\fRメソッドは\fBList\fRインタフェースのどのインスタンス化も受け付けることができます。 +.RE +.PP +Serial +.RS 4 +直列化可能クラスに\fBserialVersionUID\fR定義がないことを警告します。たとえば、次のようになります。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBpublic class PersistentTime implements Serializable\fR +\fB{\fR +\fB private Date time;\fR +\fB \fR +\fB public PersistentTime() {\fR +\fB time = Calendar\&.getInstance()\&.getTime();\fR +\fB }\fR +\fB \fR +\fB public Date getTime() {\fR +\fB return time;\fR +\fB }\fR +\fB}\fR - public Date getTime() { - return time; - } -} .fi .if n \{\ .RE @@ -936,13 +979,14 @@ .RS 4 .\} .nf -warning: [serial] serializable class PersistentTime has no definition of -serialVersionUID +\fBwarning: [serial] serializable class PersistentTime has no definition of\fR +\fBserialVersionUID\fR + .fi .if n \{\ .RE .\} -直列化可能クラスが\fIserialVersionUID\fRという名前のフィールドを明示的に宣言しない場合、直列化ランタイム環境では、「Javaオブジェクト直列化仕様」で説明されているように、クラスの様々な側面に基づいて、クラスの\fIserialVersionUID\fRのデフォルト値を計算します。ただし、すべての直列化可能クラスが\fIserialVersionUID\fR値を明示的に宣言することを強くお薦めします。 これは、\fIserialVersionUID\fR値を計算するデフォルトのプロセスが、コンパイラの実装によって異なる可能性のあるクラスの詳細にきわめて影響を受けやすく、その結果、直列化復元中に予期しない\fIInvalidClassExceptions\fRが発生する可能性があるためです。Javaコンパイラの実装が異なっても\fIserialVersionUID\fR値の一貫性を確保にするには、直列化可能クラスが\fIserialVersionUID\fR値を明示的に宣言する必要があります。 +直列化可能クラスが\fBserialVersionUID\fRという名前のフィールドを明示的に宣言しない場合、直列化ランタイム環境では、「Javaオブジェクト直列化仕様」で説明されているように、クラスの様々な側面に基づいて、クラスの\fBserialVersionUID\fRのデフォルト値を計算します。ただし、すべての直列化可能クラスが\fBserialVersionUID\fR値を明示的に宣言することを強くお薦めします。 これは、\fBserialVersionUID\fR値を計算するデフォルトのプロセスが、コンパイラの実装によって異なる可能性のあるクラスの詳細にきわめて影響を受けやすく、その結果、直列化復元中に予期しない\fBInvalidClassExceptions\fRが発生する可能性があるためです。Javaコンパイラの実装が異なっても\fBserialVersionUID\fR値の一貫性を確保にするには、直列化可能クラスが\fBserialVersionUID\fR値を明示的に宣言する必要があります。 .RE .PP static @@ -953,10 +997,11 @@ .RS 4 .\} .nf -class XLintStatic { - static void m1() { } - void m2() { this\&.m1(); } -} +\fBclass XLintStatic {\fR +\fB static void m1() { }\fR +\fB void m2() { this\&.m1(); }\fR +\fB}\fR + .fi .if n \{\ .RE @@ -967,35 +1012,38 @@ .RS 4 .\} .nf -warning: [static] static method should be qualified by type name, -XLintStatic, instead of by an expression +\fBwarning: [static] static method should be qualified by type name, \fR +\fBXLintStatic, instead of by an expression\fR + .fi .if n \{\ .RE .\} -この問題を解決するために、次のように\fIstatic\fRメソッド\fIm1\fRを呼び出すことができます。 +この問題を解決するために、次のように\fBstatic\fRメソッド\fBm1\fRを呼び出すことができます。 .sp .if n \{\ .RS 4 .\} .nf -XLintStatic\&.m1(); +\fBXLintStatic\&.m1();\fR + .fi .if n \{\ .RE .\} -あるいは、\fIstatic\fRキーワードをメソッド\fIm1\fRの宣言から削除することもできます。 +あるいは、\fBstatic\fRキーワードをメソッド\fBm1\fRの宣言から削除することもできます。 .RE .PP try .RS 4 -try\-with\-resources文を含む、\fItry\fRブロックの使用に関する問題について警告します。たとえば、\fItry\fRブロックで宣言されたリソース\fIac\fRが使用されないために、次の文に対して警告が生成されます。 +try\-with\-resources文を含む、\fBtry\fRブロックの使用に関する問題について警告します。たとえば、\fBtry\fRブロックで宣言されたリソース\fBac\fRが使用されないために、次の文に対して警告が生成されます。 .sp .if n \{\ .RS 4 .\} .nf -try ( AutoCloseable ac = getResource() ) { // do nothing} +\fBtry ( AutoCloseable ac = getResource() ) { // do nothing}\fR + .fi .if n \{\ .RE @@ -1010,37 +1058,39 @@ .RS 4 .\} .nf -List l = new ArrayList<Number>(); -List<String> ls = l; // unchecked warning +\fBList l = new ArrayList<Number>();\fR +\fBList<String> ls = l; // unchecked warning\fR + .fi .if n \{\ .RE .\} -型の消去中に、型\fIArrayList<Number>\fRおよび\fIList<String>\fRは、それぞれ\fIArrayList\fRおよび\fIList\fRになります。 +型の削除中、型\fBArrayList<Number>\fRおよび\fBList<String>\fRは、それぞれ\fBArrayList\fRおよび\fBList\fRになります。 .sp -\fIls\fRコマンドには、パラメータ化された型\fIList<String>\fRが指定されています。\fIl\fRによって参照される\fIList\fRが\fIls\fRに割り当てられた場合、コンパイラは未検査警告を生成します。コンパイル時に、コンパイラおよびJVMは、\fIl\fRが\fIList<String>\fR型を参照するかどうかを判別できません。この場合、\fIl\fRは、\fIList<String>\fR型を参照しません。その結果、ヒープ汚染が発生します。 +\fBls\fRコマンドには、パラメータ化された型\fBList<String>\fRが指定されています。\fBl\fRによって参照される\fBList\fRが\fBls\fRに割り当てられた場合、コンパイラは未検査警告を生成します。コンパイル時に、コンパイラおよびJVMは、\fBl\fRが\fBList<String>\fR型を参照するかどうかを判別できません。この場合、\fBl\fRは、\fBList<String>\fR型を参照しません。その結果、ヒープ汚染が発生します。 .sp -ヒープ汚染状態が発生するのは、\fIList\fRオブジェクト\fIl\fR -(そのstatic型は\fIList<Number>\fR)が別の\fIList\fRオブジェクト\fIls\fR -(異なるstatic型\fIList<String>\fRを持つ)に代入される場合です。しかし、コンパイラではこの代入をいまだに許可しています。総称をサポートしないJava SEのリリースとの下位互換性を確保するために、この代入を許可する必要があります。型消去により、\fIList<Number>\fRおよび\fIList<String>\fRは、両方とも\fIList\fRになります。その結果、コンパイラはオブジェクト\fIl\fR -(\fIList\fRというraw型を持つ)をオブジェクト\fIls\fRに代入することを許可します。 +ヒープ汚染状態が発生するのは、\fBList\fRオブジェクト\fBl\fR +(そのstatic型は\fBList<Number>\fR)が別の\fBList\fRオブジェクト\fBls\fR +(異なるstatic型\fBList<String>\fRを持つ)に代入される場合です。しかし、コンパイラではこの代入をいまだに許可しています。総称をサポートしないJava SEのリリースとの後方互換性を確保するために、この代入を許可する必要があります。型の削除のため、\fBList<Number>\fRおよび\fBList<String>\fRは、両方\fBList\fRになります。その結果、コンパイラはオブジェクト\fBl\fR +(\fBList\fRというraw型を持つ)をオブジェクト\fBls\fRに代入することを許可します。 .RE .PP varargs .RS 4 -可変引数(\fIvarargs\fR)メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。たとえば、次のようになります。 +可変引数(\fBvarargs\fR)メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。たとえば、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -public class ArrayBuilder { - public static <T> void addToList (List<T> listArg, T\&.\&.\&. elements) { - for (T x : elements) { - listArg\&.add(x); - } - } -} +\fBpublic class ArrayBuilder {\fR +\fB public static <T> void addToList (List<T> listArg, T\&.\&.\&. elements) {\fR +\fB for (T x : elements) {\fR +\fB listArg\&.add(x);\fR +\fB }\fR +\fB }\fR +\fB}\fR + .fi .if n \{\ .RE @@ -1048,38 +1098,42 @@ \fB注意:\fR 非具象化可能型は、型情報が実行時に完全に使用不可能な型です。 .sp -コンパイラは、メソッド\fIArrayBuilder\&.addToList\fRの定義に関する次の警告を生成します。 +コンパイラは、メソッド\fBArrayBuilder\&.addToList\fRの定義に関する次の警告を生成します。 .sp .if n \{\ .RS 4 .\} .nf -warning: [varargs] Possible heap pollution from parameterized vararg type T +\fBwarning: [varargs] Possible heap pollution from parameterized vararg type T\fR + .fi .if n \{\ .RE .\} -コンパイラは、varargsメソッドを検出すると、\fIvarargs\fRの仮パラメータを配列に変換します。しかし、Javaプログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド\fIArrayBuilder\&.addToList\fRでは、コンパイラは\fIvarargs\fRの仮パラメータ\fIT\&.\&.\&.\fR要素を仮パラメータ\fIT[]\fR要素(配列)に変換します。しかし、型消去により、コンパイラは\fIvarargs\fRの仮パラメータを\fIObject[]\fR要素に変換します。その結果、ヒープ汚染が発生する可能性があります。 +コンパイラは、varargsメソッドを検出すると、\fBvarargs\fRの仮パラメータを配列に変換します。しかし、Javaプログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド\fBArrayBuilder\&.addToList\fRでは、コンパイラは\fBvarargs\fRの仮パラメータ\fBT\&.\&.\&.\fR要素を仮パラメータ\fBT[]\fR要素(配列)に変換します。しかし、型消去により、コンパイラは\fBvarargs\fRの仮パラメータを\fBObject[]\fR要素に変換します。その結果、ヒープ汚染が発生する可能性があります。 .RE -.SH "コマンドライン引数ファイル" +.SH "コマンド行引数ファイル" .PP -\fIjavac\fRコマンドを短くしたり簡潔にしたりするために、\fIjavac\fRコマンドに対する引数(\fI\-J\fRオプションを除く)を含む1つ以上のファイルを指定することができます。これにより、どのオペレーティング・システム上でも、任意の長さの\fIjavac\fRコマンドを作成できます。 +\fBjavac\fRコマンドを短くしたり簡潔にしたりするために、\fBjavac\fRコマンドに対する引数(\fB\-J\fRオプションを除く)を含む1つ以上のファイルを指定することができます。これにより、どのオペレーティング・システム上でも、任意の長さの\fBjavac\fRコマンドを作成できます。 .PP -引数ファイルには、\fIjavac\fRのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の引数は、空白または改行文字で区切ることができます。ファイル名に埋め込まれた空白がある場合、ファイル名全体を二重引用符で囲みます。 +引数ファイルには、\fBjavac\fRのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の引数は、空白または改行文字で区切ることができます。ファイル名に埋め込まれた空白がある場合、ファイル名全体を二重引用符で囲みます。 .PP -引数ファイル内のファイル名は、引数ファイルの位置ではなく、現在のディレクトリに相対的となります。これらのリストでは、ワイルドカード(*)は使用できません(たとえば、\fI*\&.java\fRとは指定できません)。アットマーク(@)を使用したファイルの再帰的な解釈はサポートされていません。また、\fI\-J\fRオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 +引数ファイル内のファイル名は、引数ファイルの位置ではなく、現在のディレクトリに相対的となります。これらのリストでは、ワイルドカード(*)は使用できません(たとえば、\fB*\&.java\fRとは指定できません)。アットマーク(@)を使用したファイルの再帰的な解釈はサポートされていません。また、\fB\-J\fRオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 .PP -\fIjavac\fRコマンドを実行するときに、各引数ファイルのパスと名前の先頭にアットマーク(@)文字を付けて渡します。\fIjavac\fRコマンドは、アットマーク(@)で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 +\fBjavac\fRコマンドを実行するときに、各引数ファイルのパスと名前の先頭にアットマーク(@)文字を付けて渡します。\fBjavac\fRコマンドは、アットマーク(@)で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 .PP -\fBExample 1\fR, 単一の引数ファイル +\fB例 1\fR +.br +単一の引数ファイル .RS 4 -\fIargfile\fRという名前の単一の引数ファイルを使用して、すべての\fIjavac\fR引数を格納する場合は、次のように指定します。 +\fBargfile\fRという名前の単一の引数ファイルを使用して、すべての\fBjavac\fR引数を格納する場合は、次のように指定します。 .sp .if n \{\ .RS 4 .\} .nf -javac @argfile +\fBjavac @argfile\fR + .fi .if n \{\ .RE @@ -1087,9 +1141,11 @@ この引数ファイルには、例2で示されている両方のファイルの内容を入れることができます。 .RE .PP -\fBExample 2\fR, 2つの引数ファイル +\fB例 2\fR +.br +2つの引数ファイル .RS 4 -\fIjavac\fRオプション用とソース・ファイル名用に、2つの引数ファイルを作成できます。次のリストには、行の継続文字はありません。 +\fBjavac\fRオプション用とソース・ファイル名用に、2つの引数ファイルを作成できます。次のリストには、行の継続文字はありません。 .sp 次を含むoptionsという名前のファイルを作成します。 .sp @@ -1097,9 +1153,7 @@ .RS 4 .\} .nf -\-d classes -\-g -\-sourcepath /java/pubs/ws/1\&.3/src/share/classes +\fB\-d classes\fR .fi .if n \{\ .RE @@ -1109,6 +1163,27 @@ .RS 4 .\} .nf +\fB\-g\fR +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fB\-sourcepath /java/pubs/ws/1\&.3/src/share/classes\fR +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf + .fi .if n \{\ .RE @@ -1119,35 +1194,40 @@ .RS 4 .\} .nf -MyClass1\&.java -MyClass2\&.java -MyClass3\&.java +\fBMyClass1\&.java\fR +\fBMyClass2\&.java\fR +\fBMyClass3\&.java\fR + .fi .if n \{\ .RE .\} -それから、次のように\fIjavac\fRコマンドを実行します。 +それから、次のように\fBjavac\fRコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -javac @options @classes +\fBjavac @options @classes\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, パスを使用した引数ファイル +\fB例 3\fR +.br +パスを使用した引数ファイル .RS 4 -引数ファイルはパスを指定できますが、ファイル内のすべてのファイル名は、(\fIpath1\fRや\fIpath2\fRではなく)次のように現在の作業ディレクトリに相対的となります。 +引数ファイルはパスを指定できますが、ファイル内のすべてのファイル名は、(\fBpath1\fRや\fBpath2\fRではなく)次のように現在の作業ディレクトリに相対的となります。 .sp .if n \{\ .RS 4 .\} .nf -javac @path1/options @path2/classes +\fBjavac @path1/options @path2/classes\fR + .fi .if n \{\ .RE @@ -1155,106 +1235,110 @@ .RE .SH "注釈処理" .PP -\fIjavac\fRコマンドが注釈処理を直接サポートしているため、独立した注釈処理コマンドである\fIapt\fRを使用する必要がなくなりました。 +\fBjavac\fRコマンドが注釈処理を直接サポートしているため、独立した注釈処理コマンドである\fBapt\fRを使用する必要がなくなりました。 .PP -注釈プロセッサのAPIは、\fIjavax\&.annotation\&.processing\fRおよび\fIjavax\&.lang\&.model\fRパッケージとそのサブパッケージ内に定義されています。 +注釈プロセッサのAPIは、\fBjavax\&.annotation\&.processing\fRおよび\fBjavax\&.lang\&.model\fRパッケージとそのサブパッケージ内に定義されています。 .SS "注釈処理を行う方法" .PP -\fI\-proc:none\fRオプションによって注釈処理が無効化されない限り、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは、\fI\-processorpath\fRオプションを使用して指定できます。パスを指定しない場合、ユーザー・クラス・パスが使用されます。プロセッサの検索は、検索パス上の\fIMETA\-INF/services/javax\&.annotation\&.processing\fR\&.Processorという名前のサービス・プロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1行に1つずつ含めてください。また、別の方法として、\fI\-processor\fRオプションを使用してプロセッサを明示的に指定することもできます。 +\fB\-proc:none\fRオプションによって注釈処理が無効化されない限り、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは、\fB\-processorpath\fRオプションを使用して指定できます。パスを指定しない場合、ユーザー・クラス・パスが使用されます。プロセッサの検索は、検索パス上の\fBMETA\-INF/services/javax\&.annotation\&.processing\fR\&.Processorという名前のサービス・プロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1行に1つずつ含めてください。また、別の方法として、\fB\-processor\fRオプションを使用してプロセッサを明示的に指定することもできます。 .PP -コンパイラは、コマンドラインのソース・ファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問合せを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を要求できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されると、コンパイラはそれ以上プロセッサの検索を行いません。 +コンパイラは、コマンド行のソース・ファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問合せを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を要求できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されると、コンパイラはそれ以上プロセッサの検索を行いません。 .PP いずれかのプロセッサによって新しいソース・ファイルが生成されると、注釈処理の2回目のラウンドが開始されます。新しく生成されたすべてのソース・ファイルがスキャンされ、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソース・ファイルが生成されなくなるまで続きます。 .PP -あるラウンドで新しいソース・ファイルが生成されなかった場合、注釈プロセッサがあと1回のみ呼び出され、残りの処理を実行する機会が与えられます。最後に、\fI\-proc:only\fRオプションが使用されないかぎり、コンパイラは、元のソース・ファイルと生成されたすべてのソース・ファイルをコンパイルします。 +あるラウンドで新しいソース・ファイルが生成されなかった場合、注釈プロセッサがあと1回のみ呼び出され、残りの処理を実行する機会が与えられます。最後に、\fB\-proc:only\fRオプションが使用されないかぎり、コンパイラは、元のソース・ファイルと生成されたすべてのソース・ファイルをコンパイルします。 .SS "暗黙的にロードされたソース・ファイル" .PP -コンパイラは、一連のソース・ファイルをコンパイルする際に、別のソース・ファイルを暗黙的にロードすることが必要な場合があります。型の検索を参照してください。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされた任意のソース・ファイルがコンパイルされた場合、コンパイラは警告を発行します。\fI\-implicit\fRオプションでは、警告を抑制する方法が提供されます。 +コンパイラは、一連のソース・ファイルをコンパイルする際に、別のソース・ファイルを暗黙的にロードすることが必要な場合があります。型の検索を参照してください。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされた任意のソース・ファイルがコンパイルされた場合、コンパイラは警告を発行します。\fB\-implicit\fRオプションでは、警告を抑制する方法が提供されます。 .SH "型の検索" .PP -ソース・ファイルをコンパイルするために、コンパイラは通常、型に関する情報を必要としますが、その型の定義はコマンドラインで指定したソース・ファイルにありません。コンパイラは、ソース・ファイルで使用されているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソース・ファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。 +ソース・ファイルをコンパイルするために、コンパイラは通常、型に関する情報を必要としますが、その型の定義はコマンド行で指定したソース・ファイルにありません。コンパイラは、ソース・ファイルで使用されているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソース・ファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。 .PP -たとえば、サブクラス\fIjava\&.applet\&.Applet\fRを作成すると、\fIアプレット\fRの祖先のクラス(\fIjava\&.awt\&.Panel\fR、\fIjava\&.awt\&.Container\fR、\fIjava\&.awt\&.Component\fRおよび\fIjava\&.lang\&.Object\fR)を使用していることにもなります。 +たとえば、サブクラス\fBjava\&.applet\&.Applet\fRを作成すると、\fBアプレット\fRの祖先のクラス(\fBjava\&.awt\&.Panel\fR、\fBjava\&.awt\&.Container\fR、\fBjava\&.awt\&.Component\fRおよび\fBjava\&.lang\&.Object\fR)を使用していることにもなります。 .PP -コンパイラは、型の情報が必要になると、その型を定義しているソース・ファイルまたはクラス・ファイルを検索します。まず、ブートストラップ・クラスと拡張機能クラスを検索し、続いてユーザー・クラス・パス(デフォルトでは現在のディレクトリ)を検索します。ユーザー・クラス・パスは、\fICLASSPATH\fR環境変数を設定して定義するか、または\fI\-classpath\fRオプションを使用して定義します。 +コンパイラは、型の情報が必要になると、その型を定義しているソース・ファイルまたはクラス・ファイルを検索します。まず、ブートストラップ・クラスと拡張機能クラスを検索し、続いてユーザー・クラス・パス(デフォルトでは現在のディレクトリ)を検索します。ユーザー・クラス・パスは、\fBCLASSPATH\fR環境変数を設定して定義するか、または\fB\-classpath\fRオプションを使用して定義します。 .PP -\fI\-sourcepath\fRオプションが設定されている場合、コンパイラは、指定されたパスからソース・ファイルを検索します。それ以外の場合、コンパイラは、ユーザー・クラス・パスからクラス・ファイルとソース・ファイルの両方を検索します。 +\fB\-sourcepath\fRオプションが設定されている場合、コンパイラは、指定されたパスからソース・ファイルを検索します。それ以外の場合、コンパイラは、ユーザー・クラス・パスからクラス・ファイルとソース・ファイルの両方を検索します。 .PP -\fI\-bootclasspath\fRオプションおよび\fI\-extdirs\fRオプションを使用して、別のブートストラップ・クラスや拡張機能クラスを指定できます。クロスコンパイル・オプションを参照してください。 +\fB\-bootclasspath\fRオプションおよび\fB\-extdirs\fRオプションを使用して、別のブートストラップ・クラスや拡張機能クラスを指定できます。クロスコンパイル・オプションを参照してください。 .PP -型の検索に成功したときに得られる結果は、クラス・ファイル、ソース・ファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用するかを\fI\-Xprefer\fRオプションでコンパイラに指示できます。\fInewer\fRが指定された場合、コンパイラは2つのファイルのうち新しい方を使用します。\fIsource\fRが指定された場合、コンパイラはソース・ファイルを使用します。デフォルトは\fInewer\fRです。 +型の検索に成功したときに得られる結果は、クラス・ファイル、ソース・ファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用するかを\fB\-Xprefer\fRオプションでコンパイラに指示できます。\fBnewer\fRが指定された場合、コンパイラは2つのファイルのうち新しい方を使用します。\fBsource\fRが指定された場合、コンパイラはソース・ファイルを使用します。デフォルトは\fBnewer\fRです。 .PP -型の検索自体によって、または\fI\-Xprefer\fRオプションが設定された結果として必要な型のソース・ファイルが見つかった場合、コンパイラはそのソース・ファイルを読み取り、必要な情報を取得します。デフォルトでは、コンパイラはソース・ファイルのコンパイルも行います。\fI\-implicit\fRオプションを使用してその動作を指定できます。\fInone\fRが指定された場合、ソース・ファイルに対してクラス・ファイルは生成されません。\fIclass\fRが指定された場合、ソース・ファイルに対してクラス・ファイルが生成されます。 +型の検索自体によって、または\fB\-Xprefer\fRオプションが設定された結果として必要な型のソース・ファイルが見つかった場合、コンパイラはそのソース・ファイルを読み取り、必要な情報を取得します。デフォルトでは、コンパイラはソース・ファイルのコンパイルも行います。\fB\-implicit\fRオプションを使用してその動作を指定できます。\fBnone\fRが指定された場合、ソース・ファイルに対してクラス・ファイルは生成されません。\fBclass\fRが指定された場合、ソース・ファイルに対してクラス・ファイルが生成されます。 .PP -コンパイラは、注釈処理が完了するまで、ある型情報の必要性を認識しない場合があります。型情報がソース・ファイル内に見つかり、かつ\fI\-implicit\fRオプションが指定されていない場合、コンパイラによって、そのファイルが注釈処理の対象とならずにコンパイルされることが警告されます。この警告を無効にするには、(そのファイルが注釈処理の対象となるように)そのファイルをコマンドラインに指定するか、あるいはそのようなソース・ファイルに対してクラス・ファイルを生成する必要があるかどうかを\fI\-implicit\fRオプションを使用して指定します。 +コンパイラは、注釈処理が完了するまで、ある型情報の必要性を認識しない場合があります。型情報がソース・ファイル内に見つかり、かつ\fB\-implicit\fRオプションが指定されていない場合、コンパイラによって、そのファイルが注釈処理の対象とならずにコンパイルされることが警告されます。この警告を無効にするには、(そのファイルが注釈処理の対象となるように)そのファイルをコマンド行に指定するか、あるいはそのようなソース・ファイルに対してクラス・ファイルを生成する必要があるかどうかを\fB\-implicit\fRオプションを使用して指定します。 .SH "プログラマティック・インタフェース" .PP -\fIjavac\fRコマンドは、\fIjavax\&.tools\fRパッケージ内のクラスとインタフェースによって定義される新しいJava Compiler APIをサポートします。 +\fBjavac\fRコマンドは、\fBjavax\&.tools\fRパッケージ内のクラスとインタフェースによって定義される新しいJava Compiler APIをサポートします。 .SS "例" .PP -コマンドライン引数を指定するようにコンパイルするには、次の構文を使用します。 +コマンド行引数を指定するようにコンパイルするには、次の構文を使用します。 .sp .if n \{\ .RS 4 .\} .nf -JavaCompiler javac = ToolProvider\&.getSystemJavaCompiler(); -JavaCompiler javac = ToolProvider\&.getSystemJavaCompiler(); +\fBJavaCompiler javac = ToolProvider\&.getSystemJavaCompiler();\fR + .fi .if n \{\ .RE .\} .PP -例では、診断を標準出力ストリームに書き込み、コマンドラインからの呼出し時に\fIjavac\fRが指定する終了コードを返します。 +例では、診断を標準出力ストリームに書き込み、コマンド行からの呼出し時に\fBjavac\fRが指定する終了コードを返します。 .PP -\fIjavax\&.tools\&.JavaCompiler\fRインタフェースの他のメソッドを使用すると、診断の処理やファイルの読取り元/書込み先の制御などを行うことができます。 +\fBjavax\&.tools\&.JavaCompiler\fRインタフェースの他のメソッドを使用すると、診断の処理やファイルの読取り元/書込み先の制御などを行うことができます。 .SS "旧式のインタフェース" .PP \fB注意:\fR -このAPIは、下位互換性のためにのみ保持されています。すべての新しいコードは、新しいJava Compiler APIを使用する必要があります。 +このAPIは、後方互換性のためにのみ保持されています。すべての新しいコードは、新しいJava Compiler APIを使用する必要があります。 .PP -次のように、\fIcom\&.sun\&.tools\&.javac\&.Main\fRクラスには、プログラムからコンパイラを呼び出すためのstaticメソッドが2つ用意されています。 +次のように、\fBcom\&.sun\&.tools\&.javac\&.Main\fRクラスには、プログラムからコンパイラを呼び出すためのstaticメソッドが2つ用意されています。 .sp .if n \{\ .RS 4 .\} .nf -public static int compile(String[] args); -public static int compile(String[] args, PrintWriter out); +\fBpublic static int compile(String[] args);\fR +\fBpublic static int compile(String[] args, PrintWriter out);\fR + .fi .if n \{\ .RE .\} .PP -\fIargs\fRパラメータは、通常コンパイラに渡される任意のコマンドライン引数を表しています。 +\fBargs\fRパラメータは、通常コンパイラに渡される任意のコマンド行引数を表しています。 .PP -\fIout\fRパラメータは、コンパイラの診断出力の宛先を示します。 +\fBout\fRパラメータは、コンパイラの診断出力の宛先を示します。 .PP -\fIreturn\fR値は、\fIjavac\fRの\fIexit\fR値と同じです。 +\fBreturn\fR値は、\fBjavac\fRの\fBexit\fR値と同じです。 .PP \fB注意:\fR -名前が\fIcom\&.sun\&.tools\&.javac\fRで始まるパッケージ(\fIcom\&.sun\&.tools\&.javac\fRのサブパッケージ)で検出される他のすべてのクラスおよびメソッドは、完全に内部用であり、いつでも変更される可能性があります。 +名前が\fBcom\&.sun\&.tools\&.javac\fRで始まるパッケージ(\fBcom\&.sun\&.tools\&.javac\fRのサブパッケージ)で検出される他のすべてのクラスおよびメソッドは、完全に内部用であり、いつでも変更される可能性があります。 .SH "例" .PP -\fBExample 1\fR, 簡単なプログラムのコンパイル +\fB例 1\fR +.br +簡単なプログラムのコンパイル .RS 4 -この例では、greetingsディレクトリで\fIHello\&.java\fRソース・ファイルをコンパイルする方法を示しています。\fIHello\&.java\fRで定義されたクラスは、\fIgreetings\&.Hello\fRと呼ばれます。greetingsディレクトリは、ソース・ファイルとクラス・ファイルの両方があるパッケージ・ディレクトリで、現在のディレクトリのすぐ下にあります。これにより、デフォルトのユーザー・クラス・パスを使用できるようになります。また、\fI\-d\fRオプションを使用して別の出力先ディレクトリを指定する必要もありません。 +この例では、greetingsディレクトリで\fBHello\&.java\fRソース・ファイルをコンパイルする方法を示しています。\fBHello\&.java\fRで定義されたクラスは、\fBgreetings\&.Hello\fRと呼ばれます。greetingsディレクトリは、ソース・ファイルとクラス・ファイルの両方があるパッケージ・ディレクトリで、現在のディレクトリのすぐ下にあります。これにより、デフォルトのユーザー・クラス・パスを使用できるようになります。また、\fB\-d\fRオプションを使用して別の出力先ディレクトリを指定する必要もありません。 .sp -\fIHello\&.java\fR内のソース・コードは次のとおりです。 +\fBHello\&.java\fR内のソース・コードは次のとおりです。 .sp .if n \{\ .RS 4 .\} .nf -package greetings; +\fBpackage greetings;\fR +\fB \fR +\fBpublic class Hello {\fR +\fB public static void main(String[] args) {\fR +\fB for (int i=0; i < args\&.length; i++) {\fR +\fB System\&.out\&.println("Hello " + args[i]);\fR +\fB }\fR +\fB }\fR +\fB}\fR -public class Hello { - public static void main(String[] args) { - for (int i=0; i < args\&.length; i++) { - System\&.out\&.println("Hello " + args[i]); - } - } -} .fi .if n \{\ .RE @@ -1265,46 +1349,53 @@ .RS 4 .\} .nf -javac greetings/Hello\&.java +\fBjavac greetings/Hello\&.java\fR + .fi .if n \{\ .RE .\} -\fIgreetings\&.Hello\fRの実行: +\fBgreetings\&.Hello\fRの実行: .sp .if n \{\ .RS 4 .\} .nf -java greetings\&.Hello World Universe Everyone -Hello World -Hello Universe -Hello Everyone +\fBjava greetings\&.Hello World Universe Everyone\fR +\fBHello World\fR +\fBHello Universe\fR +\fBHello Everyone\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 2\fR, 複数のソース・ファイルのコンパイル +\fB例 2\fR +.br +複数のソース・ファイルのコンパイル .RS 4 -この例では、\fIgreetings\fRパッケージのソース・ファイル\fIAloha\&.java\fR、\fIGutenTag\&.java\fR、\fIHello\&.java\fRおよび\fIHi\&.java\fRをコンパイルします。 +この例では、\fBgreetings\fRパッケージのソース・ファイル\fBAloha\&.java\fR、\fBGutenTag\&.java\fR、\fBHello\&.java\fRおよび\fBHi\&.java\fRをコンパイルします。 .sp .if n \{\ .RS 4 .\} .nf -% javac greetings/*\&.java -% ls greetings -Aloha\&.class GutenTag\&.class Hello\&.class Hi\&.class -Aloha\&.java GutenTag\&.java Hello\&.java Hi\&.java +\fB% javac greetings/*\&.java\fR +\fB% ls greetings\fR +\fBAloha\&.class GutenTag\&.class Hello\&.class Hi\&.class\fR +\fBAloha\&.java GutenTag\&.java Hello\&.java Hi\&.java\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, ユーザー・クラス・パスの指定 +\fB例 3\fR +.br +ユーザー・クラス・パスの指定 .RS 4 前述の例のソース・ファイルのうち1つを変更した後に、そのファイルを再コンパイルします。 .sp @@ -1312,110 +1403,122 @@ .RS 4 .\} .nf -pwd -/examples -javac greetings/Hi\&.java +\fBpwd\fR +\fB/examples\fR +\fBjavac greetings/Hi\&.java\fR + .fi .if n \{\ .RE .\} -\fIgreetings\&.Hi\fRは\fIgreetings\fRパッケージ内の他のクラスを参照しているため、コンパイラはこれらの他のクラスを探す必要があります。デフォルトのユーザー・クラス・パスはパッケージ・ディレクトリを含むディレクトリであるため、前述の例は動作します。現在のディレクトリを気にせずにこのファイルを再コンパイルする場合、\fICLASSPATH\fRを設定して、ユーザー・クラス・パスに例のディレクトリを追加します。この例では、\fI\-classpath\fRオプションを使用しています。 +\fBgreetings\&.Hi\fRは\fBgreetings\fRパッケージ内の他のクラスを参照しているため、コンパイラはこれらの他のクラスを探す必要があります。デフォルトのユーザー・クラス・パスはパッケージ・ディレクトリを含むディレクトリであるため、前述の例は動作します。現在のディレクトリを気にせずにこのファイルを再コンパイルする場合、\fBCLASSPATH\fRを設定して、ユーザー・クラス・パスに例のディレクトリを追加します。この例では、\fB\-classpath\fRオプションを使用しています。 .sp .if n \{\ .RS 4 .\} .nf -javac \-classpath /examples /examples/greetings/Hi\&.java +\fBjavac \-classpath /examples /examples/greetings/Hi\&.java\fR + .fi .if n \{\ .RE .\} -\fIgreetings\&.Hi\fRを変更してバナー・ユーティリティを使用するようにした場合、 そのユーティリティもユーザー・クラス・パスを通じてアクセスできるようになっている必要があります。 +\fBgreetings\&.Hi\fRを変更してバナー・ユーティリティを使用するようにした場合、 そのユーティリティもユーザー・クラス・パスを通じてアクセスできるようになっている必要があります。 .sp .if n \{\ .RS 4 .\} .nf -javac \-classpath /examples:/lib/Banners\&.jar \e - /examples/greetings/Hi\&.java +\fBjavac \-classpath /examples:/lib/Banners\&.jar \e\fR +\fB /examples/greetings/Hi\&.java\fR + .fi .if n \{\ .RE .\} -\fIgreetings\fRパッケージでクラスを実行するには、プログラムは\fIgreetings\fRパッケージ、および\fIgreetings\fRクラスが使用するクラスにアクセスする必要があります。 +\fBgreetings\fRパッケージでクラスを実行するには、プログラムは\fBgreetings\fRパッケージ、および\fBgreetings\fRクラスが使用するクラスにアクセスする必要があります。 .sp .if n \{\ .RS 4 .\} .nf -java \-classpath /examples:/lib/Banners\&.jar greetings\&.Hi +\fBjava \-classpath /examples:/lib/Banners\&.jar greetings\&.Hi\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 4\fR, ソース・ファイルとクラス・ファイルの分離 +\fB例 4\fR +.br +ソース・ファイルとクラス・ファイルの分離 .RS 4 -次の例では、\fIjavac\fRを使用して、JVM 1\&.6上で実行するコードをコンパイルします。 +次の例では、\fBjavac\fRを使用して、JVM 1\&.7上で実行するコードをコンパイルします。 .sp .if n \{\ .RS 4 .\} .nf -javac \-source 1\&.6 \-target 1\&.6 \-bootclasspath jdk1\&.6\&.0/lib/rt\&.jar \e -\-extdirs "" OldCode\&.java +\fBjavac \-source 1\&.7 \-target 1\&.7 \-bootclasspath jdk1\&.7\&.0/lib/rt\&.jar \e \fR +\fB\-extdirs "" OldCode\&.java\fR + .fi .if n \{\ .RE .\} -\fI\-source 1\&.6\fRオプションにより、\fIOldCode\&.java\fRのコンパイルにはリリース1\&.6(または6)のJavaプログラミング言語が使用されます。\fI\-target 1\&.6\fRオプションにより、JVM 1\&.6と互換性のあるクラス・ファイルが生成されます。ほとんどの場合、\fI\-target\fRオプションの値は\fI\-source\fRオプションの値になります。この例では、\fI\-target\fRオプションを省略できます。 +\fB\-source 1\&.7\fRオプションにより、\fBOldCode\&.java\fRのコンパイルにはリリース1\&.7(または7)のJavaプログラミング言語が使用されます。\fB\-target 1\&.7\fRオプションにより、JVM 1\&.7と互換性のあるクラス・ファイルが生成されます。ほとんどの場合、\fB\-target\fRオプションの値は\fB\-source\fRオプションの値になります。この例では、\fB\-target\fRオプションを省略できます。 .sp -\fI\-bootclasspath\fRオプションを使用して、適切なバージョンのブートストラップ・クラス(\fIrt\&.jar\fRライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 +\fB\-bootclasspath\fRオプションを使用して、適切なバージョンのブートストラップ・クラス(\fBrt\&.jar\fRライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 .sp .if n \{\ .RS 4 .\} .nf -javac \-source 1\&.6 OldCode\&.java -warning: [options] bootstrap class path not set in conjunction with -\-source 1\&.6 +\fBjavac \-source 1\&.7 OldCode\&.java\fR +\fBwarning: [options] bootstrap class path not set in conjunction with \fR +\fB\-source 1\&.7\fR + .fi .if n \{\ .RE .\} -適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様(この例では、バージョン1\&.6のJavaプログラミング言語)を新しいブートストラップ・クラスと組み合せて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 6)で動作しない可能性があります。 +適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様(この例では、バージョン1\&.7のJavaプログラミング言語)を新しいブートストラップ・クラスと組み合せて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 7)で動作しない可能性があります。 .RE .PP -\fBExample 5\fR, クロス・コンパイル +\fB例 5\fR +.br +クロス・コンパイル .RS 4 -この例では、\fIjavac\fRを使用して、JVM 1\&.6上で実行するコードをコンパイルします。 +この例では、\fBjavac\fRを使用して、JVM 1\&.7上で実行するコードをコンパイルします。 .sp .if n \{\ .RS 4 .\} .nf -javac \-source 1\&.6 \-target 1\&.6 \-bootclasspath jdk1\&.6\&.0/lib/rt\&.jar \e - \-extdirs "" OldCode\&.java +\fBjavac \-source 1\&.7 \-target 1\&.7 \-bootclasspath jdk1\&.7\&.0/lib/rt\&.jar \e\fR +\fB \-extdirs "" OldCode\&.java\fR + .fi .if n \{\ .RE .\} -The\fI \-source 1\&.6\fRオプションにより、OldCode\&.javaのコンパイルにはリリース1\&.6(または6)のJavaプログラミング言語が使用されます。\fI\-target 1\&.6\fRオプションにより、JVM 1\&.6と互換性のあるクラス・ファイルが生成されます。ほとんどの場合、\fI\-target\fRの値は\fI\-source\fRの値になります。この例では、\fI\-target\fRオプションは省略されます。 +\fB \-source 1\&.7\fRオプションにより、OldCode\&.javaのコンパイルにはリリース1\&.7(または7)のJavaプログラミング言語が使用されます。\fB\-target 1\&.7\fRオプションにより、JVM 1\&.7と互換性のあるクラス・ファイルが生成されます。ほとんどの場合、\fB\-target\fRの値は\fB\-source\fRの値になります。この例では、\fB\-target\fRオプションは省略されます。 .sp -\fI\-bootclasspath\fRオプションを使用して、適切なバージョンのブートストラップ・クラス(\fIrt\&.jar\fRライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 +\fB\-bootclasspath\fRオプションを使用して、適切なバージョンのブートストラップ・クラス(\fBrt\&.jar\fRライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。 .sp .if n \{\ .RS 4 .\} .nf -javac \-source 1\&.6 OldCode\&.java -warning: [options] bootstrap class path not set in conjunction with \-source 1\&.6 +\fBjavac \-source 1\&.7 OldCode\&.java\fR +\fBwarning: [options] bootstrap class path not set in conjunction with \-source 1\&.7\fR + .fi .if n \{\ .RE .\} -適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様を新しいブートストラップ・クラスと組み合せて使用します。この組合せは、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 6)で動作しない可能性があります。この例では、コンパイラはJavaプログラミング言語のリリース1\&.6を使用します。 +適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様を新しいブートストラップ・クラスと組み合せて使用します。この組合せは、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 7)で動作しない可能性があります。この例では、コンパイラはJavaプログラミング言語のリリース1\&.7を使用します。 .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/javadoc.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/javadoc.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: javadoc -.\" Language: English -.\" Date: 2011年5月10日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: javadoc +.\" Language: Japanese +.\" Date: 2011年5月10日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "javadoc" "1" "2011年5月10日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" javadoc \- Javaソース・ファイルから、APIドキュメントのHTMLページを生成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjavadoc\fR {\fIpackages\fR|\fIsource\-files\fR} [\fIoptions\fR] [\fI@argfiles\fR] +\fBjavadoc\fR {\fIpackages\fR|\fIsource\-files\fR} [\fIoptions\fR] [\fI@argfiles\fR] .fi .if n \{\ .RE @@ -64,33 +66,33 @@ .PP \fIpackages\fR .RS 4 -\fIjava\&.lang java\&.lang\&.reflect java\&.awt\fRなど、空白で区切ってドキュメント化するパッケージの名前。サブパッケージもドキュメント化する場合は、\fI\-subpackages\fRオプションを使用してパッケージを指定します。 -.sp -デフォルトでは、\fIjavadoc\fRは、現在のディレクトリおよびサブディレクトリで指定されたパッケージを探します。\fI\-sourcepath\fRオプションを使用して、パッケージを探すディレクトリのリストを指定します。 +\fBjava\&.lang java\&.lang\&.reflect java\&.awt\fRなど、空白で区切ってドキュメント化するパッケージの名前。サブパッケージもドキュメント化する場合は、\fB\-subpackages\fRオプションを使用してパッケージを指定します。 +.sp +デフォルトでは、\fBjavadoc\fRは、現在のディレクトリおよびサブディレクトリで指定されたパッケージを探します。\fB\-sourcepath\fRオプションを使用して、パッケージを探すディレクトリのリストを指定します。 .RE .PP \fIsource\-files\fR .RS 4 -\fIClass\&.java Object\&.java Button\&.java\fRのように空白で区切った、ドキュメント化するJavaソース・ファイルの名前。デフォルトでは、\fIjavadoc\fRは、現在のディレクトリで指定されたクラスを探します。ただし、\fI/home/src/java/awt/Graphics*\&.java\fRのように、クラス・ファイルのフルパスを指定し、ワイルドカード文字を使用できます。現在のディレクトリからの相対パスも指定できます。 +\fBClass\&.java Object\&.java Button\&.java\fRのように空白で区切った、ドキュメント化するJavaソース・ファイルの名前。デフォルトでは、\fBjavadoc\fRは、現在のディレクトリで指定されたクラスを探します。ただし、\fB/home/src/java/awt/Graphics*\&.java\fRのように、クラス・ファイルのフルパスを指定し、ワイルドカード文字を使用できます。現在のディレクトリからの相対パスも指定できます。 .RE .PP \fIoptions\fR .RS 4 -空白で区切られたコマンドライン・オプション。オプションを参照してください。 +空白で区切られたコマンド行オプション。オプションを参照してください。 .RE .PP \fI@argfiles\fR .RS 4 -\fIjavadoc\fRコマンド・オプション、パッケージ名およびソース・ファイル名のリストを任意の順序で含むファイルの名前。 +\fBjavadoc\fRコマンド・オプション、パッケージ名およびソース・ファイル名のリストを任意の順序で含むファイルの名前。 .RE .SH "説明" .PP -\fIjavadoc\fRコマンドは、一連のJavaソース・ファイルにある宣言およびドキュメンテーション・コメントを解析し、デフォルトでは、publicクラス、protectedクラス、ネストされたクラス(匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて記述した一連のHTMLページを生成します。\fIjavadoc\fRコマンドは、APIドキュメントの生成や、一連のソース・ファイルの実装ドキュメントの生成に使用できます。 -.PP -\fIjavadoc\fRコマンドは、パッケージ全体、個々のソース・ファイル、またはその両方に対して実行できます。パッケージ全体のドキュメント化を行うには、\fI\-subpackages\fRオプションを使用してディレクトリおよびそのサブディレクトリを再帰的にたどるか、パッケージ名の明示的なリストを渡します。個々のソース・ファイルをドキュメント化するには、Javaソース・ファイル名のリストを渡します。簡単な例を参照してください。 +\fBjavadoc\fRコマンドは、一連のJavaソース・ファイルにある宣言およびドキュメンテーション・コメントを解析し、デフォルトでは、publicクラス、protectedクラス、ネストされたクラス(匿名の内部クラスは除く)、インタフェース、コンストラクタ、メソッド、およびフィールドについて記述した一連のHTMLページを生成します。\fBjavadoc\fRコマンドは、APIドキュメントの生成や、一連のソース・ファイルの実装ドキュメントの生成に使用できます。 +.PP +\fBjavadoc\fRコマンドは、パッケージ全体、個々のソース・ファイル、またはその両方に対して実行できます。パッケージ全体のドキュメント化を行うには、\fB\-subpackages\fRオプションを使用してディレクトリおよびそのサブディレクトリを再帰的にたどるか、パッケージ名の明示的なリストを渡します。個々のソース・ファイルをドキュメント化するには、Javaソース・ファイル名のリストを渡します。簡単な例を参照してください。 .SS "ソース・ファイルの処理" .PP -\fIjavadoc\fRコマンドは、ソースで終わるファイル、およびソース・ファイルで説明しているその他のファイルを処理します。個々のソース・ファイル名を渡して\fIjavadoc\fRを実行する場合、どのソース・ファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。ソース・ファイル名を明示的に指定しなくても、\fIjavadoc\fRコマンドは3つの方法で実行できます。パッケージ名を渡し、\fI\-subpackages\fRオプションを使用するか、またはソース・ファイル名にワイルドカードを使用することができます。これらの場合、\fIjavadoc\fRコマンドがソース・ファイルの処理を行うのは、そのファイルが次のすべての要件を満たす場合のみです。 +\fBjavadoc\fRコマンドは、ソースで終わるファイル、およびソース・ファイルで説明しているその他のファイルを処理します。個々のソース・ファイル名を渡して\fBjavadoc\fRを実行する場合、どのソース・ファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。ソース・ファイル名を明示的に指定しなくても、\fBjavadoc\fRコマンドは3つの方法で実行できます。パッケージ名を渡し、\fB\-subpackages\fRオプションを使用するか、またはソース・ファイル名にワイルドカードを使用することができます。これらの場合、\fBjavadoc\fRコマンドがソース・ファイルの処理を行うのは、そのファイルが次のすべての要件を満たす場合のみです。 .sp .RS 4 .ie n \{\ @@ -100,7 +102,7 @@ .sp -1 .IP \(bu 2.3 .\} -ファイル名の接頭辞(\fI\&.java\fRを削除)が有効なクラス名である。 +ファイル名の接頭辞(\fB\&.java\fRを削除)が有効なクラス名である。 .RE .sp .RS 4 @@ -124,8 +126,10 @@ .\} パッケージ文に有効なパッケージ名が含まれている。 .RE -リンクの処理.PP -処理の実行中に、\fIjavadoc\fRコマンドは、その実行でドキュメント化されるパッケージ、クラス、およびメンバーの名前に対して、相互参照リンクを追加します。リンクは、次の場所に表示されます。@タグの説明については、javadocタグを参照してください。 +.PP +リンクの処理 +.PP +処理の実行中に、\fBjavadoc\fRコマンドは、その実行でドキュメント化されるパッケージ、クラス、およびメンバーの名前に対して、相互参照リンクを追加します。リンクは、次の場所に表示されます。@タグの説明については、javadocタグを参照してください。 .sp .RS 4 .ie n \{\ @@ -146,7 +150,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI@see\fRタグから生成された「\fI関連項目\fR」セクション。 +\fB@see\fRタグから生成された\fI「関連項目」\fRセクション。 .RE .sp .RS 4 @@ -157,7 +161,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI{@link}\fRタグから生成されたインライン・テキスト。 +\fB{@link}\fRタグから生成されたインライン・テキスト。 .RE .sp .RS 4 @@ -168,7 +172,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI@throws\fRタグから生成された例外の名前。 +\fB@throws\fRタグから生成された例外の名前。 .RE .sp .RS 4 @@ -179,7 +183,7 @@ .sp -1 .IP \(bu 2.3 .\} -インタフェースのメンバーに対する「\fI定義\fR」リンクと、クラスのメンバーに対する「\fIオーバーライド\fR」リンク。メソッド・コメントの継承を参照してください。 +インタフェースのメンバーに対する\fI「定義」\fRリンクと、クラスのメンバーに対する\fI「オーバーライド」\fRリンク。メソッド・コメントの継承を参照してください。 .RE .sp .RS 4 @@ -215,37 +219,39 @@ 索引。 .RE .PP -コマンドラインで指定しなかったクラスについての既存のテキスト(別に生成したテキスト)に対してリンクを追加するには、\fI\-link\fRおよび\fI\-linkoffline\fRオプションを利用できます。 -処理の詳細.PP -\fIjavadoc\fRコマンドは実行するたびに1つの完全なドキュメントを生成します。前の実行の結果を変更または直接取り込む、増分ビルドを行いません。ただし、\fIjavadoc\fRコマンドは、他の実行の結果にリンクできます。 -.PP -\fIjavadoc\fRコマンドの実装にはJavaコンパイラが必要で、Javaコンパイラに依存しています。\fIjavadoc\fRコマンドは\fIjavac\fRコマンドの一部を呼び出し、宣言をコンパイルして、メンバーの実装を無視します。\fIjavadoc\fRコマンドは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、HTMLを生成します。さらに、J\fIjavadoc\fRコマンドは、ソース・コードのドキュメンテーション・コメントから、ユーザーの提供したドキュメントも取得します。ドキュメンテーション・コメントを参照してください。 -.PP -\fIjavadoc\fRコマンドは、メソッド本体を持たない純粋なスタブ・ファイルであるソース・ファイルに対して実行できます。したがって、APIの実装前の設計の早い段階で、ドキュメンテーション・コメントを記述して\fIjavadoc\fRコメントを実行できます。 -.PP -コンパイラに依存することによって、HTML出力は、実際の実装に正確に対応します。実際の実装は、明示的なソース・コードにではなく、暗黙のソース・コードに依存する場合があります。たとえば、\fIjavadoc\fRコマンドは、コンパイル済クラス・ファイルには存在するがソース・コードには存在しないデフォルト・コンストラクタをドキュメント化します。 -.PP -多くの場合、\fIjavadoc\fRコマンドでは、ソース・ファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。すべてのデバッグやトラブルシューティングを完了する前にドキュメントを生成できます。\fIjavadoc\fRコマンドはドキュメンテーション・コメントの基本的なチェックを行います。 -.PP -\fIjavadoc\fRコマンドは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、 -\fIjavadoc\fRコマンドは、ブートストラップ・クラス、拡張機能、またはユーザー・クラスにかかわらず、すべての参照クラスを検索できる必要があります。クラスの検出方法 +コマンド行で指定しなかったクラスについての既存のテキスト(別に生成したテキスト)に対してリンクを追加するには、\fB\-link\fRおよび\fB\-linkoffline\fRオプションを利用できます。 +.PP +処理の詳細 +.PP +\fBjavadoc\fRコマンドは実行するたびに1つの完全なドキュメントを生成します。前の実行の結果を変更または直接取り込む、増分ビルドを行いません。ただし、\fBjavadoc\fRコマンドは、他の実行の結果にリンクできます。 +.PP +\fBjavadoc\fRコマンドの実装にはJavaコンパイラが必要で、Javaコンパイラに依存しています。\fBjavadoc\fRコマンドは\fBjavac\fRコマンドの一部を呼び出し、宣言をコンパイルして、メンバーの実装を無視します。\fBjavadoc\fRコマンドは、クラス階層を含むクラスの豊富な内部表現とクラスの「使用」関係を構築し、HTMLを生成します。さらに、J\fBjavadoc\fRコマンドは、ソース・コードのドキュメンテーション・コメントから、ユーザーの提供したドキュメントも取得します。ドキュメンテーション・コメントを参照してください。 +.PP +\fBjavadoc\fRコマンドは、メソッド本体を持たない純粋なスタブ・ファイルであるソース・ファイルに対して実行できます。したがって、APIの実装前の設計の早い段階で、ドキュメンテーション・コメントを記述して\fBjavadoc\fRコメントを実行できます。 +.PP +コンパイラに依存することによって、HTML出力は、実際の実装に正確に対応します。実際の実装は、明示的なソース・コードにではなく、暗黙のソース・コードに依存する場合があります。たとえば、\fBjavadoc\fRコマンドは、コンパイル済クラス・ファイルには存在するがソース・コードには存在しないデフォルト・コンストラクタをドキュメント化します。 +.PP +多くの場合、\fBjavadoc\fRコマンドでは、ソース・ファイルのコードが不完全またはエラーを含んでいる場合でもドキュメントを生成できます。すべてのデバッグやトラブルシューティングを完了する前にドキュメントを生成できます。\fBjavadoc\fRコマンドはドキュメンテーション・コメントの基本的なチェックを行います。 +.PP +\fBjavadoc\fRコマンドは、ドキュメントの内部構造を構築する際、参照クラスをすべてロードします。このため、 +\fBjavadoc\fRコマンドは、ブートストラップ・クラス、拡張機能、またはユーザー・クラスにかかわらず、すべての参照クラスを検索できる必要があります。クラスの検出方法 (http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/findingclasses\&.html)を参照してください .PP -通常、作成するクラスは、拡張クラスとして、または\fIjavadoc\fRコマンドのクラス・パスでロードされる必要があります。 +通常、作成するクラスは、拡張クラスとして、または\fBjavadoc\fRコマンドのクラス・パスでロードされる必要があります。 .SS "Javadocのドックレット" .PP -\fIjavadoc\fRコマンドの出力の内容と形式は、ドックレットを使用してカスタマイズできます。\fIjavadoc\fRコマンドには、標準ドックレットと呼ばれるデフォルトの組込みドックレットがあります。標準ドックレットは、HTML形式のAPIドキュメントを生成します。標準ドックレットを修正またはサブクラスを作成することや、HTML、XML、MIF、RTFなどの好みの出力形式を生成する独自のドックレットを記述することも可能です。 -.PP -\fI\-doclet\fRオプションでカスタム・ドックレットが指定されていない場合、\fIjavadoc\fRコマンドは、デフォルトの標準ドックレットを使用します。\fIjavadoc\fRコマンドには、使用されているドックレットに関係なく使用できるいくつかのオプションがあります。標準ドックレットでは、これらの他に、いくつかのコマンドライン・オプションが追加されます。オプションを参照してください。 +\fBjavadoc\fRコマンドの出力の内容と形式は、ドックレットを使用してカスタマイズできます。\fBjavadoc\fRコマンドには、標準ドックレットと呼ばれるデフォルトの組込みドックレットがあります。標準ドックレットは、HTML形式のAPIドキュメントを生成します。標準ドックレットを修正またはサブクラスを作成することや、HTML、XML、MIF、RTFなどの好みの出力形式を生成する独自のドックレットを記述することも可能です。 +.PP +\fB\-doclet\fRオプションでカスタム・ドックレットが指定されていない場合、\fBjavadoc\fRコマンドは、デフォルトの標準ドックレットを使用します。\fBjavadoc\fRコマンドには、使用されているドックレットに関係なく使用できるいくつかのオプションがあります。標準ドックレットでは、これらの他に、いくつかのコマンド行オプションが追加されます。オプションを参照してください。 .SH "ソース・ファイル" .PP -\fIjavadoc\fRコマンドは、次のタイプのソース・ファイルから出力を生成します。そのファイルは、クラスのJava言語ソース・ファイル(\fI\&.java\fR)、パッケージ・コメント・ファイル、概要コメント・ファイル、およびその他の未処理のファイルです。ここでは、ドキュメント化しないがソース・ツリーに存在する場合があるテスト・ファイルやテンプレート・ファイルについても説明します。 +\fBjavadoc\fRコマンドは、次のタイプのソース・ファイルから出力を生成します。そのファイルは、クラスのJava言語ソース・ファイル(\fB\&.java\fR)、パッケージ・コメント・ファイル、概要コメント・ファイル、およびその他の未処理のファイルです。ここでは、ドキュメント化しないがソース・ツリーに存在する場合があるテスト・ファイルやテンプレート・ファイルについても説明します。 .SS "クラスのソース・ファイル" .PP それぞれのクラスまたはインタフェース、およびそのメンバーは、独自のドキュメンテーション・コメントを持つことができ、それをソース・ファイル内に保持します。ドキュメンテーション・コメントを参照してください。 .SS "パッケージ・コメント・ファイル" .PP -それぞれのパッケージは、独自のドキュメンテーション・コメントを持つことができ、それを専用のソース・ファイルに保持します。その内容は、\fIjavadoc\fRコマンドによって生成されるパッケージのサマリー・ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。 +それぞれのパッケージは、独自のドキュメンテーション・コメントを持つことができ、それを専用のソース・ファイルに保持します。その内容は、\fBjavadoc\fRコマンドによって生成されるパッケージのサマリー・ページに組み込まれます。このコメントには、通常、そのパッケージ全体に当てはまるドキュメントを記述します。 .PP パッケージ・コメント・ファイルを作成するには、次のいずれかのファイルにコメントを格納できます。 .sp @@ -257,7 +263,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIpackage\-info\&.java\fRファイルには、パッケージ宣言、パッケージ注釈、パッケージ・コメント、およびJavadocタグを格納できます。このファイルが優先されます。 +\fBpackage\-info\&.java\fRファイルには、パッケージ宣言、パッケージ注釈、パッケージ・コメント、およびJavadocタグを格納できます。このファイルが優先されます。 .RE .sp .RS 4 @@ -268,73 +274,81 @@ .sp -1 .IP \(bu 2.3 .\} -\fIpackage\&.html\fRファイルには、パッケージ・コメントとJavadocタグのみを格納できます。パッケージ注釈は格納できません。 -.RE -.PP -各パッケージは、\fIpackage\&.html\fRファイルまたは\fIpackage\-info\&.java\fRファイルのいずれかを1つ持つことができますが、その両方を持つことはできません。このどちらかのファイルをソース・ファイルとともに、ソース・ツリー内のそのパッケージ・ディレクトリ内に配置してください。 -package\-info\&.javaファイル.PP -\fIpackage\-info\&.java\fRファイルには、次の構造のパッケージ・コメントを含めることができます。コメントは、パッケージ宣言の前に配置されます。 +\fBpackage\&.html\fRファイルには、パッケージ・コメントとJavadocタグのみを格納できます。パッケージ注釈は格納できません。 +.RE +.PP +各パッケージは、\fBpackage\&.html\fRファイルまたは\fBpackage\-info\&.java\fRファイルのいずれかを1つ持つことができますが、その両方を持つことはできません。このどちらかのファイルをソース・ファイルとともに、ソース・ツリー内のそのパッケージ・ディレクトリ内に配置してください。 +.PP +package\-info\&.javaファイル +.PP +\fBpackage\-info\&.java\fRファイルには、次の構造のパッケージ・コメントを含めることができます。コメントは、パッケージ宣言の前に配置されます。 .PP \fB注意:\fR -コメント区切り文字である\fI/**\fRおよび\fI*/\fRが存在する必要がありますが、中間の行の先頭のアスタリスクは省略可能です。 +コメント区切り文字である\fB/**\fRおよび\fB*/\fRが存在する必要がありますが、中間の行の先頭のアスタリスクは省略可能です。 .sp .if n \{\ .RS 4 .\} .nf -/** - * Provides the classes necessary to create an - * applet and the classes an applet uses - * to communicate with its applet context\&. - * <p> - * The applet framework involves two entities: - * the applet 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 - */ -package java\&.lang\&.applet; +\fB/**\fR +\fB * Provides the classes necessary to create an \fR +\fB * applet and the classes an applet uses \fR +\fB * to communicate with its applet context\&.\fR +\fB * <p>\fR +\fB * The applet framework involves two entities:\fR +\fB * the applet and the applet context\&.\fR +\fB * An applet is an embeddable window (see the\fR +\fB * {@link java\&.awt\&.Panel} class) with a few extra\fR +\fB * methods that the applet context can use to \fR +\fB * initialize, start, and stop the applet\&.\fR +\fB *\fR +\fB * @since 1\&.0\fR +\fB * @see java\&.awt\fR +\fB */\fR +\fBpackage java\&.lang\&.applet;\fR + .fi .if n \{\ .RE .\} -package\&.htmlファイル.PP -\fIpackage\&.html\fRファイルには、次の構造のパッケージ・コメントを含めることができます。コメントは、\fI<body>\fR要素に配置されます。 +.PP +package\&.htmlファイル +.PP +\fBpackage\&.html\fRファイルには、次の構造のパッケージ・コメントを含めることができます。コメントは、\fB<body>\fR要素に配置されます。 .PP ファイル: -\fIjava/applet/package\&.html\fR +\fBjava/applet/package\&.html\fR .sp .if n \{\ .RS 4 .\} .nf -<HTML> -<BODY> -Provides the classes necessary to create an applet and the -classes an applet uses to communicate with its applet context\&. -<p> -The applet framework involves two entities: the applet -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> +\fB<HTML>\fR +\fB<BODY>\fR +\fBProvides the classes necessary to create an applet and the \fR +\fBclasses an applet uses to communicate with its applet context\&.\fR +\fB<p>\fR +\fBThe applet framework involves two entities: the applet\fR +\fBand the applet context\&. An applet is an embeddable\fR +\fBwindow (see the {@link java\&.awt\&.Panel} class) with a\fR +\fBfew extra methods that the applet context can use to\fR +\fBinitialize, start, and stop the applet\&. \fR + +\fB@since 1\&.0 \fR +\fB@see java\&.awt\fR +\fB</BODY>\fR +\fB</HTML>\fR + .fi .if n \{\ .RE .\} .PP -\fIpackage\&.html\fRファイルは通常のHTMLファイルであり、パッケージ宣言を含んでいません。パッケージ・コメント・ファイルの内容はHTMLで記述しますが、例外が1つあります。このドキュメンテーション・コメントには、コメント区切り文字である\fI/**\fRと\fI*/\fR、または行頭のアスタリスクを含めない、という点です。コメントを書く場合は、最初の文をパッケージのサマリーとし、\fI<body>\fRタグと最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージ・タグを含めることができます。すべてのブロック・タグは、主説明の後に配置する必要があります。\fI@see\fRタグをパッケージ・コメント・ファイルに追加する場合には、完全修飾名を使用する必要があります。 -コメント・ファイルの処理.PP -\fIjavadoc\fRコメントを実行すると、パッケージ・コメント・ファイルが検索されます。パッケージ・コメント・ファイルが見つかった場合は、\fIjavadoc\fRコマンドは次の手順を実行します。 +\fBpackage\&.html\fRファイルは通常のHTMLファイルであり、パッケージ宣言を含んでいません。パッケージ・コメント・ファイルの内容はHTMLで記述しますが、例外が1つあります。このドキュメンテーション・コメントには、コメント区切り文字である\fB/**\fRと\fB*/\fR、または行頭のアスタリスクを含めない、という点です。コメントを書く場合は、最初の文をパッケージのサマリーとし、\fB<body>\fRタグと最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージ・タグを含めることができます。すべてのブロック・タグは、主説明の後に配置する必要があります。\fB@see\fRタグをパッケージ・コメント・ファイルに追加する場合には、完全修飾名を使用する必要があります。 +.PP +コメント・ファイルの処理 +.PP +\fBjavadoc\fRコメントを実行すると、パッケージ・コメント・ファイルが検索されます。パッケージ・コメント・ファイルが見つかった場合は、\fBjavadoc\fRコマンドは次の手順を実行します。 .sp .RS 4 .ie n \{\ @@ -344,8 +358,8 @@ .sp -1 .IP \(bu 2.3 .\} -処理できるようにコメントをコピーします。package\&.htmlの場合、\fIjavadoc\fRコマンドは、\fI<body>\fRと\fI</body>\fR -HTMLタグ間のすべての内容をコピーします。\fI<head>\fRセクションを含め、そこに\fI<title>\fRタグやソース・ファイルの著作権記述などの情報を配置することもできますが、生成されたドキュメントにはそれらは一切表示されません。 +処理できるようにコメントをコピーします。package\&.htmlの場合、\fBjavadoc\fRコマンドは、\fB<body>\fRと\fB</body>\fR +HTMLタグ間ですべてのコンテンツをコピーします。\fB<head>\fRセクションを含めて、\fB<title>\fRタグ、ソース・ファイルのコピーライト文、その他の情報を配置することはできますが、これらは生成されるドキュメントには表示されません。 .RE .sp .RS 4 @@ -379,24 +393,24 @@ .sp -1 .IP \(bu 2.3 .\} -パッケージのサマリー・ページの先頭に、パッケージ・コメントの最初の文をコピーします。さらに、\fIjavadoc\fRコマンドは、概要ページのパッケージ・リストに、パッケージ名とパッケージ・コメントの最初の文を追加します。Javaプラットフォーム、Standard Edition API仕様の概要 +パッケージのサマリー・ページの先頭に、パッケージ・コメントの最初の文をコピーします。さらに、\fBjavadoc\fRコマンドは、概要ページのパッケージ・リストに、パッケージ名とパッケージ・コメントの最初の文を追加します。Javaプラットフォーム、Standard Edition API仕様の概要 (http://docs\&.oracle\&.com/javase/8/docs/api/overview\-summary\&.html)を参照してください .sp 文の終わりは、クラスやメンバーの主説明の最初の文の終わりと同じルールによって判断されます。 .RE .SS "概要コメント・ファイル" .PP -ドキュメント化する各アプリケーションまたはパッケージ・セットは、独自の概要ドキュメンテーション・コメントを持つことができ、それは専用のソース・ファイルに保持されます。その内容は、\fIjavadoc\fRコマンドによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージ・セット全体に当てはまるドキュメントを記述します。 +ドキュメント化する各アプリケーションまたはパッケージ・セットは、独自の概要ドキュメンテーション・コメントを持つことができ、それは専用のソース・ファイルに保持されます。その内容は、\fBjavadoc\fRコマンドによって生成される概要ページに組み込まれます。このコメントには、通常、アプリケーションまたはパッケージ・セット全体に当てはまるドキュメントを記述します。 .PP このファイルにはoverview\&.htmlなどの名前を付けることができ、どこに配置してもかまいません。一般的な場所は、ソース・ツリーの最上部です。 .PP -たとえば、\fIjava\&.applet\fRパッケージのソース・ファイルが/home/user/src/java/appletディレクトリに格納されている場合、概要コメント・ファイルは/home/user/src/overview\&.htmlに作成できます。 -.PP -異なるパッケージのセットに対して\fIjavadoc\fRコマンドを複数回実行する場合は、同じ1つのソース・ファイルのセットに対して複数の概要コメント・ファイルを作成できます。たとえば、内部ドキュメント用に\fI\-private\fRを指定して\fIjavadoc\fRコマンドを1回実行した後、公開ドキュメント用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメント・ファイルの1文目で、そのドキュメントを公開用または内部用として記述できます。 -.PP -概要コメント・ファイルの内容は、HTMLで記述された1つの大きなドキュメンテーション・コメントです。最初の文はアプリケーションまたはパッケージのセットのサマリーとします。\fI<body>\fRタグと最初の文の間にタイトルやその他のテキストを含めないようにします。{\fI@link}\fRなどのインライン・タグを除くすべてのタグは、主説明の後に配置する必要があります。\fI@see\fRタグを追加する場合には、完全修飾名を使用する必要があります。 -.PP -\fIjavadoc\fRコマンドの実行時に、\fI\-overview\fRオプションを使用して概要コメント・ファイル名を指定します。このファイルは、パッケージ・コメント・ファイルと同じように処理されます。\fIjavadoc\fRコマンドは次の手順を実行します。 +たとえば、\fBjava\&.applet\fRパッケージのソース・ファイルが/home/user/src/java/appletディレクトリに格納されている場合、概要コメント・ファイルは/home/user/src/overview\&.htmlに作成できます。 +.PP +異なるパッケージのセットに対して\fBjavadoc\fRコマンドを複数回実行する場合は、同じ1つのソース・ファイルのセットに対して複数の概要コメント・ファイルを作成できます。たとえば、内部ドキュメント用に\fB\-private\fRを指定して\fBjavadoc\fRコマンドを1回実行した後、公開ドキュメント用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメント・ファイルの1文目で、そのドキュメントを公開用または内部用として記述できます。 +.PP +概要コメント・ファイルの内容は、HTMLで記述された1つの大きなドキュメンテーション・コメントです。最初の文はアプリケーションまたはパッケージのセットのサマリーとします。\fB<body>\fRタグと最初の文の間にタイトルやその他のテキストを含めないようにします。{\fB@link}\fRなどのインライン・タグを除くすべてのタグは、主説明の後に配置する必要があります。\fB@see\fRタグを追加する場合には、完全修飾名を使用する必要があります。 +.PP +\fBjavadoc\fRコマンドの実行時に、\fB\-overview\fRオプションを使用して概要コメント・ファイル名を指定します。このファイルは、パッケージ・コメント・ファイルと同じように処理されます。\fBjavadoc\fRコマンドは次の手順を実行します。 .sp .RS 4 .ie n \{\ @@ -406,7 +420,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI<body>\fRと\fI</body>\fRタグの間にある内容をすべて処理対象としてコピーします。 +\fB<body>\fRと\fB</body>\fRタグ間で、処理するすべてのコンテンツをコピーします。 .RE .sp .RS 4 @@ -444,50 +458,56 @@ .RE .SS "未処理のファイル" .PP -ソース・ファイルには、\fIjavadoc\fRコマンドによって宛先ディレクトリにコピーされる、任意のファイルを含めることができます。このようなファイルには、通常、グラフィック・ファイル、サンプルのJavaソースおよびクラス・ファイル、一般的なJavaソース・ファイルのドキュメンテーション・コメントの影響を受けない多くの内容を含む独立したHTMLファイルなどがあります。 +ソース・ファイルには、\fBjavadoc\fRコマンドによって宛先ディレクトリにコピーされる、任意のファイルを含めることができます。このようなファイルには、通常、グラフィック・ファイル、サンプルのJavaソースおよびクラス・ファイル、一般的なJavaソース・ファイルのドキュメンテーション・コメントの影響を受けない多くの内容を含む独立したHTMLファイルなどがあります。 .PP 未処理のファイルを含めるには、doc\-filesというディレクトリにファイルを配置します。doc\-filesディレクトリは、ソース・ファイルを含む任意のパッケージ・ディレクトリのサブディレクトリになることができます。doc\-filesサブディレクトリは、パッケージごとに1つ用意できます。 .PP -たとえば、ボタンのイメージを\fIjava\&.awt\&.Button\fRクラスのドキュメントに含める場合には、そのイメージ・ファイルを/home/user/src/java/awt/doc\-files/ディレクトリに置きます。doc\-filesディレクトリを/home/user/src/java/doc\-filesに置かないでください。javaはパッケージではないからです。ソース・ファイルを含めることもできません。 -.PP -\fIjavadoc\fRコマンドはファイルを参照しないので、未処理のファイルへのすべてのリンクは、コードに含まれている必要があります。\fIjavadoc\fRコマンドはディレクトリとそのすべての内容を宛先にコピーします。次の例では、Button\&.javaドキュメンテーション・コメントのリンクがどのように見えるかを示しています。 +たとえば、ボタンのイメージを\fBjava\&.awt\&.Button\fRクラスのドキュメントに含める場合には、そのイメージ・ファイルを/home/user/src/java/awt/doc\-files/ディレクトリに置きます。doc\-filesディレクトリを/home/user/src/java/doc\-filesに置かないでください。javaはパッケージではないからです。ソース・ファイルを含めることもできません。 +.PP +\fBjavadoc\fRコマンドはファイルを参照しないので、未処理のファイルへのすべてのリンクは、コードに含まれている必要があります。\fBjavadoc\fRコマンドはディレクトリとそのすべての内容を宛先にコピーします。次の例では、Button\&.javaドキュメンテーション・コメントのリンクがどのように見えるかを示しています。 .sp .if n \{\ .RS 4 .\} .nf -/** - * This button looks like this: - * <img src="doc\-files/Button\&.gif"> - */ +\fB/**\fR +\fB * This button looks like this: \fR +\fB * <img src="doc\-files/Button\&.gif">\fR +\fB */\fR + .fi .if n \{\ .RE .\} .SS "テストおよびテンプレート・ファイル" .PP -ソース・ツリーのテストおよびテンプレート・ファイルを、ソース・ファイルが存在するディレクトリまたはサブディレクトリと同じディレクトリに格納できます。テストおよびテンプレート・ファイルが処理されるのを防ぐには、\fIjavadoc\fRコマンドを実行し、明示的に個別のソース・ファイル名を渡します。 -.PP -テスト・ファイルは、有効な、コンパイル可能なソース・ファイルです。テンプレート・ファイルは、有効な、互換性のあるソース・ファイルではありませんが、多くの場合、\fI\&.java\fR接尾辞を持っています。 -テスト・ファイル.PP -テスト・ファイルを、名前なしパッケージや、ソース・ファイルが存在するパッケージとは別のパッケージに属するようにする場合、テスト・ファイルをソース・ファイルの下のサブディレクトリに配置し、そのディレクトリに無効な名前を付けます。テスト・ファイルをソースと同じディレクトリに配置し、パッケージ名を示すコマンドライン引数を指定して\fIjavadoc\fRコマンドを呼び出すと、テスト・ファイルは警告またはエラーを引き起こします。ファイルが無効な名前を持つサブディレクトリ内に存在する場合、テスト・ファイル・ディレクトリはスキップされ、エラーまたは警告は発行されません。たとえば、ソース・ファイルのテスト・ファイルをcom\&.package1に追加するには、無効なパッケージ名のサブディレクトリに配置します。次のディレクトリ名にはハイフンが含まれているため無効です。 +ソース・ツリーのテストおよびテンプレート・ファイルを、ソース・ファイルが存在するディレクトリまたはサブディレクトリと同じディレクトリに格納できます。テストおよびテンプレート・ファイルが処理されるのを防ぐには、\fBjavadoc\fRコマンドを実行し、明示的に個別のソース・ファイル名を渡します。 +.PP +テスト・ファイルは、有効な、コンパイル可能なソース・ファイルです。テンプレート・ファイルは、有効な、互換性のあるソース・ファイルではありませんが、多くの場合、\fB\&.java\fR接尾辞を持っています。 +.PP +テスト・ファイル +.PP +テスト・ファイルを、名前なしパッケージや、ソース・ファイルが存在するパッケージとは別のパッケージに属するようにする場合、テスト・ファイルをソース・ファイルの下のサブディレクトリに配置し、そのディレクトリに無効な名前を付けます。テスト・ファイルをソースと同じディレクトリに配置し、パッケージ名を示すコマンド行引数を指定して\fBjavadoc\fRコマンドを呼び出すと、テスト・ファイルは警告またはエラーを引き起こします。ファイルが無効な名前を持つサブディレクトリ内に存在する場合、テスト・ファイル・ディレクトリはスキップされ、エラーまたは警告は発行されません。たとえば、ソース・ファイルのテスト・ファイルをcom\&.package1に追加するには、無効なパッケージ名のサブディレクトリに配置します。次のディレクトリ名にはハイフンが含まれているため無効です。 .sp .if n \{\ .RS 4 .\} .nf -com/package1/test\-files/ +\fBcom/package1/test\-files/\fR + .fi .if n \{\ .RE .\} .PP -テスト・ファイルにドキュメンテーション・コメントが含まれる場合、\fIjavadoc\fRコマンドの個別の実行で、ワイルドカードを含んだテスト・ソース・ファイル名(\fIcom/package1/test\-files/*\&.java\fRなど)を渡して、テスト・ファイルのドキュメントを生成するように設定できます。 -テンプレート・ファイル.PP -テンプレート・ファイルをソース・ディレクトリに配置するが、\fIjavadoc\fRコマンドを実行するときにエラーを生成しない場合、ファイルに\fIBuffer\-Template\&.java\fRなどの無効な名前を付けて、処理させないようにします。\fIjavadoc\fRコマンドは、接尾辞の\fI\&.java\fRが削除されると有効なクラス名になる名前を持つソース・ファイルのみを処理します。 +テスト・ファイルにドキュメンテーション・コメントが含まれる場合、\fBjavadoc\fRコマンドの個別の実行で、ワイルドカードを含んだテスト・ソース・ファイル名(\fBcom/package1/test\-files/*\&.java\fRなど)を渡して、テスト・ファイルのドキュメントを生成するように設定できます。 +.PP +テンプレート・ファイル +.PP +テンプレート・ファイルをソース・ディレクトリに配置するが、\fBjavadoc\fRコマンドを実行するときにエラーを生成しない場合、ファイルに\fBBuffer\-Template\&.java\fRなどの無効な名前を付けて、処理させないようにします。\fBjavadoc\fRコマンドは、接尾辞の\fB\&.java\fRが削除されると有効なクラス名になる名前を持つソース・ファイルのみを処理します。 .SH "生成されるファイル" .PP -デフォルトでは、\fIjavadoc\fRコマンドは、HTML形式のドキュメントを生成する標準ドックレットを使用します。標準ドックレットは、ここで説明する、基本内容ページ、相互参照ページ、サポート・ページを生成します。各HTMLページは個別のファイルに対応します。\fIjavadoc\fRコマンドは、2つのタイプのファイルを生成します。最初のタイプには、クラスおよびインタフェースに応じた名前が付けられます。2番目のタイプには、最初のタイプのファイルとの競合を防ぐために、ハイフンが含まれます(package\-summary\&.htmlなど)。 +デフォルトでは、\fBjavadoc\fRコマンドは、HTML形式のドキュメントを生成する標準ドックレットを使用します。標準ドックレットは、ここで説明する、基本内容ページ、相互参照ページ、サポート・ページを生成します。各HTMLページは個別のファイルに対応します。\fBjavadoc\fRコマンドは、2つのタイプのファイルを生成します。最初のタイプには、クラスおよびインタフェースに応じた名前が付けられます。2番目のタイプには、最初のタイプのファイルとの競合を防ぐために、ハイフンが含まれます(package\-summary\&.htmlなど)。 .SS "基本内容ページ" .sp .RS 4 @@ -509,7 +529,7 @@ .sp -1 .IP \(bu 2.3 .\} -記載されているパッケージごとに1つのパッケージ・ページ(package\-summary\&.html)。\fIjavadoc\fRコマンドは、ソース・ツリーのパッケージ・ディレクトリ内にあるpackage\&.htmlまたはpackage\-info\&.javaという名前のファイル内のHTMLテキストをすべて組み入れます。 +記載されているパッケージごとに1つのパッケージ・ページ(package\-summary\&.html)。\fBjavadoc\fRコマンドは、ソース・ツリーのパッケージ・ディレクトリ内にあるpackage\&.htmlまたはpackage\-info\&.javaという名前のファイル内のHTMLテキストをすべて組み入れます。 .RE .sp .RS 4 @@ -520,7 +540,7 @@ .sp -1 .IP \(bu 2.3 .\} -パッケージのセット全体に対して1つの概要ページ(overview\-summary\&.html)。概要ページは、生成ドキュメントの先頭ページになります。\fIjavadoc\fRコマンドは、\fI\-overview\fRオプションで指定されたファイル内のHTMLテキストをすべて組み入れます。概要ページが作成されるのは、\fIjavadoc\fRコマンドに複数のパッケージ名を渡した場合のみです。HTMLフレームおよびオプションを参照してください。 +パッケージのセット全体に対して1つの概要ページ(overview\-summary\&.html)。概要ページは、生成ドキュメントの先頭ページになります。\fBjavadoc\fRコマンドは、\fB\-overview\fRオプションで指定されたファイル内のHTMLテキストをすべて組み入れます。概要ページが作成されるのは、\fBjavadoc\fRコマンドに複数のパッケージ名を渡した場合のみです。HTMLフレームおよびオプションを参照してください。 .RE .SS "相互参照ページ" .sp @@ -587,9 +607,9 @@ .sp -1 .IP \(bu 2.3 .\} -直列化された形式ページ(serialized\-form\&.html)。フィールドおよびメソッドの説明を含む、直列化可能かつ外部化可能なクラスに関する情報用のページです。このページ内の情報は、APIを使用する開発者ではなく、再実装者に必要な情報です。直列化された形式ページへアクセスするには、直列化されたクラスに移動して、そのクラス・コメントにある「関連項目」セクションで「直列化された形式」をクリックします。標準ドックレットは直列化された形式ページを生成します。このページには、Serializableを実装するすべてのクラス(publicまたは非public)が、その\fIreadObject\fRや\fIwriteObject\fRメソッド、直列化されたフィールド、および\fI@serial\fR、\fI@serialField\fR、\fI@serialData\fRタグからのドキュメンテーション・コメントとともにリストされます。直列化可能なpublicクラスを除外するには、そのクラス(またはそのパッケージ)を\fI@serial\fR -excludeでマークします。直列化可能なpackage\-privateクラスを含めるには、そのクラス(またはそのパッケージ)を\fI@serial\fR -includeでマークします。リリース1\&.4では、\fI\-private\fRオプションを指定せずに\fIjavadoc\fRコマンドを実行することにより、publicクラスおよびprivateクラスの完全に直列化された形式を生成できます。オプションを参照してください。 +直列化された形式ページ(serialized\-form\&.html)。フィールドおよびメソッドの説明を含む、直列化可能かつ外部化可能なクラスに関する情報用のページです。このページ内の情報は、APIを使用する開発者ではなく、再実装者に必要な情報です。直列化された形式ページへアクセスするには、直列化されたクラスに移動して、そのクラス・コメントにある「関連項目」セクションで「直列化された形式」をクリックします。標準ドックレットは直列化された形式ページを生成します。このページには、Serializableを実装するすべてのクラス(publicまたは非public)が、その\fBreadObject\fRや\fBwriteObject\fRメソッド、直列化されたフィールド、および\fB@serial\fR、\fB@serialField\fR、\fB@serialData\fRタグからのドキュメンテーション・コメントとともにリストされます。直列化可能なpublicクラスを除外するには、そのクラス(またはそのパッケージ)を\fB@serial\fR +excludeでマークします。直列化可能なpackage\-privateクラスを含めるには、そのクラス(またはそのパッケージ)を\fB@serial\fR +includeでマークします。リリース1\&.4では、\fB\-private\fRオプションを指定せずに\fBjavadoc\fRコマンドを実行することにより、publicクラスおよびprivateクラスの完全に直列化された形式を生成できます。オプションを参照してください。 .RE .sp .RS 4 @@ -600,7 +620,7 @@ .sp -1 .IP \(bu 2.3 .\} -索引ページ(\fIindex\-*\&.html\fR)。すべてのクラス名、インタフェース名、コンストラクタ名、フィールド名、およびメソッド名がアルファベット順に並んでいます。索引ページは、Unicodeを扱えるように国際化されています。1つのファイルとして生成することも、先頭文字(英語の場合A\(enZ)ごとに別々のファイルとして生成することもできます。 +索引ページ(\fBindex\-*\&.html\fR)。すべてのクラス名、インタフェース名、コンストラクタ名、フィールド名、およびメソッド名がアルファベット順に並んでいます。索引ページは、Unicodeを扱えるように国際化されています。1つのファイルとして生成することも、先頭文字(英語の場合A\(enZ)ごとに別々のファイルとして生成することもできます。 .RE .SS "サポート・ページ" .sp @@ -612,7 +632,7 @@ .sp -1 .IP \(bu 2.3 .\} -ヘルプ・ページ(help\-doc\&.html)。ナビゲーション・バーや前述の各ページに関する説明が記載されています。デフォルトのヘルプ・ファイルを独自のカスタム・ヘルプ・ファイルでオーバーライドするには、\fI\-helpfile\fRを使用します。 +ヘルプ・ページ(help\-doc\&.html)。ナビゲーション・バーや前述の各ページに関する説明が記載されています。デフォルトのヘルプ・ファイルを独自のカスタム・ヘルプ・ファイルでオーバーライドするには、\fB\-helpfile\fRを使用します。 .RE .sp .RS 4 @@ -634,7 +654,7 @@ .sp -1 .IP \(bu 2.3 .\} -複数のフレーム・ファイル(\fI*\-frame\&.html\fR)。パッケージ、クラス、およびインタフェースのリストが含まれています。フレーム・ファイルはHTMLフレームを表示します。 +複数のフレーム・ファイル(\fB*\-frame\&.html\fR)。パッケージ、クラス、およびインタフェースのリストが含まれています。フレーム・ファイルはHTMLフレームを表示します。 .RE .sp .RS 4 @@ -645,7 +665,7 @@ .sp -1 .IP \(bu 2.3 .\} -パッケージ・リスト・ファイル(package\-list)。\fI\-link\fRおよび\fI\-linkoffline\fRオプションで使用されます。パッケージ・リスト・ファイルはテキスト・ファイルであり、どのリンクからもアクセスできません。 +パッケージ・リスト・ファイル(package\-list)。\fB\-link\fRおよび\fB\-linkoffline\fRオプションで使用されます。パッケージ・リスト・ファイルはテキスト・ファイルであり、どのリンクからもアクセスできません。 .RE .sp .RS 4 @@ -667,22 +687,22 @@ .sp -1 .IP \(bu 2.3 .\} -doc\-filesディレクトリ。宛先ディレクトリにコピーするイメージ、サンプル・コード、ソース・コードなどのファイルが格納されます。これらのファイルは、\fIjavadoc\fRコマンドによって処理されません。このディレクトリは、ソース・ツリーの中に存在する場合にのみ処理されます。 +doc\-filesディレクトリ。宛先ディレクトリにコピーするイメージ、サンプル・コード、ソース・コードなどのファイルが格納されます。これらのファイルは、\fBjavadoc\fRコマンドによって処理されません。このディレクトリは、ソース・ツリーの中に存在する場合にのみ処理されます。 .RE .PP オプションを参照してください。 .SS "HTMLフレーム" .PP -\fIjavadoc\fRコマンドは、コマンドに渡された値に基づき、最小限必要な数(2または3)のフレームを生成します。\fIjavadoc\fRコマンドに引数として1つのパッケージ名または1つのパッケージに含まれるソース・ファイルを渡す場合は、パッケージのリストが省略されます。そのかわりに、\fIjavadoc\fRコマンドは左側の列に1つのフレームを作成し、クラスのリストを表示します。複数のパッケージ名を渡した場合は、\fIjavadoc\fRコマンドは、すべてのパッケージをリストする第3のフレームと概要ページ(overview\-summary\&.html)を作成します。フレームを省略するには、「フレームなし」リンクをクリックするか、overview\-summary\&.htmlページからページ・セットを表示します。 +\fBjavadoc\fRコマンドは、コマンドに渡された値に基づき、最小限必要な数(2または3)のフレームを生成します。\fBjavadoc\fRコマンドに引数として1つのパッケージ名または1つのパッケージに含まれるソース・ファイルを渡す場合は、パッケージのリストが省略されます。そのかわりに、\fBjavadoc\fRコマンドは左側の列に1つのフレームを作成し、クラスのリストを表示します。複数のパッケージ名を渡した場合は、\fBjavadoc\fRコマンドは、すべてのパッケージをリストする第3のフレームと概要ページ(overview\-summary\&.html)を作成します。フレームを省略するには、「フレームなし」リンクをクリックするか、overview\-summary\&.htmlページからページ・セットを表示します。 .SS "生成されるファイルの構造" .PP 生成されるクラス・ファイルおよびインタフェース・ファイルは、Javaソース・ファイルおよびクラス・ファイルと同じディレクトリ階層に編成されます。1つのサブパッケージにつき1つのディレクトリ、という構造になります。 .PP -たとえば、\fIjava\&.applet\&.Applet\fRクラス用に生成されるドキュメントは、java/applet/Applet\&.htmlに格納されます。 -.PP -生成先ディレクトリの名前が\fIapidocs\fRだとすると、\fIjava\&.applet\fRパッケージのファイルの構造は、次のとおりです。前述のように、\fIframe\fRという語を名前に含むファイルは、すべて左上または左下のフレームに表示されます。それ以外のHTMLファイルは、すべて右側のフレームに表示されます。 -.PP -ディレクトリは太字です。アスタリスク(*)は、\fIjavadoc\fRコマンドへの引数がパッケージ名ではなくソース・ファイル名である場合に省略されるファイルおよびディレクトリを示しています。引数がソース・ファイル名の場合、空のパッケージ・リストが作成されます。doc\-filesディレクトリは、ソース・ツリー内に存在する場合にのみ、生成先に作成されます。生成されるファイルを参照してください。 +たとえば、\fBjava\&.applet\&.Applet\fRクラス用に生成されるドキュメントは、java/applet/Applet\&.htmlに格納されます。 +.PP +生成先ディレクトリの名前が\fBapidocs\fRだとすると、\fBjava\&.applet\fRパッケージのファイルの構造は、次のとおりです。前述のように、\fIframe\fRという語を名前に含むファイルは、すべて左上または左下のフレームに表示されます。それ以外のHTMLファイルは、すべて右側のフレームに表示されます。 +.PP +ディレクトリは太字です。アスタリスク(*)は、\fBjavadoc\fRコマンドへの引数がパッケージ名ではなくソース・ファイル名である場合に省略されるファイルおよびディレクトリを示しています。引数がソース・ファイル名の場合、空のパッケージ・リストが作成されます。doc\-filesディレクトリは、ソース・ツリー内に存在する場合にのみ、生成先に作成されます。生成されるファイルを参照してください。 .sp .RS 4 .ie n \{\ @@ -802,7 +822,7 @@ .IP \(bu 2.3 .\} index\-all\&.html: -\fI\-splitindex\fRオプションなしで作成されたデフォルトの索引 +\fB\-splitindex\fRオプションなしで作成されたデフォルトの索引 .RE .sp .RS 4 @@ -814,7 +834,7 @@ .IP \(bu 2.3 .\} \fBindex\-files\fR: -\fI\-splitindex\fRオプションを指定して作成されたディレクトリ +\fB\-splitindex\fRオプションを指定して作成されたディレクトリ .sp .RS 4 .ie n \{\ @@ -825,7 +845,7 @@ .IP \(bu 2.3 .\} index\-<number>\&.html: -\fI\-splitindex\fRオプションを指定して作成された索引ファイル +\fB\-splitindex\fRオプションを指定して作成された索引ファイル .RE .RE .sp @@ -881,7 +901,7 @@ .IP \(bu 2.3 .\} Applet\&.html: -\fIApplet\fRクラス・ページ +\fBApplet\fRクラス・ページ .RE .sp .RS 4 @@ -893,7 +913,7 @@ .IP \(bu 2.3 .\} AppletContext\&.html: -\fIAppletContext\fRインタフェース +\fBAppletContext\fRインタフェース .RE .sp .RS 4 @@ -905,7 +925,7 @@ .IP \(bu 2.3 .\} AppletStub\&.html: -\fIAppletStub\fRインタフェース +\fBAppletStub\fRインタフェース .RE .sp .RS 4 @@ -917,7 +937,7 @@ .IP \(bu 2.3 .\} AudioClip\&.html: -\fIAudioClip\fRインタフェース +\fBAudioClip\fRインタフェース .RE .sp .RS 4 @@ -988,13 +1008,13 @@ \- Applet\&.html: Appletクラスの使用 .sp \- AppletContext\&.html: -\fIAppletContext\fRインタフェースの使用 +\fBAppletContext\fRインタフェースの使用 .sp \- AppletStub\&.html: -\fIAppletStub\fRインタフェースの使用 +\fBAppletStub\fRインタフェースの使用 .sp \- AudioClip\&.html: -\fIAudioClip\fRインタフェースの使用 +\fBAudioClip\fRインタフェースの使用 .RE .RE .RE @@ -1032,62 +1052,65 @@ \- Applet\&.html: Appletソース・コード .sp \- AppletContext\&.html: -\fIAppletContext\fRソース・コード +\fBAppletContext\fRソース・コード .sp \- AppletStub\&.html: -\fIAppletStub\fRソース・コード +\fBAppletStub\fRソース・コード .sp \- AudioClip\&.html: -\fIAudioClip\fRソース・コード +\fBAudioClip\fRソース・コード .RE .RE .RE .SS "生成されるAPI宣言" .PP -\fIjavadoc\fRコマンドは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの記述の最初に、そのAPI用の宣言を生成します。たとえば、\fIBoolean\fRクラスの宣言は、次のようになります。 +\fBjavadoc\fRコマンドは、それぞれのクラス、インタフェース、フィールド、コンストラクタ、およびメソッドの記述の最初に、そのAPI用の宣言を生成します。たとえば、\fBBoolean\fRクラスの宣言は、次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -public final class Boolean -extends Object -implements Serializable +\fBpublic final class Boolean\fR +\fBextends Object\fR +\fBimplements Serializable\fR + .fi .if n \{\ .RE .\} .PP -\fIBoolean\&.valueOf\fRメソッドの宣言は次のとおりです。 +\fBBoolean\&.valueOf\fRメソッドの宣言は次のとおりです。 .sp .if n \{\ .RS 4 .\} .nf -public static Boolean valueOf(String s) +\fBpublic static Boolean valueOf(String s)\fR + .fi .if n \{\ .RE .\} .PP -\fIjavadoc\fRコマンドは、修飾子\fIpublic\fR、\fIprotected\fR、\fIprivate\fR、\fIabstract\fR、\fIfinal\fR、\fIstatic\fR、\fItransient\fR、および\fIvolatile\fRを含めることができますが、\fIsynchronized\fRおよび\fInative\fRはできません。\fIsynchronized\fRおよび\fInative\fR修飾子は、実装の詳細とみなされているため、API仕様には含まれません。 -.PP -APIでは、並行性セマンティクスについて、キーワード\fIsynchronized\fRに依存するのではなく、コメントの主説明としてドキュメント化する必要があります。たとえば、「1つのenumerationを複数のスレッドから並行して使用することはできない」のように記述します。ドキュメントには、これらのセマンティクスを実現する方法を記述しないでください。たとえば、\fIHashtable\fRオプションはスレッドセーフである必要がありますが、「エクスポートされるすべてのメソッドを同期化してそれを実現する」のように指定する根拠はありません。より高度な並行性のために、バケット・レベルで内部的に同期化する権限を保有しておくことをお薦めします。 +\fBjavadoc\fRコマンドは、修飾子\fBpublic\fR、\fBprotected\fR、\fBprivate\fR、\fBabstract\fR、\fBfinal\fR、\fBstatic\fR、\fBtransient\fR、および\fBvolatile\fRを含めることができますが、\fBsynchronized\fRおよび\fBnative\fRはできません。\fBsynchronized\fRおよび\fBnative\fR修飾子は、実装の詳細とみなされているため、API仕様には含まれません。 +.PP +APIでは、並行性セマンティクスについて、キーワード\fBsynchronized\fRに依存するのではなく、コメントの主説明としてドキュメント化する必要があります。たとえば、「1つのenumerationを複数のスレッドから並行して使用することはできない」のように記述します。ドキュメントには、これらのセマンティクスを実現する方法を記述しないでください。たとえば、\fBHashtable\fRオプションはスレッドセーフである必要がありますが、「エクスポートされるすべてのメソッドを同期化してそれを実現する」のように指定する根拠はありません。より高度な並行性のために、バケット・レベルで内部的に同期化する権限を保有しておくことをお薦めします。 .SH "ドキュメンテーション・コメント" .PP このセクションでは、ソース・コードのコメントとコメントの継承について説明します。 .SS "ソース・コード・コメント" .PP -ソース・コードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、ドキュメンテーション・コメントを記述することができます。各パッケージにもドキュメンテーション・コメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーション・コメントを作成できます。ドキュメンテーション・コメントは、\fI/**\fRと、終わりを表す\fI*/\fRの間にある文字から構成されます。先頭のアスタリスクは各行で使用でき、次の項で詳しく説明します。コメントのテキストは、複数行にわたって記述できます。 +ソース・コードの任意のクラス、インタフェース、メソッド、コンストラクタ、またはフィールドの宣言の前に、ドキュメンテーション・コメントを記述することができます。各パッケージにもドキュメンテーション・コメントを作成できます。構文は若干異なりますが、概要にもドキュメンテーション・コメントを作成できます。ドキュメンテーション・コメントは、\fB/**\fRと、終わりを表す\fB*/\fRの間にある文字から構成されます。先頭のアスタリスクは各行で使用でき、次の項で詳しく説明します。コメントのテキストは、複数行にわたって記述できます。 .sp .if n \{\ .RS 4 .\} .nf -/** - * This is the typical format of a simple documentation comment - * that spans two lines\&. - */ +\fB/**\fR +\fB * This is the typical format of a simple documentation comment\fR +\fB * that spans two lines\&.\fR +\fB */\fR + .fi .if n \{\ .RE @@ -1099,105 +1122,125 @@ .RS 4 .\} .nf -/** This comment takes up only one line\&. */ +\fB/** This comment takes up only one line\&. */\fR + .fi .if n \{\ .RE .\} -コメントの配置.PP -ドキュメンテーション・コメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールド宣言の直前に配置される場合にのみ認識されます。メソッドの本体に置かれているドキュメンテーション・コメントは無視されます。\fIjavadoc\fRコマンドは、宣言文ごとに1つのドキュメンテーション・コメントしか認識しません。タグを使用できる場所を参照してください。 -.PP -よくある間違いは、クラス・コメントとクラス宣言の間に\fIimport\fR文を置いてしまうことです。\fIjavadoc\fRコマンドはクラス・コメントを無視するので、\fIimport\fR文をこの場所に配置しないでください。 +.PP +コメントの配置 +.PP +ドキュメンテーション・コメントは、クラス、インタフェース、コンストラクタ、メソッド、またはフィールド宣言の直前に配置される場合にのみ認識されます。メソッドの本体に置かれているドキュメンテーション・コメントは無視されます。\fBjavadoc\fRコマンドは、宣言文ごとに1つのドキュメンテーション・コメントしか認識しません。タグを使用できる場所を参照してください。 +.PP +よくある間違いは、クラス・コメントとクラス宣言の間に\fBimport\fR文を置いてしまうことです。\fBjavadoc\fRコマンドはクラス・コメントを無視するので、\fBimport\fR文をこの場所に配置しないでください。 .sp .if n \{\ .RS 4 .\} .nf -/** - * This is the class comment for the class Whatever\&. - */ +\fB/**\fR +\fB * This is the class comment for the class Whatever\&.\fR +\fB */\fR +\fB \fR +\fBimport com\&.example; // MISTAKE \- Important not to put import statement here\fR +\fB \fR +\fBpublic class Whatever{ }\fR -import com\&.example; // MISTAKE \- Important not to put import statement here - -public class Whatever{ } .fi .if n \{\ .RE .\} -コメントのパーツ.PP -ドキュメンテーション・コメントには、主説明とその後に続くタグ・セクションが含まれます。主説明は、開始区切り文字\fI/**\fRで始まり、タグ・セクションまで続きます。タグ・セクションは、先頭文字が\fI@\fRの行で定義される最初のブロック・タグから始まります(先頭のアスタリスク、空白文字、先頭の区切り文字\fI/**\fRは除く)。主説明を記述せず、タグ・セクションのみのコメントを記述することもできます。主説明は、タグ・セクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1回しか記述できないタグがあります。たとえば、次の\fI@see\fRタグからタグ・セクションは始まります。 +.PP +コメントのパーツ +.PP +ドキュメンテーション・コメントには、主説明とその後に続くタグ・セクションが含まれます。主説明は、開始区切り文字\fB/**\fRで始まり、タグ・セクションまで続きます。タグ・セクションは、先頭文字が\fB@\fRの行で定義される最初のブロック・タグから始まります(先頭のアスタリスク、空白文字、先頭の区切り文字\fB/**\fRは除く)。主説明を記述せず、タグ・セクションのみのコメントを記述することもできます。主説明は、タグ・セクション以降に続けることはできません。タグの引数は、複数行にわたって記述できます。タグの数に制限はありません。何回も記述できるタグと、1回しか記述できないタグがあります。たとえば、次の\fB@see\fRタグからタグ・セクションは始まります。 .sp .if n \{\ .RS 4 .\} .nf -/** - * This sentence holds the main description for this documentation comment\&. - * @see java\&.lang\&.Object - */ +\fB/**\fR +\fB * This sentence holds the main description for this documentation comment\&.\fR +\fB * @see java\&.lang\&.Object\fR +\fB */\fR + .fi .if n \{\ .RE .\} -ブロックおよびインライン・タグ.PP -タグは、\fIjavadoc\fRコマンドが処理するドキュメンテーション・コメント内の特殊なキーワードです。タグには2つのタイプがあります。1つは\fI@tag\fRタグのように表記されるブロック・タグ(スタンドアロン・タグとも呼ばれる)、もう1つは\fI{@tag}\fRタグのように中カッコで囲んで表記されるインライン・タグです。ブロック・タグが解釈されるには、行頭のアスタリスク、空白文字、区切り文字(\fI/**\fR)を除いて、行の先頭に置く必要があります。これは、\fI@\fR文字をテキスト内の別の場所で使用しても、タグの開始として解釈されないことを意味しています。\fI@\fR文字を使用して行を開始しても、それが解釈されないようにするには、HTMLエンティティ\fI@\fRを使用します。それぞれのブロック・タグには、関連付けられたテキストがあります。このテキストは、タグの後から、次のタグの前、またはドキュメンテーション・コメントの最後までの間に記述されたテキストです(タグまたはコメント区切り文字を除く)。この関連テキストは、複数行にわたって記述できます。インライン・タグは、テキストを記述できる場所であればどこにでも置くことができ、解釈されます。次の例にはブロック・タグ\fI@deprecated\fRとインライン・タグ\fI{@link}\fRが含まれています。javadocタグを参照してください。 +.PP +ブロックおよびインライン・タグ +.PP +タグは、\fBjavadoc\fRコマンドが処理するドキュメンテーション・コメント内の特殊なキーワードです。タグには2つのタイプがあります。1つは\fB@tag\fRタグのように表記されるブロック・タグ(スタンドアロン・タグとも呼ばれる)、もう1つは\fB{@tag}\fRタグのように中カッコで囲んで表記されるインライン・タグです。ブロック・タグが解釈されるには、行頭のアスタリスク、空白文字、区切り文字(\fB/**\fR)を除いて、行の先頭に置く必要があります。これは、\fB@\fR文字をテキスト内の別の場所で使用しても、タグの開始として解釈されないことを意味しています。\fB@\fR文字を使用して行を開始しても、それが解釈されないようにするには、HTMLエンティティ\fB@\fRを使用します。それぞれのブロック・タグには、関連付けられたテキストがあります。このテキストは、タグの後から、次のタグの前、またはドキュメンテーション・コメントの最後までの間に記述されたテキストです(タグまたはコメント区切り文字を除く)。この関連テキストは、複数行にわたって記述できます。インライン・タグは、テキストを記述できる場所であればどこにでも置くことができ、解釈されます。次の例にはブロック・タグ\fB@deprecated\fRとインライン・タグ\fB{@link}\fRが含まれています。javadocタグを参照してください。 .sp .if n \{\ .RS 4 .\} .nf -/** - * @deprecated As of JDK 1\&.1, replaced by {@link #setBounds(int,int,int,int)} - */ +\fB/**\fR +\fB * @deprecated As of JDK 1\&.1, replaced by {@link #setBounds(int,int,int,int)}\fR +\fB */\fR + .fi .if n \{\ .RE .\} -HTMLでのコメントの記述.PP +.PP +HTMLでのコメントの記述 +.PP テキストはHTMLエンティティとHTMLタグを使用してHTMLで記述される必要があります。使用するブラウザがサポートする任意のHTMLのバージョンを使用できます。標準ドックレットは、カスケーディング・スタイル・シートおよびフレームを含め、ドキュメンテーション・コメント以外の部分でHTML 3\&.2に準拠したコードを生成します。フレーム・セットのため、生成されたファイルにはHTML 4\&.0が推奨されます。 .PP -たとえば、より小さい記号(<)およびより大きい記号(>)のエンティティは、\fI<\fRおよび\fI>\fRと記述する必要があります。同様に、アンパサンド(&)は\fI&\fRと記述する必要があります。次の例では、太字のHTMLタグ\fI<b>\fRを使用しています。 +たとえば、より小さい記号(<)およびより大きい記号(>)のエンティティは、\fB<\fRおよび\fB>\fRと記述する必要があります。同様に、アンパサンド(&)は\fB&\fRと記述する必要があります。次の例では、太字のHTMLタグ\fB<b>\fRを使用しています。 .sp .if n \{\ .RS 4 .\} .nf -/** - * This is a <b>doc</b> comment\&. - * @see java\&.lang\&.Object - */ +\fB/**\fR +\fB * This is a <b>doc</b> comment\&.\fR +\fB * @see java\&.lang\&.Object\fR +\fB */\fR + .fi .if n \{\ .RE .\} -先頭のアスタリスク.PP -\fIjavadoc\fRコマンドによるドキュメンテーション・コメントの解析時に、各行の先頭にあるアスタリスク(*)文字は破棄されます。最初のアスタリスク(*)文字より前にある空白やタブも破棄されます。行頭のアスタリスクを省略した場合、インデントを保持したままでサンプル・コードを\fI<PRE>\fRタグ内のドキュメンテーション・コメントに直接貼り付けられるように、先頭の空白文字は削除されなくなります。ブラウザは、空白文字をタブよりも一律に解釈します。インデントの起点は(区切り文字\fI/**\fRまたは\fI<PRE>\fRタグではなく)左マージンになります。 -最初の文.PP -各ドキュメンテーション・コメントの最初の文は、宣言されているエンティティに関する簡潔かつ完全なサマリー文である必要があります。この文は、空白、タブ、または行終了文字が続く最初のピリオド、または最初のブロック・タグがある位置で終わります。最初の文は、\fIjavadoc\fRコマンドによってHTMLページの先頭にあるメンバーのサマリーの部分にコピーされます。 -複数フィールドの宣言.PP +.PP +先頭のアスタリスク +.PP +\fBjavadoc\fRコマンドによるドキュメンテーション・コメントの解析時に、各行の先頭にあるアスタリスク(*)文字は破棄されます。最初のアスタリスク(*)文字より前にある空白やタブも破棄されます。行頭のアスタリスクを省略した場合、インデントを保持したままでサンプル・コードを\fB<PRE>\fRタグ内のドキュメンテーション・コメントに直接貼り付けられるように、先頭の空白文字は削除されなくなります。ブラウザは、空白文字をタブよりも一律に解釈します。インデントの起点は(区切り文字\fB/**\fRまたは\fB<PRE>\fRタグではなく)左マージンになります。 +.PP +最初の文 +.PP +各ドキュメンテーション・コメントの最初の文は、宣言されているエンティティに関する簡潔かつ完全なサマリー文である必要があります。この文は、空白、タブ、または行終了文字が続く最初のピリオド、または最初のブロック・タグがある位置で終わります。最初の文は、\fBjavadoc\fRコマンドによってHTMLページの先頭にあるメンバーのサマリーの部分にコピーされます。 +.PP +複数フィールドの宣言 +.PP Javaプラットフォームでは、1つの文で複数のフィールドを宣言できます。ただし、この文には、1つのドキュメンテーション・コメントしか記述できません。そのコメントが、すべてのフィールドに対してコピーされます。フィールドごとにドキュメンテーション・コメントを記述する必要がある場合は、各フィールドを別々の文で宣言する必要があります。たとえば、次のドキュメンテーション・コメントは、1つの宣言として記述すると不適切です。この場合は、宣言を2つに分けることをお薦めします。 .sp .if n \{\ .RS 4 .\} .nf -/** - * The horizontal and vertical distances of point (x,y) - */ -public int x, y; // Avoid this - +\fB/** \fR +\fB * The horizontal and vertical distances of point (x,y)\fR +\fB */\fR +\fBpublic int x, y; // Avoid this \fR +\fB \fR .fi .if n \{\ .RE .\} .PP -\fIjavadoc\fRコマンドは、上のコードから次のようなドキュメントを生成します。 +\fBjavadoc\fRコマンドは、上のコードから次のようなドキュメントを生成します。 .sp .if n \{\ .RS 4 .\} .nf -public int x +\fBpublic int x\fR + .fi .if n \{\ .RE @@ -1209,31 +1252,38 @@ .RS 4 .\} .nf -public int y +\fBpublic int y\fR + .fi .if n \{\ .RE .\} .PP The horizontal and vertical distances of point (x, y)\&. -ヘッダー・タグの使用.PP -メンバーに対してドキュメンテーション・コメントを記述するときには、\fI<H1>\fRや\fI<H2>\fRなどのHTML見出しタグを使用しないことをお薦めします。\fIjavadoc\fRコマンドは、完全な構造化ドキュメントを作成するので、このような構造化タグが使用されていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しを使用して独自の構造を指定してかまいません。 +.PP +ヘッダー・タグの使用 +.PP +メンバーに対してドキュメンテーション・コメントを記述するときには、\fB<H1>\fRおよび\fB<H2>\fRなどのHTML見出しタグを使用しないことをお薦めします。\fBjavadoc\fRコマンドは、完全な構造化ドキュメントを作成するので、このような構造化タグが使用されていると、生成ドキュメントの形式が悪影響を受けることがあります。ただし、クラスやパッケージのコメントでは、これらの見出しを使用して独自の構造を指定してかまいません。 .SS "メソッド・コメントの継承" .PP -\fIjavadoc\fRコマンドでは、クラスおよびインタフェースでメソッド・コメントを継承して、欠落したテキストを入力したり、明示的にメソッド・コメントを継承することができます。コンストラクタ、フィールド、およびネストされたクラスは、ドキュメンテーション・コメントを継承しません。 +\fBjavadoc\fRコマンドでは、クラスおよびインタフェースでメソッド・コメントを継承して、欠落したテキストを入力したり、明示的にメソッド・コメントを継承することができます。コンストラクタ、フィールド、およびネストされたクラスは、ドキュメンテーション・コメントを継承しません。 .PP \fB注意:\fR -ドキュメンテーション・コメントをコピーに利用するには、継承したメソッドのソース・ファイルが\fI\-sourcepath\fRオプションで指定したパスのみに置かれている必要があります。コマンドラインで、クラスもパッケージも渡す必要はありません。この点はリリース1\&.3\&.\fIn\fR以前とは対照的です。これまでは、クラスがドキュメント化されるクラスであることが必要でした。 -欠落テキストの入力.PP -主説明、または\fI@return\fR、\fI@param\fR、\fI@throws\fRタグがメソッド・コメントから欠落している場合、\fIjavadoc\fRコマンドは、対応する主説明またはタグ・コメントを、それがオーバーライドまたは実装しているメソッド(ある場合)からコピーします。メソッド・コメントの継承を参照してください。 -.PP -特定のパラメータの\fI@param\fRタグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の\fI@throws\fRタグが見つからない場合、その例外が宣言されている場合にかぎり、\fI@throws\fRタグがコピーされます。 +ドキュメンテーション・コメントをコピーに利用するには、継承したメソッドのソース・ファイルが\fB\-sourcepath\fRオプションで指定したパスのみに置かれている必要があります。コマンド行で、クラスもパッケージも渡す必要はありません。この点はリリース1\&.3\&.\fIn\fR以前とは対照的です。これまでは、クラスがドキュメント化されるクラスであることが必要でした。 +.PP +欠落テキストの入力 +.PP +主説明、または\fB@return\fR、\fB@param\fR、\fB@throws\fRタグがメソッド・コメントから欠落している場合、\fBjavadoc\fRコマンドは、対応する主説明またはタグ・コメントを、それがオーバーライドまたは実装しているメソッド(ある場合)からコピーします。メソッド・コメントの継承を参照してください。 +.PP +特定のパラメータの\fB@param\fRタグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の\fB@throws\fRタグが見つからない場合、その例外が宣言されている場合にかぎり、\fB@throws\fRタグがコピーされます。 .PP この動作はリリース1\&.3以前の動作とは対照的です。これまでのバージョンでは、主説明またはタグが存在すれば、コメントは一切継承されませんでした。 .PP javadocタグおよびオプションを参照してください。 -明示的な継承.PP -\fI{@inheritDoc}\fRインライン・タグをメソッドの主説明または\fI@return\fR、\fI@param\fR、\fI@throws\fRタグ・コメントに挿入します。対応する継承された主説明またはタグ・コメントは、その場所にコピーされます。 +.PP +明示的な継承 +.PP +\fB{@inheritDoc}\fRインライン・タグをメソッドの主説明または\fB@return\fR、\fB@param\fR、\fB@throws\fRタグ・コメントに挿入します。対応する継承された主説明またはタグ・コメントは、その場所にコピーされます。 .SS "クラスおよびインタフェースの継承" .PP コメントの継承は、クラスおよびインタフェースからの継承の、考えられるすべての場合に発生します。 @@ -1271,12 +1321,12 @@ クラスのメソッドがインタフェースのメソッドを実装している場合 .RE .PP -最初の2つのケースでは、\fIjavadoc\fRコマンドは、オーバーライドしているメソッドのドキュメント内に\fI「オーバーライド」\fRという小見出しを生成します。コメントが継承されているかどうかにかかわらず、オーバーライドされているメソッドへのリンクが含まれます。 -.PP -3つ目のケース(特定のクラスのメソッドがインタフェースのメソッドを実装している場合)では、\fIjavadoc\fRコマンドは、オーバーライドしているメソッドのドキュメント内に\fI「定義」\fRという小見出しを生成します。コメントが継承されているかどうかにかかわらず、実装されているメソッドへのリンクが含まれます。 +最初の2つのケースでは、\fBjavadoc\fRコマンドは、オーバーライドしているメソッドのドキュメント内に\fI「オーバーライド」\fRという小見出しを生成します。コメントが継承されているかどうかにかかわらず、オーバーライドされているメソッドへのリンクが含まれます。 +.PP +3つ目のケース(特定のクラスのメソッドがインタフェースのメソッドを実装している場合)では、\fBjavadoc\fRコマンドは、オーバーライドしているメソッドのドキュメント内に\fI「定義」\fRという小見出しを生成します。コメントが継承されているかどうかにかかわらず、実装されているメソッドへのリンクが含まれます。 .SS "メソッド・コメントのアルゴリズム" .PP -メソッドにドキュメンテーション・コメントがない、または\fI{@inheritDoc}\fRタグがある場合、\fIjavadoc\fRコマンドは次のアルゴリズムを使用して適用できるコメントを検索します。アルゴリズムは、最も特定される適用可能なドキュメンテーション・コメントを探し、スーパークラスよりもインタフェースを優先するように設計されています。 +メソッドにドキュメンテーション・コメントがない、または\fB{@inheritDoc}\fRタグがある場合、\fBjavadoc\fRコマンドは次のアルゴリズムを使用して適用できるコメントを検索します。アルゴリズムは、最も特定される適用可能なドキュメンテーション・コメントを探し、スーパークラスよりもインタフェースを優先するように設計されています。 .sp .RS 4 .ie n \{\ @@ -1286,7 +1336,7 @@ .sp -1 .IP " 1." 4.2 .\} -直接に実装されている(または、拡張されている)インタフェースを、メソッドの宣言で\fIimplements\fR(または\fIextends\fR)という語の後に出現する順序で、1つずつ調べます。このメソッドについて最初に見つかったドキュメンテーション・コメントを採用します。 +直接に実装されている(または、拡張されている)インタフェースを、メソッドの宣言で\fBimplements\fR(または\fBextends\fR)という語の後に出現する順序で、1つずつ調べます。このメソッドについて最初に見つかったドキュメンテーション・コメントを採用します。 .RE .sp .RS 4 @@ -1308,7 +1358,7 @@ .sp -1 .IP " 3." 4.2 .\} -手順2でドキュメンテーション・コメントが見つからなかった場合で、このクラスが\fIObject\fR以外のクラスであるが、インタフェースではない場合は、次のように処理します。 +手順2でドキュメンテーション・コメントが見つからなかった場合で、このクラスが\fBObject\fR以外のクラスであるが、インタフェースではない場合は、次のように処理します。 .sp .RS 4 .ie n \{\ @@ -1334,7 +1384,7 @@ .RE .SH "JAVADOCタグ" .PP -\fIjavadoc\fRコマンドは、Javaのドキュメンテーション・コメント内に埋め込まれた特別なタグを解析します。\fIjavadoc\fRタグを使用すると、完全な整形式のAPIをソース・コードから自動的に生成できます。タグはアットマーク記号(\fI@\fR)で始まり、大文字と小文字が区別されます。これらのタグは、表示されているとおりに大文字と小文字を使用して入力する必要があります。タグは、行の先頭(先頭の空白文字と省略可能なアスタリスクの後)に置く必要があります。そうしないと、テキストとして扱われます。慣例として、同じ名前のタグは1箇所にまとめます。たとえば、\fI@see\fRタグが複数ある場合は、すべて同じ場所にまとめて配置します。詳細は、タグを使用できる場所を参照してください。 +\fBjavadoc\fRコマンドは、Javaのドキュメンテーション・コメント内に埋め込まれた特別なタグを解析します。\fBjavadoc\fRタグを使用すると、完全な整形式のAPIをソース・コードから自動的に生成できます。タグはアットマーク記号(\fB@\fR)で始まり、大文字と小文字が区別されます。これらのタグは、表示されているとおりに大文字と小文字を使用して入力する必要があります。タグは、行の先頭(先頭の空白文字と省略可能なアスタリスクの後)に置く必要があります。そうしないと、テキストとして扱われます。慣例として、同じ名前のタグは1箇所にまとめます。たとえば、\fB@see\fRタグが複数ある場合は、すべて同じ場所にまとめて配置します。詳細は、タグを使用できる場所を参照してください。 .PP タグには、次のタイプがあります。 .sp @@ -1367,7 +1417,7 @@ .RS 4 JDK 1\&.0で導入 .sp -\fI\-author\fRオプションが使用されている場合、指定した名前のテキストの作成者エントリを生成されるドキュメントに追加します。1つのドキュメンテーション・コメントに複数の\fI@author\fRタグを含めることができます。1つの\fI@author\fRタグに1つの名前を指定することも、複数の名前を指定することもできます。前者の場合は、\fIjavadoc\fRコマンドによって名前と名前の間にカンマ(,)と空白文字が挿入されます。後者の場合は、テキスト全体が解析されることなく、生成ドキュメントにコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときに、1行に複数の名前を指定できます。JavadocツールでのDocコメントの記述方法の@authorに関する項 +\fB\-author\fRオプションが使用されている場合、指定した名前のテキストの作成者エントリを生成されるドキュメントに追加します。1つのドキュメンテーション・コメントに複数の\fB@author\fRタグを含めることができます。1つの\fB@author\fRタグに1つの名前を指定することも、複数の名前を指定することもできます。前者の場合は、\fBjavadoc\fRコマンドによって名前と名前の間にカンマ(,)と空白文字が挿入されます。後者の場合は、テキスト全体が解析されることなく、生成ドキュメントにコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときに、1行に複数の名前を指定できます。JavadocツールでのDocコメントの記述方法の@authorに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#@author)を参照してください。 .RE .PP @@ -1375,18 +1425,18 @@ .RS 4 JDK 1\&.5で導入 .sp -\fI<code>{@literal}</code>\fRと同等です。 -.sp -テキストをHTMLマークアップまたはネストされたJavadocタグとして解釈せずに、textをコード・フォントで表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\fI<Object>\fR)、不等号(\fI3 < 4\fR)、矢印(\fI<\-\fR)などで、通常の山カッコ(<および>)をHTMLエンティティ(\fI<\fRおよび\fI>\fR)のかわりに使用できます。たとえば、ドキュメンテーション・コメント\fI{@code A<B>C}\fRは\fIA<B>C\fRとして変更されずに生成されたHTMLページに表示されます。つまり、\fI<B>\fRが太字として解釈されず、そのフォントはコード・フォントになります。コード・フォントなしで同じ機能を実現するには、\fI{@literal}\fRタグを使用します。 +\fB<code>{@literal}</code>\fRと同等です。 +.sp +テキストをHTMLマークアップまたはネストされたJavadocタグとして解釈せずに、textをコード・フォントで表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\fB<Object>\fR)、不等号(\fB3 < 4\fR)、矢印(\fB<\-\fR)などで、通常の山カッコ(<および>)をHTMLエンティティ(\fB<\fRおよび\fB>\fR)のかわりに使用できます。たとえば、生成されたHTMLページに表示されるドキュメンテーション・コメント・テキスト\fB{@code A<B>C}\fRは、変更されず\fBA<B>C\fRとなります。つまり、\fB<B>\fRが太字として解釈されず、そのフォントはコード・フォントになります。コード・フォントなしで同じ機能を実現するには、\fB{@literal}\fRタグを使用します。 .RE .PP @deprecated \fIdeprecated\-text\fR .RS 4 JDK 1\&.0で導入 .sp -このAPIは動作し続けますが、このAPIを使用しないことを薦めるコメントを追加します。\fIjavadoc\fRコマンドは、\fIdeprecated\-text\fRを主説明の前に移動してイタリックにし、その前に太字の警告「推奨されていません。」を追加します。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 -.sp -非推奨テキストの最初の文では、そのAPIが推奨されなくなった時期と、代替として使用するAPIをユーザーに提示する必要があります。\fIjavadoc\fRコマンドは、この最初の文を、サマリー・セクションと索引にコピーします。その後の文で非推奨になった理由を説明することもできます。代替APIを指し示す\fI{@link}\fRタグ(Javadoc 1\&.2以降の場合)を含める必要があります。 +このAPIは動作し続けますが、このAPIを使用しないことを薦めるコメントを追加します。\fBjavadoc\fRコマンドは、\fBdeprecated\-text\fRを主説明の前に移動してイタリックにし、その前に太字の警告「推奨されていません。」を追加します。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 +.sp +非推奨テキストの最初の文では、そのAPIが推奨されなくなった時期と、代替として使用するAPIをユーザーに提示する必要があります。\fBjavadoc\fRコマンドは、この最初の文を、サマリー・セクションと索引にコピーします。その後の文で非推奨になった理由を説明することもできます。代替APIを指し示す\fB{@link}\fRタグ(Javadoc 1\&.2以降の場合)を含める必要があります。 .sp \fI@deprecated annotation\fRタグを使用してプログラム要素を非推奨にします。APIを非推奨にする方法と時期 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/deprecation/deprecation\&.html)を参照してください。 @@ -1402,7 +1452,7 @@ .sp 生成されるページからの、生成ドキュメントの(生成先)ルート・ディレクトリへの相対パスを表します。このタグは、著作権のページや会社のロゴなど、生成されるすべてのページから参照するファイルを組み込むときに便利です。通常は、各ページの最下部から著作権のページにリンクします。 .sp -この\fI{@docRoot}\fRタグは、コマンドラインでもドキュメンテーション・コメント内でも使用できます。このタグは、任意のタグ(\fI@return\fR、\fI@param\fRおよび\fI@deprecated\fRタグなど)のテキスト部分を含む、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 +この\fB{@docRoot}\fRタグは、コマンド行でもドキュメンテーション・コメント内でも使用できます。このタグは、任意のタグ(\fB@return\fR、\fB@param\fRおよび\fB@deprecated\fRタグなど)のテキスト部分を含む、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。 .sp .RS 4 .ie n \{\ @@ -1412,9 +1462,9 @@ .sp -1 .IP \(bu 2.3 .\} -コマンドラインで、ヘッダー、フッターまたは最下部が次のように定義されます。\fIjavadoc \-bottom \*(Aq<a href="{@docRoot}/copyright\&.html">Copyright</a>\*(Aq\fR -.sp -\fI{@docRoot}\fRタグをmakefile内でこのように利用する場合、一部の\fImakefile\fRプログラムでは、中カッコ\fI{}\fR文字を特別にエスケープする必要があります。たとえば、Inprise MAKEバージョン5\&.2をWindows上で実行する場合は、\fI{{@docRoot}}\fRのように、中カッコを二重にする必要があります。\fI\-bottom\fRオプションなどのオプションへの引数を囲むのに、二重(一重ではなく)引用符も必要です(\fIhref\fR引数を囲む引用符は省略)。 +コマンド行で、header、footerまたはbottomが定義されている場合、\fBjavadoc \-bottom \*(Aq<a href="{@docRoot}/copyright\&.html">Copyright</a>\*(Aq\fRとなります。 +.sp +\fB{@docRoot}\fRタグをmakefile内でこのように利用する場合、一部の\fBmakefile\fRプログラムでは、中カッコ\fB{}\fR文字を特別にエスケープする必要があります。たとえば、Inprise MAKEバージョン5\&.2をWindows上で実行する場合は、\fB{{@docRoot}}\fRのように、中カッコを二重にする必要があります。\fB\-bottom\fRオプションなどのオプションへの引数を囲むのに、二重(一重ではなく)引用符も必要です(\fBhref\fR引数を囲む引用符は省略)。 .RE .sp .RS 4 @@ -1431,14 +1481,16 @@ .RS 4 .\} .nf -/** - * See the <a href="{@docRoot}/copyright\&.html">Copyright</a>\&. - */ +\fB/**\fR +\fB * See the <a href="{@docRoot}/copyright\&.html">Copyright</a>\&.\fR +\fB */\fR + .fi .if n \{\ .RE .\} -このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。式\fI<a href="{@docRoot}/copyright\&.html">\fRは、\fIjava/lang/Object\&.java\fRに対しては\fI<a href="\&.\&./\&.\&./copyright\&.html">\fRに解決され、\fIjava/lang/ref/Reference\&.java\fRに対しては\fI<a href="\&.\&./\&.\&./\&.\&./copyright\&.html">\fRに解決されます。 +このタグが必要な理由は、生成ドキュメントが、サブパッケージと同じ深さを持つ階層構造のディレクトリに格納されるからです。式: +\fB<a href="{@docRoot}/copyright\&.html">\fRは、\fBjava/lang/Object\&.java\fRの場合\fB<a href="\&.\&./\&.\&./copyright\&.html">\fRに、\fBjava/lang/ref/Reference\&.java\fRの場合\fB<a href="\&.\&./\&.\&./\&.\&./copyright\&.html">\fRに解決されます。 .RE .RE .PP @@ -1446,7 +1498,7 @@ .RS 4 JDK 1\&.0で導入 .sp -\fI@throws\fRタグと同じです。@throws class\-name descriptionを参照してください。 +\fB@throws\fRタグと同じです。@throws class\-name descriptionを参照してください。 .RE .PP {@inheritDoc} @@ -1476,7 +1528,7 @@ .sp -1 .IP \(bu 2.3 .\} -メソッドの\fI@return\fR、\fI@param\fR、\fI@throws\fRタグのテキスト引数内。この場合、タグ・テキストは、上位階層の対応するタグからコピーされます。 +メソッドの\fB@return\fR、\fB@param\fR、\fB@throws\fRタグのテキスト引数内。この場合、タグ・テキストは、上位階層の対応するタグからコピーされます。 .RE .sp 継承階層でコメントを見つける方法に関する説明は、メソッド・コメントの継承を参照してください。このタグが見つからない場合、コメントは、この項で説明するルールに応じて、自動的に継承されるかどうかが決まります。 @@ -1486,20 +1538,21 @@ .RS 4 JDK 1\&.2で導入 .sp -表示テキストlabelとともにインライン・リンクを挿入します。labelは、参照クラスの指定されたパッケージ、クラス、またはメンバーの名前のドキュメントを指し示します。このタグは、\fI@return\fR、\fI@param\fRおよび\fI@deprecated\fRタグなどの任意のタグのテキスト部分を含む、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。JavadocツールでのDocコメントの記述方法の@linkに関する項 +表示テキストlabelとともにインライン・リンクを挿入します。labelは、参照クラスの指定されたパッケージ、クラス、またはメンバーの名前のドキュメントを指し示します。このタグは、\fB@return\fR、\fB@param\fRおよび\fB@deprecated\fRタグなどの任意のタグのテキスト部分を含む、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。JavadocツールでのDocコメントの記述方法の@linkに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#{@link)を参照してください。 .sp -このタグは\fI@see\fRタグに似ています。どちらのタグも、\fIpackage\&.class#member\fRと\fIlabel\fRの参照方法と、有効な構文が同じです。主な違いは、\fI{@link}\fRタグでは、「関連項目」セクションにリンクが配置されるかわりに、インライン・リンクが生成されるという点です。インライン・テキストの他の部分と区別するために、\fI{@link}\fRタグの最初と最後に中カッコを記述します。ラベル内で右中カッコ(\fI}\fR)を使用する必要がある場合、HTMLエンティティ記法\fI}\fRを使用します。 -.sp -1つ文の中で使用できる\fI{@link}\fRタグの数に制限はありません。このタグは、ドキュメンテーション・コメントの主説明部分、または\fI@deprecated\fR、\fI@return\fR、\fI@param\fRタグなどの任意のタグのテキスト部分で使用できます。 -.sp -たとえば、次のコメントでは\fIgetComponentAt(int,int)\fRメソッドを参照しています。 +このタグは\fB@see\fRタグに似ています。どちらのタグも、\fBpackage\&.class#member\fRと\fBlabel\fRの参照方法と、有効な構文が同じです。主な違いは、\fB{@link}\fRタグでは、「関連項目」セクションにリンクが配置されるかわりに、インライン・リンクが生成されるという点です。インライン・テキストの他の部分と区別するために、\fB{@link}\fRタグの最初と最後に中カッコを記述します。ラベル内で右中カッコ(\fB}\fR)を使用する必要がある場合、HTMLエンティティ記法\fB}\fRを使用します。 +.sp +1つ文の中で使用できる\fB{@link}\fRタグの数に制限はありません。このタグは、ドキュメンテーション・コメントの主説明部分、または\fB@deprecated\fR、\fB@return\fR、\fB@param\fRタグなどの任意のタグのテキスト部分で使用できます。 +.sp +たとえば、次のコメントでは\fBgetComponentAt(int,int)\fRメソッドを参照しています。 .sp .if n \{\ .RS 4 .\} .nf -Use the {@link #getComponentAt(int, int) getComponentAt} method\&. +\fBUse the {@link #getComponentAt(int, int) getComponentAt} method\&.\fR + .fi .if n \{\ .RE @@ -1510,7 +1563,8 @@ .RS 4 .\} .nf -Use the <a href="Component\&.html#getComponentAt(int, int)">getComponentAt</a> method\&. +\fBUse the <a href="Component\&.html#getComponentAt(int, int)">getComponentAt</a> method\&.\fR + .fi .if n \{\ .RE @@ -1521,7 +1575,8 @@ .RS 4 .\} .nf -Use the getComponentAt method\&. +\fBUse the getComponentAt method\&.\fR + .fi .if n \{\ .RE @@ -1532,24 +1587,24 @@ .RS 4 JDK 1\&.4で導入 .sp -\fI{@link}\fRタグと同じ動作をしますが、リンク・ラベルがコード・フォントではなくプレーン・テキストで表示される点が異なります。ラベルがプレーン・テキストで記述されていると便利です。たとえば、「\fIRefer to {@linkplain add() the overridden method}\fR\&.」は「Refer to the overridden method」と表示されます。 +\fB{@link}\fRタグと同じ動作をしますが、リンク・ラベルがコード・フォントではなくプレーン・テキストで表示される点が異なります。ラベルがプレーン・テキストで記述されていると便利です。たとえば、「\fBRefer to {@linkplain add() the overridden method}\fR\&.」は「Refer to the overridden method」と表示されます。 .RE .PP {@literal \fItext\fR} .RS 4 JDK 1\&.5で導入 .sp -テキストをHTMLマークアップまたはネストされたJavadocタグとして解釈せずに、textを表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\fI<Object>\fR)、不等号(\fI3 < 4\fR)、矢印(<\-)などで、山カッコ(\fI<および>\fR)をHTMLエンティティ(\fI<\fRおよび\fI>\fR)のかわりに使用できます。たとえば、ドキュメンテーション・コメントのテキスト\fI{@literal A<B>C}\fRは\fIA<B>C\fRとして、ブラウザの生成されたHTMLページに変更されずに表示されます。\fI<B>\fRは太字として解釈されません(コード・フォントになりません)。コード・フォントで同じ機能を実現するには、\fI{@code}\fRタグを使用します。 +テキストをHTMLマークアップまたはネストされたJavadocタグとして解釈せずに、textを表示します。これにより、ドキュメンテーション・コメントでは、パラメータの型(\fB<Object>\fR)、不等号(\fB3 < 4\fR)、矢印(<\-)などで、山カッコ(\fB<および>\fR)をHTMLエンティティ(\fB<\fRおよび\fB>\fR)のかわりに使用できます。たとえば、ドキュメンテーション・コメント・テキスト\fB{@literal A<B>C}\fRは、変更されずにブラウザに生成されたHTMLページに\fBA<B>C\fRと表示されます。\fB<B>\fRは太字として解釈されません(コード・フォントになりません)。コード・フォントで同じ機能を実現するには、\fB{@code}\fRタグを使用します。 .RE .PP @param \fIparameter\-name description\fR .RS 4 JDK 1\&.0で導入 .sp -「パラメータ」セクションに、指定された\fIparameter\-name\fRの後に指定されたdescriptionを続けてパラメータを追加します。ドキュメンテーション・コメントを記述するときには、descriptionを複数行にわたって記述することもできます。このタグは、メソッド、コンストラクタ、またはクラスのドキュメンテーション・コメント内でのみ有効です。JavadocツールでのDocコメントの記述方法の@paramに関する項 +「パラメータ」セクションに、指定された\fBparameter\-name\fRの後に指定されたdescriptionを続けてパラメータを追加します。ドキュメンテーション・コメントを記述するときには、descriptionを複数行にわたって記述することもできます。このタグは、メソッド、コンストラクタ、またはクラスのドキュメンテーション・コメント内でのみ有効です。JavadocツールでのDocコメントの記述方法の@paramに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#@param)を参照してください。 .sp -\fIparameter\-name\fRは、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタの型パラメータの名前になります。山カッコでこのパラメータ名を囲み、型パラメータを使用することを指定します。 +\fBparameter\-name\fRは、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタの型パラメータの名前になります。山カッコでこのパラメータ名を囲み、型パラメータを使用することを指定します。 .sp クラスの型パラメータの例: .sp @@ -1557,11 +1612,12 @@ .RS 4 .\} .nf -/** - * @param <E> Type of element stored in a list - */ -public interface List<E> extends Collection<E> { -} +\fB/**\fR +\fB * @param <E> Type of element stored in a list\fR +\fB */\fR +\fBpublic interface List<E> extends Collection<E> {\fR +\fB}\fR + .fi .if n \{\ .RE @@ -1572,14 +1628,15 @@ .RS 4 .\} .nf -/** - * @param string the string to be converted - * @param type the type to convert the string to - * @param <T> the type of the element - * @param <V> the value of the element - */ -<T, V extends T> V convert(String string, Class<T> type) { -} +\fB/**\fR +\fB * @param string the string to be converted\fR +\fB * @param type the type to convert the string to\fR +\fB * @param <T> the type of the element\fR +\fB * @param <V> the value of the element\fR +\fB */\fR +\fB<T, V extends T> V convert(String string, Class<T> type) {\fR +\fB}\fR + .fi .if n \{\ .RE @@ -1598,25 +1655,25 @@ .RS 4 JDK 1\&.0で導入 .sp -\fI「関連項目」\fR見出しを追加して、referenceを指すリンク、またはテキスト・エントリを書き込みます。1つのドキュメンテーション・コメントには任意の数の\fI@see\fRタグを含めることができますが、それらはすべて同じ見出しの下にグループ化されます。\fI@see\fRタグには、3つのタイプの形式があります。この形式が最も一般的です。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドで有効です。パッケージ、クラス、またはメンバーに対するインライン・リンクを文中に挿入する方法は、\fI{@link}\fRを参照してください。 +\fI「関連項目」\fR見出しを追加して、referenceを指すリンク、またはテキスト・エントリを書き込みます。1つのドキュメンテーション・コメントには任意の数の\fB@see\fRタグを含めることができますが、それらはすべて同じ見出しの下にグループ化されます。\fB@see\fRタグには、3つのタイプの形式があります。この形式が最も一般的です。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドで有効です。パッケージ、クラス、またはメンバーに対するインライン・リンクを文中に挿入する方法は、\fB{@link}\fRを参照してください。 .sp \fB形式1\fR。@see -\fIstring\fRタグ形式は、\fIstring\fRのテキスト・エントリを追加します。リンクは生成されません。stringは、書籍またはURLではアクセスできない情報の参照先です。\fIjavadoc\fRコマンドは、最初の文字として二重引用符(")を検索して、この形式を前述の形式と区別します。たとえば、\fI@see "The Java Programming Language"\fRは次のテキストを生成します。 +\fBstring\fRタグ形式は、\fIstring\fRのテキスト・エントリを追加します。リンクは生成されません。stringは、書籍またはURLではアクセスできない情報の参照先です。\fBjavadoc\fRコマンドは、最初の文字として二重引用符(")を検索して、この形式を前述の形式と区別します。たとえば、\fB@see "The Java Programming Language"\fRは次のテキストを生成します。 .sp \fB関連項目\fR: .sp "The Java Programming Language" .sp -\fB形式2\fR。\fI@see <a href="URL#value">label</a>\fR形式は、\fIURL#value\fRにより定義されたリンクを追加します。\fIURL#value\fRパラメータは、相対URLまたは絶対URLです。\fIjavadoc\fRコマンドは、最初の文字として「より小さい」記号(\fI<\fR)を検索して、この形式を他の形式と区別します。たとえば、\fI@see <a href="spec\&.html#section">Java Spec</a>\fRは次のリンクを生成します。 +\fB形式2\fR。\fB@see <a href="URL#value">label</a>\fR形式は、\fBURL#value\fRで定義されたリンクを追加します。\fBURL#value\fRパラメータは、相対URLまたは絶対URLです。\fBjavadoc\fRコマンドは、最初の文字として「より小さい」記号(\fB<\fR)を検索して、この形式を他の形式と区別します。たとえば、\fB@see <a href="spec\&.html#section">Java Spec</a>\fRは次のリンクを生成します。 .sp \fB関連項目\fR: .sp Java Spec .sp -\fB形式3\fR。\fI@see package\&.class#member label\fR形式は、表示テキスト・ラベルとともにリンクを追加します。このラベルは参照されているJava言語の指定された名前のドキュメントを指し示します。ラベルはオプションです。ラベルを省略した場合は、表示テキストのかわりに、名前が適切に短縮されて表示されます。\fI\-noqualifier\fRオプションを使用すると、この表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストにする場合に使用します。「名前が表示される方法」を参照してください。 -.sp -Java SE 1\&.2だけは、ラベルではなく名前が\fI<code>\fR -HTMLタグ内に自動的に表示されます。Java SE 1\&.2\&.2からは、ラベルを使用するかしないかにかかわらず、\fI<code>\fRタグは常に表示テキストを囲むかたちで含まれます。 +\fB形式3\fR。\fB@see package\&.class#member label\fR形式は、表示テキスト・ラベルとともにリンクを追加します。このラベルは参照されているJava言語の指定された名前のドキュメントを指し示します。ラベルはオプションです。ラベルを省略した場合は、表示テキストのかわりに、名前が適切に短縮されて表示されます。\fB\-noqualifier\fRオプションを使用すると、この表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストにする場合に使用します。「名前が表示される方法」を参照してください。 +.sp +Java SE 1\&.2だけは、ラベルではなく名前が\fB<code>\fR +HTMLタグ内に自動的に表示されます。Java SE 1\&.2\&.2からは、ラベルを使用するかしないかにかかわらず、\fB<code>\fRタグは常に表示テキストを囲むかたちで含まれます。 .sp .RS 4 .ie n \{\ @@ -1626,10 +1683,10 @@ .sp -1 .IP \(bu 2.3 .\} -\fIpackage\&.class#member\fRには、参照されている任意の有効なプログラム要素の名前を指定します。つまり、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの名前です。ただし、メンバー名の前の文字は、シャープ記号(\fI#\fR)にする必要があります。classは、任意のトップレベルまたはネストされたクラスか、インタフェースを表します。memberは、任意のコンストラクタ、メソッドまたはフィールドを表します(ネストされたクラスまたはインタフェースではありません)。この名前が、ドキュメント化されるクラスに含まれている場合、\fIjavadoc\fRコマンドは、その名前へのリンクを作成します。外部参照クラスへのリンクを作成するには、\fI\-link\fRオプションを使用します。参照クラスに属していない名前のドキュメントを参照するには、他の2つの\fI@see\fRタグ形式のどちらかを使用します。「名前の指定」を参照してください。 +\fBpackage\&.class#member\fRには、参照されている任意の有効なプログラム要素の名前を指定します。つまり、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドの名前です。ただし、メンバー名の前の文字は、シャープ記号(\fB#\fR)にする必要があります。classは、任意のトップレベルまたはネストされたクラスか、インタフェースを表します。memberは、任意のコンストラクタ、メソッドまたはフィールドを表します(ネストされたクラスまたはインタフェースではありません)。この名前が、ドキュメント化されるクラスに含まれている場合、\fBjavadoc\fRコマンドは、その名前へのリンクを作成します。外部参照クラスへのリンクを作成するには、\fB\-link\fRオプションを使用します。参照クラスに属していない名前のドキュメントを参照するには、他の2つの\fB@see\fRタグ形式のどちらかを使用します。「名前の指定」を参照してください。 .sp \fB注意:\fR -外部参照クラスは、コマンドラインで\fIjavadoc\fRコマンドに渡されないクラスです。生成ドキュメント内で外部参照クラスにリンクしている箇所は、外部参照または外部リンクと呼ばれます。たとえば、\fIjava\&.awt package\fRに対してのみ\fIjavadoc\fRコマンドを実行した場合、\fIObject\fRなどの\fIjava\&.lang\fR内のすべてのクラスが外部参照クラスになります。\fI\-link\fRおよび\fI\-linkoffline\fRオプションを使用して、外部参照クラスへリンクします。外部参照クラスのソース・コメントは\fIjavadoc\fRコマンドの実行には使用できません。 +外部参照クラスは、コマンド行で\fBjavadoc\fRコマンドに渡されないクラスです。生成ドキュメント内で外部参照クラスにリンクしている箇所は、外部参照または外部リンクと呼ばれます。たとえば、\fBjava\&.awt package\fRに対してのみ\fBjavadoc\fRコマンドを実行した場合、\fBObject\fRなどの\fBjava\&.lang\fR内のすべてのクラスが外部参照クラスになります。\fB\-link\fRおよび\fB\-linkoffline\fRオプションを使用して、外部参照クラスへリンクします。外部参照クラスのソース・コメントは\fBjavadoc\fRコマンドの実行には使用できません。 .RE .sp .RS 4 @@ -1640,7 +1697,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIlabel\fRは、省略可能なテキストで、リンクのラベルとして表示されます。ラベルには空白を含めることができます。\fIlabel\fRを省略すると、\fIpackage\&.class\&.member\fRが、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。「名前が表示される方法」を参照してください。 +\fBlabel\fRは、省略可能なテキストで、リンクのラベルとして表示されます。ラベルには空白を含めることができます。\fBlabel\fRを省略すると、\fBpackage\&.class\&.member\fRが、現在のクラスおよびパッケージに応じて適切に短縮されて表示されます。「名前が表示される方法」を参照してください。 .RE .sp .RS 4 @@ -1651,18 +1708,19 @@ .sp -1 .IP \(bu 2.3 .\} -空白文字が、\fIpackage\&.class#member\fRと\fIlabel\fRの間の区切り文字になります。カッコの内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。 -.RE -.sp -この例では、\fI@see\fRタグ(\fICharacter\fRクラス内)が、\fIString\fRクラスのequalsメソッドを参照しています。タグには、名前\fIString#equals(Object)\fRとラベル\fIequals\fRの両方の引数が含まれています。 +空白文字が、\fBpackage\&.class#member\fRと\fBlabel\fRの間の区切り文字になります。カッコの内側の空白文字はラベルの先頭とは解釈されないため、メソッドのパラメータ間に空白文字を入れてもかまいません。 +.RE +.sp +この例では、\fB@see\fRタグ(\fBCharacter\fRクラス内)が、\fBString\fRクラスのequalsメソッドを参照しています。タグには、名前\fBString#equals(Object)\fRとラベル\fBequals\fRの両方の引数が含まれています。 .sp .if n \{\ .RS 4 .\} .nf -/** - * @see String#equals(Object) equals - */ +\fB/**\fR +\fB * @see String#equals(Object) equals\fR +\fB */\fR + .fi .if n \{\ .RE @@ -1673,10 +1731,11 @@ .RS 4 .\} .nf -<dl> -<dt><b>See Also:</b> -<dd><a href="\&.\&./\&.\&./java/lang/String#equals(java\&.lang\&.Object)"><code>equals<code></a> -</dl> +\fB<dl>\fR +\fB<dt><b>See Also:</b>\fR +\fB<dd><a href="\&.\&./\&.\&./java/lang/String#equals(java\&.lang\&.Object)"><code>equals<code></a>\fR +\fB</dl>\fR + .fi .if n \{\ .RE @@ -1687,39 +1746,42 @@ .sp equals .RE -名前の指定.PP -この\fIpackage\&.class#member\fRという名前は、\fIjava\&.lang\&.String#toUpperCase()\fRのような完全修飾名にすることも、\fIString#toUpperCase()\fRや\fI#toUpperCase()\fRのような非完全修飾名にすることもできます。名前が完全修飾より短い場合は、\fIjavadoc\fRコマンドは、標準のJavaコンパイラの検索順序を使用して探します。「@seeタグの検索順序」を参照してください。名前は、メソッド引数の間など、カッコ内のスペースを含めることができます。部分的に修飾した短い名前を指定することの利点は、入力する文字数が減ることや、ソース・コードが読みやすくなることです。次のリストに様々な形式の名前を示します。ここで、\fIClass\fRにはクラスまたはインタフェースを、Typeにはクラス、インタフェース、配列、またはプリミティブを、methodにはメソッドまたはコンストラクタを、それぞれ指定できます。 +.PP +名前の指定 +.PP +この\fBpackage\&.class#member\fRという名前は、\fBjava\&.lang\&.String#toUpperCase()\fRのような完全修飾名にすることも、\fBString#toUpperCase()\fRや\fB#toUpperCase()\fRのような非完全修飾名にすることもできます。名前が完全修飾より短い場合は、\fBjavadoc\fRコマンドは、標準のJavaコンパイラの検索順序を使用して探します。「@seeタグの検索順序」を参照してください。名前は、メソッド引数の間など、カッコ内のスペースを含めることができます。部分的に修飾した短い名前を指定することの利点は、入力する文字数が減ることや、ソース・コードが読みやすくなることです。次のリストに様々な形式の名前を示します。ここで、\fBClass\fRにはクラスまたはインタフェースを、Typeにはクラス、インタフェース、配列、またはプリミティブを、methodにはメソッドまたはコンストラクタを、それぞれ指定できます。 .sp .if n \{\ .RS 4 .\} .nf -\fBTypical forms for\fR\fB @see package\&.class#member\fR -\fBReferencing a member of the current class\fR -@see #field -@see #method(Type, Type,\&.\&.\&.) -@see #method(Type argname, Type argname,\&.\&.\&.) -@see #constructor(Type, Type,\&.\&.\&.) -@see #constructor(Type argname, Type argname,\&.\&.\&.) - -\fBReferencing another class in the current or imported packages\fR -@see Class#field -@see Class#method(Type, Type,\&.\&.\&.) -@see Class#method(Type argname, Type argname,\&.\&.\&.) -@see Class#constructor(Type, Type,\&.\&.\&.) -@see Class#constructor(Type argname, Type argname,\&.\&.\&.) -@see Class\&.NestedClass -@see Class - -\fBReferencing an element in another package (fully qualified)\fR -@see package\&.Class#field -@see package\&.Class#method(Type, Type,\&.\&.\&.) -@see package\&.Class#method(Type argname, Type argname,\&.\&.\&.) -@see package\&.Class#constructor(Type, Type,\&.\&.\&.) -@see package\&.Class#constructor(Type argname, Type argname,\&.\&.\&.) -@see package\&.Class\&.NestedClass -@see package\&.Class -@see package +\fB\fBTypical forms for\fR\fR\fB\fB @see package\&.class#member\fR\fR\fB \fR +\fB\fBReferencing a member of the current class\fR\fR +\fB@see #field\fR +\fB@see #method(Type, Type,\&.\&.\&.)\fR +\fB@see #method(Type argname, Type argname,\&.\&.\&.)\fR +\fB@see #constructor(Type, Type,\&.\&.\&.)\fR +\fB@see #constructor(Type argname, Type argname,\&.\&.\&.) \fR + +\fB\fBReferencing another class in the current or imported packages\fR\fR +\fB@see Class#field\fR +\fB@see Class#method(Type, Type,\&.\&.\&.)\fR +\fB@see Class#method(Type argname, Type argname,\&.\&.\&.)\fR +\fB@see Class#constructor(Type, Type,\&.\&.\&.)\fR +\fB@see Class#constructor(Type argname, Type argname,\&.\&.\&.)\fR +\fB@see Class\&.NestedClass\fR +\fB@see Class \fR + +\fB\fBReferencing an element in another package (fully qualified)\fR\fR +\fB@see package\&.Class#field\fR +\fB@see package\&.Class#method(Type, Type,\&.\&.\&.)\fR +\fB@see package\&.Class#method(Type argname, Type argname,\&.\&.\&.)\fR +\fB@see package\&.Class#constructor(Type, Type,\&.\&.\&.)\fR +\fB@see package\&.Class#constructor(Type argname, Type argname,\&.\&.\&.)\fR +\fB@see package\&.Class\&.NestedClass\fR +\fB@see package\&.Class\fR +\fB@see package\fR + .fi .if n \{\ .RE @@ -1735,7 +1797,18 @@ .sp -1 .IP \(bu 2.3 .\} -最初のタイプの形式(パッケージとクラスを省略)の場合、\fIjavadoc\fRコマンドは、現在のクラスの階層のみを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、またはその外側を囲んでいるクラスかインタフェースからメンバーを検索します(検索項目1\(en3)。現在のパッケージの他の部分や、他のパッケージは検索しません(検索項目4\(en5)。「@seeタグの検索順序」を参照してください。 +最初のタイプの形式(パッケージとクラスを省略)の場合、\fBjavadoc\fRコマンドは、現在のクラスの階層のみを検索します。つまり、現在のクラスかインタフェース、そのスーパークラスかスーパーインタフェース、またはその外側を囲んでいるクラスかインタフェースからメンバーを検索します(検索項目1\(en3)。現在のパッケージの他の部分や、他のパッケージは検索しません(検索項目4\(en5)。「@seeタグの検索順序」を参照してください。 +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +メソッドまたはコンストラクタの入力時に、\fBgetValue\fRのようにカッコなしの名前を使用した場合、同じ名前のフィールドが存在していなければ、\fBjavadoc\fRコマンドはそのメソッドへのリンクを作成します。このメソッドがオーバーロードされている場合、\fBjavadoc\fRコマンドは、検索で最初に見つかったメソッドにリンクします。結果は前もって特定できません。 .RE .sp .RS 4 @@ -1746,7 +1819,7 @@ .sp -1 .IP \(bu 2.3 .\} -メソッドまたはコンストラクタの入力時に、\fIgetValue\fRのようにカッコなしの名前を使用した場合、同じ名前のフィールドが存在していなければ、\fIjavadoc\fRコマンドはそのメソッドへのリンクを作成します。このメソッドがオーバーロードされている場合、\fIjavadoc\fRコマンドは、検索で最初に見つかったメソッドにリンクします。結果は前もって特定できません。 +ネストされたクラスは、すべての形式について、\fBouter\&.inner\fRとして指定する必要があります。単純に\fBinner\fRとはしないでください。 .RE .sp .RS 4 @@ -1757,23 +1830,14 @@ .sp -1 .IP \(bu 2.3 .\} -ネストされたクラスは、すべての形式について、\fIouter\&.inner\fRとして指定する必要があります。単純に\fIinner\fRとはしないでください。 -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -すでに述べたように、クラスとメンバーとの間の区切り文字としては、ドット(\fI\&.\fR)ではなくシャープ記号(\fI#\fR)を使用します。このように指定すると、\fIjavadoc\fRコマンドは、あいまいさを解決できます。ドットは、クラス、ネストされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されるからです。ただし、\fIjavadoc\fRコマンドでは、あいまいさがなければドットは正しく解析されますが、警告は表示されます。 -.RE -@seeタグの検索順序.PP -\fIjavadoc\fRコマンドは、ソース・ファイル、パッケージ・ファイル、概要ファイルに表示される\fI@see\fRタグを処理します。後者の2つのファイルでは、完全修飾の名前を\fI@see\fRタグに指定する必要があります。ソース・ファイルでは、完全修飾の名前、または部分修飾の名前を指定できます。 -.PP -次に、\fI@see\fRタグの検索順序を示します。 +すでに述べたように、クラスとメンバーとの間の区切り文字としては、ドット(\fB\&.\fR)ではなくシャープ記号(\fB#\fR)を使用します。このように指定すると、\fBjavadoc\fRコマンドは、あいまいさを解決できます。ドットは、クラス、ネストされたクラス、パッケージ、およびサブパッケージを区切るためにも使用されるからです。ただし、\fBjavadoc\fRコマンドでは、あいまいさがなければドットは正しく解析されますが、警告は表示されます。 +.RE +.PP +@seeタグの検索順序 +.PP +\fBjavadoc\fRコマンドは、ソース・ファイル、パッケージ・ファイル、概要ファイルに表示される\fB@see\fRタグを処理します。後者の2つのファイルでは、完全修飾の名前を\fB@see\fRタグに指定する必要があります。ソース・ファイルでは、完全修飾の名前、または部分修飾の名前を指定できます。 +.PP +次に、\fB@see\fRタグの検索順序を示します。 .sp .RS 4 .ie n \{\ @@ -1827,12 +1891,12 @@ .sp -1 .IP " 5." 4.2 .\} -インポートされているパッケージ、クラス、およびインタフェース(\fIimport\fR文の順序に従って検索)。 -.RE -.PP -\fIjavadoc\fRコマンドは、各クラスについて項目1\-3を再帰的に適用しながら、一致する名前が見つかるまで検索を続けます。つまり、まず現在のクラスを検索し、次にその外側を囲んでいるクラスEを検索した後、Eのスーパークラスを検索してから、Eを囲んでいるクラスを検索します。項目4と5では、\fIjavadoc\fRコマンドが1つのパッケージ内のクラスまたはインタフェースを検索する順序は決まっていません(その順序は、個々のコンパイラによって異なります)。項目5では、\fIjavadoc\fRコマンドは、\fIjava\&.lang\fRを検索します。このパッケージは、すべてのプログラムに自動的にインポートされるからです。 -.PP -\fIjavadoc\fRコマンドは、完全修飾でないソース・ファイルで\fI@see\fRタグを見つけると、Javaコンパイラと同じ順序で指定された名前を検索します(ただし、\fIjavadoc\fRコマンドは、特定の名前空間のあいまいさを検出しません。これは、ソース・コードにこれらのエラーが存在していないことを前提としているためです)。この検索順序は、Java言語仕様で正式に定義されています。\fIjavadoc\fRコマンドは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてからその名前を検索します。具体的には、次の順序で検索します。 +インポートされているパッケージ、クラス、およびインタフェース(\fBimport\fR文の順序に従って検索)。 +.RE +.PP +\fBjavadoc\fRコマンドは、各クラスについて項目1\-3を再帰的に適用しながら、一致する名前が見つかるまで検索を続けます。つまり、まず現在のクラスを検索し、次にその外側を囲んでいるクラスEを検索した後、Eのスーパークラスを検索してから、Eを囲んでいるクラスを検索します。項目4と5では、\fBjavadoc\fRコマンドが1つのパッケージ内のクラスまたはインタフェースを検索する順序は決まっていません(その順序は、個々のコンパイラによって異なります)。項目5では、\fBjavadoc\fRコマンドは、\fIjava\&.lang\fRを検索します。このパッケージは、すべてのプログラムに自動的にインポートされるからです。 +.PP +\fBjavadoc\fRコマンドは、完全修飾でないソース・ファイルで\fB@see\fRタグを見つけると、Javaコンパイラと同じ順序で指定された名前を検索します(ただし、\fBjavadoc\fRコマンドは、特定の名前空間のあいまいさを検出しません。これは、ソース・コードにこれらのエラーが存在していないことを前提としているためです)。この検索順序は、Java言語仕様で正式に定義されています。\fBjavadoc\fRコマンドは、関連するクラスとパッケージ、およびインポートされたクラスとパッケージのすべてからその名前を検索します。具体的には、次の順序で検索します。 .sp .RS 4 .ie n \{\ @@ -1886,70 +1950,75 @@ .sp -1 .IP " 5." 4.2 .\} -インポートされているパッケージ、クラス、およびインタフェース(\fIimport\fR文の順序に従って検索)。 -.RE -.PP -\fIjavadoc\fRコマンドは、必ずしもサブクラスを検索するとは限りません。また、実行中に他のパッケージのドキュメントが生成される場合でも、他のパッケージを検索しません。たとえば、\fI@see\fRタグが\fIjava\&.awt\&.event\&.KeyEvent\fRクラス内に含まれていて、\fIjava\&.awt package\fR内のある名前を参照していても、そのクラスがインポートしないかぎり\fIjavadoc\fRコマンドはそのパッケージを検索しません。 -名前が表示される方法.PP -\fIlabel\fRを省略すると、\fIpackage\&.class\&.member\fRが表示されます。一般に、これは現在のクラスおよびパッケージに応じて適切に短縮されます。短縮されるとは、\fIjavadoc\fRコマンドにより必要最小限の名前のみが表示されるということです。たとえば、\fIString\&.toUpperCase()\fRメソッドに、同じクラスのメンバーへの参照と他のクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースのみです(次のリストを参照)。パッケージ名を全体的に削除するには、\fI\-noqualifier\fRオプションを使用します。 -.RS 4 -\fB参照のタイプ\fR: \fI@see\fRタグは同じクラス、同じパッケージのメンバーを参照します -.RE -.RS 4 -\fB例\fR: \fI@see String#toLowerCase()\fR -.RE -.RS 4 -\fB表示\fR: \fItoLowerCase()\fR \- パッケージおよびクラス名を省略します -.RE -.RS 4 -.RE -.RS 4 -\fB参照のタイプ\fR: \fI@see\fRタグは別のクラス、同じパッケージのメンバーを参照します -.RE -.RS 4 -\fB例\fR: \fI@see Character#toLowerCase(char)\fR -.RE -.RS 4 -\fB表示\fR: \fICharacter\&.toLowerCase(char)\fR \- パッケージ名を省略し、クラス名を含みます -.RE -.RS 4 -.RE -.RS 4 -\fB参照のタイプ\fR: \fI@see\fRタグは異なるクラス、異なるパッケージのメンバーを参照します -.RE -.RS 4 -\fB例\fR: \fI@see java\&.io\&.File#exists()\fR -.RE -.RS 4 -\fB表示\fR: \fIjava\&.io\&.File\&.exists()\fR \- パッケージおよびクラス名を含みます -.RE -.RS 4 -.RE -@seeタグの例.PP -右側のコメントは、\fI@see\fRタグが\fIjava\&.applet\&.Applet\fRなどの別のパッケージのクラス内にある場合に、名前がどのように表示されるかを示しています。JavadocツールでのDocコメントの記述方法の@seeに関する項 +インポートされているパッケージ、クラス、およびインタフェース(\fBimport\fR文の順序に従って検索)。 +.RE +.PP +\fBjavadoc\fRコマンドは、必ずしもサブクラスを検索するとは限りません。また、実行中に他のパッケージのドキュメントが生成される場合でも、他のパッケージを検索しません。たとえば、\fB@see\fRタグが\fBjava\&.awt\&.event\&.KeyEvent\fRクラス内に含まれていて、\fBjava\&.awt package\fR内のある名前を参照していても、そのクラスがインポートしないかぎり\fBjavadoc\fRコマンドはそのパッケージを検索しません。 +.PP +名前が表示される方法 +.PP +\fBlabel\fRを省略すると、\fBpackage\&.class\&.member\fRが表示されます。一般に、これは現在のクラスおよびパッケージに応じて適切に短縮されます。短縮されるとは、\fBjavadoc\fRコマンドにより必要最小限の名前のみが表示されるということです。たとえば、\fBString\&.toUpperCase()\fRメソッドに、同じクラスのメンバーへの参照と他のクラスのメンバーへの参照が含まれている場合、クラス名が表示されるのは後者のケースのみです(次のリストを参照)。パッケージ名を全体的に削除するには、\fB\-noqualifier\fRオプションを使用します。 +.RS 4 +\fB参照のタイプ\fR: \fB@see\fRタグは同じクラス、同じパッケージのメンバーを参照します +.RE +.RS 4 +\fB例\fR: \fB@see String#toLowerCase()\fR +.RE +.RS 4 +\fB表示\fR: \fBtoLowerCase()\fR \- パッケージおよびクラス名を省略します +.RE +.RS 4 +.RE +.RS 4 +\fB参照のタイプ\fR: \fB@see\fRタグは別のクラス、同じパッケージのメンバーを参照します +.RE +.RS 4 +\fB例\fR: \fB@see Character#toLowerCase(char)\fR +.RE +.RS 4 +\fB表示\fR: \fBCharacter\&.toLowerCase(char)\fR \- パッケージ名を省略し、クラス名を含みます +.RE +.RS 4 +.RE +.RS 4 +\fB参照のタイプ\fR: \fB@see\fRタグは異なるクラス、異なるパッケージのメンバーを参照します +.RE +.RS 4 +\fB例\fR: \fB@see java\&.io\&.File#exists()\fR +.RE +.RS 4 +\fB表示\fR: \fBjava\&.io\&.File\&.exists()\fR \- パッケージおよびクラス名を含みます +.RE +.RS 4 +.RE +.PP +@seeタグの例 +.PP +右側のコメントは、\fB@see\fRタグが\fBjava\&.applet\&.Applet\fRなどの別のパッケージのクラス内にある場合に、名前がどのように表示されるかを示しています。JavadocツールでのDocコメントの記述方法の@seeに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#@see)を参照してください。 .sp .if n \{\ .RS 4 .\} .nf - See also: -@see java\&.lang\&.String // String -@see java\&.lang\&.String The String class // The String class -@see String // String -@see String#equals(Object) // String\&.equals(Object) -@see String#equals // String\&.equals(java\&.lang\&.Object) -@see java\&.lang\&.Object#wait(long) // java\&.lang\&.Object\&.wait(long) -@see Character#MAX_RADIX // Character\&.MAX_RADIX -@see <a href="spec\&.html">Java Spec</a> // Java Spec -@see "The Java Programming Language" // "The Java Programming Language" +\fB See also:\fR +\fB@see java\&.lang\&.String // String \fR +\fB@see java\&.lang\&.String The String class // The String class \fR +\fB@see String // String \fR +\fB@see String#equals(Object) // String\&.equals(Object) \fR +\fB@see String#equals // String\&.equals(java\&.lang\&.Object) \fR +\fB@see java\&.lang\&.Object#wait(long) // java\&.lang\&.Object\&.wait(long) \fR +\fB@see Character#MAX_RADIX // Character\&.MAX_RADIX \fR +\fB@see <a href="spec\&.html">Java Spec</a> // Java Spec \fR +\fB@see "The Java Programming Language" // "The Java Programming Language" \fR + .fi .if n \{\ .RE .\} .PP \fB注意:\fR -\fI@se\fR\fIe\fRタグを拡張してドキュメント化されないクラスにリンクするには、\fI\-link\fRオプションを使用します。 +\fB@se\fR\fBe\fRタグを拡張してドキュメント化されないクラスにリンクするには、\fB\-link\fRオプションを使用します。 .PP @serial \fIfield\-description\fR | include | exclude .RS 4 @@ -1961,11 +2030,11 @@ Oracleの直列化された形式の仕様にクラスを含める基準 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/serialized\-criteria\-137781\&.html)も参照してください .sp -\fIfield\-description\fR(省略可能)では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要な場合は、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式ページに追加します。相互参照ページを参照してください。 +\fBfield\-description\fR(省略可能)では、フィールドの意味を説明し、取り得る値のリストを示す必要があります。必要な場合は、複数の行に渡って説明を記述できます。標準ドックレットは、この情報を、直列化された形式ページに追加します。相互参照ページを参照してください。 .sp クラスを直列化した後に直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。 .sp -\fIinclude\fRおよび\fIexclude\fR引数は、直列化された形式ページにクラスまたはパッケージを含めるか除外するかを示します。次のように機能します。 +\fBinclude\fRおよび\fBexclude\fR引数は、直列化された形式ページにクラスまたはパッケージを含めるか除外するかを示します。次のように機能します。 .sp .RS 4 .ie n \{\ @@ -1975,7 +2044,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fISerializable\fRを実装しているpublicまたはprotectedクラスは、そのクラス(またはそのクラスが属するパッケージ)が\fI@serial exclude\fRタグでマークされていないかぎり、含められます。 +\fBSerializable\fRを実装しているpublicまたはprotectedクラスは、そのクラス(またはそのクラスが属するパッケージ)が\fB@serial exclude\fRタグでマークされていないかぎり、含められます。 .RE .sp .RS 4 @@ -1986,87 +2055,89 @@ .sp -1 .IP \(bu 2.3 .\} -\fISerializable\fRを実装しているprivateまたはpackage\-privateクラスは、そのクラス(またはそのクラスが属するパッケージ)が\fI@serial include\fRタグでマークされていないかぎり、除外されます。 -.RE -.sp -たとえば、\fIjavax\&.swing\fRパッケージはpackage\&.htmlまたはpackage\-info\&.java内で\fI@serial\fR -\fIexclude\fRタグでマークされています。publicクラス\fIjava\&.security\&.BasicPermission\fRは\fI@serial exclude\fRタグでマークされています。package\-privateクラス\fIjava\&.util\&.PropertyPermissionCollection\fRは\fI@serial include\fRタグでマークされています。 -.sp -クラス・レベルの\fI@serial\fRタグはパッケージ・レベルの\fI@serial\fRタグをオーバーライドします。 +\fBSerializable\fRを実装しているprivateまたはpackage\-privateクラスは、そのクラス(またはそのクラスが属するパッケージ)が\fB@serial include\fRタグでマークされていないかぎり、除外されます。 +.RE +.sp +たとえば、\fBjavax\&.swing\fRパッケージはpackage\&.htmlまたはpackage\-info\&.java内で\fB@serial\fR +\fBexclude\fRタグでマークされています。publicクラス\fBjava\&.security\&.BasicPermission\fRは\fB@serial exclude\fRタグでマークされています。package\-privateクラス\fBjava\&.util\&.PropertyPermissionCollection\fRは\fB@serial include\fRタグでマークされています。 +.sp +クラス・レベルの\fB@serial\fRタグはパッケージ・レベルの\fB@serial\fRタグをオーバーライドします。 .RE .PP @serialData \fIdata\-description\fR .RS 4 JDK 1\&.2で導入 .sp -データの説明値を使用して、直列化された形式でのデータの型と順序をドキュメント化します。このデータには、\fIwriteObject\fRメソッドによって書き込まれる省略可能なデータ、および\fIExternalizable\&.writeExternal\fRメソッドによって書き込まれるすべてのデータ(ベース・クラスを含む)が含まれます。 -.sp -\fI@serialData\fRタグは、\fIwriteObject\fR、\fIreadObject\fR、\fIwriteExternal\fR、\fIreadExternal\fR、\fIwriteReplace\fRおよび\fIreadResolve\fRメソッドのドキュメンテーション・コメントで使用できます。 +データの説明値を使用して、直列化された形式でのデータの型と順序をドキュメント化します。このデータには、\fBwriteObject\fRメソッドによって書き込まれる省略可能なデータ、および\fBExternalizable\&.writeExternal\fRメソッドによって書き込まれるすべてのデータ(ベース・クラスを含む)が含まれます。 +.sp +\fB@serialData\fRタグは、\fBwriteObject\fR、\fBreadObject\fR、\fBwriteExternal\fR、\fBreadExternal\fR、\fBwriteReplace\fRおよび\fBreadResolve\fRメソッドのドキュメンテーション・コメントで使用できます。 .RE .PP @serialField \fIfield\-name\fR \fIfield\-type\fR \fIfield\-description\fR .RS 4 JDK 1\&.2で導入 .sp -\fISerializable\fRクラスの\fIserialPersistentFields\fRメンバーの\fIObjectStreamField\fRコンポーネントをドキュメント化します。\fIObjectStreamField\fRコンポーネントごとに1つの\fI@serialField\fRタグを使用します。 +\fBSerializable\fRクラスの\fBserialPersistentFields\fRメンバーの\fBObjectStreamField\fRコンポーネントをドキュメント化します。\fBObjectStreamField\fRコンポーネントごとに1つの\fB@serialField\fRタグを使用します。 .RE .PP @since \fIsince\-text\fR .RS 4 JDK 1\&.1で導入 .sp -生成ドキュメントに、指定された\fIsince\-text\fRの値の\fI「導入されたバージョン」\fR見出しを追加します。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドで有効です。このタグは、特定の変更または機能が、\fIsince\-text\fRの値によって指定されたソフトウェア・リリース以降、存在していることを意味します。たとえば、\fI@since 1\&.5\fRです。 -.sp -Javaプラットフォームのソース・コードの場合、\fI@since\fRタグは、JavaプラットフォームAPI仕様のバージョンを示します。ソース・コードがリファレンス実装に追加された時期を示すとは限りません。複数の\fI@since\fRタグを使用でき、複数の\fI@author\fRタグのように扱われます。プログラム要素が複数のAPIで使用される場合、複数のタグを使用できます。 +生成ドキュメントに、指定された\fBsince\-text\fRの値の\fI「導入されたバージョン」\fR見出しを追加します。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーション・コメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、またはフィールドで有効です。このタグは、特定の変更または機能が、\fBsince\-text\fRの値によって指定されたソフトウェア・リリース以降、存在していることを意味します。たとえば、\fB@since 1\&.5\fRです。 +.sp +Javaプラットフォームのソース・コードの場合、\fB@since\fRタグは、JavaプラットフォームAPI仕様のバージョンを示します。ソース・コードがリファレンス実装に追加された時期を示すとは限りません。複数の\fB@since\fRタグを使用でき、複数の\fB@author\fRタグのように扱われます。プログラム要素が複数のAPIで使用される場合、複数のタグを使用できます。 .RE .PP @throws \fIclass\-name\fR \fIdescription\fR .RS 4 JDK 1\&.2で導入 .sp -\fI@exception\fRタグと同じ動作をします。JavadocツールでのDocコメントの記述方法の@throwsに関する項 +\fB@exception\fRタグと同じ動作をします。JavadocツールでのDocコメントの記述方法の@throwsに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#@exception)を参照してください .sp -\fI@throws\fRタグは、生成ドキュメントに\fIThrows\fR小見出しを追加して、\fIclass\-name\fRおよび\fIdescription\fRテキストを書き込みます。\fIclass\-name\fRは、そのメソッドからスローされる可能性のある例外の名前です。このタグは、メソッド、コンストラクタのドキュメンテーション・コメント内でのみ有効です。このクラスが完全指定の名前で記述されていない場合、\fIjavadoc\fRコマンドは、検索順序に従ってクラスを探します。複数の\fI@throws\fRタグを、同じ例外または違う例外の指定したドキュメンテーション・コメントで使用できます。「@seeタグの検索順序」を参照してください。 -.sp -すべてのチェック済例外がドキュメント化されるようにするために、\fI@throws\fRタグがthrows節内の例外用に存在しない場合は、\fI@throws\fRタグでドキュメント化されたかのように、\fIjavadoc\fRコマンドによって例外がHTML出力に説明なしで追加されます。 -.sp -オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、\fI@throws\fRのドキュメントがそのメソッドからサブクラスにコピーされます。インタフェース・メソッドから実装メソッドにコピーされる場合も同様です。\fI{@inheritDoc}\fRタグを使用して、\fI@throws\fRタグがドキュメンテーションを継承するように強制できます。 +\fB@throws\fRタグは、生成ドキュメントに\fIThrows\fR小見出しを追加して、\fBclass\-name\fRおよび\fBdescription\fRテキストを書き込みます。\fIclass\-name\fRは、そのメソッドからスローされる可能性のある例外の名前です。このタグは、メソッド、コンストラクタのドキュメンテーション・コメント内でのみ有効です。このクラスが完全指定の名前で記述されていない場合、\fBjavadoc\fRコマンドは、検索順序に従ってクラスを探します。複数の\fB@throws\fRタグを、同じ例外または違う例外の指定したドキュメンテーション・コメントで使用できます。「@seeタグの検索順序」を参照してください。 +.sp +すべてのチェック済例外がドキュメント化されるようにするために、\fB@throws\fRタグがthrows節内の例外用に存在しない場合は、\fB@throws\fRタグでドキュメント化されたかのように、\fBjavadoc\fRコマンドによって例外がHTML出力に説明なしで追加されます。 +.sp +オーバーライドされるメソッド内で例外が明示的に宣言されている場合のみ、\fB@throws\fRのドキュメントがそのメソッドからサブクラスにコピーされます。インタフェース・メソッドから実装メソッドにコピーされる場合も同様です。\fB{@inheritDoc}\fRタグを使用して、\fB@throws\fRタグがドキュメンテーションを継承するように強制できます。 .RE .PP {@value \fIpackage\&.class#field\fR} .RS 4 JDK 1\&.4で導入 .sp -定数の値を表示します。\fI{@value}\fRタグが静的フィールドのドキュメンテーション・コメントで引数なしで使用されている場合、その定数の値を表示します。 +定数の値を表示します。\fB{@value}\fRタグが静的フィールドのドキュメンテーション・コメントで引数なしで使用されている場合、その定数の値を表示します。 .sp .if n \{\ .RS 4 .\} .nf -/** - * The value of this constant is {@value}\&. - */ -public static final String SCRIPT_START = "<script>" +\fB/**\fR +\fB * The value of this constant is {@value}\&.\fR +\fB */\fR +\fBpublic static final String SCRIPT_START = "<script>"\fR + .fi .if n \{\ .RE .\} -任意のドキュメンテーション・コメント内で引数\fIpackage\&.class#field\fRありで使用された場合、\fI{@value}\fRタグは指定された定数の値を表示します。 +任意のドキュメンテーション・コメント内で引数\fBpackage\&.class#field\fRありで使用された場合、\fB{@value}\fRタグは指定された定数の値を表示します。 .sp .if n \{\ .RS 4 .\} .nf -/** - * Evaluates the script starting with {@value #SCRIPT_START}\&. - */ -public String evalScript(String script) {} +\fB/**\fR +\fB * Evaluates the script starting with {@value #SCRIPT_START}\&.\fR +\fB */\fR +\fBpublic String evalScript(String script) {}\fR + .fi .if n \{\ .RE .\} -引数\fIpackage\&.class#field\fRは、\fI@see\fRタグ引数と同一の形式になります。ただし、メンバーは静的フィールドである必要があります。 +引数\fBpackage\&.class#field\fRは、\fB@see\fRタグ引数と同一の形式になります。ただし、メンバーは静的フィールドである必要があります。 .sp これらの定数の値は「定数フィールド値」 (http://docs\&.oracle\&.com/javase/8/docs/api/constant\-values\&.html)にも表示されます @@ -2076,34 +2147,34 @@ .RS 4 JDK 1\&.0で導入 .sp -\fI\-version\fRオプションが使用されている場合、生成ドキュメントに\fI「バージョン」\fR小見出しを追加して、指定された\fIversion\-text\fRの値を書き込みます。このタグはこのコードが含まれるソフトウェアの現在のリリース番号を保持するためのものであるのに対し、\fI@since\fRタグは、このコードが導入されたリリース番号を保持します。\fIversion\-text\fRの値には、特別な内部構造はありません。JavadocツールでのDocコメントの記述方法の@versionに関する項 +\fB\-version\fRオプションが使用されている場合、生成ドキュメントに\fI「バージョン」\fR小見出しを追加して、指定された\fBversion\-text\fRの値を書き込みます。このタグはこのコードが含まれるソフトウェアの現在のリリース番号を保持するためのものであるのに対し、\fB@since\fRタグは、このコードが導入されたリリース番号を保持します。\fBversion\-text\fRの値には、特別な内部構造はありません。JavadocツールでのDocコメントの記述方法の@versionに関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#@version)を参照してください .sp -1つのドキュメンテーション・コメントに複数の\fI@version\fRタグを含めることができます。必要に応じて、1つの\fI@version\fRタグに1つのリリース番号を指定することも、複数のリリース番号を指定することもできます。前者の場合は、\fIjavadoc\fRコマンドによって名前と名前の間にカンマ(,)と空白文字が挿入されます。後者の場合は、テキスト全体が解析されることなく、生成ドキュメントにコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときに、1行に複数の名前を指定できます。 +1つのドキュメンテーション・コメントに複数の\fB@version\fRタグを含めることができます。必要に応じて、1つの\fB@version\fRタグに1つのリリース番号を指定することも、複数のリリース番号を指定することもできます。前者の場合は、\fBjavadoc\fRコマンドによって名前と名前の間にカンマ(,)と空白文字が挿入されます。後者の場合は、テキスト全体が解析されることなく、生成ドキュメントにコピーされます。したがって、カンマではなく、各言語に対応した名前区切り文字を使用する必要があるときに、1行に複数の名前を指定できます。 .RE .SH "タグを使用できる場所" .PP -ここでは、タグを使用できる場所について説明します。次のタグがすべてのドキュメンテーション・コメントで使用できます。\fI@see\fR、\fI@since\fR、\fI@deprecated\fR、\fI{@link}\fR、\fI{@linkplain}\fRおよび\fI{@docroot}\fR。 +ここでは、タグを使用できる場所について説明します。次のタグがすべてのドキュメンテーション・コメントで使用できます。\fB@see\fR、\fB@since\fR、\fB@deprecated\fR、\fB{@link}\fR、\fB{@linkplain}\fRおよび\fB{@docroot}\fR。 .SS "概要タグ" .PP 概要タグは、概要ページのドキュメンテーション・コメントで使用できるタグです(このドキュメンテーション・コメントは、通常overview\&.htmlという名前のソース・ファイル内にあります)。他のドキュメンテーション・コメントの場合と同様に、これらのタグは、主説明の後で使用する必要があります。 .PP \fB注意:\fR -Java SE 1\&.2では、概要ドキュメント内の\fI{@link}\fRタグに不具合があります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、\fI{@docRoot}\fRタグは、概要ドキュメント内では機能しません。 +Java SE 1\&.2では、概要ドキュメント内の\fB{@link}\fRタグにbugがあります。テキストは正しく表示されますが、リンクが設定されません。現在のところ、\fB{@docRoot}\fRタグは、概要ドキュメント内では機能しません。 .PP 概要タグは、次のとおりです。 .PP @see reference || @since since\-text || @serialField field\-name field\-type field\-description || @author name\-text || @version version\-text || {@link package\&.class#member label} || {@linkplain package\&.class#member label} || {@docRoot} || .SS "パッケージ・タグ" .PP -パッケージ・タグは、パッケージのドキュメンテーション・コメントで使用できるタグで、ドキュメンテーション・コメントはpackage\&.htmlまたはpackage\-info\&.javaという名前のソース・ファイル内にあります。ここで使用できる\fI@serial\fRタグは、\fIinclude\fRまたは\fIexclude\fR引数を指定したもののみです。 +パッケージ・タグは、パッケージのドキュメンテーション・コメントで使用できるタグで、ドキュメンテーション・コメントはpackage\&.htmlまたはpackage\-info\&.javaという名前のソース・ファイル内にあります。ここで使用できる\fB@serial\fRタグは、\fBinclude\fRまたは\fBexclude\fR引数を指定したもののみです。 .PP パッケージ・タグは、次のとおりです。 .PP @see reference || @since since\-text || @serial field\-description | include | exclude || @author name\-text || @version version\-text || {@linkplain package\&.class#member label} || {@linkplain package\&.class#member label} || {@docRoot} || .SS "クラスおよびインタフェース・タグ" .PP -次に、クラスまたはインタフェースのドキュメンテーション・コメントで使用できるタグを示します。\fI@serial\fRタグは、\fIinclude\fRまたは\fIexclude\fR引数を指定して、クラスまたはインタフェースのドキュメンテーション内でのみ使用できます。 +次に、クラスまたはインタフェースのドキュメンテーション・コメントで使用できるタグを示します。\fB@serial\fRタグは、\fBinclude\fRまたは\fBexclude\fR引数を指定して、クラスまたはインタフェースのドキュメンテーション内でのみ使用できます。 .PP @see reference || @since since\-text || @deprecated deprecated\-text || @serial field\-description | include | exclude || @author name\-text || @version version\-text || {@link package\&.class#member label} || {@linkplain package\&.class#member label} || {@docRoot} || .PP @@ -2113,22 +2184,23 @@ .RS 4 .\} .nf -/** - * A class representing a window on the screen\&. - * For example: - * <pre> - * Window win = new Window(parent); - * win\&.show(); - * </pre> - * - * @author Sami Shaio - * @version 1\&.13, 06/08/06 - * @see java\&.awt\&.BaseWindow - * @see java\&.awt\&.Button - */ -class Window extends BaseWindow { - \&.\&.\&. -} +\fB/**\fR +\fB * A class representing a window on the screen\&.\fR +\fB * For example:\fR +\fB * <pre>\fR +\fB * Window win = new Window(parent);\fR +\fB * win\&.show();\fR +\fB * </pre>\fR +\fB *\fR +\fB * @author Sami Shaio\fR +\fB * @version 1\&.13, 06/08/06\fR +\fB * @see java\&.awt\&.BaseWindow\fR +\fB * @see java\&.awt\&.Button\fR +\fB */\fR +\fBclass Window extends BaseWindow {\fR +\fB \&.\&.\&.\fR +\fB}\fR + .fi .if n \{\ .RE @@ -2145,25 +2217,26 @@ .RS 4 .\} .nf - /** - * The X\-coordinate of the component\&. - * - * @see #getLocation() - */ - int x = 1263732; +\fB /**\fR +\fB * The X\-coordinate of the component\&.\fR +\fB *\fR +\fB * @see #getLocation()\fR +\fB */\fR +\fB int x = 1263732;\fR + .fi .if n \{\ .RE .\} .SS "コンストラクタとメソッド・タグ" .PP -次に、コンストラクタまたはメソッドのドキュメンテーション・コメントで使用できるタグを示します。ただし、\fI@return\fRはコンストラクタでは使用できず、 -\fI{@inheritDoc}\fRには制限があります。 +次に、コンストラクタまたはメソッドのドキュメンテーション・コメントで使用できるタグを示します。ただし、\fB@return\fRはコンストラクタでは使用できず、 +\fB{@inheritDoc}\fRには制限があります。 .PP @see reference || @since since\-text || @deprecated deprecated\-text || @param parameter\-name description || @return description || @throws class\-name description || @exception class\-name description || @serialData data\-description || {@link package\&.class#member label} || {@linkplain package\&.class#member label} || {@inheritDoc} || {@docRoot} .PP \fB注意:\fR -\fI@serialData\fRタグは、\fIwriteObject\fR、\fIreadObject\fR、\fIwriteExternal\fR、\fIreadExternal\fR、\fIwriteReplace\fRおよび\fIreadResolve\fRメソッドのドキュメンテーション・コメントでのみ使用できます。 +\fB@serialData\fRタグは、\fBwriteObject\fR、\fBreadObject\fR、\fBwriteExternal\fR、\fBreadExternal\fR、\fBwriteReplace\fRおよび\fBreadResolve\fRメソッドのドキュメンテーション・コメントでのみ使用できます。 .PP メソッド・コメントの例: .sp @@ -2171,27 +2244,28 @@ .RS 4 .\} .nf -/** - * Returns the character at the specified index\&. An index - * ranges from <code>0</code> to <code>length() \- 1</code> - * - * @param index the index of the desired character\&. - * @return the desired character\&. - * @exception StringIndexOutOfRangeException - * if the index is not in the range <code>0</code> - * to <code>length()\-1</code> - * @see java\&.lang\&.Character#charValue() - */ - public char charAt(int index) { - \&.\&.\&. - } +\fB/**\fR +\fB * Returns the character at the specified index\&. An index \fR +\fB * ranges from <code>0</code> to <code>length() \- 1</code>\fR +\fB *\fR +\fB * @param index the index of the desired character\&.\fR +\fB * @return the desired character\&.\fR +\fB * @exception StringIndexOutOfRangeException \fR +\fB * if the index is not in the range <code>0</code> \fR +\fB * to <code>length()\-1</code>\fR +\fB * @see java\&.lang\&.Character#charValue()\fR +\fB */\fR +\fB public char charAt(int index) {\fR +\fB \&.\&.\&.\fR +\fB }\fR + .fi .if n \{\ .RE .\} .SH "オプション" .PP -\fIjavadoc\fRコマンドは、ドックレットを使用して出力を決定します。\fIjavadoc\fRコマンドは、\fI\-doclet\fRオプションでカスタム・ドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使用します。\fIjavadoc\fRコマンドには、任意のドックレットとともに使用できるコマンドライン・オプションがあります。これらのオプションについては、Javadocオプションで説明します。標準ドックレットでは、この他に、いくつかの追加のコマンドライン・オプションが提供されます。これらのオプションについては、標準ドックレットのオプションで説明します。どのオプション名も、大文字と小文字が区別されません。ただし、オプションの引数では、大文字と小文字が区別されます。 +\fBjavadoc\fRコマンドは、ドックレットを使用して出力を決定します。\fBjavadoc\fRコマンドは、\fB\-doclet\fRオプションでカスタム・ドックレットが指定されている場合以外は、デフォルトの標準ドックレットを使用します。\fBjavadoc\fRコマンドには、任意のドックレットとともに使用できるコマンド行オプションがあります。これらのオプションについては、Javadocオプションで説明します。標準ドックレットでは、この他に、いくつかの追加のコマンド行オプションが提供されます。これらのオプションについては、標準ドックレットのオプションで説明します。どのオプション名も、大文字と小文字が区別されません。ただし、オプションの引数では、大文字と小文字が区別されます。 .sp .RS 4 .ie n \{\ @@ -2218,39 +2292,44 @@ オプションは次のとおりです。 .PP \-1\&.1 || \-author || \-bootclasspath classpathlist || \-bottom text || \-breakiterator || \-charset name || \-classpath classpathlist || \-d directory || \-docencoding name || \-docfilesubdirs || \-doclet class || \-docletpath classpathlist || \-doctitle title || \-encoding || \-exclude packagename1:packagename2:\&.\&.\&. || \-excludedocfilessubdir name1:name2 || \-extdirs dirist || \-footer footer || \-group groupheading packagepattern:packagepattern || \-header header || \-help || \-helpfile path\efilename || \-Jflag || \-keywords || \-link extdocURL || \-linkoffline extdocURL packagelistLoc || \-linksource || \-locale language_country_variant || \-nocomment || \-nodeprecated || \-nodeprecatedlist || \-nohelp || \-noindex || \-nonavbar || \-noqualifier all | packagename1:packagename2\&.\&.\&. || \-nosince || \-notimestamp || \-notree || -\fI\-overview path/filename || \fR\-package || \-private || \-protected || \-public || \-quiet || \-serialwarn || \-source release || \-sourcepath sourcepathlist || \-sourcetab tablength || \-splitindex || -\fI\-stylesheet path/filename || \fR\-subpackages package1:package2:\&.\&.\&. || \-tag tagname:Xaoptcmf:"taghead" || \-taglet class || \-tagletpath tagletpathlist || \-title title || \-top || \-use || \-verbose || \-version || \-windowtitle title -.PP -次のオプションは、すべてのドックレットに使用可能なコアのJavadocオプションです。標準ドックレットでは、ドックレットの他の部分を提供します。\fI\-bootclasspath\fR、\fI\-breakiterator\fR、\fI\-classpath\fR、\fI\-doclet\fR、\fI\-docletpath\fR、\fI\-encoding\fR、\-\fIexclude\fR、\fI\-extdirs\fR、\fI\-help\fR、\fI\-locale\fR、\fI\-\fR\fIoverview\fR、\fI\-package\fR、\fI\-private\fR、\fI\-protected\fR、\fI\-public\fR、\fI\-quiet\fR、\fI\-source\fR、\fI\-sourcepath\fR、\fI\-subpackages\fRおよび\fI\-verbose\fR。 + +\-overview path/filename || +\-package || \-private || \-protected || \-public || \-quiet || \-serialwarn || \-source release || \-sourcepath sourcepathlist || \-sourcetab tablength || \-splitindex || + +\-stylesheet path/filename || + +||\-subpackages package1:package2:\&.\&.\&. || \-tag tagname:Xaoptcmf:"taghead" || \-taglet class || \-tagletpath tagletpathlist || \-title title || \-top || \-use || \-verbose || \-version || \-windowtitle title +.PP +次のオプションは、すべてのドックレットに使用可能なコアのJavadocオプションです。標準ドックレットでは、ドックレットの他の部分を提供します。\fB\-bootclasspath\fR、\fB\-breakiterator\fR、\fB\-classpath\fR、\fB\-doclet\fR、\fB\-docletpath\fR、\fB\-encoding\fR、\-\fBexclude\fR、\fB\-extdirs\fR、\fB\-help\fR、\fB\-locale\fR、\fB\-\fR\fBoverview\fR、\fB\-package\fR、\fB\-private\fR、\fB\-protected\fR、\fB\-public\fR、\fB\-quiet\fR、\fB\-source\fR、\fB\-sourcepath\fR、\fB\-subpackages\fRおよび\fB\-verbose\fR。 .SS "Javadocオプション" .PP \-overview \fIpath/filename \fR .RS 4 -\fIjavadoc\fRコマンドに対して、\fIpath/filename \fRで指定されたソース・ファイルから概要ドキュメント用のテキストを取得し、そのテキストを概要ページ(overview\-summary\&.html)に配置するように指定します。\fIpath/filename\fRは、現在のディレクトリからの相対パスです。 -.sp -\fIfilename\fRの値で任意の名前を使用し、pathで任意の配置先を指定できますが、通常はoverview\&.htmlという名前を付け、ソース・ツリー内の最上位パッケージ・ディレクトリを含むディレクトリに配置します。この場所に配置すると、パッケージをドキュメント化するときにpathを指定する必要がなくなります。これは、\fI\-sourcepath\fRオプションによってこのファイルが指し示されるからです。 -.sp -たとえば、\fIjava\&.lang\fRパッケージのソース・ツリーが/src/classes/java/lang/の場合、概要ファイルを/src/classes/overview\&.htmlに配置できます +\fBjavadoc\fRコマンドに対して、\fIpath/filename \fRで指定されたソース・ファイルから概要ドキュメント用のテキストを取得し、そのテキストを概要ページ(overview\-summary\&.html)に配置するように指定します。\fIpath/filename\fRは、現在のディレクトリからの相対パスです。 +.sp +\fBfilename\fRの値で任意の名前を使用し、pathで任意の配置先を指定できますが、通常はoverview\&.htmlという名前を付け、ソース・ツリー内の最上位パッケージ・ディレクトリを含むディレクトリに配置します。この場所に配置すると、パッケージをドキュメント化するときにpathを指定する必要がなくなります。これは、\fB\-sourcepath\fRオプションによってこのファイルが指し示されるからです。 +.sp +たとえば、\fBjava\&.lang\fRパッケージのソース・ツリーが/src/classes/java/lang/の場合、概要ファイルを/src/classes/overview\&.htmlに配置できます .sp 実際の例を参照してください。 .sp \fIpath/filename\fRで指定するファイルについては、概要コメント・ファイルを参照してください。 .sp -概要ページが作成されるのは、\fIjavadoc\fRコマンドに複数のパッケージ名を渡した場合のみです。詳細は、HTMLフレームを参照してください。概要ページのタイトルは、\fI\-doctitle\fRによって設定されます。 +概要ページが作成されるのは、\fBjavadoc\fRコマンドに複数のパッケージ名を渡した場合のみです。詳細は、HTMLフレームを参照してください。概要ページのタイトルは、\fB\-doctitle\fRによって設定されます。 .RE .PP \-Xdoclint:(all|none|[\-]\fI<group>\fR) .RS 4 不正な参照、アクセシビリティの欠落およびJavadocコメントの不足の警告をレポートし、無効なJavadoc構文および不足しているHTMLタグのエラーをレポートします。 .sp -このオプションにより、\fIjavadoc\fRコマンドは生成された出力に含まれるすべてのドキュメント・コメントをチェックします。通常どおり、標準オプション\fI\-public\fR、\fI\-protected\fR、\fI\-package\fRおよび\fI\-private\fRで生成された出力に含む項目を選択できます。 -.sp -\fI\-Xdoclint\fRが有効になっている場合は、\fIjavac\fRコマンドと同様にメッセージで問題がレポートされます。\fIjavadoc\fRコマンドは、メッセージ、ソース・ファイルのコピーおよびエラーが検出された正確な位置を指すキャレットを出力します。メッセージは、重大度、および生成されたドキュメントがバリデータを使用して実行された場合にエラーが発生する可能性に応じて、警告またはエラーになります。たとえば、不正な参照またはJavadocコメントの欠落は、\fIjavadoc\fRコマンドが無効なHTMLを生成する原因にならないため、これらの問題は警告としてレポートされます。構文エラーまたはHTML終了タグの欠落は、\fIjavadoc\fRコマンドが無効なHTMLを生成する原因になるため、これらの問題はエラーとしてレポートされます。 -.sp -デフォルトでは、\fI\-Xdoclint\fRオプションは有効になっています。オプション\fI\-Xdoclint:none\fRで無効にします。 -.sp -\fI\-Xdoclint\fRオプションでレポートされる内容は次のオプションで変更します。 +このオプションにより、\fBjavadoc\fRコマンドは生成された出力に含まれるすべてのドキュメント・コメントをチェックします。通常どおり、標準オプション\fB\-public\fR、\fB\-protected\fR、\fB\-package\fRおよび\fB\-private\fRで生成された出力に含む項目を選択できます。 +.sp +\fB\-Xdoclint\fRが有効になっている場合は、\fBjavac\fRコマンドと同様にメッセージで問題がレポートされます。\fBjavadoc\fRコマンドは、メッセージ、ソース・ファイルのコピーおよびエラーが検出された正確な位置を指すキャレットを出力します。メッセージは、重大度、および生成されたドキュメントがバリデータを使用して実行された場合にエラーが発生する可能性に応じて、警告またはエラーになります。たとえば、不正な参照またはJavadocコメントの欠落は、\fBjavadoc\fRコマンドが無効なHTMLを生成する原因にならないため、これらの問題は警告としてレポートされます。構文エラーまたはHTML終了タグの欠落は、\fBjavadoc\fRコマンドが無効なHTMLを生成する原因になるため、これらの問題はエラーとしてレポートされます。 +.sp +デフォルトでは、\fB\-Xdoclint\fRオプションは有効になっています。オプション\fB\-Xdoclint:none\fRで無効にします。 +.sp +\fB\-Xdoclint\fRオプションでレポートされる内容は次のオプションで変更します。 .sp .RS 4 .ie n \{\ @@ -2260,8 +2339,8 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-Xdoclint\fR\fI\fR\fI none\fR: -\fI\-Xdoclint\fRオプションを無効にします。 +\fB\-Xdoclint none\fR: +\fB\-Xdoclint\fRオプションを無効にします。 .RE .sp .RS 4 @@ -2272,7 +2351,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-Xdoclint\fR\fI\fR\fI \fR\fIgroup\fR: +\fB\-Xdoclint \fR\fIgroup\fR: \fIgroup\fRチェックを有効にします。 .RE .sp @@ -2284,7 +2363,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-Xdoclint\fR\fI\fR\fI all\fR: すべてのチェック・グループを有効にします。 +\fB\-Xdoclint all\fR: すべてのチェック・グループを有効にします。 .RE .sp .RS 4 @@ -2295,7 +2374,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-Xdoclint\fR\fI\fR\fI all,\fR\fI\-group\fR: +\fB\-Xdoclint all,\fR\fI\-group\fR: \fIgroup\fRチェック以外のすべてを有効にします。 .RE .sp @@ -2309,7 +2388,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIaccessibility\fR: アクセシビリティ・チェッカで検出する問題をチェックします(たとえば、\fI<table>\fRタグで指定されるno captionまたはsummary属性)。 +\fBaccessibility\fR: アクセシビリティ・チェッカで検出する問題をチェックします(たとえば、\fB<table>\fRタグで指定されるno captionまたはsummary属性)。 .RE .sp .RS 4 @@ -2320,7 +2399,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIhtml\fR: インライン要素へのブロック要素の挿入や終了タグを必要とする要素を終了しないなど、上位レベルHTMLの問題を検出します。ルールは、HTML 4\&.01仕様から導出されます。このタイプのチェックは、\fIjavadoc\fRコマンドを有効にして、ブラウザが受け入れる可能性のあるHTMLの問題を検出します。 +\fBhtml\fR: インライン要素へのブロック要素の挿入や終了タグを必要とする要素を終了しないなど、上位レベルHTMLの問題を検出します。ルールは、HTML 4\&.01仕様から導出されます。このタイプのチェックは、\fBjavadoc\fRコマンドを有効にして、ブラウザが受け入れる可能性のあるHTMLの問題を検出します。 .RE .sp .RS 4 @@ -2331,7 +2410,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fImissing\fR: 欠落しているJavadocコメントまたはタグをチェックします(たとえば、欠落しているコメントやクラス、または欠落している\fI@return\fRタグやメソッド上の同様のタグ)。 +\fBmissing\fR: 欠落しているJavadocコメントまたはタグをチェックします(たとえば、欠落しているコメントやクラス、または欠落している\fB@return\fRタグやメソッド上の同様のタグ)。 .RE .sp .RS 4 @@ -2342,7 +2421,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIreference\fR: JavadocタグのJava API要素の参照に関連する問題をチェックします(たとえば、\fI@see\fRで見つからない項目、または\fI@param\fRの後の不正な名前)。 +\fBreference\fR: JavadocタグのJava API要素の参照に関連する問題をチェックします(たとえば、\fB@see\fRで見つからない項目、または\fB@param\fRの後の不正な名前)。 .RE .sp .RS 4 @@ -2353,25 +2432,26 @@ .sp -1 .IP \(bu 2.3 .\} -\fIsyntax\fR: エスケープされていない山カッコ(\fI<\fRおよび\fI>\fR)やアンパサンド(\fI&\fR)、無効なJavadocタグなどの下位レベルの問題を確認します。 -.RE -.sp -\fI\-Xdoclint\fRオプションを複数回指定して、複数のカテゴリのエラーと警告をチェックするオプションを有効にできます。または、前のオプションを使用して、複数のエラーおよび警告カテゴリを指定できます。たとえば、次のコマンドのいずれかを使用して、\fIfilename\fRファイル内のHTML、構文およびアクセシビリティの問題をチェックします。 +\fBsyntax\fR: エスケープされていない山カッコ(\fB<\fRおよび\fB>\fR)やアンパサンド(\fB&\fR)、無効なJavadocタグなどの下位レベルの問題を確認します。 +.RE +.sp +\fB\-Xdoclint\fRオプションを複数回指定して、複数のカテゴリのエラーと警告をチェックするオプションを有効にできます。または、前のオプションを使用して、複数のエラーおよび警告カテゴリを指定できます。たとえば、次のコマンドのいずれかを使用して、\fIfilename\fRファイル内のHTML、構文およびアクセシビリティの問題をチェックします。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-Xdoclint:html \-Xdoclint:syntax \-Xdoclint:accessibility \fIfilename\fR -javadoc \-Xdoclint:html,syntax,accessibility \fIfilename\fR +\fBjavadoc \-Xdoclint:html \-Xdoclint:syntax \-Xdoclint:accessibility \fR\fB\fIfilename\fR\fR +\fBjavadoc \-Xdoclint:html,syntax,accessibility \fR\fB\fIfilename\fR\fR + .fi .if n \{\ .RE .\} \fB注意:\fR -\fIjavadoc\fRコマンドでは、これらのチェックの完全性は保証されません。具体的には、完全なHTMLコンプライアンス・チェッカではありません。\-\fIXdoclint\fRオプションの目的は、\fIjavadoc\fRコマンドを有効にして一般的なエラーの大半をレポートすることです。 -.sp -\fIjavadoc\fRコマンドは、無効な入力の修正を試行せず、レポートのみ行います。 +\fBjavadoc\fRコマンドでは、これらのチェックの完全性は保証されません。具体的には、完全なHTMLコンプライアンス・チェッカではありません。\-\fBXdoclint\fRオプションの目的は、\fBjavadoc\fRコマンドを有効にして一般的なエラーの大半をレポートすることです。 +.sp +\fBjavadoc\fRコマンドは、無効な入力の修正を試行せず、レポートのみ行います。 .RE .PP \-public @@ -2396,18 +2476,18 @@ .PP \-help .RS 4 -オンライン・ヘルプを表示します。\fIjavadoc\fRと\fIドックレット\fRのコマンドライン・オプションがリストされます。 +オンライン・ヘルプを表示します。\fBjavadoc\fRと\fBドックレット\fRのコマンド行オプションがリストされます。 .RE .PP \-doclet \fIclass\fR .RS 4 -ドキュメントの生成に使用するドックレットを起動するためのクラス・ファイルを指定します。完全修飾名を使用します。このドックレットにより、出力の内容と形式が定義されます。\fI\-doclet\fRオプションが使用されていない場合、\fIjavadoc\fRコマンドは、標準ドックレットを使用してデフォルトのHTML形式を生成します。このクラスには\fIstart(Root)\fRメソッドが含まれている必要があります。この起動クラスへのパスは\fI\-docletpath\fRオプションによって定義されます。ドックレットの概要 +ドキュメントの生成に使用するドックレットを起動するためのクラス・ファイルを指定します。完全修飾名を使用します。このドックレットにより、出力の内容と形式が定義されます。\fB\-doclet\fRオプションが使用されていない場合、\fBjavadoc\fRコマンドは、標準ドックレットを使用してデフォルトのHTML形式を生成します。このクラスには\fBstart(Root)\fRメソッドが含まれている必要があります。この起動クラスへのパスは\fB\-docletpath\fRオプションによって定義されます。ドックレットの概要 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/doclet/overview\&.html)を参照してください .RE .PP \-docletpath \fIclasspathlist\fR .RS 4 -\fI\-doclet\fRオプションで指定されたドックレット開始クラス・ファイル、およびそのクラスが依存するすべてのJARファイルへのパスを指定します。開始クラス・ファイルがJARファイル内にある場合、このオプションでJARファイルへのパスを指定します。絶対パスまたは現在のディレクトリからの相対パスを指定できます。\fIclasspathlist\fRに複数のパスやJARファイルが含まれる場合には、それらをSolarisの場合はコロン(:)で、Windowsの場合はセミコロン(;)でそれぞれ区切ります。目的のドックレット開始クラスがすでに検索パス内にある場合は、このオプションは不要です。ドックレットの概要 +\fB\-doclet\fRオプションで指定されたドックレット開始クラス・ファイル、およびそのクラスが依存するすべてのJARファイルへのパスを指定します。開始クラス・ファイルがJARファイル内にある場合、このオプションでJARファイルへのパスを指定します。絶対パスまたは現在のディレクトリからの相対パスを指定できます。\fBclasspathlist\fRに複数のパスやJARファイルが含まれる場合には、それらをSolarisの場合はコロン(:)で、Windowsの場合はセミコロン(;)でそれぞれ区切ります。目的のドックレット開始クラスがすでに検索パス内にある場合は、このオプションは不要です。ドックレットの概要 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/doclet/overview\&.html)を参照してください .RE .PP @@ -2418,7 +2498,7 @@ .PP \-source \fIrelease\fR .RS 4 -受け付けるソース・コードのリリースを指定します。\fIrelease\fRパラメータには次の値を指定できます。\fIjavac\fRコマンドでコードをコンパイルするときに使用する値に対応する\fIリリース\fRの値を使用します。 +受け付けるソース・コードのリリースを指定します。\fBrelease\fRパラメータには次の値を指定できます。\fBjavac\fRコマンドでコードをコンパイルするときに使用する値に対応する\fBリリース\fRの値を使用します。 .sp .RS 4 .ie n \{\ @@ -2428,7 +2508,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fBリリース値: 1\&.5\fR。\fIjavadoc\fRコマンドは、JDK 1\&.5で導入された総称および他の言語機能を含むコードを受け付けます。\fI\-source\fRオプションが使用されなかった場合のコンパイラのデフォルト動作は、1\&.5のものになります。 +\fBリリース値: 1\&.5\fR。\fBjavadoc\fRコマンドは、JDK 1\&.5で導入された総称および他の言語機能を含むコードを受け付けます。\fB\-source\fRオプションが使用されなかった場合のコンパイラのデフォルト動作は、1\&.5のものになります。 .RE .sp .RS 4 @@ -2439,7 +2519,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fBリリース値: 1\&.4\fR。\fIjavadoc\fRコマンドは、JDK 1\&.4で導入されたアサーションを含むコードを受け付けます。 +\fBリリース値: 1\&.4\fR。\fBjavadoc\fRコマンドは、JDK 1\&.4で導入されたアサーションを含むコードを受け付けます。 .RE .sp .RS 4 @@ -2450,26 +2530,29 @@ .sp -1 .IP \(bu 2.3 .\} -\fBリリース値: 1\&.3\fR。\fIjavadoc\fRコマンドは、JDK 1\&.3以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 +\fBリリース値: 1\&.3\fR。\fBjavadoc\fRコマンドは、JDK 1\&.3以降に導入されたアサーション、総称、または他の言語機能をサポートしません。 .RE .RE .PP \-sourcepath \fIsourcepathlist\fR .RS 4 -パッケージ名または\fI\-subpackages\fRオプションを\fIjavadoc\fRコマンドに渡すときに、ソース・ファイルを見つけるための検索パスを指定します。 -\fI複数のパスはコロン(:)で区切ります。\fR\fIjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。このオプションを使用して、ドキュメント化されるソース・ファイルの位置のみでなく、それ自体はドキュメント化されないがドキュメント化されるソース・ファイルから継承されたコメントを持つソース・ファイルの位置も確認できます。 -.sp -\fI\-sourcepath\fRオプションを使用できるのは、\fIjavadoc\fRコマンドにパッケージ名を渡す場合のみです。\fIjavadoc\fRコマンドに渡されるソース・ファイルは検索されません。ソース・ファイルを特定するには、そのディレクトリに移動するか、「1つ以上のクラスのドキュメント化」に示すように各ファイルの前にパスを含めます。\fI\-sourcepath\fRが省略された場合、\fIjavadoc\fRコマンドは、クラス・パスを使用してソース・ファイルを検索します(\fI\-classpath\fRを参照)。デフォルトの\fI\-sourcepath\fRは、クラス・パスの値です。\fI\-classpath\fRを省略してパッケージ名を\fIjavadoc\fRコマンドに渡すと、\fIjavadoc\fRコマンドは現在のディレクトリ(およびそのサブディレクトリ)からソース・ファイルを検索します。 -.sp -\fIsourcepathlist\fRには、ドキュメント化するパッケージのソース・ツリーのルート・ディレクトリを設定します。 -.sp -たとえば、\fIcom\&.mypackage\fRという名前のパッケージをドキュメント化する場合に、そのソース・ファイルが/home/user/src/com/mypackage/*\&.javaにあるとします。ソース・パスをcom\emypackageが含まれるディレクトリ/home/user/srcに指定してから、次のように、パッケージ名を指定します。 +パッケージ名または\fB\-subpackages\fRオプションを\fBjavadoc\fRコマンドに渡すときに、ソース・ファイルを見つけるための検索パスを指定します。 + +複数のパスはコロン(:)で区切ります。 +\fBjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。このオプションを使用して、ドキュメント化されるソース・ファイルの位置のみでなく、それ自体はドキュメント化されないがドキュメント化されるソース・ファイルから継承されたコメントを持つソース・ファイルの位置も確認できます。 +.sp +\fB\-sourcepath\fRオプションを使用できるのは、\fBjavadoc\fRコマンドにパッケージ名を渡す場合のみです。\fBjavadoc\fRコマンドに渡されるソース・ファイルは検索されません。ソース・ファイルを特定するには、そのディレクトリに移動するか、「1つ以上のクラスのドキュメント化」に示すように各ファイルの前にパスを含めます。\fB\-sourcepath\fRが省略された場合、\fBjavadoc\fRコマンドは、クラス・パスを使用してソース・ファイルを検索します(\fB\-classpath\fRを参照)。デフォルトの\fB\-sourcepath\fRは、クラス・パスの値です。\fB\-classpath\fRを省略してパッケージ名を\fBjavadoc\fRコマンドに渡すと、\fBjavadoc\fRコマンドは現在のディレクトリ(およびそのサブディレクトリ)からソース・ファイルを検索します。 +.sp +\fBsourcepathlist\fRには、ドキュメント化するパッケージのソース・ツリーのルート・ディレクトリを設定します。 +.sp +たとえば、\fBcom\&.mypackage\fRという名前のパッケージをドキュメント化する場合に、そのソース・ファイルが/home/user/src/com/mypackage/*\&.javaにあるとします。ソース・パスをcom\emypackageが含まれるディレクトリ/home/user/srcに指定してから、次のように、パッケージ名を指定します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-sourcepath /home/user/src/ com\&.mypackage +\fBjavadoc \-sourcepath /home/user/src/ com\&.mypackage\fR + .fi .if n \{\ .RE @@ -2484,7 +2567,8 @@ .RS 4 .\} .nf -javadoc \-sourcepath /home/user1/src:/home/user2/src com\&.mypackage +\fBjavadoc \-sourcepath /home/user1/src:/home/user2/src com\&.mypackage\fR + .fi .if n \{\ .RE @@ -2493,43 +2577,47 @@ .PP \-classpath \fIclasspathlist\fR .RS 4 -\fIjavadoc\fRコマンドが参照クラスの検索を行うときに使用するパスを指定します。参照クラスとは、ドキュメント化されるクラスと、それらのクラスによって参照されるすべてのクラスのことです。 -\fI複数のパスはコロン(:)で区切ります。\fR\fIjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。\fIclasspathlist\fRの値を指定するときは、クラス・パスのドキュメントにある指示に従ってください。 -.sp -\fI\-sourcepath\fRが省略された場合、\fIjavadoc\fRコマンドは\fI\-classpath\fRを使用して、ソース・ファイルおよびクラス・ファイルを検索します(下位互換性のため)。ソース・ファイルとクラス・ファイルを別々のパスから検索する必要がある場合は、\fI\-sourcepath\fRと\fI\-classpath\fRの両方を使用します。 -.sp -たとえば、\fIcom\&.mypackage\fRをドキュメント化する場合に、そのソース・ファイルがディレクトリ/home/user/src/com/mypackageにあり、このパッケージが/home/user/libthen内のライブラリに依存しているとき、次のように指定します。 +\fBjavadoc\fRコマンドが参照クラスの検索を行うときに使用するパスを指定します。参照クラスとは、ドキュメント化されるクラスと、それらのクラスによって参照されるすべてのクラスのことです。 + +複数のパスはコロン(:)で区切ります。 +\fBjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。\fBclasspathlist\fRの値を指定するときは、クラス・パスのドキュメントにある指示に従ってください。 +.sp +\fB\-sourcepath\fRが省略された場合、\fBjavadoc\fRコマンドは\fB\-classpath\fRを使用して、ソース・ファイルおよびクラス・ファイルを検索します(後方互換性のため)。ソース・ファイルとクラス・ファイルを別々のパスから検索する必要がある場合は、\fB\-sourcepath\fRと\fB\-classpath\fRの両方を使用します。 +.sp +たとえば、\fBcom\&.mypackage\fRをドキュメント化する場合に、そのソース・ファイルがディレクトリ/home/user/src/com/mypackageにあり、このパッケージが/home/user/lib内のライブラリに依存しているとき、次のように指定します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-sourcepath /home/user/lib \-classpath /home/user/src com\&.mypackage +\fBjavadoc \-sourcepath /home/user/lib \-classpath /home/user/src com\&.mypackage\fR + .fi .if n \{\ .RE .\} -他のツールと同様に、\fI\-classpath\fRが指定されていない場合、\fICLASSPATH\fR環境変数が設定されていれば、\fIjavadoc\fRコマンドはその環境変数を使用します。どちらも設定されていない場合、\fIjavadoc\fRコマンドは現在のディレクトリからクラスを検索します。 -.sp -\fIjavadoc\fRコマンドが\fI\-classpath\fRを使用してユーザー・クラスを検索する方法についての、拡張機能クラスやブートストラップ・クラスに関連した詳細は、クラスの検索方法 +他のツールと同様に、\fB\-classpath\fRが指定されていない場合、\fBCLASSPATH\fR環境変数が設定されていれば、\fBjavadoc\fRコマンドはその環境変数を使用します。どちらも設定されていない場合、\fBjavadoc\fRコマンドは現在のディレクトリからクラスを検索します。 +.sp +\fBjavadoc\fRコマンドが\fB\-classpath\fRを使用してユーザー・クラスを検索する方法についての、拡張機能クラスやブートストラップ・クラスに関連した詳細は、クラスの検索方法 (http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/findingclasses\&.html)を参照してください。 .sp -*のベース名を含むクラス・パス要素は、\fI\&.jar\fRまたは\fI\&.JAR\fRを拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます。 -.sp -たとえば、ディレクトリ\fImydir\fRに\fIa\&.jar\fRと\fIb\&.JA\fRRが含まれている場合、クラス・パス要素\fIfoo/*\fRは\fIA\&.jar:b\&.JAR\fRに展開されますが、JARファイルの順番は未指定となります。非表示のファイルを含む、指定したディレクトリ内のすべてのJARファイルがリストに含まれます。*からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\fICLASSPATH\fR環境変数も同様に展開されます。クラス・パスのワイルドカードの展開は、Java仮想マシン(JVM)の開始前に行われます。Javaプログラムは、System\&.getenv(\fI"CLASSPATH"\fR)の呼び出しによってなど、環境を問い合せる場合を除き、展開されていないワイルドカードを参照しません。 +*のベース名を含むクラス・パス要素は、\fB\&.jar\fRまたは\fB\&.JAR\fRを拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます。 +.sp +たとえば、ディレクトリ\fBmydir\fRに\fBa\&.jar\fRと\fBb\&.JA\fRRが含まれている場合、クラス・パス要素\fBfoo/*\fRは\fBA\&.jar:b\&.JAR\fRに展開されますが、JARファイルの順番は未指定となります。非表示のファイルを含む、指定したディレクトリ内のすべてのJARファイルがリストに含まれます。*からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\fBCLASSPATH\fR環境変数も同様に展開されます。クラス・パスのワイルドカードの展開は、Java Virtual Machine (JVM)の開始前に行われます。Javaプログラムは、System\&.getenv(\fB"CLASSPATH"\fR)の呼び出しによってなど、環境を問い合せる場合を除き、展開されていないワイルドカードを参照しません。 .RE .PP \-subpackages \fIpackage1:package2:\&.\&.\&.\fR .RS 4 -ソース・ファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。このオプションは、ソース・コードに新しいサブパッケージを追加する際に便利です。新しいサブパッケージが自動的に組み込まれるからです。各package引数は、任意の最上位サブパッケージ(\fIjava\fRなど)または完全修飾パッケージ(\fIjavax\&.swing\fRなど)になります。ソース・ファイルを含める必要はありません。引数は、すべてのオペレーティング・システムで、コロンで区切られます。ワイルドカードは使用できません。パッケージの検索場所を指定するには、\fI\-sourcepath\fRを使用します。このオプションでは、ソース・ツリー内に存在するがパッケージに含まれないソース・ファイルを処理しません。ソース・ファイルの処理を参照してください。 -.sp -たとえば、次のコマンドは、\fIjava\fRおよび\fIjavax\&.swing\fRという名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。 +ソース・ファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。このオプションは、ソース・コードに新しいサブパッケージを追加する際に便利です。新しいサブパッケージが自動的に組み込まれるからです。各package引数は、任意の最上位サブパッケージ(\fBjava\fRなど)または完全修飾パッケージ(\fBjavax\&.swing\fRなど)になります。ソース・ファイルを含める必要はありません。引数は、すべてのオペレーティング・システムで、コロンで区切られます。ワイルドカードは使用できません。パッケージの検索場所を指定するには、\fB\-sourcepath\fRを使用します。このオプションでは、ソース・ツリー内に存在するがパッケージに含まれないソース・ファイルを処理しません。ソース・ファイルの処理を参照してください。 +.sp +たとえば、次のコマンドは、\fBjava\fRおよび\fBjavax\&.swing\fRという名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax\&.swing +\fBjavadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax\&.swing \fR + .fi .if n \{\ .RE @@ -2538,16 +2626,17 @@ .PP \-exclude \fIpackagename1:packagename2:\&.\&.\&.\fR .RS 4 -指定されたパッケージとそのサブパッケージを\fI\-subpackages\fRによって作成されたリストから無条件に除外します。過去または将来の\fI\-subpackages\fRオプションの指定によって組み込まれるパッケージも除外の対象となります。 -.sp -次の例では、\fIjava\&.io\fR、\fIjava\&.util\fR、\fIjava\&.math\fRなどは組み込まれますが、\fIjava\&.net\fRと\fIjava\&.lang\fRをルートに持つパッケージは除外されます。\fIjava\&.lang\fRのサブパッケージである\fIjava\&.lang\&.ref\fRが除外される点に注意してください。 +指定されたパッケージとそのサブパッケージを\fB\-subpackages\fRによって作成されたリストから無条件に除外します。過去または将来の\fB\-subpackages\fRオプションの指定によって組み込まれるパッケージも除外の対象となります。 +.sp +次の例では、\fBjava\&.io\fR、\fBjava\&.util\fR、\fBjava\&.math\fRなどは組み込まれますが、\fBjava\&.net\fRと\fBjava\&.lang\fRをルートに持つパッケージは除外されます。\fBjava\&.lang\fRのサブパッケージである\fBjava\&.lang\&.ref\fRが除外される点に注意してください。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-sourcepath /home/user/src \-subpackages java \-exclude - java\&.net:java\&.lang +\fBjavadoc \-sourcepath /home/user/src \-subpackages java \-exclude \fR +\fB java\&.net:java\&.lang\fR + .fi .if n \{\ .RE @@ -2556,30 +2645,30 @@ .PP \-bootclasspath \fIclasspathlist\fR .RS 4 -ブート・クラスが存在するパスを指定します。ブート・クラスとは、通常、Javaプラットフォーム・クラスのことです。\fIbootclasspath\fRは、\fIjavadoc\fRコマンドがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、クラスの検出方法 +ブート・クラスが存在するパスを指定します。ブート・クラスとは、通常、Javaプラットフォーム・クラスのことです。\fBbootclasspath\fRは、\fBjavadoc\fRコマンドがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、クラスの検出方法 (http://docs\&.oracle\&.com/javase/8/docs/technotes/tools/findingclasses\&.html)を参照してください .sp -\fIclasspathlist\fRパラメータ内のディレクトリは、セミコロン(;)で区切る(Windowsの場合)か、コロン(:)で区切ります(Oracle Solarisの場合)。 +\fBclasspathlist\fRパラメータ内のディレクトリは、セミコロン(;)で区切る(Windowsの場合)か、コロン(:)で区切ります(Oracle Solarisの場合)。 .RE .PP \-extdirs \fIdirist\fR .RS 4 -拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java拡張機能機構を使用するすべてのクラスです。\fIextdirs\fRオプションは、\fIjavadoc\fRコマンドがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、\fI\-classpath\fRオプションを参照してください。\fIdirlist\fR内のディレクトリは、セミコロン(;)で区切る(Windowsの場合)か、コロン(:)で区切ります(Oracle Solarisの場合)。 +拡張機能クラスが存在するディレクトリを指定します。拡張機能クラスとは、Java拡張機能機構を使用するすべてのクラスです。\fBextdirs\fRオプションは、\fBjavadoc\fRコマンドがソース・ファイルとクラス・ファイルを探すときに使用する検索パスの一部です。詳細は、\fB\-classpath\fRオプションを参照してください。\fBdirlist\fR内のディレクトリは、セミコロン(;)で区切る(Windowsの場合)か、コロン(:)で区切ります(Oracle Solarisの場合)。 .RE .PP \-verbose .RS 4 -\fIjavadoc\fRコマンドの実行中に詳細なメッセージを表示します。\fIverbose\fRオプションを指定しないと、ソース・ファイルのロード時、ドキュメントの生成時(ソース・ファイルごとに1つのメッセージ)、およびソート時にメッセージが表示されます。verboseオプションを指定すると、各Javaソース・ファイルの解析に要した時間(ミリ秒単位)を示す追加のメッセージが表示されます。 +\fBjavadoc\fRコマンドの実行中に詳細なメッセージを表示します。\fBverbose\fRオプションを指定しないと、ソース・ファイルのロード時、ドキュメントの生成時(ソース・ファイルごとに1つのメッセージ)、およびソート時にメッセージが表示されます。verboseオプションを指定すると、各Javaソース・ファイルの解析に要した時間(ミリ秒単位)を示す追加のメッセージが表示されます。 .RE .PP \-quiet .RS 4 -メッセージを抑制し、警告とエラーのみが表示されるようにして、これらを確認しやすくします。\fIversion\fR文字列も抑止します。 +メッセージを抑制し、警告とエラーのみが表示されるようにして、これらを確認しやすくします。\fBversion\fR文字列も抑止します。 .RE .PP \-breakiterator .RS 4 -英語の場合、パッケージ、クラスまたはメンバーの主説明の最初の文の終わりを判断する際に、\fIjava\&.text\&.BreakIterator\fRの国際化された文境界を使用します。他のすべてのロケールは、英語言語というロケール固有のアルゴリズムではなく、すでに\fIBreakIterator\fRクラスを使用しています。最初の文は、パッケージ、クラス、またはメンバーのサマリーにコピーされ、アルファベット順の索引にコピーされます。JDK 1\&.2以降、\fIBreakIterator\fRクラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、\fI\-breakiterator\fRオプションは、1\&.2以降では英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。 +英語の場合、パッケージ、クラスまたはメンバーの主説明の最初の文の終わりを判断する際に、\fBjava\&.text\&.BreakIterator\fRの国際化された文境界を使用します。他のすべてのロケールは、英語言語というロケール固有のアルゴリズムではなく、すでに\fBBreakIterator\fRクラスを使用しています。最初の文は、パッケージ、クラス、またはメンバーのサマリーにコピーされ、アルファベット順の索引にコピーされます。JDK 1\&.2以降、\fBBreakIterator\fRクラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、\fB\-breakiterator\fRオプションは、1\&.2以降では英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。 .sp .RS 4 .ie n \{\ @@ -2589,7 +2678,7 @@ .sp -1 .IP \(bu 2.3 .\} -英文のデフォルトの文区切りアルゴリズム。空白文字またはHTMLブロック・タグ(\fI<P>\fRなど)が続くピリオドで停止します。 +英文のデフォルトの文区切りアルゴリズム。空白文字またはHTMLブロック・タグ(\fB<P>\fRなど)が続くピリオドで停止します。 .RE .sp .RS 4 @@ -2600,45 +2689,46 @@ .sp -1 .IP \(bu 2.3 .\} -breakiterator文区切りアルゴリズム。次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止します。このアルゴリズムでは「The serial no\&. is valid」など、ほとんどの省略表記が処理されますが、「Mr\&. Smith」は処理されません。\fI\-breakiterator\fRオプションでは、HTMLタグや、数字または記号で始まる文では停止しません。HTMLタグに埋め込まれている場合でも、「\&.\&./filename」の最後のピリオドで停止します。 -.RE -.sp -Java SE 1\&.5では\fI\-breakiterator\fR警告メッセージが削除され、デフォルトの文区切りアルゴリズムは変更されていません。ソース・コードを変更せず、SE 1\&.4\&.xでの\fI\-breakiterator\fRオプションの警告を除去していない場合でも、何もする必要はありません。Java SE 1\&.5\&.0からは警告は消滅しています。 +breakiterator文区切りアルゴリズム。次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止します。このアルゴリズムでは「The serial no\&. is valid」など、ほとんどの省略表記が処理されますが、「Mr\&. Smith」は処理されません。\fB\-breakiterator\fRオプションでは、HTMLタグや、数字または記号で始まる文では停止しません。HTMLタグに埋め込まれている場合でも、「\&.\&./filename」の最後のピリオドで停止します。 +.RE +.sp +Java SE 1\&.5では\fB\-breakiterator\fR警告メッセージが削除され、デフォルトの文区切りアルゴリズムは変更されていません。ソース・コードを変更せず、SE 1\&.4\&.xでの\fB\-breakiterator\fRオプションの警告を除去していない場合でも、何もする必要はありません。Java SE 1\&.5\&.0からは警告は消滅しています。 .RE .PP \-locale \fIlanguage_country_variant\fR .RS 4 -\fIjavadoc\fRコマンドがドキュメントを生成するときに使用するロケールを指定します。この引数は、\fIj\fR\fIava\&.util\&.Locale\fRドキュメントで説明しているように、\fIen_US\fR -(英語、米国)または\fIen_US_WIN\fR +\fBjavadoc\fRコマンドがドキュメントを生成するときに使用するロケールを指定します。この引数は、\fBj\fR\fBava\&.util\&.Locale\fRドキュメントで説明しているように、\fBen_US\fR +(英語、米国)または\fBen_US_WIN\fR (Windowsバリアント)などのロケールの名前です。 .sp \fB注意:\fR -\fI\-locale\fRオプションは、標準ドックレットが提供するすべてのオプション、またはその他の任意のドックレットが提供するすべてのオプションより前(左側)に指定する必要があります。そうしないと、ナビゲーション・バーが英語で表示されます。このコマンドライン・オプションのみ、指定する順序に依存します。標準ドックレットのオプションを参照してください。 -.sp -ロケールを指定すると、指定したロケールのリソース・ファイルが\fIjavadoc\fRコマンドによって選択されて、メッセージ(ナビゲーション・バー、リストと表の見出し、ヘルプ・ファイルの目次、stylesheet\&.cssのコメントなどの文字列)のために使用されます。また、アルファベット順にソートされるリストのソート順、および最初の文の終わりを判断するための文の区切り文字も、指定したロケールによって決まります。\fI\-locale\fRオプションは、ドキュメント化されるクラスのソース・ファイル内で指定されているドキュメンテーション・コメントのテキストのロケールを決定するものではありません。 +\fB\-locale\fRオプションは、標準ドックレットが提供するすべてのオプション、またはその他の任意のドックレットが提供するすべてのオプションより前(左側)に指定する必要があります。そうしないと、ナビゲーション・バーが英語で表示されます。このコマンド行オプションのみ、指定する順序に依存します。標準ドックレットのオプションを参照してください。 +.sp +ロケールを指定すると、指定したロケールのリソース・ファイルが\fBjavadoc\fRコマンドによって選択されて、メッセージ(ナビゲーション・バー、リストと表の見出し、ヘルプ・ファイルの目次、stylesheet\&.cssのコメントなどの文字列)のために使用されます。また、アルファベット順にソートされるリストのソート順、および最初の文の終わりを判断するための文の区切り文字も、指定したロケールによって決まります。\fB\-locale\fRオプションは、ドキュメント化されるクラスのソース・ファイル内で指定されているドキュメンテーション・コメントのテキストのロケールを決定するものではありません。 .RE .PP \-encoding .RS 4 -ソース・ファイルのエンコーディングの名前(\fIEUCJIS/SJIS\fRなど)を指定します。このオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。およびオプションも参照してください。 +ソース・ファイルのエンコーディングの名前(\fBEUCJIS/SJIS\fRなど)を指定します。このオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。およびオプションも参照してください。 .RE .PP \-J\fIflag\fR .RS 4 -\fIjavadoc\fRコマンドを実行するJava Runtime Environment (JRE)に、\fIflag\fRを直接渡します。たとえば、生成ドキュメントを処理するためにシステムで32MBのメモリーを確保しておく必要がある場合は、\fI\-Xmx\fRオプションを次のように呼び出します。\fIjavadoc \-J\-Xmx32m \-J\-Xms32m com\&.mypackage\fR。\fI\-Xms\fRは省略可能で、これは初期メモリーのサイズを設定するのみのオプションで、必要なメモリーの最小量がわかっている場合に便利です。 -.sp -\fIJ\fRと\fIflag\fRの間に空白文字はありません。 -.sp -使用している\fIjavadoc\fRコマンドのバージョンを確認するには\fI\-version\fRオプションを使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。Javadocコマンドの実行を参照してください。 +\fBjavadoc\fRコマンドを実行するJava Runtime Environment (JRE)に、\fBflag\fRを直接渡します。たとえば、生成ドキュメントを処理するためにシステムで32MBのメモリーを確保しておく必要がある場合は、\fB\-Xmx\fRオプションを次のように呼び出します。\fBjavadoc \-J\-Xmx32m \-J\-Xms32m com\&.mypackage\fR。\fB\-Xms\fRは省略可能で、これは初期メモリーのサイズを設定するのみのオプションで、必要なメモリーの最小量がわかっている場合に便利です。 +.sp +\fBJ\fRと\fBflag\fRの間に空白文字はありません。 +.sp +使用している\fBjavadoc\fRコマンドのバージョンを確認するには\fB\-version\fRオプションを使用します。出力ストリームには標準ドックレットのバージョン番号が含まれます。Javadocコマンドの実行を参照してください。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-J\-version -java version "1\&.7\&.0_09" -Java(TM) SE Runtime Environment (build 1\&.7\&.0_09\-b05) -Java HotSpot(TM) 64\-Bit Server VM (build 23\&.5\-b02, mixed mode) +\fBjavadoc \-J\-version\fR +\fBjava version "1\&.7\&.0_09"\fR +\fBJava(TM) SE Runtime Environment (build 1\&.7\&.0_09\-b05)\fR +\fBJava HotSpot(TM) 64\-Bit Server VM (build 23\&.5\-b02, mixed mode)\fR + .fi .if n \{\ .RE @@ -2648,24 +2738,24 @@ .PP \-d \fIdirectory\fR .RS 4 -\fIjavadoc\fRコマンドが生成されたHTMLファイルを保存する生成先ディレクトリを指定します。\fI\-d\fRオプションを省略すると、ファイルは現在のディレクトリに保存されます。\fIdirectory\fRの値には、絶対ディレクトリ、または現在の作業ディレクトリからの相対ディレクトリを指定できます。Java SE 1\&.4では、\fIjavadoc\fRコマンドを実行すると生成先ディレクトリが自動的に作成されます。 -.sp -たとえば、次の例では、\fIcom\&.mypackage\fRパッケージのドキュメントが生成され、その結果が\fI/user/doc/ \fRディレクトリに保存されます。\fIjavadoc \-d \fR\fI/user/doc/ \fR\fIcom\&.mypackage\fR +\fBjavadoc\fRコマンドが生成されたHTMLファイルを保存する生成先ディレクトリを指定します。\fB\-d\fRオプションを省略すると、ファイルは現在のディレクトリに保存されます。\fBdirectory\fRの値には、絶対ディレクトリ、または現在の作業ディレクトリからの相対ディレクトリを指定できます。Java SE 1\&.4では、\fBjavadoc\fRコマンドを実行すると生成先ディレクトリが自動的に作成されます。 +.sp +たとえば、次の例では、\fBcom\&.mypackage\fRパッケージのドキュメントが生成され、その結果が/user/doc/ ディレクトリに保存されます。\fBjavadoc \-d \fR\fB/user/doc/ \fR\fBcom\&.mypackage\fR .RE .PP \-use .RS 4 -ドキュメント化されるクラスおよびパッケージごとに1つの使用ページを組み込みます。このページには、その特定のクラスまたはパッケージのAPIを使用しているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドが記述されます。たとえば、クラスCを例にとると、クラスCを使用しているものとしては、Cのサブクラス、Cとして宣言されているフィールド、Cを返すメソッド、および型Cのパラメータを持つメソッドとコンストラクタがあります。たとえば、\fIString\fR型用の使用ページを表示できます。\fIjava\&.awt\&.Font\fRクラスの\fIgetName\fRメソッドは\fIString\fR型を戻すので、\fIgetName\fRメソッドは\fIString\fRを使用し、\fIgetName\fRメソッドが\fIString\fR用の使用ページに表示されます。これは実装ではなくAPIの使用のみをドキュメント化します。メソッドがその実装で\fIString\fRを使用するが、引数として文字列を取らない、または文字列を返さない場合、それは\fIString\fRの使用とはみなされません。生成された使用ページにアクセスするには、クラスまたはパッケージに移動し、ナビゲーション・バーの\fBリンクの使用\fRをクリックします。 +ドキュメント化されるクラスおよびパッケージごとに1つの使用ページを組み込みます。このページには、その特定のクラスまたはパッケージのAPIを使用しているパッケージ、クラス、メソッド、コンストラクタ、およびフィールドが記述されます。たとえば、クラスCを例にとると、クラスCを使用しているものとしては、Cのサブクラス、Cとして宣言されているフィールド、Cを返すメソッド、および型Cのパラメータを持つメソッドとコンストラクタがあります。たとえば、\fBString\fR型用の使用ページを表示できます。\fBjava\&.awt\&.Font\fRクラスの\fBgetName\fRメソッドは\fBString\fR型を戻すので、\fBgetName\fRメソッドは\fBString\fRを使用し、\fBgetName\fRメソッドが\fBString\fR用の使用ページに表示されます。これは実装ではなくAPIの使用のみをドキュメント化します。メソッドがその実装で\fBString\fRを使用するが、引数として文字列を取らない、または文字列を返さない場合、それは\fBString\fRの使用とはみなされません。生成された使用ページにアクセスするには、クラスまたはパッケージに移動し、ナビゲーション・バーの\fBリンクの使用\fRをクリックします。 .RE .PP \-version .RS 4 -生成ドキュメントに、@versionのテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用している\fIjavadoc\fRコマンドのバージョンを確認するには\fI\-J\-version\fRオプションを使用します。 +生成ドキュメントに、@versionのテキストを組み込みます。このテキストは、デフォルトでは省略されます。使用している\fBjavadoc\fRコマンドのバージョンを確認するには\fB\-J\-version\fRオプションを使用します。 .RE .PP \-author .RS 4 -生成ドキュメントに、\fI@author\fRのテキストを組み込みます。 +生成ドキュメントに、\fB@author\fRのテキストを組み込みます。 .RE .PP \-splitindex @@ -2675,27 +2765,27 @@ .PP \-windowtitle \fItitle\fR .RS 4 -HTMLの\fI<title>\fRタグに配置するタイトルを指定します。\fItitle\fRタグに指定したテキストは、ウィンドウのタイトルや、このページに対して作成されたブラウザのブックマーク(お気に入り)に表示されます。このタイトルにはHTMLタグを含めないでください。タイトルにHTMLタグが含まれていると、ブラウザがタグを正しく解釈できません。\fItitle\fRタグ内の内部の二重引用符はエスケープ文字を使用してマークします。\fI\-windowtitle\fRオプションを省略すると、\fIjavadoc\fRコマンドは、\fI\-windowtitle\fRオプションのかわりに、\fI\-doctitle\fRオプションの値を使用します。たとえば、\fIjavadoc \-windowtitle "Java SE Platform" com\&.mypackage\fRです。 +HTMLの\fB<title>\fRタグに配置するタイトルを指定します。\fBtitle\fRタグに指定したテキストは、ウィンドウのタイトルや、このページに対して作成されたブラウザのブックマーク(お気に入り)に表示されます。このタイトルにはHTMLタグを含めないでください。タイトルにHTMLタグが含まれていると、ブラウザがタグを正しく解釈できません。\fBtitle\fRタグ内の内部の二重引用符はエスケープ文字を使用してマークします。\fB\-windowtitle\fRオプションを省略すると、\fBjavadoc\fRコマンドは、\fB\-windowtitle\fRオプションのかわりに、\fB\-doctitle\fRオプションの値を使用します。たとえば、\fBjavadoc \-windowtitle "Java SE Platform" com\&.mypackage\fRです。 .RE .PP \-doctitle \fItitle\fR .RS 4 -概要サマリー・ファイルの最上部の近くに配置するタイトルを指定します。\fItitle\fRタグに指定したテキストは中央揃えになり、レベル1の見出しとして、上部ナビゲーション・バーのすぐ下に置かれます。\fItitle\fRタグにはHTMLタグおよび空白文字を含めることができますが、その場合、タイトルを引用符で囲む必要があります。\fItitle\fRタグの内部で引用符を使用する場合は、エスケープする必要があります。たとえば、\fIjavadoc \-header "<b>Java Platform </b><br>v1\&.4" com\&.mypackage\fRです。 +概要サマリー・ファイルの最上部の近くに配置するタイトルを指定します。\fBtitle\fRタグに指定したテキストは中央揃えになり、レベル1の見出しとして、上部ナビゲーション・バーのすぐ下に置かれます。\fBtitle\fRタグにはHTMLタグおよび空白文字を含めることができますが、その場合、タイトルを引用符で囲む必要があります。\fBtitle\fRタグの内部で引用符を使用する場合は、エスケープする必要があります。たとえば、\fBjavadoc \-header "<b>Java Platform </b><br>v1\&.4" com\&.mypackage\&.\fRとなります。 .RE .PP \-title \fItitle\fR .RS 4 -すでに存在しません。Javadoc 1\&.2のベータ版にしか存在していませんでした。このオプションは、\fI\-doctitle\fRという名前に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。 +すでに存在しません。Javadoc 1\&.2のベータ版にしか存在していませんでした。このオプションは、\fB\-doctitle\fRという名前に変更されました。名前を変更した理由は、このオプションが、ウィンドウのタイトルではなくドキュメントのタイトルを定義することを明確にするためです。 .RE .PP \-header \fIheader\fR .RS 4 -各出力ファイルの最上部に配置するヘッダー・テキストを指定します。ヘッダーは、ナビゲーション・バーの右上に配置されます。\fIheader\fRにはHTMLタグおよび空白文字を含めることができますが、その場合、\fIheader\fRを引用符で囲む必要があります。ヘッダー内部の引用符にはエスケープ文字を使用します。たとえば、\fIjavadoc \-header "<b>Java Platform </b><br>v1\&.4" com\&.mypackage\fRです。 +各出力ファイルの最上部に配置するヘッダー・テキストを指定します。ヘッダーは、ナビゲーション・バーの右上に配置されます。\fBheader\fRにはHTMLタグおよび空白文字を含めることができますが、その場合、\fBheader\fRを引用符で囲む必要があります。ヘッダー内部の引用符にはエスケープ文字を使用します。たとえば、\fBjavadoc \-header "<b>Java Platform </b><br>v1\&.4" com\&.mypackage\&.\fRとなります。 .RE .PP \-footer \fIfooter\fR .RS 4 -各出力ファイルの最下部に配置するフッター・テキストを指定します。\fIfooter\fRの値は、ナビゲーション・バーの右下に配置されます。\fIfooter\fRにはHTMLタグおよび空白文字を含めることができますが、その場合、\fIfooter\fRを引用符で囲む必要があります。フッター内部の引用符にはエスケープ文字を使用します。 +各出力ファイルの最下部に配置するフッター・テキストを指定します。\fIfooter\fRの値は、ナビゲーション・バーの右下に配置されます。\fBfooter\fRにはHTMLタグおよび空白文字を含めることができますが、その場合、\fBfooter\fRを引用符で囲む必要があります。フッター内部の引用符にはエスケープ文字を使用します。 .RE .PP \-top @@ -2710,25 +2800,28 @@ .PP \-link \fIextdocURL\fR .RS 4 -既存のJavadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。\fIextdocURL\fR引数は、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。指定した\fIjavadoc\fRコマンドの実行で、複数の\fI\-link\fRオプションを指定して複数のドキュメントへのリンクを作成できます。 -.sp -このディレクトリ内にpackage\-listファイルが存在する必要があります(存在しない場合は、\fI\-linkoffline\fRオプションを使用します)。\fIjavadoc\fRコマンドは、package\-listファイルからパッケージ名を読み取った後、そのURLでこれらのパッケージにリンクします。\fIjavadoc\fRコマンドの実行時に、\fIextdocURL\fRの値が、作成された\fI<A HREF>\fRリンク内にコピーされます。したがって、\fIextdocURL\fRはファイルではなくディレクトリへのURLである必要があります。\fIextdocURL\fRに絶対リンクを使用すると、ユーザーのドキュメントを任意のWebサイト上のドキュメントにリンクできます。相対位置へリンクするのみの場合は相対リンクを使用できます。相対リンクを使用する場合、渡す値は宛先ディレクトリから、リンクされているパッケージを含むディレクトリへである必要があります(\fI\-d\fRオプションで指定)。絶対リンクを指定する場合、通常、HTTPリンクを使用します。ただし、Webサーバーを持たないファイル・システムにリンクする場合は、ファイル・リンクを使用できます。生成されたドキュメンテーションにアクセスする全員が同じファイル・システムを共有する場合にのみファイル・リンクを使用します。どの場合も、どのオペレーティング・システムでも、URLが絶対または相対のいずれでも、また\fIh\fR\fIttp:\fRまたは\fIf\fR\fIile:\fRのいずれでも、URLメモ: Uniform Resource Locators +既存のJavadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。\fIextdocURL\fR引数は、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。指定した\fBjavadoc\fRコマンドの実行で、複数の\fB\-link\fRオプションを指定して複数のドキュメントへのリンクを作成できます。 +.sp +このディレクトリ内にpackage\-listファイルが存在する必要があります(存在しない場合は、\fB\-linkoffline\fRオプションを使用します)。\fBjavadoc\fRコマンドは、package\-listファイルからパッケージ名を読み取った後、そのURLでこれらのパッケージにリンクします。\fBjavadoc\fRコマンドの実行時に、\fBextdocURL\fRの値が、作成された\fB<A HREF>\fRリンク内にコピーされます。したがって、\fBextdocURL\fRはファイルではなくディレクトリへのURLである必要があります。\fIextdocURL\fRに絶対リンクを使用すると、ユーザーのドキュメントを任意のWebサイト上のドキュメントにリンクできます。相対位置へリンクするのみの場合は相対リンクを使用できます。相対リンクを使用する場合、渡す値は宛先ディレクトリから、リンクされているパッケージを含むディレクトリへである必要があります(\fB\-d\fRオプションで指定)。絶対リンクを指定する場合、通常、HTTPリンクを使用します。ただし、Webサーバーを持たないファイル・システムにリンクする場合は、ファイル・リンクを使用できます。生成されたドキュメンテーションにアクセスする全員が同じファイル・システムを共有する場合にのみファイル・リンクを使用します。どの場合も、どのオペレーティング・システムでも、URLが絶対または相対のいずれでも、また\fBh\fR\fBttp:\fRまたは\fBf\fR\fBile:\fRのいずれでも、URLメモ: Uniform Resource Locators (http://www\&.ietf\&.org/rfc/rfc1738\&.txt)に指定されているとおり、区切り文字としてスラッシュを使用します。 .sp .if n \{\ .RS 4 .\} .nf -\-link http://<host>/<directory>/<directory>/\&.\&.\&./<name> -\-link file://<host>/<directory>/<directory>/\&.\&.\&./<name> -\-link <directory>/<directory>/\&.\&.\&./<name> +\fB\-link http://<host>/<directory>/<directory>/\&.\&.\&./<name>\fR +\fB\-link file://<host>/<directory>/<directory>/\&.\&.\&./<name>\fR +\fB\-link <directory>/<directory>/\&.\&.\&./<name>\fR + .fi .if n \{\ .RE .\} .RE -\-linkofflineおよび\-linkオプションの違い.PP -次の場合に、\fI\-link\fRオプションを使用します。 +.PP +\-linkofflineおよび\-linkオプションの違い +.PP +次の場合に、\fB\-link\fRオプションを使用します。 .sp .RS 4 .ie n \{\ @@ -2752,47 +2845,59 @@ 外部APIドキュメントへの絶対URLを使用する場合(そのURLに接続し、読取りを行うことがシェルによって許可されている場合)。 .RE .PP -外部APIドキュメントへの絶対URLを使用する場合(そのURLに接続し、読取りを行うことがシェルによって許可されていない場合)は\fI\-linkoffline\fRオプションを使用します。このような状況は、ファイアウォールの内側からファイアウォールの外側にあるドキュメントにリンクしようとする場合に発生します。 -.PP -\fBExample 1\fR, 外部ドキュメントへの絶対リンク -.RS 4 -http://docs\&.oracle\&.com/javase/8/docs/api/index\&.htmlに示すような、\fIjava\&.lang\fR、\fIjava\&.io\fRおよびその他のJavaプラットフォーム・パッケージにリンクする場合、次のコマンドを使用します +外部APIドキュメントへの絶対URLを使用する場合(そのURLに接続し、読取りを行うことがシェルによって許可されていない場合)は\fB\-linkoffline\fRオプションを使用します。このような状況は、ファイアウォールの内側からファイアウォールの外側にあるドキュメントにリンクしようとする場合に発生します。 +.PP +\fB例 1\fR +.br +外部ドキュメントへの絶対リンク +.RS 4 +http://docs\&.oracle\&.com/javase/8/docs/api/index\&.htmlに示すような、\fBjava\&.lang\fR、\fBjava\&.io\fRおよびその他のJavaプラットフォーム・パッケージにリンクする場合、次のコマンドを使用します .sp .if n \{\ .RS 4 .\} .nf -javadoc \-link http://docs\&.oracle\&.com/javase/8/docs/api/ com\&.mypackage +\fBjavadoc \-link http://docs\&.oracle\&.com/javase/8/docs/api/ com\&.mypackage\fR + .fi .if n \{\ .RE .\} -このコマンドは、Java SEプラットフォーム・パッケージへのリンク持つ\fIcom\&.mypackage\fRパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス\fItrees\fR内の\fIObject\fRクラスへのリンクが含まれています。\fI\-sourcepath\fRや\fI\-d\fRなどの他のオプションは表示されません。 -.RE -.PP -\fBExample 2\fR, 外部ドキュメントへの相対リンク -.RS 4 -この例では、2つのパッケージがあり、そのドキュメントは\fIjavadoc\fRコマンドを複数回実行した結果生成されたものです。さらに、これらのドキュメントは相対パスで分割されています。パッケージは、APIである\fIcom\&.apipackage\fRと、SPI(サービス・プロバイダ・インタフェース)であるc\fIom\&.spipackage\fRです。ドキュメントの格納先は、docs/api/com/apipackageとdocs/spi/com/spipackageです。APIパッケージのドキュメントはすでに生成されていて、docsが現在のディレクトリである場合、APIドキュメントへのリンクを持つSPIパッケージをドキュメント化するには、次のコマンドを実行します。\fIjavadoc \-d \&./spi \-link \&.\&./api com\&.spipackage\fR -.sp -\fI\-link\fRオプションは、宛先ディレクトリ(docs/spi)からの相対パスです。 -.RE -注意.PP -\fI\-link\fRオプションを使用すると、コードからは参照されていても、今回の\fIjavadoc\fRの実行ではドキュメント化されないクラスにリンクできるようになります。リンクから有効なページに移動できるようにするには、それらのHTMLページがある場所を調べ、その場所を\fIextdocURL\fRに指定する必要があります。これにより、サードパーティのドキュメンテーションがjava\&.*ドキュメンテーション(http://docs\&.oracle\&.com)へリンクすることができます。\fIjavadoc\fRコマンドで、現在の実行で生成しているドキュメンテーション内のAPIへのリンクのみを作成する場合には、\fI\-link\fRオプションを省略します。\fI\-link\fRオプションを指定しないと、\fIjavadoc\fRコマンドは外部参照のためのドキュメンテーションへのリンクを作成しません。ドキュメンテーションが存在するのかどうか、またはどこに存在するのかがわからないからです。\fI\-link\fRオプションでは、生成ドキュメンテーション内の複数の場所にリンクを作成できます。ソース・ファイルの処理を参照してください。もう1つの用途は、パッケージ・セットの間にクロスリンクを作成することです。一方のパッケージ・セットに対して\fIjavadoc\fRコマンドを実行した後、他方のパッケージ・セットに対して\fIjavadoc\fRコマンドを再度実行すると、両セット間に双方向のリンクを作成できます。 -クラスの参照方法.PP -表示される外部参照クラスへのリンクの場合(およびそのテキスト・ラベルだけではなく)、クラスは次の方法で参照される必要があります。メソッドの本体でクラスを参照するのみでは十分ではありません。\fIimport\fR文、宣言のいずれかで参照する必要があります。次に、クラス\fIjava\&.io\&.File\fRを参照する方法の例を示します。 -.PP -すべてのタイプのimport文の場合。ワイルドカードによるインポート、名前による明示的なインポート、または\fIjava\&.lang\&.*\fRに対する自動インポート。 -.PP -Java SE 1\&.3\&.\fIn\fRおよび1\&.2\&.\fIn\fRでは、名前による明示的なインポートのみ機能します。ワイルドカードによる\fIimport\fR文も、\fIimport java\&.lang\&.*\fRの自動インポートも機能しません。 +このコマンドは、Java SEプラットフォーム・パッケージへのリンク持つ\fBcom\&.mypackage\fRパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス\fBtrees\fR内の\fBObject\fRクラスへのリンクが含まれています。\fB\-sourcepath\fRや\fB\-d\fRなどの他のオプションは表示されません。 +.RE +.PP +\fB例 2\fR +.br +外部ドキュメントへの相対リンク +.RS 4 +この例では、2つのパッケージがあり、そのドキュメントは\fBjavadoc\fRコマンドを複数回実行した結果生成されたものです。さらに、これらのドキュメントは相対パスで分割されています。パッケージは、APIである\fBcom\&.apipackage\fRと、SPI(サービス・プロバイダ・インタフェース)であるc\fBom\&.spipackage\fRです。ドキュメントの格納先は、docs/api/com/apipackageとdocs/spi/com/spipackageです。APIパッケージのドキュメントはすでに生成されていて、docsが現在のディレクトリである場合、APIドキュメントへのリンクを持つSPIパッケージをドキュメント化するには、次のコマンドを実行します。\fBjavadoc \-d \&./spi \-link \&.\&./api com\&.spipackage\fR +.sp +\fB\-link\fRオプションは、宛先ディレクトリ(docs/spi)からの相対パスです。 +.RE +.PP +注意 +.PP +\fB\-link\fRオプションを使用すると、コードからは参照されていても、今回の\fBjavadoc\fRの実行ではドキュメント化されないクラスにリンクできるようになります。リンクから有効なページに移動できるようにするには、それらのHTMLページがある場所を調べ、その場所を\fBextdocURL\fRに指定する必要があります。これにより、サードパーティのドキュメンテーションがjava\&.*ドキュメンテーション( +http://docs\&.oracle\&.com)へリンクすることができます。\fBjavadoc\fRコマンドで、現在の実行で生成しているドキュメンテーション内のAPIへのリンクのみを作成する場合には、\fB\-link\fRオプションを省略します。\fB\-link\fRオプションを指定しないと、\fBjavadoc\fRコマンドは外部参照のためのドキュメンテーションへのリンクを作成しません。ドキュメンテーションが存在するのかどうか、またはどこに存在するのかがわからないからです。\fB\-link\fRオプションでは、生成ドキュメンテーション内の複数の場所にリンクを作成できます。ソース・ファイルの処理を参照してください。もう1つの用途は、パッケージ・セットの間にクロスリンクを作成することです。一方のパッケージ・セットに対して\fBjavadoc\fRコマンドを実行した後、他方のパッケージ・セットに対して\fBjavadoc\fRコマンドを再度実行すると、両セット間に双方向のリンクを作成できます。 +.PP +クラスの参照方法 +.PP +表示される外部参照クラスへのリンクの場合(およびそのテキスト・ラベルだけではなく)、クラスは次の方法で参照される必要があります。メソッドの本体でクラスを参照するのみでは十分ではありません。\fBimport\fR文、宣言のいずれかで参照する必要があります。次に、クラス\fBjava\&.io\&.File\fRを参照する方法の例を示します。 +.PP +すべてのタイプのimport文の場合。ワイルドカードによるインポート、名前による明示的なインポート、または\fBjava\&.lang\&.*\fRに対する自動インポート。 +.PP +Java SE 1\&.3\&.\fIn\fRおよび1\&.2\&.\fIn\fRでは、名前による明示的なインポートのみ機能します。ワイルドカードによる\fBimport\fR文も、\fBimport java\&.lang\&.*\fRの自動インポートも機能しません。 .PP 宣言の場合: -\fIvoid mymethod(File f) {}\fR +\fBvoid mymethod(File f) {}\fR .PP 参照は、メソッド、コンストラクタ、フィールド、クラスまたはインタフェースの戻り型またはパラメータ・タイプ、あるいは実装、拡張またはスロー文にあります。 .PP -重要な結果として、\fI\-link\fRオプションを使用しても、この制限のために誤って表示されないリンクが多数発生する可能性があります。テキストはハイパーテキスト・リンクが付けられずに表示されます。リンクが表示する警告から、これらのリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するための最も簡単な方法はそのクラスをインポートすることです。 -パッケージ・リスト.PP -\fI\-link\fRオプションには、\fIjavadoc\fRコマンドによって生成されるpackage\-listという名前のファイルが、\fI\-link\fRオプションに指定したURLに存在していることが必要です。package\-listファイルは、その場所にあるドキュメント化されたパッケージの名前のリストが入った単純なテキスト・ファイルです。前述の例では、\fIjavadoc\fRコマンドは、指定したURLでpackage\-listという名前のファイルを検索し、パッケージ名を読み取って、そのURLでこれらのパッケージにリンクします。 +重要な結果として、\fB\-link\fRオプションを使用しても、この制限のために誤って表示されないリンクが多数発生する可能性があります。テキストはハイパーテキスト・リンクが付けられずに表示されます。リンクが表示する警告から、これらのリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するための最も簡単な方法はそのクラスをインポートすることです。 +.PP +パッケージ・リスト +.PP +\fB\-link\fRオプションには、\fBjavadoc\fRコマンドによって生成されるpackage\-listという名前のファイルが、\fB\-link\fRオプションに指定したURLに存在していることが必要です。package\-listファイルは、その場所にあるドキュメント化されたパッケージの名前のリストが入った単純なテキスト・ファイルです。前述の例では、\fBjavadoc\fRコマンドは、指定したURLでpackage\-listという名前のファイルを検索し、パッケージ名を読み取って、そのURLでこれらのパッケージにリンクします。 .PP たとえば、Java SE APIのパッケージ・リストは http://docs\&.oracle\&.com/javase/8/docs/api/package\-listにあります。 @@ -2803,33 +2908,38 @@ .RS 4 .\} .nf -java\&.applet -java\&.awt -java\&.awt\&.color -java\&.awt\&.datatransfer -java\&.awt\&.dnd -java\&.awt\&.event -java\&.awt\&.font -and so on \&.\&.\&.\&. +\fBjava\&.applet\fR +\fBjava\&.awt\fR +\fBjava\&.awt\&.color\fR +\fBjava\&.awt\&.datatransfer\fR +\fBjava\&.awt\&.dnd\fR +\fBjava\&.awt\&.event\fR +\fBjava\&.awt\&.font\fR +\fBand so on \&.\&.\&.\&.\fR + .fi .if n \{\ .RE .\} .PP -\fI\-link\fRオプションを指定せずに\fIjavadoc\fRを実行した場合、外部参照クラスに属する名前を見つけると、その名前をリンクなしで出力します。一方、\fI\-link\fRオプションを指定した場合、\fIjavadoc\fRコマンドは、指定された\fIextdocURL\fRの場所にあるpackage\-listファイルでそのパッケージ名を検索します。パッケージ名が見つかると、\fIextdocURL\fRが名前の前に付加されます。 -.PP -すべてのリンクが正しく機能するためには、外部参照のすべてのドキュメントが、指定したURLに存在する必要があります。\fIjavadoc\fRコマンドは、指定されたpackage\-listが存在するかどうかのみをチェックし、これらのページが存在するかどうかはチェックしません。 -複数のリンク.PP -複数の\fI\-link\fRオプションを指定すると、任意の数の外部生成ドキュメントへのリンクを作成できます。Javadoc 1\&.2には、複数の\fI\-link\fRオプションを指定できないという既知の不具合があります。これはJavadoc 1\&.2\&.2で修正されました。リンクする外部ドキュメントごとに、次のように別々のリンク・オプションを指定します。\fIjavadoc \-link extdocURL1 \-link extdocURL2 \&.\&.\&. \-link extdocURLn com\&.mypackage\fR -\fIextdocURL1\fR、\fIextdocURL2\fR、\&.\fI\&.\&. extdocURLn\fRは、それぞれ外部ドキュメントのルートを指し、各ルートには、package\-listという名前のファイルが入っています。 -クロスリンク.PP -以前に作成された複数のドキュメントをクロスリンクする場合、ブートストラップが必要になることがあります。どのドキュメントについてもpackage\-listが存在していない場合は、最初のドキュメントに対して\fIjavadoc\fRコマンドを実行する時点で、2番目のドキュメントのpackage\-listはまだ存在していません。したがって、外部リンクを作成するには、2番目のドキュメントを生成した後で、最初のドキュメントを生成しなおす必要があります。 -.PP -この場合、最初のドキュメント生成の目的は、package\-listを作成することです(パッケージ名を把握している場合は手動で作成してもかまいません)。次に、2番目のドキュメントとその外部リンクを生成します。必要な外部のpackage\-listファイルが存在しない場合は、\fIjavadoc\fRコマンドから警告が出力されます。 +\fB\-link\fRオプションを指定せずに\fBjavadoc\fRを実行した場合、外部参照クラスに属する名前を見つけると、その名前をリンクなしで出力します。一方、\fB\-link\fRオプションを指定した場合、\fBjavadoc\fRコマンドは、指定された\fIextdocURL\fRの場所にあるpackage\-listファイルでそのパッケージ名を検索します。パッケージ名が見つかると、\fIextdocURL\fRが名前の前に付加されます。 +.PP +すべてのリンクが正しく機能するためには、外部参照のすべてのドキュメントが、指定したURLに存在する必要があります。\fBjavadoc\fRコマンドは、指定されたpackage\-listが存在するかどうかのみをチェックし、これらのページが存在するかどうかはチェックしません。 +.PP +複数のリンク +.PP +複数の\fB\-link\fRオプションを指定すると、任意の数の外部生成ドキュメントへのリンクを作成できます。Javadoc 1\&.2には、複数の\fB\-link\fRオプションを指定できないという既知のbugがあります。これはJavadoc 1\&.2\&.2で修正されました。リンクする外部ドキュメントごとに、次のように別々のリンク・オプションを指定します。\fBjavadoc \-link extdocURL1 \-link extdocURL2 \&.\&.\&. \-link extdocURLn com\&.mypackage\fR +\fIextdocURL1\fR、\fIextdocURL2\fR、\&.\fB\&.\&. extdocURLn\fRは、それぞれ外部ドキュメントのルートを指し、各ルートには、package\-listという名前のファイルが入っています。 +.PP +クロスリンク +.PP +以前に作成された複数のドキュメントをクロスリンクする場合、ブートストラップが必要になることがあります。どのドキュメントについてもpackage\-listが存在していない場合は、最初のドキュメントに対して\fBjavadoc\fRコマンドを実行する時点で、2番目のドキュメントのpackage\-listはまだ存在していません。したがって、外部リンクを作成するには、2番目のドキュメントを生成した後で、最初のドキュメントを生成しなおす必要があります。 +.PP +この場合、最初のドキュメント生成の目的は、package\-listを作成することです(パッケージ名を把握している場合は手動で作成してもかまいません)。次に、2番目のドキュメントとその外部リンクを生成します。必要な外部のpackage\-listファイルが存在しない場合は、\fBjavadoc\fRコマンドから警告が出力されます。 .PP \-linkoffline \fIextdocURL packagelistLoc\fR .RS 4 -このオプションは\fI\-link\fRオプションのバリエーションです。両方とも、Javadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。\fIjavadoc\fRコマンドがWeb接続を使用してドキュメントにアクセスできないとき、Web上のドキュメントにリンクするには、\fI\-link\fRo\fIffline\fRオプションを使用します。外部ドキュメントのpackage\-listファイルにアクセスできないとき、またはこのファイルが\fIextdocURL\fRで指定された場所には存在せず、\fIpackageListLoc\fRで指定できる別の場所(通常ローカル)に存在するとき、\fI\-linkoffline\fRオプションを使用します。\fIextdocURL\fRにWorld Wide Web上でしかアクセスできない場合は、\fI\-linkoffline\fRオプションを指定することにより、ドキュメントの生成時に\fIjavadoc\fRコマンドがWebに接続する必要があるという制約がなくなります。もう1つの用途は、ドキュメントを更新するための回避策として使用することです。パッケージのセット全体に対して\fIjavadoc\fRコマンドを実行した後、変更した一部のパッケージに対してのみ\fIjavadoc\fRコマンドを再度実行して、更新されたファイルを、オリジナルのセットに挿入できるようにします。次に例を示します。\fI\-linkoffline\fRオプションは引数を2つ取ります。第1引数は\fI<a href>\fRリンクに組み込まれる文字列を指定し、第2引数はpackage\-listの検索場所を\fI\-linkoffline\fRに伝えます。 +このオプションは\fB\-link\fRオプションのバリエーションです。両方とも、Javadocにより生成された外部参照クラスのドキュメントへのリンクを作成します。\fBjavadoc\fRコマンドがWeb接続を使用してドキュメントにアクセスできないとき、Web上のドキュメントにリンクするには、\fB\-link\fRo\fBffline\fRオプションを使用します。外部ドキュメントのpackage\-listファイルにアクセスできないとき、またはこのファイルが\fBextdocURL\fRで指定された場所には存在せず、\fBpackageListLoc\fRで指定できる別の場所(通常ローカル)に存在するとき、\fB\-linkoffline\fRオプションを使用します。\fBextdocURL\fRにWorld Wide Web上でしかアクセスできない場合は、\fB\-linkoffline\fRオプションを指定することにより、ドキュメントの生成時に\fBjavadoc\fRコマンドがWebに接続する必要があるという制約がなくなります。もう1つの用途は、ドキュメントを更新するための回避策として使用することです。パッケージのセット全体に対して\fBjavadoc\fRコマンドを実行した後、変更した一部のパッケージに対してのみ\fBjavadoc\fRコマンドを再度実行して、更新されたファイルを、オリジナルのセットに挿入できるようにします。次に例を示します。\fB\-linkoffline\fRオプションは引数を2つ取ります。第1引数は\fB<a href>\fRリンクに組み込まれる文字列を指定し、第2引数はpackage\-listの検索場所を\fB\-linkoffline\fRに伝えます。 .sp .RS 4 .ie n \{\ @@ -2839,7 +2949,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIextdocURL\fRの値は、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。相対URLの場合、値は、生成先ディレクトリ(\fI\-d\fRオプションで指定)からリンク先となるパッケージのルートへの相対パスにする必要があります。詳細は、\fI\-link\fRオプションの\fIextdocURL\fRを参照してください。 +\fBextdocURL\fRの値は、リンク先として指定する、Javadocにより生成された外部ドキュメントを含むディレクトリの絶対URLまたは相対URLです。相対URLの場合、値は、生成先ディレクトリ(\fB\-d\fRオプションで指定)からリンク先となるパッケージのルートへの相対パスにする必要があります。詳細は、\fB\-link\fRオプションの\fIextdocURL\fRを参照してください。 .RE .sp .RS 4 @@ -2850,14 +2960,16 @@ .sp -1 .IP \(bu 2.3 .\} -\fIpackagelistLoc\fRの値は、外部ドキュメントのpackage\-listファイルを含むディレクトリへのパスまたはURLです。これは、URL (http:またはfile:)でもファイル・パスでもかまいません。また、絶対パスと相対パスのどちらでもかまいません。相対パスの場合は、\fIjavadoc\fRコマンドが実行される現在のディレクトリからの相対パスとして指定します。package\-listファイル名を含めないでください。 -.sp -指定した\fIjavadoc\fRコマンドの実行で、複数の\fI\-link\fRオプションを指定できます。Javadoc 1\&.2\&.2より前では、\fI\-linkfile\fRオプションは1回しか指定できませんでした。 -.RE -.RE -外部ドキュメントへの絶対リンク.PP -http://docs\&.oracle\&.com/javase/8/docs/api/index\&.htmlに示すような、\fIjava\&.lang\fR、 -\fIjava\&.io\fRおよびその他のJava SEパッケージにリンクする必要がある場合があります。 +\fBpackagelistLoc\fRの値は、外部ドキュメントのpackage\-listファイルを含むディレクトリへのパスまたはURLです。これは、URL (http:またはfile:)でもファイル・パスでもかまいません。また、絶対パスと相対パスのどちらでもかまいません。相対パスの場合は、\fBjavadoc\fRコマンドが実行される現在のディレクトリからの相対パスとして指定します。package\-listファイル名を含めないでください。 +.sp +指定した\fBjavadoc\fRコマンドの実行で、複数の\fB\-link\fRオプションを指定できます。Javadoc 1\&.2\&.2より前では、\fB\-linkfile\fRオプションは1回しか指定できませんでした。 +.RE +.RE +.PP +外部ドキュメントへの絶対リンク +.PP +http://docs\&.oracle\&.com/javase/8/docs/api/index\&.htmlに示すような、\fBjava\&.lang\fR、 +\fBjava\&.io\fRおよびその他のJava SEパッケージにリンクする必要がある場合があります。 .PP ただし、シェルにはWebアクセス権がありません。この場合、次を行います。 .sp @@ -2880,78 +2992,91 @@ .sp -1 .IP " 2." 4.2 .\} -ファイルをローカル・ディレクトリに保存し、このローカル・コピーを第2引数\fIpackagelistLoc\fRで指定します。この例では、パッケージ・リスト・ファイルはカレント・ディレクトリ(\&.)に保存されています。 -.RE -.PP -次のコマンドは、Java SEプラットフォーム・パッケージへのリンクを持つc\fIom\&.mypackage\fRパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス\fItrees\fR内の\fIObject\fRクラスへのリンクが含まれています。\fI\-sourcepath\fRなど、他の必要なオプションは表示されません。 +ファイルをローカル・ディレクトリに保存し、このローカル・コピーを第2引数\fBpackagelistLoc\fRで指定します。この例では、パッケージ・リスト・ファイルはカレント・ディレクトリ(\&.)に保存されています。 +.RE +.PP +次のコマンドは、Java SEプラットフォーム・パッケージへのリンクを持つc\fBom\&.mypackage\fRパッケージのドキュメントを生成します。生成ドキュメントには、たとえばクラス\fBtrees\fR内の\fBObject\fRクラスへのリンクが含まれています。\fB\-sourcepath\fRなど、他の必要なオプションは表示されません。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-linkoffline http://docs\&.oracle\&.com/javase/8/docs/api/ \&. com\&.mypackage +\fBjavadoc \-linkoffline http://docs\&.oracle\&.com/javase/8/docs/api/ \&. com\&.mypackage \fR + .fi .if n \{\ .RE .\} -外部ドキュメントへの相対リンク.PP -\fI\-linkoffline\fRを相対パスとともに使用することはあまりありません。理由は単純で、通常は\fI\-link\fRで間に合うからです。\fI\-linkoffline\fRオプションを使用する場合、通常、package\-listファイルはローカルで、相対リンクを使用する場合はリンク先のファイルもローカルなので、通常は\fI\-linkoffline\fRオプションの2つの引数に、異なるパスを指定する必要はありません。2つの引数が同一の場合、\fI\-link\fRオプションを使用できます。 -package\-listファイルの手動での作成.PP -package\-listファイルがまだ存在しなくても、ドキュメントのリンク先のパッケージ名がわかっている場合は、このファイルのコピーを手動で作成し、\fIpackagelistLoc\fRでそのパスを指定することができます。\fIcom\&.apipackage\fRが最初に生成された時点で\fIcom\&.spipackage\fRのパッケージ・リストが存在しないという前出のケースが一例として挙げられます。この方法は、パッケージ名はわかっているものの、まだ公開されていない、新しい外部ドキュメントにリンクするドキュメントを生成する必要がある場合に便利です。また、package\-listファイルが生成されないJavadoc 1\&.0または1\&.1で生成されたパッケージ用にpackage\-listファイルを作成する場合にも、この方法が使用できます。同様に、2つの企業が未公開のpackage\-listファイルを共有できるため、クロスリンクを設定したドキュメントを同時にリリースすることも可能になります。 -複数ドキュメントへのリンク.PP -参照先の生成ドキュメントごとに1回、\fI\-linkoffline\fRオプションを含めることができます。 +.PP +外部ドキュメントへの相対リンク +.PP +\fB\-linkoffline\fRを相対パスとともに使用することはあまりありません。理由は単純で、通常は\fB\-link\fRで間に合うからです。\fB\-linkoffline\fRオプションを使用する場合、通常、package\-listファイルはローカルで、相対リンクを使用する場合はリンク先のファイルもローカルなので、通常は\fB\-linkoffline\fRオプションの2つの引数に、異なるパスを指定する必要はありません。2つの引数が同一の場合、\fB\-link\fRオプションを使用できます。 +.PP +package\-listファイルの手動での作成 +.PP +package\-listファイルがまだ存在しなくても、ドキュメントのリンク先のパッケージ名がわかっている場合は、このファイルのコピーを手動で作成し、\fBpackagelistLoc\fRでそのパスを指定することができます。\fBcom\&.apipackage\fRが最初に生成された時点で\fBcom\&.spipackage\fRのパッケージ・リストが存在しないという前出のケースが一例として挙げられます。この方法は、パッケージ名はわかっているものの、まだ公開されていない、新しい外部ドキュメントにリンクするドキュメントを生成する必要がある場合に便利です。また、package\-listファイルが生成されないJavadoc 1\&.0または1\&.1で生成されたパッケージ用にpackage\-listファイルを作成する場合にも、この方法が使用できます。同様に、2つの企業が未公開のpackage\-listファイルを共有できるため、クロスリンクを設定したドキュメントを同時にリリースすることも可能になります。 +.PP +複数ドキュメントへのリンク +.PP +参照先の生成ドキュメントごとに1回、\fB\-linkoffline\fRオプションを含めることができます。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-linkoffline extdocURL1 packagelistLoc1 \-linkoffline extdocURL2 -packagelistLoc2 \&.\&.\&. +\fBjavadoc \-linkoffline extdocURL1 packagelistLoc1 \-linkoffline extdocURL2\fR +\fBpackagelistLoc2 \&.\&.\&.\fR + .fi .if n \{\ .RE .\} -ドキュメントの更新.PP -プロジェクトに何十または何百のパッケージが含まれる場合にも、\fI\-linkoffline\fRオプションを使用できます。ソース・ツリー全体ですでに\fIjavadoc\fRコマンドを実行したことがある場合、ドキュメンテーション・コメントにわずかな変更を迅速に加え、ソース・ツリーの一部で\fIjavadoc\fRコマンドを再実行することができます。2回目の実行は、ドキュメンテーション・コメントを変更し、宣言は変更しない場合にのみ正しく処理されることに注意してください。ソース・コードに対して宣言を追加、削除、または変更した場合は、索引、パッケージ・ツリー、継承されるメンバーのリスト、使用ページなどの場所で、リンクが壊れることがあります。 -.PP -まず、この新しい小規模な実行で使用する、新しい生成先ディレクトリ(updateなど)を作成します。この例では、元の生成先ディレクトリの名前はhtmlです。最も単純な例では、htmlディレクトリの親ディレクトリに移動します。\fI\-linkoffline\fRオプションの第1引数にカレント・ディレクトリ(\&.)を設定し、第2引数にpackage\-listが検索されるhtmlへの相対パスを設定し、更新するパッケージのパッケージ名のみを渡します。 +.PP +ドキュメントの更新 +.PP +プロジェクトに何十または何百のパッケージが含まれる場合にも、\fB\-linkoffline\fRオプションを使用できます。ソース・ツリー全体ですでに\fBjavadoc\fRコマンドを実行したことがある場合、ドキュメンテーション・コメントにわずかな変更を迅速に加え、ソース・ツリーの一部で\fBjavadoc\fRコマンドを再実行することができます。2回目の実行は、ドキュメンテーション・コメントを変更し、宣言は変更しない場合にのみ正しく処理されることに注意してください。ソース・コードに対して宣言を追加、削除、または変更した場合は、索引、パッケージ・ツリー、継承されるメンバーのリスト、使用ページなどの場所で、リンクが壊れることがあります。 +.PP +まず、この新しい小規模な実行で使用する、新しい生成先ディレクトリ(updateなど)を作成します。この例では、元の生成先ディレクトリの名前はhtmlです。最も単純な例では、htmlディレクトリの親ディレクトリに移動します。\fB\-linkoffline\fRオプションの第1引数にカレント・ディレクトリ(\&.)を設定し、第2引数にpackage\-listが検索されるhtmlへの相対パスを設定し、更新するパッケージのパッケージ名のみを渡します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d update \-linkoffline \&. html com\&.mypackage +\fBjavadoc \-d update \-linkoffline \&. html com\&.mypackage\fR + .fi .if n \{\ .RE .\} .PP -\fIjavadoc\fRコマンドの終了後、update/com/package内の生成されたクラスのページをコピーし(概要や索引は除く)、html/com/package内の元のファイルに上書きします。 +\fBjavadoc\fRコマンドの終了後、update/com/package内の生成されたクラスのページをコピーし(概要や索引は除く)、html/com/package内の元のファイルに上書きします。 .PP \-linksource .RS 4 各ソース・ファイル(行番号付き)のHTMLバージョンを作成し、標準HTMLドキュメントからソース・ファイルへのリンクを追加します。リンクは、ソース・ファイル内に宣言されているクラス、インタフェース、コンストラクタ、メソッド、フィールドに対して作成されます。そうでない場合、たとえばデフォルト・コンストラクタや生成されたクラスに対しては、リンクは作成されません。 .sp -このオプションは、\fI\-public\fR、\fI\-package\fR、\fI\-protected\fRおよび\fI\-private\fRの各オプションとは関係なく、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソース・ファイル内のすべての非公開実装の詳細を公開します。\fI\-private\fRオプションもあわせて指定しないかぎり、非公開のクラスやインタフェースの一部には、リンクを介してアクセスできないことがあります。 -.sp -各リンクは、その宣言内の識別子名の上に作成されます。たとえば、\fIButton\fRクラスのソース・コードへのリンクは、\fIButton\fRという語の上に作成されます。 +このオプションは、\fB\-public\fR、\fB\-package\fR、\fB\-protected\fRおよび\fB\-private\fRの各オプションとは関係なく、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソース・ファイル内のすべての非公開実装の詳細を公開します。\fB\-private\fRオプションもあわせて指定しないかぎり、非公開のクラスやインタフェースの一部には、リンクを介してアクセスできないことがあります。 +.sp +各リンクは、その宣言内の識別子名の上に作成されます。たとえば、\fBButton\fRクラスのソース・コードへのリンクは、\fBButton\fRという語の上に作成されます。 .sp .if n \{\ .RS 4 .\} .nf -public class Button extends Component implements Accessible +\fBpublic class Button extends Component implements Accessible\fR + .fi .if n \{\ .RE .\} -\fIButton\fRクラスの\fIgetLabel\fRメソッドのソース・コードへのリンクは、\fIgetLabel\fRという語の上に作成されます。 +\fBButton\fRクラスの\fBgetLabel\fRメソッドのソース・コードへのリンクは、\fBgetLabel\fRという語の上に作成されます。 .sp .if n \{\ .RS 4 .\} .nf -public String getLabel() +\fBpublic String getLabel()\fR + .fi .if n \{\ .RE @@ -2960,7 +3085,7 @@ .PP \-group groupheading \fIpackagepattern:packagepattern\fR .RS 4 -概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の\fI\-group\fRオプションで指定します。グループは、コマンド行で指定された順序でページに表示されます。パッケージは、グループ内でアルファベット順になっています。指定した\fI\-group\fRオプションでは、\fIpackagepattern\fR式のリストに一致するパッケージが、見出しとして\fIgroupheading\fRを持つ1つの表に表示されます。 +概要ページの複数のパッケージを、指定したグループに分けて、グループごとに表を作成します。各グループは、それぞれ別の\fB\-group\fRオプションで指定します。グループは、コマンド行で指定された順序でページに表示されます。パッケージは、グループ内でアルファベット順になっています。指定した\fB\-group\fRオプションでは、\fBpackagepattern\fR式のリストに一致するパッケージが、見出しとして\fIgroupheading\fRを持つ1つの表に表示されます。 .sp .RS 4 .ie n \{\ @@ -2970,7 +3095,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIgroupheading\fRには、任意のテキストを指定でき、空白を含めることができます。指定したテキストは、グループの表見出しになります。 +\fBgroupheading\fRには、任意のテキストを指定でき、空白を含めることができます。指定したテキストは、グループの表見出しになります。 .RE .sp .RS 4 @@ -2981,54 +3106,55 @@ .sp -1 .IP \(bu 2.3 .\} -\fIpackagepattern\fRの値には、任意のパッケージ名の先頭部分とそれに続く1つのアスタリスク(*)で任意のパッケージ名を指定できます。アスタリスクは使用できる唯一のワイルドカードで、任意の文字に一致する、という意味です。1つのグループには、コロン(:)で区切って複数のパターンを含めることができます。パターンまたはパターン・リストでアスタリスクを使用する場合、パターン・リストは\fI"java\&.lang*:java\&.util"\fRのように引用符で囲む必要があります。 -.RE -.sp -\fI\-group\fRオプションを指定しない場合は、見出し\fIPackages\fRおよび適切な小見出しを持つ1つのグループに配置されます。小見出しにすべてのドキュメント化されるパッケージ(すべてのグループ)が含まれるわけではない場合、残りのパッケージは「その他のパッケージ」というサブ見出しを持つ独立したグループに入れられます。 -.sp -たとえば、次の\fIjavadoc\fRコマンドでは、3つのドキュメント化されたパッケージが\fI「コア」\fR、\fI「拡張」\fRおよび\fI「その他のパッケージ」\fRに分けられます。\fIjava\&.lang*\fRでは、最後のドット(\&.)を指定していません。\fIjava\&.lang\&.*\fRのようにドットを入れると、\fI java\&.lang\fRパッケージは除外されることになります。 +\fBpackagepattern\fRの値には、任意のパッケージ名の先頭部分とそれに続く1つのアスタリスク(*)で任意のパッケージ名を指定できます。アスタリスクは使用できる唯一のワイルドカードで、任意の文字に一致する、という意味です。1つのグループには、コロン(:)で区切って複数のパターンを含めることができます。パターンまたはパターン・リストでアスタリスクを使用する場合、パターン・リストは\fB"java\&.lang*:java\&.util"\fRのように引用符で囲む必要があります。 +.RE +.sp +\fB\-group\fRオプションを指定しない場合は、見出し\fIPackages\fRおよび適切な小見出しを持つ1つのグループに配置されます。小見出しにすべてのドキュメント化されるパッケージ(すべてのグループ)が含まれるわけではない場合、残りのパッケージは「その他のパッケージ」というサブ見出しを持つ独立したグループに入れられます。 +.sp +たとえば、次の\fBjavadoc\fRコマンドでは、3つのドキュメント化されたパッケージが\fI「コア」\fR、\fI「拡張」\fRおよび\fI「その他のパッケージ」\fRに分けられます。\fBjava\&.lang*\fRでは、最後のドット(\&.)を指定していません。\fBjava\&.lang\&.*\fRのようにドットを入れると、\fB java\&.lang\fRパッケージは除外されることになります。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-group "Core Packages" "java\&.lang*:java\&.util" - \-group "Extension Packages" "javax\&.*" - java\&.lang java\&.lang\&.reflect java\&.util javax\&.servlet java\&.new +\fBjavadoc \-group "Core Packages" "java\&.lang*:java\&.util"\fR +\fB \-group "Extension Packages" "javax\&.*"\fR +\fB java\&.lang java\&.lang\&.reflect java\&.util javax\&.servlet java\&.new\fR + .fi .if n \{\ .RE .\} \fBコア・パッケージ\fR .sp -\fIjava\&.lang\fR -.sp -\fIjava\&.lang\&.reflect\fR -.sp -\fIjava\&.util\fR +\fBjava\&.lang\fR +.sp +\fBjava\&.lang\&.reflect\fR +.sp +\fBjava\&.util\fR .sp \fB拡張機能パッケージ\fR .sp -\fIjavax\&.servlet\fR +\fBjavax\&.servlet\fR .sp \fBOther Packages\fR .sp -\fIjava\&.new\fR +\fBjava\&.new\fR .RE .PP \-nodeprecated .RS 4 -非推奨のAPIをドキュメントに生成しないようにします。このオプションを指定すると、\fI\-nodeprecatedlist\fRオプションを指定した場合と同じ効果があり、ドキュメントの他の部分全体でも、非推奨のAPIが生成されません。このオプションは、コードを記述しているとき、非推奨のコードによって気を散らされたくない場合に便利です。 +非推奨のAPIをドキュメントに生成しないようにします。このオプションを指定すると、\fB\-nodeprecatedlist\fRオプションを指定した場合と同じ効果があり、ドキュメントの他の部分全体でも、非推奨のAPIが生成されません。このオプションは、コードを記述しているとき、非推奨のコードによって気を散らされたくない場合に便利です。 .RE .PP \-nodeprecatedlist .RS 4 -非推奨のAPIのリストを含むファイル(deprecated\-list\&.html)、およびナビゲーション・バーのそのページへのリンクが生成されないようにします。\fIjavadoc\fRコマンドでは、引き続き、ドキュメントの他の部分では、非推奨のAPIが生成されます。このオプションは、非推奨のAPIがソース・コードに含まれておらず、ナビゲーション・バーをすっきりと見せる場合に便利です。 +非推奨のAPIのリストを含むファイル(deprecated\-list\&.html)、およびナビゲーション・バーのそのページへのリンクが生成されないようにします。\fBjavadoc\fRコマンドでは、引き続き、ドキュメントの他の部分では、非推奨のAPIが生成されます。このオプションは、非推奨のAPIがソース・コードに含まれておらず、ナビゲーション・バーをすっきりと見せる場合に便利です。 .RE .PP \-nosince .RS 4 -生成ドキュメントから、\fI@since\fRタグに関連付けられた\fI「導入されたバージョン」\fRセクションを省略します。 +生成ドキュメントから、\fB@since\fRタグに関連付けられた\fB「導入されたバージョン」\fRセクションを省略します。 .RE .PP \-notree @@ -3048,18 +3174,19 @@ .PP \-nonavbar .RS 4 -通常、生成されるページの最上部と最下部に表示されるナビゲーション・バー、ヘッダー、およびフッターを生成しないようにします。\fI\-nonavbar\fRオプションは\fI\-bottom\fRオプションに影響を与えません。\fI\-nonavbar\fRオプションは、印刷するためにのみファイルをPostScriptやPDFに変換する場合など、内容のみが重要で、ナビゲーションの必要がない場合に便利です。 +通常、生成されるページの最上部と最下部に表示されるナビゲーション・バー、ヘッダー、およびフッターを生成しないようにします。\fB\-nonavbar\fRオプションは\fB\-bottom\fRオプションに影響を与えません。\fB\-nonavbar\fRオプションは、印刷するためにのみファイルをPostScriptやPDFに変換する場合など、内容のみが重要で、ナビゲーションの必要がない場合に便利です。 .RE .PP \-helpfile \fIpath\efilename\fR .RS 4 -最上部および最下部のナビゲーション・バーの「ヘルプ」リンクのリンク先となる代替ヘルプ・ファイルpath\efilenameのパスを指定します。このオプションが指定されていないと、\fIjavadoc\fRコマンドは、\fIjavadoc\fRコマンド内でハードコードされているヘルプ・ファイルhelp\-doc\&.htmlを自動作成します。このオプションを使用すると、デフォルトをオーバーライドできます。ファイル名にはどんな名前でも指定でき、help\-doc\&.htmlに限定されません。\fIjavadoc\fRコマンドは、次の例のように、ナビゲーション・バー内のリンクを必要に応じて調整します。 +最上部および最下部のナビゲーション・バーの「ヘルプ」リンクのリンク先となる代替ヘルプ・ファイルpath\efilenameのパスを指定します。このオプションが指定されていないと、\fBjavadoc\fRコマンドは、\fBjavadoc\fRコマンド内でハードコードされているヘルプ・ファイルhelp\-doc\&.htmlを自動作成します。このオプションを使用すると、デフォルトをオーバーライドできます。ファイル名にはどんな名前でも指定でき、help\-doc\&.htmlに限定されません。\fBjavadoc\fRコマンドは、次の例のように、ナビゲーション・バー内のリンクを必要に応じて調整します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-helpfile /home/user/myhelp\&.html java\&.awt\&. +\fBjavadoc \-helpfile /home/user/myhelp\&.html java\&.awt\&.\fR + .fi .if n \{\ .RE @@ -3068,13 +3195,14 @@ .PP \-stylesheet \fIpath/filename \fR .RS 4 -代替HTMLスタイルシート・ファイルのパスを指定します。このオプションが指定されていないと、\fIjavadoc\fRコマンドは、\fIjavadoc\fRコマンド内でハードコードされているスタイルシート・ファイルstylesheet\&.cssを自動作成します。このオプションを使用すると、デフォルトをオーバーライドできます。ファイル名にはどんな名前でも指定でき、stylesheet\&.cssに限定されません。 +代替HTMLスタイルシート・ファイルのパスを指定します。このオプションが指定されていないと、\fBjavadoc\fRコマンドは、\fBjavadoc\fRコマンド内でハードコードされているスタイルシート・ファイルstylesheet\&.cssを自動作成します。このオプションを使用すると、デフォルトをオーバーライドできます。ファイル名にはどんな名前でも指定でき、stylesheet\&.cssに限定されません。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-stylesheet file /home/user/mystylesheet\&.css com\&.mypackage +\fBjavadoc \-stylesheet file /home/user/mystylesheet\&.css com\&.mypackage\fR + .fi .if n \{\ .RE @@ -3083,7 +3211,7 @@ .PP \-serialwarn .RS 4 -\fI@serial\fRタグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1\&.2\&.2以降では、直列化の警告は生成されません。以前のリリースとは逆の動作です。このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと\fIwriteExternal\fRメソッドを適切にドキュメント化するのに役立ちます。 +\fB@serial\fRタグがない場合は、コンパイル時に警告を生成します。デフォルトでは、Javadoc 1\&.2\&.2以降では、直列化の警告は生成されません。以前のリリースとは逆の動作です。このオプションを使用すると、直列化の警告が表示されるので、デフォルトの直列化可能フィールドと\fBwriteExternal\fRメソッドを適切にドキュメント化するのに役立ちます。 .RE .PP \-charset \fIname\fR @@ -3091,18 +3219,19 @@ このドキュメント用のHTML文字セットを指定します。この名前は、IANA RegistryのCharacter Sets (http://www\&.iana\&.org/assignments/character\-sets)に示された、優先MIME名である必要があります。 .sp -たとえば、\fIjavadoc \-charset "iso\-8859\-1" mypackage\fRは次の行を生成された各ページのヘッダーに挿入します。 +たとえば、\fBjavadoc \-charset "iso\-8859\-1" mypackage\fRは次の行を生成された各ページのヘッダーに挿入します。 .sp .if n \{\ .RS 4 .\} .nf -<META http\-equiv="Content\-Type" content="text/html; charset=ISO\-8859\-1"> +\fB<META http\-equiv="Content\-Type" content="text/html; charset=ISO\-8859\-1">\fR + .fi .if n \{\ .RE .\} -この\fIMETA\fRタグは、HTML標準(4197265および4137321)のHTML Document Representation +この\fBMETA\fRタグは、HTML標準(4197265および4137321)のHTML Document Representation (http://www\&.w3\&.org/TR/REC\-html40/charset\&.html#h\-5\&.2\&.2)に記載されています。 .sp およびオプションも参照してください。 @@ -3113,22 +3242,23 @@ 生成されるHTMLファイルのエンコーディングを指定します。この名前は、IANA RegistryのCharacter Sets (http://www\&.iana\&.org/assignments/character\-sets)に示された、優先MIME名である必要があります。 .sp -\fI\-docencoding\fRオプションを省略し、\fI\-encoding\fRオプションを使用すると、生成されたHTMLファイルの暗号化は\fI\-encoding\fRオプションで特定されます。例: -\fIjavadoc \-docencoding"iso\-8859\-1" mypackage\fRおよびオプションも参照してください。 +\fB\-docencoding\fRオプションを省略し、\fB\-encoding\fRオプションを使用すると、生成されたHTMLファイルの暗号化は\fB\-encoding\fRオプションで特定されます。例: +\fBjavadoc \-docencoding "iso\-8859\-1" mypackage\fRおよびオプションも参照してください。 .RE .PP \-keywords .RS 4 -HTMLキーワード<META>タグを、クラスごとに生成されるファイルに追加します。これらのタグは、<META>タグを検索するサーチ・エンジンがページを見つける場合に役立ちます。インターネット全体を検索する検索エンジンのほとんどは<META>タグを参照しません。ページが誤用している可能性があるからです。自身のWebサイトへの検索を制限する、企業により提供される検索エンジンは、<META>タグを参照することで恩恵を受けることができます。<META>タグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス\fIString\fRは次のキーワードで開始します。 +HTMLキーワード<META>タグを、クラスごとに生成されるファイルに追加します。これらのタグは、<META>タグを検索するサーチ・エンジンがページを見つける場合に役立ちます。インターネット全体を検索する検索エンジンのほとんどは<META>タグを参照しません。ページが誤用している可能性があるからです。自身のWebサイトへの検索を制限する、企業により提供される検索エンジンは、<META>タグを参照することで恩恵を受けることができます。<META>タグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス\fBString\fRは次のキーワードで開始します。 .sp .if n \{\ .RS 4 .\} .nf -<META NAME="keywords" CONTENT="java\&.lang\&.String class"> -<META NAME="keywords" CONTENT="CASE_INSENSITIVE_ORDER"> -<META NAME="keywords" CONTENT="length()"> -<META NAME="keywords" CONTENT="charAt()"> +\fB<META NAME="keywords" CONTENT="java\&.lang\&.String class">\fR +\fB<META NAME="keywords" CONTENT="CASE_INSENSITIVE_ORDER">\fR +\fB<META NAME="keywords" CONTENT="length()">\fR +\fB<META NAME="keywords" CONTENT="charAt()">\fR + .fi .if n \{\ .RE @@ -3137,105 +3267,108 @@ .PP \-tag \fItagname\fR:Xaoptcmf:"\fItaghead\fR" .RS 4 -\fIjavadoc\fRコマンドがドキュメンテーション・コメント内の引数を1つ取る単純なカスタム・ブロック・タグ\fI@tagname\fRを解釈できるようにします。これにより、\fIjavadoc\fRコマンドはタグ名のスペルチェックを行うことができるので、ソース・コード内に存在するすべてのカスタム・タグについて、\fI\-tag\fRオプションを組み込むことが重要です。今回の実行では出力されないタグは、\fIX\fRを付けて無効にします。\fI\-tag\fRオプションは、タグの見出し\fItaghead\fRを太字で出力します。その次の行には、このオプションの1つの引数で指定したテキストが続きます。ブロック・タグと同様、この引数のテキストにはインライン・タグを含めることができます。このインライン・タグも解釈されます。出力は、引数を1つ取る標準のタグ(\fI@return\fRや\fI@author\fRなど)の出力とよく似ています。\fItaghead\fRの値を省略すると、\fItagname\fRが見出しとして表示されます。 +\fBjavadoc\fRコマンドがドキュメンテーション・コメント内の引数を1つ取る単純なカスタム・ブロック・タグ\fB@tagname\fRを解釈できるようにします。これにより、\fBjavadoc\fRコマンドはタグ名のスペルチェックを行うことができるので、ソース・コード内に存在するすべてのカスタム・タグについて、\fB\-tag\fRオプションを組み込むことが重要です。今回の実行では出力されないタグは、\fBX\fRを付けて無効にします。\fB\-tag\fRオプションは、タグの見出し\fItaghead\fRを太字で出力します。その次の行には、このオプションの1つの引数で指定したテキストが続きます。ブロック・タグと同様、この引数のテキストにはインライン・タグを含めることができます。このインライン・タグも解釈されます。出力は、引数を1つ取る標準のタグ(\fB@return\fRや\fB@author\fRなど)の出力とよく似ています。\fItaghead\fRの値を省略すると、\fBtagname\fRが見出しとして表示されます。 .sp \fBタグの配置\fR: -\fIXaoptcmf\fR引数により、ソース・コード内でタグを配置できる場所が決まり、タグを無効にできるかどうか(\fIX\fRを使用して)が決まります。タグの配置位置を制限しない場合は\fIa\fRを指定します。それ以外の文字の組合せも可能です。 -.sp -\fIX\fR +\fBXaoptcmf\fR引数により、ソース・コード内でタグを配置できる場所が決まり、タグを無効にできるかどうか(\fBX\fRを使用して)が決まります。タグの配置位置を制限しない場合は\fBa\fRを指定します。それ以外の文字の組合せも可能です。 +.sp +\fBX\fR (タグの無効化) .sp -\fIa\fR +\fBa\fR (すべて) .sp -\fIo\fR +\fBo\fR (概要) .sp -\fIp\fR +\fBp\fR (パッケージ) .sp -\fIt\fR +\fBt\fR (タイプ、つまりクラスとインタフェース) .sp -\fIc\fR +\fBc\fR (コンストラクタ) .sp -\fIm\fR +\fBm\fR (メソッド) .sp -\fIf\fR +\fBf\fR (フィールド) .sp -\fBシングル・タグの例\fR: ソース・コード内の任意の位置で使用できるタグのタグ・オプションの例を示します。\fI\-tag todo:a:"To Do:"\fR -.sp -\fI@todo\fRタグをコンストラクタ、メソッドおよびフィールドとのみ使用する場合、\fI\-tag todo:cmf:"To Do:"\fRを使用します。 -.sp -最後のコロン(:)は、パラメータ区切り文字ではなく、見出しテキストの一部になっています。\fI@todo\fRタグを含む、ソース・コード用のいずれかのタグ・オプションを使用します。たとえば、\fI@todo The documentation for this method needs work\fRです。 -.sp -\fBタグ名内のコロン\fR: タグ名内でコロンを使用する場合はバックスラッシュを使用してエスケープします。次のドキュメンテーション・コメントには、\fI\-tag ejb\e\e:bean:a:"EJB Bean:"\fRオプションを使用します。 +\fBシングル・タグの例\fR: ソース・コード内の任意の位置で使用できるタグのタグ・オプションの例を示します。\fB\-tag todo:a:"To Do:"\fR +.sp +\fB@todo\fRタグをコンストラクタ、メソッドおよびフィールドとのみ使用する場合、\fB\-tag todo:cmf:"To Do:"\fRを使用します。 +.sp +最後のコロン(:)は、パラメータ区切り文字ではなく、見出しテキストの一部になっています。\fB@todo\fRタグを含む、ソース・コード用のいずれかのタグ・オプションを使用します。たとえば、\fB@todo The documentation for this method needs work\fRです。 +.sp +\fBタグ名内のコロン\fR: タグ名内でコロンを使用する場合はバックスラッシュを使用してエスケープします。次のドキュメンテーション・コメントには、\fB\-tag ejb\e\e:bean:a:"EJB Bean:"\fRオプションを使用します。 .sp .if n \{\ .RS 4 .\} .nf -/** - * @ejb:bean - */ +\fB/**\fR +\fB * @ejb:bean\fR +\fB */\fR + .fi .if n \{\ .RE .\} -\fBタグ名のスペルチェック\fR: 一部の開発者が必ずしも出力しないカスタム・タグをソース・コード内に配置することがあります。この場合、ソース・コード内のすべてのタグをリストし、出力するタグを有効にし、出力しないタグを無効にする必要があります。\fIX\fRを指定するとタグは無効になります。指定しないと、タグは有効になります。これにより、\fIjavadoc\fRコマンドは、検出したタグが入力ミスなどによる不明タグであるかどうかを特定できます。このような場合に、\fIjavadoc\fRコマンドから警告が出力されます。すでに配置されている値に\fIX\fRを追加できます。こうしておけば、\fIX\fRを削除するのみでタグを有効にすることができます。たとえば、\fI@todo\fRタグを出力で抑制する場合、\fI\-tag todo:Xcmf:"To Do:"\fRを使用します。さらに簡単にする場合、\fI\-tag todo:X\fRを使用します。構文\fI\-tag todo:X\fRは、\fI@todo\fRタグがタグレットで定義されていても機能します。 +\fBタグ名のスペルチェック\fR: 一部の開発者が必ずしも出力しないカスタム・タグをソース・コード内に配置することがあります。この場合、ソース・コード内のすべてのタグをリストし、出力するタグを有効にし、出力しないタグを無効にする必要があります。\fBX\fRを指定するとタグは無効になります。指定しないと、タグは有効になります。これにより、\fBjavadoc\fRコマンドは、検出したタグが入力ミスなどによる不明タグであるかどうかを特定できます。このような場合に、\fBjavadoc\fRコマンドから警告が出力されます。すでに配置されている値に\fBX\fRを追加できます。こうしておけば、\fBX\fRを削除するのみでタグを有効にすることができます。たとえば、\fB@todo\fRタグを出力で抑制する場合、\fB\-tag todo:Xcmf:"To Do:"\fRを使用します。さらに簡単にする場合、\fB\-tag todo:X\fRを使用します。構文\fB\-tag todo:X\fRは、\fB@todo\fRタグがタグレットで定義されていても機能します。 .sp \fBタグの順序\fR: -\fI\-ta\fR\fIg\fRおよび\fI\-taglet\fRオプションの順序によって、タグの出力順が決まります。カスタム・タグと標準タグを組み合せて使用することもできます。標準タグのタグ・オプションは、順序を決定するためだけのプレースホルダです。標準タグの名前のみを取ります。標準タグの小見出しは変更できません。これを次の例に示します。\fI\-tag\fRオプションを指定しないと、\fI\-tagle\fR\fIt\fRオプションの位置により、順序が決まります。タグが両方とも存在する場合、コマンドラインの最後にある方がその順序を決定します。これは、タグやタグレットがコマンドラインに指定された順番に処理されるためです。たとえば、\fI\-taglet\fRおよび\fI\-tag\fRオプションが名前\fItodo\fR値を持つ場合、コマンドラインに最後に指定されたものが順序を決定します。 -.sp -\fBタグの完全セットの例\fR: この例では、出力のParametersとThrowsの間にTo Doを挿入します。\fIX\fRを使用して、\fI@example\fRタグが、ソース・コード内の今回の実行では出力されないタグであることも指定します。\fI@argfile\fRタグを使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます(行の継続を示す文字は不要)。 +\fB\-ta\fR\fBg\fRおよび\fB\-taglet\fRオプションの順序によって、タグの出力順が決まります。カスタム・タグと標準タグを組み合せて使用することもできます。標準タグのタグ・オプションは、順序を決定するためだけのプレースホルダです。標準タグの名前のみを取ります。標準タグの小見出しは変更できません。これを次の例に示します。\fB\-tag\fRオプションを指定しないと、\fB\-tagle\fR\fBt\fRオプションの位置により、順序が決まります。タグが両方とも存在する場合、コマンド行の最後にある方がその順序を決定します。これは、タグやタグレットがコマンド行に指定された順番に処理されるためです。たとえば、\fB\-taglet\fRおよび\fB\-tag\fRオプションが名前\fBtodo\fR値を持つ場合、コマンド行に最後に指定されたものが順序を決定します。 +.sp +\fBタグの完全セットの例\fR: この例では、出力のParametersとThrowsの間にTo Doを挿入します。\fBX\fRを使用して、\fB@example\fRタグが、ソース・コード内の今回の実行では出力されないタグであることも指定します。\fB@argfile\fRタグを使用する場合は、次のように、引数ファイル内の別々の行にタグを配置できます(行の継続を示す文字は不要)。 .sp .if n \{\ .RS 4 .\} .nf -\-tag param -\-tag return -\-tag todo:a:"To Do:" -\-tag throws -\-tag see -\-tag example:X +\fB\-tag param\fR +\fB\-tag return\fR +\fB\-tag todo:a:"To Do:"\fR +\fB\-tag throws\fR +\fB\-tag see\fR +\fB\-tag example:X\fR + .fi .if n \{\ .RE .\} -\fIjavadoc\fRコマンドがドキュメンテーション・コメントを解析する際に検索されたタグのうち、標準タグでも、\fI\-tag\fRや\fI\-taglet\fRオプションで渡されたタグでもないものはすべて不明タグとみなされ、警告がスローされます。 -.sp -標準タグは、最初、デフォルトの順序でリスト内に内部的に格納されます。\fI\-tag\fRオプションを使用すると、それらのタグはこのリストに追加されます。標準タグは、デフォルトの位置から移動されます。そのため、標準タグの\fI\-tag\fRオプションを省略すると、それはデフォルトの位置に配置されたままになります。 -.sp -\fB競合の回避\fR: 固有の名前空間を作成するには、パッケージに使用されている\fIcom\&.mycompany\&.todo\fRという名前のように、ドットで区切られた名前を使用します。Oracleは、今後も名前にドットを含まない標準タグを作成します。ユーザーが作成したタグは、Oracleが定義する同じ名前のタグの動作をオーバーライドします。\fI@todo\fRという名前のタグまたはタグレットをユーザーが作成した場合、その後にOracleが同じ名前の標準タグを作成しても、そのタグまたはタグレットは常にユーザーが定義したのと同じ動作を保持します。 +\fBjavadoc\fRコマンドがドキュメンテーション・コメントを解析する際に検索されたタグのうち、標準タグでも、\fB\-tag\fRや\fB\-taglet\fRオプションで渡されたタグでもないものはすべて不明タグとみなされ、警告がスローされます。 +.sp +標準タグは、最初、デフォルトの順序でリスト内に内部的に格納されます。\fB\-tag\fRオプションを使用すると、それらのタグはこのリストに追加されます。標準タグは、デフォルトの位置から移動されます。そのため、標準タグの\fB\-tag\fRオプションを省略すると、それはデフォルトの位置に配置されたままになります。 +.sp +\fB競合の回避\fR: 固有の名前空間を作成するには、パッケージに使用されている\fBcom\&.mycompany\&.todo\fRという名前のように、ドットで区切られた名前を使用します。Oracleは、今後も名前にドットを含まない標準タグを作成します。ユーザーが作成したタグは、Oracleが定義する同じ名前のタグの動作をオーバーライドします。\fB@todo\fRという名前のタグまたはタグレットをユーザーが作成した場合、その後にOracleが同じ名前の標準タグを作成しても、そのタグまたはタグレットは常にユーザーが定義したのと同じ動作を保持します。 .sp \fB注釈vs\&. Javadocタグ\fR: 一般に、追加する必要のあるマークアップが、ドキュメントに影響を与えたりドキュメントを生成したりするためのものである場合、そのマークアップはJavadocタグにします。それ以外の場合は注釈にします。JavadocツールでのDocコメントの記述方法のカスタム・タグと注釈に関する項 (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137868\&.html#annotations)を参照してください。 .sp -\fI\-taglet\fRオプションを使用して、より複雑なブロック・タグやカスタム・インライン・タグも作成できます。 +\fB\-taglet\fRオプションを使用して、より複雑なブロック・タグやカスタム・インライン・タグも作成できます。 .RE .PP \-taglet \fIclass\fR .RS 4 -そのタグのドキュメントの生成に使用するドックレットを起動するためのクラス・ファイルを指定します。\fIclass\fR値の完全修飾名を使用します。このタグレットは、カスタム・タグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。タグレットの例を使用した豊富なドキュメントについては、タグレットの概要 +そのタグのドキュメントの生成に使用するドックレットを起動するためのクラス・ファイルを指定します。\fBclass\fR値の完全修飾名を使用します。このタグレットは、カスタム・タグのテキスト引数の数も定義します。タグレットは、これらの引数を受け付け、処理し、出力を生成します。タグレットの例を使用した豊富なドキュメントについては、タグレットの概要 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/taglet/overview\&.html)を参照してください。 .sp -タグレットは、ブロックタグまたはインライン・タグで便利です。タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。タグレットへのパスを指定するには、\fI\-tagletpath\fRオプションを使用します。次に、生成されるページのParametersとThrowsの間にTo Doタグレットを挿入する例を示します。または、\fI\-taglet\fRオプションをその\fI\-tag\fRオプションのかわりに使用することができますが、読み取りが困難になる可能性があります。 +タグレットは、ブロックタグまたはインライン・タグで便利です。タグレットは任意の数の引数をとることができます。また、テキストを太字にする、箇条書きを作成する、テキストをファイルに書き出す、その他のプロセスを開始するなどのカスタム動作を実装できます。タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガーするなどの副作用は得られます。タグレットへのパスを指定するには、\fB\-tagletpath\fRオプションを使用します。次に、生成されるページのParametersとThrowsの間にTo Doタグレットを挿入する例を示します。または、\fB\-taglet\fRオプションをその\fB\-tag\fRオプションのかわりに使用することができますが、読み取りが困難になる可能性があります。 .sp .if n \{\ .RS 4 .\} .nf -\-taglet com\&.sun\&.tools\&.doclets\&.ToDoTaglet -\-tagletpath /home/taglets -\-tag return -\-tag param -\-tag todo -\-tag throws -\-tag see +\fB\-taglet com\&.sun\&.tools\&.doclets\&.ToDoTaglet\fR +\fB\-tagletpath /home/taglets \fR +\fB\-tag return\fR +\fB\-tag param\fR +\fB\-tag todo\fR +\fB\-tag throws\fR +\fB\-tag see\fR + .fi .if n \{\ .RE @@ -3244,7 +3377,7 @@ .PP \-tagletpath \fItagletpathlist\fR .RS 4 -tagletクラス・ファイルを検索するための検索パスを指定します。\fItagletpathlist\fRには、コロン(:)で区切って複数のパスを含めることができます。\fIjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。 +tagletクラス・ファイルを検索するための検索パスを指定します。\fBtagletpathlist\fRには、コロン(:)で区切って複数のパスを含めることができます。\fBjavadoc\fRコマンドは、指定されたパス以下のすべてのサブディレクトリを検索します。 .RE .PP \-docfilesubdirs @@ -3259,21 +3392,21 @@ .PP \-noqualifier all | \fIpackagename1\fR:\fIpackagename2\&.\&.\&.\fR .RS 4 -出力されるクラス名から修飾パッケージ名を省略します。\fI\-noqualifier\fRオプションの引数は、\fIall\fR(すべてのパッケージ修飾子を省略)、または修飾子として削除するパッケージのコロン区切りリスト(ワイルドカードも可)、のいずれかとなります。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。ソース・ファイルの処理を参照してください。 -.sp -次の例では、すべてのパッケージ修飾子を省略します。\fI\-noqualifier all\fR -.sp -次の例では、\fIjava\&.lang\fRおよび\fIjava\&.io\fRパッケージ修飾子を省略します: -\fI\-noqualifier java\&.lang:java\&.io\fR。 -.sp -次の例では、\fIjava\fRで始まるパッケージ修飾子および\fIcom\&.sun\fRサブパッケージを省略しますが、\fIjavax\fRは省略しません。\fI\-noqualifier java\&.*:com\&.sun\&.*\fR -.sp -パッケージ修飾子が前述の動作に従って表示される場合、名前は適切に短縮されます。「名前が表示される方法」を参照してください。このルールは、\fI\-noqualifier\fRオプションを使用するかどうかにかかわらず有効です。 +出力されるクラス名から修飾パッケージ名を省略します。\fB\-noqualifier\fRオプションの引数は、\fBall\fR(すべてのパッケージ修飾子を省略)、または修飾子として削除するパッケージのコロン区切りリスト(ワイルドカードも可)、のいずれかとなります。クラスまたはインタフェース名が表示される位置からパッケージ名が削除されます。ソース・ファイルの処理を参照してください。 +.sp +次の例では、すべてのパッケージ修飾子を省略します。\fB\-noqualifier all\fR +.sp +次の例では、\fBjava\&.lang\fRおよび\fBjava\&.io\fRパッケージ修飾子を省略します: +\fB\-noqualifier java\&.lang:java\&.io\fR。 +.sp +次の例では、\fBjava\fRで始まるパッケージ修飾子および\fBcom\&.sun\fRサブパッケージを省略しますが、\fBjavax\fRは省略しません。\fB\-noqualifier java\&.*:com\&.sun\&.*\fR +.sp +パッケージ修飾子が前述の動作に従って表示される場合、名前は適切に短縮されます。「名前が表示される方法」を参照してください。このルールは、\fB\-noqualifier\fRオプションを使用するかどうかにかかわらず有効です。 .RE .PP \-notimestamp .RS 4 -タイムスタンプが抑制されます。各ページの先頭近くにある、生成されたHTML内のHTMLコメントでタイムスタンプが隠されます。\fI\-notimestamp\fRオプションは、\fIjavadoc\fRコマンドを2つのソース・ベースで実行し、それらの間の差分\fIdiff\fRを取得する場合に役立ちます。タイムスタンプによる\fIdiff\fRの発生を防ぐからです(そうでないとすべてのページで\fIdiff\fRになります)。タイムスタンプには\fIjavadoc\fRコマンドのリリース番号が含まれ、現在では、\fI<!\-\- Generated by javadoc (build 1\&.5\&.0_01) on Thu Apr 02 14:04:52 IST 2009 \-\->\fRのように表示されます。 +タイムスタンプが抑制されます。各ページの先頭近くにある、生成されたHTML内のHTMLコメントでタイムスタンプが隠されます。\fB\-notimestamp\fRオプションは、\fBjavadoc\fRコマンドを2つのソース・ベースで実行し、それらの間の差分\fBdiff\fRを取得する場合に役立ちます。タイムスタンプによる\fBdiff\fRの発生を防ぐからです(そうでないとすべてのページで\fBdiff\fRになります)。タイムスタンプには\fBjavadoc\fRコマンドのリリース番号が含まれ、現在では、\fB<!\-\- Generated by javadoc (build 1\&.5\&.0_01) on Thu Apr 02 14:04:52 IST 2009 \-\->\fRのように表示されます。 .RE .PP \-nocomment @@ -3285,24 +3418,28 @@ .RS 4 ソース内で各タブが使用する空白文字の数を指定します。 .RE -.SH "コマンドライン引数ファイル" -.PP -\fIjavadoc\fRコマンドを短くしたり簡潔にしたりするために、\fIjavadoc\fRコマンドに対する引数(\fI\-J\fRオプションを除く)が入った1つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティング・システム上でも、任意の長さの\fIjavadoc\fRコマンドを作成できます。 -.PP -引数ファイルには、\fIjavac\fRのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に埋め込まれた空白がある場合、ファイル名全体を二重引用符で囲みます。 -.PP -引数ファイル内のファイル名は、引数ファイルの位置ではなく、現在のディレクトリに相対的となります。これらのリストでは、ワイルドカード(\fI*\fR)は使用できません。たとえば、*\&.javaとは指定できません。アットマーク(@)を使用して、ファイルを再帰的に解釈することはできません。また、\fI\-J\fRオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 -.PP -\fIjavadoc\fRを実行するときに、各引数ファイルのパスとファイル名の先頭に@文字を付けて渡します。\fIjavadoc\fRコマンドは、アットマーク(@)文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 -.PP -\fBExample 1\fR, 単一の引数ファイル -.RS 4 -\fIargfile\fRという名前の1つの引数ファイルを使用して、すべての\fIjavadoc\fRコマンド引数を保持できます。\fIjavadoc @argfile\fR次の例に示すように、この引数ファイルには両方のファイルの内容が含まれています。 -.RE -.PP -\fBExample 2\fR, 2つの引数ファイル -.RS 4 -次のように、2つの引数ファイルを作成できます。\fIjavadoc\fRコマンドのオプション用に1つ、パッケージ名またはソース・ファイル名用に1つです。次のリストでは行継続文字を使用していません。 +.SH "コマンド行引数ファイル" +.PP +\fBjavadoc\fRコマンドを短くしたり簡潔にしたりするために、\fBjavadoc\fRコマンドに対する引数(\fB\-J\fRオプションを除く)が入った1つ以上のファイルを指定することができます。このことを利用すれば、どのオペレーティング・システム上でも、任意の長さの\fBjavadoc\fRコマンドを作成できます。 +.PP +引数ファイルには、\fBjavac\fRのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に埋め込まれた空白がある場合、ファイル名全体を二重引用符で囲みます。 +.PP +引数ファイル内のファイル名は、引数ファイルの位置ではなく、現在のディレクトリに相対的となります。これらのリストでは、ワイルドカード(\fB*\fR)は使用できません。たとえば、*\&.javaとは指定できません。アットマーク(@)を使用して、ファイルを再帰的に解釈することはできません。また、\fB\-J\fRオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。 +.PP +\fBjavadoc\fRを実行するときに、各引数ファイルのパスとファイル名の先頭に@文字を付けて渡します。\fBjavadoc\fRコマンドは、アットマーク(@)文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。 +.PP +\fB例 1\fR +.br +単一の引数ファイル +.RS 4 +\fBargfile\fRという名前の1つの引数ファイルを使用して、すべての\fBjavadoc\fRコマンド引数を保持できます。\fBjavadoc @argfile\fR次の例に示すように、この引数ファイルには両方のファイルの内容が含まれています。 +.RE +.PP +\fB例 2\fR +.br +2つの引数ファイル +.RS 4 +次のように、2つの引数ファイルを作成できます。\fBjavadoc\fRコマンドのオプション用に1つ、パッケージ名またはソース・ファイル名用に1つです。次のリストでは行継続文字を使用していません。 .sp 次の内容を含む、optionsという名前のファイルを作成します。 .sp @@ -3310,16 +3447,17 @@ .RS 4 .\} .nf -\-d docs\-filelist -\-use -\-splitindex -\-windowtitle \*(AqJava SE 7 API Specification\*(Aq -\-doctitle \*(AqJava SE 7 API Specification\*(Aq -\-header \*(Aq<b>Java(TM) SE 7</b>\*(Aq -\-bottom \*(AqCopyright © 1993\-2011 Oracle and/or its affiliates\&. All rights reserved\&.\*(Aq -\-group "Core Packages" "java\&.*" -\-overview /java/pubs/ws/1\&.7\&.0/src/share/classes/overview\-core\&.html -\-sourcepath /java/pubs/ws/1\&.7\&.0/src/share/classes +\fB\-d docs\-filelist \fR +\fB\-use \fR +\fB\-splitindex\fR +\fB\-windowtitle \*(AqJava SE 7 API Specification\*(Aq\fR +\fB\-doctitle \*(AqJava SE 7 API Specification\*(Aq\fR +\fB\-header \*(Aq<b>Java(TM) SE 7</b>\*(Aq\fR +\fB\-bottom \*(AqCopyright © 1993\-2011 Oracle and/or its affiliates\&. All rights reserved\&.\*(Aq\fR +\fB\-group "Core Packages" "java\&.*"\fR +\fB\-overview /java/pubs/ws/1\&.7\&.0/src/share/classes/overview\-core\&.html\fR +\fB\-sourcepath /java/pubs/ws/1\&.7\&.0/src/share/classes\fR + .fi .if n \{\ .RE @@ -3330,170 +3468,199 @@ .RS 4 .\} .nf -com\&.mypackage1 -com\&.mypackage2 -com\&.mypackage3 +\fBcom\&.mypackage1\fR +\fBcom\&.mypackage2\fR +\fBcom\&.mypackage3\fR + .fi .if n \{\ .RE .\} -次のように、\fIjavadoc\fRコマンドを実行します。 +次のように、\fBjavadoc\fRコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc @options @packages +\fBjavadoc @options @packages\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, パスを使用した引数ファイル -.RS 4 -引数ファイルはパスを指定できますが、ファイル内のすべてのファイル名は、(\fIpath1\fRや\fIpath2\fRではなく)次のように現在の作業ディレクトリに相対的となります。 +\fB例 3\fR +.br +パスを使用した引数ファイル +.RS 4 +引数ファイルはパスを指定できますが、ファイル内のすべてのファイル名は、(\fBpath1\fRや\fBpath2\fRではなく)次のように現在の作業ディレクトリに相対的となります。 .sp .if n \{\ .RS 4 .\} .nf -javadoc @path1/options @path2/packages +\fBjavadoc @path1/options @path2/packages\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 4\fR, オプション引数 -.RS 4 -次に、\fIjavadoc\fRコマンドのオプションに対する引数を引数ファイルに格納する例を示します。長い引数を指定できるので、\fI\-bottom\fRオプションを使用します。次のようなテキスト引数を含む、bottomという名前のファイルを作成できます。 +\fB例 4\fR +.br +オプション引数 +.RS 4 +次に、\fBjavadoc\fRコマンドのオプションに対する引数を引数ファイルに格納する例を示します。長い引数を指定できるので、\fB\-bottom\fRオプションを使用します。次のようなテキスト引数を含む、bottomという名前のファイルを作成できます。 .sp .if n \{\ .RS 4 .\} .nf -<font size="\-1"> - <a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/> - Copyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&. <br/> - Oracle is a registered trademark of Oracle Corporation and/or its affiliates\&. - Other names may be trademarks of their respective owners\&.</font> +\fB<font size="\-1">\fR +\fB <a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/>\fR +\fB Copyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&. <br/>\fR +\fB Oracle is a registered trademark of Oracle Corporation and/or its affiliates\&.\fR +\fB Other names may be trademarks of their respective owners\&.</font>\fR + .fi .if n \{\ .RE .\} -\fIjavadoc\fRコマンドを次のように実行します。\fI javadoc \-bottom @bottom @packages\fR -.sp -\fI\-bottom\fRオプションを引数ファイルの最初に含めて、次のように\fIjavadoc\fRコマンドを実行することもできます。\fIjavadoc @bottom @packages\fR +\fBjavadoc\fRコマンドを次のように実行します。\fB javadoc \-bottom @bottom @packages\fR +.sp +\fB\-bottom\fRオプションを引数ファイルの最初に含めて、次のように\fBjavadoc\fRコマンドを実行することもできます。\fBjavadoc @bottom @packages\fR .RE .SH "JAVADOCコマンドの実行" .PP -\fIjavadoc\fRコマンドのリリース番号は\fIjavadoc \-J\-version\fRオプションで特定できます。出力ストリームには標準ドックレットのリリース番号が含まれます。\fI\-quiet\fRオプションで無効にできます。 -.PP -Java言語で記述されたプログラムから\fIjavadoc\fRコマンドを起動するには公開プログラマティック・インタフェースを使用します。このインタフェースは\fIcom\&.sun\&.tools\&.javadoc\&.Main\fRにあります(また\fIjavadoc\fRコマンドは再入可能です)。詳細は、標準ドックレット +\fBjavadoc\fRコマンドのリリース番号は\fBjavadoc \-J\-version\fRオプションで特定できます。出力ストリームには標準ドックレットのリリース番号が含まれます。\fB\-quiet\fRオプションで無効にできます。 +.PP +Java言語で記述されたプログラムから\fBjavadoc\fRコマンドを起動するには公開プログラマティック・インタフェースを使用します。このインタフェースは\fBcom\&.sun\&.tools\&.javadoc\&.Main\fRにあります(また\fBjavadoc\fRコマンドは再入可能です)。詳細は、標準ドックレット (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/standard\-doclet\&.html#runningprogrammatically)を参照してください。 .PP -次の手順では、標準HTMLドックレットを呼び出します。カスタム・ドックレットを呼び出すには、\fI\-doclet\fRおよび\fI\-docletpath\fRオプションを使用しますドックレットの概要 +次の手順では、標準HTMLドックレットを呼び出します。カスタム・ドックレットを呼び出すには、\fB\-doclet\fRおよび\fB\-docletpath\fRオプションを使用しますドックレットの概要 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javadoc/doclet/overview\&.html)を参照してください .SS "簡単な例" .PP -\fIjavadoc\fRコマンドは、パッケージ全体に対して実行することも、個々のソース・ファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。 +\fBjavadoc\fRコマンドは、パッケージ全体に対して実行することも、個々のソース・ファイルに対して実行することもできます。各パッケージ名は、それぞれのパッケージ名に対応するディレクトリ名を持ちます。 .PP 次の例では、ソース・ファイルは/home/src/java/awt/*\&.javaにあります。生成先ディレクトリは/home/htmlです。 -1つ以上のパッケージのドキュメント化.PP +.PP +1つ以上のパッケージのドキュメント化 +.PP パッケージをドキュメント化するには、そのパッケージのソース・ファイルを、そのパッケージと同じ名前のディレクトリ内に格納する必要があります。 .PP -パッケージ名が(\fIjava\&.awt\&.color\fRのようにドットで区切られた)複数の識別子から構成されている場合、後続の各識別子が下位のサブディレクトリ(ava/awt/colorなど)に対応している必要があります。 -.PP -1つのパッケージのための複数のソース・ファイルを、異なる場所にあるそのような2つのディレクトリ・ツリーに分けて格納することもできます。ただし、その場合は\fI\-sourcepath\fRによってその両方の場所を指定する必要があります。たとえば、src1/java/awt/colorとsrc2/java/awt/color。 -.PP -ディレクトリの変更(\fIcd\fRコマンドを使用)または\fI\-sourcepath\fRオプションにより、\fIjavadoc\fRコマンドを実行できます。次の例で両方の選択肢を示します。 -.PP -\fBExample 1\fR, 1つ以上のパッケージから再帰的に実行 -.RS 4 -この例では\fIjavadoc\fRコマンドが任意のディレクトリから実行できるように、\fI\-sourcepath\fRを使用し、再帰的処理のために\fI\-subpackages\fR -(1\&.4の新オプション)を使用します。これは、javaディレクトリのサブパッケージをたどりますが、\fIjava\&.net\fRと\fIjava\&.lang\fRをルートに持つパッケージは除外されます。\fIjava\&.lang\fRのサブパッケージである\fIjava\&.lang\&.ref\fRが除外される点に注意してください。また、他のパッケージ・ツリーを下方にたどるには、\fIjava:javax:org\&.xml\&.sax\fRのように、それらのパッケージの名前を\fI\-subpackages\fRの引数に追加します。 +パッケージ名が(\fBjava\&.awt\&.color\fRのようにドットで区切られた)複数の識別子から構成されている場合、後続の各識別子が下位のサブディレクトリ(ava/awt/colorなど)に対応している必要があります。 +.PP +1つのパッケージのための複数のソース・ファイルを、異なる場所にあるそのような2つのディレクトリ・ツリーに分けて格納することもできます。ただし、その場合は\fB\-sourcepath\fRによってその両方の場所を指定する必要があります。たとえば、src1/java/awt/colorとsrc2/java/awt/color。 +.PP +ディレクトリの変更(\fBcd\fRコマンドを使用)または\fB\-sourcepath\fRオプションにより、\fBjavadoc\fRコマンドを実行できます。次の例で両方の選択肢を示します。 +.PP +\fB例 1\fR +.br +1つ以上のパッケージから再帰的に実行 +.RS 4 +この例では\fBjavadoc\fRコマンドが任意のディレクトリから実行できるように、\fB\-sourcepath\fRを使用し、再帰的処理のために\fB\-subpackages\fR +(1\&.4の新オプション)を使用します。これは、javaディレクトリのサブパッケージをたどりますが、\fBjava\&.net\fRと\fBjava\&.lang\fRをルートに持つパッケージは除外されます。\fBjava\&.lang\fRのサブパッケージである\fBjava\&.lang\&.ref\fRが除外される点に注意してください。また、他のパッケージ・ツリーを下方にたどるには、\fBjava:javax:org\&.xml\&.sax\fRのように、それらのパッケージの名前を\fB\-subpackages\fRの引数に追加します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude +\fBjavadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 2\fR, ルートへの移動および明示的なパッケージの実行 -.RS 4 -完全修飾されたパッケージの親ディレクトリに移動します。次に、ドキュメント化する1つ以上のパッケージの名前を指定して\fIjavadoc\fRコマンドを実行します。 +\fB例 2\fR +.br +ルートへの移動および明示的なパッケージの実行 +.RS 4 +完全修飾されたパッケージの親ディレクトリに移動します。次に、ドキュメント化する1つ以上のパッケージの名前を指定して\fBjavadoc\fRコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -cd /home/src/ -javadoc \-d /home/html java\&.awt java\&.awt\&.event +\fBcd /home/src/\fR +\fBjavadoc \-d /home/html java\&.awt java\&.awt\&.event\fR + .fi .if n \{\ .RE .\} -また、他のパッケージ・ツリーを下方にたどるには、j\fIava:javax:org\&.xml\&.sax\fRのように、それらのパッケージの名前を\fI\-subpackages\fRの引数に追加します。 -.RE -.PP -\fBExample 3\fR, 1つのツリーの明示的なパッケージの任意のディレクトリから実行 -.RS 4 -この場合、現在のディレクトリがどこかは問題ではありません。\fIjavadoc\fRコマンドを実行し、最上位パッケージの親ディレクトリを指定して\fI\-sourcepath\fRオプションを使用します。ドキュメント化する1つ以上のパッケージの名前を指定します。 +また、他のパッケージ・ツリーを下方にたどるには、j\fBava:javax:org\&.xml\&.sax\fRのように、それらのパッケージの名前を\fB\-subpackages\fRの引数に追加します。 +.RE +.PP +\fB例 3\fR +.br +1つのツリーの明示的なパッケージの任意のディレクトリから実行 +.RS 4 +この場合、現在のディレクトリがどこかは問題ではありません。\fBjavadoc\fRコマンドを実行し、最上位パッケージの親ディレクトリを指定して\fB\-sourcepath\fRオプションを使用します。ドキュメント化する1つ以上のパッケージの名前を指定します。 +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBjavadoc \-d /home/html \-sourcepath /home/src java\&.awt java\&.awt\&.event\fR + +.fi +.if n \{\ +.RE +.\} +.RE +.PP +\fB例 4\fR +.br +複数のツリーの明示的なパッケージの任意のディレクトリから実行 +.RS 4 +\fBjavadoc\fRコマンドを実行し、各ツリーのルートへのパスのコロン区切りリストを指定して\fB\-sourcepath\fRオプションを使用します。ドキュメント化する1つ以上のパッケージの名前を指定します。指定したパッケージのすべてのソース・ファイルが、1つのルート・ディレクトリの下に存在する必要はありませんが、ソース・パスで指定された場所のどこかで見つかる必要があります。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d /home/html \-sourcepath /home/src java\&.awt java\&.awt\&.event +\fBjavadoc \-d /home/html \-sourcepath /home/src1:/home/src2 java\&.awt java\&.awt\&.event\fR + .fi .if n \{\ .RE .\} -.RE -.PP -\fBExample 4\fR, 複数のツリーの明示的なパッケージの任意のディレクトリから実行 -.RS 4 -\fIjavadoc\fRコマンドを実行し、各ツリーのルートへのパスのコロン区切りリストを指定して\fI\-sourcepath\fRオプションを使用します。ドキュメント化する1つ以上のパッケージの名前を指定します。指定したパッケージのすべてのソース・ファイルが、1つのルート・ディレクトリの下に存在する必要はありませんが、ソース・パスで指定された場所のどこかで見つかる必要があります。 +すべてのケースでj\fBava\&.awt\fRおよび\fBjava\&.awt\&.even\fRtパッケージ内の\fBpublic\fRおよび\fBprotected\fRクラスとインタフェースについて、HTML形式のドキュメントが生成され、指定された生成先ディレクトリにHTMLファイルが保存されます。2つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラス・ページという3つのHTMLフレームを持つことになります。 +.RE +.PP +1つ以上のクラスのドキュメント化 +.PP +また、1つ以上のソース・ファイルを渡して、\fBjavadoc\fRコマンドを実行することもできます。\fBjavadoc\fRは、次の2つの方法のいずれかで実行できます。1つはディレクトリを変更する方法(\fBcd\fRを使用)、もう1つはソース・ファイルへのパスを完全に指定する方法です。相対パスは、現在のディレクトリを起点とします。ソース・ファイルを渡すときは、\fB\-sourcepath\fRオプションは無視されます。アスタリスク(*)のようなコマンド行ワイルドカードを使用すると、クラスのグループを指定できます。 +.PP +\fB例 1\fR +.br +ソース・ディレクトリに変更 +.RS 4 +ソースを保持するディレクトリに変更します。次に、ドキュメント化する1つ以上のソース・ファイルの名前を指定して\fBjavadoc\fRコマンドを実行します。 +.sp +この例では、\fBButton\fRクラスと\fBCanvas\fRクラス、および名前が\fBGraphics\fRで始まるクラスについて、HTML形式のドキュメントが生成されます。パッケージ名ではなくソース・ファイルが\fBjavadoc\fRコマンドに引数として渡されているので、ドキュメントは、クラスのリストとメイン・ページという2つのフレームを持つことになります。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d /home/html \-sourcepath /home/src1:/home/src2 java\&.awt java\&.awt\&.event +\fBcd /home/src/java/awt\fR +\fBjavadoc \-d /home/html Button\&.java Canvas\&.java Graphics*\&.java\fR + .fi .if n \{\ .RE .\} -すべてのケースでj\fIava\&.awt\fRおよび\fIjava\&.awt\&.even\fRtパッケージ内の\fIpublic\fRおよび\fIprotected\fRクラスとインタフェースについて、HTML形式のドキュメントが生成され、指定された生成先ディレクトリにHTMLファイルが保存されます。2つ以上のパッケージが生成されているので、ドキュメントは、パッケージのリスト、クラスのリスト、およびメインのクラス・ページという3つのHTMLフレームを持つことになります。 -.RE -1つ以上のクラスのドキュメント化.PP -また、1つ以上のソース・ファイルを渡して、\fIjavadoc\fRコマンドを実行することもできます。\fIjavadoc\fRは、次の2つの方法のいずれかで実行できます。1つはディレクトリを変更する方法(\fIcd\fRを使用)、もう1つはソース・ファイルへのパスを完全に指定する方法です。相対パスは、現在のディレクトリを起点とします。ソース・ファイルを渡すときは、\fI\-sourcepath\fRオプションは無視されます。アスタリスク(*)のようなコマンドライン・ワイルドカードを使用すると、クラスのグループを指定できます。 -.PP -\fBExample 1\fR, ソース・ディレクトリに変更 -.RS 4 -ソースを保持するディレクトリに変更します。次に、ドキュメント化する1つ以上のソース・ファイルの名前を指定して\fIjavadoc\fRコマンドを実行します。 -.sp -この例では、\fIButton\fRクラスと\fICanvas\fRクラス、および名前が\fIGraphics\fRで始まるクラスについて、HTML形式のドキュメントが生成されます。パッケージ名ではなくソース・ファイルが\fIjavadoc\fRコマンドに引数として渡されているので、ドキュメントは、クラスのリストとメイン・ページという2つのフレームを持つことになります。 -.sp -.if n \{\ -.RS 4 -.\} -.nf -cd /home/src/java/awt -javadoc \-d /home/html Button\&.java Canvas\&.java Graphics*\&.java -.fi -.if n \{\ -.RE -.\} -.RE -.PP -\fBExample 2\fR, パッケージのルート・ディレクトリに変更 +.RE +.PP +\fB例 2\fR +.br +パッケージのルート・ディレクトリに変更 .RS 4 これは、同じルートからの別のサブパッケージの個々のソース・ファイルをドキュメント化するのに役立ちます。パッケージのルート・ディレクトリに移り、各ソース・ファイルを、ルートからのパスとともに指定します。 .sp @@ -3501,143 +3668,157 @@ .RS 4 .\} .nf -cd /home/src/ -javadoc \-d /home/html java/awt/Button\&.java java/applet/Applet\&.java +\fBcd /home/src/\fR +\fBjavadoc \-d /home/html java/awt/Button\&.java java/applet/Applet\&.java\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, 任意のディレクトリからのファイルのドキュメント化 -.RS 4 -この場合、現在のディレクトリがどこかは問題ではありません。ドキュメント化するソース・ファイルへの絶対パス(または現在のディレクトリからの相対パス)を指定して\fIjavadoc\fRコマンドを実行します。 +\fB例 3\fR +.br +任意のディレクトリからのファイルのドキュメント化 +.RS 4 +この場合、現在のディレクトリがどこかは問題ではありません。ドキュメント化するソース・ファイルへの絶対パス(または現在のディレクトリからの相対パス)を指定して\fBjavadoc\fRコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d /home/html /home/src/java/awt/Button\&.java -/home/src/java/awt/Graphics*\&.java +\fBjavadoc \-d /home/html /home/src/java/awt/Button\&.java\fR +\fB/home/src/java/awt/Graphics*\&.java\fR + .fi .if n \{\ .RE .\} .RE -パッケージおよびクラスのドキュメント化.PP -パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に、前述の2つの例を組み合せた例を示します。\fI\-sourcepath\fRオプションは、パッケージへのパスに対しては使用できますが、個々のクラスへのパスに対しては使用できません。 +.PP +パッケージおよびクラスのドキュメント化 +.PP +パッケージ全体と個々のクラスを同時に指定してドキュメント化することもできます。次に、前述の2つの例を組み合せた例を示します。\fB\-sourcepath\fRオプションは、パッケージへのパスに対しては使用できますが、個々のクラスへのパスに対しては使用できません。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-d /home/html \-sourcepath /home/src java\&.awt -/home/src/java/applet/Applet\&.java +\fBjavadoc \-d /home/html \-sourcepath /home/src java\&.awt\fR +\fB/home/src/java/applet/Applet\&.java\fR + .fi .if n \{\ .RE .\} .SS "実際の例" .PP -次のコマンドラインおよび\fImakefile\fRバージョンの\fIjavadoc\fRコマンドをJavaプラットフォームAPIで実行します。Java SE 1\&.2で約1500個のpublicおよびprotectedクラスのドキュメントを生成するには、180MBのメモリーを使用します。どちらの例もオプションの引数で絶対パスが使用されているため、任意のディレクトリから同じ\fIjavadoc\fRコマンドを実行できます。 -コマンドラインの例.PP -次のコマンドは、一部のシェルに対して長すぎる可能性があります。この制限を回避するには、コマンドライン引数ファイルを使用します。または、シェル・スクリプトを記述します。 -.PP -この例では、\fIpackages\fRは処理するパッケージを含む名前で、\fIjava\&.applet\fR -\fIjava\&.lang\fRなどです。各オプションの、一重引用符で囲まれた引数の内側には、改行文字を挿入できません。たとえば、この例をコピー・アンド・ペーストする場合は、\fI\-bottom\fRオプションから改行文字を削除してください。 +次のコマンド行および\fBmakefile\fRバージョンの\fBjavadoc\fRコマンドをJavaプラットフォームAPIで実行します。Java SE 1\&.2で約1500個のpublicおよびprotectedクラスのドキュメントを生成するには、180MBのメモリーを使用します。どちらの例もオプションの引数で絶対パスが使用されているため、任意のディレクトリから同じ\fBjavadoc\fRコマンドを実行できます。 +.PP +コマンド行の例 +.PP +次のコマンドは、一部のシェルに対して長すぎる可能性があります。この制限を回避するには、コマンド行引数ファイルを使用します。または、シェル・スクリプトを記述します。 +.PP +この例では、\fBpackages\fRは処理するパッケージを含む名前で、\fBjava\&.applet\fR +\fBjava\&.lang\fRなどです。各オプションの、一重引用符で囲まれた引数の内側には、改行文字を挿入できません。たとえば、この例をコピー・アンド・ペーストする場合は、\fB\-bottom\fRオプションから改行文字を削除してください。 .sp .if n \{\ .RS 4 .\} .nf -javadoc \-sourcepath /java/jdk/src/share/classes \e -\-overview /java/jdk/src/share/classes/overview\&.html \e -\-d /java/jdk/build/api \e -\-use \e -\-splitIndex \e -\-windowtitle \*(AqJava Platform, Standard Edition 7 API Specification\*(Aq \e -\-doctitle \*(AqJava Platform, Standard Edition 7 API Specification\*(Aq \e -\-header \*(Aq<b>Java(TM) SE 7</b>\*(Aq \e -\-bottom \*(Aq<font size="\-1"> -<a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/> -Copyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&.<br/> -Oracle is a registered trademark of Oracle Corporation and/or its affiliates\&. -Other names may be trademarks of their respective owners\&.</font>\*(Aq \e -\-group "Core Packages" "java\&.*:com\&.sun\&.java\&.*:org\&.omg\&.*" \e -\-group "Extension Packages" "javax\&.*" \e -\-J\-Xmx180m \e -@packages +\fBjavadoc \-sourcepath /java/jdk/src/share/classes \e\fR +\fB\-overview /java/jdk/src/share/classes/overview\&.html \e\fR +\fB\-d /java/jdk/build/api \e\fR +\fB\-use \e\fR +\fB\-splitIndex \e\fR +\fB\-windowtitle \*(AqJava Platform, Standard Edition 7 API Specification\*(Aq \e\fR +\fB\-doctitle \*(AqJava Platform, Standard Edition 7 API Specification\*(Aq \e\fR +\fB\-header \*(Aq<b>Java(TM) SE 7</b>\*(Aq \e\fR +\fB\-bottom \*(Aq<font size="\-1">\fR +\fB<a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/>\fR +\fBCopyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&.<br/>\fR +\fBOracle is a registered trademark of Oracle Corporation and/or its affiliates\&.\fR +\fBOther names may be trademarks of their respective owners\&.</font>\*(Aq \e\fR +\fB\-group "Core Packages" "java\&.*:com\&.sun\&.java\&.*:org\&.omg\&.*" \e\fR +\fB\-group "Extension Packages" "javax\&.*" \e\fR +\fB\-J\-Xmx180m \e \fR +\fB@packages\fR + .fi .if n \{\ .RE .\} -プログラマティック・インタフェース.PP +.PP +プログラマティック・インタフェース +.PP Javadoc Access APIでは、新しいプロセスを実行しなくても、JavadocツールをJavaアプリケーションから直接起動できます。 .PP -たとえば、次の文はコマンド\fIjavadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude java\&.net:java\&.lang com\&.example\fRと同等です。 +たとえば、次の文はコマンド\fBjavadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude java\&.net:java\&.lang com\&.example\fRと同等です。 .sp .if n \{\ .RS 4 .\} .nf -import javax\&.tools\&.DocumentationTool; -import javax\&.tools\&.ToolProvider; - -public class JavaAccessSample{ - public static void main(String[] args){ - DocumentationTool javadoc = ToolProvider\&.getSystemDocumentationTool(); - int rc = javadoc\&.run( null, null, null, - "\-d", "/home/html", - "\-sourcepath", "home/src", - "\-subpackages", "java", - "\-exclude", "java\&.net:java\&.lang", - "com\&.example"); - } - } +\fBimport javax\&.tools\&.DocumentationTool;\fR +\fBimport javax\&.tools\&.ToolProvider;\fR + +\fBpublic class JavaAccessSample{\fR +\fB public static void main(String[] args){\fR +\fB DocumentationTool javadoc = ToolProvider\&.getSystemDocumentationTool();\fR +\fB int rc = javadoc\&.run( null, null, null,\fR +\fB "\-d", "/home/html",\fR +\fB "\-sourcepath", "home/src",\fR +\fB "\-subpackages", "java",\fR +\fB "\-exclude", "java\&.net:java\&.lang",\fR +\fB "com\&.example");\fR +\fB }\fR +\fB }\fR + .fi .if n \{\ .RE .\} .PP -\fIrun\fRメソッドの最初の3つの引数は、入力、標準出力、および標準エラー・ストリームを指定します。\fINull\fRは\fISystem\&.in\fR、\fISystem\&.out\fRおよび\fISystem\&.err\fRそれぞれのデフォルト値です。 +\fBrun\fRメソッドの最初の3つの引数は、入力、標準出力、および標準エラー・ストリームを指定します。\fBNull\fRは\fBSystem\&.in\fR、\fBSystem\&.out\fRおよび\fBSystem\&.err\fRそれぞれのデフォルト値です。 .SS "makefileの例" .PP ここでは、GNU -\fImakefile\fRの例を示します。\fImakefile\fRの引数は、一重引用符で囲みます。Windows -\fImakefile\fRの例については、Javadoc FAQの\fImakefiles\fRに関する項 +\fBmakefile\fRの例を示します。\fBmakefile\fRの引数は、一重引用符で囲みます。Windows +\fBmakefile\fRの例については、Javadoc FAQの\fBmakefiles\fRのセクション (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137483\&.html#makefiles)を参照してください .sp .if n \{\ .RS 4 .\} .nf -javadoc \-sourcepath $(SRCDIR) \e /* Sets path for source files */ - \-overview $(SRCDIR)/overview\&.html \e /* Sets file for overview text */ - \-d /java/jdk/build/api \e /* Sets destination directory */ - \-use \e /* Adds "Use" files */ - \-splitIndex \e /* Splits index A\-Z */ - \-windowtitle $(WINDOWTITLE) \e /* Adds a window title */ - \-doctitle $(DOCTITLE) \e /* Adds a doc title */ - \-header $(HEADER) \e /* Adds running header text */ - \-bottom $(BOTTOM) \e /* Adds text at bottom */ - \-group $(GROUPCORE) \e /* 1st subhead on overview page */ - \-group $(GROUPEXT) \e /* 2nd subhead on overview page */ - \-J\-Xmx180m \e /* Sets memory to 180MB */ - java\&.lang java\&.lang\&.reflect \e /* Sets packages to document */ - java\&.util java\&.io java\&.net \e - java\&.applet - -WINDOWTITLE = \*(AqJava(TM) SE 7 API Specification\*(Aq -DOCTITLE = \*(AqJava(TM) Platform Standard Edition 7 API Specification\*(Aq -HEADER = \*(Aq<b>Java(TM) SE 7</font>\*(Aq -BOTTOM = \*(Aq<font size="\-1"> - <a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/> - Copyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&.<br/> - Oracle is a registered trademark of Oracle Corporation and/or its affiliates\&. - Other names may be trademarks of their respective owners\&.</font>\*(Aq -GROUPCORE = \*(Aq"Core Packages" "java\&.*:com\&.sun\&.java\&.*:org\&.omg\&.*"\*(Aq -GROUPEXT = \*(Aq"Extension Packages" "javax\&.*"\*(Aq -SRCDIR = \*(Aq/java/jdk/1\&.7\&.0/src/share/classes\*(Aq +\fBjavadoc \-sourcepath $(SRCDIR) \e /* Sets path for source files */\fR +\fB \-overview $(SRCDIR)/overview\&.html \e /* Sets file for overview text */\fR +\fB \-d /java/jdk/build/api \e /* Sets destination directory */\fR +\fB \-use \e /* Adds "Use" files */\fR +\fB \-splitIndex \e /* Splits index A\-Z */\fR +\fB \-windowtitle $(WINDOWTITLE) \e /* Adds a window title */\fR +\fB \-doctitle $(DOCTITLE) \e /* Adds a doc title */\fR +\fB \-header $(HEADER) \e /* Adds running header text */\fR +\fB \-bottom $(BOTTOM) \e /* Adds text at bottom */\fR +\fB \-group $(GROUPCORE) \e /* 1st subhead on overview page */\fR +\fB \-group $(GROUPEXT) \e /* 2nd subhead on overview page */\fR +\fB \-J\-Xmx180m \e /* Sets memory to 180MB */\fR +\fB java\&.lang java\&.lang\&.reflect \e /* Sets packages to document */\fR +\fB java\&.util java\&.io java\&.net \e\fR +\fB java\&.applet\fR +\fB \fR +\fBWINDOWTITLE = \*(AqJava(TM) SE 7 API Specification\*(Aq\fR +\fBDOCTITLE = \*(AqJava(TM) Platform Standard Edition 7 API Specification\*(Aq\fR +\fBHEADER = \*(Aq<b>Java(TM) SE 7</font>\*(Aq\fR +\fBBOTTOM = \*(Aq<font size="\-1">\fR +\fB <a href="http://bugreport\&.sun\&.com/bugreport/">Submit a bug or feature</a><br/>\fR +\fB Copyright © 1993, 2011, Oracle and/or its affiliates\&. All rights reserved\&.<br/>\fR +\fB Oracle is a registered trademark of Oracle Corporation and/or its affiliates\&.\fR +\fB Other names may be trademarks of their respective owners\&.</font>\*(Aq\fR +\fBGROUPCORE = \*(Aq"Core Packages" "java\&.*:com\&.sun\&.java\&.*:org\&.omg\&.*"\*(Aq\fR +\fBGROUPEXT = \*(Aq"Extension Packages" "javax\&.*"\*(Aq\fR +\fBSRCDIR = \*(Aq/java/jdk/1\&.7\&.0/src/share/classes\*(Aq\fR + .fi .if n \{\ .RE @@ -3652,7 +3833,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-windowtitle\fRオプションを省略すると、\fIjavadoc\fRコマンドによってドキュメント・タイトルがウィンドウ・タイトルにコピーされます。\fI\-windowtitle\fRオプションのテキストは、\fI\-doctitle\fRオプションと同じですが、HTMLタグは含まれません。これは、HTMLタグが、ウィンドウ・タイトル内にそのままのテキストとして表示されるのを防ぐためです。 +\fB\-windowtitle\fRオプションを省略すると、\fBjavadoc\fRコマンドによってドキュメント・タイトルがウィンドウ・タイトルにコピーされます。\fB\-windowtitle\fRオプションのテキストは、\fB\-doctitle\fRオプションと同じですが、HTMLタグは含まれません。これは、HTMLタグが、ウィンドウ・タイトル内にそのままのテキストとして表示されるのを防ぐためです。 .RE .sp .RS 4 @@ -3663,7 +3844,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-footer\fRオプションを省略すると、\fIjavadoc\fRコマンドによってヘッダー・テキストがフッターにコピーされます。 +\fB\-footer\fRオプションを省略すると、\fBjavadoc\fRコマンドによってヘッダー・テキストがフッターにコピーされます。 .RE .sp .RS 4 @@ -3674,7 +3855,7 @@ .sp -1 .IP \(bu 2.3 .\} -この例では必要ありませんが、\fI\-classpath\fRと\fI\-link\fRも重要なオプションです。 +この例では必要ありませんが、\fB\-classpath\fRと\fB\-link\fRも重要なオプションです。 .RE .SH "一般的なトラブルシューティング" .sp @@ -3686,7 +3867,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIjavadoc\fRコマンドは有効なクラス名を含むファイルのみを読み取ります。\fIjavadoc\fRコマンドがファイルの内容を正しく読み取っていない場合は、クラス名が有効であることを確認します。ソース・ファイルの処理を参照してください。 +\fBjavadoc\fRコマンドは有効なクラス名を含むファイルのみを読み取ります。\fBjavadoc\fRコマンドがファイルの内容を正しく読み取っていない場合は、クラス名が有効であることを確認します。ソース・ファイルの処理を参照してください。 .RE .sp .RS 4 @@ -3697,25 +3878,25 @@ .sp -1 .IP \(bu 2.3 .\} -共通の不具合およびトラブルシューティングのヒントについては、Javadoc FAQ +一般的なbugおよびトラブルシューティングのヒントについては、Javadoc FAQ (http://www\&.oracle\&.com/technetwork/java/javase/documentation/index\-137483\&.html)を参照してください。 .RE .SH "エラーと警告" .PP エラーおよび警告メッセージには、ファイル名と宣言行(ドキュメンテーション・コメント内の特定の行ではない)の行番号が含まれます。 .PP -たとえば、メッセージ\fI「エラー: Class1\&.javaを読み込めません」\fRは、\fIjavadoc\fRコマンドが\fIClass1\&.jav\fR\fIa\fRを現在のディレクトリにロードしようとしていることを意味します。クラス名はそのパス(絶対または相対)で表示されます。 +たとえば、メッセージ\fB「エラー: Class1\&.javaを読み込めません」\fRは、\fBjavadoc\fRコマンドが\fBClass1\&.jav\fR\fBa\fRを現在のディレクトリにロードしようとしていることを意味します。クラス名はそのパス(絶対または相対)で表示されます。 .SH "環境" .PP CLASSPATH .RS 4 -\fICLASSPATH\fRは、\fIjavadoc\fRコマンドがユーザー・クラス・ファイルの検出に使用するパスを提供する環境変数です。この環境変数は、\fI\-classpath\fRオプションによってオーバーライドされます。ディレクトリはセミコロン(Windowsの場合)またはコロン(Oracle Solarisの場合)で区切ります。 +\fBCLASSPATH\fRは、\fBjavadoc\fRコマンドがユーザー・クラス・ファイルの検出に使用するパスを提供する環境変数です。この環境変数は、\fB\-classpath\fRオプションによってオーバーライドされます。ディレクトリはセミコロン(Windowsの場合)またはコロン(Oracle Solarisの場合)で区切ります。 .sp \fBWindowsの例\fR: -\fI\&.;C:\eclasses;C:\ehome\ejava\eclasses\fR +\fB\&.;C:\eclasses;C:\ehome\ejava\eclasses\fR .sp \fBOracle Solarisの例\fR: -\fI\&.:/home/classes:/usr/local/java/classes\fR +\fB\&.:/home/classes:/usr/local/java/classes\fR .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/javah.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/javah.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: javah -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: javah +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "javah" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" javah \- JavaクラスからCヘッダーとソース・ファイルを生成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjavah\fR [ \fIoptions\fR ] f\fIully\-qualified\-class\-name \&.\&.\&.\fR +\fBjavah\fR [ \fIoptions\fR ] f\fIully\-qualified\-class\-name \&.\&.\&.\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIfully\-qualified\-class\-name\fR @@ -73,76 +75,76 @@ .RE .SH "説明" .PP -\fIjavah\fRコマンドは、ネイティブ・メソッドを実装するために必要なCヘッダーとソース・ファイルを生成します。作成されたヘッダーとソース・ファイルは、ネイティブ・ソース・コードからオブジェクトのインスタンス変数を参照するためにCプログラムによって使用されます。\fI\&.h\fRファイルは、対応するクラスと一致する配置を持つ\fIstruct\fR定義を含みます。\fIstruct\fRのフィールドは、クラスのインスタンス変数に対応します。 +\fBjavah\fRコマンドは、ネイティブ・メソッドを実装するために必要なCヘッダーとソース・ファイルを生成します。作成されたヘッダーとソース・ファイルは、ネイティブ・ソース・コードからオブジェクトのインスタンス変数を参照するためにCプログラムによって使用されます。\fB\&.h\fRファイルは、対応するクラスと一致する配置を持つ\fBstruct\fR定義を含みます。\fBstruct\fRのフィールドは、クラスのインスタンス変数に対応します。 .PP -ヘッダー・ファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\fIjavah\fRコマンドに渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダー・ファイル名と構造体名の両方の先頭に付加されます。下線(_)が名前の区切り文字として使用されます。 +ヘッダー・ファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\fBjavah\fRコマンドに渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダー・ファイル名と構造体名の両方の先頭に付加されます。下線(_)が名前の区切り文字として使用されます。 .PP -デフォルトでは\fIjavah\fRコマンドは、コマンドラインにリストされる各クラスのヘッダー・ファイルを作成し、現在のディレクトリにファイルを置きます。ソース・ファイルを作成するには、\fI\-stubs\fRオプションを使用してください。1つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\fI\-o\fRオプションを使用してください。 +デフォルトでは\fBjavah\fRコマンドは、コマンド行にリストされる各クラスのヘッダー・ファイルを作成し、現在のディレクトリにファイルを置きます。ソース・ファイルを作成するには、\fB\-stubs\fRオプションを使用してください。1つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\fB\-o\fRオプションを使用してください。 .PP -Java Native Interface (JNI)はヘッダー情報またはスタブ・ファイルを必要としません。\fIjavah\fRコマンドは引き続きJNI形式のネイティブ・メソッドに必要なネイティブ・メソッド関数プロトタイプの生成に使用できます。\fIjavah\fRコマンドはデフォルトでJNI形式の出力を生成し、その結果を\fI\&.h\fRファイルに格納します。 +Java Native Interface (JNI)はヘッダー情報またはスタブ・ファイルを必要としません。\fBjavah\fRコマンドは引き続きJNI形式のネイティブ・メソッドに必要なネイティブ・メソッド関数プロトタイプの生成に使用できます。\fBjavah\fRコマンドはデフォルトでJNI形式の出力を生成し、その結果を\fB\&.h\fRファイルに格納します。 .SH "オプション" .PP \-o \fIoutputfile\fR .RS 4 -コマンドラインにリストされたすべてのクラスに対して、結果のヘッダーまたはソース・ファイルを連結して出力ファイルに格納します。\fI\-o\fRまたは\fI\-d\fRのどちらかのみ使用できます。 +コマンド行にリストされたすべてのクラスに対して、結果のヘッダーまたはソース・ファイルを連結して出力ファイルに格納します。\fB\-o\fRまたは\fB\-d\fRのどちらかのみ使用できます。 .RE .PP \-d \fIdirectory\fR .RS 4 -\fIjavah\fRがヘッダー・ファイルまたはスタブ・ファイルを保存する、ディレクトリを設定します。\fI\-d\fRまたは\fI\-o\fRのどちらかのみ使用できます。 +\fBjavah\fRがヘッダー・ファイルまたはスタブ・ファイルを保存する、ディレクトリを設定します。\fB\-d\fRまたは\fB\-o\fRのどちらかのみ使用できます。 .RE .PP \-stubs .RS 4 -\fIjavah\fRコマンドが、Javaオブジェクト・ファイルからC宣言を生成します。 +\fBjavah\fRコマンドが、Javaオブジェクト・ファイルからC宣言を生成します。 .RE .PP \-verbose .RS 4 -詳細出力を指定し、作成ファイルの状態に関するメッセージを、\fIjavah\fRコマンドが\fI標準出力\fRに出力します。 +詳細出力を指定し、作成ファイルの状態に関するメッセージを、\fBjavah\fRコマンドが\fB標準出力\fRに出力します。 .RE .PP \-help .RS 4 -\fIjavah\fRの使用方法についてのヘルプ・メッセージを出力します。 +\fBjavah\fRの使用方法についてのヘルプ・メッセージを出力します。 .RE .PP \-version .RS 4 -\fIjavah\fRコマンドのリリース情報を出力します。 +\fBjavah\fRコマンドのリリース情報を出力します。 .RE .PP \-jni .RS 4 -JNI形式のネイティブ・メソッド機能プロトタイプを含む出力ファイルを、\fIjavah\fRコマンドが作成します。これは標準出力であるため、\fI\-jni\fRの使用はオプションです。 +JNI形式のネイティブ・メソッド機能プロトタイプを含む出力ファイルを、\fBjavah\fRコマンドが作成します。これは標準出力であるため、\fB\-jni\fRの使用はオプションです。 .RE .PP \-classpath \fIpath\fR .RS 4 -クラスを探すために\fIjavah\fRコマンドが使用するパスを指定します。デフォルトまたは\fICLASSPATH\fR環境変数の設定をオーバーライドします。ディレクトリはOracle Solarisの場合はコロンで、Windowsの場合はセミコロンで区切られます。パスの一般的な形式は次のようになります。 +クラスを探すために\fBjavah\fRコマンドが使用するパスを指定します。デフォルトまたは\fBCLASSPATH\fR環境変数の設定をオーバーライドします。ディレクトリはOracle Solarisの場合はコロンで、Windowsの場合はセミコロンで区切られます。パスの一般的な形式は次のようになります。 .sp \fBOracle Solaris\fRの場合: .sp \&.:\fIyour\-path\fR .sp 例: -\fI\&.:/home/avh/classes:/usr/local/java/classes\fR +\fB\&.:/home/avh/classes:/usr/local/java/classes\fR .sp \fBWindows\fRの場合: .sp \&.;\fIyour\-path\fR .sp 例: -\fI\&.;C:\eusers\edac\eclasses;C:\etools\ejava\eclasses\fR +\fB\&.;C:\eusers\edac\eclasses;C:\etools\ejava\eclasses\fR .sp -便宜上、*のベース名を含むクラス・パス要素は、\fI\&.jar\fRまたは\fI\&.JAR\fRを拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます。 +便宜上、*のベース名を含むクラス・パス要素は、\fB\&.jar\fRまたは\fB\&.JAR\fRを拡張子に持つディレクトリ内のすべてのファイルのリストを指定するのと同等とみなされます。 .sp -たとえば、ディレクトリ\fImydir\fRに\fIa\&.jar\fRと\fIb\&.JAR\fRが含まれている場合、クラス・パス要素\fImydir/*\fRは\fIA\fR\fI\&.jar:b\&.JAR\fRに展開されますが、JARファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべてのJARファイルが含まれます。*からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\fICLASSPATH\fR環境変数も、定義時には同様に展開されます。クラス・パスのワイルドカードの展開は、Java仮想マシン(JVM)の開始前に行われます。Javaプログラムは、環境を問い合せる場合を除き、展開されていないワイルドカードを参照しません。たとえば、\fISystem\&.getenv("CLASSPATH")\fRをコールして問い合せる場合です。 +たとえば、ディレクトリ\fBmydir\fRに\fBa\&.jar\fRと\fBb\&.JAR\fRが含まれている場合、クラス・パス要素\fBmydir/*\fRは\fBA\fR\fB\&.jar:b\&.JAR\fRに展開されますが、JARファイルの順番は未指定となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべてのJARファイルが含まれます。*からなるクラス・パス・エントリは、現在のディレクトリ内のすべてのJARファイルのリストに展開されます。\fBCLASSPATH\fR環境変数も、定義時には同様に展開されます。クラス・パスのワイルドカードの展開は、Java Virtual Machine (JVM)の開始前に行われます。Javaプログラムは、環境を問い合せる場合を除き、展開されていないワイルドカードを参照しません。たとえば、\fBSystem\&.getenv("CLASSPATH")\fRをコールして問い合せる場合です。 .RE .PP \-bootclasspath \fIpath\fR .RS 4 -ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\fIjre\elib\ert\&.jar\fRおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。 +ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\fBjre\elib\ert\&.jar\fRおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。 .RE .PP \-old @@ -157,7 +159,7 @@ .PP \-J\fIoption\fR .RS 4 -Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/javap.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/javap.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: javap -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,8 +21,16 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 -.TH "javap" "1" "2013年11月21日" "JDK 8" "基本ツール" +.\" Title: javap +.\" Language: Japanese +.\" Date: 2014年8月8日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 +.TH "javap" "1" "2014年8月8日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" javap \- 1つ以上のクラス・ファイルを逆アセンブルします。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjavap\fR [\fIoptions\fR] \fIclassfile\fR\&.\&.\&. +\fBjavap\fR [\fIoptions\fR] \fIclassfile\fR\&.\&.\&. .fi .if n \{\ .RE @@ -64,21 +66,25 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIclassfile\fR .RS 4 -注釈の処理対象となる、空白で区切った1つ以上のクラス(DocFooter\&.classなど)。クラス・パスで検出できるクラスを、ファイル名またはURL(\fIfile:///home/user/myproject/src/DocFooter\&.class\fRなど)で指定できます。 +注釈の処理対象となる、空白で区切った1つ以上のクラス(DocFooter\&.classなど)。クラス・パスで検出できるクラスを、ファイル名またはURL(\fBfile:///home/user/myproject/src/DocFooter\&.class\fRなど)で指定できます。 .RE .SH "説明" .PP -\fIjavap\fRコマンドは、1つまたは複数のクラス・ファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\fIjavap\fRコマンドは、そのパッケージ、渡されたクラスのprotectedおよびpublicのフィールドとメソッドを出力します。\fIjavap\fRコマンドはその出力を\fI標準出力\fRに表示します。 +\fBjavap\fRコマンドは、1つまたは複数のクラス・ファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\fBjavap\fRコマンドは、そのパッケージ、渡されたクラスのprotectedおよびpublicのフィールドとメソッドを出力します。\fBjavap\fRコマンドはその出力を\fB標準出力\fRに表示します。 .SH "オプション" .PP -\-help, \-\-help, \-? +\-help +.br +\-\-help +.br +\-? .RS 4 -\fIjavap\fRコマンドについてのヘルプ・メッセージを出力します。 +\fBjavap\fRコマンドについてのヘルプ・メッセージを出力します。 .RE .PP \-version @@ -101,7 +107,9 @@ protectedおよびpublicのクラスとメンバーのみを表示します。 .RE .PP -\-private, \-p +\-private +.br +\-p .RS 4 すべてのクラスとメンバーを表示します。 .RE @@ -114,8 +122,9 @@ .RS 4 .\} .nf -javap \-J\-version -javap \-J\-Djava\&.security\&.manager \-J\-Djava\&.security\&.policy=MyPolicy MyClassName +\fBjavap \-J\-version\fR +\fBjavap \-J\-Djava\&.security\&.manager \-J\-Djava\&.security\&.policy=MyPolicy MyClassName\fR + .fi .if n \{\ .RE @@ -135,7 +144,7 @@ .PP \-constants .RS 4 -\fIstatic final\fR定数を表示します。 +\fBstatic final\fR定数を表示します。 .RE .PP \-c @@ -150,135 +159,138 @@ .PP \-classpath \fIpath\fR .RS 4 -クラスを探すために\fIjavap\fRコマンドが使用するパスを指定します。デフォルトまたは\fICLASSPATH\fR環境変数の設定をオーバーライドします。 +クラスを探すために\fBjavap\fRコマンドが使用するパスを指定します。デフォルトまたは\fBCLASSPATH\fR環境変数の設定をオーバーライドします。 .RE .PP \-bootclasspath \fIpath\fR .RS 4 -ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\fIjre/lib/rt\&.jar\fRおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。 +ブートストラップ・クラスをロードするパスを指定します。ブートストラップ・クラスは、デフォルトでは\fBjre/lib/rt\&.jar\fRおよび他のいくつかのJARファイルにある、コアJavaプラットフォームを実装するクラスです。 .RE .PP \-extdir \fIdirs\fR .RS 4 -インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能のデフォルト位置は\fIjava\&.ext\&.dirs\fRです。 +インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能のデフォルト位置は\fBjava\&.ext\&.dirs\fRです。 .RE .SH "例" .PP -次の\fIDocFooter\fRクラスをコンパイルします。 +次の\fBDocFooter\fRクラスをコンパイルします。 .sp .if n \{\ .RS 4 .\} .nf -import java\&.awt\&.*; -import java\&.applet\&.*; - -public class DocFooter extends Applet { - String date; - String email; +\fBimport java\&.awt\&.*;\fR +\fBimport java\&.applet\&.*;\fR +\fB \fR +\fBpublic class DocFooter extends Applet {\fR +\fB String date;\fR +\fB String email;\fR +\fB \fR +\fB public void init() {\fR +\fB resize(500,100);\fR +\fB date = getParameter("LAST_UPDATED");\fR +\fB email = getParameter("EMAIL");\fR +\fB }\fR +\fB \fR +\fB public void paint(Graphics g) {\fR +\fB g\&.drawString(date + " by ",100, 15);\fR +\fB g\&.drawString(email,290,15);\fR +\fB }\fR +\fB}\fR - public void init() { - resize(500,100); - date = getParameter("LAST_UPDATED"); - email = getParameter("EMAIL"); - } - - public void paint(Graphics g) { - g\&.drawString(date + " by ",100, 15); - g\&.drawString(email,290,15); - } -} .fi .if n \{\ .RE .\} .PP -\fIjavap DocFooter\&.class\fRコマンドからの出力は次を生成します。 +\fBjavap DocFooter\&.class\fRコマンドからの出力は次を生成します。 .sp .if n \{\ .RS 4 .\} .nf -Compiled from "DocFooter\&.java" -public class DocFooter extends java\&.applet\&.Applet { - java\&.lang\&.String date; - java\&.lang\&.String email; - public DocFooter(); - public void init(); - public void paint(java\&.awt\&.Graphics); -} +\fBCompiled from "DocFooter\&.java"\fR +\fBpublic class DocFooter extends java\&.applet\&.Applet {\fR +\fB java\&.lang\&.String date;\fR +\fB java\&.lang\&.String email;\fR +\fB public DocFooter();\fR +\fB public void init();\fR +\fB public void paint(java\&.awt\&.Graphics);\fR +\fB}\fR + .fi .if n \{\ .RE .\} .PP -\fIjavap \-c DocFooter\&.class\fRコマンドからの出力は次を生成します。 +\fBjavap \-c DocFooter\&.class\fRコマンドからの出力は次を生成します。 .sp .if n \{\ .RS 4 .\} .nf -Compiled from "DocFooter\&.java" -public class DocFooter extends java\&.applet\&.Applet { - java\&.lang\&.String date; - java\&.lang\&.String email; - - public DocFooter(); - Code: - 0: aload_0 - 1: invokespecial #1 // Method -java/applet/Applet\&."<init>":()V - 4: return - - public void init(); - Code: - 0: aload_0 - 1: sipush 500 - 4: bipush 100 - 6: invokevirtual #2 // Method resize:(II)V - 9: aload_0 - 10: aload_0 - 11: ldc #3 // String LAST_UPDATED - 13: invokevirtual #4 // Method - getParameter:(Ljava/lang/String;)Ljava/lang/String; - 16: putfield #5 // Field date:Ljava/lang/String; - 19: aload_0 - 20: aload_0 - 21: ldc #6 // String EMAIL - 23: invokevirtual #4 // Method - getParameter:(Ljava/lang/String;)Ljava/lang/String; - 26: putfield #7 // Field email:Ljava/lang/String; - 29: return - - public void paint(java\&.awt\&.Graphics); - Code: - 0: aload_1 - 1: new #8 // class java/lang/StringBuilder - 4: dup - 5: invokespecial #9 // Method - java/lang/StringBuilder\&."<init>":()V - 8: aload_0 - 9: getfield #5 // Field date:Ljava/lang/String; - 12: invokevirtual #10 // Method - java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder; - 15: ldc #11 // String by - 17: invokevirtual #10 // Method - java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder; - 20: invokevirtual #12 // Method - java/lang/StringBuilder\&.toString:()Ljava/lang/String; - 23: bipush 100 - 25: bipush 15 - 27: invokevirtual #13 // Method - java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V - 30: aload_1 - 31: aload_0 - 32: getfield #7 // Field email:Ljava/lang/String; - 35: sipush 290 - 38: bipush 15 - 40: invokevirtual #13 // Method -java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V - 43: return -} +\fBCompiled from "DocFooter\&.java"\fR +\fBpublic class DocFooter extends java\&.applet\&.Applet {\fR +\fB java\&.lang\&.String date;\fR +\fB java\&.lang\&.String email;\fR + +\fB public DocFooter();\fR +\fB Code:\fR +\fB 0: aload_0 \fR +\fB 1: invokespecial #1 // Method\fR +\fBjava/applet/Applet\&."<init>":()V\fR +\fB 4: return \fR + +\fB public void init();\fR +\fB Code:\fR +\fB 0: aload_0 \fR +\fB 1: sipush 500\fR +\fB 4: bipush 100\fR +\fB 6: invokevirtual #2 // Method resize:(II)V\fR +\fB 9: aload_0 \fR +\fB 10: aload_0 \fR +\fB 11: ldc #3 // String LAST_UPDATED\fR +\fB 13: invokevirtual #4 // Method\fR +\fB getParameter:(Ljava/lang/String;)Ljava/lang/String;\fR +\fB 16: putfield #5 // Field date:Ljava/lang/String;\fR +\fB 19: aload_0 \fR +\fB 20: aload_0 \fR +\fB 21: ldc #6 // String EMAIL\fR +\fB 23: invokevirtual #4 // Method\fR +\fB getParameter:(Ljava/lang/String;)Ljava/lang/String;\fR +\fB 26: putfield #7 // Field email:Ljava/lang/String;\fR +\fB 29: return \fR + +\fB public void paint(java\&.awt\&.Graphics);\fR +\fB Code:\fR +\fB 0: aload_1 \fR +\fB 1: new #8 // class java/lang/StringBuilder\fR +\fB 4: dup \fR +\fB 5: invokespecial #9 // Method\fR +\fB java/lang/StringBuilder\&."<init>":()V\fR +\fB 8: aload_0 \fR +\fB 9: getfield #5 // Field date:Ljava/lang/String;\fR +\fB 12: invokevirtual #10 // Method\fR +\fB java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;\fR +\fB 15: ldc #11 // String by \fR +\fB 17: invokevirtual #10 // Method\fR +\fB java/lang/StringBuilder\&.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;\fR +\fB 20: invokevirtual #12 // Method\fR +\fB java/lang/StringBuilder\&.toString:()Ljava/lang/String;\fR +\fB 23: bipush 100\fR +\fB 25: bipush 15\fR +\fB 27: invokevirtual #13 // Method\fR +\fB java/awt/Graphics\&.drawString:(Ljava/lang/String;II)V\fR +\fB 30: aload_1 \fR +\fB 31: aload_0 \fR +\fB 32: getfield #7 // Field email:Ljava/lang/String;\fR +\fB 35: sipush 290\fR +\fB 38: bipush 15\fR +\fB 40: invokevirtual #13 // Method\fR +\fBjava/awt/Graphics\&.drawString:(Ljava/lang/String;II)V\fR +\fB 43: return \fR +\fB}\fR + .fi .if n \{\ .RE @@ -293,6 +305,17 @@ .sp -1 .IP \(bu 2.3 .\} +java(1) +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} javac(1) .RE .sp @@ -304,7 +327,18 @@ .sp -1 .IP \(bu 2.3 .\} -java(1) +javadoc(1) +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +javah(1) .RE .sp .RS 4 @@ -326,18 +360,7 @@ .sp -1 .IP \(bu 2.3 .\} -javah(1) -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -javadoc(1) +jdeps(1) .RE .br 'pl 8.5i
--- a/src/solaris/doc/sun/man/man1/ja/jcmd.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jcmd.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jcmd -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2012, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jcmd +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jcmd" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jcmd \- 実行中のJava仮想マシン(JVM)に診断コマンド・リクエストを送信します。 +.SH "名前" +jcmd \- 実行中のJava Virtual Machine (JVM)に診断コマンド・リクエストを送信します。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjcmd\fR [\fI\-l\fR|\fI\-h\fR|\fI\-help\fR] +\fBjcmd\fR [\fB\-l\fR|\fB\-h\fR|\fB\-help\fR] .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjcmd\fR \fIpid\fR|\fImain\-class\fR \fIPerfCounter\&.print\fR +\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fBPerfCounter\&.print\fR .fi .if n \{\ .RE @@ -76,7 +78,7 @@ .RS 4 .\} .nf -\fIjcmd\fR \fIpid\fR|\fImain\-class\fR \fI\-f\fR \fIfilename\fR +\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fB\-f\fR \fIfilename\fR .fi .if n \{\ .RE @@ -86,21 +88,21 @@ .RS 4 .\} .nf -\fIjcmd\fR \fIpid\fR|\fImain\-class\fR \fIcommand\fR[ \fIarguments\fR] +\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fIcommand\fR[ \fIarguments\fR] .fi .if n \{\ .RE .\} .SH "説明" .PP -\fIjcmd\fRユーティリティは、JVMに診断コマンド・リクエストを送信するために使用されます。これはJVMが稼働しているのと同じマシンで使用し、JVMの起動に使用したものと同じ有効ユーザーおよびグループ識別子を持っている必要があります。 +\fBjcmd\fRユーティリティは、JVMに診断コマンド・リクエストを送信するために使用されます。これはJVMが稼働しているのと同じマシンで使用し、JVMの起動に使用したものと同じ有効ユーザーおよびグループ識別子を持っている必要があります。 .PP \fB注意:\fR -リモート・マシンから、または別の識別子で診断コマンドを起動するには、\fIcom\&.sun\&.management\&.DiagnosticCommandMBean\fRインタフェースを使用できます。\fIDiagnosticCommandMBean\fRインタフェースの詳細は、http://download\&.java\&.net/jdk8/docs/jre/api/management/extension/com/sun/management/DiagnosticCommandMBean\&.htmlにあるAPIドキュメントを参照してください。 +リモート・マシンから、または別の識別子で診断コマンドを起動するには、\fBcom\&.sun\&.management\&.DiagnosticCommandMBean\fRインタフェースを使用できます。\fBDiagnosticCommandMBean\fRインタフェースの詳細は、http://docs\&.oracle\&.com/javase/8/docs/jre/api/management/extension/com/sun/management/DiagnosticCommandMBean\&.htmlにあるAPIドキュメントを参照してください。 .PP -\fIjcmd\fRを引数なしまたは\fI\- l\fRオプションを指定して実行した場合は、実行中のJavaプロセス識別子のリストが、メイン・クラスおよびプロセスの起動に使用されたコマンドライン引数とともに出力されます。\fI\-h\fRまたは\fI\-help\fRオプションを指定して\fIjcmd\fRを実行すると、ツールのヘルプ・メッセージが出力されます。 +\fBjcmd\fRを引数なしまたは\fB\- l\fRオプションを指定して実行した場合は、実行中のJavaプロセス識別子のリストが、メイン・クラスおよびプロセスの起動に使用されたコマンド行引数とともに出力されます。\fB\-h\fRまたは\fB\-help\fRオプションを指定して\fBjcmd\fRを実行すると、ツールのヘルプ・メッセージが出力されます。 .PP -プロセス識別子(\fIpid\fR)またはメイン・クラス(\fImain\-class\fR)を最初の引数として指定した場合、\fIjcmd\fRは、識別子を指定した場合はJavaプロセスに、メイン・クラスの名前を指定した場合はすべてのJavaプロセスに診断コマンド・リクエストを送信します。プロセス識別子として\fI0\fRを指定して、すべての使用可能なJavaプロセスに診断コマンド・リクエストを送信することもできます。診断コマンド・リクエストとして、次のいずれかを使用します。 +プロセス識別子(\fIpid\fR)またはメイン・クラス(\fImain\-class\fR)を最初の引数として指定した場合、\fBjcmd\fRは、識別子を指定した場合はJavaプロセスに、メイン・クラスの名前を指定した場合はすべてのJavaプロセスに診断コマンド・リクエストを送信します。プロセス識別子として\fB0\fRを指定して、すべての使用可能なJavaプロセスに診断コマンド・リクエストを送信することもできます。診断コマンド・リクエストとして、次のいずれかを使用します。 .PP Perfcounter\&.print .RS 4 @@ -109,15 +111,15 @@ .PP \-f \fIfilename\fR .RS 4 -診断コマンドを読み取り、指定したJavaプロセスに送信するファイルの名前。\fI\-f\fRオプションでのみ使用します。ファイル内の各コマンドは、1行で記述する必要があります。番号記号(\fI#\fR)で始まる行は無視されます。すべての行が読み取られるか、\fIstop\fRキーワードを含む行が読み取られると、ファイルの処理が終了します。 +診断コマンドを読み取り、指定したJavaプロセスに送信するファイルの名前。\fB\-f\fRオプションでのみ使用します。ファイル内の各コマンドは、1行で記述する必要があります。番号記号(\fB#\fR)で始まる行は無視されます。すべての行が読み取られるか、\fBstop\fRキーワードを含む行が読み取られると、ファイルの処理が終了します。 .RE .PP \fIcommand\fR [\fIarguments\fR] .RS 4 -指定されたJavaプロセスに送信するコマンド。指定したプロセスで使用できる診断コマンドのリストは、このプロセスに対して\fIhelp\fRコマンドを送信すれば表示されます。各診断コマンドに独自の引数セットがあります。コマンドの説明、構文および使用可能な引数のリストを表示するには、\fIhelp\fRコマンドの引数としてコマンド名を使用します。 +指定されたJavaプロセスに送信するコマンド。指定したプロセスで使用できる診断コマンドのリストは、このプロセスに対して\fBhelp\fRコマンドを送信すれば表示されます。各診断コマンドに独自の引数セットがあります。コマンドの説明、構文および使用可能な引数のリストを表示するには、\fBhelp\fRコマンドの引数としてコマンド名を使用します。 .sp \fB注意:\fR -引数にスペースが含まれている場合は、一重引用符または二重引用符(\fI\*(Aq\fRまたは\fI"\fR)で囲む必要があります。加えて、オペレーティング・システム・シェルが引用符を処理しないように、バックスラッシュ(\fI\e\fR)で一重引用符または二重引用符をエスケープする必要があります。または、これらの引数を一重引用符で囲んでから、二重引用符で囲むこともできます(または二重引用符で囲んでから、一重引用符で囲む)。 +引数にスペースが含まれている場合は、一重引用符または二重引用符(\fB\*(Aq\fRまたは\fB"\fR)で囲む必要があります。加えて、オペレーティング・システム・シェルが引用符を処理しないように、バックスラッシュ(\fB\e\fR)で一重引用符または二重引用符をエスケープする必要があります。または、これらの引数を一重引用符で囲んでから、二重引用符で囲むこともできます(または二重引用符で囲んでから、一重引用符で囲む)。 .RE .SH "オプション" .PP @@ -125,17 +127,19 @@ .PP \-f \fIfilename\fR .RS 4 -指定されたファイルからコマンドを読み取ります。このオプションは、最初の引数としてプロセス識別子またはメイン・クラスを指定する場合にのみ使用できます。ファイル内の各コマンドは、1行で記述する必要があります。番号記号(\fI#\fR)で始まる行は無視されます。すべての行が読み取られるか、\fIstop\fRキーワードを含む行が読み取られると、ファイルの処理が終了します。 +指定されたファイルからコマンドを読み取ります。このオプションは、最初の引数としてプロセス識別子またはメイン・クラスを指定する場合にのみ使用できます。ファイル内の各コマンドは、1行で記述する必要があります。番号記号(\fB#\fR)で始まる行は無視されます。すべての行が読み取られるか、\fBstop\fRキーワードを含む行が読み取られると、ファイルの処理が終了します。 .RE .PP -\-h, \-help +\-h +.br +\-help .RS 4 ヘルプ・メッセージが出力されます。 .RE .PP \-l .RS 4 -実行中のJavaプロセス識別子のリストをメイン・クラスおよびコマンドライン引数とともに出力します。 +実行中のJavaプロセス識別子のリストをメイン・クラスおよびコマンド行引数とともに出力します。 .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/jconsole.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jconsole.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jconsole -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Javaトラブルシューティング、プロファイリング、モニタリングおよび管理ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jconsole +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Javaトラブルシューティング、プロファイリング、モニタリングおよび管理ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jconsole" "1" "2013年11月21日" "JDK 8" "Javaトラブルシューティング、プロファイリング、モニタリン" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jconsole \- Javaアプリケーションを監視および管理するためのグラフィカル・コンソールを開始します。 +.SH "名前" +jconsole \- Javaアプリケーションをモニターおよび管理するためのグラフィカル・コンソールを開始します。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjconsole\fR [ \fIoptions\fR ] [ connection \&.\&.\&. ] +\fBjconsole\fR [ \fIoptions\fR ] [ connection \&.\&.\&. ] .fi .if n \{\ .RE @@ -64,24 +66,24 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP connection = \fIpid\fR | \fIhost\fR:\fIport\fR | \fIjmxURL\fR .RS 4 -\fIpid\fR値はローカルのJava仮想マシン(JVM)のプロセスIDです。JVMは\fIjconsole\fRコマンドを実行しているユーザーIDと同じユーザーIDで実行する必要があります。\fIhost:port\fR値はJVMが動作しているホスト・システムの名前と、JVMが開始したときにシステム・プロパティ\fIcom\&.sun\&.management\&.jmxremote\&.port\fRで指定したポート番号です。\fIjmxUrl\fR値は、JMXServiceURLで記述されている、接続されるJMXエージェントのアドレスです。 +\fBpid\fR値はローカルのJava Virtual Machine (JVM)のプロセスIDです。JVMは\fBjconsole\fRコマンドを実行しているユーザーIDと同じユーザーIDで実行する必要があります。\fBhost:port\fR値はJVMが動作しているホスト・システムの名前と、JVMが開始したときにシステム・プロパティ\fBcom\&.sun\&.management\&.jmxremote\&.port\fRで指定したポート番号です。\fBjmxUrl\fR値は、JMXServiceURLで記述されている、接続されるJMXエージェントのアドレスです。 .sp -\fIconnection\fRパラメータの詳細は、JMXテクノロジを使用したモニタリングおよび管理 +\fBconnection\fRパラメータの詳細は、JMXテクノロジを使用したモニタリングおよび管理 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/agent\&.html)を参照してください .sp -\fIJMXServiceURL\fRクラスの説明( +\fBJMXServiceURL\fRクラスの説明( http://docs\&.oracle\&.com/javase/8/docs/api/javax/management/remote/JMXServiceURL\&.html)も参照してください .RE .SH "説明" .PP -\fIjconsole\fRコマンドは、ローカル・マシンまたはリモート・マシン上のJavaアプリケーションと仮想マシンの監視と管理を行うグラフィカル・コンソール・ツールを起動します。 +\fBjconsole\fRコマンドは、ローカル・マシンまたはリモート・マシン上のJavaアプリケーションと仮想マシンをモニターおよび管理するグラフィカル・コンソール・ツールを起動します。 .PP -Windows上では、\fIjconsole\fRコマンドはコンソール・ウィンドウと関連付けられていません。ただし、\fIjconsole\fRコマンドが失敗すると、エラー情報を示すダイアログ・ボックスが表示されます。 +Windows上では、\fBjconsole\fRコマンドはコンソール・ウィンドウと関連付けられていません。ただし、\fBjconsole\fRコマンドが失敗すると、エラー情報を示すダイアログ・ボックスが表示されます。 .SH "オプション" .PP \-interval\fI=n\fR @@ -91,12 +93,12 @@ .PP \-notile .RS 4 -最初にウィンドウをタイリングしません(複数接続の場合)。 +最初はウィンドウをタイル表示しません(複数接続の場合)。 .RE .PP \-pluginpath \fIplugins\fR .RS 4 -\fIJConsole\fRプラグインを検索するディレクトリまたはJARファイルのリストを指定します。\fIplugins\fRパスには\fIMETA\-INF/services/com\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fRという名前のプロバイダ構成ファイルを含んでいる必要があり、これにはプラグインごとに1行が含まれています。その行は\fIcom\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fRクラスを実装しているクラスの完全修飾クラス名を指定します。 +\fBJConsole\fRプラグインを検索するディレクトリまたはJARファイルのリストを指定します。\fIplugins\fRパスには\fBMETA\-INF/services/com\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fRという名前のプロバイダ構成ファイルを含んでいる必要があり、これにはプラグインごとに1行が含まれています。その行は\fBcom\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fRクラスを実装しているクラスの完全修飾クラス名を指定します。 .RE .PP \-version @@ -111,7 +113,7 @@ .PP \-J\fIflag\fR .RS 4 -\fIjconsole\fRコマンドを実行したJVMに\fIflag\fRを渡します。 +\fBjconsole\fRコマンドを実行したJVMに\fBflag\fRを渡します。 .RE .SH "関連項目" .sp @@ -148,7 +150,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIJMXServiceURL\fRクラスの説明( +\fBJMXServiceURL\fRクラスの説明( http://docs\&.oracle\&.com/javase/8/docs/api/javax/management/remote/JMXServiceURL\&.html) .RE .br
--- a/src/solaris/doc/sun/man/man1/ja/jdb.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jdb.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jdb -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jdb +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jdb" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jdb \- Javaプラットフォーム・プログラムの不具合を検出および修正します。 +.SH "名前" +jdb \- Javaプラットフォーム・プログラムのbugを検出および修正します。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjdb\fR [\fIoptions\fR] [\fIclassname\fR] [\fIarguments\fR] +\fBjdb\fR [\fIoptions\fR] [\fIclassname\fR] [\fIarguments\fR] .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIclass\fRname @@ -74,67 +76,70 @@ .PP \fIarguments\fR .RS 4 -classの\fImain()\fRメソッドに渡す引数。 +classの\fBmain()\fRメソッドに渡す引数。 .RE .SH "説明" .PP -Javaデバッガ(JDB)は、Javaクラス用の簡単なコマンドライン・デバッガです。\fIjdb\fRコマンドとそのオプションはJDBを呼び出します。\fIjdb\fRコマンドは、JDBA (Java Platform Debugger Architecture)を視覚的に実行し、ローカルまたはリモートのJava仮想マシン(JVM)の検査とデバッグを行うことができます。Java Platform Debugger Architecture (JDBA) +Javaデバッガ(JDB)は、Javaクラス用の簡単なコマンド行デバッガです。\fBjdb\fRコマンドとそのオプションはJDBを呼び出します。\fBjdb\fRコマンドは、JDBA (Java Platform Debugger Architecture)を視覚的に実行し、ローカルまたはリモートのJava Virtual Machine (JVM)の検査とデバッグを行うことができます。Java Platform Debugger Architecture (JDBA) (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jpda/index\&.html)を参照してください。 .SS "JDBセッションの開始" .PP -JDBセッションを開始するには様々な方法があります。最も頻繁に使用されるのは、デバッグするアプリケーションのメイン・クラスを使用して、JDBから新しいJVMを起動する方法です。コマンドラインで、\fIjava\fRコマンドのかわりに\fIjdb\fRコマンドを入力します。たとえば、アプリケーションのメイン・クラスが\fIMyClass\fRの場合は、JDB環境でデバッグするときに次のコマンドを使用します。 +JDBセッションを開始するには様々な方法があります。最も頻繁に使用されるのは、デバッグするアプリケーションのメイン・クラスを使用して、JDBから新しいJVMを起動する方法です。コマンド行で、\fBjava\fRコマンドのかわりに\fBjdb\fRコマンドを入力します。たとえば、アプリケーションのメイン・クラスが\fBMyClass\fRの場合は、JDB環境でデバッグするときに次のコマンドを使用します。 .sp .if n \{\ .RS 4 .\} .nf -jdb MyClass +\fBjdb MyClass\fR + .fi .if n \{\ .RE .\} .PP -この方法で起動すると、\fIjdb\fRコマンドは、指定されたパラメータを使用して2つ目のJVMを呼び出します。次に、指定されたクラスをロードして、クラスの最初の命令を実行する前にJVMを停止させます。 +この方法で起動すると、\fBjdb\fRコマンドは、指定されたパラメータを使用して2つ目のJVMを呼び出します。次に、指定されたクラスをロードして、クラスの最初の命令を実行する前にJVMを停止させます。 .PP -\fIjdb\fRコマンドのもう1つの使用方法は、すでに実行中のJVMにjdbを接続することです。\fIjdb\fRコマンドが接続するVMを、その実行中に起動するための構文を次に示します。これは、インプロセス・デバッグ用ライブラリをロードし、接続の種類を指定します。 +\fBjdb\fRコマンドのもう1つの使用方法は、すでに実行中のJVMにjdbを接続することです。\fBjdb\fRコマンドが接続するVMを、その実行中に起動するための構文を次に示します。これは、インプロセス・デバッグ用ライブラリをロードし、接続の種類を指定します。 .sp .if n \{\ .RS 4 .\} .nf -java \-agentlib:jdwp=transport=dt_socket,server=y,suspend=n MyClass +\fBjava \-agentlib:jdwp=transport=dt_socket,server=y,suspend=n MyClass\fR + .fi .if n \{\ .RE .\} .PP -次のコマンドを使用して、\fIjdb\fRコマンドをJVMに接続できます。 +次のコマンドを使用して、\fBjdb\fRコマンドをJVMに接続できます。 .sp .if n \{\ .RS 4 .\} .nf -jdb \-attach 8000 +\fBjdb \-attach 8000\fR + .fi .if n \{\ .RE .\} .PP -この場合、\fIjdb\fRコマンドは新しいJVMを起動するかわりに既存のJVMに接続されるため、\fIjdb\fRコマンドラインに\fIMyClass\fR引数は指定しません。 +この場合、\fBjdb\fRコマンドは新しいJVMを起動するかわりに既存のJVMに接続されるため、\fBjdb\fRコマンド行に\fBMyClass\fR引数は指定しません。 .PP -デバッガをJVMに接続するには他にも様々な方法があり、すべて\fIjdb\fRコマンドでサポートされています。接続オプションについては、Java Platform Debugger Architectureのドキュメントを参照してください。 +デバッガをJVMに接続するには他にも様々な方法があり、すべて\fBjdb\fRコマンドでサポートされています。接続オプションについては、Java Platform Debugger Architectureのドキュメントを参照してください。 .SS "基本jdbコマンド" .PP -基本的な\fIjdb\fRコマンドの一覧を示します。JDBがサポートするコマンドはこれ以外にもあり、それらは\fI\-help\fRオプションを使用して表示できます。 +基本的な\fBjdb\fRコマンドの一覧を示します。JDBがサポートするコマンドはこれ以外にもあり、それらは\fB\-help\fRオプションを使用して表示できます。 .PP helpまたは? .RS 4 -\fIhelp\fRまたは\fI?\fRコマンドは、認識されたコマンドのリストに簡潔な説明を付けて表示します。 +\fBhelp\fRまたは\fB?\fRコマンドは、認識されたコマンドのリストに簡潔な説明を付けて表示します。 .RE .PP run .RS 4 -JDBを起動してブレークポイントを設定したあとに、\fIrun\fRコマンドを使用して、デバッグするアプリケーションの実行を開始できます。\fIrun\fRコマンドは、既存のVMに接続している場合とは異なり、デバッグするアプリケーションが\fIjdb\fRから起動したときにのみ使用できます。 +JDBを起動してブレークポイントを設定したあとに、\fBrun\fRコマンドを使用して、デバッグするアプリケーションの実行を開始できます。\fBrun\fRコマンドは、既存のVMに接続している場合とは異なり、デバッグするアプリケーションが\fBjdb\fRから起動したときにのみ使用できます。 .RE .PP cont @@ -147,19 +152,20 @@ Javaオブジェクトおよびプリミティブ値を表示します。プリミティブ型の変数またはフィールドの場合には、実際の値が出力されます。オブジェクトの場合には、短い説明が出力されます。オブジェクトの詳細を取得する方法を探すには、dumpコマンドを参照してください。 .sp \fB注意:\fR -ローカル変数を表示するには、含んでいるクラスが\fIjavac \-g\fRオプションを使用してコンパイルされている必要があります。 +ローカル変数を表示するには、含んでいるクラスが\fBjavac \-g\fRオプションを使用してコンパイルされている必要があります。 .sp -\fIprint\fRコマンドは、次に示すような、メソッド呼出しを使用したものなど、多くの簡単なJava式をサポートします。 +\fBprint\fRコマンドは、次に示すような、メソッド呼出しを使用したものなど、多くの簡単なJava式をサポートします。 .sp .if n \{\ .RS 4 .\} .nf -print MyClass\&.myStaticField -print myObj\&.myInstanceField -print i + j + k (i, j, k are primities and either fields or local variables) -print myObj\&.myMethod() (if myMethod returns a non\-null) -print new java\&.lang\&.String("Hello")\&.length() +\fBprint MyClass\&.myStaticField\fR +\fBprint myObj\&.myInstanceField\fR +\fBprint i + j + k (i, j, k are primities and either fields or local variables)\fR +\fBprint myObj\&.myMethod() (if myMethod returns a non\-null)\fR +\fBprint new java\&.lang\&.String("Hello")\&.length()\fR + .fi .if n \{\ .RE @@ -168,18 +174,19 @@ .PP dump .RS 4 -プリミティブ値の場合、\fIdump\fRコマンドは\fIprint\fRコマンドと同一です。オブジェクトの場合、\fIdump\fRコマンドでは、オブジェクト内に定義されている各フィールドの現在の値が出力されます。staticフィールドとinstanceフィールドが出力されます。\fIdump\fRコマンドでは、\fIprint\fRコマンドと同じ式がサポートされます。 +プリミティブ値の場合、\fBdump\fRコマンドは\fBprint\fRコマンドと同一です。オブジェクトの場合、\fBdump\fRコマンドでは、オブジェクト内に定義されている各フィールドの現在の値が出力されます。staticフィールドとinstanceフィールドが出力されます。\fBdump\fRコマンドでは、\fBprint\fRコマンドと同じ式がサポートされます。 .RE .PP threads .RS 4 -現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、および他のコマンドに使用できるインデックスが出力されます。この例では、スレッド・インデックスは4であり、スレッドは\fIjava\&.lang\&.Thread\fRのインスタンスで、スレッドの名前は\fImain\fRであり、現在実行中です。 +現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、および他のコマンドに使用できるインデックスが出力されます。この例では、スレッド・インデックスは4であり、スレッドは\fBjava\&.lang\&.Thread\fRのインスタンスで、スレッドの名前は\fBmain\fRであり、現在実行中です。 .sp .if n \{\ .RS 4 .\} .nf -4\&. (java\&.lang\&.Thread)0x1 main running +\fB4\&. (java\&.lang\&.Thread)0x1 main running\fR + .fi .if n \{\ .RE @@ -188,16 +195,16 @@ .PP thread .RS 4 -現在のスレッドにするスレッドを選択します。多くの\fIjdb\fRコマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、threadsコマンドで説明したスレッド・インデックスとともに指定します。 +現在のスレッドにするスレッドを選択します。多くの\fBjdb\fRコマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、threadsコマンドで説明したスレッド・インデックスとともに指定します。 .RE .PP where .RS 4 -引数を指定しないで\fIwhere\fRコマンドを実行すると、現在のスレッドのスタックがダンプされます。\fIwhere\fR -\fIall\fRコマンドは、現在のスレッド・グループにあるスレッドのスタックをすべてダンプします。\fIwhere\fR -\fIthreadindex\fRコマンドは、指定されたスレッドのスタックをダンプします。 +引数を指定しないで\fBwhere\fRコマンドを実行すると、現在のスレッドのスタックがダンプされます。\fBwhere\fR +\fBall\fRコマンドは、現在のスレッド・グループにあるスレッドのスタックをすべてダンプします。\fBwhere\fR +\fBthreadindex\fRコマンドは、指定されたスレッドのスタックをダンプします。 .sp -現在のスレッドが(ブレークポイントか\fIsuspend\fRコマンドによって)中断している場合は、ローカル変数とフィールドは\fIprint\fRコマンドと\fIdump\fRコマンドで表示できます。\fIup\fRコマンドと\fIdown\fRコマンドで、どのスタック・フレームを現在のスタック・フレームにするかを選ぶことができます。 +現在のスレッドが(ブレークポイントか\fBsuspend\fRコマンドによって)中断している場合は、ローカル変数とフィールドは\fBprint\fRコマンドと\fBdump\fRコマンドで表示できます。\fBup\fRコマンドと\fBdown\fRコマンドで、どのスタック・フレームを現在のスタック・フレームにするかを選ぶことができます。 .RE .SS "ブレークポイント" .PP @@ -211,7 +218,7 @@ .sp -1 .IP \(bu 2.3 .\} -コマンド\fIstop at MyClass:22\fRは、\fIMyClass\fRが含まれるソース・ファイルの22行目の最初の命令にブレークポイントを設定します。 +コマンド\fBstop at MyClass:22\fRは、\fBMyClass\fRが含まれるソース・ファイルの22行目の最初の命令にブレークポイントを設定します。 .RE .sp .RS 4 @@ -222,7 +229,7 @@ .sp -1 .IP \(bu 2.3 .\} -コマンド\fIstop in java\&.lang\&.String\&.length\fRは、メソッド\fIjava\&.lang\&.String\&.length\fRの先頭にブレークポイントを設定します。 +コマンド\fBstop in java\&.lang\&.String\&.length\fRは、メソッド\fBjava\&.lang\&.String\&.length\fRの先頭にブレークポイントを設定します。 .RE .sp .RS 4 @@ -233,26 +240,26 @@ .sp -1 .IP \(bu 2.3 .\} -コマンド\fIstop in MyClass\&.<clinit>\fRは、\fI<clinit>\fRを使用して\fIMyClass\fRの静的初期化コードを特定します。 +コマンド\fBstop in MyClass\&.<clinit>\fRは、\fB<clinit>\fRを使用して、\fBMyClass\fRの静的初期化コードを特定します。 .RE .PP -メソッドがオーバーロードされている場合には、メソッドの引数の型も指定して、ブレークポイントに対して適切なメソッドが選択されるようにする必要があります。たとえば、\fIMyClass\&.myMethod(int,java\&.lang\&.String)\fRまたは\fIMyClass\&.myMethod()\fRと指定します。 +メソッドがオーバーロードされている場合には、メソッドの引数の型も指定して、ブレークポイントに対して適切なメソッドが選択されるようにする必要があります。たとえば、\fBMyClass\&.myMethod(int,java\&.lang\&.String)\fRまたは\fBMyClass\&.myMethod()\fRと指定します。 .PP -\fIclear\fRコマンドは、\fIclear MyClass:45\fRのような構文を使用してブレークポイントを削除します。\fIclear\fRを使用するか、引数を指定しないで\fIstop\fRコマンドを使用すると、現在設定されているすべてのブレークポイントが表示されます。\fIcont\fRコマンドは実行を継続します。 +\fBclear\fRコマンドは、\fBclear MyClass:45\fRのような構文を使用してブレークポイントを削除します。\fBclear\fRを使用するか、引数を指定しないで\fBstop\fRコマンドを使用すると、現在設定されているすべてのブレークポイントが表示されます。\fBcont\fRコマンドは実行を継続します。 .SS "ステップ実行" .PP -\fIstep\fRコマンドは、現在のスタック・フレームまたは呼び出されたメソッド内で、次の行を実行します。\fInext\fRコマンドは、現在のスタック・フレームの次の行を実行します。 +\fBstep\fRコマンドは、現在のスタック・フレームまたは呼び出されたメソッド内で、次の行を実行します。\fBnext\fRコマンドは、現在のスタック・フレームの次の行を実行します。 .SS "例外" .PP -スローしているスレッドの呼出しスタック上のどこにも\fIcatch\fR文がない場合に例外が発生すると、JVMは通常、例外トレースを出力して終了します。ただし、JDB環境で実行している場合は、違反のスロー時にJDBに制御が戻ります。次に、\fIjdb\fRコマンドを使用して例外の原因を診断します。 +スローしているスレッドの呼出しスタック上のどこにも\fBcatch\fR文がない場合に例外が発生すると、JVMは通常、例外トレースを出力して終了します。ただし、JDB環境で実行している場合は、違反のスロー時にJDBに制御が戻ります。次に、\fBjdb\fRコマンドを使用して例外の原因を診断します。 .PP -たとえば、\fIcatch java\&.io\&.FileNotFoundException\fRまたは\fIcatch\fR -\fImypackage\&.BigTroubleException\fRのように\fIcatch\fRコマンドを使用すると、デバッグされたアプリケーションは、他の例外がスローされたときに停止します。例外が特定のクラスまたはサブクラスのインスタンスの場合は、アプリケーションは例外がスローされた場所で停止します。 +たとえば、\fBcatch java\&.io\&.FileNotFoundException\fRまたは\fBcatch\fR +\fBmypackage\&.BigTroubleException\fRのように\fBcatch\fRコマンドを使用すると、デバッグされたアプリケーションは、他の例外がスローされたときに停止します。例外が特定のクラスまたはサブクラスのインスタンスの場合は、アプリケーションは例外がスローされた場所で停止します。 .PP -\fIignore\fRコマンドを使用すると、以前の\fIcatch\fRコマンドの効果が無効になります。\fIignore\fRコマンドでは、デバッグされるJVMは特定の例外を無視せず、デバッガのみを無視します。 +\fBignore\fRコマンドを使用すると、以前の\fBcatch\fRコマンドの効果が無効になります。\fBignore\fRコマンドでは、デバッグされるJVMは特定の例外を無視せず、デバッガのみを無視します。 .SH "オプション" .PP -コマンドラインで\fIjava\fRコマンドのかわりに\fIjdb\fRコマンドを使用する場合、\fIjdb\fRコマンドは、\fI\-D\fR、\fI\-classpath\fR、\fI\-X\fRなど、\fIjava\fRコマンドと同じ数のオプションを受け入れます。\fIjdb\fRコマンドは、その他に次のリストにあるオプションを受け入れます。 +コマンド行で\fBjava\fRコマンドのかわりに\fBjdb\fRコマンドを使用する場合、\fBjdb\fRコマンドは、\fB\-D\fR、\fB\-classpath\fR、\fB\-X\fRなど、\fBjava\fRコマンドと同じ数のオプションを受け入れます。\fBjdb\fRコマンドは、その他に次のリストにあるオプションを受け入れます。 .PP デバッグを行うJVMにデバッガを接続するための代替機構を提供するために、その他のオプションがサポートされています。これらの接続の代替に関する詳細なドキュメントは、Java Platform Debugger Architecture (JPDA) (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jpda/index\&.html)を参照してください @@ -279,7 +286,7 @@ .PP \-launch .RS 4 -デバッグするアプリケーションをJDBの起動後ただちに起動します。\fI\-launch\fRオプションにより、\fIrun\fRコマンドが必要なくなります。デバッグするアプリケーションは、起動後、初期アプリケーション・クラスがロードされる直前に停止します。その時点で、必要なブレークポイントを設定し、\fIcont\fRコマンドを使用して実行を継続できます。 +デバッグするアプリケーションをJDBの起動後ただちに起動します。\fB\-launch\fRオプションにより、\fBrun\fRコマンドが必要なくなります。デバッグするアプリケーションは、起動後、初期アプリケーション・クラスがロードされる直前に停止します。その時点で、必要なブレークポイントを設定し、\fBcont\fRコマンドを使用して実行を継続できます。 .RE .PP \-listconnectors @@ -294,7 +301,7 @@ .PP \-dbgtrace [\fIflags\fR] .RS 4 -\fIjdb\fRコマンドのデバッグの情報を出力します。 +\fBjdb\fRコマンドのデバッグの情報を出力します。 .RE .PP \-tclient @@ -309,7 +316,7 @@ .PP \-J\fIoption\fR .RS 4 -JVMに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +JVMに\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "デバッグ対象のプロセスに転送されるオプション" .PP
--- a/src/solaris/doc/sun/man/man1/ja/jdeps.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jdeps.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jdeps -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2013, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jdeps +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jdeps" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jdeps \- Javaクラス依存性アナライザ。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjdeps\fR [\fIoptions\fR] \fIclasses\fR \&.\&.\&. +\fBjdeps\fR [\fIoptions\fR] \fIclasses\fR \&.\&.\&. .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIclasses\fR @@ -73,20 +75,24 @@ .RE .SH "説明" .PP -\fIjdeps\fRコマンドは、Javaクラス・ファイルのパッケージレベルまたはクラスレベルの依存性を示します。入力クラスには、\fI\&.class\fRファイルのパス名、ディレクトリ、JARファイル、またはすべてのクラス・ファイルを分析するための完全修飾クラス名を指定できます。オプションにより出力が決定します。デフォルトでは、\fIjdeps\fRはシステム出力に依存関係を出力します。DOT言語で依存関係を生成できます(\fI\-dotoutput\fRオプションを参照)。 +\fBjdeps\fRコマンドは、Javaクラス・ファイルのパッケージレベルまたはクラスレベルの依存性を示します。入力クラスには、\fB\&.class\fRファイルのパス名、ディレクトリ、JARファイル、またはすべてのクラス・ファイルを分析するための完全修飾クラス名を指定できます。オプションにより出力が決定します。デフォルトでは、\fBjdeps\fRはシステム出力に依存関係を出力します。DOT言語で依存関係を生成できます(\fB\-dotoutput\fRオプションを参照)。 .SH "オプション" .PP \-dotoutput <\fIdir\fR> .RS 4 -DOTファイル出力の宛先ディレクトリ。指定した場合は\fIjdeps\fRは<\fIarchive\-file\-name\fR>\&.dotという名前の分析済みアーカイブごとに依存関係をリストする1つのdotファイルを生成し、アーカイブ間の依存関係をリストするsummary\&.dotという名前のサマリー・ファイルも生成します。 +DOTファイル出力の宛先ディレクトリ。指定した場合、\fBjdeps\fRは<\fIarchive\-file\-name\fR>\&.dotという名前の分析済アーカイブごとに依存関係をリストする1つのdotファイルを生成し、アーカイブ間の依存関係をリストするsummary\&.dotという名前のサマリー・ファイルも生成します。 .RE .PP -\-s, \-summary +\-s +.br +\-summary .RS 4 依存関係のサマリーのみを出力します。 .RE .PP -\-v, \-verbose +\-v +.br +\-verbose .RS 4 すべてのクラスレベルの依存関係を出力します。 .RE @@ -101,46 +107,56 @@ 同じアーカイブ内の依存関係を除き、クラスレベルの依存関係を出力します。 .RE .PP -\-cp <\fIpath\fR>, \-classpath <\fIpath\fR> +\-cp <\fIpath\fR> +.br +\-classpath <\fIpath\fR> .RS 4 クラス・ファイルの検索場所を指定します。 .sp Setting the Class Path も参照してください。 .RE .PP -\-p <\fIpkg name\fR>, \-package <\fIpkg name\fR> +\-p <\fIpkg name\fR> +.br +\-package <\fIpkg name\fR> .RS 4 -指定したパッケージの依存関係を検出します。異なるパッケージに対してこのオプションを複数回指定できます。\fI\-p\fRオプションと\fI\-e\fRオプションを同時に指定することはできません。 +指定したパッケージの依存関係を検出します。異なるパッケージに対してこのオプションを複数回指定できます。\fB\-p\fRオプションと\fB\-e\fRオプションを同時に指定することはできません。 .RE .PP -\-e <\fIregex\fR>, \-regex <\fIregex\fR> +\-e <\fIregex\fR> +.br +\-regex <\fIregex\fR> .RS 4 -指定した正規表現パターンと一致するパッケージの依存関係を検出します。\fI\-p\fRオプションと\fI\-e\fRオプションを同時に指定することはできません。 +指定した正規表現パターンと一致するパッケージの依存関係を検出します。\fB\-p\fRオプションと\fB\-e\fRオプションを同時に指定することはできません。 .RE .PP \-include <\fIregex\fR> .RS 4 -分析をパターンに一致するクラスに制限します。このオプションは、分析するクラスのリストをフィルタします。依存関係にパターンを適用する\fI\-p\fRおよび\fI\-e\fRとともに使用できます。 +分析をパターンに一致するクラスに制限します。このオプションは、分析するクラスのリストをフィルタします。依存関係にパターンを適用する\fB\-p\fRおよび\fB\-e\fRとともに使用できます。 .RE .PP \-jdkinternals .RS 4 -JDKの内部APIのクラスレベルの依存関係を検出します。デフォルトでは、\fI\-include\fRオプションを指定しないかぎり、\fI\-classpath\fRオプションおよび入力ファイルに指定されたすべてのクラスを分析します。このオプションは、\fI\-p\fRオプション、\fI\-e\fRオプションおよび\fI\-s\fRオプションとともに使用できません。 +JDKの内部APIのクラスレベルの依存関係を検出します。デフォルトでは、\fB\-include\fRオプションを指定しないかぎり、\fB\-classpath\fRオプションおよび入力ファイルに指定されたすべてのクラスを分析します。このオプションは、\fB\-p\fRオプション、\fB\-e\fRオプションおよび\fB\-s\fRオプションとともに使用できません。 .sp \fB警告\fR: JDKの内部APIは、今後のリリースでアクセスできなくなる可能性があります。 .RE .PP -\-P, \-profile +\-P +.br +\-profile .RS 4 パッケージを含むプロファイルまたはファイルを表示します。 .RE .PP \-apionly .RS 4 -フィールド・タイプ、メソッド・パラメータ・タイプ、戻りタイプ、チェックされた例外タイプを含むパブリック・クラスの\fIpublic\fRおよび\fIprotected\fRメンバーの署名からの依存関係など、分析をAPIに制限します。 +フィールド・タイプ、メソッド・パラメータ・タイプ、戻りタイプ、チェックされた例外タイプを含むパブリック・クラスの\fBpublic\fRおよび\fBprotected\fRメンバーの署名からの依存関係など、分析をAPIに制限します。 .RE .PP -\-R, \-recursive +\-R +.br +\-recursive .RS 4 すべての依存関係を再帰的に走査します。 .RE @@ -150,9 +166,13 @@ バージョン情報を出力します。 .RE .PP -\-h, \-?, \-help +\-h +.br +\-? +.br +\-help .RS 4 -\fIjdeps\fRに関するヘルプ・メッセージを出力します。 +\fBjdeps\fRに関するヘルプ・メッセージを出力します。 .RE .SH "例" .PP @@ -162,24 +182,25 @@ .RS 4 .\} .nf -$ jdeps demo/jfc/Notepad/Notepad\&.jar +\fB$ jdeps demo/jfc/Notepad/Notepad\&.jar\fR +\fB \fR +\fBdemo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar\fR +\fB <unnamed> (Notepad\&.jar)\fR +\fB \-> java\&.awt \fR +\fB \-> java\&.awt\&.event \fR +\fB \-> java\&.beans \fR +\fB \-> java\&.io \fR +\fB \-> java\&.lang \fR +\fB \-> java\&.net \fR +\fB \-> java\&.util \fR +\fB \-> java\&.util\&.logging \fR +\fB \-> javax\&.swing \fR +\fB \-> javax\&.swing\&.border \fR +\fB \-> javax\&.swing\&.event \fR +\fB \-> javax\&.swing\&.text \fR +\fB \-> javax\&.swing\&.tree \fR +\fB \-> javax\&.swing\&.undo \fR -demo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar - <unnamed> (Notepad\&.jar) - \-> java\&.awt - \-> java\&.awt\&.event - \-> java\&.beans - \-> java\&.io - \-> java\&.lang - \-> java\&.net - \-> java\&.util - \-> java\&.util\&.logging - \-> javax\&.swing - \-> javax\&.swing\&.border - \-> javax\&.swing\&.event - \-> javax\&.swing\&.text - \-> javax\&.swing\&.tree - \-> javax\&.swing\&.undo .fi .if n \{\ .RE @@ -191,115 +212,119 @@ .RS 4 .\} .nf -$ jdeps \-profile demo/jfc/Notepad/Notepad\&.jar -demo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar (Full JRE) - <unnamed> (Notepad\&.jar) - \-> java\&.awt Full JRE - \-> java\&.awt\&.event Full JRE - \-> java\&.beans Full JRE - \-> java\&.io compact1 - \-> java\&.lang compact1 - \-> java\&.net compact1 - \-> java\&.util compact1 - \-> java\&.util\&.logging compact1 - \-> javax\&.swing Full JRE - \-> javax\&.swing\&.border Full JRE - \-> javax\&.swing\&.event Full JRE - \-> javax\&.swing\&.text Full JRE - \-> javax\&.swing\&.tree Full JRE - \-> javax\&.swing\&.undo Full JRE +\fB$ jdeps \-profile demo/jfc/Notepad/Notepad\&.jar \fR +\fBdemo/jfc/Notepad/Notepad\&.jar \-> /usr/java/jre/lib/rt\&.jar (Full JRE)\fR +\fB <unnamed> (Notepad\&.jar)\fR +\fB \-> java\&.awt Full JRE\fR +\fB \-> java\&.awt\&.event Full JRE\fR +\fB \-> java\&.beans Full JRE\fR +\fB \-> java\&.io compact1\fR +\fB \-> java\&.lang compact1\fR +\fB \-> java\&.net compact1\fR +\fB \-> java\&.util compact1\fR +\fB \-> java\&.util\&.logging compact1\fR +\fB \-> javax\&.swing Full JRE\fR +\fB \-> javax\&.swing\&.border Full JRE\fR +\fB \-> javax\&.swing\&.event Full JRE\fR +\fB \-> javax\&.swing\&.text Full JRE\fR +\fB \-> javax\&.swing\&.tree Full JRE\fR +\fB \-> javax\&.swing\&.undo Full JRE\fR + .fi .if n \{\ .RE .\} .PP -tools\&.jarファイル内の\fIcom\&.sun\&.tools\&.jdeps\&.Main\fRクラスなど、特定のクラスパス内の特定のクラスの直接依存関係の分析。 +tools\&.jarファイル内の\fBcom\&.sun\&.tools\&.jdeps\&.Main\fRクラスなど、特定のクラスパス内の特定のクラスの直接依存関係の分析。 .sp .if n \{\ .RS 4 .\} .nf -$ jdeps \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main -lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar - com\&.sun\&.tools\&.jdeps (tools\&.jar) - \-> java\&.io - \-> java\&.lang +\fB$ jdeps \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main\fR +\fBlib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar\fR +\fB com\&.sun\&.tools\&.jdeps (tools\&.jar)\fR +\fB \-> java\&.io \fR +\fB \-> java\&.lang \fR + .fi .if n \{\ .RE .\} .PP -\fI\-verbose:class\fRオプションを使用して、クラスレベル依存関係を検索するか\fI\-v\fRまたは\fI\-verbose\fRオプションを使用して同じJARファイルからの依存関係を含めます。 +\fB\-verbose:class\fRオプションを使用して、クラスレベル依存関係を検索するか\fB\-v\fRまたは\fB\-verbose\fRオプションを使用して同じJARファイルからの依存関係を含めます。 .sp .if n \{\ .RS 4 .\} .nf -$ jdeps \-verbose:class \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main +\fB$ jdeps \-verbose:class \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main\fR +\fB \fR +\fBlib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar\fR +\fB com\&.sun\&.tools\&.jdeps\&.Main (tools\&.jar)\fR +\fB \-> java\&.io\&.PrintWriter \fR +\fB \-> java\&.lang\&.Exception \fR +\fB \-> java\&.lang\&.Object \fR +\fB \-> java\&.lang\&.String \fR +\fB \-> java\&.lang\&.System \fR -lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar - com\&.sun\&.tools\&.jdeps\&.Main (tools\&.jar) - \-> java\&.io\&.PrintWriter - \-> java\&.lang\&.Exception - \-> java\&.lang\&.Object - \-> java\&.lang\&.String - \-> java\&.lang\&.System .fi .if n \{\ .RE .\} .PP -\fI\-R\fRまたは\fI\-recursive\fRオプションを使用して、\fIcom\&.sun\&.tools\&.jdeps\&.Main\fRクラスの推移的な依存関係を分析します。 +\fB\-R\fRまたは\fB\-recursive\fRオプションを使用して、\fBcom\&.sun\&.tools\&.jdeps\&.Main\fRクラスの推移的な依存関係を分析します。 .sp .if n \{\ .RS 4 .\} .nf -$ jdeps \-R \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main -lib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar - com\&.sun\&.tools\&.classfile (tools\&.jar) - \-> java\&.io - \-> java\&.lang - \-> java\&.lang\&.reflect - \-> java\&.nio\&.charset - \-> java\&.nio\&.file - \-> java\&.util - \-> java\&.util\&.regex - com\&.sun\&.tools\&.jdeps (tools\&.jar) - \-> java\&.io - \-> java\&.lang - \-> java\&.nio\&.file - \-> java\&.nio\&.file\&.attribute - \-> java\&.text - \-> java\&.util - \-> java\&.util\&.jar - \-> java\&.util\&.regex - \-> java\&.util\&.zip -/usr/java/jre/lib/jce\&.jar \-> /usr/java/jre/lib/rt\&.jar - javax\&.crypto (jce\&.jar) - \-> java\&.io - \-> java\&.lang - \-> java\&.lang\&.reflect - \-> java\&.net - \-> java\&.nio - \-> java\&.security - \-> java\&.security\&.cert - \-> java\&.security\&.spec - \-> java\&.util - \-> java\&.util\&.concurrent - \-> java\&.util\&.jar - \-> java\&.util\&.regex - \-> java\&.util\&.zip - \-> javax\&.security\&.auth - \-> sun\&.security\&.jca JDK internal API (rt\&.jar) - \-> sun\&.security\&.util JDK internal API (rt\&.jar) - javax\&.crypto\&.spec (jce\&.jar) - \-> java\&.lang - \-> java\&.security\&.spec - \-> java\&.util -/usr/java/jre/lib/rt\&.jar \-> /usr/java/jre/lib/jce\&.jar - java\&.security (rt\&.jar) - \-> javax\&.crypto +\fB$ jdeps \-R \-cp lib/tools\&.jar com\&.sun\&.tools\&.jdeps\&.Main\fR +\fBlib/tools\&.jar \-> /usr/java/jre/lib/rt\&.jar\fR +\fB com\&.sun\&.tools\&.classfile (tools\&.jar)\fR +\fB \-> java\&.io \fR +\fB \-> java\&.lang \fR +\fB \-> java\&.lang\&.reflect \fR +\fB \-> java\&.nio\&.charset \fR +\fB \-> java\&.nio\&.file \fR +\fB \-> java\&.util \fR +\fB \-> java\&.util\&.regex \fR +\fB com\&.sun\&.tools\&.jdeps (tools\&.jar)\fR +\fB \-> java\&.io \fR +\fB \-> java\&.lang \fR +\fB \-> java\&.nio\&.file \fR +\fB \-> java\&.nio\&.file\&.attribute \fR +\fB \-> java\&.text \fR +\fB \-> java\&.util \fR +\fB \-> java\&.util\&.jar \fR +\fB \-> java\&.util\&.regex \fR +\fB \-> java\&.util\&.zip \fR +\fB/usr/java/jre/lib/jce\&.jar \-> /usr/java/jre/lib/rt\&.jar\fR +\fB javax\&.crypto (jce\&.jar)\fR +\fB \-> java\&.io \fR +\fB \-> java\&.lang \fR +\fB \-> java\&.lang\&.reflect \fR +\fB \-> java\&.net \fR +\fB \-> java\&.nio \fR +\fB \-> java\&.security \fR +\fB \-> java\&.security\&.cert \fR +\fB \-> java\&.security\&.spec \fR +\fB \-> java\&.util \fR +\fB \-> java\&.util\&.concurrent \fR +\fB \-> java\&.util\&.jar \fR +\fB \-> java\&.util\&.regex \fR +\fB \-> java\&.util\&.zip \fR +\fB \-> javax\&.security\&.auth \fR +\fB \-> sun\&.security\&.jca JDK internal API (rt\&.jar)\fR +\fB \-> sun\&.security\&.util JDK internal API (rt\&.jar)\fR +\fB javax\&.crypto\&.spec (jce\&.jar)\fR +\fB \-> java\&.lang \fR +\fB \-> java\&.security\&.spec \fR +\fB \-> java\&.util \fR +\fB/usr/java/jre/lib/rt\&.jar \-> /usr/java/jre/lib/jce\&.jar\fR +\fB java\&.security (rt\&.jar)\fR +\fB \-> javax\&.crypto\fR + .fi .if n \{\ .RE @@ -311,41 +336,43 @@ .RS 4 .\} .nf -$ jdeps \-dotoutput dot demo/jfc/Notepad/Notepad\&.jar +\fB$ jdeps \-dotoutput dot demo/jfc/Notepad/Notepad\&.jar\fR + .fi .if n \{\ .RE .\} .PP -\fIjdeps\fRは、\fI\-dotoutput\fRオプションで指定されたdotディレクトリに<\fIfilename\fR>\&.dotという名前のdotファイルを特定のJARファイルごとに作成し、JARファイル間の依存関係をリストするsummary\&.dotという名前のサマリー・ファイルも作成します +\fBjdeps\fRは、\fB\-dotoutput\fRオプションで指定されたdotディレクトリに<\fIfilename\fR>\&.dotという名前のdotファイルを特定のJARファイルごとに作成し、JARファイル間の依存関係をリストするsummary\&.dotという名前のサマリー・ファイルも作成します .sp .if n \{\ .RS 4 .\} .nf -$ cat dot/Notepad\&.jar\&.dot -digraph "Notepad\&.jar" { - // Path: demo/jfc/Notepad/Notepad\&.jar - "<unnamed>" \-> "java\&.awt"; - "<unnamed>" \-> "java\&.awt\&.event"; - "<unnamed>" \-> "java\&.beans"; - "<unnamed>" \-> "java\&.io"; - "<unnamed>" \-> "java\&.lang"; - "<unnamed>" \-> "java\&.net"; - "<unnamed>" \-> "java\&.util"; - "<unnamed>" \-> "java\&.util\&.logging"; - "<unnamed>" \-> "javax\&.swing"; - "<unnamed>" \-> "javax\&.swing\&.border"; - "<unnamed>" \-> "javax\&.swing\&.event"; - "<unnamed>" \-> "javax\&.swing\&.text"; - "<unnamed>" \-> "javax\&.swing\&.tree"; - "<unnamed>" \-> "javax\&.swing\&.undo"; -} +\fB$ cat dot/Notepad\&.jar\&.dot \fR +\fBdigraph "Notepad\&.jar" {\fR +\fB // Path: demo/jfc/Notepad/Notepad\&.jar\fR +\fB "<unnamed>" \-> "java\&.awt";\fR +\fB "<unnamed>" \-> "java\&.awt\&.event";\fR +\fB "<unnamed>" \-> "java\&.beans";\fR +\fB "<unnamed>" \-> "java\&.io";\fR +\fB "<unnamed>" \-> "java\&.lang";\fR +\fB "<unnamed>" \-> "java\&.net";\fR +\fB "<unnamed>" \-> "java\&.util";\fR +\fB "<unnamed>" \-> "java\&.util\&.logging";\fR +\fB "<unnamed>" \-> "javax\&.swing";\fR +\fB "<unnamed>" \-> "javax\&.swing\&.border";\fR +\fB "<unnamed>" \-> "javax\&.swing\&.event";\fR +\fB "<unnamed>" \-> "javax\&.swing\&.text";\fR +\fB "<unnamed>" \-> "javax\&.swing\&.tree";\fR +\fB "<unnamed>" \-> "javax\&.swing\&.undo";\fR +\fB}\fR +\fB \fR +\fB$ cat dot/summary\&.dot\fR +\fBdigraph "summary" {\fR +\fB "Notepad\&.jar" \-> "rt\&.jar";\fR +\fB}\fR -$ cat dot/summary\&.dot -digraph "summary" { - "Notepad\&.jar" \-> "rt\&.jar"; -} .fi .if n \{\ .RE
--- a/src/solaris/doc/sun/man/man1/ja/jhat.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jhat.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jhat -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2006, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jhat +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jhat" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jhat \- Javaヒープを分析します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjhat\fR [ \fIoptions\fR ] \fIheap\-dump\-file\fR +\fBjhat\fR [ \fIoptions\fR ] \fIheap\-dump\-file\fR .fi .if n \{\ .RE @@ -64,16 +66,16 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIheap\-dump\-file\fR .RS 4 -ブラウズ対象となるJavaバイナリ・ヒープ・ダンプ・ファイル。複数のヒープ・ダンプを含むダンプ・ファイルの場合、\fImyfile\&.hprof#3\fRのようにファイル名の後に\fI#<number>\fRを付加することで、ファイル内の特定のダンプを指定できます。 +ブラウズ対象となるJavaバイナリ・ヒープ・ダンプ・ファイル。複数のヒープ・ダンプを含むダンプ・ファイルの場合、\fBmyfile\&.hprof#3\fRのようにファイル名の後に\fB#<number>\fRを付加することで、ファイル内の特定のダンプを指定できます。 .RE .SH "説明" .PP -\fIjhat\fRコマンドはJavaヒープ・ダンプ・ファイルを解析し、Webサーバーを開始します。\fIjhat\fRコマンドを使用して、お気に入りのブラウザでヒープ・ダンプを参照できます。\fIjhat\fRコマンドは、既知のクラス\fIMyClass\fRのすべてのインスタンスを表示するなどの事前設計済の問合せやObject Query Language (OQL)をサポートします。ヒープ・ダンプの問合せを除き、OQLはSQLに似ています。OQLのヘルプには、\fIjhat\fRコマンドによって表示されるOQLヘルプ・ページからアクセスできます。デフォルト・ポートを使用する場合、OQLのヘルプはhttp://localhost:7000/oqlhelp/で利用可能です。 +\fBjhat\fRコマンドはJavaヒープ・ダンプ・ファイルを解析し、Webサーバーを開始します。\fBjhat\fRコマンドを使用して、お気に入りのブラウザでヒープ・ダンプを参照できます。\fBjhat\fRコマンドは、既知のクラス\fBMyClass\fRのすべてのインスタンスを表示するなどの事前設計済の問合せやObject Query Language (OQL)をサポートします。ヒープ・ダンプの問合せを除き、OQLはSQLに似ています。OQLのヘルプには、\fBjhat\fRコマンドによって表示されるOQLヘルプ・ページからアクセスできます。デフォルト・ポートを使用する場合、OQLのヘルプはhttp://localhost:7000/oqlhelp/で利用可能です。 .PP Javaのヒープ・ダンプを生成するには、次のいくつかの方法があります。 .sp @@ -85,7 +87,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIjmap \-dump\fRオプションを使用して実行時にヒープ・ダンプを取得します。jmap(1)を参照してください。 +\fBjmap \-dump\fRオプションを使用して実行時にヒープ・ダンプを取得します。jmap(1)を参照してください。 .RE .sp .RS 4 @@ -96,7 +98,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fIjconsole\fRオプションを使用して\fIHotSpotDiagnosticMXBean\fR経由で実行時にヒープ・ダンプを取得します。jconsole(1)および\fIHotSpotDiagnosticMXBean\fRのインタフェースの説明( +\fBjconsole\fRオプションを使用して\fBHotSpotDiagnosticMXBean\fR経由で実行時にヒープ・ダンプを取得します。jconsole(1)および\fBHotSpotDiagnosticMXBean\fRのインタフェースの説明( http://docs\&.oracle\&.com/javase/8/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean\&.html)を参照してください。 .RE .sp @@ -108,8 +110,8 @@ .sp -1 .IP \(bu 2.3 .\} -ヒープ・ダンプは、\fI\-XX:+HeapDumpOnOutOfMemoryError\fR -Java仮想マシン(JVM)オプションを指定することで、\fIOutOfMemoryError\fRがスローされたときに生成されます。 +ヒープ・ダンプは、\fB\-XX:+HeapDumpOnOutOfMemoryError\fR +Java Virtual Machine (JVM)オプションを指定することで、\fBOutOfMemoryError\fRがスローされたときに生成されます。 .RE .sp .RS 4 @@ -120,29 +122,29 @@ .sp -1 .IP \(bu 2.3 .\} -\fIhprof\fRコマンドを使用します。HPROF: Heap/CPUプロファイリング・ツール +\fBhprof\fRコマンドを使用します。HPROF: Heap/CPUプロファイリング・ツール (http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/hprof\&.html)を参照してください .RE .SH "オプション" .PP \-stack false|true .RS 4 -オブジェクト割当呼出しスタックの追跡を無効にします。ヒープ・ダンプ内で割当サイト情報が使用できない場合、このフラグを\fIfalse\fRに設定する必要があります。デフォルトは\fItrue\fRです。 +オブジェクト割当呼出しスタックの追跡を無効にします。ヒープ・ダンプ内で割当サイト情報が使用できない場合、このフラグを\fBfalse\fRに設定する必要があります。デフォルトは\fBtrue\fRです。 .RE .PP \-refs false|true .RS 4 -オブジェクトへの参照の追跡を無効にします。デフォルトは\fItrue\fRです。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ(指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる)が計算されます。 +オブジェクトへの参照の追跡を無効にします。デフォルトは\fBtrue\fRです。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ(指定されたオブジェクトをポイントしているオブジェクト。参照者または受信参照とも呼ばれる)が計算されます。 .RE .PP \-port \fIport\-number\fR .RS 4 -\fIjhat\fRのHTTPサーバーのポートを設定します。デフォルトは7000です。 +\fBjhat\fRのHTTPサーバーのポートを設定します。デフォルトは7000です。 .RE .PP \-exclude \fIexclude\-file\fR .RS 4 -到達可能なオブジェクトの問合せから除外する必要があるデータ・メンバーの一覧を含むファイルを指定します。たとえば、このファイルに\fIjava\&.lang\&.String\&.value\fRが含まれていた場合、特定のオブジェクト\fIo\fRから到達可能なオブジェクトのリストを計算する際に、\fIjava\&.lang\&.String\&.value\fRフィールドに関連する参照パスが考慮されなくなります。 +到達可能なオブジェクトの問合せから除外する必要があるデータ・メンバーの一覧を含むファイルを指定します。たとえば、このファイルに\fBjava\&.lang\&.String\&.value\fRが含まれていた場合、特定のオブジェクト\fBo\fRから到達可能なオブジェクトのリストを計算する際に、\fBjava\&.lang\&.String\&.value\fRフィールドに関連する参照パスが考慮されなくなります。 .RE .PP \-baseline \fIexclude\-file\fR @@ -172,7 +174,7 @@ .PP \-J\fIflag\fR .RS 4 -\fIjhat\fRコマンドを実行しているJava仮想マシンに\fIflag\fRを渡します。たとえば、512Mバイトの最大ヒープ・サイズを使用するには、\fI\-J\-Xmx512m\fRとします。 +\fBjhat\fRコマンドを実行しているJava Virtual Machineに\fBflag\fRを渡します。たとえば、512Mバイトの最大ヒープ・サイズを使用するには、\fB\-J\-Xmx512m\fRとします。 .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/jinfo.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jinfo.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jinfo -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jinfo +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jinfo" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jinfo \- 構成情報を生成します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjinfo\fR [ \fIoption\fR ] \fIpid\fR +\fBjinfo\fR [ \fIoption\fR ] \fIpid\fR .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjinfo\fR [ \fIoption \fR] \fIexecutable core\fR +\fBjinfo\fR [ \fIoption \fR] \fIexecutable core\fR .fi .if n \{\ .RE @@ -76,7 +78,7 @@ .RS 4 .\} .nf -\fIjinfo\fR [ \fIoption \fR] \fI[ servier\-id ] remote\-hostname\-or\-IP\fR +\fBjinfo\fR [ \fIoption \fR] \fI[ servier\-id ] remote\-hostname\-or\-IP\fR .fi .if n \{\ .RE @@ -84,7 +86,7 @@ .PP \fIオプション\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIpid\fR @@ -104,7 +106,7 @@ .PP \fIremote\-hostname\-or\-IP\fR .RS 4 -リモート・デバッグ・サーバーの\fIホスト名\fRまたは\fIIP\fRアドレス。jsadebugd(1)を参照してください。 +リモート・デバッグ・サーバーの\fBホスト名\fRまたは\fBIP\fRアドレス。jsadebugd(1)を参照してください。 .RE .PP \fIserver\-id\fR @@ -113,35 +115,35 @@ .RE .SH "説明" .PP -\fIjinfo\fRコマンドは、指定されたJavaプロセスやコア・ファイルまたはリモート・デバッグ・サーバーのJava構成情報を出力します。構成情報には、Javaシステム・プロパティとJava仮想マシン(JVM)のコマンドライン・フラグが含まれています。指定されたプロセスが64ビットJVM上で実行されている場合、\fI\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fIjinfo\fR -\fI\-J\-d64 \-sysprops pid\fR。 +\fBjinfo\fRコマンドは、指定されたJavaプロセスやコア・ファイルまたはリモート・デバッグ・サーバーのJava構成情報を出力します。構成情報には、Javaシステム・プロパティとJava Virtual Machine (JVM)のコマンド行フラグが含まれています。指定されたプロセスが64ビットJVM上で実行されている場合、\fB\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fBjinfo\fR +\fB\-J\-d64 \-sysprops pid\fR。 .PP -このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。たとえば、\fIset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fRです。 +このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fBdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fBPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。たとえば、\fBset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fRです。 .SH "オプション" .PP no\-option .RS 4 -コマンドライン・フラグを、システム・プロパティ名と値のペアとともに出力します。 +コマンド行フラグを、システム・プロパティ名と値のペアとともに出力します。 .RE .PP \-flag \fIname\fR .RS 4 -指定されたコマンドライン・フラグの名前と値を出力します。 +指定されたコマンド行フラグの名前と値を出力します。 .RE .PP \-flag \fI[+|\-]name\fR .RS 4 -指定されたブール型のコマンドライン・フラグを有効または無効にします。 +指定されたブール型のコマンド行フラグを有効または無効にします。 .RE .PP \-flag \fIname=value\fR .RS 4 -指定されたコマンドライン・フラグを指定された値に設定します。 +指定されたコマンド行フラグを指定された値に設定します。 .RE .PP \-flags .RS 4 -JVMに渡されるコマンドライン・フラグを出力します。 +JVMに渡されるコマンド行フラグを出力します。 .RE .PP \-sysprops
--- a/src/solaris/doc/sun/man/man1/ja/jjs.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jjs.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jjs -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 基本ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jjs +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 基本ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jjs" "1" "2013年11月21日" "JDK 8" "基本ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jjs \- Nashornエンジンを呼び出します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjjs\fR [\fIoptions\fR] [\fIscript\-files\fR] [\-\- \fIarguments\fR] +\fB\fBjjs\fR\fR\fB [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIscript\-files\fR\fR\fB] [\-\- \fR\fB\fIarguments\fR\fR\fB]\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -空白文字で区切られた、\fIjjs\fRコマンドの1つ以上のオプション。詳細は、オプションを参照してください。 +空白文字で区切られた、\fBjjs\fRコマンドの1つ以上のオプション。詳細は、オプションを参照してください。 .RE .PP \fIscript\-files\fR @@ -74,53 +76,61 @@ .PP \fIarguments\fR .RS 4 -二重ハイフン・マーカー(\fI\-\-\fR)の後のすべての値が、引数としてスクリプトまたは対話型シェルに渡されます。これらの値には\fIarguments\fRプロパティを使用してアクセスできます(Example 3を参照してください)。 +二重ハイフン・マーカー(\fB\-\-\fR)の後のすべての値が、引数としてスクリプトまたは対話型シェルに渡されます。これらの値には\fBarguments\fRプロパティを使用してアクセスできます(Example 3を参照してください)。 .RE .SH "説明" .PP -\fIjjs\fRコマンドライン・ツールを使用してNashornエンジンを呼び出します。これを使用して、1つまたは複数のスクリプト・ファイルを解釈したり、対話型シェルを実行することができます。 +\fBjjs\fRコマンド行ツールを使用してNashornエンジンを呼び出します。これを使用して、1つまたは複数のスクリプト・ファイルを解釈したり、対話型シェルを実行することができます。 .SH "オプション" .PP -\fIjjs\fRコマンドのオプションはスクリプトがNashornによって解釈される条件を制御します。 +\fBjjs\fRコマンドのオプションはスクリプトがNashornによって解釈される条件を制御します。 .PP -\-ccs=\fIsize\fR, \-\-class\-cache\-size=\fIsize\fR +\-ccs=\fIsize\fR +.br +\-\-class\-cache\-size=\fIsize\fR .RS 4 -クラス・キャッシュ・サイズをバイト単位で設定します。キロバイト(KB)を示すために\fIk\fRまたは\fIK\fRの文字を追加し、メガバイト(MB)を示すために\fIm\fRまたは\fIM\fRの文字を追加し、ギガバイト(GB)を示すために\fIg\fRまたは\fIG\fRを追加します。デフォルトでは、クラス・キャッシュ・サイズは50バイトに設定されます。次の例は、1024バイト(1 KB)に設定する方法を示します。 +クラス・キャッシュ・サイズをバイト単位で設定します。キロバイト(KB)を示すために\fBk\fRまたは\fBK\fRの文字を追加し、メガバイト(MB)を示すために\fBm\fRまたは\fBM\fRの文字を追加し、ギガバイト(GB)を示すために\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、クラス・キャッシュ・サイズは50バイトに設定されます。次の例は、1024バイト(1 KB)に設定する方法を示します。 .sp .if n \{\ .RS 4 .\} .nf -\-css=100 -\-css=1k +\fB\-css=100\fR +\fB\-css=1k\fR + .fi .if n \{\ .RE .\} .RE .PP -\-co, \-\-compile\-only +\-co +.br +\-\-compile\-only .RS 4 スクリプトを実行せずにコンパイルします。 .RE .PP -\-cp \fIpath\fR, \-\-classpath \fIpath\fR +\-cp \fIpath\fR +.br +\-\-classpath \fIpath\fR .RS 4 サポートするクラスへのパスを指定します。複数のパスを設定するには、このオプションを繰り返すか、または各パスをコロン(:)で区切ります。 .RE .PP \-D\fIname\fR=\fIvalue\fR .RS 4 -プロパティ名に値を割り当てることで、スクリプトに渡すシステム・プロパティを設定します。次の例で、対話型モードでNashornを呼び出して、\fImyValue\fRを\fImyKey\fRという名前のプロパティに割り当てる方法を示します。 +プロパティ名に値を割り当てることで、スクリプトに渡すシステム・プロパティを設定します。次の例で、対話型モードでNashornを呼び出して、\fBmyValue\fRを\fBmyKey\fRという名前のプロパティに割り当てる方法を示します。 .sp .if n \{\ .RS 4 .\} .nf ->> \fBjjs \-DmyKey=myValue\fR -jjs> \fBjava\&.lang\&.System\&.getProperty("myKey")\fR -myValue -jjs> +\fB>> \fR\fB\fBjjs \-DmyKey=myValue\fR\fR +\fBjjs> \fR\fB\fBjava\&.lang\&.System\&.getProperty("myKey")\fR\fR +\fBmyValue\fR +\fBjjs>\fR + .fi .if n \{\ .RE @@ -128,14 +138,16 @@ このオプションを繰り返し使用すると、複数のプロパティを設定できます。 .RE .PP -\-d=\fIpath\fR, \-\-dump\-debug\-dir=\fIpath\fR +\-d=\fIpath\fR +.br +\-\-dump\-debug\-dir=\fIpath\fR .RS 4 クラス・ファイルをダンプするディレクトリへのパスを指定します。 .RE .PP \-\-debug\-lines .RS 4 -クラス・ファイル内の行番号表を生成します。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-debug\-lines=false\fRを指定します。 +クラス・ファイル内の行番号表を生成します。デフォルトでは、このオプションは有効になっています。無効にするには\fB\-\-debug\-lines=false\fRを指定します。 .RE .PP \-\-debug\-locals @@ -143,14 +155,16 @@ クラス・ファイル内のローカル変数を生成します。 .RE .PP -\-doe, \-\-dump\-on\-error +\-doe +.br +\-\-dump\-on\-error .RS 4 エラーが発生したときに、フル・スタック・トレースを提供します。デフォルトでは、簡単なエラー・メッセージのみが出力されます。 .RE .PP \-\-early\-lvalue\-error .RS 4 -無効な左辺値式が早期エラーとして(つまり、コードが解析されるときに)報告されます。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-early\-lvalue\-error=false\fRを指定します。無効な場合、無効な左辺値式はコードが実行されるまで報告されません。 +無効な左辺値式が早期エラーとして(つまり、コードが解析されるときに)報告されます。デフォルトでは、このオプションは有効になっています。無効にするには\fB\-\-early\-lvalue\-error=false\fRを指定します。無効な場合、無効な左辺値式はコードが実行されるまで報告されません。 .RE .PP \-\-empty\-statements @@ -158,7 +172,9 @@ 空の文をJavaの抽象構文ツリーに保存します。 .RE .PP -\-fv, \-\-fullversion +\-fv +.br +\-\-fullversion .RS 4 完全なNashornバージョン文字列を出力します。 .RE @@ -178,28 +194,31 @@ スクリプトをJavaFXアプリケーションとして起動します。 .RE .PP -\-h, \-help +\-h +.br +\-help .RS 4 オプションのリストとその説明を出力します。 .RE .PP \-J\fIoption\fR .RS 4 -指定した\fIjava\fR起動オプションをJVMに渡します。次の例で、対話型モードでNashornを呼び出して、JVMによって使用される最大メモリーを4 GBに設定する方法を示します。 +指定した\fBjava\fR起動オプションをJVMに渡します。次の例で、対話型モードでNashornを呼び出して、JVMによって使用される最大メモリーを4 GBに設定する方法を示します。 .sp .if n \{\ .RS 4 .\} .nf ->> \fBjjs \-J\-Xmx4g\fR -jjs> \fBjava\&.lang\&.Runtime\&.getRuntime()\&.maxMemory()\fR -3817799680 -jjs> +\fB>> \fR\fB\fBjjs \-J\-Xmx4g\fR\fR +\fBjjs> \fR\fB\fBjava\&.lang\&.Runtime\&.getRuntime()\&.maxMemory()\fR\fR +\fB3817799680\fR +\fBjjs>\fR + .fi .if n \{\ .RE .\} -このオプションを繰り返し使用すると、複数の\fIjava\fRコマンド・オプションを渡すことができます。 +このオプションを繰り返し使用すると、複数の\fBjava\fRコマンド・オプションを渡すことができます。 .RE .PP \-\-lazy\-compilation @@ -209,7 +228,7 @@ .PP \-\-loader\-per\-compile .RS 4 -コンパイルごとに新しいクラス・ローダーを作成します。デフォルトでは、このオプションは有効になっています。無効にするには\fI\-\-loader\-per\-compile=false\fRを指定します。 +コンパイルごとに新しいクラス・ローダーを作成します。デフォルトでは、このオプションは有効になっています。無効にするには\fB\-\-loader\-per\-compile=false\fRを指定します。 .RE .PP \-\-log=\fIsubsystem\fR:\fIlevel\fR @@ -220,7 +239,8 @@ .RS 4 .\} .nf -\-\-log=fields:finest,codegen:info +\fB\-\-log=fields:finest,codegen:info\fR + .fi .if n \{\ .RE @@ -259,7 +279,7 @@ .PP \-\-print\-no\-newline .RS 4 -その他の\fI\-\-print*\fRオプションで強制的に1行で出力します。 +その他の\fB\-\-print*\fRオプションで強制的に1行で出力します。 .RE .PP \-\-print\-parse @@ -272,7 +292,9 @@ 記号表を出力します。 .RE .PP -\-pcs, \-\-profile\-callsites +\-pcs +.br +\-\-profile\-callsites .RS 4 呼び出しサイトのプロファイル・データをダンプします。 .RE @@ -284,12 +306,12 @@ .PP \-\-stderr=\fIfilename\fR|\fIstream\fR|\fItty\fR .RS 4 -標準エラー・ストリームを指定したファイル、ストリーム(たとえば\fIstdout\fR)に、またはテキスト端末にリダイレクトします。 +標準エラー・ストリームを指定したファイル、ストリーム(たとえば\fBstdout\fR)に、またはテキスト端末にリダイレクトします。 .RE .PP \-\-stdout=\fIfilename\fR|\fIstream\fR|\fItty\fR .RS 4 -標準出力ストリームを指定したファイル、ストリーム(たとえば\fIstderr\fR)に、またはテキスト端末にリダイレクトします。 +標準出力ストリームを指定したファイル、ストリーム(たとえば\fBstderr\fR)に、またはテキスト端末にリダイレクトします。 .RE .PP \-strict @@ -297,12 +319,16 @@ 標準(ECMAScript Edition 5\&.1)への準拠を強化するstrictモードを有効にし、これにより共通のコーディング・エラーを簡単に検出できるようになります。 .RE .PP -\-t=\fIzone\fR, \-timezone=\fIzone\fR +\-t=\fIzone\fR +.br +\-timezone=\fIzone\fR .RS 4 -スクリプトの実行に対し指定したタイムゾーンを設定します。OSで設定されたタイムゾーンをオーバーライドし、\fIDate\fRオブジェクトで使用されます。 +スクリプトの実行に対し指定したタイム・ゾーンを設定します。OSで設定されたタイム・ゾーンをオーバーライドし、\fBDate\fRオブジェクトで使用されます。 .RE .PP -\-tcs=\fIparameter\fR, \-\-trace\-callsites=\fIparameter\fR +\-tcs=\fIparameter\fR +.br +\-\-trace\-callsites=\fIparameter\fR .RS 4 呼出しサイトのトレースのモードを有効にします。使用可能なパラメータは、次のとおりです。 .PP @@ -327,60 +353,71 @@ バイトコードを実行する前に検証します。 .RE .PP -\-v, \-version +\-v +.br +\-version .RS 4 Nashornバージョン文字列を出力します。 .RE .PP \-xhelp .RS 4 -コマンドライン・オプションの拡張ヘルプを出力します。 +コマンド行オプションの拡張ヘルプを出力します。 .RE .SH "例" .PP -\fBExample 1\fR, Nashornを使用したスクリプトの実行 +\fB例 1\fR +.br +Nashornを使用したスクリプトの実行 .RS 4 .sp .if n \{\ .RS 4 .\} .nf -jjs script\&.js +\fBjjs script\&.js\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 2\fR, 対話型モードでのNashornの実行 +\fB例 2\fR +.br +対話型モードでのNashornの実行 .RS 4 .sp .if n \{\ .RS 4 .\} .nf ->> \fBjjs\fR -jjs> \fBprintln("Hello, World!")\fR -Hello, World! -jjs> \fBquit()\fR ->> +\fB>> \fR\fB\fBjjs\fR\fR +\fBjjs> \fR\fB\fBprintln("Hello, World!")\fR\fR +\fBHello, World!\fR +\fBjjs> \fR\fB\fBquit()\fR\fR +\fB>>\fR + .fi .if n \{\ .RE .\} .RE .PP -\fBExample 3\fR, Nashornへの引数の渡し +\fB例 3\fR +.br +Nashornへの引数の渡し .RS 4 .sp .if n \{\ .RS 4 .\} .nf ->> \fBjjs \-\- a b c\fR -jjs> \fBarguments\&.join(", ")\fR -a, b, c -jjs> +\fB>> \fR\fB\fBjjs \-\- a b c\fR\fR +\fBjjs> \fR\fB\fBarguments\&.join(", ")\fR\fR +\fBa, b, c\fR +\fBjjs>\fR + .fi .if n \{\ .RE @@ -388,7 +425,7 @@ .RE .SH "関連項目" .PP -\fIjrunscript\fR +\fBjrunscript\fR .br 'pl 8.5i 'bp
--- a/src/solaris/doc/sun/man/man1/ja/jmap.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jmap.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jmap -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jmap +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jmap" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jmap \- プロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjmap\fR [ \fIoptions\fR ] \fIpid\fR +\fBjmap\fR [ \fIoptions\fR ] \fIpid\fR .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjmap\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR +\fBjmap\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR .fi .if n \{\ .RE @@ -76,7 +78,7 @@ .RS 4 .\} .nf -\fIjmap\fR [ \fIoptions\fR ] [ \fIpid\fR ] \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR +\fBjmap\fR [ \fIoptions\fR ] [ \fIpid\fR ] \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR .fi .if n \{\ .RE @@ -84,7 +86,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIpid\fR @@ -104,7 +106,7 @@ .PP \fIremote\-hostname\-or\-IP\fR .RS 4 -リモート・デバッグ・サーバーの\fIホスト名\fRまたは\fIIP\fRアドレス。jsadebugd(1)を参照してください。 +リモート・デバッグ・サーバーの\fBホスト名\fRまたは\fBIP\fRアドレス。jsadebugd(1)を参照してください。 .RE .PP \fIserver\-id\fR @@ -113,22 +115,22 @@ .RE .SH "説明" .PP -\fIjmap\fRコマンドは、指定されたプロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。指定されたプロセスが64ビットJava仮想マシン(JVM)上で実行されている場合、\fI\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fIjmap\fR -\fI\-J\-d64 \-heap pid\fR。 +\fBjmap\fRコマンドは、指定されたプロセスやコア・ファイルまたはリモート・デバッグ・サーバーの、共用オブジェクト・メモリー・マップまたはヒープ・メモリーの詳細を出力します。指定されたプロセスが64ビットJava Virtual Machine (JVM)上で実行されている場合、\fB\-J\-d64\fRオプションを指定する必要がある場合があります。次に例を示します。\fBjmap\fR +\fB\-J\-d64 \-heap pid\fR。 .PP \fB注意:\fR -このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用される\fIjvm\&.dll\fRの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。\fIset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR。 +このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fBdbgeng\&.dll\fRファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fBPATH\fR環境変数には、ターゲット・プロセスによって使用される\fBjvm\&.dll\fRの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。\fBset PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR。 .SH "オプション" .PP -<オプションなし> +<no option> .RS 4 -オプションを使用しない場合、\fIjmap\fRコマンドは共用オブジェクト・マッピングを出力します。ターゲットJVMにロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズおよび共用オブジェクト・ファイルのフルパスが出力されます。この動作は、Oracle Solaris -\fIpmap\fRユーティリティと類似しています。 +オプションを使用しない場合、\fBjmap\fRコマンドは共用オブジェクト・マッピングを出力します。ターゲットJVMにロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズおよび共用オブジェクト・ファイルのフルパスが出力されます。この動作は、Oracle Solaris +\fBpmap\fRユーティリティと類似しています。 .RE .PP \-dump:[live,] format=b, file=\fIfilename\fR .RS 4 -Javaヒープを\fIhprof\fRバイナリ形式で\fIfilename\fRにダンプします。\fIlive\fRサブオプションはオプションですが、指定した場合、ヒープ内のアクティブなオブジェクトのみがダンプされます。ヒープ・ダンプを参照するには、jhat(1)コマンドを使用して生成されたファイルを読み取ります。 +Javaヒープを\fBhprof\fRバイナリ形式で\fBfilename\fRにダンプします。\fBlive\fRサブオプションはオプションですが、指定した場合、ヒープ内のアクティブなオブジェクトのみがダンプされます。ヒープ・ダンプを参照するには、jhat(1)コマンドを使用して生成されたファイルを読み取ります。 .RE .PP \-finalizerinfo @@ -143,7 +145,7 @@ .PP \-histo[:live] .RS 4 -ヒープのヒストグラムを出力します。Javaクラスごとに、オブジェクトの数、バイト単位でのメモリー・サイズ、および完全修飾クラス名が出力されます。JVMの内部クラス名はアスタリスク(*)の接頭辞を付けて出力されます。\fIlive\fRサブオプションが指定された場合、アクティブなオブジェクトのみがカウントされます。 +ヒープのヒストグラムを出力します。Javaクラスごとに、オブジェクトの数、バイト単位でのメモリー・サイズ、および完全修飾クラス名が出力されます。JVMの内部クラス名はアスタリスク(*)の接頭辞を付けて出力されます。\fBlive\fRサブオプションが指定された場合、アクティブなオブジェクトのみがカウントされます。 .RE .PP \-clstats @@ -153,7 +155,7 @@ .PP \-F .RS 4 -強制します。PIDが応答しないときに、このオプションを\fIjmap \-dump\fRまたは\fIjmap \-histo\fRオプションとともに使用します。このモードでは、\fIlive\fRサブオプションはサポートされません。 +強制します。PIDが応答しないときに、このオプションを\fBjmap \-dump\fRまたは\fBjmap \-histo\fRオプションとともに使用します。このモードでは、\fBlive\fRサブオプションはサポートされません。 .RE .PP \-h @@ -168,7 +170,7 @@ .PP \-J\fIflag\fR .RS 4 -\fIjmap\fRコマンドを実行しているJava仮想マシンに\fIflag\fRを渡します。 +\fBjmap\fRコマンドを実行しているJava Virtual Machineに\fBflag\fRを渡します。 .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/jps.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jps.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jps -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: モニタリング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jps +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: モニタリング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jps" "1" "2013年11月21日" "JDK 8" "モニタリング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jps \- ターゲット・システム上で計測されたJava仮想マシン(JVM)を一覧表示します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjps\fR [ \fIoptions\fR ] [ \fIhostid\fR ] +\fBjps\fR [ \fIoptions\fR ] [ \fIhostid\fR ] .fi .if n \{\ .RE @@ -64,41 +66,41 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIhostid\fR .RS 4 -プロセス・レポートを生成するホストの識別子。\fIhostid\fRには、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプション・コンポーネントを含めることができます。ホスト識別子を参照してください。 +プロセス・レポートを生成するホストの識別子。\fBhostid\fRには、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプション・コンポーネントを含めることができます。ホスト識別子を参照してください。 .RE .SH "説明" .PP -\fIjps\fRコマンドは、ターゲット・システム上で計測されたJava HotSpot VMを一覧表示します。このコマンドで表示できるレポート情報は、アクセス権を持ったJVMに関するものに限定されます。 +\fBjps\fRコマンドは、ターゲット・システム上で計測されたJava HotSpot VMを一覧表示します。このコマンドで表示できるレポート情報は、アクセス権を持ったJVMに関するものに限定されます。 .PP -\fIhostid\fRを指定せずに\fIjps\fRコマンドを実行した場合、ローカル・ホストで計測されたJVMが検索されます。\fIhostid\fRを指定して起動した場合、指定されたプロトコルとポートを使用して、指定されたホスト上のJVMを検索します。\fIjstatd\fRプロセスがターゲット・ホスト上で実行されていると想定されます。 +\fBhostid\fRを指定せずに\fBjps\fRコマンドを実行した場合、ローカル・ホストで計測されたJVMが検索されます。\fBhostid\fRを指定して起動した場合、指定されたプロトコルとポートを使用して、指定されたホスト上のJVMを検索します。\fBjstatd\fRプロセスがターゲット・ホスト上で実行されていると想定されます。 .PP -\fIjps\fRコマンドは、ターゲット・システムで計測された各JVMについて、ローカルVM識別子、つまり\fIlvmid\fRをレポートします。\fIlvmid\fRは、一般的にはJVMプロセスに対するオペレーティング・システムのプロセス識別子ですが、必ずしもそうであるとは限りません。オプションを指定しない場合、\fIjps\fRによって、各Javaアプリケーションの\fIlvmid\fRが一覧表示され、それぞれにアプリケーションのクラス名またはJARファイル名が簡単な形式で示されます。この簡単な形式のクラス名とJARファイル名では、クラスのパッケージ情報またはJARファイル・パス情報が省略されています。 +\fBjps\fRコマンドは、ターゲット・システムで計測された各JVMについて、ローカルVM識別子、つまり\fBlvmid\fRをレポートします。\fBlvmid\fRは、一般的にはJVMプロセスに対するオペレーティング・システムのプロセス識別子ですが、必ずしもそうであるとは限りません。オプションを指定しない場合、\fBjps\fRによって、各Javaアプリケーションの\fBlvmid\fRが一覧表示され、それぞれにアプリケーションのクラス名またはJARファイル名が簡単な形式で示されます。この簡単な形式のクラス名とJARファイル名では、クラスのパッケージ情報またはJARファイル・パス情報が省略されています。 .PP -\fIjps\fRコマンドは、Java起動ツールを使用してmainメソッドに渡されるクラス名と引数を検索します。独自の起動ツールを使用してターゲットJVMを起動した場合は、\fImain\fRメソッドに渡されるクラス名またはJARファイル名と引数は利用できません。この場合、\fIjps\fRコマンドは、\fImain\fRメソッドに渡されるクラス名またはJARファイル名と引数に対して、文字列\fIUnknown\fRを出力します。 +\fBjps\fRコマンドは、Java起動ツールを使用してmainメソッドに渡されるクラス名と引数を検索します。独自の起動ツールを使用してターゲットJVMを起動した場合は、\fBmain\fRメソッドに渡されるクラス名またはJARファイル名と引数は利用できません。この場合、\fBjps\fRコマンドは、\fBmain\fRメソッドに渡されるクラス名またはJARファイル名と引数に対して、文字列\fBUnknown\fRを出力します。 .PP -\fIjps\fRコマンドで生成されるJVMのリストは、このコマンドを実行するプリンシパルに与えられたアクセス権に基づき、制限される場合があります。このコマンドは、オペレーティング・システム独自のアクセス制御機構による決定に基づいて、プリンシパルにアクセス権が与えられているJVMのみを一覧表示します。 +\fBjps\fRコマンドで生成されるJVMのリストは、このコマンドを実行するプリンシパルに与えられたアクセス権に基づき、制限される場合があります。このコマンドは、オペレーティング・システム独自のアクセス制御機構による決定に基づいて、プリンシパルにアクセス権が与えられているJVMのみを一覧表示します。 .SH "オプション" .PP -\fIjps\fRコマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。 +\fBjps\fRコマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。 .PP \-q .RS 4 -クラス名、JARファイル名、および\fImain\fRメソッドに渡された引数の出力を抑制し、ローカルVM識別子の一覧のみを生成します。 +クラス名、JARファイル名、および\fBmain\fRメソッドに渡された引数の出力を抑制し、ローカルVM識別子の一覧のみを生成します。 .RE .PP \-m .RS 4 -\fImain\fRメソッドに渡される引数を出力します。この出力は、組み込まれているJVMに対して\fInull\fRになることもあります。 +\fBmain\fRメソッドに渡される引数を出力します。この出力は、組み込まれているJVMに対して\fBnull\fRになることもあります。 .RE .PP \-l .RS 4 -アプリケーションの\fImain\fRクラスのフル・パッケージ名、またはアプリケーションのJARファイルへのフルパス名を出力します。 +アプリケーションの\fBmain\fRクラスのフル・パッケージ名、またはアプリケーションのJARファイルへのフルパス名を出力します。 .RE .PP \-v @@ -111,19 +113,20 @@ クラス名、JARファイル名、およびmaiメソッドに渡された引数の出力を抑制し、ローカルVM識別子の一覧のみを生成します。 .RE .PP -\-J\fIoption\fR +\-J\fBoption\fR .RS 4 -JVMに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fIオプション\fRを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +JVMに\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fBオプション\fRを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "ホスト識別子" .PP -ホスト識別子、つまり\fIhostid\fRは、ターゲット・システムを示す文字列です。\fIhostid\fR文字列の構文は、URIの構文に対応しています。 +ホスト識別子、つまり\fBhostid\fRは、ターゲット・システムを示す文字列です。\fBhostid\fR文字列の構文は、URIの構文に対応しています。 .sp .if n \{\ .RS 4 .\} .nf -[protocol:][[//]hostname][:port][/servername] +\fB[protocol:][[//]hostname][:port][/servername]\fR + .fi .if n \{\ .RE @@ -131,45 +134,46 @@ .PP \fIprotocol\fR .RS 4 -通信プロトコルです。\fIprotocol\fRが省略され、\fIhostname\fRが指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカル・プロトコルになります。プロトコルが省略され、ホスト名が指定されている場合は、デフォルト・プロトコルは\fIrmi\fRになります。 +通信プロトコルです。\fBprotocol\fRが省略され、\fBhostname\fRが指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカル・プロトコルになります。プロトコルが省略され、ホスト名が指定されている場合は、デフォルト・プロトコルは\fBrmi\fRになります。 .RE .PP hostname .RS 4 -ターゲット・ホストを示すホスト名またはIPアドレスです。\fIhostname\fRパラメータが省略されている場合は、ターゲット・ホストはローカル・ホストになります。 +ターゲット・ホストを示すホスト名またはIPアドレスです。\fBhostname\fRパラメータが省略されている場合は、ターゲット・ホストはローカル・ホストになります。 .RE .PP port .RS 4 -リモート・サーバーと通信するためのデフォルト・ポートです。\fIhostname\fRパラメータが省略されているか、\fIprotocol\fRパラメータが、最適化されたローカル・プロトコルを指定している場合、\fIport\fRパラメータは無視されます。それ以外の場合、\fIport\fRパラメータの扱いは、実装によって異なります。デフォルトの -\fIrmi\fRプロトコルの場合、\fIport\fRパラメータは、リモート・ホスト上のrmiregistryのポート番号を示します。\fIport\fRパラメータが省略されているか、\fIprotocol\fRパラメータが\fIrmi\fRを示している場合、デフォルトのrmiregistryポート(1099)が使用されます。 +リモート・サーバーと通信するためのデフォルト・ポートです。\fBhostname\fRパラメータが省略されているか、\fBprotocol\fRパラメータが、最適化されたローカル・プロトコルを指定している場合、\fBport\fRパラメータは無視されます。それ以外の場合、\fBport\fRパラメータの扱いは、実装によって異なります。デフォルトの +\fBrmi\fRプロトコルの場合、\fBport\fRパラメータは、リモート・ホスト上のrmiregistryのポート番号を示します。\fBport\fRパラメータが省略されているか、\fBprotocol\fRパラメータが\fBrmi\fRを示している場合、デフォルトのrmiregistryポート(1099)が使用されます。 .RE .PP servername .RS 4 -このパラメータの扱いは、実装によって異なります。最適化されたローカル・プロトコルの場合、このフィールドは無視されます。\fIrmi\fRプロトコルの場合、このパラメータは、リモート・ホスト上のRMIリモート・オブジェクトの名前を示す文字列になります。詳細は、\fIjstatd\fRコマンドの\fI\-n\fRオプションを参照してください。 +このパラメータの扱いは、実装によって異なります。最適化されたローカル・プロトコルの場合、このフィールドは無視されます。\fBrmi\fRプロトコルの場合、このパラメータは、リモート・ホスト上のRMIリモート・オブジェクトの名前を示す文字列になります。詳細は、\fBjstatd\fRコマンドの\fB\-n\fRオプションを参照してください。 .RE .SH "出力フォーマット" .PP -\fIjps\fRコマンドの出力は、次のパターンに従います。 +\fBjps\fRコマンドの出力は、次のパターンに従います。 .sp .if n \{\ .RS 4 .\} .nf -lvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ] +\fBlvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ]\fR + .fi .if n \{\ .RE .\} .PP -すべての出力トークンは空白文字で区切られます。\fIarg\fR値の中で空白を使用すると、実際の定位置パラメータに引数をマッピングしようとするときに、あいまいになります。 +すべての出力トークンは空白文字で区切られます。\fBarg\fR値の中で空白を使用すると、実際の定位置パラメータに引数をマッピングしようとするときに、あいまいになります。 .PP \fB注意:\fR -将来のリリースでこの形式は変更される可能性があるため、\fIjps\fRの出力を解析するスクリプトは作成しないことをお薦めします。\fIjps\fR出力を解析するスクリプトを作成すると、このツールの将来のリリースで、作成したスクリプトの変更が必要になる可能性があります。 +将来のリリースでこの形式は変更される可能性があるため、\fBjps\fRの出力を解析するスクリプトは作成しないことをお薦めします。\fBjps\fR出力を解析するスクリプトを作成すると、このツールの将来のリリースで、作成したスクリプトの変更が必要になる可能性があります。 .SH "例" .PP -この項では、\fIjps\fRコマンドの例を示します。 +この項では、\fBjps\fRコマンドの例を示します。 .PP ローカル・ホスト上で計測されたJVMを一覧表示する場合: .sp @@ -177,38 +181,41 @@ .RS 4 .\} .nf -jps -18027 Java2Demo\&.JAR -18032 jps -18005 jstat +\fBjps\fR +\fB18027 Java2Demo\&.JAR\fR +\fB18032 jps\fR +\fB18005 jstat\fR + .fi .if n \{\ .RE .\} .PP -次の例では、リモート・ホスト上で計測されたJVMを一覧表示します。この例では、\fIjstat\fRサーバーと、その内部RMIレジストリまたは別の外部rmiregistryプロセスのいずれかが、リモート・ホストのデフォルト・ポート(ポート1099)で実行されていると想定しています。また、ローカル・ホストが、リモート・ホストへの有効なアクセス権を持っていることも想定しています。この例には、\fI\-l\fRオプションも含まれ、クラス名またはJARファイル名を詳細な形式で出力します。 +次の例では、リモート・ホスト上で計測されたJVMを一覧表示します。この例では、\fBjstat\fRサーバーと、その内部RMIレジストリまたは別の外部rmiregistryプロセスのいずれかが、リモート・ホストのデフォルト・ポート(ポート1099)で実行されていると想定しています。また、ローカル・ホストが、リモート・ホストへの有効なアクセス権を持っていることも想定しています。この例には、\fB\-l\fRオプションも含まれ、クラス名またはJARファイル名を詳細な形式で出力します。 .sp .if n \{\ .RS 4 .\} .nf -jps \-l remote\&.domain -3002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR -2857 sun\&.tools\&.jstatd\&.jstatd +\fBjps \-l remote\&.domain\fR +\fB3002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR\fR +\fB2857 sun\&.tools\&.jstatd\&.jstatd\fR + .fi .if n \{\ .RE .\} .PP -次の例では、RMIレジストリにデフォルトではないポートを使用して、リモート・ホスト上で計測されたJVMを一覧表示します。この例では、内部RMIレジストリがポート2002にバインドされた\fIjstatd\fRサーバーが、リモート・ホスト上で実行されていると想定しています。また、\fI\-m\fRオプションを使用して、一覧表示されたそれぞれのJavaアプリケーションの\fImain\fRメソッドに渡される引数を組み込んでいます。 +次の例では、RMIレジストリにデフォルトではないポートを使用して、リモート・ホスト上で計測されたJVMを一覧表示します。この例では、内部RMIレジストリがポート2002にバインドされた\fBjstatd\fRサーバーが、リモート・ホスト上で実行されていると想定しています。また、\fB\-m\fRオプションを使用して、一覧表示されたそれぞれのJavaアプリケーションの\fBmain\fRメソッドに渡される引数を組み込んでいます。 .sp .if n \{\ .RS 4 .\} .nf -jps \-m remote\&.domain:2002 -3002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR -3102 sun\&.tools\&.jstatd\&.jstatd \-p 2002 +\fBjps \-m remote\&.domain:2002\fR +\fB3002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR\fR +\fB3102 sun\&.tools\&.jstatd\&.jstatd \-p 2002\fR + .fi .if n \{\ .RE
--- a/src/solaris/doc/sun/man/man1/ja/jrunscript.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jrunscript.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jrunscript -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: スクリプティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2006, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jrunscript +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: スクリプティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jrunscript" "1" "2013年11月21日" "JDK 8" "スクリプティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jrunscript \- 対話型モードとバッチ・モードをサポートするコマンドライン・スクリプト・シェルを実行します。このコマンドは試験的なもので、サポートされていません。 +.SH "名前" +jrunscript \- 対話型モードとバッチ・モードをサポートするコマンド行スクリプト・シェルを実行します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjrunscript\fR [\fIoptions\fR] [\fIarguments\fR] +\fBjrunscript\fR [\fIoptions\fR] [\fIarguments\fR] .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIarguments\fR @@ -73,7 +75,7 @@ .RE .SH "説明" .PP -\fIjrunscript\fRコマンドは、言語に依存しないコマンドライン・スクリプト・シェルです。\fIjrunscript\fRは、対話型(read\-eval\-print)モードとバッチ(\fI\-f\fRオプション)・モードの両方のスクリプト実行をサポートします。デフォルトの使用言語はJavaScriptですが、\fI\-l\fRオプションを使用すれば他の言語も指定できます。\fIjrunscript\fRコマンドは、Javaとスクリプト言語との通信を使用して探求的なプログラミング・スタイルをサポートします。 +\fBjrunscript\fRコマンドは、言語に依存しないコマンド行スクリプト・シェルです。\fBjrunscript\fRは、対話型(read\-eval\-print)モードとバッチ(\fB\-f\fRオプション)・モードの両方のスクリプト実行をサポートします。デフォルトの使用言語はJavaScriptですが、\fB\-l\fRオプションを使用すれば他の言語も指定できます。\fBjrunscript\fRコマンドは、Javaとスクリプト言語との通信を使用して探求的なプログラミング・スタイルをサポートします。 .SH "オプション" .PP \-classpath \fIpath\fR @@ -83,8 +85,8 @@ .PP \-cp \fIpath\fR .RS 4 -\fI\-classpath\fR -\fIpath\fRと同じです。 +\fB\-classpath\fR +\fBpath\fRと同じです。 .RE .PP \-D\fIname\fR=\fIvalue\fR @@ -94,17 +96,17 @@ .PP \-J\fIflag\fR .RS 4 -\fIflag\fRを、\fIjrunscript\fRコマンドが実行されているJava仮想マシンに直接渡します。 +\fBflag\fRを、\fBjrunscript\fRコマンドが実行されているJava Virtual Machineに直接渡します。 .RE .PP \-I \fIlanguage\fR .RS 4 -指定されたスクリプト言語を使用します。デフォルトではJavaScriptが使用されます。他のスクリプト言語を使用するには、\fI\-cp\fRまたは\fI\-classpath\fRオプションを使用して、対応するスクリプト・エンジンのJARファイルを指定する必要があります。 +指定されたスクリプト言語を使用します。デフォルトではJavaScriptが使用されます。他のスクリプト言語を使用するには、\fB\-cp\fRまたは\fB\-classpath\fRオプションを使用して、対応するスクリプト・エンジンのJARファイルを指定する必要があります。 .RE .PP \-e \fIscript\fR .RS 4 -指定されたスクリプトを評価します。このオプションを使用すれば、コマンドラインにすべてが指定された1行スクリプトを実行できます。 +指定されたスクリプトを評価します。このオプションを使用すれば、コマンド行にすべてが指定された1行スクリプトを実行できます。 .RE .PP \-encoding \fIencoding\fR @@ -138,7 +140,7 @@ .RE .SH "引数" .PP -argumentsが存在していて、かつ\fI\-e\fR、\fI\-f\fRのいずれのオプションも使用されなかった場合、最初の引数がスクリプト・ファイルとなり、他の引数が存在する場合はスクリプトに渡されます。argumentsと、\fI\-e\fRまたは\fI\-f\fRオプションが使用されている場合、すべてのargumentsがスクリプトに渡されます。arguments、\fI\-e\fR、\fI\-f\fRがどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、\fIarguments\fRという名前の\fIString\fR配列型のエンジン変数を使用します。 +argumentsが存在していて、かつ\fB\-e\fR、\fB\-f\fRのいずれのオプションも使用されなかった場合、最初の引数がスクリプト・ファイルとなり、他の引数が存在する場合はスクリプトに渡されます。argumentsと、\fB\-e\fRまたは\fB\-f\fRオプションが使用されている場合、すべてのargumentsがスクリプトに渡されます。arguments、\fB\-e\fR、\fB\-f\fRがどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、\fBarguments\fRという名前の\fBString\fR配列型のエンジン変数を使用します。 .SH "例" .SS "インライン・スクリプトの実行" .sp @@ -146,8 +148,9 @@ .RS 4 .\} .nf -jrunscript \-e "print(\*(Aqhello world\*(Aq)" -jrunscript \-e "cat(\*(Aqhttp://www\&.example\&.com\*(Aq)" +\fBjrunscript \-e "print(\*(Aqhello world\*(Aq)"\fR +\fBjrunscript \-e "cat(\*(Aqhttp://www\&.example\&.com\*(Aq)"\fR + .fi .if n \{\ .RE @@ -158,7 +161,8 @@ .RS 4 .\} .nf -jrunscript \-l js \-f test\&.js +\fBjrunscript \-l js \-f test\&.js\fR + .fi .if n \{\ .RE @@ -169,38 +173,41 @@ .RS 4 .\} .nf -jrunscript -js> print(\*(AqHello World\en\*(Aq); -Hello World -js> 34 + 55 -89\&.0 -js> t = new java\&.lang\&.Thread(function() { print(\*(AqHello World\en\*(Aq); }) -Thread[Thread\-0,5,main] -js> t\&.start() -js> Hello World +\fBjrunscript\fR +\fBjs> print(\*(AqHello World\en\*(Aq);\fR +\fBHello World\fR +\fBjs> 34 + 55\fR +\fB89\&.0\fR +\fBjs> t = new java\&.lang\&.Thread(function() { print(\*(AqHello World\en\*(Aq); })\fR +\fBThread[Thread\-0,5,main]\fR +\fBjs> t\&.start()\fR +\fBjs> Hello World\fR +\fB \fR +\fBjs>\fR -js> .fi .if n \{\ .RE .\} .SS "スクリプト引数を指定したスクリプト・ファイルの実行" .PP -test\&.jsファイルはスクリプト・ファイルです。\fIarg1\fR、\fIarg2\fRおよび\fIarg3\fRの各引数がスクリプトに渡されます。スクリプトはarguments配列を使用してこれらの引数にアクセスできます。 +test\&.jsファイルはスクリプト・ファイルです。\fBarg1\fR、\fBarg2\fRおよび\fBarg3\fRの各引数がスクリプトに渡されます。スクリプトはarguments配列を使用してこれらの引数にアクセスできます。 .sp .if n \{\ .RS 4 .\} .nf -jrunscript test\&.js arg1 arg2 arg3 +\fBjrunscript test\&.js arg1 arg2 arg3\fR + .fi .if n \{\ .RE .\} .SH "関連項目" .PP -JavaScriptが使用される場合、ユーザー定義スクリプトを評価する前に、\fIjrunscript\fRコマンドはいくつかの組込み関数や組込みオブジェクトを初期化します。これらのJavaScriptの組込みについては、http://code\&.google\&.com/p/jsdoc\-toolkit/にある -JsDoc\-Toolkitを参照してください。 +JavaScriptを使用している場合、ユーザー定義スクリプトを評価する前に、\fBjrunscript\fRコマンドによって特定の組込み関数およびオブジェクトが初期化されます(これらについては、次のjrunscript JavaScript組込みのAPI仕様に記載されています)。 +.PP +http://docs\&.oracle\&.com/javase/7/docs/technotes/tools/share/jsdocs/overview\-summary\&.html .br 'pl 8.5i 'bp
--- a/src/solaris/doc/sun/man/man1/ja/jsadebugd.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jsadebugd.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jsadebugd -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jsadebugd +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jsadebugd" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jsadebugd \- Javaプロセスまたはコア・ファイルに接続し、デバッグ・サーバーとして機能します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjsadebugd\fR \fIpid\fR [ \fIserver\-id\fR ] +\fBjsadebugd\fR \fIpid\fR [ \fIserver\-id\fR ] .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjsadebugd\fR \fIexecutable\fR \fIcore\fR [ \fIserver\-id\fR ] +\fBjsadebugd\fR \fIexecutable\fR \fIcore\fR [ \fIserver\-id\fR ] .fi .if n \{\ .RE @@ -93,23 +95,24 @@ .RE .SH "説明" .PP -\fIjsadebugd\fRコマンドは、Javaプロセスまたはコア・ファイルに接続し、デバッグ・サーバーとして機能します。\fIjstack\fR、\fIjmap\fRおよび\fIjinfo\fRなどのリモート・クライアントは、Java Remote Method Invocation (RMI)を使用しているサーバーに接続できます。\fIjsadebugd\fRコマンドを起動する前に、\fIrmiregistry\fRコマンドでRMIレジストリを次のように起動します。\fI$JAVA_HOME\fRはJDKのインストール・ディレクトリです。 +\fBjsadebugd\fRコマンドは、Javaプロセスまたはコア・ファイルに接続し、デバッグ・サーバーとして機能します。\fBjstack\fR、\fBjmap\fRおよび\fBjinfo\fRなどのリモート・クライアントは、Java Remote Method Invocation(RMI)を使用しているサーバーに接続できます。\fBjsadebugd\fRコマンドを起動する前に、\fBrmiregistry\fRコマンドでRMIレジストリを次のように起動します。\fI$JAVA_HOME\fRはJDKのインストール・ディレクトリです。 .sp .if n \{\ .RS 4 .\} .nf -rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi\&.jar +\fBrmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi\&.jar\fR + .fi .if n \{\ .RE .\} .PP -RMIレジストリが起動していない場合、\fIjsadebugd\fRコマンドはRMIレジストリを標準(1099)ポートで内部で起動します。デバッグ・サーバーは、\fISIGINT\fRを送信することにより停止できます。SIGINTを送信するには、\fB[Ctrl] + [C]\fRを押します。 +RMIレジストリが起動していない場合、\fBjsadebugd\fRコマンドはRMIレジストリを標準(1099)ポートで内部で起動します。デバッグ・サーバーは、\fBSIGINT\fRを送信することにより停止できます。SIGINTを送信するには、\fB[Ctrl] + [C]\fRを押します。 .PP \fB注意:\fR -このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fIdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。例: -\fIs\fR\fIet PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR +このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。\fBdbgeng\&.dll\fRが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。\fBPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。例: +\fBs\fR\fBet PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR .SH "関連項目" .sp .RS 4
--- a/src/solaris/doc/sun/man/man1/ja/jstack.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jstack.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jstack -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: トラブルシューティング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jstack +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: トラブルシューティング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jstack" "1" "2013年11月21日" "JDK 8" "トラブルシューティング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jstack \- Javaプロセス、コア・ファイルまたはリモート・デバッグ・サーバーに対するJavaスレッドのスタック・トレースを出力します。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjstack\fR [ \fIoptions\fR ] \fIpid\fR +\fBjstack\fR [ \fIoptions\fR ] \fIpid\fR .fi .if n \{\ .RE @@ -66,7 +68,7 @@ .RS 4 .\} .nf -\fIjstack\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR +\fBjstack\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR .fi .if n \{\ .RE @@ -76,7 +78,7 @@ .RS 4 .\} .nf -\fIjstack\fR [ \fIoptions\fR ] [ \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR +\fBjstack\fR [ \fIoptions\fR ] [ \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR .fi .if n \{\ .RE @@ -84,7 +86,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIpid\fR @@ -104,7 +106,7 @@ .PP \fIremote\-hostname\-or\-IP\fR .RS 4 -リモート・デバッグ・サーバーの\fIホスト名\fRまたは\fIIP\fRアドレス。jsadebugd(1)を参照してください。 +リモート・デバッグ・サーバーの\fBホスト名\fRまたは\fBIP\fRアドレス。jsadebugd(1)を参照してください。 .RE .PP \fIserver\-id\fR @@ -113,17 +115,18 @@ .RE .SH "説明" .PP -\fIjstack\fRコマンドは、指定されたJavaプロセス、コア・ファイルまたはリモート・デバッグ・サーバーに対するJavaスレッドのJavaスタック・トレースを出力します。Javaフレームごとに、フルクラス名、メソッド名、バイトコード・インデックス(bci)、および行番号(利用可能な場合)が出力されます。\fI\-m\fRオプションを使用すると、\fIjstack\fRコマンドは、すべてのスレッドのJavaフレームとネイティブ・フレームの両方を、プログラム・カウンタ(PC)とともに出力します。ネイティブ・フレームごとに、PCに最も近いネイティブ・シンボル(利用可能な場合)が出力されます。C++分解名は分解解除されません。C++名を分解解除するには、このコマンドの出力を\fIc++filt\fRにパイプします。指定されたプロセスが64ビットJava仮想マシン上で実行されている場合は、\fI\-J\-d64\fRオプションを指定する必要があります(例: -\fIjstack \-J\-d64 \-m pid\fR)。 +\fBjstack\fRコマンドは、指定されたJavaプロセス、コア・ファイルまたはリモート・デバッグ・サーバーに対するJavaスレッドのJavaスタック・トレースを出力します。Javaフレームごとに、フルクラス名、メソッド名、バイトコード・インデックス(bci)、および行番号(利用可能な場合)が出力されます。\fB\-m\fRオプションを使用すると、\fBjstack\fRコマンドは、すべてのスレッドのJavaフレームとネイティブ・フレームの両方を、プログラム・カウンタ(PC)とともに出力します。ネイティブ・フレームごとに、PCに最も近いネイティブ・シンボル(利用可能な場合)が出力されます。C++分解名は分解解除されません。C++名を分解解除するには、このコマンドの出力を\fBc++filt\fRにパイプします。指定されたプロセスが64ビットJava Virtual Machine上で実行されている場合は、\fB\-J\-d64\fRオプションを指定する必要があります(例: +\fBjstack \-J\-d64 \-m pid\fR)。 .PP \fB注意\fR -このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。dbgeng\&.dllファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。また、\fIPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。 +このユーティリティはサポート対象外であり、将来のJDKのリリースでは利用できなくなる可能性があります。dbgeng\&.dllファイルが存在していないWindowsシステムでは、Debugging Tools For Windowsをインストールしないとこれらのツールが正常に動作しません。また、\fBPATH\fR環境変数には、ターゲット・プロセスによって使用されるjvm\&.dllの場所、またはクラッシュ・ダンプ・ファイルが生成された場所が含まれるようにしてください。次に例を示します。 .sp .if n \{\ .RS 4 .\} .nf -set PATH=<jdk>\ejre\ebin\eclient;%PATH% +\fBset PATH=<jdk>\ejre\ebin\eclient;%PATH%\fR + .fi .if n \{\ .RE @@ -132,15 +135,15 @@ .PP \-F .RS 4 -\fIjstack\fR -[\fI\-l\fR] -\fIpid\fRが応答しない場合にスタック・ダンプを強制します。 +\fBjstack\fR +[\fB\-l\fR] +\fBpid\fRが応答しない場合にスタック・ダンプを強制します。 .RE .PP \-l .RS 4 -長形式のリスト。所有\fIjava\&.util\&.concurrent\fRの所有できるシンクロナイザの一覧など、ロックについての追加情報を印刷します。http://docs\&.oracle\&.com/javase/8/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer\&.htmlにある -\fIAbstractOwnableSynchronizer\fRクラス記述を参照してください +長形式のリスト。所有\fBjava\&.util\&.concurrent\fRの所有できるシンクロナイザの一覧など、ロックについての追加情報を印刷します。http://docs\&.oracle\&.com/javase/8/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer\&.htmlにある +\fBAbstractOwnableSynchronizer\fRクラス記述を参照してください .RE .PP \-m @@ -157,9 +160,9 @@ .RS 4 ヘルプ・メッセージが出力されます。 .RE -.SH "既知の不具合" +.SH "既知のBUG" .PP -混合モードのスタック・トレースでは、\fI\-m\fRオプションはリモート・デバッグ・サーバーでは機能しません。 +混合モードのスタック・トレースでは、\fB\-m\fRオプションはリモート・デバッグ・サーバーでは機能しません。 .SH "関連項目" .sp .RS 4
--- a/src/solaris/doc/sun/man/man1/ja/jstat.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jstat.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jstat -.\" Language: English -.\" Date: 2011年5月10日 -.\" SectDesc: モニタリング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jstat +.\" Language: Japanese +.\" Date: 2011年5月10日 +.\" SectDesc: モニタリング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jstat" "1" "2011年5月10日" "JDK 8" "モニタリング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jstat \- Java仮想マシン(JVM)の統計を監視します。このコマンドは試験的なもので、サポートされていません。 +.SH "名前" +jstat \- Java Virtual Machine (JVM)の統計をモニターします。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjstat\fR [ \fIgeneralOption\fR | \fIoutputOptions vmid\fR [ \fIinterval\fR[s|ms] [ \fIcount \fR] ] +\fBjstat\fR [ \fIgeneralOption\fR | \fIoutputOptions vmid\fR [ \fIinterval\fR[s|ms] [ \fIcount \fR] ] .fi .if n \{\ .RE @@ -64,12 +66,12 @@ .PP \fIgeneralOption\fR .RS 4 -単独で使用する一般的なコマンドライン・オプションです(\fI\-help\fRまたは\fI\-options\fR)。一般的なオプションを参照してください。 +単独で使用する一般的なコマンド行オプションです(\fB\-help\fRまたは\fB\-options\fR)。一般的なオプションを参照してください。 .RE .PP \fIoutputOptions\fR .RS 4 -単一の\fIstatOption\fRと\fI\-t\fR、\fI\-h\fRおよび\fI\-J\fRのいずれかのオプションで構成される1つ以上の出力オプション。出力オプションを参照してください。 +単一の\fBstatOption\fRと\fB\-t\fR、\fB\-h\fRおよび\fB\-J\fRのいずれかのオプションで構成される1つ以上の出力オプション。出力オプションを参照してください。 .RE .PP \fIvmid\fR @@ -80,35 +82,37 @@ .RS 4 .\} .nf -[protocol:][//]lvmid[@hostname[:port]/servername] +\fB[protocol:][//]lvmid[@hostname[:port]/servername]\fR + .fi .if n \{\ .RE .\} -\fIvmid\fR文字列の構文は、URIの構文に対応しています。\fIvmid\fR文字列は、ローカルJVMを表す単純な整数から、通信プロトコル、ポート番号、および他の実装固有の値を示す複雑な構造まで、様々に異なります。仮想マシン識別子を参照してください。 +\fBvmid\fR文字列の構文は、URIの構文に対応しています。\fBvmid\fR文字列は、ローカルJVMを表す単純な整数から、通信プロトコル、ポート番号、および他の実装固有の値を示す複雑な構造まで、様々に異なります。仮想マシン識別子を参照してください。 .RE .PP \fIinterval\fR [s|ms] .RS 4 -秒(s)またはミリ秒(ms)のうち指定した単位でのサンプリング間隔です。デフォルトの単位はミリ秒です。正の整数にする必要があります。指定した場合、\fIjstat\fRコマンドは各間隔で出力を生成します。 +秒(s)またはミリ秒(ms)のうち指定した単位でのサンプリング間隔です。デフォルトの単位はミリ秒です。正の整数にする必要があります。指定した場合、\fBjstat\fRコマンドは各間隔で出力を生成します。 .RE .PP \fIcount\fR .RS 4 -表示するサンプル数です。デフォルト値は無限で、ターゲットJVMが終了するまで、または\fIjstat\fRコマンドが終了するまで、\fIjstat\fRコマンドは統計データを表示します。この値は、正の整数である必要があります。 +表示するサンプル数です。デフォルト値は無限で、ターゲットJVMが終了するまで、または\fBjstat\fRコマンドが終了するまで、\fBjstat\fRコマンドは統計データを表示します。この値は、正の整数である必要があります。 .RE .SH "説明" .PP -\fIjstat\fRコマンドは、設置されているJava HotSpot VMのパフォーマンス統計データを表示します。ターゲットJVMは、仮想マシン識別子または\fIvmid\fRオプションによって識別されます。 +\fBjstat\fRコマンドは、設置されているJava HotSpot VMのパフォーマンス統計データを表示します。ターゲットJVMは、仮想マシン識別子または\fBvmid\fRオプションによって識別されます。 .SH "仮想マシン識別子" .PP -\fIvmid\fR文字列の構文は、URIの構文に対応しています。 +\fBvmid\fR文字列の構文は、URIの構文に対応しています。 .sp .if n \{\ .RS 4 .\} .nf -[protocol:][//]lvmid[@hostname[:port]/servername] +\fB[protocol:][//]lvmid[@hostname[:port]/servername]\fR + .fi .if n \{\ .RE @@ -116,12 +120,12 @@ .PP \fIprotocol\fR .RS 4 -通信プロトコルです。\fIprotocol\fR値が省略され、ホスト名が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカル・プロトコルになります。\fIprotocol\fR値が省略され、ホスト名が指定されている場合は、デフォルト・プロトコルは\fIrmi\fRになります。 +通信プロトコルです。\fIprotocol\fR値が省略され、ホスト名が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカル・プロトコルになります。\fIprotocol\fR値が省略され、ホスト名が指定されている場合は、デフォルト・プロトコルは\fBrmi\fRになります。 .RE .PP \fIlvmid\fR .RS 4 -ターゲットJVMのローカル仮想マシン識別子です。\fIlvmid\fRは、システム上のJVMを一意に識別するプラットフォーム固有の値です。\fIlvmid\fRは、仮想マシン識別子の唯一の必須要素です。\fIlvmid\fRは、一般的にはターゲットJVMプロセスに対するオペレーティング・システムのプロセス識別子ですが、必ずしもそうであるとは限りません。\fIjps\fRコマンドを使用して、\fIlvmid\fRを特定できます。また、UNIXプラットフォームでは\fIps\fRコマンドを使用して、WindowsではWindowsタスク・マネージャを使用して、\fIlvmid\fRを特定できます。 +ターゲットJVMのローカル仮想マシン識別子です。\fBlvmid\fRは、システム上のJVMを一意に識別するプラットフォーム固有の値です。\fBlvmid\fRは、仮想マシン識別子の唯一の必須要素です。\fBlvmid\fRは、一般的にはターゲットJVMプロセスに対するオペレーティング・システムのプロセス識別子ですが、必ずしもそうであるとは限りません。\fBjps\fRコマンドを使用して、\fBlvmid\fRを特定できます。また、Solaris、LinuxおよびOS Xプラットフォームでは\fBps\fRコマンドを使用して、WindowsではWindowsタスク・マネージャを使用して、\fBlvmid\fRを特定できます。 .RE .PP \fIhostname\fR @@ -131,16 +135,16 @@ .PP \fIport\fR .RS 4 -リモート・サーバーと通信するためのデフォルト・ポートです。\fIhostname\fR値が省略されているか、最適化されたローカル・プロトコルが\fIprotocol\fR値に指定されている場合、\fIport\fR値は無視されます。それ以外の場合、\fIport\fRパラメータの扱いは、実装によって異なります。デフォルトの\fIrmi\fRプロトコルの場合、ポート値は、リモート・ホスト上のrmiregistryのポート番号を示します。\fIport\fR値が省略され、\fIprotocol\fR値で\fIrmi\fRが指定されている場合、デフォルトのrmiregistryポート(1099)が使用されます。 +リモート・サーバーと通信するためのデフォルト・ポートです。\fIhostname\fR値が省略されているか、最適化されたローカル・プロトコルが\fIprotocol\fR値に指定されている場合、\fIport\fR値は無視されます。それ以外の場合、\fBport\fRパラメータの扱いは、実装によって異なります。デフォルトの\fBrmi\fRプロトコルの場合、ポート値は、リモート・ホスト上のrmiregistryのポート番号を示します。\fIport\fR値が省略され、\fIprotocol\fR値で\fBrmi\fRが指定されている場合、デフォルトのrmiregistryポート(1099)が使用されます。 .RE .PP \fIservername\fR .RS 4 -\fIservername\fRパラメータの扱いは、実装によって異なります。最適化されたローカル・プロトコルの場合、このフィールドは無視されます。\fIrmi\fRプロトコルの場合、これは、リモート・ホスト上のRMIリソース・オブジェクトの名前を表します。 +\fBservername\fRパラメータの扱いは、実装によって異なります。最適化されたローカル・プロトコルの場合、このフィールドは無視されます。\fBrmi\fRプロトコルの場合、これは、リモート・ホスト上のRMIリソース・オブジェクトの名前を表します。 .RE .SH "オプション" .PP -\fIjstat\fRコマンドは、一般的なオプションと出力オプションの2つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、\fIjstat\fRコマンドは簡単な使用率およびバージョン情報を表示します。出力オプションによって、統計データ出力の内容と形式が決まります。 +\fBjstat\fRコマンドは、一般的なオプションと出力オプションの2つのタイプのオプションをサポートしています。一般的なオプションを使用した場合、\fBjstat\fRコマンドは簡単な使用率およびバージョン情報を表示します。出力オプションによって、統計データ出力の内容と形式が決まります。 .PP すべてのオプションとその機能は、将来のリリースで変更または廃止される可能性があります。 .SS "一般的なオプション" @@ -158,44 +162,44 @@ .RE .SS "出力オプション" .PP -一般的なオプションを指定しない場合に、出力オプションを指定できます。出力オプションは、\fIjstat\fRコマンドの出力の内容と形式を決定し、単一の\fIstatOption\fRといずれかの出力オプション(\fI\-h\fR、\fI\-t\fRおよび\fI\-J\fR)で構成されます。\fIstatOption\fRは最初に記述する必要があります。 +一般的なオプションを指定しない場合に、出力オプションを指定できます。出力オプションは、\fBjstat\fRコマンドの出力の内容と形式を決定し、単一の\fBstatOption\fRといずれかの出力オプション(\fB\-h\fR、\fB\-t\fRおよび\fB\-J\fR)で構成されます。\fBstatOption\fRは最初に記述する必要があります。 .PP -出力は、各列が空白で区切られた表の形式になります。タイトルを含むヘッダー行によって、各列の意味がわかります。ヘッダーの表示頻度を設定するには、\fI\-h\fRオプションを使用します。列のヘッダー名は、様々なオプション間で一貫性が保たれています。一般に、2つのオプションで同じ名前の列が使用されていれば、2つの列のデータ・ソースは同じです。 +出力は、各列が空白で区切られた表の形式になります。タイトルを含むヘッダー行によって、各列の意味がわかります。ヘッダーの表示頻度を設定するには、\fB\-h\fRオプションを使用します。列のヘッダー名は、様々なオプション間で一貫性が保たれています。一般に、2つのオプションで同じ名前の列が使用されていれば、2つの列のデータ・ソースは同じです。 .PP -\fI\-t\fRオプションを使用すると、Timestampというラベルの付いたタイムスタンプの列が、出力の最初の列として表示されます。Timestamp列には、ターゲットJVMの起動からの経過時間が、秒単位で表示されます。タイムスタンプの精度は、様々な要因によって異なり、大量の負荷のかかったシステムでのスレッド・スケジュールの遅延により変動します。 +\fB\-t\fRオプションを使用すると、Timestampというラベルの付いたタイムスタンプの列が、出力の最初の列として表示されます。Timestamp列には、ターゲットJVMの起動からの経過時間が、秒単位で表示されます。タイムスタンプの精度は、様々な要因によって異なり、大量の負荷のかかったシステムでのスレッド・スケジュールの遅延により変動します。 .PP -intervalおよびcountパラメータを使用して、\fIjstat\fRコマンドがその出力を表示する頻度と回数をそれぞれ指定します。 +intervalおよびcountパラメータを使用して、\fBjstat\fRコマンドがその出力を表示する頻度と回数をそれぞれ指定します。 .PP \fB注意:\fR -将来のリリースでこの形式は変更される可能性があるため、\fIjstat\fRコマンドの出力を解析するスクリプトは作成しなでください。\fIjstat\fRコマンドの出力を解析するスクリプトを作成する場合は、このツールの将来のリリースで、そのスクリプトを変更する必要があることに留意してください。 +将来のリリースでこの形式は変更される可能性があるため、\fBjstat\fRコマンドの出力を解析するスクリプトは作成しなでください。\fBjstat\fRコマンドの出力を解析するスクリプトを作成する場合は、このツールの将来のリリースで、そのスクリプトを変更する必要があることに留意してください。 .PP \-\fIstatOption\fR .RS 4 -\fIjstat\fRコマンドが表示する統計データ情報を指定します。次に、利用可能なオプションの一覧を示します。特定のプラットフォーム・インストールのオプションを一覧表示するには、一般的なオプションの\fI\-options\fRを使用します。Statオプションおよび出力を参照してください。 +\fBjstat\fRコマンドが表示する統計データ情報を指定します。次に、利用可能なオプションの一覧を示します。特定のプラットフォーム・インストールのオプションを一覧表示するには、一般的なオプションの\fB\-options\fRを使用します。Statオプションおよび出力を参照してください。 .sp -\fIclass\fR: クラス・ローダーの動作に関する統計データを表示します。 +\fBclass\fR: クラス・ローダーの動作に関する統計データを表示します。 .sp -\fIcompiler\fR: Java HotSpot VM Just\-in\-Timeコンパイラの動作に関する統計データを表示します。 +\fBcompiler\fR: Java HotSpot VM Just\-in\-Timeコンパイラの動作に関する統計データを表示します。 .sp -\fIgc\fR: ガベージ・コレクトされたヒープの動作に関する統計データを表示します。 +\fBgc\fR: ガベージ・コレクトされたヒープの動作に関する統計データを表示します。 .sp -\fIgccapacity\fR: 世代ごとの容量と対応する領域に関する統計データを表示します。 +\fBgccapacity\fR: 世代ごとの容量と対応する領域に関する統計データを表示します。 .sp -\fIgccause\fR: ガベージ・コレクション統計データのサマリー(\fI\-gcutil\fRと同じ)と、直前および現在(適用可能な場合)のガベージ・コレクション・イベントの原因を表示します。 +\fBgccause\fR: ガベージ・コレクション統計データのサマリー(\fB\-gcutil\fRと同じ)と、直前および現在(適用可能な場合)のガベージ・コレクション・イベントの原因を表示します。 .sp -\fIgcnew\fR: New世代の動作に関する統計データを表示します。 +\fBgcnew\fR: New世代の動作に関する統計データを表示します。 .sp -\fIgcnewcapacity\fR: New世代のサイズと対応する領域に関する統計データを表示します。 +\fBgcnewcapacity\fR: New世代のサイズと対応する領域に関する統計データを表示します。 .sp -\fIgcold\fR: Old世代の動作とメタスペースに関する統計データを表示します。 +\fBgcold\fR: Old世代の動作とメタスペースに関する統計データを表示します。 .sp -\fIgcoldcapacity\fR: Old世代のサイズに関する統計データを表示します。 +\fBgcoldcapacity\fR: Old世代のサイズに関する統計データを表示します。 .sp -\fIgcmetacapacity\fR: メタスペースのサイズに関する統計データを表示します。 +\fBgcmetacapacity\fR: メタスペースのサイズに関する統計データを表示します。 .sp -\fIgcutil\fR: ガベージ・コレクションのサマリーに関する統計データを表示します。 +\fBgcutil\fR: ガベージ・コレクションのサマリーに関する統計データを表示します。 .sp -\fIprintcompilation\fR: Java HotSpot VMコンパイル・メソッドの統計データを表示します。 +\fBprintcompilation\fR: Java HotSpot VMコンパイル・メソッドの統計データを表示します。 .RE .PP \-h \fIn\fR @@ -210,150 +214,150 @@ .PP \-J\fIjavaOption\fR .RS 4 -\fIjavaOption\fRをJavaアプリケーション起動ツールに渡します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。オプションの完全なリストについては、java(1)を参照してください。 +\fBjavaOption\fRをJavaアプリケーション起動ツールに渡します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。オプションの完全なリストについては、java(1)を参照してください。 .RE .SS "Statオプションおよび出力" .PP -次の情報は、\fIjstat\fRコマンドが各\fIstatOption\fRについて出力する列をまとめたものです。 +次の情報は、\fBjstat\fRコマンドが各\fIstatOption\fRについて出力する列をまとめたものです。 .PP \-class \fIoption\fR .RS 4 クラス・ローダーの統計データ。 .sp -\fILoaded\fR: ロードされたクラスの数。 +\fBLoaded\fR: ロードされたクラスの数。 .sp -\fIBytes\fR: ロードされたKBの数。 +\fBBytes\fR: ロードされたKBの数。 .sp -\fIUnloaded\fR: アンロードされたクラスの数。 +\fBUnloaded\fR: アンロードされたクラスの数。 .sp -\fIBytes\fR: アンロードされたKBの数。 +\fBBytes\fR: アンロードされたKBの数。 .sp -\fITime\fR: クラスのロードやアンロード処理に要した時間。 +\fBTime\fR: クラスのロードやアンロード処理に要した時間。 .RE .PP \-compiler \fIoption\fR .RS 4 Java HotSpot VM Just\-in\-Timeコンパイラの統計データ。 .sp -\fICompiled\fR: 実行されたコンパイル・タスクの数。 +\fBCompiled\fR: 実行されたコンパイル・タスクの数。 .sp -\fIFailed\fR: 失敗したコンパイル・タスクの数。 +\fBFailed\fR: 失敗したコンパイル・タスクの数。 .sp -\fIInvalid\fR: 無効にされたコンパイル・タスクの数。 +\fBInvalid\fR: 無効にされたコンパイル・タスクの数。 .sp -\fITime\fR: コンパイル・タスクの実行に要した時間。 +\fBTime\fR: コンパイル・タスクの実行に要した時間。 .sp -\fIFailedType\fR: 最後に失敗したコンパイルのコンパイル・タイプ。 +\fBFailedType\fR: 最後に失敗したコンパイルのコンパイル・タイプ。 .sp -\fIFailedMethod\fR: 最後に失敗したコンパイルのクラス名とメソッド。 +\fBFailedMethod\fR: 最後に失敗したコンパイルのクラス名とメソッド。 .RE .PP \-gc \fIoption\fR .RS 4 ガベージ・コレクトされたヒープの統計データ。 .sp -\fIS0C\fR: Survivor領域0の現在の容量(KB)。 +\fBS0C\fR: Survivor領域0の現在の容量(KB)。 .sp -\fIS1C\fR: Survivor領域1の現在の容量(KB)。 +\fBS1C\fR: Survivor領域1の現在の容量(KB)。 .sp -\fIS0U\fR: Survivor領域0の使用率(KB)。 +\fBS0U\fR: Survivor領域0の使用率(KB)。 .sp -\fIS1U\fR: Survivor領域1の使用率(KB)。 +\fBS1U\fR: Survivor領域1の使用率(KB)。 .sp -\fIEC\fR: Eden領域の現在の容量(KB)。 +\fBEC\fR: Eden領域の現在の容量(KB)。 .sp -\fIEU\fR: Eden領域の使用率(KB)。 +\fBEU\fR: Eden領域の使用率(KB)。 .sp -\fIOC\fR: Old領域の現在の容量(KB)。 +\fBOC\fR: Old領域の現在の容量(KB)。 .sp -\fIOU\fR: Old領域の使用率(KB)。 +\fBOU\fR: Old領域の使用率(KB)。 .sp -\fIMC\fR: メタスペースの容量(KB)。 +\fBMC\fR: メタスペースの容量(KB)。 .sp -\fIMU\fR: メタスペースの使用率(KB)。 +\fBMU\fR: メタスペースの使用率(KB)。 .sp -\fIYGC\fR: 若い世代のガベージ・コレクション・イベントの数。 +\fBYGC\fR: 若い世代のガベージ・コレクション・イベントの数。 .sp -\fIYGCT\fR: 若い世代のガベージ・コレクション時間。 +\fBYGCT\fR: 若い世代のガベージ・コレクション時間。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .sp -\fIFGCT\fR: フルガベージ・コレクション時間。 +\fBFGCT\fR: フルガベージ・コレクション時間。 .sp -\fIGCT\fR: ガベージ・コレクション総時間。 +\fBGCT\fR: ガベージ・コレクション総時間。 .RE .PP \-gccapacity \fIoption\fR .RS 4 メモリー・プール世代および領域容量。 .sp -\fINGCMN\fR: New世代の最小容量(KB)。 +\fBNGCMN\fR: New世代の最小容量(KB)。 .sp -\fINGCMX\fR: New世代の最大容量(KB)。 +\fBNGCMX\fR: New世代の最大容量(KB)。 .sp -\fINGC\fR: New世代の現在の容量(KB)。 +\fBNGC\fR: New世代の現在の容量(KB)。 .sp -\fIS0C\fR: Survivor領域0の現在の容量(KB)。 +\fBS0C\fR: Survivor領域0の現在の容量(KB)。 .sp -\fIS1C\fR: Survivor領域1の現在の容量(KB)。 +\fBS1C\fR: Survivor領域1の現在の容量(KB)。 .sp -\fIEC\fR: Eden領域の現在の容量(KB)。 +\fBEC\fR: Eden領域の現在の容量(KB)。 .sp -\fIOGCMN\fR: Old世代の最小容量(KB)。 +\fBOGCMN\fR: Old世代の最小容量(KB)。 .sp -\fIOGCMX\fR: Old世代の最大容量(KB)。 +\fBOGCMX\fR: Old世代の最大容量(KB)。 .sp -\fIOGC\fR: Old世代の現在の容量(KB)。 +\fBOGC\fR: Old世代の現在の容量(KB)。 .sp -\fIOC\fR: Old領域の現在の容量(KB)。 +\fBOC\fR: Old領域の現在の容量(KB)。 .sp -\fIMCMN\fR: メタスペースの最小容量(KB)。 +\fBMCMN\fR: メタスペースの最小容量(KB)。 .sp -\fIMCMX\fR: メタスペースの最大容量(KB)。 +\fBMCMX\fR: メタスペースの最大容量(KB)。 .sp -\fIMC\fR: メタスペースの容量(KB)。 +\fBMC\fR: メタスペースの容量(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .RE .PP \-gccause \fIoption\fR .RS 4 -このオプションは、\fI\-gcutil\fRオプションと同じガベージ・コレクション統計データのサマリーを表示しますが、最後のガベージ・コレクション・イベントと(適用可能な場合は)現在のガベージ・コレクション・イベントの原因が含まれます。\fI\-gcutil\fRで一覧表示される列のほか、このオプションでは次の列が追加されます。 +このオプションは、\fB\-gcutil\fRオプションと同じガベージ・コレクション統計データのサマリーを表示しますが、最後のガベージ・コレクション・イベントと(適用可能な場合は)現在のガベージ・コレクション・イベントの原因が含まれます。\fB\-gcutil\fRで一覧表示される列のほか、このオプションでは次の列が追加されます。 .sp ガベージ・コレクション・イベントを含むガベージ・コレクション統計データ。 .sp -\fILGCC\fR: 最後のガベージ・コレクションの原因。 +\fBLGCC\fR: 最後のガベージ・コレクションの原因。 .sp -\fIGCC\fR: 現在のガベージ・コレクションの原因。 +\fBGCC\fR: 現在のガベージ・コレクションの原因。 .RE .PP \-gcnew \fIoption\fR .RS 4 New世代の統計データ。 .sp -\fIS0C\fR: Survivor領域0の現在の容量(KB)。 +\fBS0C\fR: Survivor領域0の現在の容量(KB)。 .sp -\fIS1C\fR: Survivor領域1の現在の容量(KB)。 +\fBS1C\fR: Survivor領域1の現在の容量(KB)。 .sp -\fIS0U\fR: Survivor領域0の使用率(KB)。 +\fBS0U\fR: Survivor領域0の使用率(KB)。 .sp -\fIS1U\fR: Survivor領域1の使用率(KB)。 +\fBS1U\fR: Survivor領域1の使用率(KB)。 .sp -\fITT\fR: 殿堂入りしきい値。 +\fBTT\fR: 殿堂入りしきい値。 .sp -\fIMTT\fR: 最大殿堂入りしきい値。 +\fBMTT\fR: 最大殿堂入りしきい値。 .sp -\fIDSS\fR: 適切なSurvivorサイズ(KB)。 +\fBDSS\fR: 適切なSurvivorサイズ(KB)。 .sp -\fIEC\fR: Eden領域の現在の容量(KB)。 +\fBEC\fR: Eden領域の現在の容量(KB)。 .sp -\fIEU\fR: Eden領域の使用率(KB)。 +\fBEU\fR: Eden領域の使用率(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIYGCT\fR: 若い世代のガベージ・コレクション時間。 +\fBYGCT\fR: 若い世代のガベージ・コレクション時間。 .RE .PP \-gcnewcapacity \fIoption\fR @@ -362,132 +366,132 @@ .sp NGCMN: New世代の最小容量(KB)。 .sp -\fINGCMX\fR: New世代の最大容量(KB)。 +\fBNGCMX\fR: New世代の最大容量(KB)。 .sp -\fINGC\fR: New世代の現在の容量(KB)。 +\fBNGC\fR: New世代の現在の容量(KB)。 .sp -\fIS0CMX\fR: Survivor領域0の最大容量(KB)。 +\fBS0CMX\fR: Survivor領域0の最大容量(KB)。 .sp -\fIS0C\fR: Survivor領域0の現在の容量(KB)。 +\fBS0C\fR: Survivor領域0の現在の容量(KB)。 .sp -\fIS1CMX\fR: Survivor領域1の最大容量(KB)。 +\fBS1CMX\fR: Survivor領域1の最大容量(KB)。 .sp -\fIS1C\fR: Survivor領域1の現在の容量(KB)。 +\fBS1C\fR: Survivor領域1の現在の容量(KB)。 .sp -\fIECMX\fR: Eden領域の最大容量(KB)。 +\fBECMX\fR: Eden領域の最大容量(KB)。 .sp -\fIEC\fR: Eden領域の現在の容量(KB)。 +\fBEC\fR: Eden領域の現在の容量(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .RE .PP \-gcold \fIoption\fR .RS 4 OldおよびPermanent世代の統計データ。 .sp -\fIMC\fR: メタスペースの容量(KB)。 +\fBMC\fR: メタスペースの容量(KB)。 .sp -\fIMU\fR: メタスペースの使用率(KB)。 +\fBMU\fR: メタスペースの使用率(KB)。 .sp -\fIOC\fR: Old領域の現在の容量(KB)。 +\fBOC\fR: Old領域の現在の容量(KB)。 .sp -\fIOU\fR: Old領域の使用率(KB)。 +\fBOU\fR: Old領域の使用率(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .sp -\fIFGCT\fR: フルガベージ・コレクション時間。 +\fBFGCT\fR: フルガベージ・コレクション時間。 .sp -\fIGCT\fR: ガベージ・コレクション総時間。 +\fBGCT\fR: ガベージ・コレクション総時間。 .RE .PP \-gcoldcapacity \fIoption\fR .RS 4 Old世代の統計データ。 .sp -\fIOGCMN\fR: Old世代の最小容量(KB)。 +\fBOGCMN\fR: Old世代の最小容量(KB)。 .sp -\fIOGCMX\fR: Old世代の最大容量(KB)。 +\fBOGCMX\fR: Old世代の最大容量(KB)。 .sp -\fIOGC\fR: Old世代の現在の容量(KB)。 +\fBOGC\fR: Old世代の現在の容量(KB)。 .sp -\fIOC\fR: Old領域の現在の容量(KB)。 +\fBOC\fR: Old領域の現在の容量(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .sp -\fIFGCT\fR: フルガベージ・コレクション時間。 +\fBFGCT\fR: フルガベージ・コレクション時間。 .sp -\fIGCT\fR: ガベージ・コレクション総時間。 +\fBGCT\fR: ガベージ・コレクション総時間。 .RE .PP \-gcmetacapacity \fIoption\fR .RS 4 Permanent世代の統計データ。 .sp -\fIMCMN\fR: メタスペースの最小容量(KB)。 +\fBMCMN\fR: メタスペースの最小容量(KB)。 .sp -\fIMCMX\fR: メタスペースの最大容量(KB)。 +\fBMCMX\fR: メタスペースの最大容量(KB)。 .sp -\fIMC\fR: メタスペースの容量(KB)。 +\fBMC\fR: メタスペースの容量(KB)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .sp -\fIFGCT\fR: フルガベージ・コレクション時間。 +\fBFGCT\fR: フルガベージ・コレクション時間。 .sp -\fIGCT\fR: ガベージ・コレクション総時間。 +\fBGCT\fR: ガベージ・コレクション総時間。 .RE .PP \-gcutil \fIoption\fR .RS 4 ガベージ・コレクション統計データのサマリー .sp -\fIS0\fR: Survivor領域0の使用率(現在の容量に対するパーセンテージ)。 +\fBS0\fR: Survivor領域0の使用率(現在の容量に対するパーセンテージ)。 .sp -\fIS1\fR: Survivor領域1の使用率(現在の容量に対するパーセンテージ)。 +\fBS1\fR: Survivor領域1の使用率(現在の容量に対するパーセンテージ)。 .sp -\fIE\fR: Eden領域の使用率(現在の容量に対するパーセンテージ)。 +\fBE\fR: Eden領域の使用率(現在の容量に対するパーセンテージ)。 .sp -\fIO\fR: Old領域の使用率(現在の容量に対するパーセンテージ)。 +\fBO\fR: Old領域の使用率(現在の容量に対するパーセンテージ)。 .sp -\fIM\fR: メタスペースの使用率(領域の現在の容量に対するパーセンテージ)。 +\fBM\fR: メタスペースの使用率(領域の現在の容量に対するパーセンテージ)。 .sp -\fIYGC\fR: 若い世代のGCイベント数。 +\fBYGC\fR: 若い世代のGCイベント数。 .sp -\fIYGCT\fR: 若い世代のガベージ・コレクション時間。 +\fBYGCT\fR: 若い世代のガベージ・コレクション時間。 .sp -\fIFGC\fR: フルGCイベント数。 +\fBFGC\fR: フルGCイベント数。 .sp -\fIFGCT\fR: フルガベージ・コレクション時間。 +\fBFGCT\fR: フルガベージ・コレクション時間。 .sp -\fIGCT\fR: ガベージ・コレクション総時間。 +\fBGCT\fR: ガベージ・コレクション総時間。 .RE .PP \-printcompilation \fIoption\fR .RS 4 Java HotSpot VMコンパイル・メソッドの統計データ。 .sp -\fICompiled\fR: 最近コンパイルされたメソッドで実行されたコンパイル・タスクの数。 +\fBCompiled\fR: 最近コンパイルされたメソッドで実行されたコンパイル・タスクの数。 .sp -\fISize\fR: 最近コンパイルされたメソッドのバイト・コードのバイト数。 +\fBSize\fR: 最近コンパイルされたメソッドのバイト・コードのバイト数。 .sp -\fIType\fR: 最近コンパイルされたメソッドのコンパイル・タイプ。 +\fBType\fR: 最近コンパイルされたメソッドのコンパイル・タイプ。 .sp -\fIMethod\fR: 最近コンパイルされたメソッドを特定するクラス名とメソッド名。クラス名では、名前空間の区切り文字として、ドット(\&.)のかわりにスラッシュ(/)が使用されます。メソッド名は、指定されたクラス内のメソッドです。これらの2つのフィールドの形式は、HotSpot -\fI\-XX:+PrintComplation\fRオプションと対応しています。 +\fBMethod\fR: 最近コンパイルされたメソッドを特定するクラス名とメソッド名。クラス名では、名前空間の区切り文字として、ドット(\&.)のかわりにスラッシュ(/)が使用されます。メソッド名は、指定されたクラス内のメソッドです。これらの2つのフィールドの形式は、HotSpot +\fB\-XX:+PrintCompilation\fRオプションと対応しています。 .RE .SH "例" .PP この項では、21891の\fIlvmid\fRを持つローカルJVMをモニタリングする例を示します。 .SS "gcutilオプション" .PP -この例では、lvmid 21891に接続して、250ミリ秒間隔で7つのサンプルを取得し、\-\fIgcutil\fRオプションでの指定に従って出力を表示します。 +この例では、lvmid 21891に接続して、250ミリ秒間隔で7つのサンプルを取得し、\-\fBgcutil\fRオプションでの指定に従って出力を表示します。 .PP この例の出力は、若い世代のコレクションが3番目と4番目のサンプル間で行われたことを示しています。コレクションには0\&.001秒かかっており、オブジェクトがEden領域(E)からOld領域(O)に昇格したため、Old領域の使用率は9\&.49%から9\&.51%に増加しています。Survivor領域は、コレクション前は12\&.44%が使用されていましたが、コレクション後の使用は7\&.74%のみです。 .sp @@ -495,22 +499,23 @@ .RS 4 .\} .nf -jstat \-gcutil 21891 250 7 - S0 S1 E O M YGC YGCT FGC FGCT GCT -0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 -0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124 +\fBjstat \-gcutil 21891 250 7\fR +\fB S0 S1 E O M YGC YGCT FGC FGCT GCT\fR +\fB0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.49 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR +\fB0\&.00 99\&.74 13\&.80 7\&.86 95\&.82 3 0\&.124 0 0\&.000 0\&.124\fR + .fi .if n \{\ .RE .\} .SS "列ヘッダー文字列の繰返し" .PP -この例では、lvmid 21891に接続して、250ミリ秒間隔でサンプルを取得し、\fI\-gcutil\fRオプションでの指定に従って出力を表示します。さらに、\fI\-h3\fRオプションを使用して、データが3行表示されるごとに列ヘッダーを出力します。 +この例では、lvmid 21891に接続して、250ミリ秒間隔でサンプルを取得し、\fB\-gcutil\fRオプションでの指定に従って出力を表示します。さらに、\fB\-h3\fRオプションを使用して、データが3行表示されるごとに列ヘッダーを出力します。 .PP この例では、ヘッダー文字列の繰返しが表示されているほか、2番目と3番目のサンプル間でYoung GCが行われたことがわかります。この継続時間は0\&.001秒でした。このコレクションでは、Survivor領域0の使用率(S0U)が適切なSurvivorサイズ(DSS)を超過することになるアクティブ・データが検出されました。この結果、オブジェクトは、Old世代(この出力には非表示)へ昇格され、殿堂入りしきい値(TT)が、31から2へ降格されました。 .PP @@ -520,51 +525,54 @@ .RS 4 .\} .nf -jstat \-gcnew \-h3 21891 250 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT - 64\&.0 64\&.0 0\&.0 31\&.7 31 31 32\&.0 512\&.0 178\&.6 249 0\&.203 - 64\&.0 64\&.0 0\&.0 31\&.7 31 31 32\&.0 512\&.0 355\&.5 249 0\&.203 - 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 21\&.9 250 0\&.204 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT - 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 245\&.9 250 0\&.204 - 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 421\&.1 250 0\&.204 - 64\&.0 64\&.0 0\&.0 19\&.0 31 31 32\&.0 512\&.0 84\&.4 251 0\&.204 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT - 64\&.0 64\&.0 0\&.0 19\&.0 31 31 32\&.0 512\&.0 306\&.7 251 0\&.204 +\fBjstat \-gcnew \-h3 21891 250\fR +\fB S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT\fR +\fB 64\&.0 64\&.0 0\&.0 31\&.7 31 31 32\&.0 512\&.0 178\&.6 249 0\&.203\fR +\fB 64\&.0 64\&.0 0\&.0 31\&.7 31 31 32\&.0 512\&.0 355\&.5 249 0\&.203\fR +\fB 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 21\&.9 250 0\&.204\fR +\fB S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT\fR +\fB 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 245\&.9 250 0\&.204\fR +\fB 64\&.0 64\&.0 35\&.4 0\&.0 2 31 32\&.0 512\&.0 421\&.1 250 0\&.204\fR +\fB 64\&.0 64\&.0 0\&.0 19\&.0 31 31 32\&.0 512\&.0 84\&.4 251 0\&.204\fR +\fB S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT\fR +\fB 64\&.0 64\&.0 0\&.0 19\&.0 31 31 32\&.0 512\&.0 306\&.7 251 0\&.204\fR + .fi .if n \{\ .RE .\} .SS "サンプルごとのタイムスタンプの挿入" .PP -この例では、lvmid21891へ接続し、250ミリ秒間隔で3つのサンプルを取得しています。\fI\-t\fRオプションを使用して、最初の列にサンプルごとのタイムスタンプを表示しています。 +この例では、lvmid21891へ接続し、250ミリ秒間隔で3つのサンプルを取得しています。\fB\-t\fRオプションを使用して、最初の列にサンプルごとのタイムスタンプを表示しています。 .PP -Timestamp列には、ターゲットJVMの起動時からの経過時間が、秒単位でレポートされています。さらに、\fI\-gcoldcapacity\fR出力では、割当リクエストまたは昇格リクエストあるいはその両方を満たすためにヒープが拡張するたびに、Old世代の容量(OGC)とOld領域の容量(OC)とが増加していることがわかります。81番目のフル・ガベージ・コレクション(FGC)の後、Old世代の容量(OGC)は11,696 KBから13820 KBに増加しました。この世代(および領域)の最大容量は、60,544 KB (OGCMX)なので、まだ拡張できる余裕が残されています。 +Timestamp列には、ターゲットJVMの起動時からの経過時間が、秒単位でレポートされています。さらに、\fB\-gcoldcapacity\fR出力では、割当リクエストまたは昇格リクエストあるいはその両方を満たすためにヒープが拡張するたびに、Old世代の容量(OGC)とOld領域の容量(OC)とが増加していることがわかります。81番目のフル・ガベージ・コレクション(FGC)の後、Old世代の容量(OGC)は11,696 KBから13820 KBに増加しました。この世代(および領域)の最大容量は、60,544 KB (OGCMX)なので、まだ拡張できる余裕が残されています。 .sp .if n \{\ .RS 4 .\} .nf -Timestamp OGCMN OGCMX OGC OC YGC FGC FGCT GCT - 150\&.1 1408\&.0 60544\&.0 11696\&.0 11696\&.0 194 80 2\&.874 3\&.799 - 150\&.4 1408\&.0 60544\&.0 13820\&.0 13820\&.0 194 81 2\&.938 3\&.863 - 150\&.7 1408\&.0 60544\&.0 13820\&.0 13820\&.0 194 81 2\&.938 3\&.863 +\fBTimestamp OGCMN OGCMX OGC OC YGC FGC FGCT GCT\fR +\fB 150\&.1 1408\&.0 60544\&.0 11696\&.0 11696\&.0 194 80 2\&.874 3\&.799\fR +\fB 150\&.4 1408\&.0 60544\&.0 13820\&.0 13820\&.0 194 81 2\&.938 3\&.863\fR +\fB 150\&.7 1408\&.0 60544\&.0 13820\&.0 13820\&.0 194 81 2\&.938 3\&.863\fR + .fi .if n \{\ .RE .\} -.SS "リモートJVMのインストゥルメンテーションの監視" +.SS "リモートJVMのインストゥルメンテーションのモニター" .PP -この例は、\fI\-gcutil\fRオプションを使用して、remote\&.domainというシステム上のlvmid 40496に接続し、サンプルを秒単位で無期限に取得しています。 +この例は、\fB\-gcutil\fRオプションを使用して、remote\&.domainというシステム上のlvmid 40496に接続し、サンプルを秒単位で無期限に取得しています。 .PP -lvmidは、リモート・ホストの名前と結合されて、\fI40496@remote\&.domain\fRの\fIvmid\fRを構成しています。結果として、このvmidは、\fIrmi\fRプロトコルを使用して、リモート・ホスト上のデフォルトの\fIjstatd\fRサーバーと通信します。\fIjstatd\fRサーバーは、rmiregistryを使用して、デフォルトのrmiregistryポート(ポート1099)にバインドされた\fIremote\&.domain\fRに配置されます。 +lvmidは、リモート・ホストの名前と結合されて、\fB40496@remote\&.domain\fRの\fIvmid\fRを構成しています。結果として、このvmidは、\fBrmi\fRプロトコルを使用して、リモート・ホスト上のデフォルトの\fBjstatd\fRサーバーと通信します。\fBjstatd\fRサーバーは、rmiregistryを使用して、デフォルトのrmiregistryポート(ポート1099)にバインドされた\fBremote\&.domain\fRに配置されます。 .sp .if n \{\ .RS 4 .\} .nf -jstat \-gcutil 40496@remote\&.domain 1000 -\fI\&.\&.\&. output omitted\fR +\fBjstat \-gcutil 40496@remote\&.domain 1000\fR +\fB\fI\&.\&.\&. output omitted\fR\fR + .fi .if n \{\ .RE
--- a/src/solaris/doc/sun/man/man1/ja/jstatd.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jstatd.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jstatd -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: モニタリング・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jstatd +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: モニタリング・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jstatd" "1" "2013年11月21日" "JDK 8" "モニタリング・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" jstatd \- Java仮想マシン(JVM)をモニターし、リモート・モニタリング・ツールがJVMに接続できるようにします。このコマンドは試験的なもので、サポートされていません。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIjstatd\fR [ \fIoptions\fR ] +\fBjstatd\fR [ \fIoptions\fR ] .fi .if n \{\ .RE @@ -64,156 +66,164 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .SH "説明" .PP -\fIjstatd\fRコマンドは、計測されたJava HotSpot VMの作成と終了をモニターし、ローカル・システム上で実行されているJVMに、リモート・モニタリング・ツールが接続できるようにするためのインタフェースを提供するRMIサーバー・アプリケーションです。 +\fBjstatd\fRコマンドは、計測されたJava HotSpot VMの作成と終了をモニターし、ローカル・システム上で実行されているJVMに、リモート・モニタリング・ツールが接続できるようにするためのインタフェースを提供するRMIサーバー・アプリケーションです。 .PP -\fIjstatd\fRサーバーでは、ローカル・ホストにRMIレジストリが必要になります。\fIjstatd\fRサーバーはデフォルト・ポートで、または\fI\-p\fR -\fIport\fRオプションで指定したポートで、RMIレジストリに接続しようとします。RMIレジストリが見つからない場合、\fI\-p\fR -\fIport\fRオプションで指定されたポート、または\fI\-p\fR -\fIport\fRオプションが省略されている場合は、デフォルトRMIレジストリにバインドされた\fIjstatd\fRアプリケーション内に、1つのRMIレジストリが作成されます。内部RMIレジストリの作成は、\fI\-nr\fRオプションを指定することによって中止できます。 +\fBjstatd\fRサーバーでは、ローカル・ホストにRMIレジストリが必要になります。\fBjstatd\fRサーバーはデフォルト・ポートで、または\fB\-p\fR +\fBport\fRオプションで指定したポートで、RMIレジストリに接続しようとします。RMIレジストリが見つからない場合、\fB\-p\fR +\fBport\fRオプションで指定されたポート、または\fB\-p\fR +\fBport\fRオプションが省略されている場合は、デフォルトRMIレジストリにバインドされた\fBjstatd\fRアプリケーション内に、1つのRMIレジストリが作成されます。内部RMIレジストリの作成は、\fB\-nr\fRオプションを指定することによって中止できます。 .SH "オプション" .PP \-nr .RS 4 -既存のRMIレジストリが見つからない場合、\fIjstatd\fRプロセス内に内部RMIレジストリを作成しないようにします。 +既存のRMIレジストリが見つからない場合、\fBjstatd\fRプロセス内に内部RMIレジストリを作成しないようにします。 .RE .PP \-p \fIport\fR .RS 4 -RMIレジストリがあると予想されるポート番号です。見つからない場合は、\fI\-nr\fRオプションが指定されていなければ作成されます。 +RMIレジストリがあると予想されるポート番号です。見つからない場合は、\fB\-nr\fRオプションが指定されていなければ作成されます。 .RE .PP \-n \fIrminame\fR .RS 4 -RMIレジストリにおいて、リモートRMIオブジェクトがバインドされる名前です。デフォルト名は\fIJStatRemoteHost\fRです。複数の\fIjstatd\fRサーバーが同じホスト上で起動している場合、各サーバーのエクスポートしたRMIオブジェクトの名前は、このオプションを指定することによって、一意の名前にすることができます。ただし、このオプションを使用する場合、モニタリング・クライアントの\fIhostid\fRおよび\fIvmid\fR文字列に、その一意のサーバー名を含める必要があります。 +RMIレジストリにおいて、リモートRMIオブジェクトがバインドされる名前です。デフォルト名は\fBJStatRemoteHost\fRです。複数の\fBjstatd\fRサーバーが同じホスト上で起動している場合、各サーバーのエクスポートしたRMIオブジェクトの名前は、このオプションを指定することによって、一意の名前にすることができます。ただし、このオプションを使用する場合、モニタリング・クライアントの\fBhostid\fRおよび\fBvmid\fR文字列に、その一意のサーバー名を含める必要があります。 .RE .PP \-J\fIoption\fR .RS 4 -JVMに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fIオプション\fRを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +JVMに\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fBオプション\fRを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "セキュリティ" .PP -\fIjstatd\fRサーバーは、適切なネイティブ・アクセス権を持つJVMのみを監視できます。したがって、\fIjstatd\fRプロセスは、ターゲットJVMと同じユーザー資格で実行されている必要があります。UNIXベースのシステムにおけるrootユーザーなどの一部のユーザー資格は、システム上の任意のJVMによってエクスポートされたインストゥルメンテーションへのアクセス権を持っています。このような資格で実行されている\fIjstatd\fRプロセスは、システム上のすべてのJVMを監視できますが、セキュリティ上の別の問題が起こります。 +\fBjstatd\fRサーバーは、適切なネイティブ・アクセス権を持つJVMのみをモニターできます。したがって、\fBjstatd\fRプロセスは、ターゲットJVMと同じユーザー資格証明で実行されている必要があります。Solaris、LinuxおよびOS Xオペレーティング・システムにおけるrootユーザーなどの一部のユーザー資格証明は、システム上の任意のJVMによってエクスポートされたインストゥルメンテーションへのアクセス権を持っています。このような資格証明で実行されている\fBjstatd\fRプロセスは、システム上のすべてのJVMをモニターできますが、セキュリティ上の別の問題が起こります。 .PP -\fIjstatd\fRサーバーには、リモート・クライアントの認証機能がありません。そのため、\fIjstatd\fRサーバー・プロセスを実行すると、\fIjstatd\fRプロセスがアクセス権を持つすべてのJVMによるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境によっては望ましくない場合があるので、特に実稼働環境または安全でないネットワークでは、\fIjstatd\fRプロセスを起動する前に、ローカル・セキュリティ・ポリシーを検討する必要があります。 +\fBjstatd\fRサーバーには、リモート・クライアントの認証機能がありません。そのため、\fBjstatd\fRサーバー・プロセスを実行すると、\fBjstatd\fRプロセスがアクセス権を持つすべてのJVMによるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境によっては望ましくない場合があるので、特に本番環境またはセキュアでないネットワークでは、\fBjstatd\fRプロセスを起動する前に、ローカル・セキュリティ・ポリシーを検討する必要があります。 .PP -\fIjstatd\fRサーバーは、他のセキュリティ・マネージャがインストールされていない場合には、\fIRMISecurityPolicy\fRのインスタンスをインストールします。そのため、セキュリティ・ポリシー・ファイルを指定する必要があります。ポリシー・ファイルは、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある +\fBjstatd\fRサーバーは、他のセキュリティ・マネージャがインストールされていない場合には、\fBRMISecurityPolicy\fRのインスタンスをインストールします。そのため、セキュリティ・ポリシー・ファイルを指定する必要があります。ポリシー・ファイルは、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある 「デフォルトのPolicyの実装とポリシー・ファイルの構文」に準拠している必要があります .PP -次のポリシー・ファイルでは、セキュリティ例外を発生せずに\fIjstatd\fRサーバーを実行できます。このポリシーは、すべてのコード・ベースへのあらゆるアクセス権を認めるポリシーよりも自由度が低いですが、\fIjstatd\fRサーバーを実行するために最低限必要なアクセス権のみを認めるポリシーよりも自由度が高くなっています。 +次のポリシー・ファイルでは、セキュリティ例外を発生せずに\fBjstatd\fRサーバーを実行できます。このポリシーは、すべてのコード・ベースへのあらゆるアクセス権を認めるポリシーよりも自由度が低いですが、\fBjstatd\fRサーバーを実行するために最低限必要なアクセス権のみを認めるポリシーよりも自由度が高くなっています。 .sp .if n \{\ .RS 4 .\} .nf -grant codebase "file:${java\&.home}/\&.\&./lib/tools\&.jar" { - permission java\&.security\&.AllPermission; -}; +\fBgrant codebase "file:${java\&.home}/\&.\&./lib/tools\&.jar" { \fR +\fB permission java\&.security\&.AllPermission;\fR +\fB};\fR + .fi .if n \{\ .RE .\} .PP -このポリシー設定を使用するには、このテキストを\fIjstatd\&.all\&.policy\fRというファイルにコピーし、次のように\fIjstatd\fRサーバーを実行します。 +このポリシー設定を使用するには、このテキストを\fBjstatd\&.all\&.policy\fRというファイルにコピーし、次のように\fBjstatd\fRサーバーを実行します。 .sp .if n \{\ .RS 4 .\} .nf -jstatd \-J\-Djava\&.security\&.policy=jstatd\&.all\&.policy +\fBjstatd \-J\-Djava\&.security\&.policy=jstatd\&.all\&.policy\fR + .fi .if n \{\ .RE .\} .PP -より厳しいセキュリティを実施するサイトの場合、カスタム・ポリシー・ファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。ただし、このような方法は、IPアドレスの盗聴攻撃を受けやすくなります。セキュリティの問題について、カスタマイズしたポリシー・ファイルでも対処できない場合は、\fIjstatd\fRサーバーを実行せずに、\fIjstat\fRと\fIjps\fRツールをローカルで使用することが最も安全な方法になります。 +より厳しいセキュリティを実施するサイトの場合、カスタム・ポリシー・ファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。ただし、このような方法は、IPアドレスの盗聴攻撃を受けやすくなります。セキュリティの問題について、カスタマイズしたポリシー・ファイルでも対処できない場合は、\fBjstatd\fRサーバーを実行せずに、\fBjstat\fRと\fBjps\fRツールをローカルで使用することが最も安全な方法になります。 .SH "リモート・インタフェース" .PP -\fIjstatd\fRプロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書込みを行わないでください。 +\fBjstatd\fRプロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書込みを行わないでください。 .SH "例" .PP -次に、\fIjstatd\fRコマンドの例を示します。\fIjstatd\fRスクリプトによって、サーバーはバックグラウンドで自動的に起動します。 +次に、\fBjstatd\fRコマンドの例を示します。\fBjstatd\fRスクリプトによって、サーバーはバックグラウンドで自動的に起動します。 .SS "内部RMIレジストリ" .PP -この例は、内部RMIレジストリを使用したホストによる\fIjstatd\fRセッションの起動を表しています。この例では、デフォルトのRMIレジストリ・ポート(ポート1099)には、他のサーバーはバインドされていないと想定しています。 +この例は、内部RMIレジストリを使用した\fBjstatd\fRセッションの起動方法を表しています。この例では、デフォルトのRMIレジストリ・ポート(ポート1099)には、他のサーバーはバインドされていないと想定しています。 .sp .if n \{\ .RS 4 .\} .nf -jstatd \-J\-Djava\&.security\&.policy=all\&.policy +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy\fR + .fi .if n \{\ .RE .\} .SS "外部RMIレジストリ" .PP -この例は、外部RMIレジストリを使用した\fIjstatd\fRセッションの起動を表しています。 +この例は、外部RMIレジストリを使用した\fBjstatd\fRセッションの起動を表しています。 .sp .if n \{\ .RS 4 .\} .nf -rmiregistry& -jstatd \-J\-Djava\&.security\&.policy=all\&.policy +\fBrmiregistry&\fR +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy\fR + .fi .if n \{\ .RE .\} .PP -この例では、ポート2020の外部RMIレジストリを使用して\fIjstatd\fRセッションを起動します。 +この例では、ポート2020の外部RMIレジストリを使用して\fBjstatd\fRセッションを起動します。 .sp .if n \{\ .RS 4 .\} .nf -jrmiregistry 2020& -jstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020 +\fBjrmiregistry 2020&\fR +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020\fR + .fi .if n \{\ .RE .\} .PP -この例では、ポート2020の外部RMIレジストリを使用して、\fIAlternateJstatdServerName\fRにバインドされている\fIjstatd\fRセッションを起動します。 +この例では、ポート2020の外部RMIレジストリを使用して、\fBAlternateJstatdServerName\fRにバインドされている\fBjstatd\fRセッションを起動します。 .sp .if n \{\ .RS 4 .\} .nf -rmiregistry 2020& -jstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020 - \-n AlternateJstatdServerName +\fBrmiregistry 2020&\fR +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020\fR +\fB \-n AlternateJstatdServerName\fR + .fi .if n \{\ .RE .\} .SS "インプロセスRMIレジストリの作成の停止" .PP -この例では、外部RMIレジストリがない場合に作成しない\fIjstatd\fRセッションを起動します。この例では、RMIレジストリがすでに実行されていると想定しています。RMIレジストリが実行されていない場合、エラー・メッセージが表示されます。 +この例では、外部RMIレジストリがない場合に作成しない\fBjstatd\fRセッションを起動します。この例では、RMIレジストリがすでに実行されていると想定しています。RMIレジストリが実行されていない場合、エラー・メッセージが表示されます。 .sp .if n \{\ .RS 4 .\} .nf -jstatd \-J\-Djava\&.security\&.policy=all\&.policy \-nr +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy \-nr\fR + .fi .if n \{\ .RE .\} .SS "RMIロギングの有効化" .PP -この例では、RMIロギング機能を有効化して\fIjstatd\fRセッションを起動します。この方法は、トラブルシューティングまたはサーバー活動のモニタリングに役立ちます。 +この例では、RMIロギング機能を有効化して\fBjstatd\fRセッションを起動します。この方法は、トラブルシューティングまたはサーバー活動のモニタリングに役立ちます。 .sp .if n \{\ .RS 4 .\} .nf -jstatd \-J\-Djava\&.security\&.policy=all\&.policy - \-J\-Djava\&.rmi\&.server\&.logCalls=true +\fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy\fR +\fB \-J\-Djava\&.rmi\&.server\&.logCalls=true\fR + .fi .if n \{\ .RE
--- a/src/solaris/doc/sun/man/man1/ja/jvisualvm.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/jvisualvm.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2008, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: jvisualvm -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Javaトラブルシューティング、プロファイリング、モニタリングおよび管理ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2008, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: jvisualvm +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Javaトラブルシューティング、プロファイリング、モニタリングおよび管理ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "jvisualvm" "1" "2013年11月21日" "JDK 8" "Javaトラブルシューティング、プロファイリング、モニタリン" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -jvisualvm \- Javaアプリケーションを視覚的に監視、トラブルシュートおよびプロファイルします。 +.SH "名前" +jvisualvm \- Javaアプリケーションを視覚的にモニターし、トラブルシューティングとプロファイリングを行います。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIjvisualvm\fR [ \fIoptions\fR ] +\fBjvisualvm\fR [ \fIoptions\fR ] .fi .if n \{\ .RE @@ -64,15 +66,15 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .SH "説明" .PP -Java VisualVMは、指定されたJava仮想マシン(JVM)でJavaテクノロジ・ベースのアプリケーション(Javaアプリケーション)が実行されているときに、そのJavaアプリケーションに関する詳細な情報を提供する直感的なグラフィカル・ユーザー・インタフェースです。Java VisualVMという名前は、Java VisualVMがJVMソフトウェアに関する情報を視覚的に提供するという事実に由来しています。 +Java VisualVMは、指定されたJava Virtual Machine (JVM)でJavaテクノロジ・ベースのアプリケーション(Javaアプリケーション)が実行されているときに、そのJavaアプリケーションに関する詳細な情報を提供する直感的なグラフィカル・ユーザー・インタフェースです。Java VisualVMという名前は、Java VisualVMがJVMソフトウェアに関する情報を視覚的に提供するという事実に由来しています。 .PP -Java VisualVMは、いくつかのモニタリング、トラブルシューティングおよびプロファイリング・ユーティリティを1つのツールに統合します。たとえば、スタンドアロン・ツール\fIjmap\fR、\fIjinfo\fR、\fIjstat\fRおよび\fIjstack\fRで提供されている機能のほとんどが、Java VisualVMに組み込まれています。\fIjconsole\fRコマンドによって提供される一部の機能など、他の機能はオプションのプラグインとして追加できます。 +Java VisualVMは、いくつかのモニタリング、トラブルシューティングおよびプロファイリング・ユーティリティを1つのツールに統合します。たとえば、スタンドアロン・ツール\fBjmap\fR、\fBjinfo\fR、\fBjstat\fRおよび\fBjstack\fRで提供されている機能のほとんどが、Java VisualVMに組み込まれています。\fBjconsole\fRコマンドによって提供される一部の機能など、他の機能はオプションのプラグインとして追加できます。 .PP -Java VisualVMは、Javaアプリケーションの開発者がアプリケーションのトラブルシューティングを行ったり、アプリケーションのパフォーマンスを監視および改善したりするのに役立ちます。Java VisualVMを使用すると、開発者はヒープ・ダンプの生成および解析、メモリー・リークの特定、ガベージ・コレクションの実行および監視、およびメモリーとCPUの簡易プロファイリングの実行が可能になります。プラグインでJava VisualVMの機能を拡張できます。たとえば、\fIjconsole\fRコマンドのほとんどの機能は、「MBean」タブおよびJConsole Plug\-in Wrapperプラグインを介して使用できます。標準のJava VisualVMプラグインのカタログから選択するには、Java VisualVMメニューの\fB「ツール」\fR、\fB「プラグイン」\fRを選択します。 +Java VisualVMは、Javaアプリケーションの開発者がアプリケーションのトラブルシューティングを行ったり、アプリケーションのパフォーマンスをモニターおよび改善したりするのに役立ちます。Java VisualVMを使用すると、開発者はヒープ・ダンプの生成および解析、メモリー・リークの特定、ガベージ・コレクションの実行およびモニター、およびメモリーとCPUの簡易プロファイリングの実行が可能になります。プラグインでJava VisualVMの機能を拡張できます。たとえば、\fBjconsole\fRコマンドのほとんどの機能は、「MBean」タブおよびJConsole Plug\-in Wrapperプラグインを介して使用できます。標準のJava VisualVMプラグインのカタログから選択するには、Java VisualVMメニューの\fB「ツール」\fR、\fB「プラグイン」\fRを選択します。 .PP Java VisualVMを起動するには、次のコマンドを実行します。 .sp @@ -80,7 +82,8 @@ .RS 4 .\} .nf -% jvisualvm <options> +\fB% jvisualvm <options>\fR + .fi .if n \{\ .RE @@ -91,7 +94,7 @@ .PP \-J\fIjvm_option\fR .RS 4 -この\fIjvm_option\fRをJVMソフトウェアに渡します。 +この\fBjvm_option\fRをJVMソフトウェアに渡します。 .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/keytool.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/keytool.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: keytool -.\" Language: English -.\" Date: 2013年8月6日 -.\" SectDesc: セキュリティ・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: keytool +.\" Language: Japanese +.\" Date: 2013年8月6日 +.\" SectDesc: セキュリティ・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "keytool" "1" "2013年8月6日" "JDK 8" "セキュリティ・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" keytool \- 暗号化鍵、X\&.509証明書チェーンおよび信頼できる証明書を含むキーストア(データベース)を管理します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIkeytool\fR [\fIcommands\fR] +\fBkeytool\fR [\fIcommands\fR] .fi .if n \{\ .RE @@ -332,13 +334,13 @@ .RE .SH "説明" .PP -\fIkeytool\fRコマンドは、鍵と証明書を管理するためのユーティリティです。これにより、ユーザーは自分の公開鍵と秘密鍵のペアおよび関連する証明書を管理し、デジタル署名を使用した自己認証(他のユーザーまたはサービスに対して自分自身を認証すること)や、データの整合性と証明書に関するサービスを利用することができます。\fIkeytool\fRコマンドでは、通信しているピアの公開鍵をキャッシュすることもできます(証明書のフォームで)。 +\fBkeytool\fRコマンドは、鍵と証明書を管理するためのユーティリティです。これにより、ユーザーは自分の公開鍵と秘密鍵のペアおよび関連する証明書を管理し、デジタル署名を使用した自己認証(他のユーザーまたはサービスに対して自分自身を認証すること)や、データの整合性と証明書に関するサービスを利用することができます。\fBkeytool\fRコマンドでは、通信しているピアの公開鍵をキャッシュすることもできます(証明書のフォームで)。 .PP 証明書とは、あるエンティティ(人物、会社など)からのデジタル署名付きの文書のことです。証明書には、他のあるエンティティの公開鍵(およびその他の情報)が特別な値を持っていることが書かれています。(証明書を参照してください。)データにデジタル署名が付いている場合は、デジタル署名を検証することで、データの整合性およびデータが本物であることをチェックできます。データの整合性とは、データが変更されたり、改変されたりしていないことを意味します。また、データが本物であるとは、そのデータが、データを作成して署名したと称する人物から渡されたデータであることを意味します。 .PP -また、\fIkeytool\fRコマンドを使用すれば、対称暗号化/復号化(DES)で使用される秘密鍵およびパスフレーズを管理することもできます。 +また、\fBkeytool\fRコマンドを使用すれば、対称暗号化/復号化(DES)で使用される秘密鍵およびパスフレーズを管理することもできます。 .PP -\fIkeytool\fRコマンドは、鍵と証明書をキーストアに格納します。キーストアの別名を参照してください。 +\fBkeytool\fRコマンドは、鍵と証明書をキーストアに格納します。キーストアの別名を参照してください。 .SH "コマンドとオプションに関する注意" .PP 様々なコマンドとその説明については、コマンドを参照してください。 @@ -384,7 +386,7 @@ .sp -1 .IP \(bu 2.3 .\} -オプションを囲む中カッコは、そのオプションをコマンドラインで指定しなかった場合に、デフォルト値が使用されることを意味します。オプションのデフォルト値を参照してください。中カッコは、\fI\-v\fR、\fI\-rfc\fRおよび\fI\-J\fRオプションを囲むためにも使用されますが、これらのオプションはコマンドラインで指定された場合にのみ意味を持ちます。指定されていない場合以外、デフォルト値はありません。 +オプションを囲む中カッコは、そのオプションをコマンド行で指定しなかった場合に、デフォルト値が使用されることを意味します。オプションのデフォルト値を参照してください。中カッコは、\fB\-v\fR、\fB\-rfc\fRおよび\fB\-J\fRオプションを囲むためにも使用されますが、これらのオプションはコマンド行で指定された場合にのみ意味を持ちます。指定されていない場合以外、デフォルト値はありません。 .RE .sp .RS 4 @@ -395,7 +397,7 @@ .sp -1 .IP \(bu 2.3 .\} -オプションを囲む角カッコは、そのオプションをコマンドラインで指定しなかった場合に、値の入力を求められることを意味します。\fI\-keypass\fRオプションの場合、オプションをコマンドラインで指定しなかった場合は、\fIkeytool\fRコマンドがまずキーストアのパスワードを使用して非公開/秘密鍵の復元を試みます。この試みが失敗した場合、\fIkeytool\fRコマンドにより、非公開/秘密鍵のパスワードの入力を求められます。 +オプションを囲む角カッコは、そのオプションをコマンド行で指定しなかった場合に、値の入力を求められることを意味します。\fB\-keypass\fRオプションの場合、オプションをコマンド行で指定しなかった場合は、\fBkeytool\fRコマンドがまずキーストアのパスワードを使用して非公開/秘密鍵の復元を試みます。この試みが失敗した場合、\fBkeytool\fRコマンドにより、非公開/秘密鍵のパスワードの入力を求められます。 .RE .sp .RS 4 @@ -406,12 +408,12 @@ .sp -1 .IP \(bu 2.3 .\} -イタリック体の項目の実際の値(オプションの値)は、指定する必要があります。たとえば、\fI\-printcert\fRコマンドの形式は次のとおりです。 +イタリック体の項目の実際の値(オプションの値)は、指定する必要があります。たとえば、\fB\-printcert\fRコマンドの形式は次のとおりです。 .sp -\fIkeytool \-printcert {\-file cert_file} {\-v}\fR +\fBkeytool \-printcert {\-file cert_file} {\-v}\fR .sp -\fI\-printcert\fRコマンドを指定する場合は、\fIcert_file\fRを実際のファイル名で置き換えます。例: -\fIkeytool \-printcert \-file VScert\&.cer\fR +\fB\-printcert\fRコマンドを指定する場合は、\fBcert_file\fRを実際のファイル名で置き換えます。例: +\fBkeytool \-printcert \-file VScert\&.cer\fR .RE .sp .RS 4 @@ -433,7 +435,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-help\fRオプションがデフォルトです。\fIkeytool\fRコマンドは、\fIkeytool \-help\fRと同じです。 +\fB\-help\fRオプションがデフォルトです。\fBkeytool\fRコマンドは、\fBkeytool \-help\fRと同じです。 .RE .SH "オプションのデフォルト値" .PP @@ -443,38 +445,39 @@ .RS 4 .\} .nf -\-alias "mykey" - -\-keyalg - "DSA" (when using \-genkeypair) - "DES" (when using \-genseckey) - -\-keysize - 2048 (when using \-genkeypair and \-keyalg is "RSA") - 1024 (when using \-genkeypair and \-keyalg is "DSA") - 256 (when using \-genkeypair and \-keyalg is "EC") - 56 (when using \-genseckey and \-keyalg is "DES") - 168 (when using \-genseckey and \-keyalg is "DESede") +\fB\-alias "mykey"\fR +\fB \fR +\fB\-keyalg\fR +\fB "DSA" (when using \-genkeypair)\fR +\fB "DES" (when using \-genseckey)\fR +\fB \fR +\fB\-keysize\fR +\fB 2048 (when using \-genkeypair and \-keyalg is "RSA")\fR +\fB 1024 (when using \-genkeypair and \-keyalg is "DSA")\fR +\fB 256 (when using \-genkeypair and \-keyalg is "EC")\fR +\fB 56 (when using \-genseckey and \-keyalg is "DES")\fR +\fB 168 (when using \-genseckey and \-keyalg is "DESede")\fR +\fB \fR +\fB\-validity 90\fR +\fB \fR +\fB\-keystore <the file named \&.keystore in the user\*(Aqs home directory>\fR +\fB \fR +\fB\-storetype <the value of the "keystore\&.type" property in the\fR +\fB security properties file, which is returned by the static\fR +\fB getDefaultType method in java\&.security\&.KeyStore>\fR +\fB \fR +\fB\-file\fR +\fB stdin (if reading)\fR +\fB stdout (if writing)\fR +\fB \fR +\fB\-protected false\fR -\-validity 90 - -\-keystore <the file named \&.keystore in the user\*(Aqs home directory> - -\-storetype <the value of the "keystore\&.type" property in the - security properties file, which is returned by the static - getDefaultType method in java\&.security\&.KeyStore> - -\-file - stdin (if reading) - stdout (if writing) - -\-protected false .fi .if n \{\ .RE .\} .PP -公開/秘密鍵ペアの生成において、署名アルゴリズム(\fI\-sigalg\fRオプション)は、基になる秘密鍵のアルゴリズムから派生します。 +公開/秘密鍵ペアの生成において、署名アルゴリズム(\fB\-sigalg\fRオプション)は、基になる秘密鍵のアルゴリズムから派生します。 .sp .RS 4 .ie n \{\ @@ -484,7 +487,7 @@ .sp -1 .IP \(bu 2.3 .\} -基になる秘密鍵がDSAタイプである場合は、\fI\-sigalg\fRオプションのデフォルト値はSHA1withDSAになります。 +基になる秘密鍵がDSAタイプである場合は、\fB\-sigalg\fRオプションのデフォルト値はSHA1withDSAになります。 .RE .sp .RS 4 @@ -495,7 +498,7 @@ .sp -1 .IP \(bu 2.3 .\} -基になる秘密鍵がRSAタイプである場合は、\fI\-sigalg\fRオプションのデフォルト値はSHA256withRSAになります。 +基になる秘密鍵がRSAタイプである場合は、\fB\-sigalg\fRオプションのデフォルト値はSHA256withRSAになります。 .RE .sp .RS 4 @@ -506,16 +509,16 @@ .sp -1 .IP \(bu 2.3 .\} -基になる秘密鍵がECタイプである場合は、\fI\-sigalg\fRオプションのデフォルト値はSHA256withECDSAになります。 +基になる秘密鍵がECタイプである場合は、\fB\-sigalg\fRオプションのデフォルト値はSHA256withECDSAになります。 .RE .PP -\fI\-keyalg\fRおよび\fI\-sigalg\fR引数の完全なリストについては、 +\fB\-keyalg\fRおよび\fB\-sigalg\fR引数の完全なリストについては、 http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/CryptoSpec\&.html#AppAの「Java Cryptography Architecture (JCA) Reference Guide」を参照してください。 .SH "一般オプション" .PP -\fI\-v\fRオプションは、\fI\-help\fRコマンドを除くすべてのコマンドで使用できます。\fI\-v\fRオプションを指定した場合、コマンドは冗長モードで実行され、詳細な情報が出力されます。 +\fB\-v\fRオプションは、\fB\-help\fRコマンドを除くすべてのコマンドで使用できます。\fB\-v\fRオプションを指定した場合、コマンドは冗長モードで実行され、詳細な情報が出力されます。 .PP -任意のコマンドで指定できる\fI\-Jjavaoption\fR引数もあります。\fI\-Jjavaoption\fRを指定した場合、指定された\fIjavaoption\fR文字列がJavaインタプリタに直接渡されます。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンドラインで\fIjava \-h\fRまたは\fIjava \-X\fRと入力してください。 +任意のコマンドで指定できる\fB\-Jjavaoption\fR引数もあります。\fB\-Jjavaoption\fRを指定した場合、指定された\fBjavaoption\fR文字列がJavaインタプリタに直接渡されます。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。指定できるインタプリタ・オプションを一覧表示するには、コマンド行で\fBjava \-h\fRまたは\fBjava \-X\fRと入力してください。 .PP 次のオプションは、キーストアに対する操作を行うすべてのコマンドで指定できます。 .PP @@ -528,18 +531,18 @@ .RS 4 キーストアの場所を指定します。 .sp -特定の\fIkeytool\fRコマンドを実行する際に、JKS -\fIstoretype\fRが使用され、かつキーストア・ファイルがまだ存在していなかった場合、新しいキーストア・ファイルが作成されます。たとえば、\fIkeytool \-genkeypair\fRの呼出し時に\fI\-keystore\fRオプションが指定されなかった場合、\fI\&.keystore\fRという名前のデフォルト・キーストア・ファイルがユーザーのホーム・ディレクトリ内にまだ存在していなければ、そこに作成されます。同様に、\fI\-keystore ks_file\fRというオプションが指定されてもそのks_fileが存在しなかった場合、そのファイルが作成されます。JKS -\fIstoretype\fRの詳細は、\fIの\fRKeyStoreの実装キーストアの別名に関する項を参照してください。 +特定の\fBkeytool\fRコマンドを実行する際に、JKS +\fBstoretype\fRが使用され、かつキーストア・ファイルがまだ存在していなかった場合、新しいキーストア・ファイルが作成されます。たとえば、\fBkeytool \-genkeypair\fRの呼出し時に\fB\-keystore\fRオプションが指定されなかった場合、\fB\&.keystore\fRという名前のデフォルト・キーストア・ファイルがユーザーのホーム・ディレクトリ内にまだ存在していなければ、そこに作成されます。同様に、\fB\-keystore ks_file\fRというオプションが指定されてもそのks_fileが存在しなかった場合、そのファイルが作成されます。JKS +\fBstoretype\fRの詳細は、\fIの\fRKeyStoreの実装キーストアの別名に関する項を参照してください。 .sp -\fI\-keystore\fRオプションからの入力ストリームは、\fIKeyStore\&.load\fRメソッドに渡されます。URLとして\fINONE\fRが指定されている場合は、nullのストリームが\fIKeyStore\&.load\fRメソッドに渡されます。\fINONE\fRは、KeyStoreがファイルベースではない場合に指定してください。たとえば、ハードウェア・トークン・デバイス上に存在している場合などです。 +\fB\-keystore\fRオプションからの入力ストリームは、\fBKeyStore\&.load\fRメソッドに渡されます。URLとして\fBNONE\fRが指定されている場合は、nullのストリームが\fBKeyStore\&.load\fRメソッドに渡されます。\fBNONE\fRは、KeyStoreがファイルベースではない場合に指定してください。たとえば、ハードウェア・トークン・デバイス上に存在している場合などです。 .RE .PP \-storepass[:\fIenv\fR| :\fIfile\fR] argument .RS 4 キーストアの整合性を保護するために使用するパスワードを指定します。 .sp -修飾子\fIenv\fRまたは\fIfile\fRを指定しない場合、パスワードの値は\fIargument\fRになります。この値は、6文字以上にする必要があります。それ以外の場合、パスワードは次のようにして取得されます。 +修飾子\fBenv\fRまたは\fBfile\fRを指定しない場合、パスワードの値は\fBargument\fRになります。この値は、6文字以上にする必要があります。それ以外の場合、パスワードは次のようにして取得されます。 .sp .RS 4 .ie n \{\ @@ -549,8 +552,8 @@ .sp -1 .IP \(bu 2.3 .\} -\fIenv\fR: -\fIargument\fRという名前の環境変数からパスワードを取得します。 +\fBenv\fR: +\fBargument\fRという名前の環境変数からパスワードを取得します。 .RE .sp .RS 4 @@ -561,13 +564,13 @@ .sp -1 .IP \(bu 2.3 .\} -\fIfile\fR: argumentという名前のファイルからパスワードを取得します。 +\fBfile\fR: argumentという名前のファイルからパスワードを取得します。 .RE .sp \fB注意:\fR -\fI\-keypass\fR、\fI\-srckeypass\fR、\-\fIdestkeypass\fR、\fI\-srcstorepass\fR、\fI\-deststorepass\fRなどのパスワードを必要とするその他のオプションはすべて、\fIenv\fRおよび\fIfile\fR修飾子を受け付けます。パスワード・オプションと修飾子は、必ずコロン(:)で区切ってください。 +\fB\-keypass\fR、\fB\-srckeypass\fR、\-\fBdestkeypass\fR、\fB\-srcstorepass\fR、\fB\-deststorepass\fRなどのパスワードを必要とするその他のオプションはすべて、\fIenv\fRおよび\fIfile\fR修飾子を受け付けます。パスワード・オプションと修飾子は、必ずコロン(:)で区切ってください。 .sp -パスワードは、キーストアの内容にアクセスするすべてのコマンドで使用されます。この種のコマンドを実行するときに、コマンドラインで\fI\-storepass\fRオプションを指定しなかった場合は、パスワードの入力を求められます。 +パスワードは、キーストアの内容にアクセスするすべてのコマンドで使用されます。この種のコマンドを実行するときに、コマンド行で\fB\-storepass\fRオプションを指定しなかった場合は、パスワードの入力を求められます。 .sp キーストアから情報を取得する場合、パスワードは省略可能です。パスワードが指定されていない場合は、取得した情報の整合性を検証できず、警告が表示されます。 .RE @@ -584,75 +587,74 @@ .PP \-providerArg \fIprovider_arg\fR .RS 4 -\fI\-providerClass\fRオプションとともに使用され、\fIprovider_class_name\fRのコンストラクタのオプションの文字列入力引数を表します。 +\fB\-providerClass\fRオプションとともに使用され、\fBprovider_class_name\fRのコンストラクタのオプションの文字列入力引数を表します。 .RE .PP \-protected .RS 4 -\fItrue\fRまたは\fIfalse\fRのいずれか。パスワードを専用PINリーダーなどの保護された認証パス経由で指定する必要がある場合は、この値を\fItrue\fRに指定する必要があります。\fI\-importkeystore\fRコマンドには2つのキーストアが関連しているため、ソース・キーストアと宛先キーストアにそれぞれ次の2つのオプション、\fI\-srcprotected\fRと\-\fIdestprotected\fRが用意されています。 +\fBtrue\fRまたは\fBfalse\fRのいずれか。パスワードを専用PINリーダーなどの保護された認証パス経由で指定する必要がある場合は、この値を\fBtrue\fRに指定する必要があります。\fB\-importkeystore\fRコマンドには2つのキーストアが関連しているため、ソース・キーストアと宛先キーストアにそれぞれ次の2つのオプション、\fB\-srcprotected\fRと\-\fBdestprotected\fRが用意されています。 .RE .PP \-ext \fI{name{:critical} {=value}}\fR .RS 4 -X\&.509証明書エクステンションを示します。このオプションを\fI\-genkeypair\fRおよび\fI\-gencert\fRで使用して、生成される証明書または\fI\-certreq\fRにエクステンションを埋め込み、証明書リクエストでリクエストされるエクステンションを示すことができます。このオプションは複数回指定できます。\fIname\fR引数には、サポートされているエクステンション名(名前付きエクステンションを参照)または任意のOID番号を指定できます。指定されている場合、\fIvalue\fR引数はエクステンションの引数を指します。\fIvalue\fRを省略した場合、エクステンションのデフォルト値またはエクステンションが引数を必要としないことを示します。\fI:critical\fR修飾子が指定された場合、エクステンションの\fIisCritical\fR属性は\fItrue\fRで、指定されない場合は\fIfalse\fRです。\fI:critical\fRのかわりに\fI:c\fRを使用できます。 +X\&.509証明書エクステンションを示します。このオプションを\fB\-genkeypair\fRおよび\fB\-gencert\fRで使用して、生成される証明書または\fB\-certreq\fRにエクステンションを埋め込み、証明書リクエストでリクエストされるエクステンションを示すことができます。このオプションは複数回指定できます。\fBname\fR引数には、サポートされているエクステンション名(名前付きエクステンションを参照)または任意のOID番号を指定できます。指定されている場合、\fBvalue\fR引数はエクステンションの引数を指します。\fIvalue\fRを省略した場合、エクステンションのデフォルト値またはエクステンションが引数を必要としないことを示します。\fB:critical\fR修飾子が指定された場合、エクステンションの\fBisCritical\fR属性は\fBtrue\fRで、指定されない場合は\fBfalse\fRです。\fB:critical\fRのかわりに\fB:c\fRを使用できます。 .RE .SH "名前付きエクステンション" .PP -\fIkeytool\fRコマンドは、次の名前のエクステンションをサポートしています。名前の大/小文字は区別されません。 +\fBkeytool\fRコマンドは、次の名前のエクステンションをサポートしています。名前の大/小文字は区別されません。 .PP BCまたはBasicContraints .RS 4 -\fB値\fR: 完全な形式は次のとおりです: -\fIca:{true|false}[,pathlen:<len>]\fRまたは\fI<len>\fR(これは、\fIca:true,pathlen:<len>\fRの短縮形です)。<\fIlen\fR>を省略すると、\fIca:true\fRの意味になります。 +\fB値\fR: 完全な形式は、\fBca:{true|false}[,pathlen:<len>]\fRまたは\fB<len>\fR(\fBca:true,pathlen:<len>\fRの短縮形)です。<\fBlen\fR>を省略すると、\fBca:true\fRの意味になります。 .RE .PP KUまたはKeyUsage .RS 4 \fB値\fR: -\fIusage\fR(\fIusage\fR)*、\fIusage\fRには\fIdigitalSignature\fR、\fInonRepudiation\fR -(contentCommitment)、\fIkeyEncipherment\fR、\fIdataEncipherment\fR、\fIkeyAgreement\fR、\fIkeyCertSign\fR、\fIcRLSign\fR、\fIencipherOnly\fR、\fIdecipherOnly\fRのいずれかを指定できます。\fIusage\fR引数は、不明確にならないかぎり、最初の数文字(\fIdigitalSignature\fRの場合は\fIdig\fR)またはキャメルケース・スタイル(\fIdigitalSignature\fRの場合は\fIdS\fR、\fIcRLSign\fRの場合は\fIcRLS\fR)で省略表記できます。\fIusage\fR値は、大文字と小文字が区別されます。 +\fBusage\fR(\fBusage\fR)*、\fIusage\fRには\fBdigitalSignature\fR、\fBnonRepudiation\fR +(contentCommitment)、\fBkeyEncipherment\fR、\fBdataEncipherment\fR、\fBkeyAgreement\fR、\fBkeyCertSign\fR、\fBcRLSign\fR、\fBencipherOnly\fR、\fBdecipherOnly\fRのいずれかを指定できます。\fIusage\fR引数は、不明確にならないかぎり、最初の数文字(\fBdigitalSignature\fRの場合は\fBdig\fR)またはキャメルケース・スタイル(\fBdigitalSignature\fRの場合は\fBdS\fR、\fBcRLSign\fRの場合は\fBcRLS\fR)で省略表記できます。\fBusage\fR値は、大文字と小文字が区別されます。 .RE .PP EKUまたはExtendedKeyUsage .RS 4 \fB値\fR: -\fIusage\fR(\fIusage\fR)*、\fIusage\fRには\fIanyExtendedKeyUsage\fR、\fIserverAuth\fR、\fIclientAuth\fR、\fIcodeSigning\fR、\fIemailProtection\fR、\fItimeStamping\fR、\fIOCSPSigning\fRまたは任意の\fIOID文字列\fRのいずれかを指定できます。\fIusage\fR引数は、不明確にならないかぎり、最初の数文字またはキャメルケース・スタイルで省略表記できます。\fIusage\fR値は、大文字と小文字が区別されます。 +\fBusage\fR(\fBusage\fR)*、\fIusage\fRには\fBanyExtendedKeyUsage\fR、\fBserverAuth\fR、\fBclientAuth\fR、\fBcodeSigning\fR、\fBemailProtection\fR、\fBtimeStamping\fR、\fBOCSPSigning\fRまたは任意の\fIOID文字列\fRのいずれかを指定できます。\fIusage\fR引数は、不明確にならないかぎり、最初の数文字またはキャメルケース・スタイルで省略表記できます。\fBusage\fR値は、大文字と小文字が区別されます。 .RE .PP SANまたはSubjectAlternativeName .RS 4 \fB値\fR: -\fItype\fR:\fIvalue\fR -(t\fIype:value\fR)*、\fItype\fRには\fIEMAIL\fR、\fIURI\fR、\fIDNS\fR、\fIIP\fRまたは\fIOID\fRを指定できます。\fIvalue\fR引数は、\fItype\fRの文字列形式の値です。 +\fBtype\fR:\fBvalue\fR +(t\fBype:value\fR)*、\fBtype\fRには\fBEMAIL\fR、\fBURI\fR、\fBDNS\fR、\fBIP\fRまたは\fBOID\fRを指定できます。\fBvalue\fR引数は、\fBtype\fRの文字列形式の値です。 .RE .PP IANまたはIssuerAlternativeName .RS 4 \fB値\fR: -\fISubjectAlternativeName\fRと同じです。 +\fBSubjectAlternativeName\fRと同じです。 .RE .PP SIAまたはSubjectInfoAccess .RS 4 \fB値\fR: -\fImethod\fR:\fIlocation\-type\fR:\fIlocation\-value\fR -(\fImethod:location\-type\fR:\fIlocation\-value\fR)*、\fImethod\fRには\fItimeStamping\fR、\fIcaRepository\fRまたは任意のOIDを指定できます。\fIlocation\-type\fRおよび\fIlocation\-value\fR引数には、\fISubjectAlternativeName\fRエクステンションでサポートされる任意の\fItype\fR:\fIvalue\fRを指定できます。 +\fBmethod\fR:\fBlocation\-type\fR:\fBlocation\-value\fR +(\fBmethod:location\-type\fR:\fBlocation\-value\fR)*、\fBmethod\fRには\fBtimeStamping\fR、\fBcaRepository\fRまたは任意のOIDを指定できます。\fBlocation\-type\fRおよび\fBlocation\-value\fR引数には、\fBSubjectAlternativeName\fRエクステンションでサポートされる任意の\fBtype\fR:\fBvalue\fRを指定できます。 .RE .PP AIAまたはAuthorityInfoAccess .RS 4 \fB値\fR: -\fISubjectInfoAccess\fRと同じです。\fImethod\fR引数には、\fIocsp\fR、\fIcaIssuers\fRまたは任意のOIDを指定できます。 +\fBSubjectInfoAccess\fRと同じです。\fBmethod\fR引数には、\fBocsp\fR、\fBcaIssuers\fRまたは任意のOIDを指定できます。 .RE .PP -\fIname\fRがOIDの場合、OCTET STRINGタイプと長さのバイトを除外したエクステンションについては、値は\fIextnValue\fRの16進ダンプのDERエンコーディングです。HEX文字列では、標準の16進数(0\-9、a\-f、A\-F)以外の文字は無視されます。したがって、01:02:03:04と01020304の両方とも同一の値として受け付けられます。値がない場合、エクステンションの値フィールドは空になります。 +\fBname\fRがOIDの場合、OCTET STRINGタイプと長さのバイトを除外したエクステンションについては、値は\fBextnValue\fRの16進ダンプのDERエンコーディングです。HEX文字列では、標準の16進数(0\-9、a\-f、A\-F)以外の文字は無視されます。したがって、01:02:03:04と01020304の両方とも同一の値として受け付けられます。値がない場合、エクステンションの値フィールドは空になります。 .PP -\fI\-gencert\fRでのみ使用する\fIhonored\fRという特別な名前は、証明書リクエストに含まれるエクステンションを優先する方法を示します。この名前の値は、\fIall\fR(リクエストされるすべてのエクステンションが優先される)、\fIname{:[critical|non\-critical]}\fR(名前付きのエクステンションが優先されるが、別の\fIisCritical\fR属性を使用する)、および\fI\-name\fR(\fIall\fRとともに使用し、例外を示す)のカンマ区切りリストです。デフォルトでは、リクエストされるエクステンションは優先されません。 +\fB\-gencert\fRでのみ使用する\fBhonored\fRという特別な名前は、証明書リクエストに含まれるエクステンションを優先する方法を示します。この名前の値は、\fBall\fR(リクエストされるすべてのエクステンションが優先される)、\fBname{:[critical|non\-critical]}\fR(名前付きのエクステンションが優先されるが、別の\fBisCritical\fR属性を使用する)、および\fB\-name\fR(\fBall\fRとともに使用し、例外を示す)のカンマ区切りリストです。デフォルトでは、リクエストされるエクステンションは優先されません。 .PP -\fI\-ext honored\fRオプションに加え、別の名前の、またはOID -\fI\-ext\fRのオプションを指定した場合は、このエクステンションが、すでに優先されているエクステンションに追加されます。ただし、この名前(またはOID)を優先される値でも使用した場合は、その値と重要性がリクエストに含まれるものをオーバーライドします。 +\fB\-ext honored\fRオプションに加え、別の名前の、またはOID +\fB\-ext\fRのオプションを指定した場合は、このエクステンションが、すでに優先されているエクステンションに追加されます。ただし、この名前(またはOID)を優先される値でも使用した場合は、その値と重要性がリクエストに含まれるものをオーバーライドします。 .PP -\fIsubjectKeyIdentifier\fRエクステンションは常に作成されます。自己署名でない証明書の場合は、\fIauthorityKeyIdentifier\fRが作成されます。 +\fBsubjectKeyIdentifier\fRエクステンションは常に作成されます。自己署名でない証明書の場合は、\fBauthorityKeyIdentifier\fRが作成されます。 .PP \fB注意:\fR ユーザーは、エクステンション(および証明書の他のフィールド)の組合せによっては、インターネットの標準に準拠しない場合があることに注意してください。証明書の準拠に関する警告を参照してください。 @@ -660,57 +662,60 @@ .PP \-gencert .RS 4 -\fI{\-rfc} {\-infile infile} {\-outfile outfile} {\-alias alias} {\-sigalg sigalg} {\-dname dname} {\-startdate startdate {\-ext ext}* {\-validity valDays} [\-keypass keypass] {\-keystore keystore} [\-storepass storepass] {\-storetype storetype} {\-providername provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-rfc} {\-infile infile} {\-outfile outfile} {\-alias alias} {\-sigalg sigalg} {\-dname dname} {\-startdate startdate {\-ext ext}* {\-validity valDays} [\-keypass keypass] {\-keystore keystore} [\-storepass storepass] {\-storetype storetype} {\-providername provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -証明書リクエスト・ファイル(\fIkeytool\fR -\fI\-certreq\fRコマンドで作成可能)に対するレスポンスとして証明書を生成します。このコマンドは、\fIinfile\fRから(省略した場合は、標準入力から)リクエストを読み込み、別名の秘密鍵を使用してそのリクエストに署名して、X\&.509証明書を\fIoutfile\fRに(省略した場合は、標準出力に)出力します。\fI\-rfc\fRを指定した場合、出力形式はBASE64符号化のPEMになります。それ以外の場合は、バイナリDERが作成されます。 +証明書リクエスト・ファイル(\fBkeytool\fR +\fB\-certreq\fRコマンドで作成可能)に対するレスポンスとして証明書を生成します。このコマンドは、\fIinfile\fRから(省略した場合は、標準入力から)リクエストを読み込み、別名の秘密鍵を使用してそのリクエストに署名して、X\&.509証明書を\fIoutfile\fRに(省略した場合は、標準出力に)出力します。\fB\-rfc\fRを指定した場合、出力形式はBASE64符号化のPEMになります。それ以外の場合は、バイナリDERが作成されます。 .sp -\fIsigalg\fR値には、証明書に署名を付けるときに使用するアルゴリズムを指定します。\fIstartdate\fR引数は、証明書の有効開始日時です。\fIvalDays\fR引数は、証明書の有効日数を示します。 +\fBsigalg\fR値には、証明書に署名を付けるときに使用するアルゴリズムを指定します。\fBstartdate\fR引数は、証明書の有効開始日時です。\fBvalDays\fR引数は、証明書の有効日数を示します。 .sp -\fIdname\fRを指定すると、生成される証明書の主体として使用されます。それ以外の場合は、証明書リクエストからの名前が使用されます。 +\fBdname\fRを指定すると、生成される証明書の主体として使用されます。それ以外の場合は、証明書リクエストからの名前が使用されます。 .sp -\fIext\fR値は、証明書に埋め込まれるX\&.509エクステンションを示します。\fI\-ext\fRの構文については、一般オプションを参照してください。 +\fBext\fR値は、証明書に埋め込まれるX\&.509エクステンションを示します。\fB\-ext\fRの構文については、一般オプションを参照してください。 .sp -\fI\-gencert\fRオプションを使用すると、証明書チェーンを作成できます。次の例では、\fIe1\fRという証明書を作成します。この証明書の証明書チェーンには、3つの証明書が含まれています。 +\fB\-gencert\fRオプションを使用すると、証明書チェーンを作成できます。次の例では、\fBe1\fRという証明書を作成します。この証明書の証明書チェーンには、3つの証明書が含まれています。 .sp -次のコマンドは、\fIca\fR、\fIca1\fR、\fIca2\fRおよび\fIe1\fRの4つの鍵ペアを作成します。 +次のコマンドは、\fBca\fR、\fBca1\fR、\fBca2\fRおよび\fBe1\fRの4つの鍵ペアを作成します。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-alias ca \-dname CN=CA \-genkeypair -keytool \-alias ca1 \-dname CN=CA \-genkeypair -keytool \-alias ca2 \-dname CN=CA \-genkeypair -keytool \-alias e1 \-dname CN=E1 \-genkeypair +\fBkeytool \-alias ca \-dname CN=CA \-genkeypair\fR +\fBkeytool \-alias ca1 \-dname CN=CA \-genkeypair\fR +\fBkeytool \-alias ca2 \-dname CN=CA \-genkeypair\fR +\fBkeytool \-alias e1 \-dname CN=E1 \-genkeypair\fR + .fi .if n \{\ .RE .\} -次の2つのコマンドは、署名付き証明書のチェーンを作成します。\fIca\fRは\fIca1\fRに署名し、\fIca1\fRは\fIca2\fRに署名します。すべて自己発行です。 +次の2つのコマンドは、署名付き証明書のチェーンを作成します。\fBca\fRは\fBca1\fRに署名し、\fBca1\fRは\fBca2\fRに署名します。すべて自己発行です。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-alias ca1 \-certreq | - keytool \-alias ca \-gencert \-ext san=dns:ca1 | - keytool \-alias ca1 \-importcert - -keytool \-alias ca2 \-certreq | - $KT \-alias ca1 \-gencert \-ext san=dns:ca2 | - $KT \-alias ca2 \-importcert +\fBkeytool \-alias ca1 \-certreq |\fR +\fB keytool \-alias ca \-gencert \-ext san=dns:ca1 |\fR +\fB keytool \-alias ca1 \-importcert\fR + +\fBkeytool \-alias ca2 \-certreq |\fR +\fB $KT \-alias ca1 \-gencert \-ext san=dns:ca2 |\fR +\fB $KT \-alias ca2 \-importcert\fR + .fi .if n \{\ .RE .\} -次のコマンドは、証明書\fIe1\fRを作成してファイル\fIe1\&.cert\fRに格納します。この証明書は\fIca2\fRによって署名されます。その結果、\fIe1\fRの証明書チェーンには\fIca\fR、\fIca1\fRおよび\fIca2\fRが含まれることになります。 +次のコマンドは、証明書\fBe1\fRを作成してファイル\fBe1\&.cert\fRに格納します。この証明書は\fBca2\fRによって署名されます。その結果、\fBe1\fRの証明書チェーンには\fBca\fR、\fBca1\fRおよび\fBca2\fRが含まれることになります。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-alias e1 \-certreq | keytool \-alias ca2 \-gencert > e1\&.cert +\fBkeytool \-alias e1 \-certreq | keytool \-alias ca2 \-gencert > e1\&.cert\fR + .fi .if n \{\ .RE @@ -719,154 +724,155 @@ .PP \-genkeypair .RS 4 -\fI{\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-startdate value} {\-ext ext}* {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-startdate value} {\-ext ext}* {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp 鍵のペア(公開鍵および関連する秘密鍵)を生成します。公開鍵はX\&.509 v3自己署名証明書でラップされます。証明書は、単一の要素を持つ証明書チェーンとして格納されます。この証明書チェーンと秘密鍵は、aliasで特定される新しいキーストア・エントリに格納されます。 .sp -\fIkeyalg\fR値は鍵ペアの生成に使用するアルゴリズムを、\fIkeysize\fR値は生成する各鍵のサイズを、それぞれ指定します。\fIsigalg\fR値は、自己署名証明書に署名を付けるために使用するアルゴリズムを指定します。このアルゴリズムは\fIkeyalg\fR値と互換性がある必要があります。 +\fBkeyalg\fR値は鍵ペアの生成に使用するアルゴリズムを、\fBkeysize\fR値は生成する各鍵のサイズを、それぞれ指定します。\fBsigalg\fR値は、自己署名証明書に署名を付けるために使用するアルゴリズムを指定します。このアルゴリズムは\fBkeyalg\fR値と互換性がある必要があります。 .sp -\fIdname\fR値には、\fIalias\fR値に関連付け、自己署名証明書のissuerフィールドとsubjectフィールドとして使用するX\&.500識別名を指定します。コマンドラインで識別名を指定しなかった場合は、識別名の入力を求められます。 +\fBdname\fR値には、\fBalias\fR値に関連付け、自己署名証明書のissuerフィールドとsubjectフィールドとして使用するX\&.500識別名を指定します。コマンド行で識別名を指定しなかった場合は、識別名の入力を求められます。 .sp -\fIkeypass\fR値には、生成される鍵のペアのうち、秘密鍵を保護するのに使用するパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、\fI[Return]キー\fRを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\fIkeypass\fR値は、6文字以上にする必要があります。 +\fBkeypass\fR値には、生成される鍵のペアのうち、秘密鍵を保護するのに使用するパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\fBkeypass\fR値は、6文字以上にする必要があります。 .sp -\fIstartdate\fR値には、証明書の発行時刻を指定します。これは、X\&.509証明書の「Validity」フィールドの「Not Before」値とも呼ばれます。 +\fBstartdate\fR値には、証明書の発行時刻を指定します。これは、X\&.509証明書の「Validity」フィールドの「Not Before」値とも呼ばれます。 .sp オプションの値は、次の2つの形式のいずれかで設定できます。 .sp -\fI([+\-]nnn[ymdHMS])+\fR +\fB([+\-]nnn[ymdHMS])+\fR .sp -\fI[yyyy/mm/dd] [HH:MM:SS]\fR +\fB[yyyy/mm/dd] [HH:MM:SS]\fR .sp -最初の形式では、発行時刻は、指定される値の分、現在の時刻から移ります。指定される値は、一連の下位の値を連結したものになります。下位の各値で、プラス記号(「+」)は時間が進むことを、マイナス記号(「\-」)は時間が戻ることを意味しています。移る時間は\fInnn\fRで、単位は年、月、日、時間、分または秒です(それぞれ、1文字の\fIy\fR、\fIm\fR、\fId\fR、\fIH\fR、\fIM\fRまたは\fIS\fR」で示されています)。下位の各値で\fIjava\&.util\&.GregorianCalendar\&.add(int field, int amount)\fRメソッドを使用することで、発行時刻の追加の値が左から右へ計算されます。たとえば、指定すると、発行時刻は次のようになります。 +最初の形式では、発行時刻は、指定される値の分、現在の時刻から移ります。指定される値は、一連の下位の値を連結したものになります。下位の各値で、プラス記号(「+」)は時間が進むことを、マイナス記号(「\-」)は時間が戻ることを意味しています。移る時間は\fBnnn\fRで、単位は年、月、日、時間、分または秒です(それぞれ、1文字の\fBy\fR、\fBm\fR、\fBd\fR、\fBH\fR、\fBM\fRまたは\fBS\fR」で示されています)。下位の各値で\fBjava\&.util\&.GregorianCalendar\&.add(int field, int amount)\fRメソッドを使用することで、発行時刻の追加の値が左から右へ計算されます。たとえば、指定すると、発行時刻は次のようになります。 .sp .if n \{\ .RS 4 .\} .nf -Calendar c = new GregorianCalendar(); -c\&.add(Calendar\&.YEAR, \-1); -c\&.add(Calendar\&.MONTH, 1); -c\&.add(Calendar\&.DATE, \-1); -return c\&.getTime() +\fBCalendar c = new GregorianCalendar();\fR +\fBc\&.add(Calendar\&.YEAR, \-1);\fR +\fBc\&.add(Calendar\&.MONTH, 1);\fR +\fBc\&.add(Calendar\&.DATE, \-1);\fR +\fBreturn c\&.getTime()\fR + .fi .if n \{\ .RE .\} -2番目の形式では、ユーザーは、年/月/日と時間:分:秒の2つの部分で厳密な開始時刻を設定します(地元の時間帯を使用)。ユーザーは、1つの部分のみを指定できます。これは、もう1つの部分は現在の日付(または時刻)と同じになるということです。ユーザーは、形式の定義に示されているように、桁数を厳密に指定する必要があります(短い場合は0で埋めます)。日付と時刻の両方が指定された状態で、2つの部分の間に空白文字が1つ(1つのみ)あります。時間は常に24時間形式で指定してください。 +2番目の形式では、ユーザーは、年/月/日と時間:分:秒の2つの部分からなる正確な発行時刻を設定します(ローカルのタイム・ゾーンを使用)。ユーザーは、1つの部分のみを指定できます。これは、もう1つの部分は現在の日付(または時刻)と同じになるということです。ユーザーは、形式の定義に示されているように、桁数を厳密に指定する必要があります(短い場合は0で埋めます)。日付と時刻の両方が指定された状態で、2つの部分の間に空白文字が1つ(1つのみ)あります。時間は常に24時間形式で指定してください。 .sp オプションを指定しないと、開始日付は現在の時刻になります。オプションは、最大で1回指定できます。 .sp -\fIvalDays\fRの値には、証明書の有効日数を指定します(\fI\-startdate\fRで指定された日付、または\fI\-startdate\fRが指定されていない場合は現在の日付から始まります)。 +\fBvalDays\fRの値には、証明書の有効日数を指定します(\fB\-startdate\fRで指定された日付、または\fB\-startdate\fRが指定されていない場合は現在の日付から始まります)。 .sp -このコマンドは、以前のリリースでは\fI\-genkey\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fI\-genkeypair\fRが優先されます。 +このコマンドは、以前のリリースでは\fB\-genkey\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fB\-genkeypair\fRが優先されます。 .RE .PP \-genseckey .RS 4 -\fI\-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB\-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -秘密鍵を生成し、それを新しい\fIKeyStore\&.SecretKeyEntry\fR(\fIalias\fRで特定される)内に格納します。 +秘密鍵を生成し、それを新しい\fBKeyStore\&.SecretKeyEntry\fR(\fBalias\fRで特定される)内に格納します。 .sp -\fIkeyalg\fR値は鍵ペアの生成に使用するアルゴリズムを、\fIkeysize\fR値は生成する各鍵のサイズを、それぞれ指定します。\fIkeypass\fR値は、秘密鍵を保護するパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、\fIkeystore\fRのパスワードと同じパスワードが鍵のパスワードに設定されます。\fIkeypass\fR値は、6文字以上にする必要があります。 +\fBkeyalg\fR値は鍵ペアの生成に使用するアルゴリズムを、\fBkeysize\fR値は生成する各鍵のサイズを、それぞれ指定します。\fBkeypass\fR値は、秘密鍵を保護するパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、\fBkeystore\fRのパスワードと同じパスワードが鍵のパスワードに設定されます。\fBkeypass\fR値は、6文字以上にする必要があります。 .RE .PP \-importcert .RS 4 -\fI\-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB\-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -ファイル\fIcert_file\fRから証明書または証明書チェーン(証明書チェーンの場合は、PKCS#7形式の応答または一連のX\&.509証明書で提供されるもの)を読み込み、\fIalias\fRによって特定される\fIkeystore\fRエントリに格納します。ファイルが指定されていない場合は、\fIstdin\fRから証明書または証明書チェーンを読み込みます。 +ファイル\fBcert_file\fRから証明書または証明書チェーン(証明書チェーンの場合は、PKCS#7形式の応答または一連のX\&.509証明書で提供されるもの)を読み込み、\fBalias\fRによって特定される\fBkeystore\fRエントリに格納します。ファイルが指定されていない場合は、\fBstdin\fRから証明書または証明書チェーンを読み込みます。 .sp -\fIkeytool\fRコマンドでは、X\&.509 v1、v2、v3の証明書、およびPKCS#7形式の証明書から構成されているPKCS#7形式の証明書チェーンをインポートできます。インポートするデータは、バイナリ符号化方式、または出力可能符号化方式(Base64符号化とも呼ばれる)のどちらかで提供する必要があります。出力可能符号化方式は、インターネットRFC 1421証明書符号化規格で定義されています。この符号化方式の場合、証明書は\fI\-\fR\fI\-\-\-\-BEGIN\fRで始まる文字列で開始され、\fI\-\-\-\-\-END\fRで始まる文字列で終了する必要があります。 +\fBkeytool\fRコマンドでは、X\&.509 v1、v2、v3の証明書、およびPKCS#7形式の証明書から構成されているPKCS#7形式の証明書チェーンをインポートできます。インポートするデータは、バイナリ符号化方式、または出力可能符号化方式(Base64符号化とも呼ばれる)のどちらかで提供する必要があります。出力可能符号化方式は、インターネットRFC 1421証明書符号化規格で定義されています。この符号化方式の場合、証明書は\fB\-\fR\fB\-\-\-\-BEGIN\fRで始まる文字列で開始され、\fB\-\-\-\-\-END\fRで始まる文字列で終了する必要があります。 .sp -証明書は、信頼できる証明書のリストに追加するため、および認証局(CA)に証明書署名リクエストを送信した結果としてCAから受信した証明書応答をインポートするため(コマンドの\fI\-certreq\fRオプションを参照)という2つの理由でインポートします。 +証明書は、信頼できる証明書のリストに追加するため、および認証局(CA)に証明書署名リクエストを送信した結果としてCAから受信した証明書応答をインポートするため(\fBの\fR\-certreqコマンドオプションを参照)という2つの理由でインポートします。 .sp -どちらのタイプのインポートを行うかは、\fI\-alias\fRオプションの値によって指定します。別名がキー・エントリをポイントしない場合、\fIkeytool\fRコマンドはユーザーが信頼できる証明書エントリを追加しようとしているものとみなします。この場合、別名がキーストア内に存在していないことが必要です。別名がすでに存在している場合、その別名の信頼できる証明書がすでに存在することになるので、\fIkeytool\fRコマンドはエラーを出力し、証明書のインポートを行いません。別名がキー・エントリをポイントする場合、\fIkeytool\fRコマンドはユーザーが証明書応答をインポートしようとしているものとみなします。 +どちらのタイプのインポートを行うかは、\fB\-alias\fRオプションの値によって指定します。別名がキー・エントリをポイントしない場合、\fBkeytool\fRコマンドはユーザーが信頼できる証明書エントリを追加しようとしているものとみなします。この場合、別名がキーストア内に存在していないことが必要です。別名がすでに存在している場合、その別名の信頼できる証明書がすでに存在することになるので、\fBkeytool\fRコマンドはエラーを出力し、証明書のインポートを行いません。別名がキー・エントリをポイントする場合、\fBkeytool\fRコマンドはユーザーが証明書応答をインポートしようとしているものとみなします。 .RE .PP \-importpassword .RS 4 -\fI{\-alias alias} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -パスフレーズをインポートし、\fIalias\fRで識別される新規\fIKeyStore\&.SecretKeyEntry\fRに格納します。パスフレーズは、標準入力ストリームを介して提供できます。または、ユーザーにそのプロンプトが表示されます。\fIkeypass\fRは、インポートされるパスフレーズの保護に使用されるパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、\fIkeystore\fRのパスワードと同じパスワードが鍵のパスワードに設定されます。\fIkeypass\fRは、6文字以上にする必要があります。 +パスフレーズをインポートし、\fBalias\fRで識別される新規\fBKeyStore\&.SecretKeyEntry\fRに格納します。パスフレーズは、標準入力ストリームを介して提供できます。または、ユーザーにそのプロンプトが表示されます。\fBkeypass\fRは、インポートされるパスフレーズの保護に使用されるパスワードです。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、[Return]キーを押すと、\fBkeystore\fRのパスワードと同じパスワードが鍵のパスワードに設定されます。\fBkeypass\fRは、6文字以上にする必要があります。 .RE .PP \-importkeystore .RS 4 -\fI{\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] } [\-destkeypass destkeypass] {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] } [\-destkeypass destkeypass] {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp ソース・キーストアからターゲット・キーストアへ、単一のエントリまたはすべてのエントリをインポートします。 .sp -\fI\-srcalias\fRオプションが指定された場合、このコマンドは、その別名で特定される単一のエントリをターゲット・キーストアにインポートします。\fIdestalias\fR経由でターゲット別名が指定されなかった場合、\fIsrcalias\fRがターゲット別名として使用されます。ソースのエントリがパスワードで保護されていた場合、\fIsrckeypass\fRを使用してそのエントリが回復されます。\fIsrckeypass\fRが指定されなかった場合、\fIkeytool\fRコマンドは\fIsrcstorepass\fRを使用してそのエントリを回復しようとします。\fIsrcstorepass\fRが指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ターゲットのエントリは\fIdestkeypass\fRによって保護されます。\fIdestkeypass\fRが指定されなかった場合、ターゲット・エントリはソース・エントリのパスワードによって保護されます。たとえば、ほとんどのサード・パーティ・ツールでは、PKCS #12キーストアで\fIstorepass\fRと\fIkeypass\fRが同じである必要があります。これらのツールのPKCS #12キーストアを作成する場合は、常に\fI\-destkeypass\fRと\fI\-deststorepass\fRが同じになるように指定します。 +\fB\-srcalias\fRオプションが指定された場合、このコマンドは、その別名で特定される単一のエントリをターゲット・キーストアにインポートします。\fBdestalias\fR経由でターゲット別名が指定されなかった場合、\fBsrcalias\fRがターゲット別名として使用されます。ソースのエントリがパスワードで保護されていた場合、\fBsrckeypass\fRを使用してそのエントリが回復されます。\fIsrckeypass\fRが指定されなかった場合、\fBkeytool\fRコマンドは\fBsrcstorepass\fRを使用してそのエントリを回復しようとします。\fBsrcstorepass\fRが指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ターゲットのエントリは\fBdestkeypass\fRによって保護されます。\fBdestkeypass\fRが指定されなかった場合、ターゲット・エントリはソース・エントリのパスワードによって保護されます。たとえば、ほとんどのサード・パーティ・ツールでは、PKCS #12キーストアで\fBstorepass\fRと\fBkeypass\fRが同じである必要があります。これらのツールのPKCS #12キーストアを作成する場合は、常に\fB\-destkeypass\fRと\fB\-deststorepass\fRが同じになるように指定します。 .sp -\fI\-srcalias\fRオプションが指定されなかった場合、ソース・キーストア内のすべてのエントリがターゲット・キーストア内にインポートされます。各ターゲット・エントリは対応するソース・エントリの別名の下に格納されます。ソースのエントリがパスワードで保護されていた場合、\fIsrcstorepass\fRを使用してそのエントリが回復されます。\fIsrcstorepass\fRが指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ソース・キーストア内のあるエントリ・タイプがターゲット・キーストアでサポートされていない場合や、あるエントリをターゲット・キーストアに格納する際にエラーが発生した場合、ユーザーはそのエントリをスキップして処理を続行するか、あるいは処理を中断するかの選択を求められます。ターゲット・エントリはソース・エントリのパスワードによって保護されます。 +\fB\-srcalias\fRオプションが指定されなかった場合、ソース・キーストア内のすべてのエントリがターゲット・キーストア内にインポートされます。各ターゲット・エントリは対応するソース・エントリの別名の下に格納されます。ソースのエントリがパスワードで保護されていた場合、\fBsrcstorepass\fRを使用してそのエントリが回復されます。\fBsrcstorepass\fRが指定されなかったか正しくなかった場合、ユーザーはパスワードの入力を求められます。ソース・キーストア内のあるエントリ・タイプがターゲット・キーストアでサポートされていない場合や、あるエントリをターゲット・キーストアに格納する際にエラーが発生した場合、ユーザーはそのエントリをスキップして処理を続行するか、または中止するかの選択を求められます。ターゲット・エントリはソース・エントリのパスワードによって保護されます。 .sp ターゲット別名がターゲット・キーストア内にすでに存在していた場合、ユーザーは、そのエントリを上書きするか、あるいは異なる別名の下で新しいエントリを作成するかの選択を求められます。 .sp -\fI\-noprompt\fRオプションを指定した場合、ユーザーは新しいターゲット別名の入力を求められません。既存のエントリがそのターゲット別名で上書きされます。インポートできないエントリはスキップされ、警告が出力されます。 +\fB\-noprompt\fRオプションを指定した場合、ユーザーは新しいターゲット別名の入力を求められません。既存のエントリがそのターゲット別名で上書きされます。インポートできないエントリはスキップされ、警告が出力されます。 .RE .PP \-printcertreq .RS 4 -\fI{\-file file}\fR +\fB{\-file file}\fR .sp -PKCS#10形式の証明書リクエストの内容を出力します。このリクエストは、\fIkeytool\fR -\fI\-certreq\fRコマンドで生成できます。このコマンドは、ファイルからリクエストを読み取ります。ファイルが存在しない場合、リクエストは標準入力から読み取られます。 +PKCS#10形式の証明書リクエストの内容を出力します。このリクエストは、\fBkeytool\fR +\fB\-certreq\fRコマンドで生成できます。このコマンドは、ファイルからリクエストを読み取ります。ファイルが存在しない場合、リクエストは標準入力から読み取られます。 .RE .PP \-certreq .RS 4 -\fI{\-alias alias} {\-dname dname} {\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} {\-dname dname} {\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp PKCS#10形式を使用して証明書署名リクエスト(CSR)を生成します。 .sp CSRは、証明書発行局(CA)に送信することを目的としたものです。CAは、証明書要求者を(通常はオフラインで)認証し、証明書または証明書チェーンを送り返します。この証明書または証明書チェーンは、キーストア内の既存の証明書チェーン(最初は1つの自己署名証明書から構成される)に置き換えて使用します。 .sp -aliasに関連付けられた秘密鍵は、PKCS#10証明書リクエストを作成するのに使用されます。秘密鍵にアクセスするには、正しいパスワードを指定する必要があります。コマンドラインで\fIkeypass\fRを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。\fIdname\fRが指定されている場合は、それがCSRで主体として使用されます。それ以外の場合は、別名に関連付けられたX\&.500識別名が使用されます。 +aliasに関連付けられた秘密鍵は、PKCS#10証明書リクエストを作成するのに使用されます。秘密鍵にアクセスするには、正しいパスワードを指定する必要があります。コマンド行で\fBkeypass\fRを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。\fBdname\fRが指定されている場合は、それがCSRで主体として使用されます。それ以外の場合は、別名に関連付けられたX\&.500識別名が使用されます。 .sp -\fIsigalg\fR値には、CSRに署名を付けるときに使用するアルゴリズムを指定します。 +\fBsigalg\fR値には、CSRに署名を付けるときに使用するアルゴリズムを指定します。 .sp -CSRは、ファイルcertreq_fileに格納されます。ファイルが指定されていない場合は、\fIstdout\fRにCSRが出力されます。 +CSRは、ファイルcertreq_fileに格納されます。ファイルが指定されていない場合は、\fBstdout\fRにCSRが出力されます。 .sp -CAからのレスポンスをインポートするには、\fIimportcert\fRコマンドを使用します。 +CAからのレスポンスをインポートするには、\fBimportcert\fRコマンドを使用します。 .RE .PP \-exportcert .RS 4 -\fI{\-alias alias} {\-file cert_file} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-rfc} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} {\-file cert_file} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-rfc} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -\fIalias\fRに関連付けられた証明書をキーストアから読み込み、ファイルcert_fileに格納します。ファイルが指定されていない場合は、\fIstdout\fRに証明書が出力されます。 +\fIalias\fRに関連付けられた証明書をキーストアから読み込み、ファイルcert_fileに格納します。ファイルが指定されていない場合は、\fBstdout\fRに証明書が出力されます。 .sp -デフォルトでは、証明書はバイナリ符号化で出力されます。\fI\-rfc\fRオプションが指定されている場合、出力可能符号化方式の出力はインターネットRFC 1421証明書符号化規格で定義されます。 +デフォルトでは、証明書はバイナリ符号化で出力されます。\fB\-rfc\fRオプションが指定されている場合、出力可能符号化方式の出力はインターネットRFC 1421証明書符号化規格で定義されます。 .sp -\fIalias\fRが、信頼できる証明書を参照している場合は、該当する証明書が出力されます。それ以外の場合、\fIalias\fRは、関連付けられた証明書チェーンを持つ鍵エントリを参照します。この場合は、チェーン内の最初の証明書が返されます。この証明書は、\fIalias\fRによって表されるエンティティの公開鍵を認証する証明書です。 +\fBalias\fRが、信頼できる証明書を参照している場合は、該当する証明書が出力されます。それ以外の場合、\fBalias\fRは、関連付けられた証明書チェーンを持つ鍵エントリを参照します。この場合は、チェーン内の最初の証明書が返されます。この証明書は、\fBalias\fRによって表されるエンティティの公開鍵を認証する証明書です。 .sp -このコマンドは、以前のリリースでは\fI\-export\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fI\-exportcert\fRが優先されます。 +このコマンドは、以前のリリースでは\fB\-export\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fB\-exportcert\fRが優先されます。 .RE .PP \-list .RS 4 -\fI{\-alias alias} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v | \-rfc} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v | \-rfc} {\-protected} {\-Jjavaoption}\fR .sp -\fIalias\fRで特定されるキーストア・エントリの内容を\fIstdout\fRに出力します。\fIalias\fRが指定されていない場合は、キーストア全体の内容が表示されます。 +\fBalias\fRで特定されるキーストア・エントリの内容を\fBstdout\fRに出力します。\fBalias\fRが指定されていない場合は、キーストア全体の内容が表示されます。 .sp このコマンドは、デフォルトでは証明書のSHA1フィンガープリントを表示します。 -\fI\-v\fRオプションが指定されている場合は、所有者、発行者、シリアル番号、拡張機能などの付加的な情報とともに、人間が読むことのできる形式で証明書が表示されます。\fI\-rfc\fRオプションが指定されている場合は、出力可能符号化方式で証明書の内容が出力されます。出力可能符号化方式は、インターネットRFC 1421証明書符号化規格で定義されています。 +\fB\-v\fRオプションが指定されている場合は、所有者、発行者、シリアル番号、拡張機能などの付加的な情報とともに、人間が読むことのできる形式で証明書が表示されます。\fB\-rfc\fRオプションが指定されている場合は、出力可能符号化方式で証明書の内容が出力されます。出力可能符号化方式は、インターネットRFC 1421証明書符号化規格で定義されています。 .sp -\fI\-v\fRオプションと\fI\-rfc\fRオプションを同時に指定することはできません。 +\fB\-v\fRオプションと\fB\-rfc\fRオプションを同時に指定することはできません。 .RE .PP \-printcert .RS 4 -\fI{\-file cert_file | \-sslserver host[:port]} {\-jarfile JAR_file {\-rfc} {\-v} {\-Jjavaoption}\fR +\fB{\-file cert_file | \-sslserver host[:port]} {\-jarfile JAR_file {\-rfc} {\-v} {\-Jjavaoption}\fR .sp -ファイルcert_file、host:portにあるSSLサーバー、または署名付きJARファイル\fIJAR_file\fR(\fI\-jarfile\fRオプションを指定)から証明書を読み込み、人間が読むことのできる形式で証明書の内容を表示します。ポートが指定されていない場合は、標準のHTTPSポート443が想定されます。\fI\-sslserver\fRおよび\-fileオプションを同時に指定することはできません。これに反する場合、エラーが報告されます。オプションが指定されていない場合は、\fIstdin\fRから証明書を読み込みます。 +ファイルcert_file、host:portにあるSSLサーバー、または署名付きJARファイル\fBJAR_file\fR(\fB\-jarfile\fRオプションを指定)から証明書を読み込み、人間が読むことのできる形式で証明書の内容を表示します。ポートが指定されていない場合は、標準のHTTPSポート443が想定されます。\fB\-sslserver\fRおよび\-fileオプションを同時に指定することはできません。それ以外の場合、エラーが報告されます。オプションが指定されていない場合は、\fBstdin\fRから証明書を読み込みます。 .sp -\fI\-rfc\fRが指定されている場合、\fIkeytool\fRコマンドは、インターネットRFC 1421証明書符号化標準で定義されているように、PEMモードで証明書を出力します。インターネットRFC 1421証明書符号化規格を参照してください。 +\fB\-rfc\fRが指定されている場合、\fBkeytool\fRコマンドは、インターネットRFC 1421証明書符号化標準で定義されているように、PEMモードで証明書を出力します。インターネットRFC 1421証明書符号化規格を参照してください。 .sp -ファイルまたは\fIstdin\fRから証明書を読み込む場合、その証明書は、インターネットRFC 1421証明書符号化標準で定義されているように、バイナリ符号化方式または出力可能符号化方式で表示できます。 +ファイルまたは\fBstdin\fRから証明書を読み込む場合、その証明書は、インターネットRFC 1421証明書符号化標準で定義されているように、バイナリ符号化方式または出力可能符号化方式で表示できます。 .sp -SSLサーバーがファイアウォールの背後にある場合は、\fI\-J\-Dhttps\&.proxyHost=proxyhost\fRおよび\fI\-J\-Dhttps\&.proxyPort=proxyport\fRオプションをコマンドラインで指定して、プロキシ・トンネリングを使用できます。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/jsse/JSSERefGuide\&.htmlの +SSLサーバーがファイアウォールの背後にある場合は、\fB\-J\-Dhttps\&.proxyHost=proxyhost\fRおよび\fB\-J\-Dhttps\&.proxyPort=proxyport\fRオプションをコマンド行で指定して、プロキシ・トンネリングを使用できます。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/jsse/JSSERefGuide\&.htmlの 「Java Secure Socket Extension (JSSE) Reference Guide」を参照してください .sp \fB注意:\fR @@ -875,9 +881,9 @@ .PP \-printcrl .RS 4 -\fI\-file crl_ {\-v}\fR +\fB\-file crl_ {\-v}\fR .sp -ファイル\fIcrl_\fRから証明書失効リスト(CRL)を読み込みます。CRLは、発行したCAによって失効されたデジタル証明書のリストです。CAは、\fIcrl_\fRを生成します。 +ファイル\fBcrl_\fRから証明書失効リスト(CRL)を読み込みます。CRLは、発行したCAによって失効されたデジタル証明書のリストです。CAは、\fBcrl_\fRを生成します。 .sp \fB注意:\fR このオプションはキーストアとは関係なく使用できます。 @@ -885,34 +891,34 @@ .PP \-storepasswd .RS 4 -\fI[\-new new_storepass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}\fR +\fB[\-new new_storepass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}\fR .sp -キーストアの内容の整合性を保護するために使用するパスワードを変更します。\fInew_storepass\fRには、新しいパスワードを指定します。new_storepassは、6文字以上である必要があります。 +キーストアの内容の整合性を保護するために使用するパスワードを変更します。\fBnew_storepass\fRには、新しいパスワードを指定します。new_storepassは、6文字以上である必要があります。 .RE .PP \-keypasswd .RS 4 -\fI{\-alias alias} [\-keypass old_keypass] [\-new new_keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}\fR +\fB{\-alias alias} [\-keypass old_keypass] [\-new new_keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}\fR .sp -\fIalias\fRによって特定される非公開/秘密鍵を保護するためのパスワードを、\fIold_keypass\fRから\fInew_keypass\fRに変更します。new_keypassは、6文字以上である必要があります。 +\fBalias\fRによって特定される非公開/秘密鍵を保護するためのパスワードを、\fBold_keypass\fRから\fBnew_keypass\fRに変更します。new_keypassは、6文字以上である必要があります。 .sp -コマンドラインで\fI\-keypass\fRオプションを指定しておらず、鍵のパスワードがキーストアのパスワードと異なる場合は、鍵のパスワードの入力を求められます。 +コマンド行で\fB\-keypass\fRオプションを指定しておらず、鍵のパスワードがキーストアのパスワードと異なる場合は、鍵のパスワードの入力を求められます。 .sp -コマンドラインで\fI\-new\fRオプションを指定しなかった場合は、新しいパスワードの入力を求められます。 +コマンド行で\fB\-new\fRオプションを指定しなかった場合は、新しいパスワードの入力を求められます。 .RE .PP \-delete .RS 4 -\fI[\-alias alias] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB[\-alias alias] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -\fIalias\fRによって特定されるエントリをキーストアから削除します。コマンドラインで別名を指定しなかった場合は、別名の入力を求められます。 +\fBalias\fRによって特定されるエントリをキーストアから削除します。コマンド行で別名を指定しなかった場合は、別名の入力を求められます。 .RE .PP \-changealias .RS 4 -\fI{\-alias alias} [\-destalias destalias] [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR +\fB{\-alias alias} [\-destalias destalias] [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}\fR .sp -指定された\fIalias\fRから新しい別名\fIdestalias\fRへ、既存のキーストア・エントリを移動します。ターゲット別名を指定しなかった場合、ターゲット別名の入力を求められます。元のエントリがエントリ・パスワードで保護されていた場合、\fI\-keypass\fRオプションでそのパスワードを指定できます。鍵パスワードが指定されなかった場合、\fIstorepass\fR(指定された場合)がまず試みられます。その試みが失敗すると、ユーザーはパスワードの入力を求められます。 +指定された\fBalias\fRから新しい別名\fBdestalias\fRへ、既存のキーストア・エントリを移動します。ターゲット別名を指定しなかった場合、ターゲット別名の入力を求められます。元のエントリがエントリ・パスワードで保護されていた場合、\fB\-keypass\fRオプションでそのパスワードを指定できます。鍵パスワードが指定されなかった場合、\fBstorepass\fR(指定された場合)がまず試みられます。その試みが失敗すると、ユーザーはパスワードの入力を求められます。 .RE .PP \-help @@ -920,7 +926,7 @@ 基本的なコマンドとそのオプションの一覧を表示します。 .sp 特定のコマンドの詳細を参照するには、次のように入力してください: -\fIkeytool \-command_name \-help\fR。\fIcommand_name\fRはコマンドの名前です。 +\fBkeytool \-command_name \-help\fR。\fBcommand_name\fRはコマンドの名前です。 .RE .SH "例" .PP @@ -933,18 +939,19 @@ .RS 4 .\} .nf -keytool \-genkeypair \-dname "cn=Mark Jones, ou=Java, o=Oracle, c=US" - \-alias business \-keypass <new password for private key> - \-keystore /working/mykeystore - \-storepass <new password for keystore> \-validity 180 +\fBkeytool \-genkeypair \-dname "cn=Mark Jones, ou=Java, o=Oracle, c=US"\fR +\fB \-alias business \-keypass <new password for private key>\fR +\fB \-keystore /working/mykeystore\fR +\fB \-storepass <new password for keystore> \-validity 180\fR + .fi .if n \{\ .RE .\} .PP -コマンドは、workingディレクトリに\fImykeystore\fRという名前のキーストアを作成し(キーストアはまだ存在していないと仮定)、作成したキーストアに、\fI<new password for keystore>\fRで指定したパスワードを割り当てます。生成する公開鍵と秘密鍵のペアに対応するエンティティの「識別名」は、通称がMark Jones、組織単位がJava、組織がOracle、2文字の国番号がUSです。公開鍵と秘密鍵のサイズはどちらも1024ビットで、鍵の作成にはデフォルトのDSA鍵生成アルゴリズムを使用します。 +コマンドは、workingディレクトリに\fBmykeystore\fRという名前のキーストアを作成し(キーストアはまだ存在していないと仮定)、作成したキーストアに、\fB<new password for keystore>\fRで指定したパスワードを割り当てます。生成する公開鍵と秘密鍵のペアに対応するエンティティの「識別名」は、通称がMark Jones、組織単位がJava、組織がOracle、2文字の国番号がUSです。公開鍵と秘密鍵のサイズはどちらも1024ビットで、鍵の作成にはデフォルトのDSA鍵生成アルゴリズムを使用します。 .PP -このコマンドは、デフォルトのSHA1withDSA署名アルゴリズムを使用して、公開鍵と識別名情報を含む自己署名証明書を作成します。証明書の有効期間は180日です。証明書は、別名\fIbusiness\fRで特定されるキーストア・エントリ内の秘密鍵に関連付けられます。秘密鍵には、\fI<new password for private key>\fRで指定したパスワードが割り当てられます。 +このコマンドは、デフォルトのSHA1withDSA署名アルゴリズムを使用して、公開鍵と識別名情報を含む自己署名証明書を作成します。証明書の有効期間は180日です。証明書は、別名\fBbusiness\fRで特定されるキーストア・エントリ内の秘密鍵に関連付けられます。秘密鍵には、\fB<new password for private key>\fRで指定したパスワードが割り当てられます。 .PP オプションのデフォルト値を使用する場合、コマンドは大幅に短くなります。この場合、オプションは不要です。デフォルト値を持つオプションでは、オプションを指定しなければデフォルト値が使用されます。必須値の入力を求められます。使用可能な値は次のとおりです。 .sp @@ -952,15 +959,16 @@ .RS 4 .\} .nf -keytool \-genkeypair +\fBkeytool \-genkeypair\fR + .fi .if n \{\ .RE .\} .PP -この場合は、\fImykey\fRという別名でキーストア・エントリが作成され、新しく生成された鍵のペア、および90日間有効な証明書がこのエントリに格納されます。このエントリは、ホーム・ディレクトリ内の\fI\&.keystore\fRという名前のキーストアに置かれます。キーストアは、まだ存在していない場合に作成されます。識別名情報、キーストアのパスワードおよび秘密鍵のパスワードの入力を求められます。 +この場合は、\fBmykey\fRという別名でキーストア・エントリが作成され、新しく生成された鍵のペア、および90日間有効な証明書がこのエントリに格納されます。このエントリは、ホーム・ディレクトリ内の\fB\&.keystore\fRという名前のキーストアに置かれます。キーストアは、まだ存在していない場合に作成されます。識別名情報、キーストアのパスワードおよび秘密鍵のパスワードの入力を求められます。 .PP -以降では、オプションを指定しないで\fI\-genkeypair\fRコマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した\fI\-genkeypair\fRコマンドの値を入力したものとします。たとえば識別名には\fIcn=Mark Jones\fR、\fIou=Java\fR、\fIo=Oracle\fR、\fIc=US\fRと指定します。 +以降では、オプションを指定しないで\fB\-genkeypair\fRコマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した\fB\-genkeypair\fRコマンドの値を入力したものとします。たとえば識別名には\fBcn=Mark Jones\fR、\fBou=Java\fR、\fBo=Oracle\fR、\fBc=US\fRと指定します。 .SS "CAからの署名付き証明書のリクエスト" .PP 自己署名証明書を作成する鍵のペアの生成。証明書に証明書発行局(CA)の署名が付いていれば、他のユーザーから証明書が信頼される可能性も高くなります。CAの署名を取得するには、まず、証明書署名リクエスト(CSR)を生成します。たとえば、次のようにします。 @@ -969,18 +977,19 @@ .RS 4 .\} .nf -keytool \-certreq \-file MarkJ\&.csr +\fBkeytool \-certreq \-file MarkJ\&.csr\fR + .fi .if n \{\ .RE .\} .PP -CSR(デフォルト別名\fImykey\fRによって特定されるエンティティのCSR)が作成され、MarkJ\&.csrという名前のファイルに置かれます。このファイルをCA (VeriSignなど)に提出します。CAは要求者を(通常はオフラインで)認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CAが証明書のチェーンを返すこともあります。証明書のチェーンでは、各証明書がチェーン内のその前の署名者の公開鍵を認証します。 +CSR(デフォルト別名\fBmykey\fRによって特定されるエンティティのCSR)が作成され、MarkJ\&.csrという名前のファイルに置かれます。このファイルをCA (VeriSignなど)に提出します。CAは要求者を(通常はオフラインで)認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CAが証明書のチェーンを返すこともあります。証明書のチェーンでは、各証明書がチェーン内のその前の署名者の公開鍵を認証します。 .SS "CAからの証明書のインポート" .PP 作成した自己署名証明書は、証明書チェーンで置き換える必要があります。証明書チェーンでは、各証明書が、「ルート」CAを起点とするチェーン内の次の証明書の署名者の公開鍵を認証します。 .PP -CAからの証明書応答をインポートするには、キーストアか、\fIcacerts\fRキーストア・ファイル内に1つ以上の信頼できる証明書がある必要があります。\fIの\fR\-importcertコマンドを参照してください。 +CAからの証明書応答をインポートするには、キーストアか、\fBcacerts\fRキーストア・ファイル内に1つ以上の信頼できる証明書がある必要があります。コマンドの\fB\-importcert\fRを参照してください。 .sp .RS 4 .ie n \{\ @@ -1004,9 +1013,9 @@ 証明書応答が単一の証明書の場合は、発行CA(署名した)の証明書が必要です。その証明書が自己署名でない場合は、その署名者の証明書が必要であり、このようにして自己署名ルート証明書が必要になります。 .RE .PP -\fIcacerts\fRキーストア・ファイルは、いくつかのVeriSignルートCA証明書を含んだ状態で出荷されているので、VeriSignの証明書を、信頼できる証明書としてキーストア内にインポートする必要がない場合があります。ただし、他のCAに対して署名付き証明書をリクエストしていて、このCAの公開鍵を認証する証明書が、\fIcacerts\fRにまだ追加されていない場合は、該当するCAからの証明書を、「信頼できる証明書」としてインポートする必要があります。 +\fBcacerts\fRキーストア・ファイルは、いくつかのVeriSignルートCA証明書を含んだ状態で出荷されているので、VeriSignの証明書を、信頼できる証明書としてキーストア内にインポートする必要がない場合があります。ただし、他のCAに対して署名付き証明書をリクエストしていて、このCAの公開鍵を認証する証明書が、\fBcacerts\fRにまだ追加されていない場合は、該当するCAからの証明書を、「信頼できる証明書」としてインポートする必要があります。 .PP -通常、CAからの証明書は、自己署名証明書、または他のCAによって署名された証明書です(後者の場合は、該当する他のCAの公開鍵を認証する証明書が必要)。ABC, Inc\&.,がCAで、ABCから自己署名証明書であるA\fIBCCA\&.cer\fRという名前のファイルを取得したとします(この証明書はCAの公開鍵を認証します)。信頼できる証明書として証明書をインポートするときは、証明書が有効であることを確認する必要があります。まず、\fIkeytool \-printcert\fRコマンドまたは\fI\-noprompt\fRオプションなしの\fIkeytool \-importcert\fRコマンドでそれを表示し、表示された証明書のフィンガープリントが期待されるものと一致するかどうかを確認します。証明書を送信した人物に連絡し、この人物が提示した(または安全な公開鍵のリポジトリによって提示される)フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中で他の何者か(攻撃者など)による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。 +通常、CAからの証明書は、自己署名証明書、または他のCAによって署名された証明書です(後者の場合は、該当する他のCAの公開鍵を認証する証明書が必要)。ABC, Inc\&.,がCAで、ABCから自己署名証明書であるA\fBBCCA\&.cer\fRという名前のファイルを取得したとします(この証明書はCAの公開鍵を認証します)。信頼できる証明書として証明書をインポートするときは、証明書が有効であることを確認する必要があります。まず、\fBkeytool \-printcert\fRコマンドまたは\fB\-noprompt\fRオプションなしの\fBkeytool \-importcert\fRコマンドでそれを表示し、表示された証明書のフィンガープリントが期待されるものと一致するかどうかを確認します。証明書を送信した人物に連絡し、この人物が提示した(またはセキュアな公開鍵のリポジトリによって提示される)フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中で他の何者か(攻撃者など)による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。 .PP 証明書が有効であると信頼する場合は、次のコマンドでキーストアに追加できます。 .sp @@ -1014,16 +1023,17 @@ .RS 4 .\} .nf -keytool \-importcert \-alias abc \-file ABCCA\&.cer +\fBkeytool \-importcert \-alias abc \-file ABCCA\&.cer\fR + .fi .if n \{\ .RE .\} .PP -ABCCA\&.cerファイルのデータを含む信頼できる証明書のエントリがキーストア内に作成され、該当するエントリに\fIabc\fRという別名が割り当てられます。 +ABCCA\&.cerファイルのデータを含む信頼できる証明書のエントリがキーストア内に作成され、該当するエントリに\fBabc\fRという別名が割り当てられます。 .SS "CAからの証明書応答のインポート" .PP -証明書署名リクエストの提出先のCAの公開鍵を認証する証明書をインポートした後は(または同種の証明書がすでにcacertsファイル内に存在している場合は)、証明応答をインポートし、自己署名証明書を証明書チェーンで置き換えることができます。このチェーンは、CAの応答がチェーンの場合に、リクエストに対するレスポンスとしてCAから送り返された証明書チェーンです。また、CAの応答が単一の証明書の場合は、この証明応答と、インポート先のキーストア内または\fIcacerts\fRキーストアファイル内にすでに存在する信頼できる証明書とを使用して構築した証明書チェーンです。 +証明書署名リクエストの提出先のCAの公開鍵を認証する証明書をインポートした後は(または同種の証明書がすでにcacertsファイル内に存在している場合は)、証明応答をインポートし、自己署名証明書を証明書チェーンで置き換えることができます。このチェーンは、CAの応答がチェーンの場合に、リクエストに対するレスポンスとしてCAから送り返された証明書チェーンです。また、CAの応答が単一の証明書の場合は、この証明応答と、インポート先のキーストア内または\fBcacerts\fRキーストアファイル内にすでに存在する信頼できる証明書とを使用して構築した証明書チェーンです。 .PP たとえば、証明書署名リクエストをVeriSignに送信する場合、送り返された証明書の名前がVSMarkJ\&.cerだとすると、次のようにして応答をインポートできます。 .sp @@ -1031,31 +1041,33 @@ .RS 4 .\} .nf -keytool \-importcert \-trustcacerts \-file VSMarkJ\&.cer +\fBkeytool \-importcert \-trustcacerts \-file VSMarkJ\&.cer\fR + .fi .if n \{\ .RE .\} .SS "公開鍵を認証する証明書のエクスポート" .PP -\fIjarsigner\fRコマンドを使用してJava Archive (JAR)ファイルに署名する場合、このファイルを使用するクライアントは署名を認証する必要があります。クライアントが署名を認証する方法の1つに、まず自分の公開鍵の証明書を信頼できるエントリとしてクライアントのキーストアにインポートする方法があります。 +\fBjarsigner\fRコマンドを使用してJava Archive (JAR)ファイルに署名する場合、このファイルを使用するクライアントは署名を認証する必要があります。クライアントが署名を認証する方法の1つに、まず自分の公開鍵の証明書を信頼できるエントリとしてクライアントのキーストアにインポートする方法があります。 .PP -そのためには、証明書をエクスポートして、クライアントに提供します。例として、次のコマンドを使用して、MJ\&.cerという名前のファイルに証明書をコピーできます。このコマンドでは、エントリに別名\fImykey\fRがあると仮定しています。 +そのためには、証明書をエクスポートして、クライアントに提供します。例として、次のコマンドを使用して、MJ\&.cerという名前のファイルに証明書をコピーできます。このコマンドでは、エントリに別名\fBmykey\fRがあると仮定しています。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-exportcert \-alias mykey \-file MJ\&.cer +\fBkeytool \-exportcert \-alias mykey \-file MJ\&.cer\fR + .fi .if n \{\ .RE .\} .PP -証明書と署名付きJARファイルを入手したクライアントは、\fIjarsigner\fRコマンドを使用して署名を認証できます。 +証明書と署名付きJARファイルを入手したクライアントは、\fBjarsigner\fRコマンドを使用して署名を認証できます。 .SS "キーストアのインポート" .PP -コマンド\fIimportkeystore\fRを使用すれば、あるキーストアの全体を別のキーストア内にインポートできます。これは、鍵や証明書といったソースキーストア内のすべてのエントリが、単一のコマンドを使用してターゲットキーストア内にインポートされることを意味します。このコマンドを使用すれば、異なるタイプのキーストア内に含まれるエントリをインポートすることができます。インポート時には、ターゲット・キーストア内の新しいエントリはすべて、元と同じ別名および(秘密鍵や秘密鍵の場合は)保護用パスワードを持ちます。ソースキーストア内の非公開/秘密鍵をリカバリできない場合、\fIkeytool\fRコマンドはユーザーにパスワードの入力を求めます。このコマンドは、別名の重複を検出すると、ユーザーに新しい別名の入力を求めます。ユーザーは、新しい別名を指定することも、単純に既存の別名の上書きを\fIkeytool\fRコマンドに許可することもできます。 +コマンド\fBimportkeystore\fRを使用すれば、あるキーストアの全体を別のキーストア内にインポートできます。これは、鍵や証明書といったソースキーストア内のすべてのエントリが、単一のコマンドを使用してターゲットキーストア内にインポートされることを意味します。このコマンドを使用すれば、異なるタイプのキーストア内に含まれるエントリをインポートすることができます。インポート時には、ターゲット・キーストア内の新しいエントリはすべて、元と同じ別名および(秘密鍵や秘密鍵の場合は)保護用パスワードを持ちます。ソースキーストア内の非公開/秘密鍵をリカバリできない場合、\fBkeytool\fRコマンドはユーザーにパスワードの入力を求めます。このコマンドは、別名の重複を検出すると、ユーザーに新しい別名の入力を求めます。ユーザーは、新しい別名を指定することも、単純に既存の別名の上書きを\fBkeytool\fRコマンドに許可することもできます。 .PP たとえば、通常のJKSタイプのキーストアkey\&.jks内のエントリをPKCS#11タイプのハードウェア・ベースのキーストア内にインポートするには、次のコマンドを使用します。 .sp @@ -1063,59 +1075,62 @@ .RS 4 .\} .nf -keytool \-importkeystore - \-srckeystore key\&.jks \-destkeystore NONE - \-srcstoretype JKS \-deststoretype PKCS11 - \-srcstorepass <src keystore password> - \-deststorepass <destination keystore pwd> +\fBkeytool \-importkeystore\fR +\fB \-srckeystore key\&.jks \-destkeystore NONE\fR +\fB \-srcstoretype JKS \-deststoretype PKCS11\fR +\fB \-srcstorepass <src keystore password>\fR +\fB \-deststorepass <destination keystore pwd>\fR + .fi .if n \{\ .RE .\} .PP -また、\fIimportkeystore\fRコマンドを使用すれば、あるソース・キーストア内の単一のエントリをターゲット・キーストアにインポートすることもできます。この場合は、前例のオプションに加えて、インポートする別名を指定する必要があります。\fI\-srcalias\fRオプションを指定する場合には、ターゲット別名もコマンドラインから指定できるほか、秘密/秘密鍵の保護用パスワードやターゲット保護用パスワードも指定できます。その方法を示すコマンドを次に示します。 +また、\fBimportkeystore\fRコマンドを使用すれば、あるソース・キーストア内の単一のエントリをターゲット・キーストアにインポートすることもできます。この場合は、前例のオプションに加えて、インポートする別名を指定する必要があります。\fB\-srcalias\fRオプションを指定する場合には、ターゲット別名もコマンド行から指定できるほか、秘密/秘密鍵の保護用パスワードやターゲット保護用パスワードも指定できます。その方法を示すコマンドを次に示します。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-importkeystore - \-srckeystore key\&.jks \-destkeystore NONE - \-srcstoretype JKS \-deststoretype PKCS11 - \-srcstorepass <src keystore password> - \-deststorepass <destination keystore pwd> - \-srcalias myprivatekey \-destalias myoldprivatekey - \-srckeypass <source entry password> - \-destkeypass <destination entry password> - \-noprompt +\fBkeytool \-importkeystore\fR +\fB \-srckeystore key\&.jks \-destkeystore NONE\fR +\fB \-srcstoretype JKS \-deststoretype PKCS11\fR +\fB \-srcstorepass <src keystore password>\fR +\fB \-deststorepass <destination keystore pwd>\fR +\fB \-srcalias myprivatekey \-destalias myoldprivatekey\fR +\fB \-srckeypass <source entry password>\fR +\fB \-destkeypass <destination entry password>\fR +\fB \-noprompt\fR + .fi .if n \{\ .RE .\} .SS "SSLサーバーの証明書の生成" .PP -次に、3つのエンティティ、つまりルートCA(\fIroot\fR)、中間CA(\fIca\fR)およびSSLサーバー(\fIserver\fR)用の鍵ペアと証明書を生成する\fIkeytool\fRコマンドを示します。すべての証明書を同じキーストアに格納するようにしてください。これらの例では、RSAが推奨される鍵のアルゴリズムです。 +次に、3つのエンティティ、つまりルートCA(\fBroot\fR)、中間CA(\fBca\fR)およびSSLサーバー(\fBserver\fR)用の鍵ペアと証明書を生成する\fBkeytool\fRコマンドを示します。すべての証明書を同じキーストアに格納するようにしてください。これらの例では、RSAが推奨される鍵のアルゴリズムです。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-genkeypair \-keystore root\&.jks \-alias root \-ext bc:c -keytool \-genkeypair \-keystore ca\&.jks \-alias ca \-ext bc:c -keytool \-genkeypair \-keystore server\&.jks \-alias server - -keytool \-keystore root\&.jks \-alias root \-exportcert \-rfc > root\&.pem +\fBkeytool \-genkeypair \-keystore root\&.jks \-alias root \-ext bc:c\fR +\fBkeytool \-genkeypair \-keystore ca\&.jks \-alias ca \-ext bc:c\fR +\fBkeytool \-genkeypair \-keystore server\&.jks \-alias server\fR +\fB \fR +\fBkeytool \-keystore root\&.jks \-alias root \-exportcert \-rfc > root\&.pem\fR +\fB \fR +\fBkeytool \-storepass <storepass> \-keystore ca\&.jks \-certreq \-alias ca |\fR +\fB keytool \-storepass <storepass> \-keystore root\&.jks\fR +\fB \-gencert \-alias root \-ext BC=0 \-rfc > ca\&.pem\fR +\fBkeytool \-keystore ca\&.jks \-importcert \-alias ca \-file ca\&.pem\fR +\fB \fR +\fBkeytool \-storepass <storepass> \-keystore server\&.jks \-certreq \-alias server |\fR +\fB keytool \-storepass <storepass> \-keystore ca\&.jks \-gencert \-alias ca\fR +\fB \-ext ku:c=dig,kE \-rfc > server\&.pem\fR +\fBcat root\&.pem ca\&.pem server\&.pem |\fR +\fB keytool \-keystore server\&.jks \-importcert \-alias server\fR -keytool \-storepass <storepass> \-keystore ca\&.jks \-certreq \-alias ca | - keytool \-storepass <storepass> \-keystore root\&.jks - \-gencert \-alias root \-ext BC=0 \-rfc > ca\&.pem -keytool \-keystore ca\&.jks \-importcert \-alias ca \-file ca\&.pem - -keytool \-storepass <storepass> \-keystore server\&.jks \-certreq \-alias server | - keytool \-storepass <storepass> \-keystore ca\&.jks \-gencert \-alias ca - \-ext ku:c=dig,kE \-rfc > server\&.pem -cat root\&.pem ca\&.pem server\&.pem | - keytool \-keystore server\&.jks \-importcert \-alias server .fi .if n \{\ .RE @@ -1129,10 +1144,10 @@ .PP キーストアのエントリ .RS 4 -キーストアには異なるタイプのエントリを含めることができます。\fIkeytool\fRコマンドで最も適用範囲の広いエントリ・タイプは、次の2つです。 +キーストアには異なるタイプのエントリを含めることができます。\fBkeytool\fRコマンドで最も適用範囲の広いエントリ・タイプは、次の2つです。 .sp \fB鍵のエントリ\fR -\- 各エントリは、非常に重要な暗号化の鍵の情報を保持します。この情報は、許可していないアクセスを防ぐために、保護された形で格納されます。一般に、この種のエントリとして格納される鍵は、秘密鍵か、対応する公開鍵の証明書チェーンを伴う秘密鍵です。証明書チェーンを参照してください。\fIkeytool\fRコマンドがこの両方のタイプのエントリを処理できるのに対し、\fIjarsigner\fRツールは後者のタイプのエントリ、つまり秘密鍵とそれに関連付けられた証明書チェーンのみを処理します。 +\- 各エントリは、非常に重要な暗号化の鍵の情報を保持します。この情報は、許可していないアクセスを防ぐために、保護された形で格納されます。一般に、この種のエントリとして格納される鍵は、秘密鍵か、対応する公開鍵の証明書チェーンを伴う秘密鍵です。証明書チェーンを参照してください。\fBkeytool\fRコマンドがこの両方のタイプのエントリを処理できるのに対し、\fBjarsigner\fRツールは後者のタイプのエントリ、つまり秘密鍵とそれに関連付けられた証明書チェーンのみを処理します。 .sp \fB信頼できる証明書のエントリ\fR: 各エントリは、第三者からの公開鍵証明書を1つ含んでいます。このエントリは、信頼できる証明書と呼ばれます。それは、証明書内の公開鍵が、証明書のSubject(所有者)によって特定されるアイデンティティに由来するものであることを、キーストアの所有者が信頼するからです。証明書の発行者は、証明書に署名を付けることによって、その内容を保証します。 .RE @@ -1141,81 +1156,86 @@ .RS 4 キーストアのすべてのエントリ(鍵および信頼できる証明書エントリ)は、一意の別名を介してアクセスされます。 .sp -別名を指定するのは、\fI\-genseckey\fRコマンドを使用して秘密鍵を生成したり、\fI\-genkeypair\fRコマンドを使用して鍵ペア(公開鍵と秘密鍵)を生成したり、\fI\-importcert\fRコマンドを使用して証明書または証明書チェーンを信頼できる証明書のリストに追加するなど、特定のエンティティをキーストアに追加する場合です。これ以後、\fIkeytool\fRコマンドでエンティティを参照する場合は、このときに指定した別名を使用する必要があります。 +別名を指定するのは、\fB\-genseckey\fRコマンドを使用して秘密鍵を生成したり、\fB\-genkeypair\fRコマンドを使用して鍵ペア(公開鍵と秘密鍵)を生成したり、\fB\-importcert\fRコマンドを使用して証明書または証明書チェーンを信頼できる証明書のリストに追加するなど、特定のエンティティをキーストアに追加する場合です。これ以後、\fBkeytool\fRコマンドでエンティティを参照する場合は、このときに指定した別名を使用する必要があります。 .sp -たとえば、\fIduke\fRという別名を使用して新しい公開鍵と秘密鍵のペアを生成し、公開鍵を自己署名証明書でラップするとします。この場合は、次のコマンドを実行します。証明書チェーンを参照してください。 +たとえば、\fBduke\fRという別名を使用して新しい公開鍵と秘密鍵のペアを生成し、公開鍵を自己署名証明書でラップするとします。この場合は、次のコマンドを実行します。証明書チェーンを参照してください。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-genkeypair \-alias duke \-keypass dukekeypasswd +\fBkeytool \-genkeypair \-alias duke \-keypass dukekeypasswd\fR + .fi .if n \{\ .RE .\} -この例では、初期パスワードとして\fIdukekeypasswd\fRを指定しています。以後、別名\fIduke\fRに関連付けられた秘密鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。Dukeの秘密鍵のパスワードをあとから変更するには、次のコマンドを実行します。 +この例では、初期パスワードとして\fBdukekeypasswd\fRを指定しています。以後、別名\fBduke\fRに関連付けられた秘密鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。Dukeの秘密鍵のパスワードをあとから変更するには、次のコマンドを実行します。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-keypasswd \-alias duke \-keypass dukekeypasswd \-new newpass +\fBkeytool \-keypasswd \-alias duke \-keypass dukekeypasswd \-new newpass\fR + .fi .if n \{\ .RE .\} -パスワードが、\fIdukekeypasswd\fRから\fInewpass\fRに変更されます。テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンドラインで指定しなかった場合は、パスワードの入力を求められます。 +パスワードが、\fBdukekeypasswd\fRから\fBnewpass\fRに変更されます。テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。 .RE .PP キーストアの実装 .RS 4 -\fIjava\&.security\fRパッケージで提供されている\fIKeyStore\fRクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定のタイプのキーストアを対象とする複数の異なる実装が存在可能です。 +\fBjava\&.security\fRパッケージで提供されている\fBKeyStore\fRクラスは、キーストア内の情報へのアクセスおよび情報の変更を行うための、明確に定義されたインタフェースを提供します。キーストアの固定実装としては、それぞれが特定のタイプのキーストアを対象とする複数の異なる実装が存在可能です。 .sp -現在、\fIkeytool\fRと\fIjarsigner\fRの2つのコマンドライン・ツールと、Policy Toolという名前のGUIベースのツールが、キーストアの実装を使用しています。\fIKeyStore\fRクラスは\fIpublic\fRであるため、ユーザーはKeyStoreを使用した他のセキュリティ・アプリケーションも作成できます。 +現在、\fBkeytool\fRと\fBjarsigner\fRの2つのコマンド行ツールと、Policy Toolという名前のGUIベースのツールが、キーストアの実装を使用しています。\fBKeyStore\fRクラスは\fBpublic\fRであるため、ユーザーはKeyStoreを使用した他のセキュリティ・アプリケーションも作成できます。 .sp キーストアには、Oracleが提供する組込みのデフォルトの実装があります。これは、JKSという名前の独自のキーストア・タイプ(形式)を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の秘密鍵は個別のパスワードによって保護され、キーストア全体の整合性も(秘密鍵とは別の)パスワードによって保護されます。 .sp -キーストアの実装は、プロバイダベースです。具体的には、\fIKeyStore\fRによって提供されるアプリケーション・インタフェースがサービス・プロバイダ・インタフェース(SPI)に基づいて実装されます。つまり、対応する\fIKeystoreSpi\fR抽象クラス(これも\fIjava\&.security\fRパッケージに含まれています)があり、このクラスが、プロバイダが実装する必要のあるService Provider Interfaceのメソッドを定義しています。ここで、\fIプロバイダ\fRとは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。キーストアの実装を提供するには、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/HowToImplAProvider\&.htmlにある -Java暗号化アーキテクチャのプロバイダの実装方法で説明しているように、クライアントはプロバイダを実装し、\fIKeystoreSpi\fRサブクラスの実装を提供する必要があります。 +キーストアの実装は、プロバイダベースです。具体的には、\fBKeyStore\fRによって提供されるアプリケーション・インタフェースがサービス・プロバイダ・インタフェース(SPI)に基づいて実装されます。つまり、対応する\fBKeystoreSpi\fR抽象クラス(これも\fBjava\&.security\fRパッケージに含まれています)があり、このクラスが、プロバイダが実装する必要のあるService Provider Interfaceのメソッドを定義しています。ここで、\fIプロバイダ\fRとは、Java Security APIによってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。キーストアの実装を提供するには、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/HowToImplAProvider\&.htmlにある +Java暗号化アーキテクチャのプロバイダの実装方法で説明しているように、クライアントはプロバイダを実装し、\fBKeystoreSpi\fRサブクラスの実装を提供する必要があります。 .sp -アプリケーションでは、\fIKeyStore\fRクラスが提供する\fIgetInstance\fRファクトリ・メソッドを使用することで、様々なプロバイダから異なるタイプのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストアの整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 +アプリケーションでは、\fBKeyStore\fRクラスが提供する\fBgetInstance\fRファクトリ・メソッドを使用することで、様々なプロバイダから異なるタイプのキーストアの実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストアの整合性を保護するために使用されるアルゴリズムを定義します。異なるタイプのキーストアの実装には、互換性はありません。 .sp -\fIkeytool\fRコマンドは、任意のファイルベースのキーストア実装で動作します。コマンド・ラインで渡されたキーストアの場所をファイル名として扱って、\fIFileInputStream\fRに変換し、ここからキーストア情報をロードします。\fIjarsigner\fRおよび\fIpolicytool\fRコマンドは、URLで指定できる任意の場所からキーストアを読み取ることができます。 +\fBkeytool\fRコマンドは、任意のファイルベースのキーストア実装で動作します。コマンド行で渡されたキーストアの場所をファイル名として扱って、\fBFileInputStream\fRに変換し、ここからキーストア情報をロードします。\fBjarsigner\fRおよび\fBpolicytool\fRコマンドは、URLで指定できる任意の場所からキーストアを読み取ることができます。 .sp -\fIkeytool\fRと\fIjarsigner\fRの場合、\fI\-storetype\fRオプションを使用してコマンドラインでキーストアのタイプを指定できます。Policy Toolの場合は、「キーストア」メニューによってキーストアのタイプを指定できます。 +\fBkeytool\fRと\fBjarsigner\fRの場合、\fB\-storetype\fRオプションを使用してコマンド行でキーストアのタイプを指定できます。Policy Toolの場合は、「キーストア」メニューによってキーストアのタイプを指定できます。 .sp -ユーザーがキーストアのタイプを明示的に指定しなかった場合、セキュリティ・プロパティ・ファイルで指定された\fIkeystore\&.type\fRプロパティの値に基づいて、ツールによってキーストアの実装が選択されます。このセキュリティ・プロパティ・ファイルは\fIjava\&.security\fRと呼ばれ、Windowsではセキュリティ・プロパティ・ディレクトリ\fIjava\&.home\elib\esecurity\fR、Oracle Solarisでは\fIjava\&.home/lib/security\fRにあります。\fIjava\&.home\fRは、実行時環境のディレクトリです。\fIjre\fRディレクトリは、SDKまたはJava Runtime Environment (JRE)の最上位のディレクトリにあります。 +ユーザーがキーストアのタイプを明示的に指定しなかった場合、セキュリティ・プロパティ・ファイルで指定された\fBkeystore\&.type\fRプロパティの値に基づいて、ツールによってキーストアの実装が選択されます。このセキュリティ・プロパティ・ファイルは\fBjava\&.security\fRと呼ばれ、Windowsではセキュリティ・プロパティ・ディレクトリ\fBjava\&.home\elib\esecurity\fR、Oracle Solarisでは\fBjava\&.home/lib/security\fRにあります。\fBjava\&.home\fRは、実行時環境のディレクトリです。\fBjre\fRディレクトリは、SDKまたはJava Runtime Environment (JRE)の最上位のディレクトリにあります。 .sp -各ツールは、\fIkeystore\&.type\fRの値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。そのプロバイダからのキーストアの実装を使用します。\fIKeyStore\fRクラスに定義されているstaticメソッド\fIgetDefaultType\fRを使用すると、アプリケーションやアプレットから\fIkeystore\&.type\fRプロパティの値を取得できます。次のコードは、デフォルトのキーストア・タイプ(\fIkeystore\&.type\fRプロパティで指定されたタイプ)のインスタンスを生成します。 +各ツールは、\fBkeystore\&.type\fRの値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。そのプロバイダからのキーストアの実装を使用します。\fBKeyStore\fRクラスに定義されているstaticメソッド\fBgetDefaultType\fRを使用すると、アプリケーションやアプレットから\fBkeystore\&.type\fRプロパティの値を取得できます。次のコードは、デフォルトのキーストア・タイプ(\fBkeystore\&.type\fRプロパティで指定されたタイプ)のインスタンスを生成します。 .sp .if n \{\ .RS 4 .\} .nf -KeyStore keyStore = KeyStore\&.getInstance(KeyStore\&.getDefaultType()); +\fBKeyStore keyStore = KeyStore\&.getInstance(KeyStore\&.getDefaultType());\fR + .fi .if n \{\ .RE .\} -デフォルトのキーストア・タイプは\fIjks\fRで、これはOracleが提供する独自のタイプのキーストアの実装です。これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。 +デフォルトのキーストア・タイプは\fBjks\fRで、これはOracleが提供する独自のタイプのキーストアの実装です。これは、セキュリティ・プロパティ・ファイル内の次の行によって指定されています。 .sp .if n \{\ .RS 4 .\} .nf -keystore\&.type=jks +\fBkeystore\&.type=jks\fR + .fi .if n \{\ .RE .\} -各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。たとえば、\fIpkcs12\fRと呼ばれるキーストアのタイプのキーストアの実装を提供するプロバイダ・パッケージがある場合、行を次のように変更します。 +各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。たとえば、\fBpkcs12\fRと呼ばれるキーストアのタイプのキーストアの実装を提供するプロバイダ・パッケージがある場合、行を次のように変更します。 .sp .if n \{\ .RS 4 .\} .nf -keystore\&.type=pkcs12 +\fBkeystore\&.type=pkcs12\fR + .fi .if n \{\ .RE @@ -1242,9 +1262,9 @@ .sp 公開鍵暗号化では、ユーザーの公開鍵にアクセスする必要があります。大規模なネットワーク環境では、互いに通信しているエンティティ間で以前の関係が引続き確立されていると仮定したり、使用されているすべての公開鍵を収めた信頼できるリポジトリが存在すると仮定したりすることは不可能です。このような公開鍵の配布に関する問題を解決するために証明書が考案されました。現在では、証明書発行局(CA)が信頼できる第三者として機能します。CAは、他のエンティティの証明書に署名する(発行する)行為を、信頼して任されているエンティティ(企業など)です。CAは法律上の契約に拘束されるので、有効かつ信頼できる証明書のみを作成するものとして扱われます。VeriSign、Thawte、Entrustをはじめ、多くの公的な証明書発行局が存在します。 .sp -Microsoftの認証サーバー、EntrustのCA製品などを所属組織内で利用すれば、独自の証明書発行局を運営することも可能です。\fIkeytool\fRコマンドを使用すると、証明書の表示、インポートおよびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。 +Microsoftの認証サーバー、EntrustのCA製品などを所属組織内で利用すれば、独自の証明書発行局を運営することも可能です。\fBkeytool\fRコマンドを使用すると、証明書の表示、インポートおよびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。 .sp -現在、\fIkeytool\fRコマンドはX\&.509証明書を対象にしています。 +現在、\fBkeytool\fRコマンドはX\&.509証明書を対象にしています。 .RE .PP X\&.509証明書 @@ -1253,13 +1273,13 @@ .sp すべてのX\&.509証明書は、署名の他に次のデータを含んでいます。 .sp -\fBバージョン\fR: 証明書に適用されるX\&.509規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。今のところ、3つのバージョンが定義されています。\fIkeytool\fRコマンドでは、v1、v2、v3の証明書をインポートおよびエクスポートできます。v3の証明書を生成します。 +\fBバージョン\fR: 証明書に適用されるX\&.509規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。今のところ、3つのバージョンが定義されています。\fBkeytool\fRコマンドでは、v1、v2、v3の証明書をインポートおよびエクスポートできます。v3の証明書を生成します。 .sp X\&.509 Version 1は、1988年から利用されて広く普及しており、最も一般的です。 .sp X\&.509 Version 2では、Subjectや発行者の名前をあとで再利用できるようにするために、Subjectと発行者の一意識別子の概念が導入されました。ほとんどの証明書プロファイル文書では、名前を再使用しないことと、証明書で一意の識別子を使用しないことが、強く推奨されています。Version 2の証明書は、広くは使用されていません。 .sp -X\&.509 Version 3は最も新しい(1996年)規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。一般的なエクステンションとしては、KeyUsage(\fI署名専用\fRなど、鍵の使用を特定の目的に制限する)、AlternativeNames(DNS名、電子メール・アドレス、IPアドレスなど、他のアイデンティティを公開鍵に関連付けることができる)などがあります。エクステンションには、criticalというマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、criticalとマークされ、\fIkeyCertSign\fRが設定されたKeyUsageエクステンションが証明書に含まれている場合、この証明書をSSL通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する秘密鍵が証明書の署名専用として指定されており、SSLでは使用できないためです。 +X\&.509 Version 3は最も新しい(1996年)規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。一般的なエクステンションとしては、KeyUsage(\fB署名専用\fRなど、鍵の使用を特定の目的に制限する)、AlternativeNames(DNS名、電子メール・アドレス、IPアドレスなど、他のアイデンティティを公開鍵に関連付けることができる)などがあります。エクステンションには、criticalというマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、criticalとマークされ、\fBkeyCertSign\fRが設定されたKeyUsageエクステンションが証明書に含まれている場合、この証明書をSSL通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する秘密鍵が証明書の署名専用として指定されており、SSLでは使用できないためです。 .sp \fBシリアル番号\fR: 証明書を作成したエンティティは、そのエンティティが発行する他の証明書と区別するために、証明書にシリアル番号を割り当てます。この情報は、様々な方法で使用されます。たとえば、証明書が取り消されると、シリアル番号が証明書失効リスト(CRL)に格納されます。 .sp @@ -1275,7 +1295,8 @@ .RS 4 .\} .nf -CN=Java Duke, OU=Java Software Division, O=Oracle Corporation, C=US +\fBCN=Java Duke, OU=Java Software Division, O=Oracle Corporation, C=US\fR + .fi .if n \{\ .RE @@ -1287,51 +1308,52 @@ .PP 証明書チェーン .RS 4 -\fIkeytool\fRコマンドでは、秘密鍵および関連する証明書チェーンを含むキーストアの鍵エントリを作成し、管理することができます。このようなエントリでは、秘密鍵に対応する公開鍵は、チェーンの最初の証明書に含まれています。 +\fBkeytool\fRコマンドでは、秘密鍵および関連する証明書チェーンを含むキーストアの鍵エントリを作成し、管理することができます。このようなエントリでは、秘密鍵に対応する公開鍵は、チェーンの最初の証明書に含まれています。 .sp -鍵を初めて作成すると、自己署名証明書という1つの要素のみを含むチェーンが開始されます。\fIの\fR\-genkeypairコマンドを参照してください。自己署名証明書は発行者(署名者)が主体と同じです。主体は、その公開鍵が証明書によって認証されるエンティティです。\fI\-genkeypair\fRコマンドを呼び出して新しい公開鍵と秘密鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。 +鍵を初めて作成すると、自己署名証明書という1つの要素のみを含むチェーンが開始されます。コマンドの\fB\-genkeypair\fRを参照してください。自己署名証明書は発行者(署名者)が主体と同じです。主体は、その公開鍵が証明書によって認証されるエンティティです。\fB\-genkeypair\fRコマンドを呼び出して新しい公開鍵と秘密鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。 .sp -この後、証明書署名リクエスト(CSR)が\fI\-certreq\fRコマンドで生成されて、CSRが証明書発行局(CA)に送信されると、CAからのレスポンスが\fI\-importcert\fRでインポートされ、元の自己署名証明書は証明書チェーンによって置き換えられます。コマンドの\fI\-certreq\fRおよび\fI\-importcert\fRオプションを参照してください。チェーンの最後にあるのは、Subjectの公開鍵を認証したCAが発行した証明書(応答)です。チェーン内のその前の証明書は、CAの公開鍵を認証する証明書です。 +この後、証明書署名リクエスト(CSR)が\fB\-certreq\fRコマンドで生成されて、CSRが証明書発行局(CA)に送信されると、CAからのレスポンスが\fB\-importcert\fRでインポートされ、元の自己署名証明書は証明書チェーンによって置き換えられます。\fBの\fR\-certreq\fBおよび\fR\-importcertコマンドオプションを参照してください。チェーンの最後にあるのは、Subjectの公開鍵を認証したCAが発行した証明書(応答)です。チェーン内のその前の証明書は、CAの公開鍵を認証する証明書です。 .sp CAの公開鍵を認証する証明書は、多くの場合、自己署名証明書(つまりCAが自身の公開鍵を認証した証明書)であり、これはチェーンの最初の証明書になります。場合によっては、CAが証明書のチェーンを返すこともあります。この場合、チェーン内の最後の証明書(CAによって署名され、鍵エントリの公開鍵を認証する証明書)に変わりはありませんが、チェーン内のその前の証明書は、CSRの送信先のCAとは別のCAによって署名され、CSRの送信先のCAの公開鍵を認証する証明書になります。チェーン内のその前の証明書は、次のCAの鍵を認証する証明書になります。以下同様に、自己署名された「ルート」証明書に達するまでチェーンが続きます。したがって、チェーン内の(最初の証明書以後の)各証明書では、チェーン内の次の証明書の署名者の公開鍵が認証されていることになります。 .sp 多くのCAは、チェーンをサポートせずに発行済の証明書のみを返します。特に、中間のCAが存在しないフラットな階層構造の場合は、その傾向が顕著です。このような場合は、キーストアにすでに格納されている信頼できる証明書情報から、証明書チェーンを確立する必要があります。 .sp -別の応答形式(PKCS#7で定義されている形式)では、発行済証明書に加え、証明書チェーンのサポートが含まれています。\fIkeytool\fRコマンドでは、どちらの応答形式も扱うことができます。 +別の応答形式(PKCS#7で定義されている形式)では、発行済証明書に加え、証明書チェーンのサポートが含まれています。\fBkeytool\fRコマンドでは、どちらの応答形式も扱うことができます。 .sp -トップレベル(ルート)CAの証明書は、自己署名証明書です。ただし、ルートの公開鍵への信頼は、ルート証明書自体からではなく、新聞など他のソースから取得されます。これは、VeriSignルートCAなどの識別名を使用して、誰でも自己署名型証明書を生成できるためです。ルートCAの公開鍵は広く知られています。ルートCAの公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。つまり、証明書は、ルートCAの公開鍵を運ぶ「媒体」として利用されるのみです。ルートCAの証明書をキーストアに追加するときは、\fI\-printcert\fRオプションを使用して、その前に証明書の内容を表示し、表示されたフィンガープリントと、新聞やルートCAのWebページなどから入手した既知のフィンガープリントとを比較する必要があります。 +トップレベル(ルート)CAの証明書は、自己署名証明書です。ただし、ルートの公開鍵への信頼は、ルート証明書自体からではなく、新聞など他のソースから取得されます。これは、VeriSignルートCAなどの識別名を使用して、誰でも自己署名型証明書を生成できるためです。ルートCAの公開鍵は広く知られています。ルートCAの公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。つまり、証明書は、ルートCAの公開鍵を運ぶ「媒体」として利用されるのみです。ルートCAの証明書をキーストアに追加するときは、\fB\-printcert\fRオプションを使用して、その前に証明書の内容を表示し、表示されたフィンガープリントと、新聞やルートCAのWebページなどから入手した既知のフィンガープリントとを比較する必要があります。 .RE .PP cacerts証明書ファイル .RS 4 -\fIcacerts\fRという名前の証明書ファイルは、Windowsではセキュリティ・プロパティ・ディレクトリ\fIjava\&.home\elib\esecurity\fR、Oracle Solarisでは\fIjava\&.home/lib/security\fRに置かれています。\fIjava\&.home\fRは、実行環境のディレクトリ(SDKの\fIjre\fRディレクトリまたはJREの最上位ディレクトリ)です。 +\fBcacerts\fRという名前の証明書ファイルは、Windowsではセキュリティ・プロパティ・ディレクトリ\fBjava\&.home\elib\esecurity\fR、Oracle Solarisでは\fBjava\&.home/lib/security\fRに置かれています。\fBjava\&.home\fRは、実行環境のディレクトリ(SDKの\fBjre\fRディレクトリまたはJREの最上位ディレクトリ)です。 .sp -\fIcacerts\fRファイルは、CAの証明書を含む、システム全体のキーストアです。システム管理者は、キーストア・タイプに\fIjks\fRを指定することで、\fIkeytool\fRコマンドを使用してこのファイルの構成と管理を行うことができます。\fIcacerts\fRキーストア・ファイルは、ルートCA証明書のデフォルト・セットを含んだ状態で出荷されています。デフォルトの証明書を一覧表示するには、次のコマンドを使用します。 +\fBcacerts\fRファイルは、CAの証明書を含む、システム全体のキーストアです。システム管理者は、キーストア・タイプに\fBjks\fRを指定することで、\fBkeytool\fRコマンドを使用してこのファイルの構成と管理を行うことができます。\fBcacerts\fRキーストア・ファイルは、ルートCA証明書のデフォルト・セットを含んだ状態で出荷されています。デフォルトの証明書を一覧表示するには、次のコマンドを使用します。 .sp .if n \{\ .RS 4 .\} .nf -keytool \-list \-keystore java\&.home/lib/security/cacerts +\fBkeytool \-list \-keystore java\&.home/lib/security/cacerts\fR + .fi .if n \{\ .RE .\} -\fIcacerts\fRキーストア・ファイルの初期パスワードは、\fIchangeit\fRです。システム管理者は、SDKのインストール後、このファイルのパスワードとデフォルト・アクセス権を変更する必要があります。 +\fBcacerts\fRキーストア・ファイルの初期パスワードは、\fBchangeit\fRです。システム管理者は、SDKのインストール後、このファイルのパスワードとデフォルト・アクセス権を変更する必要があります。 .sp \fB注意:\fR -\fIcacerts\fRファイルを確認することが重要です。\fIcacerts\fRファイル内のCAは、署名および他のエンティティへの証明書発行のためのエンティティとして信頼されるため、\fIcacerts\fRファイルの管理は慎重に行う必要があります。\fIcacerts\fRファイルには、信頼するCAの証明書のみが含まれている必要があります。ユーザーは、自身の責任において、\fIcacerts\fRファイルにバンドルされている信頼できるルートCA証明書を検証し、信頼性に関する独自の決定を行います。 +\fBcacerts\fRファイルを確認することが重要です。\fBcacerts\fRファイル内のCAは、署名および他のエンティティへの証明書発行のためのエンティティとして信頼されるため、\fBcacerts\fRファイルの管理は慎重に行う必要があります。\fBcacerts\fRファイルには、信頼するCAの証明書のみが含まれている必要があります。ユーザーは、自身の責任において、\fBcacerts\fRファイルにバンドルされている信頼できるルートCA証明書を検証し、信頼性に関する独自の決定を行います。 .sp -信頼できないCA証明書を\fIcacerts\fRファイルから削除するには、\fIkeytool\fRコマンドの\fIdelete\fRオプションを使用します。\fIcacerts\fRファイルはJREのインストール・ディレクトリにあります。このファイルを編集するアクセス権がない場合は、システム管理者に連絡してください +信頼できないCA証明書を\fBcacerts\fRファイルから削除するには、\fBkeytool\fRコマンドの\fBdelete\fRオプションを使用します。\fBcacerts\fRファイルはJREのインストール・ディレクトリにあります。このファイルを編集するアクセス権がない場合は、システム管理者に連絡してください .RE .PP インターネットRFC 1421証明書符号化規格 .RS 4 多くの場合、証明書は、バイナリ符号化ではなく、インターネットRFC 1421規格で定義されている出力可能符号化方式を使用して格納されます。Base 64符号化とも呼ばれるこの証明書形式では、電子メールやその他の機構を通じて、他のアプリケーションに証明書を容易にエクスポートできます。 .sp -\fI\-importcert\fRと\fI\-printcert\fRコマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。\fI\-exportcert\fRコマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。ただし、\fI\-rfc\fRオプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 +\fB\-importcert\fRと\fB\-printcert\fRコマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。\fB\-exportcert\fRコマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。ただし、\fB\-rfc\fRオプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 .sp -\fI\-list\fRコマンドでは、デフォルトで証明書のSHA1フィンガープリントが出力されます。\fI\-v\fRオプションが指定されている場合、証明書は人が理解できる形式で出力されます。\fI\-rfc\fRオプションが指定されている場合、証明書は出力可能符号化方式で出力されます。 +\fB\-list\fRコマンドでは、デフォルトで証明書のSHA1フィンガープリントが出力されます。\fB\-v\fRオプションが指定されている場合、証明書は人が理解できる形式で出力されます。\fB\-rfc\fRオプションが指定されている場合、証明書は出力可能符号化方式で出力されます。 .sp 出力可能符号化方式で符号化された証明書は、次のテキストで始まり、次のテキストで終了します。 .sp @@ -1339,11 +1361,12 @@ .RS 4 .\} .nf -\-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\- - -encoded certificate goes here\&. - -\-\-\-\-\-END CERTIFICATE\-\-\-\-\- +\fB\-\-\-\-\-BEGIN CERTIFICATE\-\-\-\-\-\fR + +\fBencoded certificate goes here\&. \fR + +\fB\-\-\-\-\-END CERTIFICATE\-\-\-\-\-\fR + .fi .if n \{\ .RE @@ -1352,7 +1375,7 @@ .PP X\&.500識別名 .RS 4 -X\&.500識別名は、エンティティを特定するために使用されます。たとえば、X\&.509証明書の\fIsubject\fRフィールドと\fIissuer\fR(署名者)フィールドで指定される名前は、X\&.500識別名です。\fIkeytool\fRコマンドは、次のサブパートをサポートしています。 +X\&.500識別名は、エンティティを特定するために使用されます。たとえば、X\&.509証明書の\fBsubject\fRフィールドと\fBissuer\fR(署名者)フィールドで指定される名前は、X\&.500識別名です。\fBkeytool\fRコマンドは、次のサブパートをサポートしています。 .sp \fBcommonName\fR: Susan Jonesなど、人の通称。 .sp @@ -1364,13 +1387,14 @@ .sp \fBcountry\fR: 2文字の国コード。CHなど。 .sp -識別名文字列を\fI\-dname\fRオプションの値として指定する場合(たとえば\fI\-genkeypair\fRコマンドに)、文字列は次の形式にする必要があります。 +識別名文字列を\fB\-dname\fRオプションの値として指定する場合(たとえば\fB\-genkeypair\fRコマンドに)、文字列は次の形式にする必要があります。 .sp .if n \{\ .RS 4 .\} .nf -CN=cName, OU=orgUnit, O=org, L=city, S=state, C=countryCode +\fBCN=cName, OU=orgUnit, O=org, L=city, S=state, C=countryCode\fR + .fi .if n \{\ .RE @@ -1381,12 +1405,13 @@ .RS 4 .\} .nf -CN=commonName -OU=organizationUnit -O=organizationName -L=localityName -S=stateName -C=country +\fBCN=commonName\fR +\fBOU=organizationUnit\fR +\fBO=organizationName\fR +\fBL=localityName\fR +\fBS=stateName\fR +\fBC=country\fR + .fi .if n \{\ .RE @@ -1397,7 +1422,8 @@ .RS 4 .\} .nf -CN=Mark Smith, OU=Java, O=Oracle, L=Cupertino, S=California, C=US +\fBCN=Mark Smith, OU=Java, O=Oracle, L=Cupertino, S=California, C=US\fR + .fi .if n \{\ .RE @@ -1408,8 +1434,9 @@ .RS 4 .\} .nf -keytool \-genkeypair \-dname "CN=Mark Smith, OU=Java, O=Oracle, L=Cupertino, -S=California, C=US" \-alias mark +\fBkeytool \-genkeypair \-dname "CN=Mark Smith, OU=Java, O=Oracle, L=Cupertino,\fR +\fBS=California, C=US" \-alias mark\fR + .fi .if n \{\ .RE @@ -1422,66 +1449,73 @@ .RS 4 .\} .nf -CN=Steve Meier, OU=Java, O=Oracle, C=US +\fBCN=Steve Meier, OU=Java, O=Oracle, C=US\fR + .fi .if n \{\ .RE .\} -識別名文字列の値にカンマが含まれる場合に、コマンドラインで文字列を指定するときには、次のようにカンマをバックスラッシュ文字(\e)でエスケープする必要があります。 +識別名文字列の値にカンマが含まれる場合に、コマンド行で文字列を指定するときには、次のようにカンマをバックスラッシュ文字(\e)でエスケープする必要があります。 .sp .if n \{\ .RS 4 .\} .nf -cn=Peter Schuster, ou=Java\e, Product Development, o=Oracle, c=US +\fBcn=Peter Schuster, ou=Java\e, Product Development, o=Oracle, c=US\fR + .fi .if n \{\ .RE .\} -識別名文字列をコマンドラインで指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンドラインで識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、カンマをバックスラッシュ(\e)でエスケープする必要はありません。 +識別名文字列をコマンド行で指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンド行で識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、カンマをバックスラッシュ(\e)でエスケープする必要はありません。 .RE .SH "警告" .SS "信頼できる証明書のインポート警告" .PP \fB重要\fR: 信頼できる証明書として証明書をインポートする前に、証明書の内容を慎重に調べてください。 -Windowsの例:.PP -まず、\fI\-noprompt\fRオプションを指定せずに\fI\-printcert\fRコマンドまたは\fI\-importcert\fRコマンドを使用して、証明書を表示します。表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致することを確認します。たとえば、証明書が送られてきて、この証明書を\fI\etmp\ecert\fRという名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\fI\-printcert\fRコマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 +.PP +Windowsの例: +.PP +まず、\fB\-noprompt\fRオプションを指定せずに\fB\-printcert\fRコマンドまたは\fB\-importcert\fRコマンドを使用して、証明書を表示します。表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致することを確認します。たとえば、証明書が送られてきて、この証明書を\fB\etmp\ecert\fRという名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\fB\-printcert\fRコマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 .sp .if n \{\ .RS 4 .\} .nf - keytool \-printcert \-file \etmp\ecert - Owner: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll - Issuer: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll - Serial Number: 59092b34 - Valid from: Thu Sep 25 18:01:13 PDT 1997 until: Wed Dec 24 17:01:13 PST 1997 - Certificate Fingerprints: - MD5: 11:81:AD:92:C8:E5:0E:A2:01:2E:D4:7A:D7:5F:07:6F - SHA1: 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE - SHA256: 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90: - 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4 +\fB keytool \-printcert \-file \etmp\ecert\fR +\fB Owner: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll\fR +\fB Issuer: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll\fR +\fB Serial Number: 59092b34\fR +\fB Valid from: Thu Sep 25 18:01:13 PDT 1997 until: Wed Dec 24 17:01:13 PST 1997\fR +\fB Certificate Fingerprints:\fR +\fB MD5: 11:81:AD:92:C8:E5:0E:A2:01:2E:D4:7A:D7:5F:07:6F\fR +\fB SHA1: 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE\fR +\fB SHA256: 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90:\fR +\fB 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4\fR .fi .if n \{\ .RE .\} -Oracle Solarisの例:.PP -まず、\fI\-noprompt\fRオプションを指定せずに\fI\-printcert\fRコマンドまたは\fI\-importcert\fRコマンドを使用して、証明書を表示します。表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致することを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を\fI/tmp/cert\fRという名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\fI\-printcert\fRコマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 +.PP +Oracle Solarisの例: +.PP +まず、\fB\-noprompt\fRオプションを指定せずに\fB\-printcert\fRコマンドまたは\fB\-importcert\fRコマンドを使用して、証明書を表示します。表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致することを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を\fB/tmp/cert\fRという名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\fB\-printcert\fRコマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。 .sp .if n \{\ .RS 4 .\} .nf - keytool \-printcert \-file /tmp/cert - Owner: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll - Issuer: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll - Serial Number: 59092b34 - Valid from: Thu Sep 25 18:01:13 PDT 1997 until: Wed Dec 24 17:01:13 PST 1997 - Certificate Fingerprints: - MD5: 11:81:AD:92:C8:E5:0E:A2:01:2E:D4:7A:D7:5F:07:6F - SHA1: 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE - SHA256: 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90: - 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4 +\fB keytool \-printcert \-file /tmp/cert\fR +\fB Owner: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll\fR +\fB Issuer: CN=ll, OU=ll, O=ll, L=ll, S=ll, C=ll\fR +\fB Serial Number: 59092b34\fR +\fB Valid from: Thu Sep 25 18:01:13 PDT 1997 until: Wed Dec 24 17:01:13 PST 1997\fR +\fB Certificate Fingerprints:\fR +\fB MD5: 11:81:AD:92:C8:E5:0E:A2:01:2E:D4:7A:D7:5F:07:6F\fR +\fB SHA1: 20:B6:17:FA:EF:E5:55:8A:D0:71:1F:E8:D6:9D:C0:37:13:0E:5E:FE\fR +\fB SHA256: 90:7B:70:0A:EA:DC:16:79:92:99:41:FF:8A:FE:EB:90:\fR +\fB 17:75:E0:90:B2:24:4D:3A:2A:16:A6:E4:11:0F:67:A4\fR + .fi .if n \{\ .RE @@ -1490,27 +1524,27 @@ 次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中で他の何者か(攻撃者など)による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの(攻撃的意図を持つクラス・ファイルを含んだJARファイルなど)を信頼することになります。 .PP \fB注意:\fR -証明書をインポートする前に\fI\-printcert\fRコマンドを実行する必要はありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に、\fI\-importcert\fRコマンドによって証明書の情報が表示され、確認を求めるメッセージが表示されるためです。ユーザーはインポート操作を停止できます。ただし、これを実行できるのは、\fI\-noprompt\fRオプションを指定せずに\fI\-importcert\fRコマンドを呼び出す場合のみです。\fI\-noprompt\fRオプションが指定されている場合、ユーザーとの対話は行われません。 +証明書をインポートする前に\fB\-printcert\fRコマンドを実行する必要はありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に、\fB\-importcert\fRコマンドによって証明書の情報が表示され、確認を求めるメッセージが表示されるためです。ユーザーはインポート操作を停止できます。ただし、これを実行できるのは、\fB\-noprompt\fRオプションを指定せずに\fB\-importcert\fRコマンドを呼び出す場合のみです。\fB\-noprompt\fRオプションが指定されている場合、ユーザーとの対話は行われません。 .SS "パスワード警告" .PP -キーストアに対する操作を行うほとんどのコマンドでは、ストアのパスワードが必要です。また、一部のコマンドでは、非公開/秘密鍵のパスワードが必要になることがあります。パスワードはコマンドラインで指定できます(\fI\-storepass\fRオプションと\fI\-keypass\fRオプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンドラインやスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンドラインで指定しなかった場合は、パスワードの入力を求められます。 +キーストアに対する操作を行うほとんどのコマンドでは、ストアのパスワードが必要です。また、一部のコマンドでは、非公開/秘密鍵のパスワードが必要になることがあります。パスワードはコマンド行で指定できます(\fB\-storepass\fRオプションと\fB\-keypass\fRオプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。 .SS "証明書の準拠に関する警告" .PP インターネット標準RFC 5280では、X\&.509証明書の準拠に関するプロファイルが定義されており、証明書のフィールドおよびエクステンションに有効な値および値の組合せが記載されています。標準については、 http://tools\&.ietf\&.org/rfc/rfc5280\&.txtを参照してください .PP -\fIkeytool\fRコマンドでは、これらのルールすべてが適用されるわけではないため、標準に準拠しない証明書を生成できます。標準に準拠しない証明書は、JREや他のアプリケーションで拒否されることがあります。ユーザーは、\fI\-dname\fRや\fI\-ext\fRなどで適正なオプションを指定するようにしてください。 +\fBkeytool\fRコマンドでは、これらのルールすべてが適用されるわけではないため、標準に準拠しない証明書を生成できます。標準に準拠しない証明書は、JREや他のアプリケーションで拒否されることがあります。ユーザーは、\fB\-dname\fRや\fB\-ext\fRなどで適正なオプションを指定するようにしてください。 .SH "注意" .SS "新しい信頼できる証明書のインポート" .PP -\fIkeytool\fRコマンドは、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使用して、インポートする証明書から(ルートCAの)自己署名証明書に至るまでの信頼のチェーンの構築を試みます。 +\fBkeytool\fRコマンドは、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使用して、インポートする証明書から(ルートCAの)自己署名証明書に至るまでの信頼のチェーンの構築を試みます。 .PP -\fI\-trustcacerts\fRオプションを指定した場合、追加の証明書は信頼できるすなわち\fIcacerts\fRという名前のファイルに含まれる証明書のチェーンとみなされます。 +\fB\-trustcacerts\fRオプションを指定した場合、追加の証明書は信頼できるすなわち\fBcacerts\fRという名前のファイルに含まれる証明書のチェーンとみなされます。 .PP -\fIkeytool\fRコマンドが、インポートする証明書から自己署名証明書(キーストアまたは\fIcacerts\fRファイルに含まれている自己署名証明書)に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザーに確認を求めます。この場合は、表示された証明書のフィンガープリントと、他のなんらかの(信頼できる)情報源(証明書の所有者など)から入手したフィンガープリントとを比較します。信頼できる証明書として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。信頼できる証明書のインポート警告を参照してください。インポート操作は、証明書を確認する時点で中止できます。\fI\-noprompt\fRオプションが指定されている場合、ユーザーとの対話は行われません。 +\fBkeytool\fRコマンドが、インポートする証明書から自己署名証明書(キーストアまたは\fBcacerts\fRファイルに含まれている自己署名証明書)に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザーに確認を求めます。この場合は、表示された証明書のフィンガープリントと、他のなんらかの(信頼できる)情報源(証明書の所有者など)から入手したフィンガープリントとを比較します。信頼できる証明書として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。信頼できる証明書のインポート警告を参照してください。インポート操作は、証明書を確認する時点で中止できます。\fB\-noprompt\fRオプションが指定されている場合、ユーザーとの対話は行われません。 .SS "証明書応答のインポート" .PP -証明書応答をインポートするときは、キーストア内の信頼できる証明書、および(\fI\-trustcacert\fR\fIs\fRオプションが指定されている場合は)\fIcacerts\fRキーストア・ファイルで構成された証明書を使用して証明書応答が検査されます。cacerts証明書ファイルを参照してください。 +証明書応答をインポートするときは、キーストア内の信頼できる証明書、および(\fB\-trustcacert\fR\fBs\fRオプションが指定されている場合は)\fBcacerts\fRキーストア・ファイルで構成された証明書を使用して証明書応答が検査されます。cacerts証明書ファイルを参照してください。 .PP 証明書応答が信頼できるかどうかを決定する方法は次のとおりです。 .sp @@ -1522,7 +1556,7 @@ .sp -1 .IP \(bu 2.3 .\} -証明書応答が単一のX\&.509証明書である場合、\fIkeytool\fRコマンドは、証明書応答から(ルートCAの)自己署名証明書に至るまでの信頼チェーンの確立を試みます。証明書応答と、証明書応答の認証に使用される証明書の階層構造は、aliasの新しい証明書チェーンを形成します。信頼チェーンが確立されない場合、証明書応答はインポートされません。この場合、\fIkeytool\fRコマンドは証明書を出力せず、ユーザーに検証を求めるプロンプトを表示します。ユーザーが証明書応答の信頼性を判断するのは非常に難しいためです。 +証明書応答が単一のX\&.509証明書である場合、\fBkeytool\fRコマンドは、証明書応答から(ルートCAの)自己署名証明書に至るまでの信頼チェーンの確立を試みます。証明書応答と、証明書応答の認証に使用される証明書の階層構造は、aliasの新しい証明書チェーンを形成します。信頼チェーンが確立されない場合、証明書応答はインポートされません。この場合、\fBkeytool\fRコマンドは証明書を出力せず、ユーザーに検証を求めるプロンプトを表示します。ユーザーが証明書応答の信頼性を判断するのは非常に難しいためです。 .RE .sp .RS 4 @@ -1533,12 +1567,12 @@ .sp -1 .IP \(bu 2.3 .\} -証明書応答がPKCS#7形式の証明書チェーンまたは一連のX\&.509証明書である場合、チェーンは、ユーザーの証明書が最初に、0以上のCA証明書がその次にくるように並べられます。チェーンが自己署名のルートCA証明書で終わり、\fI \-trustcacerts\fRオプションが指定されている場合、\fIkeytool\fRコマンドは、その証明書と、キーストア内または\fIcacerts\fRキーストア・ファイル内の信頼できるすべての証明書を照合しようとします。チェーンが自己署名のルートCA証明書で終わっておらず、\fI\-trustcacerts\fRオプションが指定されている場合、\fIkeytool\fRコマンドは、キーストア内または\fIcacerts\fRキーストア・ファイル内の信頼できる証明書から自己署名のルートCA証明書を見つけてそれをチェーンの末尾に追加しようとします。その証明書が見つからず、\fI\-noprompt\fRオプションが指定されていない場合は、チェーン内の最後の証明書の情報が出力され、ユーザーは確認を求められます。 +証明書応答がPKCS#7形式の証明書チェーンまたは一連のX\&.509証明書である場合、チェーンは、ユーザーの証明書が最初に、0以上のCA証明書がその次にくるように並べられます。チェーンが自己署名のルートCA証明書で終わり、\fB \-trustcacerts\fRオプションが指定されている場合、\fBkeytool\fRコマンドは、その証明書と、キーストア内または\fBcacerts\fRキーストア・ファイル内の信頼できるすべての証明書を照合しようとします。チェーンが自己署名のルートCA証明書で終わっておらず、\fB\-trustcacerts\fRオプションが指定されている場合、\fBkeytool\fRコマンドは、キーストア内または\fBcacerts\fRキーストア・ファイル内の信頼できる証明書から自己署名のルートCA証明書を見つけてそれをチェーンの末尾に追加しようとします。その証明書が見つからず、\fB\-noprompt\fRオプションが指定されていない場合は、チェーン内の最後の証明書の情報が出力され、ユーザーは確認を求められます。 .RE .PP -証明書応答内の公開鍵が\fIalias\fRですでに格納されているユーザーの公開鍵に一致した場合、古い証明書チェーンが応答内の新しい証明書チェーンで置き換えられます。以前の証明書チェーンを有効な\fIkeypass\fRで置き換えることができるのは、エントリの秘密鍵を保護するためのパスワードを指定した場合のみです。パスワードを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。 +証明書応答内の公開鍵が\fBalias\fRですでに格納されているユーザーの公開鍵に一致した場合、古い証明書チェーンが応答内の新しい証明書チェーンで置き換えられます。以前の証明書チェーンを有効な\fBkeypass\fRで置き換えることができるのは、エントリの秘密鍵を保護するためのパスワードを指定した場合のみです。パスワードを指定しておらず、秘密鍵のパスワードがキーストアのパスワードと異なる場合は、秘密鍵のパスワードの入力を求められます。 .PP -このコマンドは、以前のリリースでは\fI\-import\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fI\-importcert\fRが優先されます。 +このコマンドは、以前のリリースでは\fB\-import\fRという名前でした。このリリースでは、引き続き古い名前がサポートされています。今後は、新しい名前\fB\-importcert\fRが優先されます。 .SH "関連項目" .sp .RS 4
--- a/src/solaris/doc/sun/man/man1/ja/native2ascii.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/native2ascii.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: native2ascii -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: 国際化ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: native2ascii +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: 国際化ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "native2ascii" "1" "2013年11月21日" "JDK 8" "国際化ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" native2ascii \- サポートされている任意の文字エンコーディングの文字を含むファイルを、ASCIIおよびUnicodeでエスケープされたファイルに変換して(またはその逆)、ローカライズ可能なアプリケーションを作成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fInative2ascii\fR [ \fIinputfile\fR ] [ \fIoutputfile\fR ] +\fBnative2ascii\fR [ \fIinputfile\fR ] [ \fIoutputfile\fR ] .fi .if n \{\ .RE @@ -73,9 +75,9 @@ .RE .SH "説明" .PP -\fInative2ascii\fRコマンドは、ASCIIキャラクタ・セットに含まれないすべての文字にUnicodeエスケープ(\fI\eu\fR\fIxxxx\fR)表記法を使用して、Java Runtime Environment (JRE)でサポートされているエンコードされたファイルを、ASCIIでエンコードされたファイルに変換します。このプロセスは、ISO\-8859\-1文字セットに含まれない文字が含まれているプロパティ・ファイルで必要です。このツールは、その逆の変換を実行することもできます。 +\fBnative2ascii\fRコマンドは、ASCII文字セットに含まれないすべての文字にUnicodeエスケープ(\fB\eu\fR\fIxxxx\fR)表記法を使用して、Java Runtime Environment (JRE)でサポートされているエンコードされたファイルを、ASCIIでエンコードされたファイルに変換します。このプロセスは、ISO\-8859\-1文字セットに含まれない文字が含まれているプロパティ・ファイルで必要です。このツールは、その逆の変換を実行することもできます。 .PP -\fIoutputfile\fR値を省略した場合、標準出力に出力されます。さらに、\fIinputfile\fR値を省略した場合、標準入力から入力されます。 +\fBoutputfile\fR値を省略した場合、標準出力に出力されます。さらに、\fBinputfile\fR値を省略した場合、標準入力から入力されます。 .SH "オプション" .PP \-reverse @@ -85,13 +87,13 @@ .PP \-encoding \fIencoding_name\fR .RS 4 -変換処理で使用する文字エンコーディングの名前を指定します。このオプションが存在しない場合は、デフォルトの文字エンコーディング(\fIjava\&.nio\&.charset\&.Charset\&.defaultCharset\fRメソッドで定義された)が使用されます。\fIencoding_name\fR文字列は、JREでサポートされている文字エンコーディングの名前にする必要があります。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/intl/encoding\&.doc\&.htmlにある +変換処理で使用する文字エンコーディングの名前を指定します。このオプションが存在しない場合は、デフォルトの文字エンコーディング(\fBjava\&.nio\&.charset\&.Charset\&.defaultCharset\fRメソッドで定義された)が使用されます。\fBencoding_name\fR文字列は、JREでサポートされている文字エンコーディングの名前にする必要があります。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/intl/encoding\&.doc\&.htmlにある 「サポートされているエンコーディング」を参照してください .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシン(JVM)に\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machine (JVM)に\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .br 'pl 8.5i
--- a/src/solaris/doc/sun/man/man1/ja/orbd.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/orbd.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: orbd -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java IDLおよびRMI-IIOPツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: orbd +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java IDLおよびRMI-IIOPツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "orbd" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" orbd \- CORBA環境のサーバーにある永続オブジェクトをクライアントから検索して呼び出せるようにします。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIorbd\fR [ \fIoptions\fR ] +\fBorbd\fR [ \fIoptions\fR ] .fi .if n \{\ .RE @@ -64,11 +66,11 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .SH "説明" .PP -\fIorbd\fRコマンドを使用すると、CORBA環境のサーバーにある永続オブジェクトをクライアントから透過的に検索して呼び出すことができます。orbdツールに含まれるサーバー・マネージャを使用すると、クライアントはCORBA環境でサーバー上にある永続オブジェクトを透過的に検索して呼び出すことができます。永続サーバーは、ネーミング・サービスに永続オブジェクト参照を発行する際、サーバーのポート番号のかわりにORBDのポート番号をオブジェクト参照に含めます。永続オブジェクト参照のオブジェクト参照にORBDポート番号を含めることには、次のような利点があります。 +\fBorbd\fRコマンドを使用すると、CORBA環境のサーバーにある永続オブジェクトをクライアントから透過的に検索して呼び出すことができます。orbdツールに含まれるサーバー・マネージャを使用すると、クライアントはCORBA環境でサーバー上にある永続オブジェクトを透過的に検索して呼び出すことができます。永続サーバーは、ネーミング・サービスに永続オブジェクト参照を発行する際、サーバーのポート番号のかわりにORBDのポート番号をオブジェクト参照に含めます。永続オブジェクト参照のオブジェクト参照にORBDポート番号を含めることには、次のような利点があります。 .sp .RS 4 .ie n \{\ @@ -92,14 +94,14 @@ クライアントは一度のみネーミング・サービスのオブジェクト参照をルックアップする必要がありますが、その後はサーバーのライフ・サイクルによる変更とは無関係にこの参照を利用することができます。 .RE .PP -ORBDのサーバー・マネージャにアクセスするには、\fIservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースです。サーバー・マネージャの詳細は、サーバー・マネージャを参照してください。 +ORBDのサーバー・マネージャにアクセスするには、\fBservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンド行インタフェースです。サーバー・マネージャの詳細は、サーバー・マネージャを参照してください。 .PP -\fIorbd\fRを起動すると、ネーミング・サービスも起動されます。ネーミング・サービスの詳細。ネーミング・サービスの起動と停止を参照してください。 +\fBorbd\fRを起動すると、ネーミング・サービスも起動されます。ネーミング・サービスの詳細。ネーミング・サービスの起動と停止を参照してください。 .SH "オプション" .PP \-ORBInitialPort \fInameserverport\fR .RS 4 -必須。ネーム・サーバーを起動するポートの番号を指定します。\fIorbd\fRは、起動されると、このポート上で着信リクエストをリスニングします。Oracle Solarisソフトウェアでは、1024より小さいポートでプロセスを開始する場合、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 +必須。ネーム・サーバーを起動するポートの番号を指定します。\fBorbd\fRは、起動されると、このポート上で着信リクエストをリスニングします。Oracle Solarisソフトウェアでは、1024より小さいポートでプロセスを開始する場合、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 .RE .SS "必須でないオプション" .PP @@ -110,22 +112,22 @@ .PP \-defaultdb \fIdirectory\fR .RS 4 -ORBD永続格納ディレクトリ\fIorb\&.db\fRが作成されるベース・ディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は\fI\&./orb\&.db\fRになります。 +ORBD永続格納ディレクトリ\fBorb\&.db\fRが作成されるベース・ディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は\fB\&./orb\&.db\fRになります。 .RE .PP \-serverPollingTime \fImilliseconds\fR .RS 4 -\fIservertool\fRを使用して登録された永続サーバーのヘルス状態をORBDがチェックする間隔を指定します。デフォルト値は1000ミリ秒です。\fImilliseconds\fRに指定する値は、有効な正の整数にする必要があります。 +\fBservertool\fRを使用して登録された永続サーバーのヘルス状態をORBDがチェックする間隔を指定します。デフォルト値は1000ミリ秒です。\fBmilliseconds\fRに指定する値は、有効な正の整数にする必要があります。 .RE .PP \-serverStartupDelay milliseconds .RS 4 -\fIservertool\fRを使用して登録された永続サーバーを再起動してから、位置転送の例外を送信するまでのORBDの待機時間を指定します。デフォルト値は1000ミリ秒です。\fImilliseconds\fRに指定する値は、有効な正の整数にする必要があります。 +\fBservertool\fRを使用して登録された永続サーバーを再起動してから、位置転送の例外を送信するまでのORBDの待機時間を指定します。デフォルト値は1000ミリ秒です。\fBmilliseconds\fRに指定する値は、有効な正の整数にする必要があります。 .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SS "ネーミング・サービスの起動と停止" .PP @@ -135,17 +137,18 @@ .PP 永続ネーミング・サービスは、ネーミング・コンテキストに対して永続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBDを再起動すると、永続ネーミング・サービスはネーミング・コンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングがそのまま(永続的に)保持されるようにします。 .PP -下位互換性のため、旧リリースのJDKに同梱されていた一時ネーミング・サービス\fItnameserv\fRが、今回のリリースのJava SEにも同梱されています。一時ネーム・サービスでは、ネーム・サービスの実行中にのみネーミング・コンテキストが保持されます。サービスが中断されると、ネーミング・コンテキスト・グラフは失われます。 +後方互換性のため、旧リリースのJDKに同梱されていた一時ネーミング・サービス\fBtnameserv\fRが、今回のリリースのJava SEにも同梱されています。一時ネーム・サービスでは、ネーム・サービスの実行中にのみネーミング・コンテキストが保持されます。サービスが中断されると、ネーミング・コンテキスト・グラフは失われます。 .PP -\fI\-ORBInitialPort\fR引数は、\fIorbd\fRの必須のコマンドライン引数で、ネーミング・サービスが実行されるポートの番号を設定するために使用されます。次の手順では、Java IDL Object Request Broker Daemon用にポート1050を使用できることを前提としています。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。必要であれば別のポートに変更してください。 +\fB\-ORBInitialPort\fR引数は、\fBorbd\fRの必須のコマンド行引数で、ネーミング・サービスが実行されるポートの番号を設定するために使用されます。次の手順では、Java IDL Object Request Broker Daemon用にポート1050を使用できることを前提としています。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。必要であれば別のポートに変更してください。 .PP -UNIXコマンド・シェルで\fIorbd\fRを起動するには、次のように入力します。 +Solaris、LinuxまたはOS Xコマンド・シェルから\fBorbd\fRを開始するには、次のように入力します。 .sp .if n \{\ .RS 4 .\} .nf -orbd \-ORBInitialPort 1050& +\fBorbd \-ORBInitialPort 1050&\fR + .fi .if n \{\ .RE @@ -157,7 +160,8 @@ .RS 4 .\} .nf -start orbd \-ORBInitialPort 1050 +\fBstart orbd \-ORBInitialPort 1050\fR + .fi .if n \{\ .RE @@ -169,85 +173,89 @@ .RS 4 .\} .nf -Properties props = new Properties(); -props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050"); -props\&.put("org\&.omg\&.CORBA\&.ORBInitialHost", "MyHost"); -ORB orb = ORB\&.init(args, props); +\fBProperties props = new Properties();\fR +\fBprops\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fR +\fBprops\&.put("org\&.omg\&.CORBA\&.ORBInitialHost", "MyHost");\fR +\fBORB orb = ORB\&.init(args, props);\fR + .fi .if n \{\ .RE .\} .PP -この例では、ネーミング・サービスは、ホスト\fIMyHost\fRのポート1050上で実行されます。別の方法として、コマンドラインからサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンドライン・オプションを使用して、\fIHelloApplication\fRを起動できます。 +この例では、ネーミング・サービスは、ホスト\fBMyHost\fRのポート1050上で実行されます。別の方法として、コマンド行からサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンド行オプションを使用して、\fBHelloApplication\fRを起動できます。 .sp .if n \{\ .RS 4 .\} .nf -java HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost +\fBjava HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost\fR + .fi .if n \{\ .RE .\} .PP -ネーミング・サービスを停止するには、適切なオペレーティング・システム・コマンドを使用します。たとえば、Oracle Solaris上で\fIpkill\fR -\fIorbd\fRを実行したり、\fIorbd\fRが動作中のDOSウィンドウで\fB[Ctrl]+[C]\fRキーを押します。一時ネーミング・サービスの場合は、サービスが終了されると、ネーミング・サービスに登録された名前が消去される場合があります。Java IDLネーム・サービスは、明示的に停止されるまで実行されます。 +ネーミング・サービスを停止するには、適切なオペレーティング・システム・コマンドを使用します。たとえば、Oracle Solaris上で\fBpkill\fR +\fBorbd\fRを実行したり、\fBorbd\fRが動作中のDOSウィンドウで\fB[Ctrl]+[C]\fRキーを押します。一時ネーミング・サービスの場合は、サービスが終了されると、ネーミング・サービスに登録された名前が消去される場合があります。Java IDLネーム・サービスは、明示的に停止されるまで実行されます。 .PP ORBDに付属するネーミング・サービスの詳細は、 http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlの「Naming Service」を参照してください .SH "サーバー・マネージャ" .PP -ORBDのサーバー・マネージャにアクセスして、永続サーバーを実行するには、\fIservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースです。\fIservertool\fRを使用してサーバーを起動する場合は、\fIorbd\fRが実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカル・コンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。 +ORBDのサーバー・マネージャにアクセスして、永続サーバーを実行するには、\fBservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンド行インタフェースです。\fBservertool\fRを使用してサーバーを起動する場合は、\fBorbd\fRが実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカル・コンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。 .PP http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlExample\&.htmlの 「Java IDL: The "Hello World" Example」を参照してください .PP -この例では、チュートリアルの手順に従って\fIidlj\fRコンパイラと\fIjavac\fRコンパイラを実行します。ORBDのサーバー・マネージャを実行するには、次の手順に従ってアプリケーションを実行します。 +この例では、チュートリアルの手順に従って\fBidlj\fRコンパイラと\fBjavac\fRコンパイラを実行します。ORBDのサーバー・マネージャを実行するには、次の手順に従ってアプリケーションを実行します。 .PP -\fIorbd\fRを起動します。 +\fBorbd\fRを起動します。 .PP -UNIXコマンド・シェルで次のように入力します: -\fIorbd \-ORBInitialPort 1050\fR。 +Solaris、LinuxまたはOS Xコマンド・シェルで、次のように入力します: +\fBorbd \-ORBInitialPort 1050\fR .PP MS\-DOSシステム・プロンプト(Windows)で次のように入力します: -\fIs\fR\fItart orbd \-ORBInitialPort 105\fR\fI0\fR +\fBs\fR\fBtart orbd \-ORBInitialPort 105\fR\fB0\fR .PP -ポート1050はネーム・サーバーを実行するポートです。\fI\-ORBInitialPort\fRオプションは必須コマンドライン引数です。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 +ポート1050はネーム・サーバーを実行するポートです。\fB\-ORBInitialPort\fRオプションは必須コマンド行引数です。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 .PP -\fIservertool\fRを起動します: -\fIservertool \-ORBInitialPort 1050\fR。 +\fBservertool\fRを起動します: +\fBservertool \-ORBInitialPort 1050\fR。 .PP -前回の手順とネーム・サーバー(\fIorbd\fR)のポートが同じであることを確認します。たとえば\fI\-ORBInitialPort 1050\&.\fRのようになります。\fIservertool\fRは、ネーム・サーバーと同じポート上で起動する必要があります。 +前回の手順とネーム・サーバー(\fBorbd\fR)のポートが同じであることを確認します。たとえば\fB\-ORBInitialPort 1050\&.\fRのようになります。\fBservertool\fRは、ネーム・サーバーと同じポート上で起動する必要があります。 .PP -\fIservertool\fRコマンドライン・インタフェースで、\fIservertool\fRプロンプトから\fIHello\fRサーバーを起動します。 +\fBservertool\fRコマンド行インタフェースで、\fBservertool\fRプロンプトから\fBHello\fRサーバーを起動します。 .sp .if n \{\ .RS 4 .\} .nf -servertool > register \-server HelloServer \-classpath \&. \-applicationName - HelloServerApName +\fBservertool > register \-server HelloServer \-classpath \&. \-applicationName\fR +\fB HelloServerApName\fR + .fi .if n \{\ .RE .\} .PP -\fIservertool\fRによってサーバーが登録されて、\fIHelloServerApName\fRという名前がサーバーに割り当てられ、登録されているすべてのサーバー一覧とともにサーバーIDが表示されます。他の端末ウィンドウまたはプロンプトからクライアント・アプリケーションを実行します。 +\fBservertool\fRによってサーバーが登録されて、\fBHelloServerApName\fRという名前がサーバーに割り当てられ、登録されているすべてのサーバー一覧とともにサーバーIDが表示されます。他の端末ウィンドウまたはプロンプトからクライアント・アプリケーションを実行します。 .sp .if n \{\ .RS 4 .\} .nf -java HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost +\fBjava HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost\fR + .fi .if n \{\ .RE .\} .PP -この例の\fI\-ORBInitialHost localhost\fRは省略することができます。ネーム・サーバーが\fIHello\fRクライアントとして同一ホスト上で動作しているからです。ネーム・サーバーが別のホストで実行されている場合は、\-\fIORBInitialHost nameserverhost\fRオプションを使用してIDLネーム・サーバーが実行されているホストを指定します。前の手順で行われたとおりにネーム・サーバー(\fIorbd\fR)ポートを指定します(例: -\fI\-ORBInitialPort 1050\fR)。ORBDのサーバー・マネージャの操作が終了したら、ネーム・サーバー(\fIorbd\fR)と\fIservertool\fRを停止するか終了してください。MS\-DOSプロンプトで\fIorbd\fRをシャットダウンするには、サーバーを実行しているウィンドウを選択して\fB[Ctrl]+[C]\fRキーを押します。 +この例の\fB\-ORBInitialHost localhost\fRは省略することができます。ネーム・サーバーが\fBHello\fRクライアントとして同一ホスト上で動作しているからです。ネーム・サーバーが別のホストで実行されている場合は、\-\fBORBInitialHost nameserverhost\fRオプションを使用してIDLネーム・サーバーが実行されているホストを指定します。前の手順で行われたとおりにネーム・サーバー(\fBorbd\fR)ポートを指定します(例: +\fB\-ORBInitialPort 1050\fR)。ORBDのサーバー・マネージャの操作が終了したら、ネーム・サーバー(\fBorbd\fR)と\fBservertool\fRを停止するか終了してください。MS\-DOSプロンプトで\fBorbd\fRをシャットダウンするには、サーバーを実行しているウィンドウを選択して\fB[Ctrl]+[C]\fRキーを押します。 .PP -Oracle Solarisから\fIorbd\fRをシャットダウンするには、プロセスを検索して、\fIkill\fRコマンドで終了します。サーバーを明示的に停止するまでは、呼出し待機状態が続きます。\fIservertool\fRをシャットダウンするには、\fBquit\fRと入力してキーボードの\fB[Enter]\fRキーを押します。 +Oracle Solarisから\fBorbd\fRをシャットダウンするには、プロセスを検索して、\fBkill\fRコマンドで終了します。サーバーを明示的に停止するまでは、呼出し待機状態が続きます。\fBservertool\fRをシャットダウンするには、\fBquit\fRと入力してキーボードの\fB[Enter]\fRキーを押します。 .SH "関連項目" .sp .RS 4
--- a/src/solaris/doc/sun/man/man1/ja/pack200.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/pack200.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: pack200 -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Javaデプロイメント・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: pack200 +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Javaデプロイメント・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "pack200" "1" "2013年11月21日" "JDK 8" "Javaデプロイメント・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" pack200 \- WebデプロイメントのためにJARファイルをpack200圧縮ファイルにパッケージします。 .SH "概要" .sp @@ -56,17 +58,17 @@ .RS 4 .\} .nf -\fIpack200\fR [\fIoptions\fR] \fIoutput\-file\fR \fIJAR\-file\fR +\fBpack200\fR [\fIoptions\fR] \fIoutput\-file\fR \fIJAR\-file\fR .fi .if n \{\ .RE .\} .PP -オプションは任意の順序で指定できます。コマンドラインまたはpropertiesファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 +オプションは任意の順序で指定できます。コマンド行またはpropertiesファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。 .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIoutput\-file\fR @@ -80,31 +82,35 @@ .RE .SH "説明" .PP -\fIpack200\fRコマンドは、Java gzipコンプレッサを使用してJARファイルをpack200圧縮ファイルに変換するJavaアプリケーションです。pack200ファイルは高圧縮のファイルで、直接デプロイでき、帯域幅の節約やダウンロード時間の短縮が可能です。 +\fBpack200\fRコマンドは、Java gzipコンプレッサを使用してJARファイルをpack200圧縮ファイルに変換するJavaアプリケーションです。pack200ファイルは高圧縮のファイルで、直接デプロイでき、帯域幅の節約やダウンロード時間の短縮が可能です。 .PP -\fIpack200\fRコマンドには、圧縮エンジンの設定や微調整を行うオプションがあります。一般的な使用方法を次の例に示します。\fImyarchive\&.pack\&.gz\fRがデフォルトの\fIpack200\fRコマンド設定で作成されます。 +\fBpack200\fRコマンドには、圧縮エンジンの設定や微調整を行うオプションがあります。一般的な使用方法を次の例に示します。\fBmyarchive\&.pack\&.gz\fRがデフォルトの\fBpack200\fRコマンド設定で作成されます。 .sp .if n \{\ .RS 4 .\} .nf -pack200 myarchive\&.pack\&.gz myarchive\&.jar +\fBpack200 myarchive\&.pack\&.gz myarchive\&.jar\fR + .fi .if n \{\ .RE .\} .SH "オプション" .PP -\-r, \-\-repack +\-r +.br +\-\-repack .RS 4 -JARファイルをパックした後アンパックして、JARファイルを生成します。生成されたファイルは\fIjarsigner\fR(1)ツールの入力ファイルとして使用できます。次の例では、myarchive\&.jarファイルをパックした後、アンパックします。 +JARファイルをパックした後アンパックして、JARファイルを生成します。生成されたファイルは\fBjarsigner\fR(1)ツールの入力ファイルとして使用できます。次の例では、myarchive\&.jarファイルをパックした後、アンパックします。 .sp .if n \{\ .RS 4 .\} .nf -pack200 \-\-repack myarchive\-packer\&.jar myarchive\&.jar -pack200 \-\-repack myarchive\&.jar +\fBpack200 \-\-repack myarchive\-packer\&.jar myarchive\&.jar\fR +\fBpack200 \-\-repack myarchive\&.jar\fR + .fi .if n \{\ .RE @@ -112,24 +118,29 @@ 次の例では、入力ファイル内のファイルの順序を保持します。 .RE .PP -\-g, \-\-no\-gzip +\-g +.br +\-\-no\-gzip .RS 4 -\fIpack200\fRファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲット・システムでは、対応する圧縮解除ツールを使用する必要があります。 +\fBpack200\fRファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲット・システムでは、対応する圧縮解除ツールを使用する必要があります。 .sp .if n \{\ .RS 4 .\} .nf -pack200 \-\-no\-gzip myarchive\&.pack myarchive\&.jar +\fBpack200 \-\-no\-gzip myarchive\&.pack myarchive\&.jar\fR + .fi .if n \{\ .RE .\} .RE .PP -\-G, \-\-strip\-debug +\-G +.br +\-\-strip\-debug .RS 4 -出力からデバッグ属性を削除します。これには、\fISourceFile\fR、\fILineNumberTable\fR、\fILocalVariableTable\fR、\fILocalVariableTypeTable\fRが含まれます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。 +出力からデバッグ属性を削除します。これには、\fBSourceFile\fR、\fBLineNumberTable\fR、\fBLocalVariableTable\fR、\fBLocalVariableTypeTable\fRが含まれます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。 .RE .PP \-\-keep\-file\-order @@ -137,15 +148,19 @@ 入力ファイル内のファイルの順序を保持します。これは、デフォルトの動作です。 .RE .PP -\-O, \-\-no\-keep\-file\-order +\-O +.br +\-\-no\-keep\-file\-order .RS 4 パック・ツールは、すべての要素を並べ替えて送信します。パック・ツールは、JARディレクトリ名を削除してダウンロード・サイズを削減することもできます。ただし、インデックスなど、特定のJARファイルの最適化機能が正常に動作しなくなることがあります。 .RE .PP -\-S\fIvalue\fR, \-\-segment\-limit=\fIvalue\fR +\-S\fIvalue\fR +.br +\-\-segment\-limit=\fIvalue\fR .RS 4 この値は、各アーカイブ・セグメントの予想ターゲット・サイズ\fIN\fR -(バイト単位)です。単一の入力ファイルの必要サイズが\fIN\fRバイトを超えると、独立したセグメントが割り当てられます。特殊なケースとして、値が\fI\-1\fRの場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が0の場合は、クラスごとにセグメントが1つずつ生成されます。アーカイブ・セグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。 +(バイト単位)です。単一の入力ファイルの必要サイズが\fIN\fRバイトを超えると、独立したセグメントが割り当てられます。特殊なケースとして、値が\fB\-1\fRの場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が0の場合は、クラスごとにセグメントが1つずつ生成されます。アーカイブ・セグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。 .sp 各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前と他の送信されるプロパティのサイズを計算して推測されます。 .sp @@ -154,136 +169,169 @@ この制限が課されていない10 MBのJARパック・ファイルは通常、約10%小さくパックされます。しかし、パック・ツールでより大きなJavaヒープ(セグメントの制限の約10倍)を必要とする場合もあります。 .RE .PP -\-E\fIvalue\fR, \-\-effort=\fIvalue\fR +\-E\fIvalue\fR +.br +\-\-effort=\fIvalue\fR .RS 4 -単一の10進数値を指定した場合、パック・ツールは、指定された圧縮率でアーカイブを圧縮します。レベル1の場合は、比較的短い圧縮時間で多少大きめのファイルが生成されますが、レベル9の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値0を指定した場合は、\fIpack200\fRコマンドは元のJARファイルを圧縮なしで直接コピーします。JSR 200標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。 +単一の10進数値を指定した場合、パック・ツールは、指定された圧縮率でアーカイブを圧縮します。レベル1の場合は、比較的短い圧縮時間で多少大きめのファイルが生成されますが、レベル9の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値0を指定した場合は、\fBpack200\fRコマンドは元のJARファイルを圧縮なしで直接コピーします。JSR 200標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。 .sp デフォルトは5です。この場合、標準的な時間で適切な圧縮が行われます。 .RE .PP -\-H\fIvalue\fR, \-\-deflate\-hint=\fIvalue\fR +\-H\fIvalue\fR +.br +\-\-deflate\-hint=\fIvalue\fR .RS 4 -入力情報を保存するというデフォルト値をオーバーライドします。転送されるアーカイブのサイズは大きくなる場合があります。指定可能な値は、\fItrue\fR、\fIfalse\fRまたは\fIkeep\fRです。 +入力情報を保存するというデフォルト値をオーバーライドします。転送されるアーカイブのサイズは大きくなる場合があります。指定可能な値は、\fBtrue\fR、\fBfalse\fRまたは\fBkeep\fRです。 .sp -\fIvalue\fRが\fItrue\fRまたはfalseの場合、\fIpacker200\fRコマンドは指定に従ってデフレーション・ヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーション・ヒントは転送されません。 +\fBvalue\fRが\fBtrue\fRまたはfalseの場合、\fBpacker200\fRコマンドは指定に従ってデフレーション・ヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーション・ヒントは転送されません。 .sp -\fIkeep\fR値は、入力JARで確認されたデフレーション・ヒントを保持します。これがデフォルトです。 +\fBkeep\fR値は、入力JARで確認されたデフレーション・ヒントを保持します。これがデフォルトです。 .RE .PP -\-m\fIvalue\fR, \-\-modification\-time=\fIvalue\fR +\-m\fIvalue\fR +.br +\-\-modification\-time=\fIvalue\fR .RS 4 -指定可能な値は\fIlatest\fRと\fIkeep\fRです。 +指定可能な値は\fBlatest\fRと\fBkeep\fRです。 .sp 値が最新の場合、パック・ツールは、元のアーカイブの使用可能なすべてのエントリのうちの最終更新時刻か、そのセグメントの使用可能なすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストール・ファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。 .sp -値が\fIkeep\fRの場合、入力JARで確認された変更時間が保持されます。これがデフォルトです。 +値が\fBkeep\fRの場合、入力JARで確認された変更時間が保持されます。これがデフォルトです。 .RE .PP -\-P\fIfile\fR, \-\-pass\-file=\fIfile\fR +\-P\fIfile\fR +.br +\-\-pass\-file=\fIfile\fR .RS 4 -ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰返し使用して、複数のファイルを指定できます。システム・ファイル・セパレータがJARファイル・セパレータのスラッシュ(/)に置き換えられる点を除き、パス名の変換は行われません。結果として得られるファイル名は、文字列として正確にJARファイルでの出現と一致している必要があります。\fIfile\fRにディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。 +ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰返し使用して、複数のファイルを指定できます。システム・ファイル・セパレータがJARファイル・セパレータのスラッシュ(/)に置き換えられる点を除き、パス名の変換は行われません。結果として得られるファイル名は、文字列として正確にJARファイルでの出現と一致している必要があります。\fBfile\fRにディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。 .RE .PP -\-U\fIaction\fR, \-\-unknown\-attribute=\fIaction\fR +\-U\fIaction\fR +.br +\-\-unknown\-attribute=\fIaction\fR .RS 4 -デフォルトの動作をオーバーライドします。つまり、不明な属性を含むクラス・ファイルが、指定した\fIaction\fRによって渡されます。アクションとして指定可能な値は、\fIerror\fR、\fIstrip\fRまたは\fIpass\fRです。 +デフォルトの動作をオーバーライドします。つまり、不明な属性を含むクラス・ファイルが、指定した\fBaction\fRによって渡されます。アクションとして指定可能な値は、\fBerror\fR、\fBstrip\fRまたは\fBpass\fRです。 .sp -値が\fIerror\fRの場合、\fIpack200\fRコマンド操作全体が失敗して適切な説明が表示されます。 +値が\fBerror\fRの場合、\fBpack200\fRコマンド操作全体が失敗して適切な説明が表示されます。 .sp -値が\fIstrip\fRの場合、属性は削除されます。Java仮想マシン(JVM)必須属性を削除すると、クラス・ローダーの障害が発生することがあります。 +値が\fBstrip\fRの場合、属性は削除されます。Java Virtual Machine (JVM)必須属性を削除すると、クラス・ローダーの障害が発生することがあります。 .sp -値が\fIpass\fRの場合、クラス全体が1つのリソースとして転送されます。 +値が\fBpass\fRの場合、クラス全体が1つのリソースとして転送されます。 .RE .PP -\-C\fIattribute\-name\fR=\fIlayout\fR, \-\-class\-attribute=\fIattribute\-name\fR=\fIaction\fR +\-C\fIattribute\-name\fR=\fIlayout\fR +.br +\-\-class\-attribute=\fIattribute\-name\fR=\fIaction\fR .RS 4 次のオプションを参照してください。 .RE .PP -\-F\fIattribute\-name\fR=\fIlayout\fR, \-\-field\-attribute=\fIattribute\-name\fR=\fIaction\fR +\-F\fIattribute\-name\fR=\fIlayout\fR +.br +\-\-field\-attribute=\fIattribute\-name\fR=\fIaction\fR .RS 4 次のオプションを参照してください。 .RE .PP -\-M\fIattribute\-name\fR=\fIlayout\fR, \-\-method\-attribute=\fIattribute\-name\fR=\fIaction\fR +\-M\fIattribute\-name\fR=\fIlayout\fR +.br +\-\-method\-attribute=\fIattribute\-name\fR=\fIaction\fR .RS 4 次のオプションを参照してください。 .RE .PP -\-D\fIattribute\-name\fR=\fIlayout\fR, \-\-code\-attribute=\fIattribute\-name\fR=\fIaction\fR +\-D\fIattribute\-name\fR=\fIlayout\fR +.br +\-\-code\-attribute=\fIattribute\-name\fR=\fIaction\fR .RS 4 -前述の4つのオプションでは、クラス・エンティティに\fIclass\-attribute\fR、\fIfield\-attribute\fR、\fImethod\-attribute\fRおよび\fIcode\-attribute\fRなどの属性のレイアウトを指定できます。\fIattribute\-name\fRには、これからレイアウトまたはアクションを定義する属性の名前を指定します。\fIaction\fRとして指定可能な値は、\fIsome\-layout\-string\fR、\fIerror\fR、\fIstrip\fR、\fIpass\fRです。 +前述の4つのオプションでは、クラス・エンティティに\fBclass\-attribute\fR、\fBfield\-attribute\fR、\fBmethod\-attribute\fRおよび\fBcode\-attribute\fRなどの属性のレイアウトを指定できます。\fIattribute\-name\fRには、これからレイアウトまたはアクションを定義する属性の名前を指定します。\fIaction\fRとして指定可能な値は、\fBsome\-layout\-string\fR、\fBerror\fR、\fBstrip\fR、\fBpass\fRです。 .sp -\fIsome\-layout\-string\fR: レイアウト言語はJSR 200仕様で定義されています。例: -\fI\-\-class\-attribute=SourceFile=RUH\fR。 +\fBsome\-layout\-string\fR: レイアウト言語はJSR 200仕様で定義されています。例: +\fB\-\-class\-attribute=SourceFile=RUH\fR。 .sp -値が\fIerror\fRの場合、\fIpack200\fR操作が失敗して説明が表示されます。 +値が\fBerror\fRの場合、\fBpack200\fR操作が失敗して説明が表示されます。 .sp -値が\fIstrip\fRの場合、属性が出力から削除されます。VM必須属性を削除するとクラス・ローダーの障害が発生することがあります。たとえば、\fI\-\-class\-attribute=CompilationID=pass\fRというこの属性を含むクラス・ファイルを転送します。パック・ツールは、その他のアクションを行いません。 +値が\fBstrip\fRの場合、属性が出力から削除されます。VM必須属性を削除するとクラス・ローダーの障害が発生することがあります。たとえば、\fB\-\-class\-attribute=CompilationID=pass\fRというこの属性を含むクラス・ファイルを転送します。パック・ツールは、その他のアクションを行いません。 .sp -値が\fIpass\fRの場合、クラス全体が1つのリソースとして転送されます。 +値が\fBpass\fRの場合、クラス全体が1つのリソースとして転送されます。 .RE .PP -\-f \fIpack\&.properties\fR, \-\-config\-file=\fIpack\&.properties\fR +\-f \fIpack\&.properties\fR +.br +\-\-config\-file=\fIpack\&.properties\fR .RS 4 -コマンドラインに、パック・ツールを初期化するためのJavaプロパティが含まれている構成ファイルを指定できます。 +コマンド行に、パック・ツールを初期化するためのJavaプロパティが含まれている構成ファイルを指定できます。 .sp .if n \{\ .RS 4 .\} .nf -pack200 \-f pack\&.properties myarchive\&.pack\&.gz myarchive\&.jar -more pack\&.properties -# Generic properties for the packer\&. -modification\&.time=latest -deflate\&.hint=false -keep\&.file\&.order=false -# This option will cause the files bearing new attributes to -# be reported as an error rather than passed uncompressed\&. -unknown\&.attribute=error -# Change the segment limit to be unlimited\&. -segment\&.limit=\-1 +\fBpack200 \-f pack\&.properties myarchive\&.pack\&.gz myarchive\&.jar\fR +\fBmore pack\&.properties\fR +\fB# Generic properties for the packer\&.\fR +\fBmodification\&.time=latest\fR +\fBdeflate\&.hint=false\fR +\fBkeep\&.file\&.order=false\fR +\fB# This option will cause the files bearing new attributes to\fR +\fB# be reported as an error rather than passed uncompressed\&.\fR +\fBunknown\&.attribute=error\fR +\fB# Change the segment limit to be unlimited\&.\fR +\fBsegment\&.limit=\-1\fR + .fi .if n \{\ .RE .\} .RE .PP -\-v, \-\-verbose +\-v +.br +\-\-verbose .RS 4 最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが作成されます。 .RE .PP -\-q, \-\-quiet +\-q +.br +\-\-quiet .RS 4 メッセージを表示せずに動作するように指定します。 .RE .PP -\-l\fIfilename\fR, \-\-log\-file=\fIfilename\fR +\-l\fIfilename\fR +.br +\-\-log\-file=\fIfilename\fR .RS 4 出力メッセージのログ・ファイルを指定します。 .RE .PP -\-?, \-h, \-\-help +\-? +.br +\-h +.br +\-\-help .RS 4 このコマンドに関するヘルプ情報を出力します。 .RE .PP -\-V, \-\-version +\-V +.br +\-\-version .RS 4 このコマンドに関するバージョン情報を出力します。 .RE .PP \-J\fIoption\fR .RS 4 -指定されたオプションをJava仮想マシンに渡します。詳細は、java(1)コマンドのリファレンス・ページを参照してください。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。 +指定されたオプションをJava Virtual Machineに渡します。詳細は、java(1)コマンドのリファレンス・ページを参照してください。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。 .RE .SH "終了ステータス" .PP 次の終了値が返されます: 正常終了の場合は0、エラーが発生した場合は0より大きい値。 .SH "注意" .PP -このコマンドと\fIpack\fR(1)を混同しないでください。\fIpack\fRおよび\fIpack200\fRコマンドは、別々の製品です。 +このコマンドと\fBpack\fR(1)を混同しないでください。\fBpack\fRおよび\fBpack200\fRコマンドは、別々の製品です。 .PP JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。 .SH "関連項目"
--- a/src/solaris/doc/sun/man/man1/ja/policytool.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/policytool.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: policytool -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: セキュリティ・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: policytool +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: セキュリティ・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "policytool" "1" "2013年11月21日" "JDK 8" "セキュリティ・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" policytool \- ユーティリティGUI経由で取得したユーザー入力に基づいて、プレーン・テキストのポリシー・ファイルを読み書きします。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIpolicytool\fR [ \fI\-file\fR ] [ \fIfilename\fR ] +\fBpolicytool\fR [ \fB\-file\fR ] [ \fIfilename\fR ] .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \-file .RS 4 -ポリシー・ファイルを読み込むように\fIpolicytool\fRに指示します。 +ポリシー・ファイルを読み込むように\fBpolicytool\fRに指示します。 .RE .PP \fIfilename\fR @@ -80,32 +82,34 @@ .RS 4 .\} .nf -policytool +\fBpolicytool\fR + .fi .if n \{\ .RE .\} .PP -\fIpolicytool\fRコマンドを実行し、指定されたファイルをロードします: +\fBpolicytool\fRコマンドを実行し、指定されたファイルをロードします: .sp .if n \{\ .RS 4 .\} .nf -policytool\-file mypolicyfile +\fBpolicytool\-file mypolicyfile\fR + .fi .if n \{\ .RE .\} .SH "説明" .PP -\fIpolicytool\fRコマンドは、管理者のGUIを呼び出します。これにより、システム管理者はローカル・ポリシー・ファイルの内容を管理できるようになります。ポリシー・ファイルは\fI\&.policy\fR拡張子を持つプレーンテキスト・ファイルで、ドメイン別にリモート・リクエスタを権限オブジェクトにマップします。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある +\fBpolicytool\fRコマンドは、管理者のGUIを呼び出します。これにより、システム管理者はローカル・ポリシー・ファイルの内容を管理できるようになります。ポリシー・ファイルは\fB\&.policy\fR拡張子を持つプレーンテキスト・ファイルで、ドメイン別にリモート・リクエスタを権限オブジェクトにマップします。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある 「Default Policy Implementation and Policy File Syntax」を参照してください .SH "オプション" .PP \-file .RS 4 -ポリシー・ファイルを読み込むように\fIpolicytool\fRに指示します。 +ポリシー・ファイルを読み込むように\fBpolicytool\fRに指示します。 .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/rmic.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/rmic.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: rmic -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Remote Method Invocation (RMI)ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: rmic +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Remote Method Invocation (RMI)ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "rmic" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" rmic \- Java Remote Method Protocol (JRMP)またはInternet Inter\-Orb protocol (IIOP)を使用するリモート・オブジェクトのスタブ、スケルトンおよびTieクラスを生成します。Object Management Group (OMG)インタフェース定義言語(IDL)も生成します .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIrmic\fR [ \fIoptions\fR ] \fIpackage\-qualified\-class\-names\fR +\fBrmic\fR [ \fIoptions\fR ] \fIpackage\-qualified\-class\-names\fR .fi .if n \{\ .RE @@ -64,26 +66,27 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・\fIオプション\fR。オプションを参照してください。 +コマンド行\fBオプション\fR。オプションを参照してください。 .RE .PP \fIpackage\-qualified\-class\-names\fR .RS 4 パッケージを含むクラス名。例: -\fIjava\&.awt\&.Color\fR。 +\fBjava\&.awt\&.Color\fR。 .RE .SH "説明" .PP \fB非推奨に関する注意:\fR -Java Remote Method Protocol (JRMP)スタブおよびスケルトンの静的な生成のサポートは非推奨になりました。動的に生成されるJRMPスタブをかわりに使用して、JRMPベースのアプリケーションにこのツールを使用する必要性をなくすことをお薦めします。詳細は、\fIjava\&.rmi\&.server\&.UnicastRemoteObject\fR仕様(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/server/UnicastRemoteObject\&.html)を参照してください。 +Java Remote Method Protocol (JRMP)スタブおよびスケルトンの静的な生成のサポートは非推奨になりました。動的に生成されるJRMPスタブをかわりに使用して、JRMPベースのアプリケーションにこのツールを使用する必要性をなくすことをお薦めします。詳細は、\fBjava\&.rmi\&.server\&.UnicastRemoteObject\fR仕様(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/server/UnicastRemoteObject\&.html)を参照してください。 .PP -\fIrmic\fRコンパイラは、Java Remote Method Protocol (JRMP)とスタブおよびTieクラス・ファイル(IIOPプロトコル)を使用して、リモート・オブジェクトのスタブおよびスケルトン・クラス・ファイルを生成します。リモート・オブジェクトの実装クラスであるこれらのクラス・ファイルは、Javaプログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、\fIjava\&.rmi\&.Remote\fRインタフェースを実装するクラスです。\fIrmic\fRコマンドでのクラス名は、そのクラスが\fIjavac\fRコマンドでコンパイルが成功していて、かつ完全修飾パッケージ名である必要があります。たとえば、次に示すクラス・ファイル名\fIHelloImpl\fRで\fIrmic\fRコマンドを実行すると、helloサブディレクトリ(クラスのパッケージの名前の付いた)に\fIHelloImpl_Stub\&.class \fRファイルが作成されます。 +\fBrmic\fRコンパイラは、Java Remote Method Protocol (JRMP)とスタブおよびTieクラス・ファイル(IIOPプロトコル)を使用して、リモート・オブジェクトのスタブおよびスケルトン・クラス・ファイルを生成します。リモート・オブジェクトの実装クラスであるこれらのクラス・ファイルは、Javaプログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、\fBjava\&.rmi\&.Remote\fRインタフェースを実装するクラスです。\fBrmic\fRコマンドでのクラス名は、そのクラスが\fBjavac\fRコマンドでコンパイルが成功していて、かつ完全修飾パッケージ名である必要があります。たとえば、次に示すクラス・ファイル名\fBHelloImpl\fRで\fBrmic\fRコマンドを実行すると、helloサブディレクトリ(クラスのパッケージの名前の付いた)に\fBHelloImpl_Stub\&.class \fRファイルが作成されます。 .sp .if n \{\ .RS 4 .\} .nf -rmic hello\&.HelloImpl +\fBrmic hello\&.HelloImpl\fR + .fi .if n \{\ .RE @@ -95,9 +98,9 @@ .PP スタブとは、リモート・オブジェクトのクライアント側での代理です。スタブは、リモート・オブジェクトのメソッド呼出しを、実物のリモート・オブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモート・オブジェクトへの参照は、実際はローカル・スタブへの参照となります。 .PP -デフォルトで\fIrmic\fRコマンドは、1\&.2 JRMPスタブ・プロトコル・バージョンのみを使用するスタブ・クラスを生成します。これは、\fI\-v1\&.2\fRオプションを指定した場合と同じ動作です。リリース5\&.0以前では\fI\-vcompat\fRオプションがデフォルトでした。IIOPプロトコル用のスタブおよびTieクラスを生成するには\fI\-iiop\fRオプションを使用します。オプションを参照してください。 +デフォルトで\fBrmic\fRコマンドは、1\&.2 JRMPスタブ・プロトコル・バージョンのみを使用するスタブ・クラスを生成します。これは、\fB\-v1\&.2\fRオプションを指定した場合と同じ動作です。リリース5\&.0以前では\fB\-vcompat\fRオプションがデフォルトでした。IIOPプロトコル用のスタブおよびTieクラスを生成するには\fB\-iiop\fRオプションを使用します。オプションを参照してください。 .PP -スタブはリモート・インタフェースのみを実装し、リモート・オブジェクトが実装するローカル・インタフェースは実装していません。JRMPスタブはリモート・オブジェクトが実装するリモート・インタフェースと同じものを実装しているので、クライアントは、キャストや型チェックにJavaプログラミング言語に組み込まれた演算子を使用することができます。IIOPの場合は、\fIPortableRemoteObject\&.narrow\fRメソッドを使用する必要があります。 +スタブはリモート・インタフェースのみを実装し、リモート・オブジェクトが実装するローカル・インタフェースは実装していません。JRMPスタブはリモート・オブジェクトが実装するリモート・インタフェースと同じものを実装しているので、クライアントは、キャストや型チェックにJavaプログラミング言語に組み込まれた演算子を使用することができます。IIOPの場合は、\fBPortableRemoteObject\&.narrow\fRメソッドを使用する必要があります。 .SH "オプション" .PP \-bootclasspath \fIpath\fR @@ -107,8 +110,8 @@ .PP \-classpath path .RS 4 -\fIrmic\fRコマンドがクラスを探すためのパスを指定します。このオプションは、デフォルトや\fICLASSPATH\fR環境変数設定をオーバーライドします。ディレクトリはコロンで分割します。パスの一般的な形式は\fI\&.;<your_path>\fRです。例: -\fI\&.;/usr/local/java/classes\fR +\fBrmic\fRコマンドがクラスを探すためのパスを指定します。このオプションは、デフォルトや\fBCLASSPATH\fR環境変数設定をオーバーライドします。ディレクトリはコロンで分割します。パスの一般的な形式は\fB\&.;<your_path>\fRです。例: +\fB\&.;/usr/local/java/classes\fR .RE .PP \-d \fIdirectory\fR @@ -119,12 +122,13 @@ .RS 4 .\} .nf -rmic \-d /java/classes exampleclass\&.MyClass +\fBrmic \-d /java/classes exampleclass\&.MyClass\fR + .fi .if n \{\ .RE .\} -\fI\-d\fRオプションが指定されていない場合、デフォルトの動作は\fI\-d\fRが指定されていた場合と同じです。ターゲット・クラスのパッケージ階層が現在のディレクトリに作成され、stub/tie/skeletonファイルが格納されます。以前のリリースの\fIrmic\fRコマンドでは、\fI\-d\fRが指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていました。 +\fB\-d\fRオプションが指定されていない場合、デフォルトの動作は\fB\-d\fRが指定されていた場合と同じです。ターゲット・クラスのパッケージ階層が現在のディレクトリに作成され、stub/tie/skeletonファイルが格納されます。以前のリリースの\fBrmic\fRコマンドでは、\fB\-d\fRが指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていました。 .RE .PP \-extdirs \fIpath\fR @@ -139,10 +143,10 @@ .PP \-idl .RS 4 -\fIrmic\fRコマンドによって、指定したクラスおよび参照されたクラスのOMG IDLが生成されます。IDLでは、プログラミング言語に依存せずに、宣言するだけでオブジェクトのAPIを指定することができます。IDLは、メソッドおよびデータの仕様として使用します。CORBAバインディングを提供する任意の言語で、メソッドおよびデータの作成および呼出しを行うことができます。これらの言語には、JavaおよびC++が含まれています。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/mapping/jidlMapping\&.htmlの +\fBrmic\fRコマンドによって、指定したクラスおよび参照されたクラスのOMG IDLが生成されます。IDLでは、プログラミング言語に依存せずに、宣言するだけでオブジェクトのAPIを指定することができます。IDLは、メソッドおよびデータの仕様として使用します。CORBAバインディングを提供する任意の言語で、メソッドおよびデータの作成および呼出しを行うことができます。これらの言語には、JavaおよびC++が含まれています。http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/mapping/jidlMapping\&.htmlの 「Java IDL: IDL to Java Language Mapping」を参照してください .sp -\fI\-idl\fRオプションを使用するときには、他のオプションも指定できます。 +\fB\-idl\fRオプションを使用するときには、他のオプションも指定できます。 .sp .RS 4 .ie n \{\ @@ -152,18 +156,7 @@ .sp -1 .IP \(bu 2.3 .\} -既存のスタブ/Tie/IDLが入力クラスよりも新しい場合でも、\fI\-always\fRまたは\fI\-alwaysgenerate\fRオプションは再生成を強制します。 -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -\fI\-factory\fRオプションは、生成されたIDLで\fIfactory\fRキーワードを使用します。 +既存のスタブ/Tie/IDLが入力クラスよりも新しい場合でも、\fB\-always\fRまたは\fB\-alwaysgenerate\fRオプションは再生成を強制します。 .RE .sp .RS 4 @@ -174,15 +167,7 @@ .sp -1 .IP \(bu 2.3 .\} -The -\fI\-idlModule\fR -from J\fIavaPackage[\&.class]\fR -\fItoIDLModule\fR -specifies -\fIIDLEntity\fR -package mapping, for example: -\fI\-idlModule\fR -\fImy\&.module my::real::idlmod\fR\&. +\fB\-factory\fRオプションは、生成されたIDLで\fBfactory\fRキーワードを使用します。 .RE .sp .RS 4 @@ -193,27 +178,39 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-idlFile\fR -\fIfromJavaPackage[\&.class] toIDLFile\fR -specifies -\fIIDLEntity\fR -file mapping, for example: -\fI\-idlFile test\&.pkg\&.X TEST16\&.idl\fR\&. +J\fBavaPackage[\&.class]\fR +\fBtoIDLModule\fRの\fB\-idlModule\fRは\fBIDLEntity\fRパッケージ・マッピングを指定します。例: +\fB\-idlModule\fR +\fBmy\&.module my::real::idlmod\fR +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fB\-idlFile\fR +\fBfromJavaPackage[\&.class] toIDLFile\fRは\fBIDLEntity\fRファイル・マッピングを指定します。例: +\fB\-idlFile test\&.pkg\&.X TEST16\&.idl\fR .RE .RE .PP \-iiop .RS 4 -\fIrmic\fRコマンドによって、JRMPのスタブとスケルトン・クラスのかわりに、IIOPのスタブとTieクラスが生成されます。スタブ・クラスは、リモート・オブジェクトのローカル・プロキシで、クライアントからサーバーに呼出しを送信するときに使用されます。各リモート・インタフェースにはスタブ・クラスが必要です。スタブ・クラスによってリモート・インタフェースが実装されます。クライアントでリモート・オブジェクトを参照するときは、スタブを参照することになります。タイ・クラスは、サーバー側で着呼を処理し、その呼出しを適切な実装クラスにディスパッチするときに使用されます。各実装クラスには、タイ・クラスが必要です。 +\fBrmic\fRコマンドによって、JRMPのスタブとスケルトン・クラスのかわりに、IIOPのスタブとTieクラスが生成されます。スタブ・クラスは、リモート・オブジェクトのローカル・プロキシで、クライアントからサーバーに呼出しを送信するときに使用されます。各リモート・インタフェースにはスタブ・クラスが必要です。スタブ・クラスによってリモート・インタフェースが実装されます。クライアントでリモート・オブジェクトを参照するときは、スタブを参照することになります。タイ・クラスは、サーバー側で着呼を処理し、その呼出しを適切な実装クラスにディスパッチするときに使用されます。各実装クラスには、タイ・クラスが必要です。 .sp -\fI\-iiop\fRを使用して\fIrmic\fRコマンドを呼び出すと、次の命名規則に準拠したスタブとTieが生成されます。 +\fB\-iiop\fRを使用して\fBrmic\fRコマンドを呼び出すと、次の命名規則に準拠したスタブとTieが生成されます。 .sp .if n \{\ .RS 4 .\} .nf -_<implementationName>_stub\&.class -_<interfaceName>_tie\&.class +\fB_<implementationName>_stub\&.class\fR +\fB_<interfaceName>_tie\&.class\fR + .fi .if n \{\ .RE @@ -227,7 +224,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-iiop\fRオプションを使用するときには、他のオプションも指定できます。 +\fB\-iiop\fRオプションを使用するときには、他のオプションも指定できます。 .RE .sp .RS 4 @@ -238,7 +235,7 @@ .sp -1 .IP \(bu 2.3 .\} -既存のスタブ/Tie/IDLが入力クラスよりも新しい場合でも、\fI\-always\fRまたは\fI\-alwaysgenerate\fRオプションは再生成を強制します。 +既存のスタブ/Tie/IDLが入力クラスよりも新しい場合でも、\fB\-always\fRまたは\fB\-alwaysgenerate\fRオプションは再生成を強制します。 .RE .sp .RS 4 @@ -249,7 +246,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-nolocalstubs\fRオプションでは、同じプロセスのクライアントとサーバーに最適化されたスタブは作成されません。 +\fB\-nolocalstubs\fRオプションでは、同じプロセスのクライアントとサーバーに最適化されたスタブは作成されません。 .RE .sp .RS 4 @@ -260,7 +257,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-noValueMethods\fRオプションは\fI\-idl\fRオプションとともに使用する必要があります。\fI\-noValueMethods\fRオプションは、送信されるIDLに\fIvaluetype\fRメソッドおよび初期化子を追加できないようにします。このメソッドおよび初期化子は、valuetypeの場合はオプションです。\fI\-idl\fRオプションとともに\fI\-noValueMethods\fRオプションを指定しないかぎり生成されます。 +\fB\-noValueMethods\fRオプションは\fB\-idl\fRオプションとともに使用する必要があります。\fB\-noValueMethods\fRオプションは、送信されるIDLに\fBvaluetype\fRメソッドおよび初期化子を追加できないようにします。このメソッドおよび初期化子は、valuetypeの場合はオプションです。\fB\-idl\fRオプションとともに\fB\-noValueMethods\fRオプションを指定しないかぎり生成されます。 .RE .sp .RS 4 @@ -271,23 +268,23 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-poa\fRオプションは継承を\fIorg\&.omg\&.CORBA_2_3\&.portable\&.ObjectImpl\fRから\fIorg\&.omg\&.PortableServer\&.Servant\fRに変更します。ポータブル・オブジェクト・アダプタ(POA)の\fIPortableServer\fRモジュールは、ネイティブの\fIServant\fR型を定義します。Javaプログラミング言語では、\fIServant\fR型はJavaの\fIorg\&.omg\&.PortableServer\&.Servant\fRクラスにマップされます。これは、すべてのPOAサーバント実装のベース・クラスとして機能し、アプリケーション・プログラマが呼び出すことのできるいくつかのメソッド、およびPOAによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドを提供します。OMG IDL to Java Language Mapping Specification、CORBA V 2\&.3\&.1 ptc/00\-01\-08\&.pdfに準拠しています。 +\fB\-poa\fRオプションは継承を\fBorg\&.omg\&.CORBA_2_3\&.portable\&.ObjectImpl\fRから\fBorg\&.omg\&.PortableServer\&.Servant\fRに変更します。ポータブル・オブジェクト・アダプタ(POA)の\fBPortableServer\fRモジュールは、ネイティブの\fBServant\fR型を定義します。Javaプログラミング言語では、\fBServant\fR型はJavaの\fBorg\&.omg\&.PortableServer\&.Servant\fRクラスにマップされます。これは、すべてのPOAサーバント実装のベース・クラスとして機能し、アプリケーション・プログラマが呼び出すことのできるいくつかのメソッド、およびPOAによって呼び出され、サーバントの動作を制御するためにユーザーがオーバーライドできるメソッドを提供します。OMG IDL to Java Language Mapping Specification、CORBA V 2\&.3\&.1 ptc/00\-01\-08\&.pdfに準拠しています。 .RE .RE .PP \-J .RS 4 -Javaコマンドとともに使用して、\fI\-J\fRオプションは\fI\-J\fRの後ろに続く引数をJavaインタプリタに渡します(\fI\-J\fRと引数の間にスペースは入れません)。 +Javaコマンドとともに使用して、\fB\-J\fRオプションは\fB\-J\fRの後ろに続く引数をJavaインタプリタに渡します(\fB\-J\fRと引数の間にスペースは入れません)。 .RE .PP \-keep or \-keepgenerated .RS 4 -スタブ、スケルトン、またはTieクラスのために生成された\fI\&.java\fRソース・ファイルを保持し、\fI\&.class\fRファイルと同じディレクトリに書き込みます。 +スタブ、スケルトン、またはTieクラスのために生成された\fB\&.java\fRソース・ファイルを保持し、\fB\&.class\fRファイルと同じディレクトリに書き込みます。 .RE .PP \-nowarn .RS 4 -警告をオフにします。\fI\-nowarn\fRオプションが使用される場合。コンパイラは警告を表示しません。 +警告をオフにします。\fB\-nowarn\fRオプションが使用される場合。コンパイラは警告を表示しません。 .RE .PP \-nowrite @@ -307,7 +304,7 @@ .PP \-v1\&.1 (非推奨) .RS 4 -1\&.1 JRMPスタブ・プロトコル・バージョンのみのスタブおよびスケルトン・クラスを生成します。\fI\-v1\&.1\fRオプションを使用できるのは、JDK 1\&.1から\fIrmic\fRコマンドで生成され、アップグレードできない(さらにダイナミック・クラス・ローディングを使用していない)、既存の静的デプロイされたスタブ・クラスに対し、直列化互換性のあるスタブ・クラスを生成する場合のみです。注意:このオプションは非推奨になりました。説明を参照してください。 +1\&.1 JRMPスタブ・プロトコル・バージョンのみのスタブおよびスケルトン・クラスを生成します。\fB\-v1\&.1\fRオプションを使用できるのは、JDK 1\&.1から\fBrmic\fRコマンドで生成され、アップグレードできない(さらにダイナミック・クラス・ローディングを使用していない)、既存の静的デプロイされたスタブ・クラスに対し、直列化互換性のあるスタブ・クラスを生成する場合のみです。注意:このオプションは非推奨になりました。説明を参照してください。 .RE .PP \-v1\&.2 (非推奨) @@ -319,7 +316,7 @@ CLASSPATH .RS 4 ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで区切られます。例: -\fI\&.:/usr/local/java/classes\fR +\fB\&.:/usr/local/java/classes\fR .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/rmid.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/rmid.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: rmid -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Remote Method Invocation (RMI)ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: rmid +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Remote Method Invocation (RMI)ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "rmid" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -rmid \- 起動システム・デーモンを開始すると、オブジェクトをJava仮想マシン(VM)に登録してアクティブ化できるようになります。 +.SH "名前" +rmid \- 起動システム・デーモンを開始すると、オブジェクトをJava Virtual Machine(VM)に登録してアクティブ化できるようになります。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIrmid\fR [\fIoptions\fR] +\fBrmid\fR [\fIoptions\fR] .fi .if n \{\ .RE @@ -64,48 +66,50 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .SH "説明" .PP -\fIrmid\fRコマンドは、起動システム・デーモンを開始します。起動システム・デーモンを開始してからでないと、アクティブ化可能オブジェクトをアクティブ化システムに登録したり、JVM内でアクティブ化したりすることができません。アクティブ化可能なオブジェクトを使用するプログラムの作成方法の詳細は、\fIアクティブ化の使用\fRに関するチュートリアル(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi/activation/overview\&.html)を参照してください +\fBrmid\fRコマンドは、起動システム・デーモンを開始します。起動システム・デーモンを開始してからでないと、アクティブ化可能オブジェクトをアクティブ化システムに登録したり、JVM内でアクティブ化したりすることができません。アクティブ化可能なオブジェクトを使用するプログラムの作成方法の詳細は、\fIアクティブ化の使用\fRに関するチュートリアル(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi/activation/overview\&.html)を参照してください .PP -\fIrmid\fRコマンドを実行し、次のようにセキュリティ・ポリシー・ファイルを指定して、デーモンを起動します。 +\fBrmid\fRコマンドを実行し、次のようにセキュリティ・ポリシー・ファイルを指定して、デーモンを起動します。 .sp .if n \{\ .RS 4 .\} .nf -rmid \-J\-Djava\&.security\&.policy=rmid\&.policy +\fBrmid \-J\-Djava\&.security\&.policy=rmid\&.policy\fR + .fi .if n \{\ .RE .\} .PP -\fIrmid\fRコマンドのOracleの実装を実行する場合、デフォルトでは、セキュリティ・ポリシー・ファイルを指定する必要があります。それは、\fIrmid\fRコマンドが起動グループ用にJVMを起動するために各\fIActivationGroupDesc\fR内の情報を使用できるかどうかを検証できるようにするためです特に、\fIActivationGroupDesc\fRコンストラクタに渡される\fICommandEnvironment\fRや任意のプロパティによって指定されるコマンドおよびオプションは、\fIrmid\fRコマンドのセキュリティ・ポリシー・ファイルの中で明示的に許可することが必要になりました。\fIsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値は、起動グループ用にJVMを起動するために\fIActivationGroupDesc\fR内の情報を使用できるかどうかを判断するときに\fIrmid\fRコマンドが使用するポリシーを決定します。詳細は、\-J\-Dsun\&.rmi\&.activation\&.execPolicy=policyオプションの説明を参照してください。 +\fBrmid\fRコマンドのOracleの実装を実行する場合、デフォルトでは、セキュリティ・ポリシー・ファイルを指定する必要があります。それは、\fBrmid\fRコマンドが起動グループ用にJVMを起動するために各\fBActivationGroupDesc\fR内の情報を使用できるかどうかを検証できるようにするためです特に、\fBActivationGroupDesc\fRコンストラクタに渡される\fBCommandEnvironment\fRや任意のプロパティによって指定されるコマンドおよびオプションは、\fBrmid\fRコマンドのセキュリティ・ポリシー・ファイルの中で明示的に許可することが必要になりました。\fBsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値は、起動グループ用にJVMを起動するために\fBActivationGroupDesc\fR内の情報を使用できるかどうかを判断するときに\fBrmid\fRコマンドが使用するポリシーを決定します。詳細は、\-J\-Dsun\&.rmi\&.activation\&.execPolicy=policyオプションの説明を参照してください。 .PP -\fIrmid\fRコマンドを実行すると、デフォルト・ポート1098でアクティベータと内部レジストリが起動され、\fIActivationSystem\fRがこの内部レジストリ内の名前\fIjava\&.rmi\&.activation\&.ActivationSystem\fRにバインドされます。 +\fBrmid\fRコマンドを実行すると、デフォルト・ポート1098でアクティベータと内部レジストリが起動され、\fBActivationSystem\fRがこの内部レジストリ内の名前\fBjava\&.rmi\&.activation\&.ActivationSystem\fRにバインドされます。 .PP -レジストリに他のポートを指定するには、\fIrmid\fRコマンドの実行時に\fI\-port\fRオプションを指定する必要があります。たとえば、次のコマンドは、レジストリのデフォルト・ポート1099で、起動システム・デーモンとレジストリを起動します。 +レジストリに他のポートを指定するには、\fBrmid\fRコマンドの実行時に\fB\-port\fRオプションを指定する必要があります。たとえば、次のコマンドは、レジストリのデフォルト・ポート1099で、起動システム・デーモンとレジストリを起動します。 .sp .if n \{\ .RS 4 .\} .nf -rmid \-J\-Djava\&.security\&.policy=rmid\&.policy \-port 1099 +\fBrmid \-J\-Djava\&.security\&.policy=rmid\&.policy \-port 1099\fR + .fi .if n \{\ .RE .\} .SH "必要に応じてRMIDを開始" .PP -\fIrmid\fRをコマンドラインから開始するには、\fIinetd\fR -(Oracle Solarisの場合)、または\fIxinetd\fR -(Linuxの場合)を構成して\fIrmid\fRを必要に応じて開始する方法もあります。 +\fBrmid\fRをコマンド行から開始するには、\fBinetd\fR +(Oracle Solarisの場合)、または\fBxinetd\fR +(Linuxの場合)を構成して\fBrmid\fRを必要に応じて開始する方法もあります。 .PP -RMIDを開始すると、\fISystem\&.inheritedChannel\fRメソッドを呼び出して、継承されたチャンネル(\fIinetd\fR/\fIxinetd\fRから継承)を取得しようとします。継承されたチャンネルがnullであるか、\fIjava\&.nio\&.channels\&.ServerSocketChannel\fRのインスタンスでなかった場合、RMIDはそのチャンネルは\fIinetd\fR/\fIxinetd\fRによって起動されたものではないと判断し、前述のように起動します。 +RMIDを開始すると、\fBSystem\&.inheritedChannel\fRメソッドを呼び出して、継承されたチャンネル(\fBinetd\fR/\fBxinetd\fRから継承)を取得しようとします。継承されたチャンネルがnullであるか、\fBjava\&.nio\&.channels\&.ServerSocketChannel\fRのインスタンスでなかった場合、RMIDはそのチャンネルは\fBinetd\fR/\fBxinetd\fRによって起動されたものではないと判断し、前述のように起動します。 .PP -継承されたチャンネルが\fIServerSocketChannel\fRインスタンスである場合は、RMIDはエクスポートするリモート・オブジェクト、つまり\fIjava\&.rmi\&.activation\&.ActivationSystem\fRがバインドされているレジストリと\fIjava\&.rmi\&.activation\&.Activator\fRリモート・オブジェクトに対するリクエストを受信するサーバー・ソケットとして、\fIServerSocketChannel\fRから取得した\fIjava\&.net\&.ServerSocket\fRを使用します。このモードでは、RMIDの動作は、次のことを除いて、コマンドラインから起動した場合と同じです。 +継承されたチャンネルが\fBServerSocketChannel\fRインスタンスである場合は、RMIDはエクスポートするリモート・オブジェクト、つまり\fBjava\&.rmi\&.activation\&.ActivationSystem\fRがバインドされているレジストリと\fBjava\&.rmi\&.activation\&.Activator\fRリモート・オブジェクトに対するリクエストを受信するサーバー・ソケットとして、\fBServerSocketChannel\fRから取得した\fBjava\&.net\&.ServerSocket\fRを使用します。このモードでは、RMIDの動作は、次のことを除いて、コマンド行から起動した場合と同じです。 .sp .RS 4 .ie n \{\ @@ -115,7 +119,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fISystem\&.err\fRに対する出力は、ファイルにリダイレクトされる。このファイルは\fIjava\&.io\&.tmpdir\fRシステム・プロパティで指定されるディレクトリ(通常は\fI/var/tmp\fRまたは\fI/tmp\fR)にある。ファイル名の接頭辞は\fIrmid\-err\fRで、接尾辞は\fItmp\fRである。 +\fBSystem\&.err\fRに対する出力は、ファイルにリダイレクトされる。このファイルは\fBjava\&.io\&.tmpdir\fRシステム・プロパティで指定されるディレクトリ(通常は\fB/var/tmp\fRまたは\fB/tmp\fR)にある。ファイル名の接頭辞は\fBrmid\-err\fRで、接尾辞は\fBtmp\fRである。 .RE .sp .RS 4 @@ -126,7 +130,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-port\fRオプションは使用できません。このオプションが指定されている場合、RMIDはエラー・メッセージが表示されて終了します。 +\fB\-port\fRオプションは使用できません。このオプションが指定されている場合、RMIDはエラー・メッセージが表示されて終了します。 .RE .sp .RS 4 @@ -137,34 +141,36 @@ .sp -1 .IP \(bu 2.3 .\} -\fI\-log\fRオプションは必須。このオプションが指定されていない場合、RMIDはエラー・メッセージが表示されて終了します。 +\fB\-log\fRオプションは必須。このオプションが指定されていない場合、RMIDはエラー・メッセージが表示されて終了します。 .RE .PP -必要に応じてサービスを開始するように構成する方法の詳細は、\fIinetd\fR -(Oracle Solarisの場合)、または\fIxinetd\fR +必要に応じてサービスを開始するように構成する方法の詳細は、\fBinetd\fR +(Oracle Solarisの場合)、または\fBxinetd\fR (Linux)のマニュアル・ページを参照してください。 .SH "オプション" .PP \-C\fIオプション\fR .RS 4 -\fIrmid\fRコマンドの子プロセス(起動グループ)が作成されたときに、それぞれの子プロセスにコマンドライン引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム・デーモンによって生成される各仮想マシンにプロパティを渡すことができます。 +\fBrmid\fRコマンドの子プロセス(起動グループ)が作成されたときに、それぞれの子プロセスにコマンド行引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム・デーモンによって生成される各仮想マシンにプロパティを渡すことができます。 .sp .if n \{\ .RS 4 .\} .nf -rmid \-C\-Dsome\&.property=value +\fBrmid \-C\-Dsome\&.property=value\fR + .fi .if n \{\ .RE .\} -コマンドライン引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のコマンドでは、すべての子JVMでserver\-callロギングが可能です。 +コマンド行引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のコマンドでは、すべての子JVMでserver\-callロギングが可能です。 .sp .if n \{\ .RS 4 .\} .nf -rmid \-C\-Djava\&.rmi\&.server\&.logCalls=true +\fBrmid \-C\-Djava\&.rmi\&.server\&.logCalls=true\fR + .fi .if n \{\ .RE @@ -173,13 +179,14 @@ .PP \-J\fIoption\fR .RS 4 -RMIDを実行しているJavaインタプリタに渡すオプションを指定します。たとえば、\fIrmid\fRコマンドが\fIrmid\&.policy\fRという名前のポリシー・ファイルを使用するように指定するには、\fIrmid\fRのコマンドラインで\fI\-J\fRオプションを使用して、\fIjava\&.security\&.policy\fRプロパティを定義します。次に例を示します。 +RMIDを実行しているJavaインタプリタに渡すオプションを指定します。たとえば、\fBrmid\fRコマンドが\fBrmid\&.policy\fRという名前のポリシー・ファイルを使用するように指定するには、\fBrmid\fRのコマンド行で\fB\-J\fRオプションを使用して、\fBjava\&.security\&.policy\fRプロパティを定義します。次に例を示します。 .sp .if n \{\ .RS 4 .\} .nf -rmid \-J\-Djava\&.security\&.policy\-rmid\&.policy +\fBrmid \-J\-Djava\&.security\&.policy\-rmid\&.policy\fR + .fi .if n \{\ .RE @@ -188,7 +195,7 @@ .PP \-J\-Dsun\&.rmi\&.activation\&.execPolicy=\fIpolicy\fR .RS 4 -起動グループが実行されることになるJVMの起動に使用するコマンドおよびコマンドライン・オプションをチェックするために、RMIDが採用するポリシーを指定します。このオプションは、Java RMI起動デーモンのOracleの実装のみに存在することに注意してください。コマンドラインにこのプロパティを指定しない場合、結果は\fI\-J\-Dsun\&.rmi\&.activation\&.execPolicy=default\fRを指定した場合と同じになります。\fIpolicy\fRに指定可能な値は、\fIdefault\fR、\fIpolicyClassName\fRまたは\fInone\fRです。 +起動グループが実行されることになるJVMの起動に使用するコマンドおよびコマンド行オプションをチェックするために、RMIDが採用するポリシーを指定します。このオプションは、Java RMI起動デーモンのOracleの実装のみに存在することに注意してください。コマンド行にこのプロパティを指定しない場合、結果は\fB\-J\-Dsun\&.rmi\&.activation\&.execPolicy=default\fRを指定した場合と同じになります。\fBpolicy\fRに指定可能な値は、\fBdefault\fR、\fBpolicyClassName\fRまたは\fBnone\fRです。 .sp .RS 4 .ie n \{\ @@ -200,65 +207,66 @@ .\} デフォルト .sp -\fIdefault\fRまたは未指定値の\fIexecPolicy\fRの場合、\fIrmid\fRコマンドが実行できるのは、\fIrmid\fRコマンドが使用するセキュリティ・ポリシー・ファイルの中で、実行する権限が\fIrmid\fRに与えられているコマンドおよびコマンドライン・オプションのみです。デフォルトの実行ポリシーで使用できるのは、デフォルトの起動グループ実装のみです。 +\fBdefault\fRまたは未指定値の\fBexecPolicy\fRの場合、\fBrmid\fRコマンドが実行できるのは、\fBrmid\fRコマンドが使用するセキュリティ・ポリシー・ファイルの中で、実行する権限が\fBrmid\fRに与えられているコマンドおよびコマンド行オプションのみです。デフォルトの実行ポリシーで使用できるのは、デフォルトの起動グループ実装のみです。 .sp -\fIrmid\fRコマンドは、起動グループ用のJVMを起動するときに、そのグループについて登録された起動グループ記述子である\fIActivationGroupDesc\fR内の情報を使用します。グループ記述子は、\fIActivationGroupDesc\&.CommandEnvironment\fRを指定します(省略可能)。これには、起動グループを開始するコマンドと、そのコマンドラインに追加できるコマンドライン・オプションが含まれています。デフォルトでは、\fIrmid\fRコマンドは\fIjava\&.home\fRにある\fIjava\fRコマンドを使用します。グループ記述子には、コマンドラインにオプションとして追加されるプロパティ・オーバーライドも含まれます(\fI\-D<property>=<value>\fRとして定義されます)。\fIcom\&.sun\&.rmi\&.rmid\&.ExecPermission\fR権限は\fIrmid\fRコマンドに、起動グループを開始するためにグループ記述子の\fICommandEnvironment\fRで指定されたコマンドを実行する権限を付与します。\fIcom\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR権限は起動グループの開始時に、グループ記述子でプロパティ・オーバーライドとして、または\fICommandEnvironment\fRでオプションとして指定されたコマンドライン・オプションを、\fIrmid\fRコマンドが使用することを許可します。\fIrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を付与する場合、権限\fIExecPermission\fRおよび\fIExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります。 +\fBrmid\fRコマンドは、起動グループ用のJVMを起動するときに、そのグループについて登録された起動グループ記述子である\fBActivationGroupDesc\fR内の情報を使用します。グループ記述子は、\fBActivationGroupDesc\&.CommandEnvironment\fRを指定します(省略可能)。これには、起動グループを開始するコマンドと、そのコマンド行に追加できるコマンド行オプションが含まれています。デフォルトでは、\fBrmid\fRコマンドは\fBjava\&.home\fRにある\fBjava\fRコマンドを使用します。グループ記述子には、コマンド行にオプションとして追加されるプロパティ・オーバーライドも含まれます(\fB\-D<property>=<value>\fRとして定義されます)。\fBcom\&.sun\&.rmi\&.rmid\&.ExecPermission\fR権限は\fBrmid\fRコマンドに、起動グループを開始するためにグループ記述子の\fBCommandEnvironment\fRで指定されたコマンドを実行する権限を付与します。\fBcom\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR権限は起動グループの開始時に、グループ記述子でプロパティ・オーバーライドとして、または\fBCommandEnvironment\fRでオプションとして指定されたコマンド行オプションを、\fBrmid\fRコマンドが使用することを許可します。\fBrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を付与する場合、権限\fBExecPermission\fRおよび\fBExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります。 .sp \fBExecPermission\fR .sp -\fIExecPermission\fRクラスは、起動グループを開始するために\fIrmid\fRコマンドが特定のコマンドを実行する権限を表します。 +\fBExecPermission\fRクラスは、起動グループを開始するために\fBrmid\fRコマンドが特定のコマンドを実行する権限を表します。 .sp \fB構文\fR: -\fIExecPermission\fRの名前は、\fIrmid\fRコマンドに実行を許可するコマンドのパス名です。スラッシュ(/)およびアスタリスク(*)で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。スラッシュはファイル区切り文字\fIFile\&.separatorChar\fRです。スラッシュ(/)およびマイナス符号(\-)で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ(再帰的に)を示します。パス名に特別なトークン\fI<<ALL FILES>>\fRを指定した場合は、任意のファイルを示します。 +\fBExecPermission\fRの名前は、\fBrmid\fRコマンドに実行を許可するコマンドのパス名です。スラッシュ(/)およびアスタリスク(*)で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。スラッシュはファイル区切り文字\fBFile\&.separatorChar\fRです。スラッシュ(/)およびマイナス符号(\-)で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ(再帰的に)を示します。特殊なトークン\fB<<ALL FILES>>\fRで構成されるパス名は、どのファイルとも一致します。 .sp パス名にアスタリスク(*)を指定した場合は、現在のディレクトリ内のすべてのファイルを示します。パス名にマイナス符号(\-)を指定した場合は、現在のディレクトリ内のすべてのファイルおよび(再帰的に)現在のディレクトリに含まれるすべてのファイルとサブディレクトリを示します。 .sp \fBExecOptionPermission\fR .sp -\fIExecOptionPermission\fRクラスは、起動グループを開始するときに\fIrmid\fRコマンドで特定のコマンドライン・オプションを使用できる権限を表します。\fIExecOptionPermission\fRの名前は、コマンドライン・オプションの値です。 +\fBExecOptionPermission\fRクラスは、起動グループを開始するときに\fBrmid\fRコマンドで特定のコマンド行オプションを使用できる権限を表します。\fBExecOptionPermission\fRの名前は、コマンド行オプションの値です。 .sp \fB構文\fR: オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカード・マッチを表します。アスタリスク(*)は、オプション名そのものとして使用できます。つまり、任意のオプションを表すことができます。また、オプション名の末尾に使用することもできます。ただし、ドット(\&.)か等号(=)の直後にアスタリスク(*)を指定する必要があります。 .sp 例: -\fI*\fRや\fI\-Dmydir\&.*\fRや\fI\-Da\&.b\&.c=*\fRは有効ですが、\fI*mydir\fRや\fI\-Da*b\fRや\fIab*\fRは無効です。 +\fB*\fRや\fB\-Dmydir\&.*\fRや\fB\-Da\&.b\&.c=*\fRは有効ですが、\fB*mydir\fRや\fB\-Da*b\fRや\fBab*\fRは無効です。 .sp \fBrmidのポリシー・ファイル\fR .sp -\fIrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を許可する場合は、権限\fIExecPermission\fRおよび\fIExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります(汎用的に)。これらの権限をチェックするのは\fIrmid\fRコマンドのみなので、これらの権限を汎用的に付与しても安全です。 +\fBrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を許可する場合は、権限\fBExecPermission\fRおよび\fBExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります(汎用的に)。これらの権限をチェックするのは\fBrmid\fRコマンドのみなので、これらの権限を汎用的に付与しても安全です。 .sp -\fIrmid\fRコマンドに各種の実行権限を付与するポリシー・ファイルの例を、次に示します。 +\fBrmid\fRコマンドに各種の実行権限を付与するポリシー・ファイルの例を、次に示します。 .sp .if n \{\ .RS 4 .\} .nf -grant { - permission com\&.sun\&.rmi\&.rmid\&.ExecPermission - "/files/apps/java/jdk1\&.7\&.0/solaris/bin/java"; - - permission com\&.sun\&.rmi\&.rmid\&.ExecPermission - "/files/apps/rmidcmds/*"; +\fBgrant {\fR +\fB permission com\&.sun\&.rmi\&.rmid\&.ExecPermission\fR +\fB "/files/apps/java/jdk1\&.7\&.0/solaris/bin/java";\fR +\fB \fR +\fB permission com\&.sun\&.rmi\&.rmid\&.ExecPermission\fR +\fB "/files/apps/rmidcmds/*";\fR +\fB \fR +\fB permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR +\fB "\-Djava\&.security\&.policy=/files/policies/group\&.policy";\fR +\fB \fR +\fB permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR +\fB "\-Djava\&.security\&.debug=*";\fR +\fB \fR +\fB permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR +\fB "\-Dsun\&.rmi\&.*";\fR +\fB};\fR - permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission - "\-Djava\&.security\&.policy=/files/policies/group\&.policy"; - - permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission - "\-Djava\&.security\&.debug=*"; - - permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission - "\-Dsun\&.rmi\&.*"; -}; .fi .if n \{\ .RE .\} -最初に付与されている権限は、\fIrmid\fRコマンドに対し、パス名により明示的に指定される\fIjava\fRコマンドの1\&.7\&.0リリースの実行を許可します。デフォルトでは、\fIjava\&.home\fRにあるバージョンの\fIjava\fRコマンドを使用します。\fIrmid\fRコマンドが使用するのと同じバージョンが使用されるため、そのコマンドは、ポリシー・ファイルで指定する必要はありません。2番目の権限は、\fIrmid\fRコマンドに対して、ディレクトリ\fI/files/apps/rmidcmds\fR内の任意のコマンドの実行権限を許可します。 +最初に付与されている権限は、\fBrmid\fRコマンドに対し、パス名により明示的に指定される\fBjava\fRコマンドの1\&.7\&.0リリースの実行を許可します。デフォルトでは、\fBjava\&.home\fRにあるバージョンの\fBjava\fRコマンドを使用します。\fBrmid\fRコマンドが使用するのと同じバージョンが使用されるため、そのコマンドは、ポリシー・ファイルで指定する必要はありません。2番目の権限は、\fBrmid\fRコマンドに対して、ディレクトリ\fB/files/apps/rmidcmds\fR内の任意のコマンドの実行権限を許可します。 .sp -3番目に付与されている権限\fIExecOptionPermission\fRは、\fIrmid\fRコマンドに対して、セキュリティ・ポリシー・ファイルを\fI/files/policies/group\&.policy\fRとして定義している起動グループの開始を許可します。次の権限は、起動グループが\fIjava\&.security\&.debug property\fRを使用することを許可しています。最後の権限は、起動グループが\fIsun\&.rmi property\fR名の階層内の任意のプロパティを使用することを許可しています。 +3番目に付与されている権限\fBExecOptionPermission\fRは、\fBrmid\fRコマンドに対して、セキュリティ・ポリシー・ファイルを\fB/files/policies/group\&.policy\fRとして定義している起動グループの開始を許可します。次の権限は、起動グループが\fBjava\&.security\&.debug property\fRを使用することを許可しています。最後の権限は、起動グループが\fBsun\&.rmi property\fR名の階層内の任意のプロパティを使用することを許可しています。 .sp -ポリシー・ファイルを指定して\fIrmid\fRコマンドを起動するには、\fIrmid\fRのコマンドラインで\fIjava\&.security\&.policy\fRプロパティを指定する必要があります。次に例を示します。 +ポリシー・ファイルを指定して\fBrmid\fRコマンドを起動するには、\fBrmid\fRのコマンド行で\fBjava\&.security\&.policy\fRプロパティを指定する必要があります。次に例を示します。 .sp -\fIrmid \-J\-Djava\&.security\&.policy=rmid\&.policy\fR\&. +\fBrmid \-J\-Djava\&.security\&.policy=rmid\&.policy\fR\&. .RE .sp .RS 4 @@ -271,21 +279,22 @@ .\} <policyClassName> .sp -デフォルトの動作では十分な柔軟性が得られない場合、管理者は、\fIrmid\fRの起動時に、\fIcheckExecCommand\fRメソッドが所属するクラスの名前を指定して、\fIrmid\fRコマンドが実行するコマンドをチェックすることができます。 +デフォルトの動作では十分な柔軟性が得られない場合、管理者は、\fBrmid\fRの起動時に、\fBcheckExecCommand\fRメソッドが所属するクラスの名前を指定して、\fBrmid\fRコマンドが実行するコマンドをチェックすることができます。 .sp -\fIpolicyClassName\fRには、引数なしのコンストラクタを持ち、次のような\fIcheckExecCommand\fRメソッドを実装しているpublicクラスを指定します。 +\fBpolicyClassName\fRには、引数なしのコンストラクタを持ち、次のような\fBcheckExecCommand\fRメソッドを実装しているpublicクラスを指定します。 .sp .if n \{\ .RS 4 .\} .nf - public void checkExecCommand(ActivationGroupDesc desc, String[] command) - throws SecurityException; +\fB public void checkExecCommand(ActivationGroupDesc desc, String[] command)\fR +\fB throws SecurityException;\fR + .fi .if n \{\ .RE .\} -起動グループを開始する前に、\fIrmid\fRコマンドは、ポリシーの\fIcheckExecCommand\fRメソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。\fIcheckExecCommand\fRが\fISecurityException\fRをスローすると、\fIrmid\fRコマンドはその起動グループを開始せず、オブジェクトの起動を試行している呼出し側には\fIActivationException\fRがスローされます。 +起動グループを開始する前に、\fBrmid\fRコマンドは、ポリシーの\fBcheckExecCommand\fRメソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。\fBcheckExecCommand\fRが\fBSecurityException\fRをスローすると、\fBrmid\fRコマンドはその起動グループを開始せず、オブジェクトの起動を試行している呼出し側には\fBActivationException\fRがスローされます。 .RE .sp .RS 4 @@ -298,28 +307,29 @@ .\} none .sp -\fIsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値が\fInone\fRの場合、\fIrmid\fRコマンドは、起動グループを開始するコマンドをまったく検証しません。 +\fBsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値が\fBnone\fRの場合、\fBrmid\fRコマンドは、起動グループを開始するコマンドをまったく検証しません。 .RE .RE .PP \-log \fIdir\fR .RS 4 -起動システム・デーモンがデータベースおよび関連情報を書き込むのに使用するディレクトリの名前を指定します。デフォルトでは、\fIrmid\fRコマンドを実行したディレクトリに、logというログ・ディレクトリが作成されます。 +起動システム・デーモンがデータベースおよび関連情報を書き込むのに使用するディレクトリの名前を指定します。デフォルトでは、\fBrmid\fRコマンドを実行したディレクトリに、logというログ・ディレクトリが作成されます。 .RE .PP \-port \fIport\fR .RS 4 -レジストリが使用するポートを指定します。起動システム・デーモンは、このレジストリの中で、\fIjava\&.rmi\&.activation\&.ActivationSystem\fRという名前で\fIActivationSystem\fRをバインドします。ローカル・マシン上の\fIActivationSystem\fRは、次のように\fINaming\&.lookup\fRメソッドを呼び出すことによって取得できます。 +レジストリが使用するポートを指定します。起動システム・デーモンは、このレジストリの中で、\fBjava\&.rmi\&.activation\&.ActivationSystem\fRという名前で\fBActivationSystem\fRをバインドします。ローカル・マシン上の\fBActivationSystem\fRは、次のように\fBNaming\&.lookup\fRメソッドを呼び出すことによって取得できます。 .sp .if n \{\ .RS 4 .\} .nf -import java\&.rmi\&.*; - import java\&.rmi\&.activation\&.*; +\fBimport java\&.rmi\&.*; \fR +\fB import java\&.rmi\&.activation\&.*;\fR +\fB \fR +\fB ActivationSystem system; system = (ActivationSystem)\fR +\fB Naming\&.lookup("//:port/java\&.rmi\&.activation\&.ActivationSystem");\fR - ActivationSystem system; system = (ActivationSystem) - Naming\&.lookup("//:port/java\&.rmi\&.activation\&.ActivationSystem"); .fi .if n \{\ .RE @@ -328,14 +338,14 @@ .PP \-stop .RS 4 -\fI\-port\fRオプションによって指定されたポートの、現在の\fIrmid\fRコマンドの呼出しを停止します。ポートが指定されていない場合は、このオプションはポート1098で実行されている\fIrmid\fRの呼出しを停止します。 +\fB\-port\fRオプションによって指定されたポートの、現在の\fBrmid\fRコマンドの呼出しを停止します。ポートが指定されていない場合は、このオプションはポート1098で実行されている\fBrmid\fRの呼出しを停止します。 .RE .SH "環境変数" .PP CLASSPATH .RS 4 ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで区切られます。例: -\fI\&.:/usr/local/java/classes\fR +\fB\&.:/usr/local/java/classes\fR .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/rmiregistry.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/rmiregistry.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: rmiregistry -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Remote Method Invocation (RMI)ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: rmiregistry +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Remote Method Invocation (RMI)ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "rmiregistry" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" rmiregistry \- 現在のホストの指定したポート上にリモート・オブジェクト・レジストリを開始します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIrmiregistry\fR [ \fIport\fR ] +\fBrmiregistry\fR [ \fIport\fR ] .fi .if n \{\ .RE @@ -64,17 +66,18 @@ .PP \fIport\fR .RS 4 -リモート・オブジェクト・レジストリを開始する現在のホスト上の\fIport\fRの数。 +リモート・オブジェクト・レジストリを開始する現在のホスト上の\fBport\fRの数。 .RE .SH "説明" .PP -\fIrmiregistry\fRコマンドは、現在のホストの指定したポート上にリモート・オブジェクト・レジストリを作成し、開始します。portの指定を省略した場合、レジストリはポート1099で開始します。\fIrmiregistry\fRコマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。次に例を示します。 +\fBrmiregistry\fRコマンドは、現在のホストの指定したポート上にリモート・オブジェクト・レジストリを作成し、開始します。portの指定を省略した場合、レジストリはポート1099で開始します。\fBrmiregistry\fRコマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。次に例を示します。 .sp .if n \{\ .RS 4 .\} .nf -rmiregistry & +\fBrmiregistry &\fR + .fi .if n \{\ .RE @@ -84,14 +87,14 @@ .PP レジストリは、一般的に、最初のリモート・オブジェクトの位置を指定します。そこで、アプリケーションはメソッドを呼び出す必要があります。その後、そのオブジェクトはアプリケーション指定のサポートを提供し、他のオブジェクトを探します。 .PP -\fIjava\&.rmi\&.registry\&.LocateRegistry\fRクラスのメソッドは、ローカル・ホスト、またはローカル・ホストとポートで動作するレジストリを取得するために使用されます。 +\fBjava\&.rmi\&.registry\&.LocateRegistry\fRクラスのメソッドは、ローカル・ホスト、またはローカル・ホストとポートで動作するレジストリを取得するために使用されます。 .PP -\fIjava\&.rmi\&.Naming\fRクラスのURLベース・メソッドはレジストリに対して操作を実行し、任意のホストおよびローカル・ホストでのリモート・オブジェクトの検索に使用できます。単純名(文字列)をリモート・オブジェクトにバインドし、新しい名前をリモート・オブジェクトに再バインドし(古いバインドをオーバーライド)、リモート・オブジェクトをアンバインドし、レジストリにバインドされているURLをリスト表示します。 +\fBjava\&.rmi\&.Naming\fRクラスのURLベース・メソッドはレジストリに対して操作を実行し、任意のホストおよびローカル・ホストでのリモート・オブジェクトの検索に使用できます。単純名(文字列)をリモート・オブジェクトにバインドし、新しい名前をリモート・オブジェクトに再バインドし(古いバインドをオーバーライド)、リモート・オブジェクトをアンバインドし、レジストリにバインドされているURLをリスト表示します。 .SH "オプション" .PP \-J .RS 4 -Javaオプションとともに使用して、\fI\-J\fRの後ろに続くオプションをJavaインタプリタに引き渡します(\fI\-J\fRとオプションの間にスペースは入れません)。 +Javaオプションとともに使用して、\fB\-J\fRの後ろに続くオプションをJavaインタプリタに引き渡します(\fB\-J\fRとオプションの間にスペースは入れません)。 .RE .SH "関連項目" .sp @@ -114,7 +117,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI「java\&.rmi\&.registry\&.LocateRegistry」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/registry/LocateRegistry\&.html) +\fB「java\&.rmi\&.registry\&.LocateRegistry」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/registry/LocateRegistry\&.html) .RE .sp .RS 4 @@ -125,7 +128,7 @@ .sp -1 .IP \(bu 2.3 .\} -\fI「java\&.rmi\&.Naming class description」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/Naming\&.html) +\fB「java\&.rmi\&.Naming class description」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/Naming\&.html) .RE .br 'pl 8.5i
--- a/src/solaris/doc/sun/man/man1/ja/schemagen.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/schemagen.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: schemagen -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java Webサービス・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: schemagen +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java Webサービス・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "schemagen" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" schemagen \- Javaクラス内で参照されているネームスペースごとにスキーマを生成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIschemagen\fR [ \fIoptions\fR ] \fIjava\-files\fR +\fBschemagen\fR [ \fIoptions\fR ] \fIjava\-files\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIjava\-files\fR @@ -76,40 +78,41 @@ スキーマ・ジェネレータは、Javaクラス内で参照されているネームスペースごとに1つのスキーマ・ファイルを作成します。現在、生成されるスキーマ・ファイルの名前は制御できません。スキーマ・ファイル名を制御する場合は、http://jaxb\&.java\&.net/nonav/2\&.2\&.3u1/docs/schemagenTask\&.htmlにある 「Using SchemaGen with Ant」を参照してください .PP -プラットフォームのbinディレクトリにある適切な\fIschemagen\fRシェル・スクリプトを使用して、スキーマ・ジェネレータを起動します。現在のスキーマ・ジェネレータは、Javaソース・ファイルとクラス・ファイルのいずれも処理できます。 +プラットフォームのbinディレクトリにある適切な\fBschemagen\fRシェル・スクリプトを使用して、スキーマ・ジェネレータを起動します。現在のスキーマ・ジェネレータは、Javaソース・ファイルとクラス・ファイルのいずれも処理できます。 .sp .if n \{\ .RS 4 .\} .nf -schemagen\&.sh Foo\&.java Bar\&.java \&.\&.\&. -Note: Writing schema1\&.xsd +\fBschemagen\&.sh Foo\&.java Bar\&.java \&.\&.\&.\fR +\fBNote: Writing schema1\&.xsd\fR + .fi .if n \{\ .RE .\} .PP -javaファイルが他のクラスを参照している場合、それらのクラスにシステム\fICLASSPATH\fR環境変数でアクセスできる必要があります。または、クラス・パス・オプションを指定して\fIschemagen\fRコマンド・ラインで指定する必要があります。オプションを参照してください。参照されるファイルにアクセスできない、または参照されるファイルが指定されていない場合、スキーマの生成時にエラーが表示されます。 +javaファイルが他のクラスを参照している場合、それらのクラスにシステム\fBCLASSPATH\fR環境変数でアクセスできる必要があります。または、クラス・パス・オプションを指定して\fBschemagen\fRコマンド行で指定する必要があります。オプションを参照してください。参照されるファイルにアクセスできない、または参照されるファイルが指定されていない場合、スキーマの生成時にエラーが表示されます。 .SH "オプション" .PP \-d \fIpath\fR .RS 4 -\fIschemagen\fRコマンドがプロセッサ生成および\fIjavac\fR生成クラス・ファイルを配置する場所。 +\fBschemagen\fRコマンドがプロセッサ生成および\fBjavac\fR生成クラス・ファイルを配置する場所。 .RE .PP \-cp \fIpath\fR .RS 4 -\fIschemagen\fRコマンドがユーザー指定ファイルを配置する場所。 +\fBschemagen\fRコマンドがユーザー指定ファイルを配置する場所。 .RE .PP \-classpath \fIpath\fR .RS 4 -\fIschemagen\fRコマンドがユーザー指定ファイルを配置する場所。 +\fBschemagen\fRコマンドがユーザー指定ファイルを配置する場所。 .RE .PP \-encoding \fIencoding\fR .RS 4 -\fIapt\fRまたは\fIjavac\fRコマンドの呼出しに使用するエンコーディングを指定します。 +\fBapt\fRまたは\fBjavac\fRコマンドの呼出しに使用するエンコーディングを指定します。 .RE .PP \-episode \fIfile\fR
--- a/src/solaris/doc/sun/man/man1/ja/serialver.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/serialver.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: serialver -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Remote Method Invocation (RMI)ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: serialver +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Remote Method Invocation (RMI)ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "serialver" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" serialver \- 指定したクラスのシリアル・バージョンUIDを戻します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIserialver\fR [ \fIoptions\fR ] [ \fIclassnames\fR ] +\fBserialver\fR [ \fIoptions\fR ] [ \fIclassnames\fR ] .fi .if n \{\ .RE @@ -64,16 +66,16 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIclassnames\fR .RS 4 -\fIserialVersionUID\fRを戻すクラスです。 +\fBserialVersionUID\fRを戻すクラスです。 .RE .SH "説明" .PP -\fIserialver\fRコマンドは、1つ以上のクラスの\fIserialVersionUID\fRを、展開しているクラスへコピーするのに適した形式で返します。引数なしで呼び出された場合、\fIserialver\fRコマンドは使用率行を出力します。 +\fBserialver\fRコマンドは、1つ以上のクラスの\fBserialVersionUID\fRを、展開しているクラスへコピーするのに適した形式で返します。引数なしで呼び出された場合、\fBserialver\fRコマンドは使用率行を出力します。 .SH "オプション" .PP \-classpath \fIpath\-files\fR @@ -83,22 +85,23 @@ .PP \-show .RS 4 -簡単なユーザー・インタフェースを表示します。完全指定のクラス名を入力して、Enterキーか「表示」ボタンを押し、\fIserialVersionUID\fRを表示します。 +簡単なユーザー・インタフェースを表示します。完全指定のクラス名を入力して、Enterキーか「表示」ボタンを押し、\fBserialVersionUID\fRを表示します。 .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシンに\fIoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineに\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "注意" .PP -\fIserialver\fRコマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティ・マネージャの設定は行いません。信頼できないクラスとともに\fIserialver\fRコマンドを実行する場合には、次のオプションを使用してセキュリティ・マネージャを設定できます。 +\fBserialver\fRコマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティ・マネージャの設定は行いません。信頼できないクラスとともに\fBserialver\fRコマンドを実行する場合には、次のオプションを使用してセキュリティ・マネージャを設定できます。 .sp .if n \{\ .RS 4 .\} .nf -\-J\-Djava\&.security\&.manager +\fB\-J\-Djava\&.security\&.manager\fR + .fi .if n \{\ .RE @@ -110,7 +113,8 @@ .RS 4 .\} .nf -\-J\-Djava\&.security\&.policy=<policy file> +\fB\-J\-Djava\&.security\&.policy=<policy file>\fR + .fi .if n \{\ .RE @@ -137,7 +141,7 @@ .IP \(bu 2.3 .\} http://docs\&.oracle\&.com/javase/8/docs/api/java/io/ObjectStreamClass\&.htmlにある -\fIjava\&.io\&.ObjectStream\fRクラス記述 +\fBjava\&.io\&.ObjectStream\fRクラス記述 .RE .br 'pl 8.5i
--- a/src/solaris/doc/sun/man/man1/ja/servertool.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/servertool.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: servertool -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java IDLおよびRMI-IIOPツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: servertool +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java IDLおよびRMI-IIOPツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "servertool" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" servertool \- 開発者が永続サーバーを登録、登録解除、起動、停止するための使いやすいユーザー・インタフェースを提供します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIservertool\fR \-ORBInitialPort \fInameserverport\fR [ \fIoptions\fR ] [ \fIcommands \fR] +\fBservertool\fR \-ORBInitialPort \fInameserverport\fR [ \fIoptions\fR ] [ \fIcommands \fR] .fi .if n \{\ .RE @@ -64,35 +66,35 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP commands .RS 4 -コマンドライン・コマンド。コマンドを参照してください。 +コマンド行コマンド。コマンドを参照してください。 .RE .PP -\fIservertool\fR\fIservertool >\fR\fIservertool >\fR +\fBservertool\fR\fBservertool >\fR\fBservertool >\fR .SH "説明" .PP -\fIservertool\fRコマンドは、開発者が永続サーバーを登録、登録解除、起動、停止するためのコマンドライン・インタフェースを提供します。コマンドライン・コマンドを使用すると、サーバーに関する様々な統計情報を取得できます。コマンドを参照してください。 +\fBservertool\fRコマンドは、開発者が永続サーバーを登録、登録解除、起動、停止するためのコマンド行インタフェースを提供します。コマンド行コマンドを使用すると、サーバーに関する様々な統計情報を取得できます。コマンドを参照してください。 .SH "オプション" .PP \-ORBInitialHost \fInameserverhost\fR .RS 4 -このオプションは必須です。ネーム・サーバーが実行され、着信リクエストをリスニングするホスト・マシンを指定します。\fInameserverhost\fR値は、\fIorb\fRが実行され、リクエストをリスニングしているポートを指定する必要があります。このオプションを指定しない場合、値はデフォルトで\fIlocalhost\fRに設定されます。\fIorbd\fRと\fIservertool\fRが異なるマシン上で実行されている場合は、\fIorbd\fRが実行されているホストの名前またはIPアドレスを指定する必要があります。 +このオプションは必須です。ネーム・サーバーが実行され、着信リクエストをリスニングするホスト・マシンを指定します。\fBnameserverhost\fR値は、\fBorb\fRが実行され、リクエストをリスニングしているポートを指定する必要があります。このオプションを指定しない場合、値はデフォルトで\fBlocalhost\fRに設定されます。\fBorbd\fRと\fBservertool\fRが異なるマシン上で実行されている場合は、\fBorbd\fRが実行されているホストの名前またはIPアドレスを指定する必要があります。 .sp \fB注意:\fR -Oracle Solarisでは、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。\fInameserverport\fR値には、1024以上のポート番号を使用することをお薦めします。 +Oracle Solarisでは、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。\fBnameserverport\fR値には、1024以上のポート番号を使用することをお薦めします。 .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "コマンド" .PP -\fIservertool\fRコマンドは、コマンドライン・コマンドを使用して、または使用せずに起動できます。 +\fBservertool\fRコマンドは、コマンド行コマンドを使用して、または使用せずに起動できます。 .sp .RS 4 .ie n \{\ @@ -102,8 +104,8 @@ .sp -1 .IP \(bu 2.3 .\} -\fIservertool\fRの起動時にコマンドを指定しなかった場合、コマンドライン・ツールにコマンド入力を求める\fIservertool\fRプロンプトが表示されます: -\fIservertool >\fR。 +\fBservertool\fRの起動時にコマンドを指定しなかった場合、コマンド行ツールにコマンド入力を求める\fBservertool\fRプロンプトが表示されます: +\fBservertool >\fR。 .RE .sp .RS 4 @@ -114,23 +116,23 @@ .sp -1 .IP \(bu 2.3 .\} -\fIservertool\fRの起動時にコマンドを指定した場合、Java IDL Server Toolが起動してコマンドを実行し、終了します。 +\fBservertool\fRの起動時にコマンドを指定した場合、Java IDL Server Toolが起動してコマンドを実行し、終了します。 .RE .PP register \-server \fIserver\-class\-name\fR \-classpath \fIclasspath\-to\-server\fR [ \-applicationName \fIapplication\-name\fR \-args \fIargs\-to\-server\fR \-vmargs \fIflags\-for\-JVM\fR ] .RS 4 -Object Request Broker Daemon (ORBD)に新規永続サーバーを登録します。サーバーが未登録の場合、登録してアクティブ化します。このコマンドによって、\fI\-server\fRオプションで識別されるサーバーの\fIメイン\fR・クラス内でインストール・メソッドが呼び出されます。このインストール・メソッドは、\fIpublic static void install(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。インストール・メソッドはオプションであり、開発者はデータベース・スキーマの作成など独自のサーバー・インストール動作を指定できます。 +Object Request Broker Daemon (ORBD)に新規永続サーバーを登録します。サーバーが未登録の場合、登録してアクティブ化します。このコマンドによって、\fB\-server\fRオプションで識別されるサーバーの\fBメイン\fR・クラス内でインストール・メソッドが呼び出されます。このインストール・メソッドは、\fBpublic static void install(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。インストール・メソッドはオプションであり、開発者はデータベース・スキーマの作成など独自のサーバー・インストール動作を指定できます。 .RE .PP unregister \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR .RS 4 -サーバーIDまたはアプリケーション名で、サーバーをORBDから登録解除します。このコマンドによって、\fI\-server\fRオプションで識別されるサーバーの\fIメイン\fR・クラス内でアンインストール・メソッドが呼び出されます。 -\fIuninstall\fRメソッドは、\fIpublic static void uninstall(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。\fIuninstall\fRメソッドはオプションであり、開発者は\fIinstall\fRメソッドの動作の取消など、独自のサーバー・アンインストール動作を指定できます。 +サーバーIDまたはアプリケーション名で、サーバーをORBDから登録解除します。このコマンドによって、\fB\-server\fRオプションで識別されるサーバーの\fBメイン\fR・クラス内でアンインストール・メソッドが呼び出されます。 +\fBuninstall\fRメソッドは、\fBpublic static void uninstall(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。\fBuninstall\fRメソッドはオプションであり、開発者は\fBinstall\fRメソッドの動作の取消など、独自のサーバー・アンインストール動作を指定できます。 .RE .PP getserverid \-applicationName \fIapplication\-name\fR .RS 4 -\fIapplication\-name\fR値に対応するサーバーIDを返します。 +\fBapplication\-name\fR値に対応するサーバーIDを返します。 .RE .PP list @@ -150,22 +152,22 @@ .PP locate \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR [ \-endpointType \fIendpointType\fR ] .RS 4 -登録されたサーバーで作成したすべてのORBの特定のタイプについてエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fIendpointType\fR値が指定されていない場合、サーバーのORBごとに関連付けられているplainタイプまたはnon\-protectedタイプのエンドポイントが返されます。 +登録されたサーバーで作成したすべてのORBの特定のタイプについてエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fBendpointType\fR値が指定されていない場合、サーバーのORBごとに関連付けられているplainタイプまたはnon\-protectedタイプのエンドポイントが返されます。 .RE .PP locateperorb \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR [ \-orbid \fIORB\-name\fR ] .RS 4 -登録されたサーバーの特定のObject Request Broker (ORB)で登録されたエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fIorbid\fRが指定されていない場合、デフォルト値の\fI""\fRが\fIorbid\fRに割り当てられます。ORBが空文字列の\fIorbid\fRで作成されている場合、登録したポートがすべて返されます。 +登録されたサーバーの特定のObject Request Broker (ORB)で登録されたエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fBorbid\fRが指定されていない場合、デフォルト値の\fB""\fRが\fBorbid\fRに割り当てられます。ORBが空文字列の\fBorbid\fRで作成されている場合、登録したポートがすべて返されます。 .RE .PP orblist \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR .RS 4 -サーバー上に定義されたORBの\fIORBId\fRを一覧表示します。\fIORBId\fRはサーバーで作成されたORBの文字列名です。サーバーが実行されていない場合、アクティブ化されます。 +サーバー上に定義されたORBの\fBORBId\fRを一覧表示します。\fBORBId\fRはサーバーで作成されたORBの文字列名です。サーバーが実行されていない場合、アクティブ化されます。 .RE .PP shutdown \-serverid \fIserver\-id\fR | \-applicationName application\-name .RS 4 -ORBDに登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\fI\-serverid\fRパラメータまたは\fI\-applicationName\fRパラメータで指定されたクラス内に定義された\fIshutdown\fRメソッドも呼び出されてサーバー・プロセスを停止します。 +ORBDに登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\fB\-serverid\fRパラメータまたは\fB\-applicationName\fRパラメータで指定されたクラス内に定義された\fBshutdown\fRメソッドも呼び出されてサーバー・プロセスを停止します。 .RE .PP startup \-serverid \fIserver\-id\fR | \-applicationName application\-name @@ -175,12 +177,12 @@ .PP help .RS 4 -\fIservertool\fRコマンドを介してサーバーが利用できるすべてのコマンドをリストします。 +\fBservertool\fRコマンドを介してサーバーが利用できるすべてのコマンドをリストします。 .RE .PP quit .RS 4 -\fIservertool\fRコマンドを終了します。 +\fBservertool\fRコマンドを終了します。 .RE .SH "関連項目" .sp
--- a/src/solaris/doc/sun/man/man1/ja/tnameserv.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/tnameserv.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: tnameserv -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java IDLおよびRMI-IIOPツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 1999, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: tnameserv +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java IDLおよびRMI-IIOPツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "tnameserv" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" tnameserv \- インタフェース定義言語(IDL)。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fItnameserve\fR \fI\-ORBInitialPort\fR [ \fInameserverport\fR ] +\fBtnameserve\fR \fB\-ORBInitialPort\fR [ \fInameserverport\fR ] .fi .if n \{\ .RE @@ -64,16 +66,16 @@ .PP \-ORBInitialPort \fInameserverport\fR .RS 4 -ネーミング・サービスがORBの\fIresolve_initial_references\fRメソッドと\fIlist_initial_references\fRメソッドの実装に使用するブートストラップ・プロトコルをリスニングする初期ポートです。 +ネーミング・サービスがORBの\fBresolve_initial_references\fRメソッドと\fBlist_initial_references\fRメソッドの実装に使用するブートストラップ・プロトコルをリスニングする初期ポートです。 .RE .SH "説明" .PP -Java IDLには、Object Request Broker Daemon (ORBD)が含まれます。ORBDは、ブートストラップ・サービス、一時ネーミング・サービス、永続ネーミング・サービスおよびサーバー・マネージャを含むデーモン・プロセスです。Java IDLのすべてのチュートリアルではORBDを使用していますが、一時ネーミング・サービスを使用する例では、\fIorbd\fRのかわりに\fItnameserv\fRを使用できます。 +Java IDLには、Object Request Broker Daemon (ORBD)が含まれます。ORBDは、ブートストラップ・サービス、一時ネーミング・サービス、永続ネーミング・サービスおよびサーバー・マネージャを含むデーモン・プロセスです。Java IDLのすべてのチュートリアルではORBDを使用していますが、一時ネーミング・サービスを使用する例では、\fBorbd\fRのかわりに\fBtnameserv\fRを使用できます。 .PP -http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlにある -orbd(1)または「Naming Service」を参照してください。 +orbd(1)http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.html +にあるまたは「Naming Service」を参照してください。 .PP -CORBAのCOS (Common Object Services)ネーミング・サービスは、ファイル・システムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDLの一時ネーム・サービスである\fItnameserv\fRは、COSネーム・サービスの仕様を単純な形で実装したものです。 +CORBAのCOS (Common Object Services)ネーミング・サービスは、ファイル・システムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDLの一時ネーム・サービスである\fBtnameserv\fRは、COSネーム・サービスの仕様を単純な形で実装したものです。 .PP オブジェクト参照はネームスペースに名前で格納され、オブジェクト参照と名前のペアは、それぞれネーム・バインディングと呼ばれます。ネーム・バインディングはネーミング・コンテキストに組み込むことができます。ネーミング・コンテキストはネーム・バインディングであり、ファイル・システムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは初期ネーミング・コンテキストの下に格納されます。初期ネーミング・コンテキストは、ネームスペースの唯一の永続バインディングです。Java IDLネーミング・サービス・プロセスを停止して再起動すると、残りのネームスペースは失われます。 .PP @@ -81,28 +83,30 @@ .SS "ネーミング・サービスの起動" .PP Java IDLネーム・サービスは、ネーム・サービスを使用するアプリケーションまたはアプレットより前に起動しておく必要があります。Java IDL製品をインストールすると、Java IDLネーミング・サービスを起動するスクリプト(Oracle Solaris: -\fItnameserv\fR)または実行可能ファイル(Windows: -\fItnameserv\&.exe\fR)が作成されます。バックグラウンドで動作するように、ネーム・サービスを起動してください。 +\fBtnameserv\fR)または実行可能ファイル(Windows: +\fBtnameserv\&.exe\fR)が作成されます。バックグラウンドで動作するように、ネーム・サービスを起動してください。 .PP -特に指定しない場合、Java IDLネーミング・サービスは、ORBの\fIresolve_initial_references\fRメソッドと\fIlist_initial_references methods\fRメソッドの実装に使用するブートストラップ・プロトコルに対してポート900でリスニングします。 +特に指定しない場合、Java IDLネーミング・サービスは、ORBの\fBresolve_initial_references\fRメソッドと\fBlist_initial_references methods\fRメソッドの実装に使用するブートストラップ・プロトコルに対してポート900でリスニングします。 .sp .if n \{\ .RS 4 .\} .nf -tnameserv \-ORBInitialPort nameserverport& +\fBtnameserv \-ORBInitialPort nameserverport&\fR + .fi .if n \{\ .RE .\} .PP -ネーム・サーバー・ポートを指定しない場合、デフォルトでポート900が使用されます。Oracle Solarisソフトウェアの実行時、1024より小さいポートでプロセスを開始する場合は、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。1050のように別のポートを指定し、ネーム・サービスをバックグラウンドで実行するには、UNIXコマンド・シェルで次のように入力します。 +ネーム・サーバー・ポートを指定しない場合、デフォルトでポート900が使用されます。Oracle Solarisソフトウェアの実行時、1024より小さいポートでプロセスを開始する場合は、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。1050のように別のポートを指定し、ネーム・サービスをバックグラウンドで実行するには、Solaris、LinuxまたはOS Xコマンド・シェルで次のように入力します。 .sp .if n \{\ .RS 4 .\} .nf -tnameserv \-ORBInitialPort 1050& +\fBtnameserv \-ORBInitialPort 1050&\fR + .fi .if n \{\ .RE @@ -114,69 +118,73 @@ .RS 4 .\} .nf -start tnameserv \-ORBInitialPort 1050 +\fBstart tnameserv \-ORBInitialPort 1050\fR + .fi .if n \{\ .RE .\} .PP -ネーム・サーバーのクライアントには、新しいポート番号を知らせる必要があります。これを行うには、ORBオブジェクトの作成時に\fIorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティに新しいポート番号を設定します。 +ネーム・サーバーのクライアントには、新しいポート番号を知らせる必要があります。これを行うには、ORBオブジェクトの作成時に\fBorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティに新しいポート番号を設定します。 .SS "異なるホスト上でのサーバーとクライアントの実行" .PP Java IDLとRMI\-IIOPのほとんどのチュートリアルでは、ネーミング・サービス、サーバーおよびクライアントはすべて開発用のマシン上で実行されます。実際にデプロイメントする場合には、クライアントとサーバーを、ネーミング・サービスとは異なるホスト・マシン上で実行することが多くなります。 .PP -クライアントとサーバーがネーム・サービスを見つけるには、クライアントとサーバーが、ネーム・サービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の\fIorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティと\fIorg\&.omg\&.CORBA\&.ORBInitialHost\fRプロパティをネーム・サービスが実行されているポートの番号とマシンの名前に設定します。この例は、「Getting Started Using RMI\-IIOP」 +クライアントとサーバーがネーム・サービスを見つけるには、クライアントとサーバーが、ネーム・サービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の\fBorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティと\fBorg\&.omg\&.CORBA\&.ORBInitialHost\fRプロパティをネーム・サービスが実行されているポートの番号とマシンの名前に設定します。この例は、「Getting Started Using RMI\-IIOP」 (http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi\-iiop/rmiiiopexample\&.html)に示されています .PP -コマンドライン・オプション\fI\-ORBInitialPort nameserverport#\fRと\fI\-ORBInitialHost nameserverhostname\fRを使用して、クライアントとサーバーに対してネーミング・サービスを探す場所を指定することもできます。コマンドライン・オプションを使用してこれを行う方法の1つの例は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/tutorial/jidl2machines\&.htmlの「Java IDL: The Hello World Example on Two Machines」 +コマンド行オプション\fB\-ORBInitialPort nameserverport#\fRと\fB\-ORBInitialHost nameserverhostname\fRを使用して、クライアントとサーバーに対してネーミング・サービスを探す場所を指定することもできます。コマンド行オプションを使用してこれを行う方法の1つの例は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/tutorial/jidl2machines\&.htmlの「Java IDL: The Hello World Example on Two Machines」 を参照してください .PP -たとえば、一時ネーム・サービス\fItnameserv\fRが、ホスト\fInameserverhost\fRのポート1050上で実行されているとします。さらに、クライアントがホスト\fIclienthost\fR上で実行され、サーバーはホスト\fIserverhost\fR上で実行されているとします。 +たとえば、一時ネーム・サービス\fBtnameserv\fRが、ホスト\fBnameserverhost\fRのポート1050上で実行されているとします。さらに、クライアントがホスト\fBclienthost\fR上で実行され、サーバーはホスト\fBserverhost\fR上で実行されているとします。 .PP -ホスト\fInameserverhost\fR上で\fItnameserv\fRを起動します。 +ホスト\fBnameserverhost\fR上で\fBtnameserv\fRを起動します。 .sp .if n \{\ .RS 4 .\} .nf -tnameserv \-ORBInitialPort 1050 +\fBtnameserv \-ORBInitialPort 1050\fR + .fi .if n \{\ .RE .\} .PP -\fIserverhost\fR上でサーバーを起動します。 +\fBserverhost\fR上でサーバーを起動します。 .sp .if n \{\ .RS 4 .\} .nf -java Server \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost +\fBjava Server \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost\fR + .fi .if n \{\ .RE .\} .PP -\fIclienthost\fR上でクライアントを起動します。 +\fBclienthost\fR上でクライアントを起動します。 .sp .if n \{\ .RS 4 .\} .nf -java Client \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost +\fBjava Client \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost\fR + .fi .if n \{\ .RE .\} .SS "ネーミング・サービスの停止" .PP -Java IDLネーミング・サービスを停止するには、Unixの場合は、\fIkill\fRなどのオペレーティング・システムのコマンドを使用し、Windowsの場合は、\fI[Ctrl]+[C]\fRキーを使用します。ネーミング・サービスを明示的に停止するまでは、呼出し待機状態が続きます。サービスを終了させると、Java IDLネーム・サービスに登録されている名前は失われます。 +Java IDLネーミング・サービスを停止するには、Solaris、LinuxまたはOS Xの場合は、\fBkill\fRなどのオペレーティング・システムのコマンドを使用し、Windowsの場合は、\fB[Ctrl]+[C]\fRキーを使用します。ネーミング・サービスを明示的に停止するまでは、呼出し待機状態が続きます。サービスを終了させると、Java IDLネーム・サービスに登録されている名前は失われます。 .SH "オプション" .PP \-J\fIoption\fR .RS 4 -Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "例" .SS "ネームスペースへのオブジェクトの追加" @@ -187,115 +195,122 @@ .RS 4 .\} .nf -Initial Naming Context - plans - Personal - calendar - schedule +\fBInitial Naming Context\fR +\fB plans\fR +\fB Personal\fR +\fB calendar\fR +\fB schedule\fR + .fi .if n \{\ .RE .\} .PP -この例で、\fIplans\fRはオブジェクト参照、\fIPersonal\fRは\fIcalendar\fRと\fIschedule\fRの2つのオブジェクト参照を含むネーミング・コンテキストです。 +この例で、\fBplans\fRはオブジェクト参照、\fBPersonal\fRは\fBcalendar\fRと\fBschedule\fRの2つのオブジェクト参照を含むネーミング・コンテキストです。 .sp .if n \{\ .RS 4 .\} .nf -import java\&.util\&.Properties; -import org\&.omg\&.CORBA\&.*; -import org\&.omg\&.CosNaming\&.*; +\fBimport java\&.util\&.Properties;\fR +\fBimport org\&.omg\&.CORBA\&.*;\fR +\fBimport org\&.omg\&.CosNaming\&.*;\fR +\fB \fR +\fBpublic class NameClient {\fR -public class NameClient { - - public static void main(String args[]) { - - try { +\fB public static void main(String args[]) {\fR + +\fB try {\fR + .fi .if n \{\ .RE .\} .PP -ネーミング・サービスの起動で、\fInameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。 +ネーミング・サービスの起動で、\fBnameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。 .sp .if n \{\ .RS 4 .\} .nf - Properties props = new Properties(); - props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050"); - ORB orb = ORB\&.init(args, props); +\fB Properties props = new Properties();\fR +\fB props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fR +\fB ORB orb = ORB\&.init(args, props);\fR + .fi .if n \{\ .RE .\} .PP -次のコードでは、初期ネーミング・コンテキストを取得し、それを\fIctx\fRに代入します。2行目では、\fIctx\fRをダミーのオブジェクト参照\fIobjref\fRにコピーします。このobjrefには、あとで様々な名前を割り当ててネームスペースに追加します。 +次のコードでは、初期ネーミング・コンテキストを取得し、それを\fBctx\fRに代入します。2行目では、\fBctx\fRをダミーのオブジェクト参照\fBobjref\fRにコピーします。このobjrefには、あとで様々な名前を割り当ててネームスペースに追加します。 .sp .if n \{\ .RS 4 .\} .nf - NamingContext ctx = - NamingContextHelper\&.narrow( - orb\&.resolve_initial_references("NameService")); - NamingContext objref = ctx; +\fB NamingContext ctx =\fR +\fB NamingContextHelper\&.narrow(\fR +\fB orb\&.resolve_initial_references("NameService"));\fR +\fB NamingContext objref = ctx;\fR + .fi .if n \{\ .RE .\} .PP -次のコードでは、\fItext\fRタイプの名前\fIplans\fRを作成し、それをダミーのオブジェクト参照にバインドします。その後、\fIrebind\fRメソッドを使用して初期ネーミング・コンテキストの下に\fIplans\fRを追加しています。\fIrebind\fRメソッドを使用すれば、\fIbind\fRメソッドを使用した場合に発生する例外を発生させずに、このプログラムを何度も繰返し実行できます。 +次のコードでは、\fBtext\fRタイプの名前\fBplans\fRを作成し、それをダミーのオブジェクト参照にバインドします。その後、\fBrebind\fRメソッドを使用して初期ネーミング・コンテキストの下に\fBplans\fRを追加しています。\fBrebind\fRメソッドを使用すれば、\fBbind\fRメソッドを使用した場合に発生する例外を発生させずに、このプログラムを何度も繰返し実行できます。 .sp .if n \{\ .RS 4 .\} .nf - NameComponent nc1 = new NameComponent("plans", "text"); - NameComponent[] name1 = {nc1}; - ctx\&.rebind(name1, objref); - System\&.out\&.println("plans rebind successful!"); +\fB NameComponent nc1 = new NameComponent("plans", "text");\fR +\fB NameComponent[] name1 = {nc1};\fR +\fB ctx\&.rebind(name1, objref);\fR +\fB System\&.out\&.println("plans rebind successful!");\fR + .fi .if n \{\ .RE .\} .PP -次のコードでは、\fIdirectory\fRタイプの\fIPersonal\fRというネーミング・コンテキストを作成します。その結果得られるオブジェクト参照\fIctx2\fRを\fIname\fRにバインドし、初期ネーミング・コンテキストに追加します。 +次のコードでは、\fBdirectory\fRタイプの\fBPersonal\fRというネーミング・コンテキストを作成します。その結果得られるオブジェクト参照\fBctx2\fRを\fBname\fRにバインドし、初期ネーミング・コンテキストに追加します。 .sp .if n \{\ .RS 4 .\} .nf - NameComponent nc2 = new NameComponent("Personal", "directory"); - NameComponent[] name2 = {nc2}; - NamingContext ctx2 = ctx\&.bind_new_context(name2); - System\&.out\&.println("new naming context added\&.\&."); +\fB NameComponent nc2 = new NameComponent("Personal", "directory");\fR +\fB NameComponent[] name2 = {nc2};\fR +\fB NamingContext ctx2 = ctx\&.bind_new_context(name2);\fR +\fB System\&.out\&.println("new naming context added\&.\&.");\fR + .fi .if n \{\ .RE .\} .PP -残りのコードでは、ダミーのオブジェクト参照を\fIschedule\fRと\fIcalendar\fRという名前でネーミング・コンテキスト\fIPersonal\fR(\fIctx2\fR)にバインドします。 +残りのコードでは、ダミーのオブジェクト参照を\fBschedule\fRと\fBcalendar\fRという名前でネーミング・コンテキスト\fBPersonal\fR(\fBctx2\fR)にバインドします。 .sp .if n \{\ .RS 4 .\} .nf - NameComponent nc3 = new NameComponent("schedule", "text"); - NameComponent[] name3 = {nc3}; - ctx2\&.rebind(name3, objref); - System\&.out\&.println("schedule rebind successful!"); +\fB NameComponent nc3 = new NameComponent("schedule", "text");\fR +\fB NameComponent[] name3 = {nc3};\fR +\fB ctx2\&.rebind(name3, objref);\fR +\fB System\&.out\&.println("schedule rebind successful!");\fR +\fB \fR +\fB NameComponent nc4 = new NameComponent("calender", "text");\fR +\fB NameComponent[] name4 = {nc4};\fR +\fB ctx2\&.rebind(name4, objref);\fR +\fB System\&.out\&.println("calender rebind successful!");\fR +\fB } catch (Exception e) {\fR +\fB e\&.printStackTrace(System\&.err);\fR +\fB }\fR +\fB }\fR +\fB}\fR - NameComponent nc4 = new NameComponent("calender", "text"); - NameComponent[] name4 = {nc4}; - ctx2\&.rebind(name4, objref); - System\&.out\&.println("calender rebind successful!"); - } catch (Exception e) { - e\&.printStackTrace(System\&.err); - } - } -} .fi .if n \{\ .RE @@ -308,29 +323,31 @@ .RS 4 .\} .nf -import java\&.util\&.Properties; -import org\&.omg\&.CORBA\&.*; -import org\&.omg\&.CosNaming\&.*; +\fBimport java\&.util\&.Properties;\fR +\fBimport org\&.omg\&.CORBA\&.*;\fR +\fBimport org\&.omg\&.CosNaming\&.*;\fR +\fB \fR +\fBpublic class NameClientList {\fR -public class NameClientList { - - public static void main(String args[]) { - - try { +\fB public static void main(String args[]) {\fR + +\fB try {\fR + .fi .if n \{\ .RE .\} .PP -ネーミング・サービスの起動で、\fInameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。 +ネーミング・サービスの起動で、\fBnameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。 .sp .if n \{\ .RS 4 .\} .nf - Properties props = new Properties(); - props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050"); - ORB orb = ORB\&.init(args, props); +\fB Properties props = new Properties();\fR +\fB props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fR +\fB ORB orb = ORB\&.init(args, props);\fR + .fi .if n \{\ .RE @@ -342,36 +359,39 @@ .RS 4 .\} .nf - NamingContext nc = - NamingContextHelper\&.narrow( - orb\&.resolve_initial_references("NameService")); +\fB NamingContext nc =\fR +\fB NamingContextHelper\&.narrow(\fR +\fB orb\&.resolve_initial_references("NameService"));\fR + .fi .if n \{\ .RE .\} .PP -\fIlist\fRメソッドは、ネーミング・コンテキストのバインディングをリストします。この場合、最大1000個までのバインディングが初期ネーミング・コンテキストから\fIBindingListHolder\fRに返されます。残りのバインディングは、\fIBindingIteratorHolder\fRに返されます。 +\fBlist\fRメソッドは、ネーミング・コンテキストのバインディングをリストします。この場合、最大1000個までのバインディングが初期ネーミング・コンテキストから\fBBindingListHolder\fRに返されます。残りのバインディングは、\fBBindingIteratorHolder\fRに返されます。 .sp .if n \{\ .RS 4 .\} .nf - BindingListHolder bl = new BindingListHolder(); - BindingIteratorHolder blIt= new BindingIteratorHolder(); - nc\&.list(1000, bl, blIt); +\fB BindingListHolder bl = new BindingListHolder();\fR +\fB BindingIteratorHolder blIt= new BindingIteratorHolder();\fR +\fB nc\&.list(1000, bl, blIt);\fR + .fi .if n \{\ .RE .\} .PP -次のコードでは、返された\fIBindingListHolder\fRからバインディングの配列を取得します。バインディングがない場合は、プログラムが終了します。 +次のコードでは、返された\fBBindingListHolder\fRからバインディングの配列を取得します。バインディングがない場合は、プログラムが終了します。 .sp .if n \{\ .RS 4 .\} .nf - Binding bindings[] = bl\&.value; - if (bindings\&.length == 0) return; +\fB Binding bindings[] = bl\&.value;\fR +\fB if (bindings\&.length == 0) return;\fR + .fi .if n \{\ .RE @@ -383,27 +403,28 @@ .RS 4 .\} .nf - for (int i=0; i < bindings\&.length; i++) { - - // get the object reference for each binding - org\&.omg\&.CORBA\&.Object obj = nc\&.resolve(bindings[i]\&.binding_name); - String objStr = orb\&.object_to_string(obj); - int lastIx = bindings[i]\&.binding_name\&.length\-1; +\fB for (int i=0; i < bindings\&.length; i++) {\fR +\fB \fR +\fB // get the object reference for each binding\fR +\fB org\&.omg\&.CORBA\&.Object obj = nc\&.resolve(bindings[i]\&.binding_name);\fR +\fB String objStr = orb\&.object_to_string(obj);\fR +\fB int lastIx = bindings[i]\&.binding_name\&.length\-1;\fR +\fB \fR +\fB // check to see if this is a naming context\fR +\fB if (bindings[i]\&.binding_type == BindingType\&.ncontext) {\fR +\fB System\&.out\&.println("Context: " +\fR +\fB bindings[i]\&.binding_name[lastIx]\&.id);\fR +\fB } else {\fR +\fB System\&.out\&.println("Object: " +\fR +\fB bindings[i]\&.binding_name[lastIx]\&.id);\fR +\fB }\fR +\fB }\fR +\fB } catch (Exception e) {\fR +\fB e\&.printStackTrace(System\&.err)\fR +\fB }\fR +\fB }\fR +\fB}\fR - // check to see if this is a naming context - if (bindings[i]\&.binding_type == BindingType\&.ncontext) { - System\&.out\&.println("Context: " + - bindings[i]\&.binding_name[lastIx]\&.id); - } else { - System\&.out\&.println("Object: " + - bindings[i]\&.binding_name[lastIx]\&.id); - } - } - } catch (Exception e) { - e\&.printStackTrace(System\&.err) - } - } -} .fi .if n \{\ .RE
--- a/src/solaris/doc/sun/man/man1/ja/unpack200.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/unpack200.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: unpack200 -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Javaデプロイメント・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: unpack200 +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Javaデプロイメント・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "unpack200" "1" "2013年11月21日" "JDK 8" "Javaデプロイメント・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,15 +50,15 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" -unpack200 \- pack200(1)で作成されたパック・ファイルを、WebデプロイメントのためにJARファイルに変換します。 +.SH "名前" +unpack200 \- \fBpack200\fR(1)で作成されたパック・ファイルを、WebデプロイメントのためにJARファイルに変換します。 .SH "概要" .sp .if n \{\ .RS 4 .\} .nf -\fIunpack200\fR [ \fIoptions\fR ] input\-file \fIJAR\-file\fR +\fBunpack200\fR [ \fIoptions\fR ] input\-file \fIJAR\-file\fR .fi .if n \{\ .RE @@ -64,12 +66,12 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIinput\-file\fR .RS 4 -入力ファイルの名前。pack200 gzipファイルかpack200ファイルを指定できます。入力ファイルには、\fIpack200\fR(1)で作成されたJARファイルを指定することもできます(手間は\fI0\fRです)。この場合、入力ファイルの内容はPack2000マーカーで出力JARファイルにコピーされます。 +入力ファイルの名前。pack200 gzipファイルかpack200ファイルを指定できます。入力ファイルには、\fBpack200\fR(1)で作成されたJARファイルを指定することもできます(手間は\fB0\fRです)。この場合、入力ファイルの内容はPack2000マーカーで出力JARファイルにコピーされます。 .RE .PP \fIJAR\-file\fR @@ -78,13 +80,14 @@ .RE .SH "説明" .PP -\fIunpack200\fRコマンドは、\fIpack200\fR\fI(1)\fRで作成されたパック・ファイルをJARファイルに変換するネイティブ実装です。一般的な使用方法は次のとおりです。次の例では、デフォルトの\fIunpack200\fRコマンド設定で、\fImyarchive\&.jar\fRファイルが\fImyarchive\&.pack\&.gz\fRから作成されます。 +\fBunpack200\fRコマンドは、\fBpack200\fR\fB(1)\fRで作成されたパック・ファイルをJARファイルに変換するネイティブ実装です。一般的な使用方法は次のとおりです。次の例では、デフォルトの\fBunpack200\fRコマンド設定で、\fBmyarchive\&.jar\fRファイルが\fBmyarchive\&.pack\&.gz\fRから作成されます。 .sp .if n \{\ .RS 4 .\} .nf -unpack200 myarchive\&.pack\&.gz myarchive\&.jar +\fBunpack200 myarchive\&.pack\&.gz myarchive\&.jar\fR + .fi .if n \{\ .RE @@ -93,7 +96,7 @@ .PP \-Hvalue \-\-deflate\-hint=\fIvalue\fR .RS 4 -JARファイル内のすべてのエントリに\fItrue\fR、\fIfalse\fRまたは\fIkeep\fRのデフレーションを設定します。デフォルト・モードは\fIkeep\fRです。値が\fItrue\fRまたは\fIfalse\fR場合、\fI\-\-deflate=hint\fRオプションはデフォルトの動作をオーバーライドして、出力JARファイル内のすべてのエントリのデフレーション・モードが設定されます。 +JARファイル内のすべてのエントリに\fBtrue\fR、\fBfalse\fRまたは\fBkeep\fRのデフレーションを設定します。デフォルト・モードは\fBkeep\fRです。値が\fBtrue\fRまたは\fBfalse\fR場合、\fB\-\-deflate=hint\fRオプションはデフォルトの動作をオーバーライドして、出力JARファイル内のすべてのエントリのデフレーション・モードが設定されます。 .RE .PP \-r \-\-remove\-pack\-file @@ -118,21 +121,21 @@ .PP \-? \-h \-\-help .RS 4 -\fIunpack200\fRコマンドに関するヘルプ情報を出力します。 +\fBunpack200\fRコマンドに関するヘルプ情報を出力します。 .RE .PP \-V \-\-version .RS 4 -\fIunpack200\fRコマンドに関するバージョン情報を出力します。 +\fBunpack200\fRコマンドに関するバージョン情報を出力します。 .RE .PP \-J\fIoption\fR .RS 4 -Java仮想マシンにoptionを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 +Java Virtual Machineにoptionを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 .RE .SH "注意" .PP -このコマンドと\fIunpack\fRコマンドを混同しないでください。これらは別製品です。 +このコマンドと\fBunpack\fRコマンドを混同しないでください。これらは別製品です。 .PP JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。 .SH "終了ステータス" @@ -181,8 +184,9 @@ .sp -1 .IP \(bu 2.3 .\} -「Pack200 and Compression」 -(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/deployment/deployment\-guide/pack200\&.html) +「Compression Formats for Network Deployment」 + +http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jweb/networking/compression_formats\&.html .RE .sp .RS 4
--- a/src/solaris/doc/sun/man/man1/ja/wsgen.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/wsgen.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: wsgen -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java Webサービス・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: wsgen +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java Webサービス・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "wsgen" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" wsgen \- Webサービスのエンドポイント実装(SEI)クラスを読取り、Webサービスのデプロイメントと呼出しに必要なすべてのアーティファクトを生成します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIwsgen\fR [ \fIoptions\fR ] \fISEI\fR +\fBwsgen\fR [ \fIoptions\fR ] \fISEI\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fISEI\fR @@ -73,18 +75,19 @@ .RE .SH "説明" .PP -\fIwsgen\fRコマンドは、JAX\-WS Webサービスで使用されるJAX\-WSポータブル・アーティファクトを生成します。このツールは、Webサービスのエンドポイント・クラスを読取り、Webサービスのデプロイメントと呼出しに必要なすべてのアーティファクトを生成します。JAXWS 2\&.1\&.1 RIでは\fIwsgen\fR +\fBwsgen\fRコマンドは、JAX\-WS Webサービスで使用されるJAX\-WSポータブル・アーティファクトを生成します。このツールは、Webサービスのエンドポイント・クラスを読取り、Webサービスのデプロイメントと呼出しに必要なすべてのアーティファクトを生成します。JAXWS 2\&.1\&.1 RIでは\fBwsgen\fR Antタスクも提供されます。 http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.htmlのJAX\-WS (wsgen)ページのToolsタブを参照してください。 .PP -\fIwsgen\fRコマンドを起動するには、次を行います。 +\fBwsgen\fRコマンドを起動するには、次を行います。 .sp .if n \{\ .RS 4 .\} .nf -export JAXWS_HOME=/pathto/jaxws\-ri -$JAXWS_HOME/bin/wsgen\&.sh \-help +\fBexport JAXWS_HOME=/pathto/jaxws\-ri\fR +\fB$JAXWS_HOME/bin/wsgen\&.sh \-help\fR + .fi .if n \{\ .RE @@ -113,7 +116,7 @@ .PP \-help .RS 4 -\fIwsgen\fRコマンドに関するヘルプ・メッセージを表示します。 +\fBwsgen\fRコマンドに関するヘルプ・メッセージを表示します。 .RE .PP \-keep @@ -123,7 +126,7 @@ .PP \-r \fIdirectory\fR .RS 4 -このオプションを\fI\-wsdl\fRオプションとともに使用して、WSDLなど生成されたリソース・ファイルを配置する場所を指定します。 +このオプションを\fB\-wsdl\fRオプションとともに使用して、WSDLなど生成されたリソース・ファイルを配置する場所を指定します。 .RE .PP \-s \fIdirectory\fR @@ -145,41 +148,43 @@ .RS 4 エンドポイントをデプロイする前に確認するWSDLファイルを生成するオプション・コマンド。WSDLファイルには、サービスを呼び出す方法、パラメータに必要な値、返されるデータ構造についてのコンピュータで読取り可能な記述が含まれます。 .sp -デフォルトでは\fIwsgen\fRコマンドはWSDLファイルを生成しません。\fIprotocol\fR値は省略可能であり、WSDLバインディング(\fIwsdl:binding\fR)で使用するプロトコルを指定するために使用されます。有効なプロトコルは、\fIsoap1\&.1\fRと\fIXsoap1\&.2\fRです。デフォルトは\fIsoap1\&.1\fRです。\fIXsoap1\&.2\fRプロトコルは標準ではないため、\fI\-extension\fRオプションとともにのみ使用可能です。 +デフォルトでは\fBwsgen\fRコマンドはWSDLファイルを生成しません。\fBprotocol\fR値は省略可能であり、WSDLバインディング(\fBwsdl:binding\fR)で使用するプロトコルを指定するために使用されます。有効なプロトコルは、\fBsoap1\&.1\fRと\fBXsoap1\&.2\fRです。デフォルトは\fBsoap1\&.1\fRです。\fBXsoap1\&.2\fRプロトコルは標準ではないため、\fB\-extension\fRオプションとともにのみ使用可能です。 .RE .PP \-servicename \fIname\fR .RS 4 -\fI\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLサービス(\fIwsdl:service\fR)名を指定します。例: -\fI\-servicename "{http://mynamespace/}MyService"\fR。 +\fB\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLサービス(\fBwsdl:service\fR)名を指定します。例: +\fB\-servicename "{http://mynamespace/}MyService"\fR。 .RE .PP \-portname \fIname\fR .RS 4 -\fI\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLポート(\fIwsdl:port\fR)名を指定します。例: -\fI\-portname "{http://mynamespace/}MyPort"\fR。 +\fB\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLポート(\fBwsdl:port\fR)名を指定します。例: +\fB\-portname "{http://mynamespace/}MyPort"\fR。 .RE .SH "例" .PP -次の例では、Stockディレクトリ内に\fI@WebService\fR注釈を持つ\fIStockService\fRのラッパー・クラスを生成します。 +次の例では、Stockディレクトリ内に\fB@WebService\fR注釈を持つ\fBStockService\fRのラッパー・クラスを生成します。 .sp .if n \{\ .RS 4 .\} .nf -wsgen \-d stock \-cp myclasspath stock\&.StockService +\fBwsgen \-d stock \-cp myclasspath stock\&.StockService\fR + .fi .if n \{\ .RE .\} .PP -次の例では、SOAP 1\&.1 WSDLおよび\fI@WebService\fR注釈を持つ\fIstock\&.StockService\fRクラスのスキーマを生成します。 +次の例では、SOAP 1\&.1 WSDLおよび\fB@WebService\fR注釈を持つ\fBstock\&.StockService\fRクラスのスキーマを生成します。 .sp .if n \{\ .RS 4 .\} .nf -wsgen \-wsdl \-d stock \-cp myclasspath stock\&.StockService +\fBwsgen \-wsdl \-d stock \-cp myclasspath stock\&.StockService\fR + .fi .if n \{\ .RE @@ -191,7 +196,8 @@ .RS 4 .\} .nf -wsgen \-wsdl:Xsoap1\&.2 \-d stock \-cp myclasspath stock\&.StockService +\fBwsgen \-wsdl:Xsoap1\&.2 \-d stock \-cp myclasspath stock\&.StockService \fR + .fi .if n \{\ .RE
--- a/src/solaris/doc/sun/man/man1/ja/wsimport.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/wsimport.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: wsimport -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java Webサービス・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: wsimport +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java Webサービス・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "wsimport" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" wsimport \- Webアプリケーション・アーカイブ(WAR)ファイルにパッケージできるJAX\-WSポータブル・アーティファクトを生成して、Antタスクを指定します。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIwsimport\fR [ \fIoptions\fR ] \fIwsdl\fR +\fBwsimport\fR [ \fIoptions\fR ] \fIwsdl\fR .fi .if n \{\ .RE @@ -64,7 +66,7 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP \fIwsdl\fR @@ -73,7 +75,7 @@ .RE .SH "説明" .PP -\fIwsimport\fRコマンドは、次のJAX\-WSポータブル・アーティファクトを生成します。これらのアーティファクトは、デプロイするWSDLおよびスキーマ・ドキュメントおよびエンドポイント実装とともに、WARファイルにパッケージできます。\fIwsimport\fRコマンドでは\fIwsimport\fR +\fBwsimport\fRコマンドは、次のJAX\-WSポータブル・アーティファクトを生成します。これらのアーティファクトは、デプロイするWSDLおよびスキーマ・ドキュメントおよびエンドポイント実装とともに、WARファイルにパッケージできます。\fBwsimport\fRコマンドでは\fBwsimport\fR Antタスクも提供されます。 http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.htmlのWsimport Ant TaskページのToolsタブを参照してください。 .sp @@ -107,7 +109,7 @@ .sp -1 .IP \(bu 2.3 .\} -例外クラスは\fIwsdl:fault\fRからマップされます(存在する場合) +例外クラスは\fBwsdl:fault\fRからマップされます(存在する場合) .RE .sp .RS 4 @@ -118,7 +120,7 @@ .sp -1 .IP \(bu 2.3 .\} -非同期レスポンスBeanはレスポンス\fIwsdl:message\fRから派生します(存在する場合) +非同期レスポンスBeanはレスポンス\fBwsdl:message\fRから派生します(存在する場合) .RE .sp .RS 4 @@ -132,7 +134,7 @@ JAXBが生成する値タイプ(スキーマのタイプからマップされたJavaクラス) .RE .PP -\fIwsgen\fRコマンドを起動するには、次を行います。 +\fBwsgen\fRコマンドを起動するには、次を行います。 .PP \fBOracle Solaris/Linux\fR: .sp @@ -140,7 +142,8 @@ .RS 4 .\} .nf -/bin/wsimport\&.sh \-help +\fB/bin/wsimport\&.sh \-help\fR + .fi .if n \{\ .RE @@ -152,7 +155,8 @@ .RS 4 .\} .nf -\ebin\ewsimport\&.bat \-help +\fB\ebin\ewsimport\&.bat \-help\fR + .fi .if n \{\ .RE @@ -166,18 +170,18 @@ .PP \-b \fIpath\fR .RS 4 -外部JAX\-WSまたはJAXBバインディング・ファイルを指定します。\fI\-b\fRオプションで複数のJAX\-WSおよびJAXBバインディング・ファイルを指定できます。これらのファイルを使用して、パッケージ名、Bean名などをカスタマイズできます。JAX\-WSおよびJAXBバインディング・ファイルの詳細は、 +外部JAX\-WSまたはJAXBバインディング・ファイルを指定します。\fB\-b\fRオプションで複数のJAX\-WSおよびJAXBバインディング・ファイルを指定できます。これらのファイルを使用して、パッケージ名、Bean名などをカスタマイズできます。JAX\-WSおよびJAXBバインディング・ファイルの詳細は、 http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.htmlのWSDL CustomizationのUsers Guideタブを参照してください .RE .PP \-B \fIjaxbOption\fR .RS 4 -JAXBスキーマ・コンパイラに\fIjaxbOption\fRオプションを渡します。 +JAXBスキーマ・コンパイラに\fBjaxbOption\fRオプションを渡します。 .RE .PP \-catalog .RS 4 -外部エンティティ参照を解決するカタログ・ファイルを指定します。\fI\-catalog\fRオプションは、TR9401、XCatalog、OASIS XML Catalogの各形式をサポートしています。http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/catalog\-support\&.htmlの +外部エンティティ参照を解決するカタログ・ファイルを指定します。\fB\-catalog\fRオプションは、TR9401、XCatalog、OASIS XML Catalogの各形式をサポートしています。http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/catalog\-support\&.htmlの Catalog SupportページのUsers Guideタブを参照してください。 .RE .PP @@ -188,7 +192,7 @@ .PP \-help .RS 4 -\fIwsimport\fRコマンドに関するヘルプ・メッセージを表示します。 +\fBwsimport\fRコマンドに関するヘルプ・メッセージを表示します。 .RE .PP \-httpproxy: \fIhost\fR:\fIport\fR @@ -223,7 +227,7 @@ .PP \-wsdllocation \fIlocation\fR .RS 4 -\fI@WebServiceClient\&.wsdlLocation\fRの値を指定します。 +\fB@WebServiceClient\&.wsdlLocation\fRの値を指定します。 .RE .PP \-target @@ -233,11 +237,11 @@ .PP \-quiet .RS 4 -\fIwsimport\fRコマンド出力を抑制します。 +\fBwsimport\fRコマンド出力を抑制します。 .RE .PP -\fI\-b\fRオプションを使用して、複数の\fIJAX\-WS\fRおよび\fIJAXB\fRバインディング・ファイルを指定できます。これらのファイルを使用して、パッケージ名やBean名など、様々なものをカスタマイズできます。\fIJAX\-WS\fRおよび\fIJAXB\fRバインディング・ファイルの詳細は、 -https://jax\-ws\&.dev\&.java\&.net/nonav/2\&.1\&.1/docs/customizations\&.htmlのJAXBタブを参照してください +\fB\-b\fRオプションを使用して、複数の\fBJAX\-WS\fRおよび\fBJAXB\fRバインディング・ファイルを指定できます。これらのファイルを使用して、パッケージ名やBean名など、様々なものをカスタマイズできます。\fBJAX\-WS\fRおよび\fBJAXB\fRバインディング・ファイルの詳細は、 +https://jax\-ws\&.java\&.net/nonav/2\&.1\&.2/docs/customizations\&.htmlのカスタマイズ・ドキュメントを参照してください .SH "非標準オプション" .PP \-XadditionalHeaders @@ -249,7 +253,7 @@ .RS 4 認証情報を含むファイルを指定するWSDL URIです。このURIの形式は次のとおりです。 .sp -http://\fIuser\-name\fR:\fIpassword\fR@\fIhost\-name\fR/\fIweb\-service\-name\fR>?wsdl +http://\fIuser\-name\fR:\fBpassword\fR@\fIhost\-name\fR/\fIweb\-service\-name\fR>?wsdl\&. .RE .PP \-Xdebug @@ -268,13 +272,14 @@ .RE .SH "例" .PP -次の例では、Javaアーティファクトを生成し、\fIhttp://stockquote\&.example\&.com/quote?wsdl\fRをインポートしてアーティファクトをコンパイルします。 +次の例では、Javaアーティファクトを生成し、\fBhttp://stockquote\&.example\&.com/quote?wsdl\fRをインポートしてアーティファクトをコンパイルします。 .sp .if n \{\ .RS 4 .\} .nf -wsimport \-p stockquote http://stockquote\&.example\&.com/quote?wsdl +\fBwsimport \-p stockquote http://stockquote\&.example\&.com/quote?wsdl\fR + .fi .if n \{\ .RE
--- a/src/solaris/doc/sun/man/man1/ja/xjc.1 Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/doc/sun/man/man1/ja/xjc.1 Mon Jul 14 11:15:04 2014 -0700 @@ -1,11 +1,5 @@ '\" t -.\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. -.\" Title: xjc -.\" Language: English -.\" Date: 2013年11月21日 -.\" SectDesc: Java Webサービス・ツール -.\" Software: JDK 8 -.\" Arch: 汎用 +.\" Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. .\" .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" @@ -27,7 +21,15 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.pl 99999 +.\" Title: xjc +.\" Language: Japanese +.\" Date: 2013年11月21日 +.\" SectDesc: Java Webサービス・ツール +.\" Software: JDK 8 +.\" Arch: 汎用 +.\" Part Number: E54734-01 +.\" +.if n .pl 99999 .TH "xjc" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール" .\" ----------------------------------------------------------------- .\" * Define some portability stuff @@ -48,7 +50,7 @@ .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "NAME" +.SH "名前" xjc \- XMLスキーマ・ファイルを完全注釈付きのJavaクラスにコンパイルします。 .SH "概要" .sp @@ -56,7 +58,7 @@ .RS 4 .\} .nf -\fIxjc\fR [ \fIoptions\fR ] \fIschema\fR \fIfile/URL/dir/jar\fR \&.\&.\&. [\fI\-b\fR \fIbindinfo\fR ] \&.\&.\&. +\fBxjc\fR [ \fIoptions\fR ] \fBschema\fR \fIfile/URL/dir/jar\fR \&.\&.\&. [\fB\-b\fR \fIbindinfo\fR ] \&.\&.\&. .fi .if n \{\ .RE @@ -64,12 +66,12 @@ .PP \fIoptions\fR .RS 4 -コマンドライン・オプション。オプションを参照してください。 +コマンド行オプション。オプションを参照してください。 .RE .PP schema \fIfile/URL/dir/jar \&.\&.\&.\fR .RS 4 -XMLスキーマ・ファイルの場所。\fIdir\fRが指定されている場合は、すべてのスキーマ・ファイルがコンパイルされます。\fIjar\fRが指定されている場合は、\fI/META\-INF/sun\-jaxb\&.episode\fRバインディング・ファイルがコンパイルされます。 +XMLスキーマ・ファイルの場所。\fBdir\fRが指定されている場合は、すべてのスキーマ・ファイルがコンパイルされます。\fBjar\fRが指定されている場合は、\fB/META\-INF/sun\-jaxb\&.episode\fRバインディング・ファイルがコンパイルされます。 .RE .PP \-b \fIbindinfo\fR @@ -78,7 +80,7 @@ .RE .SH "説明" .PP -プラットフォームのbinディレクトリにある適切な\fIxjc\fRシェル・スクリプトを使用して、バインディング・コンパイラを起動します。バインディング・コンパイラを実行するAntタスクもあります。http://jaxb\&.java\&.net/nonav/2\&.1\&.3/docs/xjcTask\&.htmlの +プラットフォームのbinディレクトリにある適切な\fBxjc\fRシェル・スクリプトを使用して、バインディング・コンパイラを起動します。バインディング・コンパイラを実行するAntタスクもあります。http://jaxb\&.java\&.net/nonav/2\&.1\&.3/docs/xjcTask\&.htmlの Using the XJC with Antを参照してください .SH "オプション" .sp @@ -111,13 +113,13 @@ .PP \-extension .RS 4 -デフォルトでは、XJCバインディング・コンパイラは、JAXB仕様のCompatibilityの章で説明されているルールを厳密に強制します。付録E\&.2には、JAXB v1\&.0で完全にはサポートされていない一連のW3C XMLスキーマ機能が定義されています。場合によっては、このスイッチで有効になる\fI\-extension\fRモードでそれらの機能が使用できる場合があります。また、デフォルトの厳密なモードでは、仕様に定義されているバインディング・カスタマイズのみが使用できます。\fI\-extension\fRスイッチを指定すれば、JAXB Vendor Extensionを使用できます。 +デフォルトでは、XJCバインディング・コンパイラは、JAXB仕様のCompatibilityの章で説明されているルールを厳密に強制します。付録E\&.2には、JAXB v1\&.0で完全にはサポートされていない一連のW3C XMLスキーマ機能が定義されています。場合によっては、このスイッチで有効になる\fB\-extension\fRモードでそれらの機能が使用できる場合があります。また、デフォルトの厳密なモードでは、仕様に定義されているバインディング・カスタマイズのみが使用できます。\fB\-extension\fRスイッチを指定すれば、JAXB Vendor Extensionを使用できます。 .RE .PP \-b \fIfile\fR .RS 4 -処理する外部バインディング・ファイルを1つまたは複数指定します。バインディング・ファイルごとに\fI\-b\fRスイッチを指定する必要があります。外部バインディング・ファイルの構文は柔軟です。複数のスキーマのカスタマイズが含まれる1つのバインディング・ファイルを使用したり、それらのカスタマイズを複数のバインディング・ファイルに分割したりできます。次に例を示します。\fIxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings123\&.xjb\fR -\fIxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings1\&.xjb \-b bindings2\&.xjb \-b bindings3\&.xjb\fRまた、コマンドラインにスキーマ・ファイルとバインディング・ファイルを指定する順番は任意です。 +処理する外部バインディング・ファイルを1つまたは複数指定します。バインディング・ファイルごとに\fB\-b\fRスイッチを指定する必要があります。外部バインディング・ファイルの構文は柔軟です。複数のスキーマのカスタマイズが含まれる1つのバインディング・ファイルを使用したり、それらのカスタマイズを複数のバインディング・ファイルに分割したりできます。次に例を示します。\fBxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings123\&.xjb\fR +\fBxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings1\&.xjb \-b bindings2\&.xjb \-b bindings3\&.xjb\fRまた、コマンド行にスキーマ・ファイルとバインディング・ファイルを指定する順番は任意です。 .RE .PP \-d \fIdir\fR @@ -127,17 +129,17 @@ .PP \-p \fIpkg\fR .RS 4 -このコマンドライン・オプションでターゲット・パッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディング・カスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。 +このコマンド行オプションでターゲット・パッケージを指定した場合、パッケージ名に対するすべてのバインディング・カスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。 .RE .PP \-httpproxy \fIproxy\fR .RS 4 -\fI[user[:password]@]proxyHost[:proxyPort]\fR形式でHTTPまたはHTTPSプロキシを指定します。古い\fI\-host\fRおよび\fI\-port\fRオプションは、下位互換性のために引き続きRIでサポートされますが、非推奨となりました。このオプションで指定されたパスワードは、topコマンドを使用する他のユーザーが表示できる引数です。セキュリティを高めるには、\fI\-httpproxyfile\fRを使用してください。 +\fI[user[:password]@]proxyHost[:proxyPort]\fR形式でHTTPまたはHTTPSプロキシを指定します。古い\fB\-host\fRおよび\fB\-port\fRオプションは、後方互換性のために引き続きRIでサポートされますが、非推奨となりました。このオプションで指定されたパスワードは、topコマンドを使用する他のユーザーが表示できる引数です。セキュリティを高めるには、\fB\-httpproxyfile\fRを使用してください。 .RE .PP \-httpproxyfile file .RS 4 -ファイルを使用して、HTTPまたはHTTPSプロキシを指定します。形式は\fI\-httpproxy\fRオプションと同じですが、このファイル内に指定されたパスワードを他のユーザーが表示することはできません。 +ファイルを使用して、HTTPまたはHTTPSプロキシを指定します。形式は\fB\-httpproxy\fRオプションと同じですが、このファイル内に指定されたパスワードを他のユーザーが表示することはできません。 .RE .PP \-classpath arg @@ -158,12 +160,12 @@ .PP \-npa .RS 4 -\fI**/package\-info\&.java\fRへのパッケージ・レベルの注釈の生成を抑制します。このスイッチを使用して生成するコードでは、これらの注釈が他の生成済クラスに内部化されます。 +\fB**/package\-info\&.java\fRへのパッケージ・レベルの注釈の生成を抑制します。このスイッチを使用して生成するコードでは、これらの注釈が他の生成済クラスに内部化されます。 .RE .PP \-no\-header .RS 4 -多少のメモとタイムスタンプを含むファイル・ヘッダー・コメントの生成を抑制します。これを使用すると、生成されたコードと\fIdiff\fRコマンドとの互換性がより強くなります。 +多少のメモとタイムスタンプを含むファイル・ヘッダー・コメントの生成を抑制します。これを使用すると、生成されたコードと\fBdiff\fRコマンドとの互換性がより強くなります。 .RE .PP \-target 2\&.0 @@ -218,7 +220,7 @@ .PP \fIschema file/URL/dir\fR .RS 4 -コンパイル対象となる1つまたは複数のスキーマ・ファイルを指定します。ディレクトリを指定する場合、\fIxjc\fRコマンドはすべてのスキーマ・ファイルをスキャンしてコンパイルします。 +コンパイル対象となる1つまたは複数のスキーマ・ファイルを指定します。ディレクトリを指定する場合、\fBxjc\fRコマンドはすべてのスキーマ・ファイルをスキャンしてコンパイルします。 .RE .SS "非標準オプション" .PP @@ -229,12 +231,12 @@ .PP \-Xsync\-methods .RS 4 -生成されたすべてのメソッド・シグニチャに\fIsynchronized\fRキーワードが含められます。 +生成されたすべてのメソッド・シグニチャに\fBsynchronized\fRキーワードが含められます。 .RE .PP \-mark\-generated .RS 4 -生成されたコードに注釈\fI@javax\&.annotation\&.Generated\fRを付けます。 +生成されたコードに注釈\fB@javax\&.annotation\&.Generated\fRを付けます。 .RE .PP \-episode file @@ -245,21 +247,21 @@ .PP \-host & \-port .RS 4 -これらのオプションは\fI\-httpproxy\fRオプションで置き換えられました。これらのオプションは、下位互換性を確保するためにサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。 +これらのオプションは\fB\-httpproxy\fRオプションで置き換えられました。これらのオプションは、後方互換性を確保するためにサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。 .RE .PP \-use\-runtime .RS 4 -JAXB 2\&.0仕様では、移植性のあるランタイム環境が定義されたため、JAXB RIが\fI**/impl/runtime \fRパッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。 +JAXB 2\&.0仕様では、移植性のあるランタイム環境が定義されたため、JAXB RIが\fB**/impl/runtime \fRパッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。 .RE .PP \-source .RS 4 -\fI\-source\fR互換性スイッチは、JAXB 2\&.0の最初のEarly Access版で導入されました。このスイッチはJAXB 2\&.0の今後のリリースから削除されます。1\&.0\&.xコードを生成する必要がある場合は、1\&.0\&.xコード・ベースのインストールを使用してください。 +\fB\-source\fR互換性スイッチは、JAXB 2\&.0の最初のEarly Access版で導入されました。このスイッチはJAXB 2\&.0の今後のリリースから削除されます。1\&.0\&.xコードを生成する必要がある場合は、1\&.0\&.xコード・ベースのインストールを使用してください。 .RE .SH "コンパイラの制限" .PP -通常は、関連するすべてのスキーマを、同じバインディング・コンパイラ・スイッチを指定して1つの単位としてコンパイルするのが最も安全です。\fIxjc\fRコマンドの実行時には、次の制限リストに留意してください。これらの問題のほとんどは、\fIxjc\fRコマンドを何度か呼び出して複数のスキーマをコンパイルする場合にのみ当てはまります。 +通常は、関連するすべてのスキーマを、同じバインディング・コンパイラ・スイッチを指定して1つの単位としてコンパイルするのが最も安全です。\fBxjc\fRコマンドの実行時には、次の制限リストに留意してください。これらの問題のほとんどは、\fBxjc\fRコマンドを何度か呼び出して複数のスキーマをコンパイルする場合にのみ当てはまります。 .PP 複数のスキーマを同時にコンパイルする場合は、ターゲットのJavaパッケージ名に次の優先順位のルールが適用されることに注意してください。 .sp @@ -271,7 +273,7 @@ .sp -1 .IP " 1." 4.2 .\} -\fI\-p\fRオプションが最も優先されます。 +\fB\-p\fRオプションが最も優先されます。 .RE .sp .RS 4 @@ -293,7 +295,7 @@ .sp -1 .IP " 3." 4.2 .\} -\fItargetNamespace\fRが宣言されている場合は、\fIt\fR\fIargetNamespace\fRを仕様で定義されているJavaパッケージ名のアルゴリズムに適用します。 +\fBtargetNamespace\fRが宣言されている場合は、\fBt\fR\fBargetNamespace\fRを仕様で定義されているJavaパッケージ名のアルゴリズムに適用します。 .RE .sp .RS 4 @@ -304,7 +306,7 @@ .sp -1 .IP " 4." 4.2 .\} -\fItargetNamespace\fRが宣言されていない場合は、\fIgenerated\fRという名前のハードコードされたパッケージを使用します。 +\fBtargetNamespace\fRが宣言されていない場合は、\fBgenerated\fRという名前のハードコードされたパッケージを使用します。 .RE .PP 1つのネームスペースが複数の\fIjaxb:schemaBindings\fRを持つことはできないため、異なるJavaパッケージにコンパイラされる同一ターゲット・ネームスペースが2つのスキーマを持つことはできません。
--- a/src/solaris/native/sun/security/smartcardio/MUSCLE/pcsclite.h Mon Jul 07 16:55:22 2014 +0400 +++ b/src/solaris/native/sun/security/smartcardio/MUSCLE/pcsclite.h Mon Jul 14 11:15:04 2014 -0700 @@ -75,6 +75,13 @@ } SCARD_READERSTATE_A; +typedef struct _SCARD_IO_REQUEST +{ + unsigned long dwProtocol; /* Protocol identifier */ + unsigned long cbPciLength; /* Protocol Control Inf Length */ +} +SCARD_IO_REQUEST, *PSCARD_IO_REQUEST, *LPSCARD_IO_REQUEST; + #else // __APPLE__ #pragma pack(1) @@ -88,6 +95,13 @@ unsigned char rgbAtr[MAX_ATR_SIZE]; } SCARD_READERSTATE_A; + +typedef struct _SCARD_IO_REQUEST +{ + uint32_t dwProtocol; /* Protocol identifier */ + uint32_t cbPciLength; /* Protocol Control Inf Length */ +} +SCARD_IO_REQUEST, *PSCARD_IO_REQUEST, *LPSCARD_IO_REQUEST; #pragma pack() #endif // __APPLE__ @@ -95,13 +109,6 @@ typedef SCARD_READERSTATE_A SCARD_READERSTATE, *PSCARD_READERSTATE_A, *LPSCARD_READERSTATE_A; -typedef struct _SCARD_IO_REQUEST -{ - unsigned long dwProtocol; /* Protocol identifier */ - unsigned long cbPciLength; /* Protocol Control Inf Length */ -} -SCARD_IO_REQUEST, *PSCARD_IO_REQUEST, *LPSCARD_IO_REQUEST; - typedef const SCARD_IO_REQUEST *LPCSCARD_IO_REQUEST; extern SCARD_IO_REQUEST g_rgSCardT0Pci, g_rgSCardT1Pci,
--- a/src/windows/classes/sun/awt/windows/WingDings.java Mon Jul 07 16:55:22 2014 +0400 +++ b/src/windows/classes/sun/awt/windows/WingDings.java Mon Jul 14 11:15:04 2014 -0700 @@ -29,7 +29,7 @@ import java.nio.CharBuffer; import java.nio.charset.*; -final class WingDings extends Charset { +public final class WingDings extends Charset { public WingDings () { super("WingDings", null); }
--- a/test/java/net/URLPermission/nstest/lookup.sh Mon Jul 07 16:55:22 2014 +0400 +++ b/test/java/net/URLPermission/nstest/lookup.sh Mon Jul 14 11:15:04 2014 -0700 @@ -24,9 +24,9 @@ # @test # @library /lib/testlibrary +# @build jdk.testlibrary.* # @compile -XDignore.symbol.file=true SimpleNameService.java # LookupTest.java SimpleNameServiceDescriptor.java -# @build jdk.testlibrary.* # @run shell/timeout=50 lookup.sh # @@ -42,8 +42,7 @@ ;; esac - -port=`${TESTJAVA}/bin/java -cp ${TESTCLASSES} LookupTest -getport` +port=`${TESTJAVA}/bin/java -cp ${TESTCLASSPATH} LookupTest -getport` cat << POLICY > policy grant { @@ -57,4 +56,7 @@ }; POLICY -${TESTJAVA}/bin/java -Djava.security.policy=file:./policy -Dsun.net.spi.nameservice.provider.1=simple,sun -cp ${TESTCLASSES}${PS}${TESTSRC} LookupTest -runtest ${port} +${TESTJAVA}/bin/java ${TESTVMOPTS} \ + -Djava.security.policy=file:./policy \ + -Dsun.net.spi.nameservice.provider.1=simple,sun \ + -cp ${TESTCLASSPATH}${PS}${TESTSRC} LookupTest -runtest ${port}
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test/javax/swing/PopupFactory/8048506/bug8048506.java Mon Jul 14 11:15:04 2014 -0700 @@ -0,0 +1,65 @@ +/* + * Copyright (c) 2014, 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 + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + +/* + * @test + * @bug 8048506 + * @summary Tests that popup with null-owner does not throw NPE + * @author Dmitry Markov + */ + +import javax.swing.*; +import javax.swing.plaf.metal.MetalLookAndFeel; + +public class bug8048506 { + + public static void main(String[] args) throws Exception { + UIManager.setLookAndFeel(new MetalLookAndFeel()); + + SwingUtilities.invokeAndWait(new Runnable() { + @Override + public void run() { + createAndShowGUI(); + } + }); + System.out.println("The test passed"); + } + + private static void createAndShowGUI() { + JFrame frame = new JFrame("bug8048506"); + frame.setSize(400, 400); + frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); + frame.setVisible(true); + + PopupFactory factory = PopupFactory.getSharedInstance(); + + // Create and show popup with owner + Popup popup1 = factory.getPopup(frame, new JLabel("Popup with owner"), 100, 100); + popup1.show(); + + //Create and show popup without owner + Popup popup2 = factory.getPopup(null, new JLabel("Popup without owner"), 200, 200); + popup2.show(); + } +} +