1 '\" t
2 .\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved.
3 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 .\"
5 .\" This code is free software; you can redistribute it and/or modify it
6 .\" under the terms of the GNU General Public License version 2 only, as
7 .\" published by the Free Software Foundation.
8 .\"
9 .\" This code is distributed in the hope that it will be useful, but WITHOUT
10 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 .\" version 2 for more details (a copy is included in the LICENSE file that
13 .\" accompanied this code).
14 .\"
15 .\" You should have received a copy of the GNU General Public License version
16 .\" 2 along with this work; if not, write to the Free Software Foundation,
17 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 .\"
19 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 .\" or visit www.oracle.com if you need additional information or have any
21 .\" questions.
22 .\"
23 .\" Title: javac
24 .\" Language: Japanese
25 .\" Date: 2015年3月3日
26 .\" SectDesc: 基本ツール
27 .\" Software: JDK 8
28 .\" Arch: 汎用
29 .\" Part Number: E58103-01
30 .\" Doc ID: JSSON
31 .\"
32 .if n .pl 99999
33 .TH "javac" "1" "2015年3月3日" "JDK 8" "基本ツール"
34 .\" -----------------------------------------------------------------
35 .\" * Define some portability stuff
36 .\" -----------------------------------------------------------------
37 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
38 .\" http://bugs.debian.org/507673
39 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
40 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
41 .ie \n(.g .ds Aq \(aq
42 .el .ds Aq '
43 .\" -----------------------------------------------------------------
44 .\" * set default formatting
45 .\" -----------------------------------------------------------------
46 .\" disable hyphenation
47 .nh
48 .\" disable justification (adjust text to left margin only)
49 .ad l
50 .\" -----------------------------------------------------------------
51 .\" * MAIN CONTENT STARTS HERE *
52 .\" -----------------------------------------------------------------
53 .SH "名前"
54 javac \- Javaクラスおよびインタフェースの定義を読み取り、バイトコードおよびクラス・ファイルにコンパイルします。
55 .SH "概要"
56 .sp
57 .if n \{\
58 .RS 4
59 .\}
60 .nf
61 \fBjavac\fR [ \fIoptions\fR ] [ \fIsourcefiles\fR ] [ \fIclasses\fR] [ \fI@argfiles\fR ]
62 .fi
63 .if n \{\
64 .RE
65 .\}
66 .PP
67 引数を指定する順序は任意です。
68 .PP
69 \fIoptions\fR
70 .RS 4
71 コマンド行オプション。オプションを参照してください。
72 .RE
73 .PP
74 \fIsourcefiles\fR
75 .RS 4
76 コンパイルされる1つ以上のソース・ファイル(\fBMyClass\&.java\fRなど)。
77 .RE
78 .PP
79 \fIclasses\fR
80 .RS 4
81 注釈の処理対象となる1つ以上のクラス(\fBMyPackage\&.MyClass\fRなど)。
82 .RE
83 .PP
84 \fI@argfiles\fR
85 .RS 4
86 オプションとソース・ファイルを一覧表示する1つ以上のファイル。このファイルの中では\fB\-J\fRオプションは指定できません。コマンド行引数ファイルを参照してください。
87 .RE
88 .SH "説明"
89 .PP
90 \fBjavac\fRコマンドは、Javaプログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラス・ファイルにコンパイルします。\fBjavac\fRコマンドでは、Javaソース・ファイルおよびクラス内の注釈の処理もできます。
91 .PP
92 ソース・コードのファイル名を\fBjavac\fRに渡すには、2つの方法があります。
93 .sp
94 .RS 4
95 .ie n \{\
96 \h'-04'\(bu\h'+03'\c
97 .\}
98 .el \{\
99 .sp -1
100 .IP \(bu 2.3
101 .\}
102 ソース・ファイルの数が少ない場合は、ファイル名をコマンド行で指定します。
103 .RE
104 .sp
105 .RS 4
106 .ie n \{\
107 \h'-04'\(bu\h'+03'\c
108 .\}
109 .el \{\
110 .sp -1
111 .IP \(bu 2.3
112 .\}
113 ソース・ファイルの数が多い場合は、ファイル内のファイル名を空白または改行で区切って指定します。\fBjavac\fRコマンドで、リスト・ファイル名の先頭にアットマーク(@)を使用します。
114 .RE
115 .PP
116 ソース・コードのファイル名は\&.java拡張子を、クラスのファイル名は\&.class拡張子を持っている必要があります。また、ソース・ファイルとクラス・ファイルのどちらも、該当するクラスに対応するルート名を持っている必要があります。たとえば、\fBMyClass\fRという名前のクラスは、\fBMyClass\&.java\fRという名前のソース・ファイルに記述されます。このソース・ファイルは、\fBMyClass\&.class\fRという名前のバイトコード・クラス・ファイルにコンパイルされます。
117 .PP
118 内部クラスが定義されていると、追加のクラス・ファイルが生成されます。これらのクラス・ファイルの名前は、\fBMyClass$MyInnerClass\&.class\fRのように、内部クラス名と外部クラス名を組み合せたものになります。
119 .PP
120 ソース・ファイルは、パッケージ・ツリーを反映したディレクトリ・ツリーに配置します。たとえば、すべてのソース・ファイルが\fB/workspace\fRにある場合、\fBcom\&.mysoft\&.mypack\&.MyClass\fRのソース・コードを、\fB/workspace/com/mysoft/mypack/MyClass\&.java\fRに格納します。
121 .PP
122 デフォルトでは、コンパイラは、各クラス・ファイルを対応するソース・ファイルと同じディレクトリに格納します。\fB\-d\fRオプションを使用して、別の出力先ディレクトリを指定できます。
123 .SH "オプション"
124 .PP
125 コンパイラには、現在の開発環境でサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来、変更される可能性があります。非標準オプションは、\fB\-X\fRオプションで始まります。
126 .sp
127 .RS 4
128 .ie n \{\
129 \h'-04'\(bu\h'+03'\c
130 .\}
131 .el \{\
132 .sp -1
133 .IP \(bu 2.3
134 .\}
135 クロスコンパイル・オプションも参照してください
136 .RE
137 .sp
138 .RS 4
139 .ie n \{\
140 \h'-04'\(bu\h'+03'\c
141 .\}
142 .el \{\
143 .sp -1
144 .IP \(bu 2.3
145 .\}
146 非標準オプションも参照してください
147 .RE
148 .SS "標準オプション"
149 .PP
150 \-A\fIkey\fR[\fI=value\fR]
151 .RS 4
152 注釈プロセッサに渡すオプションを指定します。これらのオプションは、\fBjavac\fRが直接解釈するのではなく、それぞれのプロセッサで使用できるようになります。\fBkey\fRの値は、1つまたは複数の識別子をドット(\&.)で区切る必要があります。
153 .RE
154 .PP
155 \-cp \fIpath\fR or \-classpath \fIpath\fR
156 .RS 4
157 ユーザー・クラス・ファイル、および(オプションで)注釈プロセッサとソース・ファイルを検索する場所を指定します。このクラス・パスは\fBCLASSPATH\fR環境変数のユーザー・クラス・パスをオーバーライドします。\fBCLASSPATH\fR、\fB\-cp\fR、\fB\-classpath\fRのいずれも指定されていない場合、ユーザーの\fIクラス・パス\fRは、現在のディレクトリになります。クラス・パスの設定 を参照してください。
158 .sp
159 \fB\-sourcepath\fRオプションが指定されていない場合、ソース・ファイルもユーザー・クラス・パスから検索されます。
160 .sp
161 \fB\-processorpath\fRオプションが指定されていない場合、注釈プロセッサもクラス・パスから検索されます。
162 .RE
163 .PP
164 \-Djava\&.ext\&.dirs=\fIdirectories\fR
165 .RS 4
166 インストール済拡張機能の位置をオーバーライドします。
167 .RE
168 .PP
169 \-Djava\&.endorsed\&.dirs=\fIdirectories\fR
170 .RS 4
171 承認された標準パスの位置をオーバーライドします。
172 .RE
173 .PP
174 \-d \fIdirectory\fR
175 .RS 4
176 クラス・ファイルの出力先ディレクトリを設定します。そのディレクトリは\fBjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、\fBjavac\fRは、パッケージ名を反映したサブディレクトリ内にクラス・ファイルを格納し、必要に応じてディレクトリを作成します。
177 .sp
178 \fB\-d\fR
179 \fB/home/myclasses\fRと指定し、クラスの名前が\fBcom\&.mypackage\&.MyClass\fRである場合、クラス・ファイルは\fB/home/myclasses/com/mypackage/MyClass\&.class\fRになります。
180 .sp
181 \fI\-d\fRオプションが指定されなかった場合、\fBjavac\fRは、各クラス・ファイルを、その生成元となるソース・ファイルと同じディレクトリ内に格納します。
182 .sp
183 \fB注意:\fR
184 \fI\-d\fRオプションによって指定されたディレクトリは、ユーザー・クラス・パスに自動的に追加されません。
185 .RE
186 .PP
187 \-deprecation
188 .RS 4
189 非推奨のメンバーまたはクラスが使用またはオーバーライドされるたびに、説明を表示します。\fB\-deprecation\fRオプションが指定されていない場合、\fBjavac\fRは、非推奨のメンバーまたはクラスを使用またはオーバーライドしているソース・ファイルのサマリーを表示します。\fB\-deprecation\fRオプションは、\fB\-Xlint:deprecation\fRの省略表記です。
190 .RE
191 .PP
192 \-encoding \fIencoding\fR
193 .RS 4
194 ソース・ファイルのエンコーディング名(EUC\-JPやUTF\-8など)を設定します。\fB\-encoding\fRオプションが指定されていない場合は、プラットフォームのデフォルト・コンバータが使用されます。
195 .RE
196 .PP
197 \-endorseddirs \fIdirectories\fR
198 .RS 4
199 承認された標準パスの位置をオーバーライドします。
200 .RE
201 .PP
202 \-extdirs \fIdirectories\fR
203 .RS 4
204 \fBext\fRディレクトリの位置をオーバーライドします。directories変数には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各JARファイルから、クラス・ファイルが検索されます。検出されたすべてのJARファイルは、クラス・パスの一部になります。
205 .sp
206 クロスコンパイル(異なるJavaプラットフォームに実装されたブートストラップ・クラスや拡張機能クラスに対してコンパイルを行う)を実行する場合、このオプションには拡張機能クラスを含むディレクトリを指定します。詳細はクロスコンパイル・オプションを参照してください。
207 .RE
208 .PP
209 \-g
210 .RS 4
211 ローカル変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号およびソース・ファイル情報のみが生成されます。
212 .RE
213 .PP
214 \-g:none
215 .RS 4
216 デバッグ情報を生成しません。
217 .RE
218 .PP
219 \-g:[\fIkeyword list\fR]
220 .RS 4
221 カンマで区切られたキーワード・リストにより指定された、特定の種類のデバッグ情報のみを生成します。次のキーワードが有効です。
222 .PP
223 source
224 .RS 4
225 ソース・ファイルのデバッグ情報。
226 .RE
227 .PP
228 lines
229 .RS 4
230 行番号のデバッグ情報。
231 .RE
232 .PP
233 vars
234 .RS 4
235 ローカル変数のデバッグ情報。
236 .RE
237 .RE
238 .PP
239 \-help
240 .RS 4
241 標準オプションの概要を出力します。
242 .RE
243 .PP
244 \-implicit:[\fIclass, none\fR]
245 .RS 4
246 暗黙的にロードされたソース・ファイルに対するクラス・ファイルの生成を制御します。クラス・ファイルを自動生成するには、\fB\-implicit:class\fRを使用します。クラス・ファイルの生成を抑制するには、\fB\-implicit:none\fRを使用します。このオプションが指定されなかった場合のデフォルト動作は、クラス・ファイルの自動生成になります。その場合、そのようなクラス・ファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。\fB\-implicit\fRオプションが明示的に設定された場合、警告は発行されません。型の検索を参照してください。
247 .RE
248 .PP
249 \-J\fIoption\fR
250 .RS 4
251 Java Virtual Machine (JVM)に\fBoption\fRを渡します。optionには、Java起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
252 .sp
253 \fB注意:\fR
254 \fICLASSPATH\fR、\fB\-classpath\fR、\fB\-bootclasspath\fRおよび\fB\-extdirs\fRオプションは、\fBjavac\fRの実行に使用されるクラスを指定しません。これらのオプションおよび変数を使用してコンパイラの実装をカスタマイズしようとすると、リスクが高く、多くの場合、必要な処理が実行されません。コンパイラの実装をカスタマイズする必要がある場合、\fB\-J\fRオプションを使用して、基礎となるJava起動ツールにオプションを渡します。
255 .RE
256 .PP
257 \-nowarn
258 .RS 4
259 警告メッセージを無効にします。このオプションは、\fB\-Xlint:none\fRオプションと同じように動作します。
260 .RE
261 .PP
262 \-parameters
263 .RS 4
264 リフレクションAPIのメソッド\fBjava\&.lang\&.reflect\&.Executable\&.getParameters\fRが取得できるように、生成されるクラス・ファイル内のコンストラクタとメソッドの仮パラメータ名を格納します。
265 .RE
266 .PP
267 \-proc: [\fInone\fR, \fIonly\fR]
268 .RS 4
269 注釈処理およびコンパイルを実行するかを制御します。\fB\-proc:none\fRは、注釈処理なしでコンパイルが実行されることを意味します。\fB\-proc:only\fRは、注釈処理のみが実行され、後続のコンパイルはまったく実行されないことを意味します。
270 .RE
271 .PP
272 \-processor \fIclass1\fR [,\fIclass2\fR,\fIclass3\fR\&.\&.\&.]
273 .RS 4
274 実行する注釈プロセッサの名前。これを指定した場合、デフォルトの検索処理は省略されます。
275 .RE
276 .PP
277 \-processorpath \fIpath\fR
278 .RS 4
279 注釈プロセッサを検索する場所を指定します。このオプションが使用されない場合、クラス・パスのプロセッサが検索されます。
280 .RE
281 .PP
282 \-s \fIdir\fR
283 .RS 4
284 生成されたソース・ファイルの格納先となるディレクトリを指定します。そのディレクトリは\fBjavac\fRでは作成されないため、すでに存在している必要があります。クラスがパッケージの一部である場合、コンパイラは、パッケージ名を反映したサブディレクトリ内にソース・ファイルを格納し、必要に応じてディレクトリを作成します。
285 .sp
286 \fB\-s /home/mysrc\fRと指定し、クラスの名前が\fBcom\&.mypackage\&.MyClass\fRである場合、ソース・ファイルは\fB/home/mysrc/com/mypackage/MyClass\&.java\fRに格納されます。
287 .RE
288 .PP
289 \-source \fIrelease\fR
290 .RS 4
291 受け付けるソース・コードのバージョンを指定します。\fBrelease\fRには次の値を指定できます。
292 .PP
293 1\&.3
294 .RS 4
295 このコンパイラでは、Java SE 1\&.3以降に導入されたアサーション、総称または他の言語機能をサポートしません。
296 .RE
297 .PP
298 1\&.4
299 .RS 4
300 Java SE 1\&.4で導入された、アサーションを含むコードを受け付けます。
301 .RE
302 .PP
303 1\&.5
304 .RS 4
305 Java SE 5で導入された総称および他の言語機能を含んだコードを受け付けます。
306 .RE
307 .PP
308 5
309 .RS 4
310 1\&.5と同義です。
311 .RE
312 .PP
313 1\&.6
314 .RS 4
315 Java SE 6では言語に対する変更は導入されませんでした。しかし、ソース・ファイル内のエンコーディング・エラーが、Java Platform, Standard Editionの以前のリリースような警告ではなく、エラーとして報告されるようになりました。
316 .RE
317 .PP
318 6
319 .RS 4
320 1\&.6と同義です。
321 .RE
322 .PP
323 1\&.7
324 .RS 4
325 Java SE 7で導入された機能を含むコードを受け付けます。
326 .RE
327 .PP
328 7
329 .RS 4
330 1\&.7と同義です。
331 .RE
332 .PP
333 1\&.8
334 .RS 4
335 これがデフォルト値です。Java SE 8で導入された機能を含むコードを受け付けます。
336 .RE
337 .PP
338 8
339 .RS 4
340 1\&.8と同義です。
341 .RE
342 .RE
343 .PP
344 \-sourcepath \fIsourcepath\fR
345 .RS 4
346 クラスまたはインタフェースの定義を検索するソース・コード・パスを指定します。ユーザー・クラス・パスと同様に、ソース・パスのエントリは、Oracle Solarisではコロン(:)で、Windowsではセミコロンで区切り、ここには、ディレクトリ、JARアーカイブまたはZIPアーカイブを指定できます。パッケージを使用している場合は、ディレクトリまたはアーカイブ内のローカル・パス名がパッケージ名を反映している必要があります。
347 .sp
348 \fB注意:\fR
349 ソース・ファイルも見つかった場合、クラス・パスにより見つかったクラスは再コンパイルされる可能性があります。型の検索を参照してください。
350 .RE
351 .PP
352 \-verbose
353 .RS 4
354 ロードされるクラスおよびコンパイルされるソース・ファイルごとの情報が出力される、詳細出力を使用します。
355 .RE
356 .PP
357 \-version
358 .RS 4
359 リリース情報を出力します。
360 .RE
361 .PP
362 \-werror
363 .RS 4
364 警告が発生した場合にコンパイルを終了します。
365 .RE
366 .PP
367 \-X
368 .RS 4
369 非標準オプションに関する情報を表示して終了します。
370 .RE
371 .SS "クロスコンパイル・オプション"
372 .PP
373 デフォルトでは、クラスのコンパイルは、\fBjavac\fRが添付されているプラットフォームのブートストラップ・クラスおよび拡張機能クラスに対して行われます。ただし、\fBjavac\fRは、異なるJavaプラットフォームに実装されたブートストラップ・クラスおよび拡張機能クラスに対してコンパイルを行うクロスコンパイルもサポートしています。クロスコンパイルを行う場合は、\fB\-bootclasspath\fRおよび\fB\-extdirs\fRオプションを使用することが重要です。
374 .PP
375 \-target \fIversion\fR
376 .RS 4
377 仮想マシンの指定されたリリースを対象とするクラス・ファイルを生成します。クラス・ファイルは、指定されたターゲット以降のリリースでは動作しますが、それより前のリリースのJVMでは動作しません。有効なターゲットは、1\&.1、1\&.2、1\&.3、1\&.4、1\&.5 (5も可)、1\&.6 (6も可)、1\&.7 (7も可)および1\&.8 (8も可)です。
378 .sp
379 \fB\-target\fRオプションのデフォルトは、\fB\-source\fRオプションの値によって異なります。
380 .sp
381 .RS 4
382 .ie n \{\
383 \h'-04'\(bu\h'+03'\c
384 .\}
385 .el \{\
386 .sp -1
387 .IP \(bu 2.3
388 .\}
389 \fB\-source\fRオプションが指定されていない場合、\fB\-target\fRオプションの値は1\&.8です。
390 .RE
391 .sp
392 .RS 4
393 .ie n \{\
394 \h'-04'\(bu\h'+03'\c
395 .\}
396 .el \{\
397 .sp -1
398 .IP \(bu 2.3
399 .\}
400 \fB\-source\fRオプションが1\&.2の場合、\fB\-target\fRオプションの値は1\&.4です。
401 .RE
402 .sp
403 .RS 4
404 .ie n \{\
405 \h'-04'\(bu\h'+03'\c
406 .\}
407 .el \{\
408 .sp -1
409 .IP \(bu 2.3
410 .\}
411 \fB\-source\fRオプションが1\&.3の場合、\fB\-target\fRオプションの値は1\&.4です。
412 .RE
413 .sp
414 .RS 4
415 .ie n \{\
416 \h'-04'\(bu\h'+03'\c
417 .\}
418 .el \{\
419 .sp -1
420 .IP \(bu 2.3
421 .\}
422 \fB\-source\fRオプションが1\&.5の場合、\fB\-target\fRオプションの値は1\&.8です。
423 .RE
424 .sp
425 .RS 4
426 .ie n \{\
427 \h'-04'\(bu\h'+03'\c
428 .\}
429 .el \{\
430 .sp -1
431 .IP \(bu 2.3
432 .\}
433 \fB\-source\fRオプションが1\&.6の場合、\fB\-target\fRオプションの値は1\&.8です。
434 .RE
435 .sp
436 .RS 4
437 .ie n \{\
438 \h'-04'\(bu\h'+03'\c
439 .\}
440 .el \{\
441 .sp -1
442 .IP \(bu 2.3
443 .\}
444 \fB\-source\fRオプションが1\&.7の場合、\fB\-target\fRオプションの値は1\&.8です。
445 .RE
446 .sp
447 .RS 4
448 .ie n \{\
449 \h'-04'\(bu\h'+03'\c
450 .\}
451 .el \{\
452 .sp -1
453 .IP \(bu 2.3
454 .\}
455 \fB\-source\fRオプションの他のすべての値の場合、\fB\-target\fRオプションの値は、\fB\-source\fRオプションの値になります。
456 .RE
457 .RE
458 .PP
459 \-bootclasspath \fIbootclasspath\fR
460 .RS 4
461 指定された一連のブート・クラスに対してクロスコンパイルを行います。ユーザー・クラス・パスと同様に、ブート・クラス・パスのエントリはコロン(:)で区切り、ここには、ディレクトリ、JARアーカイブまたはZIPアーカイブを指定できます。
462 .RE
463 .SS "コンパクト・プロファイル・オプション"
464 .PP
465 JDK 8以降から、\fBjavac\fRコンパイラはコンパクト・プロファイルをサポートします。コンパクト・プロファイルを使用すると、Javaプラットフォーム全体を必要としないアプリケーションは、デプロイ可能で、小さいフットプリントで実行できます。コンパクト・プロファイル機能は、アプリケーション・ストアからのアプリケーションのダウンロード時間を短縮するのに使用できます。この機能は、JREをバンドルするJavaアプリケーションの、よりコンパクトなデプロイメントに役立ちます。この機能は、小さいデバイスでも役立ちます。
466 .PP
467 サポートされているプロファイル値は、\fBcompact1\fR、\fBcompact2\fRおよび\fBcompact3\fRです。これらは、追加のレイヤーです。大きい番号の各コンパクト・プロファイルには、小さい番号の名前のプロファイル内のすべてのAPIが含まれます。
468 .PP
469 \-profile
470 .RS 4
471 コンパクト・プロファイルを使用する場合、このオプションは、コンパイル時にプロファイル名を指定します。次に例を示します。
472 .sp
473 .if n \{\
474 .RS 4
475 .\}
476 .nf
477 \fBjavac \-profile compact1 Hello\&.java\fR
478
479 .fi
480 .if n \{\
481 .RE
482 .\}
483 javacは、指定されたプロファイルにない任意のJava SE APIを使用するソース・コードをコンパイルしません。これは、そのようなソース・コードをコンパイルしようとすることによって生じるエラー・メッセージの例です。
484 .sp
485 .if n \{\
486 .RS 4
487 .\}
488 .nf
489 \fBcd jdk1\&.8\&.0/bin\fR
490 \fB\&./javac \-profile compact1 Paint\&.java\fR
491 \fBPaint\&.java:5: error: Applet is not available in profile \*(Aqcompact1\*(Aq\fR
492 \fBimport java\&.applet\&.Applet;\fR
493
494 .fi
495 .if n \{\
496 .RE
497 .\}
498 この例では、\fBApplet\fRクラスを使用しないようにソースを変更することによって、エラーを修正できます。\-profileオプションを指定せずにコンパイルすることによって、エラーを修正することもできます。コンパイルは、Java SE APIの完全なセットに対して実行されます。(どのコンパクト・プロファイルにも、\fBApplet\fRクラスは含まれていません。)
499 .sp
500 コンパクト・プロファイルを使用してコンパイルするための別の方法として、\fB\-bootclasspath\fRオプションを使用して、プロファイルのイメージを指定する\fBrt\&.jar\fRファイルへのパスを指定します。かわりに\fB\-profile\fRオプションを使用すると、プロファイル・イメージは、コンパイル時にシステム上に存在する必要がありません。これは、クロスコンパイル時に役立ちます。
501 .RE
502 .SS "非標準オプション"
503 .PP
504 \-Xbootclasspath/p:\fIpath\fR
505 .RS 4
506 ブートストラップ・クラス・パスに接尾辞を追加します。
507 .RE
508 .PP
509 \-Xbootclasspath/a:\fIpath\fR
510 .RS 4
511 ブートストラップ・クラス・パスに接頭辞を追加します。
512 .RE
513 .PP
514 \-Xbootclasspath/:\fIpath\fR
515 .RS 4
516 ブートストラップ・クラス・ファイルの位置をオーバーライドします。
517 .RE
518 .PP
519 \-Xdoclint:[\-]\fIgroup\fR [\fI/access\fR]
520 .RS 4
521 \fIgroup\fRの値が\fBaccessibility\fR、\fBsyntax\fR、\fBreference\fR、\fBhtml\fRまたは\fBmissing\fRのいずれかである特定のチェック・グループを有効または無効にします。これらのチェック・グループの詳細は、\fBjavadoc\fRコマンドの\fB\-Xdoclint\fRオプションを参照してください。\fB\-Xdoclint\fRオプションは、\fBjavac\fRコマンドではデフォルトで無効になります。
522 .sp
523 変数\fIaccess\fRは、\fB\-Xdoclint\fRオプションがチェックするクラスとメンバーの最小の可視性レベルを指定します。\fBpublic\fR、\fBprotected\fR、\fBpackage\fRおよび\fBprivate\fRの値(可視性の高い順)の1つを持つことができます。たとえば、次のオプションは、(protected、package、publicを含む) protected以上のアクセス・レベルを持つクラスおよびメンバーを(すべてのチェック・グループで)チェックします。
524 .sp
525 .if n \{\
526 .RS 4
527 .\}
528 .nf
529 \fB\-Xdoclint:all/protected\fR
530
531 .fi
532 .if n \{\
533 .RE
534 .\}
535 次のオプションは、package以上のアクセス権(packageおよびpublicを含む)を持つクラスおよびメンバーに対するHTMLエラーをチェックしないことを除き、すべてのアクセス・レベルに対してすべてのチェック・グループを有効にします。
536 .sp
537 .if n \{\
538 .RS 4
539 .\}
540 .nf
541 \fB\-Xdoclint:all,\-html/package\fR
542
543 .fi
544 .if n \{\
545 .RE
546 .\}
547 .RE
548 .PP
549 \-Xdoclint:none
550 .RS 4
551 すべてのチェック・グループを無効にします。
552 .RE
553 .PP
554 \-Xdoclint:all[\fI/access\fR]
555 .RS 4
556 すべてのチェック・グループを有効にします。
557 .RE
558 .PP
559 \-Xlint
560 .RS 4
561 推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告を有効にすることをお薦めします。
562 .RE
563 .PP
564 \-Xlint:all
565 .RS 4
566 推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告を有効にすることをお薦めします。
567 .RE
568 .PP
569 \-Xlint:none
570 .RS 4
571 すべての警告を無効にします。
572 .RE
573 .PP
574 \-Xlint:\fIname\fR
575 .RS 4
576 警告名を無効にします。このオプションで無効にできる警告のリストは、\-Xlintオプションを使用した警告の有効化または無効化を参照してください。
577 .RE
578 .PP
579 \-Xlint:\fI\-name\fR
580 .RS 4
581 警告名を無効にします。このオプションで無効にできる警告のリストを取得するには、\-Xlintオプションを使用した警告の有効化または無効化\-Xlint\fBオプションを使用した\fRを参照してください。
582 .RE
583 .PP
584 \-Xmaxerrs \fInumber\fR
585 .RS 4
586 印刷するエラーの最大数を設定します。
587 .RE
588 .PP
589 \-Xmaxwarns \fInumber\fR
590 .RS 4
591 印刷する警告の最大数を設定します。
592 .RE
593 .PP
594 \-Xstdout \fIfilename\fR
595 .RS 4
596 コンパイラのメッセージを、指定されたファイルに送信します。デフォルトでは、コンパイラのメッセージは\fBSystem\&.err\fRに送られます。
597 .RE
598 .PP
599 \-Xprefer:[\fInewer,source\fR]
600 .RS 4
601 ある型に対してソース・ファイルとクラス・ファイルの両方が見つかった場合、そのどちらのファイルを読み取るかを指定します。(型の検索を参照してください)。\fB\-Xprefer:newer\fRオプションを使用した場合、ある型に対するソース・ファイルとクラス・ファイルのうち新しい方が読み取られます(デフォルト)。\fB\-Xprefer:source\fRオプションを使用した場合、ソース・ファイルが読み取られます。\fBSOURCE\fRの保存ポリシーを使用して宣言された注釈に任意の注釈プロセッサがアクセスできるようにする場合は、\fB\-Xprefer:source\fRを使用してください。
602 .RE
603 .PP
604 \-Xpkginfo:[\fIalways\fR,\fIlegacy\fR,\fInonempty\fR]
605 .RS 4
606 javacがpackage\-info\&.javaファイルから\fBpackage\-info\&.class\fRファイルを生成するかどうかを制御します。このオプションで使用可能なmode引数は次のとおりです。
607 .PP
608 always
609 .RS 4
610 すべての\fBpackage\-info\&.java\fRファイルの\fBpackage\-info\&.class\fRファイルを常に生成します。このオプションは、各\fB\&.java\fRファイルに対応する\fB\&.class\fRファイルがあることを確認するAntなどのビルド・システムを使用する場合に役立つことがあります。
611 .RE
612 .PP
613 legacy
614 .RS 4
615 package\-info\&.javaに注釈が含まれる場合にのみ\fBpackage\-info\&.class\fRファイルを生成します。package\-info\&.javaにコメントのみ含まれる場合に\fBpackage\-info\&.class\fRファイルを生成しません。
616 .sp
617 \fB注意:\fR
618 \fBpackage\-info\&.class\fRファイルは生成できますが、package\-info\&.javaファイル内のすべての注釈に\fBRetentionPolicy\&.SOURCE\fRがある場合は空になります。
619 .RE
620 .PP
621 nonempty
622 .RS 4
623 package\-info\&.javaに\fBRetentionPolicy\&.CLASS\fRまたは\fBRetentionPolicy\&.RUNTIME\fRとともに注釈が含まれる場合にのみ\fBpackage\-info\&.class\fRファイルを生成します。
624 .RE
625 .RE
626 .PP
627 \-Xprint
628 .RS 4
629 デバッグ目的で指定した型のテキスト表示を出力します。注釈処理もコンパイルも実行されません。出力形式は変更される可能性があります。
630 .RE
631 .PP
632 \-XprintProcessorInfo
633 .RS 4
634 ある特定のプロセッサが処理を依頼されている注釈に関する情報を出力します。
635 .RE
636 .PP
637 \-XprintRounds
638 .RS 4
639 初回および後続の注釈処理ラウンドに関する情報を出力します。
640 .RE
641 .SH "-XLINTオプションを使用した警告の有効化または無効化"
642 .PP
643 \fB\-Xlint:name\fRオプションを使用して警告\fIname\fRを有効にします。ここで、\fBname\fRは次の警告名のいずれかになります。\fB\-Xlint:\-name:\fRオプションを使用して、警告を無効化できます。
644 .PP
645 cast
646 .RS 4
647 不要で冗長なキャストについて警告します。たとえば、次のようになります。
648 .sp
649 .if n \{\
650 .RS 4
651 .\}
652 .nf
653 \fBString s = (String) "Hello!"\fR
654
655 .fi
656 .if n \{\
657 .RE
658 .\}
659 .RE
660 .PP
661 classfile
662 .RS 4
663 クラス・ファイルの内容に関連した問題について警告します。
664 .RE
665 .PP
666 deprecation
667 .RS 4
668 非推奨の項目の使用について警告します。たとえば、次のようになります。
669 .sp
670 .if n \{\
671 .RS 4
672 .\}
673 .nf
674 \fBjava\&.util\&.Date myDate = new java\&.util\&.Date();\fR
675 \fBint currentDay = myDate\&.getDay();\fR
676
677 .fi
678 .if n \{\
679 .RE
680 .\}
681 メソッド\fBjava\&.util\&.Date\&.getDay\fRはJDK 1\&.1以降は非推奨になりました。
682 .RE
683 .PP
684 dep\-ann
685 .RS 4
686 \fB@deprecated\fR
687 Javadocコメントでドキュメント化されているが、\fB@Deprecated\fR注釈が付いていない項目について警告します。たとえば、次のようになります。
688 .sp
689 .if n \{\
690 .RS 4
691 .\}
692 .nf
693 \fB/**\fR
694 \fB * @deprecated As of Java SE 7, replaced by {@link #newMethod()}\fR
695 \fB */\fR
696 \fBpublic static void deprecatedMethood() { }\fR
697 \fBpublic static void newMethod() { }\fR
698
699 .fi
700 .if n \{\
701 .RE
702 .\}
703 .RE
704 .PP
705 divzero
706 .RS 4
707 定整数0で除算されることについて警告します。たとえば、次のようになります。
708 .sp
709 .if n \{\
710 .RS 4
711 .\}
712 .nf
713 \fBint divideByZero = 42 / 0;\fR
714
715 .fi
716 .if n \{\
717 .RE
718 .\}
719 .RE
720 .PP
721 empty
722 .RS 4
723 \fBif \fR文以降が空の文であることについて警告します。たとえば、次のようになります。
724 .sp
725 .if n \{\
726 .RS 4
727 .\}
728 .nf
729 \fBclass E {\fR
730 \fB void m() {\fR
731 \fB if (true) ;\fR
732 \fB }\fR
733 \fB}\fR
734
735 .fi
736 .if n \{\
737 .RE
738 .\}
739 .RE
740 .PP
741 fallthrough
742 .RS 4
743 fall\-throughケースのswitchブロックをチェックし、検出されたものに対して警告メッセージを表示します。Fall\-throughケースは、switchブロック内の最後のケースを除くケースです。このコードにはbreak文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、このswitchブロック内のcase 1ラベルに続くコードは、break文で終わっていません。
744 .sp
745 .if n \{\
746 .RS 4
747 .\}
748 .nf
749 \fBswitch (x) {\fR
750 \fBcase 1:\fR
751 \fB System\&.out\&.println("1");\fR
752 \fB // No break statement here\&.\fR
753 \fBcase 2:\fR
754 \fB System\&.out\&.println("2");\fR
755 \fB}\fR
756
757 .fi
758 .if n \{\
759 .RE
760 .\}
761 このコードのコンパイル時に\fB\-Xlint:fallthrough\fRオプションが使用されていた場合、コンパイラは、問題になっているケースの行番号とともに、caseにfall\-throughする可能性があることを示す警告を発行します。
762 .RE
763 .PP
764 finally
765 .RS 4
766 正常に完了できない\fBfinally\fR句について警告します。たとえば、次のようになります。
767 .sp
768 .if n \{\
769 .RS 4
770 .\}
771 .nf
772 \fBpublic static int m() {\fR
773 \fB try {\fR
774 \fB throw new NullPointerException();\fR
775 \fB } catch (NullPointerException(); {\fR
776 \fB System\&.err\&.println("Caught NullPointerException\&.");\fR
777 \fB return 1;\fR
778 \fB } finally {\fR
779 \fB return 0;\fR
780 \fB }\fR
781 \fB }\fR
782
783 .fi
784 .if n \{\
785 .RE
786 .\}
787 この例では、コンパイラは\fBfinally\fRブロックに関する警告を生成します。\fBint\fRメソッドが呼び出されると、値0が返されます。\fBfinally\fRブロックは、\fBtry\fRブロックが終了すると実行されます。この例では、制御が\fBcatch\fRブロックに移された場合、\fBint\fRメソッドは終了します。ただし、\fBfinally\fRブロックは実行される必要があるため、制御がメソッドの外部に移されていても、このブロックは実行されます。
788 .RE
789 .PP
790 options
791 .RS 4
792 コマンド行オプションの使用に関する問題について警告します。クロスコンパイル・オプションを参照してください。
793 .RE
794 .PP
795 overrides
796 .RS 4
797 メソッドのオーバーライドに関する問題について警告します。たとえば、次の2つのクラスがあるとします。
798 .sp
799 .if n \{\
800 .RS 4
801 .\}
802 .nf
803 \fBpublic class ClassWithVarargsMethod {\fR
804 \fB void varargsMethod(String\&.\&.\&. s) { }\fR
805 \fB}\fR
806
807 \fBpublic class ClassWithOverridingMethod extends ClassWithVarargsMethod {\fR
808 \fB @Override\fR
809 \fB void varargsMethod(String[] s) { }\fR
810 \fB}\fR
811
812 .fi
813 .if n \{\
814 .RE
815 .\}
816 コンパイラは、次のような警告を生成します。
817 .sp
818 .if n \{\
819 .RS 4
820 .\}
821 .nf
822 \fBwarning: [override] varargsMethod(String[]) in ClassWithOverridingMethod \fR
823 \fBoverrides varargsMethod(String\&.\&.\&.) in ClassWithVarargsMethod; overriding\fR
824 \fBmethod is missing \*(Aq\&.\&.\&.\*(Aq\fR
825
826 .fi
827 .if n \{\
828 .RE
829 .\}
830 コンパイラは、\fBvarargs\fRメソッドを検出すると、\fBvarargs\fRの仮パラメータを配列に変換します。メソッド\fBClassWithVarargsMethod\&.varargsMethod\fRでは、コンパイラは\fBvarargs\fRの仮パラメータ\fBString\&.\&.\&. s\fRを仮パラメータ\fBString[] s\fRに変換します。これは、メソッド\fBClassWithOverridingMethod\&.varargsMethod\fRの仮パラメータに対応する配列です。その結果、この例ではコンパイルが行われます。
831 .RE
832 .PP
833 path
834 .RS 4
835 コマンド行での無効なパス要素と存在しないパス・ディレクトリについて警告します(クラス・パス、ソース・パスなどのパス関連)。このような警告を\fB@SuppressWarnings\fR注釈で抑制することはできません。たとえば、次のようになります。
836 .sp
837 .if n \{\
838 .RS 4
839 .\}
840 .nf
841 \fBjavac \-Xlint:path \-classpath /nonexistentpath Example\&.java\fR
842
843 .fi
844 .if n \{\
845 .RE
846 .\}
847 .RE
848 .PP
849 processing
850 .RS 4
851 注釈処理に関する問題について警告します。コンパイラがこの警告を生成するのは、注釈を含むクラスがあるときに、使用している注釈プロセッサでそのタイプの例外を処理できない場合です。たとえば、単純な注釈プロセッサを次に示します。
852 .sp
853 \fBソース・ファイルAnnocProc\&.java\fR:
854 .sp
855 .if n \{\
856 .RS 4
857 .\}
858 .nf
859 \fBimport java\&.util\&.*;\fR
860 \fBimport javax\&.annotation\&.processing\&.*;\fR
861 \fBimport javax\&.lang\&.model\&.*;\fR
862 \fBimport\&.javaz\&.lang\&.model\&.element\&.*;\fR
863
864 \fB@SupportedAnnotationTypes("NotAnno")\fR
865 \fBpublic class AnnoProc extends AbstractProcessor {\fR
866 \fB public boolean process(Set<? extends TypeElement> elems, RoundEnvironment renv){\fR
867 \fB return true;\fR
868 \fB }\fR
869
870 \fB public SourceVersion getSupportedSourceVersion() {\fR
871 \fB return SourceVersion\&.latest();\fR
872 \fB }\fR
873 \fB}\fR
874
875 .fi
876 .if n \{\
877 .RE
878 .\}
879 \fBソース・ファイルAnnosWithoutProcessors\&.java\fR:
880 .sp
881 .if n \{\
882 .RS 4
883 .\}
884 .nf
885 \fB@interface Anno { }\fR
886 \fB \fR
887 \fB@Anno\fR
888 \fBclass AnnosWithoutProcessors { }\fR
889
890 .fi
891 .if n \{\
892 .RE
893 .\}
894 次のコマンドは、注釈プロセッサ\fBAnnoProc\fRをコンパイルし、この注釈プロセッサをソース・ファイル\fBAnnosWithoutProcessors\&.java\fRに対して実行します。
895 .sp
896 .if n \{\
897 .RS 4
898 .\}
899 .nf
900 \fBjavac AnnoProc\&.java\fR
901 \fBjavac \-cp \&. \-Xlint:processing \-processor AnnoProc \-proc:only AnnosWithoutProcessors\&.java\fR
902
903 .fi
904 .if n \{\
905 .RE
906 .\}
907 コンパイラがソース・ファイル\fBAnnosWithoutProcessors\&.java\fRに対して注釈プロセッサを実行すると、次の警告が生成されます。
908 .sp
909 .if n \{\
910 .RS 4
911 .\}
912 .nf
913 \fBwarning: [processing] No processor claimed any of these annotations: Anno\fR
914 \fB \fR
915 .fi
916 .if n \{\
917 .RE
918 .\}
919 この問題を解決するために、クラス\fBAnnosWithoutProcessors\fRで定義および使用される注釈の名前を、\fBAnno\fRから\fBNotAnno\fRに変更できます。
920 .RE
921 .PP
922 rawtypes
923 .RS 4
924 raw型に対する未検査操作について警告します。次の文では、\fBrawtypes\fR警告が生成されます。
925 .sp
926 .if n \{\
927 .RS 4
928 .\}
929 .nf
930 \fBvoid countElements(List l) { \&.\&.\&. }\fR
931
932 .fi
933 .if n \{\
934 .RE
935 .\}
936 次の例では、\fBrawtypes\fR警告は生成されません。
937 .sp
938 .if n \{\
939 .RS 4
940 .\}
941 .nf
942 \fBvoid countElements(List<?> l) { \&.\&.\&. }\fR
943
944 .fi
945 .if n \{\
946 .RE
947 .\}
948 \fBList\fRはraw型です。ただし、\fBList<?>\fRは、アンバウンド形式のワイルドカードのパラメータ化された型です。\fBList\fRはパラメータ化されたインタフェースであるため、常にその型引数を指定します。この例では、\fBList\fRの仮引数はアンバウンド形式のワイルドカード(\fB?\fR)を使用してその仮型パラメータとして指定されます。つまり、\fBcountElements\fRメソッドは\fBList\fRインタフェースのどのインスタンス化も受け付けることができます。
949 .RE
950 .PP
951 Serial
952 .RS 4
953 直列化可能クラスに\fBserialVersionUID\fR定義がないことを警告します。たとえば、次のようになります。
954 .sp
955 .if n \{\
956 .RS 4
957 .\}
958 .nf
959 \fBpublic class PersistentTime implements Serializable\fR
960 \fB{\fR
961 \fB private Date time;\fR
962 \fB \fR
963 \fB public PersistentTime() {\fR
964 \fB time = Calendar\&.getInstance()\&.getTime();\fR
965 \fB }\fR
966 \fB \fR
967 \fB public Date getTime() {\fR
968 \fB return time;\fR
969 \fB }\fR
970 \fB}\fR
971
972 .fi
973 .if n \{\
974 .RE
975 .\}
976 コンパイラは次の警告を生成します。
977 .sp
978 .if n \{\
979 .RS 4
980 .\}
981 .nf
982 \fBwarning: [serial] serializable class PersistentTime has no definition of\fR
983 \fBserialVersionUID\fR
984
985 .fi
986 .if n \{\
987 .RE
988 .\}
989 直列化可能クラスが\fBserialVersionUID\fRという名前のフィールドを明示的に宣言しない場合、直列化ランタイム環境では、「Javaオブジェクト直列化仕様」で説明されているように、クラスの様々な側面に基づいて、クラスの\fBserialVersionUID\fRのデフォルト値を計算します。ただし、すべての直列化可能クラスが\fBserialVersionUID\fR値を明示的に宣言することを強くお薦めします。 これは、\fBserialVersionUID\fR値を計算するデフォルトのプロセスが、コンパイラの実装によって異なる可能性のあるクラスの詳細にきわめて影響を受けやすく、その結果、直列化復元中に予期しない\fBInvalidClassExceptions\fRが発生する可能性があるためです。Javaコンパイラの実装が異なっても\fBserialVersionUID\fR値の一貫性を確保にするには、直列化可能クラスが\fBserialVersionUID\fR値を明示的に宣言する必要があります。
990 .RE
991 .PP
992 static
993 .RS 4
994 staticの使用に関する問題について警告します。たとえば、次のようになります。
995 .sp
996 .if n \{\
997 .RS 4
998 .\}
999 .nf
1000 \fBclass XLintStatic {\fR
1001 \fB static void m1() { }\fR
1002 \fB void m2() { this\&.m1(); }\fR
1003 \fB}\fR
1004
1005 .fi
1006 .if n \{\
1007 .RE
1008 .\}
1009 コンパイラは次の警告を生成します。
1010 .sp
1011 .if n \{\
1012 .RS 4
1013 .\}
1014 .nf
1015 \fBwarning: [static] static method should be qualified by type name, \fR
1016 \fBXLintStatic, instead of by an expression\fR
1017
1018 .fi
1019 .if n \{\
1020 .RE
1021 .\}
1022 この問題を解決するために、次のように\fBstatic\fRメソッド\fBm1\fRを呼び出すことができます。
1023 .sp
1024 .if n \{\
1025 .RS 4
1026 .\}
1027 .nf
1028 \fBXLintStatic\&.m1();\fR
1029
1030 .fi
1031 .if n \{\
1032 .RE
1033 .\}
1034 あるいは、\fBstatic\fRキーワードをメソッド\fBm1\fRの宣言から削除することもできます。
1035 .RE
1036 .PP
1037 try
1038 .RS 4
1039 try\-with\-resources文を含む、\fBtry\fRブロックの使用に関する問題について警告します。たとえば、\fBtry\fRブロックで宣言されたリソース\fBac\fRが使用されないために、次の文に対して警告が生成されます。
1040 .sp
1041 .if n \{\
1042 .RS 4
1043 .\}
1044 .nf
1045 \fBtry ( AutoCloseable ac = getResource() ) { // do nothing}\fR
1046
1047 .fi
1048 .if n \{\
1049 .RE
1050 .\}
1051 .RE
1052 .PP
1053 unchecked
1054 .RS 4
1055 Java言語仕様で指定されている未検査変換警告の詳細を示します。たとえば、次のようになります。
1056 .sp
1057 .if n \{\
1058 .RS 4
1059 .\}
1060 .nf
1061 \fBList l = new ArrayList<Number>();\fR
1062 \fBList<String> ls = l; // unchecked warning\fR
1063
1064 .fi
1065 .if n \{\
1066 .RE
1067 .\}
1068 型の削除中、型\fBArrayList<Number>\fRおよび\fBList<String>\fRは、それぞれ\fBArrayList\fRおよび\fBList\fRになります。
1069 .sp
1070 \fBls\fRコマンドには、パラメータ化された型\fBList<String>\fRが指定されています。\fBl\fRによって参照される\fBList\fRが\fBls\fRに割り当てられた場合、コンパイラは未検査警告を生成します。コンパイル時に、コンパイラおよびJVMは、\fBl\fRが\fBList<String>\fR型を参照するかどうかを判別できません。この場合、\fBl\fRは、\fBList<String>\fR型を参照しません。その結果、ヒープ汚染が発生します。
1071 .sp
1072 ヒープ汚染状態が発生するのは、\fBList\fRオブジェクト\fBl\fR
1073 (そのstatic型は\fBList<Number>\fR)が別の\fBList\fRオブジェクト\fBls\fR
1074 (異なるstatic型\fBList<String>\fRを持つ)に代入される場合です。しかし、コンパイラではこの代入をいまだに許可しています。総称をサポートしないJava SEのリリースとの後方互換性を確保するために、この代入を許可する必要があります。型の削除のため、\fBList<Number>\fRおよび\fBList<String>\fRは、両方\fBList\fRになります。その結果、コンパイラはオブジェクト\fBl\fR
1075 (\fBList\fRというraw型を持つ)をオブジェクト\fBls\fRに代入することを許可します。
1076 .RE
1077 .PP
1078 varargs
1079 .RS 4
1080 可変引数(\fBvarargs\fR)メソッド、特に非具象化可能引数を含むものの使用が安全でないことを警告します。たとえば、次のようになります。
1081 .sp
1082 .if n \{\
1083 .RS 4
1084 .\}
1085 .nf
1086 \fBpublic class ArrayBuilder {\fR
1087 \fB public static <T> void addToList (List<T> listArg, T\&.\&.\&. elements) {\fR
1088 \fB for (T x : elements) {\fR
1089 \fB listArg\&.add(x);\fR
1090 \fB }\fR
1091 \fB }\fR
1092 \fB}\fR
1093
1094 .fi
1095 .if n \{\
1096 .RE
1097 .\}
1098 \fB注意:\fR
1099 非具象化可能型は、型情報が実行時に完全に使用不可能な型です。
1100 .sp
1101 コンパイラは、メソッド\fBArrayBuilder\&.addToList\fRの定義に関する次の警告を生成します。
1102 .sp
1103 .if n \{\
1104 .RS 4
1105 .\}
1106 .nf
1107 \fBwarning: [varargs] Possible heap pollution from parameterized vararg type T\fR
1108
1109 .fi
1110 .if n \{\
1111 .RE
1112 .\}
1113 コンパイラは、varargsメソッドを検出すると、\fBvarargs\fRの仮パラメータを配列に変換します。しかし、Javaプログラミング言語では、パラメータ化された型の配列の作成を許可していません。メソッド\fBArrayBuilder\&.addToList\fRでは、コンパイラは\fBvarargs\fRの仮パラメータ\fBT\&.\&.\&.\fR要素を仮パラメータ\fBT[]\fR要素(配列)に変換します。しかし、型消去により、コンパイラは\fBvarargs\fRの仮パラメータを\fBObject[]\fR要素に変換します。その結果、ヒープ汚染が発生する可能性があります。
1114 .RE
1115 .SH "コマンド行引数ファイル"
1116 .PP
1117 \fBjavac\fRコマンドを短くしたり簡潔にしたりするために、\fBjavac\fRコマンドに対する引数(\fB\-J\fRオプションを除く)を含む1つ以上のファイルを指定することができます。これにより、どのオペレーティング・システム上でも、任意の長さの\fBjavac\fRコマンドを作成できます。
1118 .PP
1119 引数ファイルには、\fBjavac\fRのオプションとソース・ファイル名を自由に組み合せて記述できます。ファイル内の引数は、空白または改行文字で区切ることができます。ファイル名に埋め込まれた空白がある場合、ファイル名全体を二重引用符で囲みます。
1120 .PP
1121 引数ファイル内のファイル名は、引数ファイルの位置ではなく、現在のディレクトリに相対的となります。これらのリストでは、ワイルドカード(*)は使用できません(たとえば、\fB*\&.java\fRとは指定できません)。アットマーク(@)を使用したファイルの再帰的な解釈はサポートされていません。また、\fB\-J\fRオプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
1122 .PP
1123 \fBjavac\fRコマンドを実行するときに、各引数ファイルのパスと名前の先頭にアットマーク(@)文字を付けて渡します。\fBjavac\fRコマンドは、アットマーク(@)で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
1124 .PP
1125 \fB例 1 \fR単一の引数ファイル
1126 .RS 4
1127 \fBargfile\fRという名前の単一の引数ファイルを使用して、すべての\fBjavac\fR引数を格納する場合は、次のように指定します。
1128 .sp
1129 .if n \{\
1130 .RS 4
1131 .\}
1132 .nf
1133 \fBjavac @argfile\fR
1134
1135 .fi
1136 .if n \{\
1137 .RE
1138 .\}
1139 この引数ファイルには、例2で示されている両方のファイルの内容を入れることができます。
1140 .RE
1141 .PP
1142 \fB例 2 \fR2つの引数ファイル
1143 .RS 4
1144 \fBjavac\fRオプション用とソース・ファイル名用に、2つの引数ファイルを作成できます。次のリストには、行の継続文字はありません。
1145 .sp
1146 次を含むoptionsという名前のファイルを作成します。
1147 .sp
1148 .if n \{\
1149 .RS 4
1150 .\}
1151 .nf
1152 \fB\-d classes\fR
1153 .fi
1154 .if n \{\
1155 .RE
1156 .\}
1157 .sp
1158 .if n \{\
1159 .RS 4
1160 .\}
1161 .nf
1162 \fB\-g\fR
1163 .fi
1164 .if n \{\
1165 .RE
1166 .\}
1167 .sp
1168 .if n \{\
1169 .RS 4
1170 .\}
1171 .nf
1172 \fB\-sourcepath /java/pubs/ws/1\&.3/src/share/classes\fR
1173 .fi
1174 .if n \{\
1175 .RE
1176 .\}
1177 .sp
1178 .if n \{\
1179 .RS 4
1180 .\}
1181 .nf
1182
1183 .fi
1184 .if n \{\
1185 .RE
1186 .\}
1187 次を含むclassesという名前のファイルを作成します。
1188 .sp
1189 .if n \{\
1190 .RS 4
1191 .\}
1192 .nf
1193 \fBMyClass1\&.java\fR
1194 \fBMyClass2\&.java\fR
1195 \fBMyClass3\&.java\fR
1196
1197 .fi
1198 .if n \{\
1199 .RE
1200 .\}
1201 それから、次のように\fBjavac\fRコマンドを実行します。
1202 .sp
1203 .if n \{\
1204 .RS 4
1205 .\}
1206 .nf
1207 \fBjavac @options @classes\fR
1208
1209 .fi
1210 .if n \{\
1211 .RE
1212 .\}
1213 .RE
1214 .PP
1215 \fB例 3 \fRパスを使用した引数ファイル
1216 .RS 4
1217 引数ファイルはパスを指定できますが、ファイル内のすべてのファイル名は、(\fBpath1\fRや\fBpath2\fRではなく)次のように現在の作業ディレクトリに相対的となります。
1218 .sp
1219 .if n \{\
1220 .RS 4
1221 .\}
1222 .nf
1223 \fBjavac @path1/options @path2/classes\fR
1224
1225 .fi
1226 .if n \{\
1227 .RE
1228 .\}
1229 .RE
1230 .SH "注釈処理"
1231 .PP
1232 \fBjavac\fRコマンドが注釈処理を直接サポートしているため、独立した注釈処理コマンドである\fBapt\fRを使用する必要がなくなりました。
1233 .PP
1234 注釈プロセッサのAPIは、\fBjavax\&.annotation\&.processing\fRおよび\fBjavax\&.lang\&.model\fRパッケージとそのサブパッケージ内に定義されています。
1235 .SS "注釈処理を行う方法"
1236 .PP
1237 \fB\-proc:none\fRオプションによって注釈処理が無効化されない限り、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは、\fB\-processorpath\fRオプションを使用して指定できます。パスを指定しない場合、ユーザー・クラス・パスが使用されます。プロセッサの検索は、検索パス上の\fBMETA\-INF/services/javax\&.annotation\&.processing\fR\&.Processorという名前のサービス・プロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1行に1つずつ含めてください。また、別の方法として、\fB\-processor\fRオプションを使用してプロセッサを明示的に指定することもできます。
1238 .PP
1239 コンパイラは、コマンド行のソース・ファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問合せを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を要求できます。その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されると、コンパイラはそれ以上プロセッサの検索を行いません。
1240 .PP
1241 いずれかのプロセッサによって新しいソース・ファイルが生成されると、注釈処理の2回目のラウンドが開始されます。新しく生成されたすべてのソース・ファイルがスキャンされ、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソース・ファイルが生成されなくなるまで続きます。
1242 .PP
1243 あるラウンドで新しいソース・ファイルが生成されなかった場合、注釈プロセッサがあと1回のみ呼び出され、残りの処理を実行する機会が与えられます。最後に、\fB\-proc:only\fRオプションが使用されないかぎり、コンパイラは、元のソース・ファイルと生成されたすべてのソース・ファイルをコンパイルします。
1244 .SS "暗黙的にロードされたソース・ファイル"
1245 .PP
1246 コンパイラは、一連のソース・ファイルをコンパイルする際に、別のソース・ファイルを暗黙的にロードすることが必要な場合があります。型の検索を参照してください。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされた任意のソース・ファイルがコンパイルされた場合、コンパイラは警告を発行します。\fB\-implicit\fRオプションでは、警告を抑制する方法が提供されます。
1247 .SH "型の検索"
1248 .PP
1249 ソース・ファイルをコンパイルするために、コンパイラは通常、型に関する情報を必要としますが、その型の定義はコマンド行で指定したソース・ファイルにありません。コンパイラは、ソース・ファイルで使用されているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソース・ファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。
1250 .PP
1251 たとえば、サブクラス\fBjava\&.applet\&.Applet\fRを作成すると、\fBアプレット\fRの祖先のクラス(\fBjava\&.awt\&.Panel\fR、\fBjava\&.awt\&.Container\fR、\fBjava\&.awt\&.Component\fRおよび\fBjava\&.lang\&.Object\fR)を使用していることにもなります。
1252 .PP
1253 コンパイラは、型の情報が必要になると、その型を定義しているソース・ファイルまたはクラス・ファイルを検索します。まず、ブートストラップ・クラスと拡張機能クラスを検索し、続いてユーザー・クラス・パス(デフォルトでは現在のディレクトリ)を検索します。ユーザー・クラス・パスは、\fBCLASSPATH\fR環境変数を設定して定義するか、または\fB\-classpath\fRオプションを使用して定義します。
1254 .PP
1255 \fB\-sourcepath\fRオプションが設定されている場合、コンパイラは、指定されたパスからソース・ファイルを検索します。それ以外の場合、コンパイラは、ユーザー・クラス・パスからクラス・ファイルとソース・ファイルの両方を検索します。
1256 .PP
1257 \fB\-bootclasspath\fRオプションおよび\fB\-extdirs\fRオプションを使用して、別のブートストラップ・クラスや拡張機能クラスを指定できます。クロスコンパイル・オプションを参照してください。
1258 .PP
1259 型の検索に成功したときに得られる結果は、クラス・ファイル、ソース・ファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用するかを\fB\-Xprefer\fRオプションでコンパイラに指示できます。\fBnewer\fRが指定された場合、コンパイラは2つのファイルのうち新しい方を使用します。\fBsource\fRが指定された場合、コンパイラはソース・ファイルを使用します。デフォルトは\fBnewer\fRです。
1260 .PP
1261 型の検索自体によって、または\fB\-Xprefer\fRオプションが設定された結果として必要な型のソース・ファイルが見つかった場合、コンパイラはそのソース・ファイルを読み取り、必要な情報を取得します。デフォルトでは、コンパイラはソース・ファイルのコンパイルも行います。\fB\-implicit\fRオプションを使用してその動作を指定できます。\fBnone\fRが指定された場合、ソース・ファイルに対してクラス・ファイルは生成されません。\fBclass\fRが指定された場合、ソース・ファイルに対してクラス・ファイルが生成されます。
1262 .PP
1263 コンパイラは、注釈処理が完了するまで、ある型情報の必要性を認識しない場合があります。型情報がソース・ファイル内に見つかり、かつ\fB\-implicit\fRオプションが指定されていない場合、コンパイラによって、そのファイルが注釈処理の対象とならずにコンパイルされることが警告されます。この警告を無効にするには、(そのファイルが注釈処理の対象となるように)そのファイルをコマンド行に指定するか、あるいはそのようなソース・ファイルに対してクラス・ファイルを生成する必要があるかどうかを\fB\-implicit\fRオプションを使用して指定します。
1264 .SH "プログラマティック・インタフェース"
1265 .PP
1266 \fBjavac\fRコマンドは、\fBjavax\&.tools\fRパッケージ内のクラスとインタフェースによって定義される新しいJava Compiler APIをサポートします。
1267 .SS "例"
1268 .PP
1269 コマンド行引数を指定するようにコンパイルするには、次の構文を使用します。
1270 .sp
1271 .if n \{\
1272 .RS 4
1273 .\}
1274 .nf
1275 \fBJavaCompiler javac = ToolProvider\&.getSystemJavaCompiler();\fR
1276
1277 .fi
1278 .if n \{\
1279 .RE
1280 .\}
1281 .PP
1282 例では、診断を標準出力ストリームに書き込み、コマンド行からの呼出し時に\fBjavac\fRが指定する終了コードを返します。
1283 .PP
1284 \fBjavax\&.tools\&.JavaCompiler\fRインタフェースの他のメソッドを使用すると、診断の処理やファイルの読取り元/書込み先の制御などを行うことができます。
1285 .SS "旧式のインタフェース"
1286 .PP
1287 \fB注意:\fR
1288 このAPIは、後方互換性のためにのみ保持されています。すべての新しいコードは、新しいJava Compiler APIを使用する必要があります。
1289 .PP
1290 次のように、\fBcom\&.sun\&.tools\&.javac\&.Main\fRクラスには、プログラムからコンパイラを呼び出すためのstaticメソッドが2つ用意されています。
1291 .sp
1292 .if n \{\
1293 .RS 4
1294 .\}
1295 .nf
1296 \fBpublic static int compile(String[] args);\fR
1297 \fBpublic static int compile(String[] args, PrintWriter out);\fR
1298
1299 .fi
1300 .if n \{\
1301 .RE
1302 .\}
1303 .PP
1304 \fBargs\fRパラメータは、通常コンパイラに渡される任意のコマンド行引数を表しています。
1305 .PP
1306 \fBout\fRパラメータは、コンパイラの診断出力の宛先を示します。
1307 .PP
1308 \fBreturn\fR値は、\fBjavac\fRの\fBexit\fR値と同じです。
1309 .PP
1310 \fB注意:\fR
1311 名前が\fBcom\&.sun\&.tools\&.javac\fRで始まるパッケージ(\fBcom\&.sun\&.tools\&.javac\fRのサブパッケージ)で検出される他のすべてのクラスおよびメソッドは、完全に内部用であり、いつでも変更される可能性があります。
1312 .SH "例"
1313 .PP
1314 \fB例 1 \fR簡単なプログラムのコンパイル
1315 .RS 4
1316 この例では、greetingsディレクトリで\fBHello\&.java\fRソース・ファイルをコンパイルする方法を示しています。\fBHello\&.java\fRで定義されたクラスは、\fBgreetings\&.Hello\fRと呼ばれます。greetingsディレクトリは、ソース・ファイルとクラス・ファイルの両方があるパッケージ・ディレクトリで、現在のディレクトリのすぐ下にあります。これにより、デフォルトのユーザー・クラス・パスを使用できるようになります。また、\fB\-d\fRオプションを使用して別の出力先ディレクトリを指定する必要もありません。
1317 .sp
1318 \fBHello\&.java\fR内のソース・コードは次のとおりです。
1319 .sp
1320 .if n \{\
1321 .RS 4
1322 .\}
1323 .nf
1324 \fBpackage greetings;\fR
1325 \fB \fR
1326 \fBpublic class Hello {\fR
1327 \fB public static void main(String[] args) {\fR
1328 \fB for (int i=0; i < args\&.length; i++) {\fR
1329 \fB System\&.out\&.println("Hello " + args[i]);\fR
1330 \fB }\fR
1331 \fB }\fR
1332 \fB}\fR
1333
1334 .fi
1335 .if n \{\
1336 .RE
1337 .\}
1338 greetings\&.Helloのコンパイル:
1339 .sp
1340 .if n \{\
1341 .RS 4
1342 .\}
1343 .nf
1344 \fBjavac greetings/Hello\&.java\fR
1345
1346 .fi
1347 .if n \{\
1348 .RE
1349 .\}
1350 \fBgreetings\&.Hello\fRの実行:
1351 .sp
1352 .if n \{\
1353 .RS 4
1354 .\}
1355 .nf
1356 \fBjava greetings\&.Hello World Universe Everyone\fR
1357 \fBHello World\fR
1358 \fBHello Universe\fR
1359 \fBHello Everyone\fR
1360
1361 .fi
1362 .if n \{\
1363 .RE
1364 .\}
1365 .RE
1366 .PP
1367 \fB例 2 \fR複数のソース・ファイルのコンパイル
1368 .RS 4
1369 この例では、\fBgreetings\fRパッケージのソース・ファイル\fBAloha\&.java\fR、\fBGutenTag\&.java\fR、\fBHello\&.java\fRおよび\fBHi\&.java\fRをコンパイルします。
1370 .sp
1371 .if n \{\
1372 .RS 4
1373 .\}
1374 .nf
1375 \fB% javac greetings/*\&.java\fR
1376 \fB% ls greetings\fR
1377 \fBAloha\&.class GutenTag\&.class Hello\&.class Hi\&.class\fR
1378 \fBAloha\&.java GutenTag\&.java Hello\&.java Hi\&.java\fR
1379
1380 .fi
1381 .if n \{\
1382 .RE
1383 .\}
1384 .RE
1385 .PP
1386 \fB例 3 \fRユーザー・クラス・パスの指定
1387 .RS 4
1388 前述の例のソース・ファイルのうち1つを変更した後に、そのファイルを再コンパイルします。
1389 .sp
1390 .if n \{\
1391 .RS 4
1392 .\}
1393 .nf
1394 \fBpwd\fR
1395 \fB/examples\fR
1396 \fBjavac greetings/Hi\&.java\fR
1397
1398 .fi
1399 .if n \{\
1400 .RE
1401 .\}
1402 \fBgreetings\&.Hi\fRは\fBgreetings\fRパッケージ内の他のクラスを参照しているため、コンパイラはこれらの他のクラスを探す必要があります。デフォルトのユーザー・クラス・パスはパッケージ・ディレクトリを含むディレクトリであるため、前述の例は動作します。現在のディレクトリを気にせずにこのファイルを再コンパイルする場合、\fBCLASSPATH\fRを設定して、ユーザー・クラス・パスに例のディレクトリを追加します。この例では、\fB\-classpath\fRオプションを使用しています。
1403 .sp
1404 .if n \{\
1405 .RS 4
1406 .\}
1407 .nf
1408 \fBjavac \-classpath /examples /examples/greetings/Hi\&.java\fR
1409
1410 .fi
1411 .if n \{\
1412 .RE
1413 .\}
1414 \fBgreetings\&.Hi\fRを変更してバナー・ユーティリティを使用するようにした場合、 そのユーティリティもユーザー・クラス・パスを通じてアクセスできるようになっている必要があります。
1415 .sp
1416 .if n \{\
1417 .RS 4
1418 .\}
1419 .nf
1420 \fBjavac \-classpath /examples:/lib/Banners\&.jar \e\fR
1421 \fB /examples/greetings/Hi\&.java\fR
1422
1423 .fi
1424 .if n \{\
1425 .RE
1426 .\}
1427 \fBgreetings\fRパッケージでクラスを実行するには、プログラムは\fBgreetings\fRパッケージ、および\fBgreetings\fRクラスが使用するクラスにアクセスする必要があります。
1428 .sp
1429 .if n \{\
1430 .RS 4
1431 .\}
1432 .nf
1433 \fBjava \-classpath /examples:/lib/Banners\&.jar greetings\&.Hi\fR
1434
1435 .fi
1436 .if n \{\
1437 .RE
1438 .\}
1439 .RE
1440 .PP
1441 \fB例 4 \fRソース・ファイルとクラス・ファイルの分離
1442 .RS 4
1443 次の例では、\fBjavac\fRを使用して、JVM 1\&.7上で実行するコードをコンパイルします。
1444 .sp
1445 .if n \{\
1446 .RS 4
1447 .\}
1448 .nf
1449 \fBjavac \-source 1\&.7 \-target 1\&.7 \-bootclasspath jdk1\&.7\&.0/lib/rt\&.jar \e \fR
1450 \fB\-extdirs "" OldCode\&.java\fR
1451
1452 .fi
1453 .if n \{\
1454 .RE
1455 .\}
1456 \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オプションを省略できます。
1457 .sp
1458 \fB\-bootclasspath\fRオプションを使用して、適切なバージョンのブートストラップ・クラス(\fBrt\&.jar\fRライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。
1459 .sp
1460 .if n \{\
1461 .RS 4
1462 .\}
1463 .nf
1464 \fBjavac \-source 1\&.7 OldCode\&.java\fR
1465 \fBwarning: [options] bootstrap class path not set in conjunction with \fR
1466 \fB\-source 1\&.7\fR
1467
1468 .fi
1469 .if n \{\
1470 .RE
1471 .\}
1472 適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様(この例では、バージョン1\&.7のJavaプログラミング言語)を新しいブートストラップ・クラスと組み合せて使用します。その結果、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 7)で動作しない可能性があります。
1473 .RE
1474 .PP
1475 \fB例 5 \fRクロス・コンパイル
1476 .RS 4
1477 この例では、\fBjavac\fRを使用して、JVM 1\&.7上で実行するコードをコンパイルします。
1478 .sp
1479 .if n \{\
1480 .RS 4
1481 .\}
1482 .nf
1483 \fBjavac \-source 1\&.7 \-target 1\&.7 \-bootclasspath jdk1\&.7\&.0/lib/rt\&.jar \e\fR
1484 \fB \-extdirs "" OldCode\&.java\fR
1485
1486 .fi
1487 .if n \{\
1488 .RE
1489 .\}
1490 \fB \-source 1\&.7\fRオプションにより、OldCode\&.javaのコンパイルにはリリース1\&.7(または7)のJavaプログラミング言語が使用されます。\fB\-target 1\&.7\fRオプションにより、JVM 1\&.7と互換性のあるクラス・ファイルが生成されます。
1491 .sp
1492 \fB\-bootclasspath\fRオプションを使用して、適切なバージョンのブートストラップ・クラス(\fBrt\&.jar\fRライブラリ)を指定する必要があります。指定しない場合は、コンパイラによって次の警告が生成されます。
1493 .sp
1494 .if n \{\
1495 .RS 4
1496 .\}
1497 .nf
1498 \fBjavac \-source 1\&.7 OldCode\&.java\fR
1499 \fBwarning: [options] bootstrap class path not set in conjunction with \-source 1\&.7\fR
1500
1501 .fi
1502 .if n \{\
1503 .RE
1504 .\}
1505 適切なバージョンのブートストラップ・クラスを指定しない場合、コンパイラは古い言語仕様を新しいブートストラップ・クラスと組み合せて使用します。この組合せは、存在しないメソッドへの参照が含まれていることがあるため、クラス・ファイルが古いプラットフォーム(この場合はJava SE 7)で動作しない可能性があります。この例では、コンパイラはJavaプログラミング言語のリリース1\&.7を使用します。
1506 .RE
1507 .SH "関連項目"
1508 .sp
1509 .RS 4
1510 .ie n \{\
1511 \h'-04'\(bu\h'+03'\c
1512 .\}
1513 .el \{\
1514 .sp -1
1515 .IP \(bu 2.3
1516 .\}
1517 java(1)
1518 .RE
1519 .sp
1520 .RS 4
1521 .ie n \{\
1522 \h'-04'\(bu\h'+03'\c
1523 .\}
1524 .el \{\
1525 .sp -1
1526 .IP \(bu 2.3
1527 .\}
1528 jdb(1)
1529 .RE
1530 .sp
1531 .RS 4
1532 .ie n \{\
1533 \h'-04'\(bu\h'+03'\c
1534 .\}
1535 .el \{\
1536 .sp -1
1537 .IP \(bu 2.3
1538 .\}
1539 javadoc(1)
1540 .RE
1541 .sp
1542 .RS 4
1543 .ie n \{\
1544 \h'-04'\(bu\h'+03'\c
1545 .\}
1546 .el \{\
1547 .sp -1
1548 .IP \(bu 2.3
1549 .\}
1550 jar(1)
1551 .RE
1552 .sp
1553 .RS 4
1554 .ie n \{\
1555 \h'-04'\(bu\h'+03'\c
1556 .\}
1557 .el \{\
1558 .sp -1
1559 .IP \(bu 2.3
1560 .\}
1561 jdb(1)
1562 .RE
1563 .br
1564 'pl 8.5i
1565 'bp