Old src/linux/doc/man/ja/apt.1

   1 '\" t
   2 .\"
   3 .\" Copyright 2004-2006 Sun Microsystems, Inc.  All Rights Reserved.
   4 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   5 .\"
   6 .\" This code is free software; you can redistribute it and/or modify it
   7 .\" under the terms of the GNU General Public License version 2 only, as
   8 .\" published by the Free Software Foundation.
   9 .\"
  10 .\" This code is distributed in the hope that it will be useful, but WITHOUT
  11 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  12 .\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  13 .\" version 2 for more details (a copy is included in the LICENSE file that
  14 .\" accompanied this code).
  15 .\"
  16 .\" You should have received a copy of the GNU General Public License version
  17 .\" 2 along with this work; if not, write to the Free Software Foundation,
  18 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  19 .\"
  20 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  21 .\" or visit www.oracle.com if you need additional information or have any
  22 .\" questions.
  23 .\" 
  24 .\"
  25 .\" 
  26 .TH apt 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
  27 .SH "名前"
  28 apt \- 注釈処理ツール
  29 .\"
  30 .SH "形式"
  31 .B apt 
  32 .BI [\-classpath " classpath"]
  33 .BI [\-sourcepath " sourcepath"]
  34 .BI [\-d " directory"]
  35 .BI [\-s " directory"]
  36 .BI [\-factorypath " path"]
  37 .BI [\-factory " class"]
  38 .B [\-print]
  39 .B [\-nocompile]
  40 .B [\-Akey[=val] ...]
  41 .BI [javac option]
  42 .BI sourcefiles
  43 .BI [@files]
  44 .SH "パラメータ" 
  45 オプションは任意の順序で使用できます。特定のオプションに適用される
  46 パラメータについては、後述の「オプション」を参照してください。
  47 .if t .TP 20
  48 .if n .TP 15
  49 .I sourcefiles
  50 処理される 0 個以上のソースファイル。
  51 .if t .TP 20
  52 .if n .TP 15
  53 .I @files
  54 ソースファイルまたはその他のオプションをリストする 1 個以上のファイル。
  55 .SH "機能説明"
  56 注釈処理ツール
  57 .B apt 
  58 には、プログラム注釈を処理するための一連の
  59 新しいリフレクション API とインフラストラクチャサポートが含まれています。
  60 .B apt 
  61 のリフレクション API では、プログラム構造のビューが、
  62 ビルド時のソースベースの読み取り専用として用意されています。
  63 これらのリフレクション API は、総称型の追加後に、
  64 Java(TM) プログラミング言語の型システムを
  65 わかりやすくモデル化できるように設計されました。
  66 はじめに、
  67 .B apt 
  68 は注釈プロセッサを実行します。この注釈プロセッサでは、
  69 新規のソースコードおよびその他のファイルを生成します。
  70 次に、オリジナルのソースファイルと生成したソースファイルの両方をコンパイルし、
  71 開発を容易にします。ツールと対話するためのリフレクション API と
  72 その他の API は、
  73 .B com.sun.mirror 
  74 のサブパッケージです。
  75 .LP
  76 .B apt 
  77 によるツールの操作方法と開発手順についての詳細は、
  78 http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.html
  79 の「Getting Started with apt」を参照してください。
  80 .LP
  81 .TP 3
  82 注: 
  83 \f2apt\fP\f2 の機能\fPは標準の注釈処理インフラストラクチャに組み込まれました。この標準のインフラストラクチャは、今では \f2javac\fP ツール [
  84 .na
  85 \f2Solaris と Linux\fP の場合: 
  86 .fi
  87 http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [
  88 .na
  89 \f2Windows\fP の場合: 
  90 .fi
  91 http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html] の一部となり、すべての Java コンパイラで使用できるように標準化されています。この新しいインフラストラクチャは、Java プラットフォームの一部となった言語モデルと注釈処理 API に依存しています。新しい注釈プロセッサの開発は、この新しい API と \f2javac\fP ツールに基づいて行うことをお勧めします。
  92 .LP
  93 .SH "オプション"
  94 .SS apt 固有のオプション
  95 .if t .TP 20
  96 .if n .TP 15
  97 .BI \-s " dir"
  98 プロセッサが生成するソースファイルが配置されるディレクトリルートを
  99 指定します。ファイルはパッケージのネームスペースに従って、
 100 サブディレクトリに配置されます。
 101 .if t .TP 20
 102 .if n .TP 15
 103 .BI \-nocompile
 104 ソースファイルをクラスファイルにコンパイルしません。
 105 .if t .TP 20
 106 .if n .TP 15
 107 .BI \-print
 108 指定した型のテキスト表現を出力します。
 109 注釈処理やコンパイルは実行しません。
 110 .if t .TP 20
 111 .if n .TP 15
 112 .BI \-A[key[=val]]
 113 注釈プロセッサに渡されるオプション。
 114 .B apt 
 115 は、これらのオプションを直接解釈しませんが、個別のプロセッサ
 116 によって使用可能になります。
 117 .if t .TP 20
 118 .if n .TP 15
 119 .BI \-factorypath " path" 
 120 注釈プロセッサファクトリを検索する場所を指定します。
 121 このオプションを使用する場合、ファクトリの検索に
 122 クラスパスは使用されません。
 123 .if t .TP 20
 124 .if n .TP 15
 125 .BI \-factory " classname"
 126 使用する注釈プロセッサファクトリの名前。
 127 デフォルトの検出処理はバイパスされます。
 128 .SS javac と共有されるオプション
 129 .if t .TP 20
 130 .if n .TP 15
 131 .BI \-d " dir"
 132 プロセッサおよび 
 133 .B javac 
 134 が生成したクラスファイルを配置する場所を指定します。
 135 .if t .TP 20
 136 .if n .TP 15
 137 .BI \-cp " path " \fLまたは\fP \fL\-classpath " path"
 138 ユーザクラスファイルおよび注釈プロセッサファクトリを検索する場所を
 139 指定します。
 140 .B \-factorypath 
 141 を指定した場合、ファクトリの検索にクラスパスは使用されません。
 142 .LP
 143 javac のオプションについては、
 144 .BR javac(1) 
 145 のマニュアルページを参照してください。
 146 .SH 注意事項
 147 .LP
 148 \f2apt\fP の機能は、\f2javac\fP が提供するようになった標準の注釈処理インフラストラクチャに組み込まれました。\f2apt\fP とその関連 API のサポートは、JDK の将来のリリースで打ち切られる可能性があります。
 149 .LP
 150 .SH "関連項目"
 151 .LP
 152 .RS 3
 153 .TP 2
 154 *
 155 javac: [
 156 .na
 157 \f2Solaris と Linux\fP の場合: 
 158 .fi
 159 http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] 
 160 [ \f2Windows\fP の場合: 
 161 .fi
 162 http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html] 
 163 .TP 2
 164 *
 165 java: [
 166 .na
 167 \f2Solaris\fP の場合: 
 168 .fi
 169 http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html] [
 170 .na
 171 \f2Linux\fP の場合: 
 172 .fi
 173 http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html] 
 174 [ \f2Windows\fP の場合: 
 175 .fi
 176 http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html] 
 177 .RE
 178 
 179 .LP
 180