OSDN Git Service

autoconf, configureの索引を追加. 自動設定->autoconfと分かりやすく.
[omake-japanese/omake_trans.git] / omake-options.rst
1 .. A. OMake command-line options
2
3 .. _labelA:
4
5 A. OMake コマンドラインオプション
6 ======================================
7
8 ``omake [-j <count>] [-k] [-p] [-P] [-n] [-s] [-S] [-w] [-t] [-u] [-U] [-R] [--verbose] [--project] [--depend] [--progress] [--print-status] [--print-exit] [--print-dependencies] [--show-dependencies <target>] [--all-dependencies] [--verbose-dependencies] [--force-dotomake] [--dotomake <dir>] [--flush-includes] [--configure] [--save-interval <seconds>] [--install] [--install-all] [--install-force] [--version] [--absname] [--output-normal] [--output-postpone] [--output-only-errors] [--output-at-end] filename... [var-definition...]``
9
10 .. _labelA.1:
11
12 A.1 一般的な使い方
13 ----------------------------------
14 .. For Boolean options (for example, -s, --progress, etc.) the option can include a prefix --no, which inverts the usual sense of the option. For example, the option --progress means “print a progress bar,” while the option --no--progress means “do not print a progress bar.”
15
16 ブーリアンオプション(例えば ``-s`` , ``--progress`` など…)は意味を逆転させる接頭辞 ``--no`` を付与することができます。例えば、オプション ``--progress`` は『プログレスバーを表示する』ことを示していますが、オプション ``--no--progress`` は『プログレスバーを表示しない』ことを示しています。
17
18 .. If multiple instances of an option are specified, the final option determines the behavior of OMake. In the following command line, the final --no-S cancels the earlier -S.
19
20 複数の重複するオプションが指定されていた場合、最後のオプションがOMakeでのふるまいを決定します。以下のコマンドラインでは、最後の ``--no-S`` が前の ``-S`` オプションを打ち消します。 ::
21
22     % omake -S --progress --no-S
23
24 .. _labelA.2:
25
26 A.2 出力のコントロール
27 ----------------------------------
28
29 .. index::
30    single: -s
31 .. _labelA.2.1:
32
33 A.2.1 -s
34 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
35 ``-s``
36
37 .. Never not print commands as they are executed (be “silent”).
38
39 コマンドが実行された場合でも、決してコマンドの内容を表示しません("silent")。
40
41 .. index::
42    single: -S
43 .. _labelA.2.2:
44
45 A.2.2 -S
46 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
47 ``-S``
48
49 .. Do not print commands as they are executed unless they produce output and/or fail. This is the default.
50
51 コマンドが出力を生成したり、失敗したりするまでは、コマンドの内容を表示しません。このオプションはデフォルトで有効です。
52
53 .. index::
54    single: -w
55 .. _labelA.2.3:
56
57 A.2.3 -w
58 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
59 ``-w``
60
61 .. Print directory information in make format as commands are executed. This is mainly useful for editors that expect make-style directory information for determining the location of errors.
62
63 コマンドが実行される時点でのディレクトリの情報を ``make`` フォーマットで表示します。これはエラー場所を特定するため、makeスタイルのディレクトリの情報を切望しているエディターにとって、とても有用なオプションです。
64
65 .. index::
66    single: --progress
67 .. _labelA.2.4:
68
69 A.2.4 -progress
70 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
71 ``--progress``
72
73 .. Print a progress indicator. This option is enabled by default when the OMake's output (stdout) is on a terminal and disabled by default (except on Windows) when the OMake's output is redirected.
74
75 進捗状況(プログレスバー)を表示します。このオプションは、OMakeの出力先( ``stdout`` )がターミナルとなっている場合はデフォルトで有効となり、OMakeの出力先がリダイレクトされている場合はデフォルトで無効となります(Windowsを除く)。
76
77 .. index::
78    single: --print-status
79 .. _labelA.2.5:
80
81 A.2.5 -print-status
82 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
83 ``--print-status``
84
85 .. Print status lines (the + and - lines).
86
87 ステータスライン( ``+`` と ``-`` ライン)を表示します。
88
89 .. index::
90    single: --print-exit
91 .. _labelA.2.6:
92
93 A.2.6 -print-exit
94 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
95 ``--print-exit``
96
97 .. Print termination codes when commands complete.
98
99 コマンドが成功した場合には終了コードを表示します。
100
101 .. index::
102    single: --verbose
103 .. _labelA.2.7:
104
105 A.2.7 -verbose
106 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
107 ``--verbose``
108
109 .. Make OMake very verbose. This option is equivalent to --no-S --print-status --print-exit VERBOSE=true
110
111 OMakeの出力を詳細に表示します。このオプションは ``--no-S --print-status --print-exit VERBOSE=true`` と等価です。
112
113 .. index::
114    single: --output-normal
115 .. _labelA.2.8:
116
117 A.2.8 -output-normal
118 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
119 ``--output-normal``
120
121 .. As rule commands are executed, relay their output to the OMake output right away. This is enabled by default, unless --output-postpone or --output-only-errors is enabled.
122
123 ルールコマンドを実行した時点で、コマンドの出力をOMakeの出力へと即座に受け渡します。これは ``--output-postpone`` か ``--output-only-errors`` が有効になっていない限りデフォルトで有効です。
124
125 .. index::
126    single: --output-postpone
127 .. _labelA.2.9:
128
129 A.2.9 -output-postpone
130 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
131 ``--output-postpone``
132
133 .. When a rule finishes, print the output as a single block. This is useful in combination -j option (see Section A.3.12), where the output of multiple subprocesses can be garbled. The diversion is printed as a single coherent unit.
134
135 ルールが完了した際に、出力を一つのブロックとして一気に表示します。これは複数のサブプロセスの出力をまとめてくれる(garbled) ``-j`` オプション( :ref:`labelA.3.12` を参照)と一緒に使うと有用です。コマンドの出力は一つにまとめられて表示します。
136
137 .. Note that enabling --output-postpone will by default disable the --output-normal option. This might be problematic if you have a command that decides to ask for interactive input. If the --output-postpone is enabled, but the --output-normal is not, the prompt of such a command will not be visible and it may be hard to figure out why the build appears “stuck”. You might also consider using the --progress flag (see Section A.2.4) so that you can see when the build is active. 
138
139 .. note::
140    ``--output-postpone`` を有効にした際、デフォルトで ``--output-normal`` オプションが無効になります。この仕様は、インタラクティブな入力を要請するコマンドを使いたいような場合に問題となるでしょう。 ``--output-postpone`` が有効になって、さらに ``--output-normal`` が無効になっているような場合、このようなコマンドのプロンプトを表示することはなくなるので、ビルドがなぜ『固まって』いるのか理解することは殆ど困難となります。このような状況に直面した際、あなたは ``--process`` フラグ( :ref:`labelA.2.4` を参照)を用いて、ビルドが実行されているのかどうか確認すべきです。
141
142 .. index::
143    single: --output-only-errors
144 .. _labelA.2.10:
145
146 A.2.10 -output-only-errors
147 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
148 ``--output-only-errors``
149
150 .. Similar to --output-postpone, except that the postponed output from commands that were successful will be discarded. This can be useful in reducing unwanted output so that you can concentrate on any errors.
151
152 ``--output-postpone`` と似ていますが、このオプションは成功したコマンドの出力を表示しません。つまりユーザが望んでいない出力を減らすことができるので、あなたは任意のエラーが出た箇所のみに集中できます。
153
154 .. index::
155    single: --output-at-end
156 .. _labelA.2.11:
157
158 A.2.11 -output-at-end
159 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
160 ``--output-at-end``
161
162 .. If any rules/commands fail, re-print the output of the failed commands when OMake finishes the build. This is especially useful when any of the -k, -p, or -P options are enabled.
163
164 任意のルールやコマンドが失敗した場合、失敗したコマンドの出力をOMakeのビルドが終了した際に表示します。これは ``-k`` , ``-p`` , ``-P`` オプションのうち一つでも有効としている場合に、特に有用となります。
165
166 .. This option is off by default. However, when -k is enabled — either explicitly or via one of the -p/-P options — --output-at-end will be enabled by default.
167
168 このオプションはデフォルトで無効となっています。しかしながら、 ``-k`` オプションが有効となっているような場合ー明示的、あるいは ``-p``/``-P`` オプションを経由した場合ー ``--output-at-end`` オプションはデフォルトで有効となります。
169
170 .. index::
171    single: -o
172 .. _labelA.2.12:
173
174 A.2.12 -o
175 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
176 ``-o [01jwWpPxXsS]``
177
178 .. For brevity, the -o option is also provided to duplicate the above output options. The -o option takes a argument consisting of a sequence of characters. The characters are read from left-to-right; each specifies a set of output options. In general, an uppercase character turns the option on; a lowercase character turns the option off.
179
180 上記の出力オプションを簡単に指定するために、 ``-o`` オプションが出力オプションの代替手段として提供されています。 ``-o`` オプションは文字のシーケンスで構成された引数が必要となります。文字は左から右へ読み込まれ、各々の文字は出力オプションの集合を指定しています。一般的に、大文字はオプションを有効にして、小文字はオプションを無効化します。
181
182 * **0**
183   
184   .. Equivalent to -s --output-only-errors --no-progress
185   
186   ``-s --output-only-errors --no-progress`` と等価です。
187   
188   .. This option specifies that omake should be as quiet as possible. If any errors occur during the build, the output is delayed until the build terminates. Output from successful commands is discarded.
189   
190   このオプションは ``omake`` の出力ができるだけサイレントとなるように指定します。任意のエラーがビルド中に生じた場合、出力はビルドが終了するまで延期されます。成功したコマンドの出力は表示されません。
191
192 * **1**
193   
194   .. Equivalent to -S --progress --output-only-errors
195   
196   ``-S --progress --output-only-errors`` と等価です。
197   
198   .. This is a slightly more relaxed version of “quiet” output. The output from successful commands is discarded. The output from failed commands is printed immediately after the command complete. The output from failed commands is displayed twice: once immediately after the command completes, and again when the build completes. A progress bar is displayed so that you know when the build is active. Include the `p' option if you want to turn off the progress bar (for example omake -o 1p).
199   
200   このオプションは上の『サイレント』なバージョンよりも、もう少し寛容な形になっています。成功したコマンドの出力は表示しません。失敗したコマンドの出力はコマンドが完了した後で、即座に表示します。失敗したコマンドの出力は2回表示します。まず1回目はコマンドが完了した際に表示し、2回目はビルドが完了した際に表示します。また、プログレスバーも表示するので、あなたはビルドが実行されているのかどうか確認することができます。もしプログレスバーを表示したくないのであれば、 ``p`` オプションを含めてください(例: ``omake -o 1p`` )。
201
202 * **2**
203   
204   .. Equivalent to --progress --output-postpone
205   
206   ``--progress --output-postpone`` と等価です。
207   
208   .. The is even more relaxed, output from successful commands is printed. This is often useful for deinterleaving the output when using -j.
209   
210   このオプションはさらに寛容な形となっており、成功したコマンドの出力も表示します。これは ``-j`` オプションを用いて出力を重ね合わせたくない(deinterleaving)ような場合にしばしば有用となります。
211
212 * **W**
213   
214   ``-w`` と等価です。
215
216 * **w**
217   
218   ``--no-w`` と等価です。
219
220 * **P**
221   
222   ``-progress`` と等価です。
223
224 * **p**
225   
226   ``--no--progress`` と等価です。
227
228 * **X**
229   
230   ``--print-exit`` と等価です。
231
232 * **x**
233   
234   ``--no-print-exit`` と等価です。
235
236 * **S**
237   
238   ``-S`` と等価です。
239
240 * **s**
241   
242   ``--no-S`` と等価です。
243
244 .. _labelA.3:
245
246 A.3 ビルドオプション
247 ----------------------------------
248
249 .. index::
250    single: -k
251 .. _labelA.3.1:
252
253 A.3.1 -k
254 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
255 ``-k``
256
257 .. Do not abort when a build command fails; continue to build as much of the project as possible. This option is implied by both -p and -P options. In turn, this option would imply the --output-at-end option.
258
259 ビルドコマンドが失敗したとしても中断せず、可能な限りプロジェクトのビルドを続けます。このオプションは ``-p`` あるいは ``-P`` オプションを指定した場合、暗黙的に有効となります。さらに、このオプションは暗黙的に ``--output-at-end`` オプションを有効にします。
260
261 .. index::
262    single: -n
263 .. _labelA.3.2:
264
265 A.3.2 -n
266 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
267 ``-n``
268
269 .. This can be used to see what would happen if the project were to be built.
270
271 このオプションによって、プロジェクトがビルドされる場合にどのような手順が踏まれるのか、実際に確認することができます。
272
273 .. index::
274    single: -p
275 .. _labelA.3.3:
276
277 A.3.3 -p
278 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
279 ``-p``
280
281 .. Watch the filesystem for changes, and continue the build until it succeeds. If this option is specified, omake will restart the build whenever source files are modified. Implies -k.
282
283 ファイルシステムの変化を監視し、ビルドが成功するまで実行し続けます。このオプションを指定した場合、 ``omake`` はソースファイルが変更された際にはいつでもビルドを開始します。また、暗黙的に ``-k`` オプションを有効にします。
284
285 .. index::
286    single: -P
287 .. _labelA.3.4:
288
289 A.3.4 -P
290 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
291 ``-P``
292
293 .. Watch the filesystem for changes forever. If this option is specified, omake will restart the build whenever source files are modified. Implies -k.
294
295 ファイルシステムの変更点を永久に監視します。このオプションを指定した場合、 ``omake`` はソースファイルが変更された際にはいつでもビルドを開始します。また、暗黙的に ``-k`` オプションを有効にします。
296
297 .. index::
298    single: -R
299 .. _labelA.3.5:
300
301 A.3.5 -R
302 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
303 ``-R``
304
305 .. Ignore the current directory and build the project from its root directory. When omake is run in a subdirectory of a project and no explicit targets are given on the command line, it would normally only build files within the current directory and its subdirectories (more precisely, it builds all the .DEFAULT targets in the current directory and its subdirectories). If the -R option is specified, the build is performed as if omake were run in the project root.
306
307 カレントディレクトリを無視し、ルートディレクトリからプロジェクトをビルドします。 ``omake`` をプロジェクトのサブディレクトリから実行し、さらに明示的なターゲットをコマンドライン上から与えていないような場合、OMakeは通常カレントディレクトリとそのサブディレクトリ内にあるファイルのみをビルドします(正確には、すべてのカレントディレクトリ内の ``.DEFAULT`` ターゲットをビルドします)。 ``-R`` オプションを指定した場合、まるで ``omake`` がプロジェクトのルート上から実行しているかのようにビルドを行います。
308
309 .. In other words, with the -R option, all the relative targets specified on the command line will be taken relative to the project root (instead of relative to the current directory). When no targets are given on the command line, all the .DEFAULT targets in the project will be built (regardless of the current directory).
310
311 言い換えると、 ``-R`` オプションを用いることで、コマンドライン上から指定したすべての関連するターゲットを、(カレントディレクトリに関連付ける代わりに)プロジェクトのルートに関連付けます。なんのターゲットもコマンドライン上に指定していない場合には、プロジェクト上のすべての ``.DEFAULT`` ターゲットが(カレントディレクトリに関係なく)ビルドされます。
312
313 .. index::
314    single: -t
315 .. _labelA.3.6:
316
317 A.3.6 -t
318 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
319 ``-t``
320
321 .. Update the omake database to force the project to be considered up-to-date.
322
323 強制的に ``omake`` のデータベースを更新します。
324
325 .. index::
326    single: -U
327 .. _labelA.3.7:
328
329 A.3.7 -U
330 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
331 ``-U``
332
333 .. Do not trust cached build information. This will force the entire project to be rebuilt.
334
335 キャッシュされたビルド情報を用いません。このオプションを指定した場合、強制的にプロジェクト全体をリビルドします。
336
337 .. index::
338    single: --depend
339 .. _labelA.3.8:
340
341 A.3.8 -depend
342 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
343 ``--depend``
344
345 .. Do not trust cached dependency information. This will force files to be rescanned for dependency information.
346
347 キャッシュされた依存関係の情報を用いません。このオプションを指定した場合、強制的にファイルの依存関係を再スキャンします。
348
349 .. index::
350    single: --configure
351 .. _labelA.3.9:
352
353 A.3.9 -configure
354 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
355 ``--configure``
356
357 .. Re-run static. sections of the included omake files, instead of trusting the cached results.
358
359 OMakeファイルに含まれている ``static.`` セクションを、キャッシュされた結果を用いる代わりに再実行します。
360
361 .. index::
362    single: --force-dotomake
363 .. _labelA.3.10:
364
365 A.3.10 -force-dotomake
366 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
367 ``--force-dotomake``
368
369 .. Always use the $HOME/.omake for the .omc cache files.
370
371 常に ``$HOME/.omake`` の ``.omc`` キャッシュファイルを用います。
372
373 .. index::
374    single: --dotomake
375 .. _labelA.3.11:
376
377 A.3.11 -dotomake
378 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
379 ``--dotomake <dir>``
380
381 .. Use the specified directory instead of the $HOME/.omake for the placement of the .omc cache files.
382
383 ``$HOME/.omake`` を用いる代わりに、指定したディレクトリに置かれた ``.omc`` キャッシュファイルを用います。
384
385 .. index::
386    single: -j
387    single: 並列ビルド
388 .. _labelA.3.12:
389
390 A.3.12 -j
391 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
392 ``-j <count>``
393
394 .. Run multiple build commands in parallel. The count specifies a bound on the number of commands to run simultaneously. In addition, the count may specify servers for remote execution of commands in the form server=count. For example, the option -j 2:small.host.org=1:large.host.org=4 would specify that up to 2 jobs can be executed locally, 1 on the server small.host.org and 4 on large.host.org. Each remote server must use the same filesystem location for the project.
395
396 平行して複数のビルドコマンドを実行します。 ``count`` では同時に実行するコマンドの限界数を指定します。加えて、 ``server=count`` の形でリモートサーバのコマンドを実行することもできます。例えば、オプション ``-j 2:small.host.org=1:large.host.org=4`` は2つのジョブをローカルで実行し、さらに1つをサーバ ``small.host.org`` 上、4つを ``large.host.org`` 上で実行します。それぞれのリモートサーバはプロジェクト上の同一の場所で実行しなければなりません。
397
398 .. Remote execution is currently an experimental feature. Remote filesystems like NFS do not provide adequate file consistency for this to work.
399
400 リモートサーバでの実行は現在実験的な機能として搭載しています。NFSのようなリモートファイルシステムでは、十分なファイルの整合性を保つことはできません。
401
402 .. index::
403    single: --print-dependencies
404 .. _labelA.3.13:
405
406 A.3.13 -print-dependencies
407 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
408 ``--print-dependencies``
409
410 .. Print dependency information for the targets on the command line.
411
412 コマンドライン上でのターゲットの、依存関係に関する情報を表示します。
413
414 .. index::
415    single: --show-dependencies
416 .. _labelA.3.14:
417
418 A.3.14 -show-dependencies
419 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
420 ``--show-dependencies <target>``
421
422 .. Print dependency information if the target is built.
423
424 ``target`` をビルドする場合、依存関係に関する情報を表示します。
425
426 .. index::
427    single: --all-dependencies
428 .. _labelA.3.15:
429
430 A.3.15 -all-dependencies
431 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
432 ``--all-dependencies``
433
434 .. If either of the options --print-dependencies or --show-dependencies is in effect, print transitive dependencies. That is, print all dependencies recursively. If neither option --print-dependencies, --show-dependencies is specified, this option has no effect.
435
436 オプション ``--print-dependencies`` あるいは ``--show-dependencies`` が指定されている場合、動的な依存関係も表示します。これは、すべての依存関係を再帰的に表示することを表しています。オプション ``--print-dependencies`` , ``--show-dependencies`` のどちらも指定していない場合、このオプションはなんの影響も与えません。
437
438 .. index::
439    single: --verbose-dependencies
440 .. _labelA.3.16:
441
442 A.3.16 -verbose-dependencies
443 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
444 ``--verbose-dependencies``
445
446 .. If either of the options --print-dependencies or --show-dependencies is in effect, also print listings for each dependency. The output is very verbose, consider redirecting to a file. If neither option --print-dependencies, --show-dependencies is specified, this option has no effect.
447
448 オプション ``--print-dependencies`` あるいは ``--show-dependencies`` が指定されている場合、各々の依存関係のリストを表示します。出力はとても冗長となり、ファイルへのリダイレクトも考慮されるようになります。オプション ``--print-dependencies`` , ``--show-dependencies`` のどちらも指定していない場合、このオプションはなんの影響も与えません。
449
450 .. index::
451    single: --install
452 .. _labelA.3.17:
453
454 A.3.17 -install
455 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
456 ``--install``
457
458 .. Install default files OMakefile and OMakeroot into the current directory. You would typically do this to start a project in the current directory.
459
460 デフォルトのファイル ``OMakefile`` と ``OMakeroot`` をカレントディレクトリにインストールします。典型的な使い方としては、カレントディレクトリ内でOMakeのプロジェクトを開始しようとする際に、このオプションを用います。
461
462 .. index::
463    single: --install-all
464 .. _labelA.3.18:
465
466 A.3.18 -install-all
467 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
468 ``--install-all``
469
470 .. In addition to installing files OMakefile and OMakeroot, install default OMakefiles into each subdirectory of the current directory. cvs(1) rules are used for filtering the subdirectory list. For example, OMakefiles are not copied into directories called CVS, RCCS, etc.
471
472 ``OMakefile`` と ``OMakeroot`` をインストールし、さらにデフォルトの ``OMakefile`` をカレントディレクトリ内のサブディレクトリにインストールします。その際に、サブディレクトリのリストをフィルタリングするため ``cvs(1)`` のルールが用いられます。例えば、 ``OMakefile`` は ``CVS`` , ``RCCS`` などのディレクトリ内にはコピーされません。
473
474 .. index::
475    single: --install-force
476 .. _labelA.3.19:
477
478 A.3.19 -install-force
479 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
480 ``--install-force``
481
482 .. Normally, omake will prompt before it overwrites any existing OMakefile. If this option is given, all files are forcibly overwritten without prompting.
483
484 通常、 ``omake`` は既存の ``OMakefile`` を上書きする前に警告を行います。このオプションが与えられている場合、すべてのファイルは強制的に警告を発することなく上書きされます。
485
486 .. index::
487    single: --absname
488 .. _labelA.3.20:
489
490 A.3.20 -absname
491 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
492 ``--absname``
493
494 .. Filenames should expand to absolute pathnames.
495
496 ファイル名は絶対パスとして展開されるようになります。
497
498 .. N.B. This is an experimental option. It may become deprecated.
499
500 .. note::
501    これは実験的なオプションで、廃止される恐れがあります。
502
503 .. _labelA.3.21:
504
505 A.3.21 変数の定義
506 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
507 ``name=[value]``
508
509 .. omake variables can also be defined on the command line in the form name=value. For example, the CFLAGS variable might be defined on the command line with the argument CFLAGS="-Wall -g".
510
511 ``omake`` の変数は ``name=value`` の形で、コマンドライン上から指定することもできます。例えば、 ``CFLAGS`` 変数はコマンドライン上から、引数に ``CFLAGS="-Wall -g"`` を指定することで定義することもできます。
512
513 .. _labelA.4:
514
515 A.4 さらなるオプション
516 ----------------------------------
517 .. In addition, omake supports a number of debugging flags on the command line. Run omake --help to get a summary of these flags.
518
519 これらのオプションに加えて、 ``omake`` ではコマンドライン上で利用できる、数多くのデバッグフラグをサポートしています。これらのフラグの概要について知りたい方は、 ``omake --help`` を実行してください。
520
521 .. index::
522    single: 環境変数
523 .. _labelA.5:
524
525 A.5 環境変数
526 ----------------------------------
527
528 .. index::
529    single: OMAKEFLAGS
530 .. _labelA.5.1:
531
532 A.5.1 OMAKEFLAGS
533 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
534 .. If defines, the OMAKEFLAGS should specify a set of options exactly as they are specified on the command line.
535
536 ``OMAKEFLAGS`` 変数が定義されている場合、 ``OMAKEFLAGS`` で指定したオプションの集合が、コマンドライン上から指定したものと同様に扱われます。
537
538 .. index::
539    single: OMAKELIB
540 .. _labelA.5.2:
541
542 A.5.2 OMAKELIB
543 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
544 .. If defined, the OMAKELIB environment variable should refer to the installed location of the OMake standard library. This is the directory that contains Pervasives.om etc. On a Unix system, this is often /usr/lib/omake or /usr/local/lib/omake, and on Win32 systems it is often c:\Program Files\OMake\lib.
545
546 ``OMAKELIB`` が定義されている場合、 ``OMAKELIB`` の環境変数はOMakeでの標準ライブラリの場所を表しています。これは ``Pervasives.om`` などを含んだディレクトリとなっています。Unixシステム上では、これは大まかに ``/usr/lib/omake`` か ``/usr/local/lib/omake`` へ関連付けられ、Win32システム上では ``c:\Program Files\OMake\lib`` へ関連付けられます。
547
548 .. If not defined, omake uses the default configured location. You should normally leave this unset.
549
550 この環境変数が定義されていない場合、 ``omake`` は設定されたデフォルトのパスを用います。通常はこの環境変数を未定義のままにしておいて構いません。
551
552 .. _labelA.6:
553
554 A.6 関数
555 ----------------------------------
556
557 .. index::
558    single: OMakeFlags()
559 .. _labelA.6.1:
560
561 A.6.1 OMakeFlags
562 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
563 .. The OMakeFlags function can be used within an OMakefile to modify the set of options. The options should be specified exactly as they are on the command line. For example, if you want some specific project to be silent and display a progress bar, you can add the following line to your OMakefile.
564
565 ``OMakeFlags`` 関数はオプションの集合を ``OMakefile`` の内部で修正するために用いられます。このオプションはコマンドライン上で指定するのと同様にして指定する必要があります。例えば、ある特定のプロジェクト内で出力をサイレント、かつプログレスバーを表示したい場合、あなたは ``OMakefile`` 上に以下の行を追加します。 ::
566
567     OMakeFlags(-S --progress)
568
569 .. For options where it makes sense, the options are scoped like variables. For example, if you want OMake to be silent for a single rule (instead of for the entire project), you can use scoping the restrict the range of the option.
570
571 この関数によって指定したオプションは、まるで変数のようにスコープ化されます。例えば、OMakeでの出力を(プロジェクト全体で有効にする代わりに)一つのルール上でサイレントにしたい場合は、オプションを適用させる範囲をそのままスコープ化します。 ::
572
573     section
574         # fooが生成される際に、コマンドラインの出力を表示しません
575         OMakeFlags(-S)
576
577         foo: fee
578            echo "This is a generated file" > foo
579            cat fee >> foo
580            chmod 555 foo
581
582 .. _labelA.7:
583
584 A.7 オプションの処理過程
585 ----------------------------------
586 .. When omake is invoked, the options are processed in the following order.
587
588 ``omake`` が実行された際、オプションは以下の順に処理されます。
589
590 ..   1. All options specified by the OMAKEFLAGS environment variable are defined globally.
591      2. All options from the command line are defined globally.
592      3. Any individual calls the the OMakeFlags function modify the options locally. 
593
594 1. ``OMAKEFLAGS`` 環境変数によって指定したすべてのオプションが、プロジェクト全体に作用します。
595 2. コマンドラインによって指定したすべてのオプションが、プロジェクト全体に作用します。
596 3. ``OMakeFlags`` 関数によって呼び出された任意のオプションが、プロジェクトの一部分に作用します。
597
598 .. index::
599    single: .omakerc
600 .. _labelA.8:
601
602 A.8 .omakerc
603 ----------------------------------
604 .. If the $(HOME)/.omakerc exists, it is read before any of the OMakefiles in your project. The .omakerc file is frequently used for user-specific customization. For example, instead of defining the OMAKEFLAGS environment variable, you could add a line to your .omakerc.
605
606 ``$(HOME)/.omakerc`` が存在する場合、任意の ``OMakefiles`` が読み込まれる前にまず  ``$(HOME)/.omakerc`` が読み込まれます。このファイルは、ユーザが自由にOMakeをカスタマイズする用途として頻繁に用いられます。例えば、 ``OMAKEFLAGS`` 環境変数を定義する代わりに、以下の行を ``.omakerc`` に加えることもできます。 ::
607
608     $(HOME)/.omakerc:
609         # プライベートなオプションを記述
610         OMakeFlags(-S --progress)