1 '\" t
   2 .\" Copyright 2006 Sun Microsystems, Inc.  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 .TH apt 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
  24 .SH "名前"
  25 apt \- 注釈処理ツール
  26 .\"
  27 .SH "形式"
  28 .B apt 
  29 .BI [\-classpath " classpath"]
  30 .BI [\-sourcepath " sourcepath"]
  31 .BI [\-d " directory"]
  32 .BI [\-s " directory"]
  33 .BI [\-factorypath " path"]
  34 .BI [\-factory " class"]
  35 .B [\-print]
  36 .B [\-nocompile]
  37 .B [\-Akey[=val] ...]
  38 .BI [javac option]
  39 .BI sourcefiles
  40 .BI [@files]
  41 .SH "パラメータ" 
  42 オプションは任意の順序で使用できます。特定のオプションに適用される
  43 パラメータについては、後述の「オプション」を参照してください。
  44 .if t .TP 20
  45 .if n .TP 15
  46 .I sourcefiles
  47 処理される 0 個以上のソースファイル。
  48 .if t .TP 20
  49 .if n .TP 15
  50 .I @files
  51 ソースファイルまたはその他のオプションをリストする 1 個以上のファイル。
  52 .SH "機能説明"
  53 注釈処理ツール
  54 .B apt 
  55 には、プログラム注釈を処理するための一連の
  56 新しいリフレクション API とインフラストラクチャサポートが含まれています。
  57 .B apt 
  58 のリフレクション API では、プログラム構造のビューが、
  59 ビルド時のソースベースの読み取り専用として用意されています。
  60 これらのリフレクション API は、総称型の追加後に、
  61 Java(TM) プログラミング言語の型システムを
  62 わかりやすくモデル化できるように設計されました。
  63 はじめに、
  64 .B apt 
  65 は注釈プロセッサを実行します。この注釈プロセッサでは、
  66 新規のソースコードおよびその他のファイルを生成します。
  67 次に、オリジナルのソースファイルと生成したソースファイルの両方をコンパイルし、
  68 開発を容易にします。ツールと対話するためのリフレクション API と
  69 その他の API は、
  70 .B com.sun.mirror 
  71 のサブパッケージです。
  72 .LP
  73 .B apt 
  74 によるツールの操作方法と開発手順についての詳細は、
  75 http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.html
  76 の「Getting Started with apt」を参照してください。
  77 .LP
  78 .TP 3
  79 注: 
  80 \f2apt\fP\f2 の機能\fPは標準の注釈処理インフラストラクチャに組み込まれました。この標準のインフラストラクチャは、今では \f2javac\fP ツール [
  81 .na
  82 \f2Solaris と Linux\fP の場合: 
  83 .fi
  84 http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [
  85 .na
  86 \f2Windows\fP の場合: 
  87 .fi
  88 http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html] の一部となり、すべての Java コンパイラで使用できるように標準化されています。この新しいインフラストラクチャは、Java プラットフォームの一部となった言語モデルと注釈処理 API に依存しています。新しい注釈プロセッサの開発は、この新しい API と \f2javac\fP ツールに基づいて行うことをお勧めします。
  89 .LP
  90 .SH "オプション"
  91 .SS apt 固有のオプション
  92 .if t .TP 20
  93 .if n .TP 15
  94 .BI \-s " dir"
  95 プロセッサが生成するソースファイルが配置されるディレクトリルートを
  96 指定します。ファイルはパッケージのネームスペースに従って、
  97 サブディレクトリに配置されます。
  98 .if t .TP 20
  99 .if n .TP 15
 100 .BI \-nocompile
 101 ソースファイルをクラスファイルにコンパイルしません。
 102 .if t .TP 20
 103 .if n .TP 15
 104 .BI \-print
 105 指定した型のテキスト表現を出力します。
 106 注釈処理やコンパイルは実行しません。
 107 .if t .TP 20
 108 .if n .TP 15
 109 .BI \-A[key[=val]]
 110 注釈プロセッサに渡されるオプション。
 111 .B apt 
 112 は、これらのオプションを直接解釈しませんが、個別のプロセッサ
 113 によって使用可能になります。
 114 .if t .TP 20
 115 .if n .TP 15
 116 .BI \-factorypath " path" 
 117 注釈プロセッサファクトリを検索する場所を指定します。
 118 このオプションを使用する場合、ファクトリの検索に
 119 クラスパスは使用されません。
 120 .if t .TP 20
 121 .if n .TP 15
 122 .BI \-factory " classname"
 123 使用する注釈プロセッサファクトリの名前。
 124 デフォルトの検出処理はバイパスされます。
 125 .SS javac と共有されるオプション
 126 .if t .TP 20
 127 .if n .TP 15
 128 .BI \-d " dir"
 129 プロセッサおよび 
 130 .B javac 
 131 が生成したクラスファイルを配置する場所を指定します。
 132 .if t .TP 20
 133 .if n .TP 15
 134 .BI \-cp " path " \fLまたは\fP \fL\-classpath " path"
 135 ユーザクラスファイルおよび注釈プロセッサファクトリを検索する場所を
 136 指定します。
 137 .B \-factorypath 
 138 を指定した場合、ファクトリの検索にクラスパスは使用されません。
 139 .LP
 140 javac のオプションについては、
 141 .BR javac(1) 
 142 のマニュアルページを参照してください。
 143 .SH 注意事項
 144 .LP
 145 \f2apt\fP の機能は、\f2javac\fP が提供するようになった標準の注釈処理インフラストラクチャに組み込まれました。\f2apt\fP とその関連 API のサポートは、JDK の将来のリリースで打ち切られる可能性があります。
 146 .LP
 147 .SH "関連項目"
 148 .LP
 149 .RS 3
 150 .TP 2
 151 *
 152 javac: [
 153 .na
 154 \f2Solaris と Linux\fP の場合: 
 155 .fi
 156 http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] 
 157 [ \f2Windows\fP の場合: 
 158 .fi
 159 http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html] 
 160 .TP 2
 161 *
 162 java: [
 163 .na
 164 \f2Solaris\fP の場合: 
 165 .fi
 166 http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html] [
 167 .na
 168 \f2Linux\fP の場合: 
 169 .fi
 170 http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html] 
 171 [ \f2Windows\fP の場合: 
 172 .fi
 173 http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html] 
 174 .RE
 175 
 176 .LP
 177