path: root/ja/man/man1/make.1

.\" this file based on that translated to japanese on NetBSD Japanese Reference
.\" Manual Project, and modefied to fit FreeBSD Reference Manual
.\" by Mochida Shuji  1996/04/26
.\" 
.\" Copyright (c) 1990, 1993
.\" jpman %Id: make.1,v 1.2 1997/05/27 00:42:17 mutoh Stab %
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	from: @(#)make.1	8.4 (Berkeley) 3/19/94
.\"	%Id: make.1,v 1.6.2.3 1997/09/15 09:20:40 jkh Exp %
.\"
.Dd March 19, 1994
.Dt MAKE 1
.Os
.Sh 名称
.Nm make
.Nd プログラムの依存関係をメンテナンスする
.Sh 書式
.Nm make
.Op Fl Beiknqrst
.Op Fl D Ar variable
.Op Fl d Ar flags
.Op Fl f Ar makefile
.Op Fl I Ar directory
.Bk -words
.Op Fl j Ar max_jobs
.Op Fl m Ar directory
.Ek
.Op Fl V Ar variable
.Op Ar variable=value
.Op Ar target ...
.Sh 解説
.Nm make
は、プログラムのメンテナンスを単純化するためのツールです。その入力は
ファイル毎の依存関係指定のリストで、それぞれのファイルがどのプログラム、
どのファイルに依存するか記述されています。
その指定リストとして、ファイル
.Ql Pa makefile
が存在すればそれを、無ければ
.Ql Pa Makefile
を読み込みます。
.Ql Pa .depend
というファイルがあれば、それも読み込みます
.Pq Xr mkdep 1 を参照
。
.Pp
本マニュアルはリファレンスのためのみのドキュメントです。
.Nm make
と makefile に関する詳しい記述は
.%T "Make \- A Tutorial"
を参照してください
.\"  (
.\" .Dq /usr/src/usr.bin/make/PSD.doc
.\" に、本
.\" .Nm make
.\" の元になった pmake に関する 
.\" .Xr nroff 1
.\" でフォーマットできるドキュメントがあります)
。
.Pp
オプションは以下のとおりです。
.Bl -tag -width Ds
.It Fl B
シーケンス中の依存行のソースを作成するために、各コマンドに対して
一つのシェルを実行する、バックワード互換モードで実行しようとします。
.It Fl D Ar variable
大域変数
.Ar variable
を 1 と定義します。
.It Fl d Ar flags
デバッグモードを有効にし、
.\" .Ar flags
.\" で指定されたデバッグ情報を出力します。
.Nm
が表示するデバッグ情報の種類を指定します。
.Ar flags
には、以下のうち 1 つ以上を指定できます。
.Bl -tag -width Ds
.It Ar A
すべてのデバッグ情報を出力します。他のフラグをすべて指定したことと
等価です。
.It Ar a
アーカイブ検索とキャッシュに関する情報を表示します。
.It Ar c
条件評価に関する情報を表示します。
.It Ar d
ディレクトリ検索とキャッシュに関する情報を表示します。
.It Ar "g1"
処理を行う前に、入力のグラフを表示します。
.It Ar "g2"
すべての処理を行ったあと、あるいはエラーにより終了する前に入力のグラフを
表示します。
.It Ar j
複数のシェルを起動する場合の情報を表示します。
.It Ar m
ターゲットの作成と変更日付に関する情報を表示します。
.It Ar s
拡張子解釈に関する情報を表示します。
.It Ar t
ターゲットリストのメンテナンスに関する情報を表示します。
.It Ar v
変数の値に関する情報を表示します。
.El
.It Fl e
環境変数で makefile 中の変数の値を上書きするように指示します。
.It Fl f Ar makefile
デフォルトの
.Ql Pa makefile
と
.Ql Pa Makefile
のかわりに、読み込むファイルを指定します。もし
.Ar makefile
が
.Ql Fl
なら標準入力から読み込みます。複数のファイルが指定可能で、
指定した順に読み込まれます。
.It Fl I Ar directory
makefile と、インクルードされる makefile を検索するためのディレクトリを
指定します。システムで定義してある makefile のあるディレクトリ (または、
複数のディレクトリ;
.Fl m
オプションを参照) は自動的にリストに含まれ、検索されます。
.It Fl i
makefile から実行されたシェルコマンドが 0 でない終了ステータスを返し
ても無視します。makefile 中でコマンドの先頭に
.Ql Fl
を指定するのと同じです。
.It Fl j Ar max_jobs
.Nm make
が同時に起動できるジョブの数を指定します。互換性モードをオフにするには、
.Ar B
フラグも指定してください。
.It Fl k
エラーが発生しても処理を続行します。ただし、発生したエラーによって作成
が不能になったターゲットに依存したターゲットに関しては処理が中断されます。
.It Fl m Ar directory
<...> 形式で読み込まれる sys.mk や makefile を検索するための
ディレクトリを指定します。複数のディレクトリを検索パスに加えることが
できます。このパスは、デフォルトのシステムインクルードパス 
/usr/share/mk を上書きします。
さらに、システムインクルードパスを "..."形式のインクルードによって
追加することができます(
.Fl I
オプションを参照)。
.It Fl n
make が実行するであろうコマンド内容の表示のみを行い、実行はしません。
.It Fl q
いっさいのコマンドを実行せず、指定されたターゲットが最新のものであれば 0 
を、そうでなければ 1 を終了ステータスとして返します。
.It Fl r
システムの makefile で定義された組み込みのルールを使用しません。
.It Fl s
実行するコマンドを表示しません。makefile のなかで、コマンドの先頭に
.Ql Ic @
を指定するのと同じです。
.It Fl t
makefile で指定されたターゲットを作り直すのではなく、ターゲットを作成
するか、あるいは最終更新日付を現在の時刻に設定することにより、
ターゲットが最新であるかのようにします。
.It Fl V Ar variable
グローバルな文脈での
.Nm make
の
.Ar variable 
の値を表示します。如何なるターゲットも生成しません。
このオプションで複数のインスタンスを指定することができます。
変数は、各行毎に表示されます。未定義もしくは空の変数は、空行で
表現されます。
.It Ar variable=value
変数
.Ar variable
の値を
.Ar value
に設定します。
.El
.Pp
makefile には 7 種類の行があります: 依存関係記述、シェルコマンド、変数
代入、インクルード文、条件命令、for ループ、コメントです。
.Pp
一般に、行は行末にバックスラッシュ
.Pq Ql \e
を置くことにより次行へ継続させることがで
きます。この場合、バックスラッシュ直後の改行と、次の行の先頭の
空白部分は 1 つの空白に置き換えられます。
.Sh ファイル依存関係記述
入力ファイルにおける依存関係記述行は、1 つ以上のターゲット、オペレータ、
0個 以上のソースからなります。
これは、ターゲットがソースに「依存」しているという関係を
定義しており、通常は、ソースからターゲットが作成されます。ターゲットと
ソースとの厳密な関係はオペレータによって、両者間に指定します。
オペレータには以下の種類があります。
.Bl -tag -width flag
.It Ic \&:
ターゲットの最終更新日付が、いずれかのソースの最終更新日付よりも
古いものであれば、ターゲットは古いものであり、作り直されるべきものと
判断されます。
別の行でこのオペレータによる同じターゲットに関するソースの記述があれば、
それらはすべて 1 つにまとめられます。ターゲットの作成中に
.Nm make
が中断されると、ターゲットは削除されます。
.It Ic \&!
ターゲットはつねに作り直されます。ただし、作り直されるのは、
すべてのソースが検査され、必要と判断されたソースが作り直されたあとです。
このオペレータによる同じターゲットに関するソースの記述が別の行にもあれば、
それらはすべて 1 つにまとめられます。ターゲットの作成中に
.Nm make
が中断されると、ターゲットは削除されます。
.It Ic \&::
ソースが指定されていなかった場合、つねにターゲットは作り直されます。
指定されていた場合にはソースのいずれかがターゲットよりも新しい時だけ
ターゲットは作り直されます。本オペレータでは、別の行において同じ
ターゲットに関するソースの記述があっても 1 つにまとめません。
ターゲットの作成中に
.Nm make
が中断されるても、ターゲットは削除されません。
.El
.Pp
ターゲットとソースは、シェルのワイルドカードとして
.Ql ? ,
.Ql * ,
.Ql [] ,
.Ql {}
を含むこ
とができます。
.Ql ? ,
.Ql * ,
.Ql []
は、ターゲットまたはソースの最後の要素として記述でき、
存在するファイルを指定するものでなければなりません。
.Ql {}
はファイルが存在しなくてもかまいません。シェルのように辞書順に並べられて
展開されることはなく、ファイルシステム上に並んでいる順番のまま行われます。
.Sh シェルコマンド
ターゲットは、シェルコマンドの列と関連付けることができ、通常はそれによって
ターゲットを作成します。
これに含まれる各コマンドは、
.Em 必ず
行頭のタブに続けて記述します。同一のターゲットに
対して複数の依存記述行がある場合、
.Ql Ic ::
オペレータを使用したのでなければ、それらのうちの 1 つにのみコマンド行を
続けることができます。
.Pp
もし最初の文字が
.Ql Ic @
または
.Ql Ic \-
ならば
.Pq 2\ 文字とも指定することも可能
、コマンドは特別な扱いを受けます。
.Ql Ic @
は、コマンドが実行される前にコマンド内容が表示されることを抑制します。
.Ql Ic \-
は、コマンドの 0 ではない終了ステータスを無視するように指示します。
.Sh 変数代入
.Nm make
で使われる変数はシェルでの変数に類似しています。そして、歴史的な経緯から、
すべて大文字からなる名前が用いられます。変数代入には以下の 5 通りの
オペレータを使用できます。
.Bl -tag -width Ds
.It Ic \&=
変数に値を代入します。その時点までの値は失われます。
.It Ic \&+=
現在の変数の値に、右辺の値を追加します。
.It Ic \&?=
変数が未定義の場合のみ、値を代入します
.It Ic \&:=
右辺を展開した値を代入します。つまり、変数に代入する前に値の展開を行います。
通常、値の展開は代入時には行われず、変数が参照されるときに行われます。
.It Ic \&!=
右辺を展開した値をシェルに実行させ、実行結果を左辺の変数に代入します。
結果のなかに含まれる改行は空白に置き換えられます。
.El
.Pp
いずれの場合も、値の前にある空白は無視されます。値が追加される場合、
変数の直前の値と追加する値との間に空白が挿入されます。
.Pp
変数は、ドル記号
.Pq Ql $
に続いて中括弧
.Pq Ql {}
または小括弧
.Pq Ql ()
で囲まれた変数名を置くことにより展開されます
.\" .Pq 例: ${LIBS}
。もし変数名が 1 文字な
ら、変数名を囲む括弧は省略できますが、このような省略形は推奨できません。
.Pp
変数置換は、変数が用いられている場所により、 2 つの別々のタイミングで
行われます。依存関係記述行で用いられた変数は、その行が読み込まれたときに
展開されます。シェルコマンド内で用いられた変数は、シェルコマンド実行時に
展開されます。
.Pp
変数には、優先度に従って、4 つの異なるクラスがあります:
.Bl -tag -width Ds
.It 環境変数
.Nm make
の環境中で有効な変数
.It グローバル変数
makefile とインクルードされた makefile 内で有効な変数。
.It コマンドライン変数
コマンドラインで指定された変数。
.It ローカル変数
あるターゲットのみに対して定義される変数。ローカル変数には、
以下の 7 種類があります:
.Bl -tag -width ".ARCHIVE"
.It Va .ALLSRC
このターゲットに対するすべてのソースのリスト。
.Ql Va \&> .
も同じです。
.It Va .ARCHIVE
アーカイブファイル名
.It Va .IMPSRC
ターゲット名に変換するのに使用するソースのファイル名またはパス名
.Pq 「暗黙の」ソース
.\" .Pq ターゲットが foo.o なら foo.c 等
。
.Ql Va \&< .
も同じです。
.It Va .MEMBER
アーカイブのメンバー
.It Va .OODATE
ターゲットよりも新しいソースのリスト。
.Ql Va \&? .
も同じ。
.It Va .PREFIX
ターゲットのディレクトリ名と拡張子を取り除いた名前。
.Ql Va * .
も同じ。
.It Va .TARGET
ターゲットの名前。
.Ql Va @ .
も同じ。
.El
.Pp
短い形式
.Ql Va @ ,
.Ql Va ? ,
.Ql Va \&> ,
.Ql Va *
は古い makefile での互換性のためのものですが、利用することは推奨できません。
また、
.Ql Va "@F" ,
.Ql Va "@D" ,
.Ql Va "<F" ,
.Ql Va "<D" ,
.Ql Va "*F" ,
.Ql Va "*D"
は
.At V
の makefile との互換性のために存在していますが、利用することは
推奨できません。
.Pp
次の 4 つのローカル変数は依存関係記述行のソースに使うことができます。
これらは、その行のターゲット毎の値に展開されます。
これらのローカル変数は
.Ql Va .TARGET ,
.Ql Va .PREFIX ,
.Ql Va .ARCHIVE ,
.Ql Va .MEMBER
です。
.Pp
さらに、
.Nm make
では以下の変数を利用することができます。
.Bl -tag -width MAKEFLAGS
.It Va \&$
単一のドル記号
.Ql \&$
。すなわち、
.Ql \&$$
は単一のドル記号に置換されます。
.It Va .MAKE
.Nm make
の起動に使用された名前
.Pq Va argv Op 0
。
.It Va .CURDIR
.Nm make
が実行されたディレクトリ。
.It Ev PWD
現在のディレクトリへの異なったパス。
.Nm make
は普通、
.Ql Va .CURDIR
を
.Xr getcwd 2 
で得られたパスに設定します。しかしながら、環境変数
.Ql Ev PWD
が設定されており、与えられたパスがカレントディレクトリの時、
.Nm make
は、
.Ql Va .CURDIR
を
.Ql Ev PWD
の値に設定します。
.Ql Ev PWD
は、
.Nm make
が実行している全てのプログラムに対して、
.Ql Va .OBJDIR
の値を設定します。
.El
.Pp
変数展開において、その変数内の単語を選択したり、変更したりすることが
できます
.Pq 単語とは空白で区切られた文字列です
。変数展開の一般形は、次のとおりです。
.Pp
.Dl {variable[:modifier[:...]]}
.Pp
各修飾子は、コロンと以下に示すいずれかの文字のうち 1 文字からなります。
リテラルなコロン
.Pq Ql \&:
を指定するにはコロンの前にバックスラッシュ
.Pq Ql \e
を置きます。
.Bl -tag -width Cm E\&
.It Cm E
変数中の各単語を拡張子で置換します。
.It Cm H
変数中の各単語を、パスの最後の要素
.\" (最後のスラッシュ
.\" .Pq Ql /
.\" より後の部分)
を除いた部分で置換します。
.It Cm M Ns Ar pattern
pattern にマッチする単語を選択します。標準的なワイルドカード
.Pf ( Ql * ,
.Ql ? ,
.Ql Op )
が使用できます。ワイルドカード文字はバックスラッシュ
.Pq Ql \e
によりエスケープできます。
.It Cm N Ns Ar pattern
pattern にマッチしない単語を選択します。それ以外は
.Ql Cm M
と同様です。
.It Cm R
変数中の各単語から拡張子を取り除きます。
.Sm off
.It Cm S No \&/ Ar old_pattern Xo
.No \&/ Ar new_pattern
.No \&/ Op Cm g
.Xc
.Sm on
各単語中の最初の
.Ar old_pattern
を
.Ar new_pattern
に置換します。もし、最後のスラッシュのあとに
.Ql g
が指定されていれば、各単語中に出現したすべての 
.Ar old_pattern
が
.Ar new_pattern
に置換されます。
.Ar old_pattern
が
.Ql ^
で始まっているなら、そのパタンを各単語の先頭からマッチさせることを
意味します。
.Ar old_pattern
がドル記号
.Pq Ql $
で終わっているなら、そのパタンを各単語の終端にマッチさせることを
意味します。
.Ar new_string
中のアンド記号
.Pq Ql &
は
.Ar old_pattern
に置換されます。修飾文字列の区切りにはどんな文字を使ってもかまいません。
.Ql ^
,
.Ql $
,
.Ql &
と区切り文字はバックスラッシュ
.Pq Ql \e
によりエスケープできます。
.Pp
.Ar old_string
と
.Ar new_string
中では通常の変数置換が行われます。ただし、ドル記号
.Pq Ql \&$
の展開を抑制するためには、通常のドル記号の前置ではなく、
バックスラッシュでエスケープします。
.It Cm T
変数中の各単語をパスの最後の要素
.\" (最後のスラッシュ
.\" .Pq Ql /
.\" より後の部分)
で置換します。
.It Ar old_string=new_string
これは
.At V
での変数置換の形式です。これは最後の修飾子として指定する必要があります。
もし、パタンマッチ文字
.Ar %
が 
.Ar new_string
にも
.Ar old_string
にも含まれないなら、
.Ar new_string
と 
.Ar old_string
はどちらも単語の最後にマッチするものとみなされます。すなわち、
拡張子のみか、または単語全部が置換されることになります。そうでなければ、
.Ar %
が
.Ar old_string
に含まれており、それは
.Ar new_string
に置換されます。
.\" .Pp
.\" たとえば、以下の例において、
.\" .Bd -literal -offset indent
.\" OBJS+=  ${SRCS:N*.h:N*.sh:R:S/$/.o/g}
.\" .Ed
.\" OBJS は、 SRCS の各単語のうち、
.\" .Ql *.h
.\" 、
.\" .Ql *.sh
.\" にマッチするものを除き、さらに拡
.\" 張子のかわりに
.\" .Ql .o
.\" を付加した単語のリストになります。
.\" .Pp
.\" もし、
.\" .Bd -literal -offset indent
.\" SRCS = foo.c bar.c foo.h
.\" .Ed
.\" ならば、
.\" .Bd -literal -offset indent
.\" OBJS = foo.o bar.o
.\" .Ed
.\" となります。
.El
.Sh インクルード文、条件式、FOR ループ
.Nm make
では、C 言語を彷彿させるインクルード、条件文、for ループを使用することが
できます。これらの制御構造は、行頭に単一のドット
.Pq Ql \&.
がくることで識別されます。ファイルのインクルードは
.Ql .include <file>
または、
.Ql .include \*qfile\*q
により行います。ブラケット
.Pq Ql <>
と ダブルクォート
.Pq Ql \*q\*q
中の変数はファイル名に展開されます。もし、ブラケットが使用されたなら、
makefile はシステムの makefile ディレクトリにあるものを用います。
ダブルクォートなら、makefile が存在するディレクトリ、
.Fl I
オプションで指定されたディレクトリ、システムの makefile ディレクトリの
順に検索します。
.Pp
条件式も、行頭のドットから開始します。条件式には以下のものがあります:
.Bl -tag -width Ds
.It Ic .undef Ar variable
グローバル変数を未定義とします。グローバル変数以外は未定義とすることが
できません。 
.It Xo
.Ic \&.if
.Oo \&! Oc Ns Ar expression
.Op Ar operator expression ...
.Xc
式の値をテストします。
.It Xo
.Ic .ifdef
.Oo \&! Oc Ns Ar variable
.Op Ar operator variable ...
.Xc
変数の値をテストします。
.It Xo
.Ic .ifndef
.Oo \&! Oc Ns Ar variable
.Op Ar operator variable ...
.Xc
変数の値をテストします。
.It Xo
.Ic .ifmake
.Oo \&! Oc Ns Ar target
.Op Ar operator target ...
.Xc
ターゲット
.Ar target
が作成中かどうかをテストします。
.It Xo
.Ic .ifnmake
.Oo \&! Oc Ar target
.Op Ar operator target ...
.Xc
ターゲット
.Ar target
が作成中かどうかをテストします。
.It Ic .else
最後に行った条件文の意味を逆にします。
.It Xo
.Ic .elif
.Oo \&! Oc Ar expression
.Op Ar operator expression ...
.Xc
.Ql Ic .else
と直後の
.Ql Ic .if
を対にしたものです。
.It Xo
.Ic .elifdef
.Oo \&! Oc Ns Ar variable
.Op Ar operator variable ...
.Xc
.Ql Ic .else
と直後の
.Ql Ic .ifdef
を対にしたものです。
.It Xo
.Ic .elifndef
.Oo \&! Oc Ns Ar variable
.Op Ar operator variable ...
.Xc
.Ql Ic .else
と直後の
.Ql Ic .ifndef
を対にしたものです。
.It Xo
.Ic .elifmake
.Oo \&! Oc Ns Ar target
.Op Ar operator target ...
.Xc
.Ql Ic .else
と直後の
.Ql Ic .ifmake
を対にしたものです。
.It Xo
.Ic .elifnmake
.Oo \&! Oc Ns Ar target
.Op Ar operator target ...
.Xc
.Ql Ic .else
と直後の
.Ql Ic .ifnmake
を対にしたものです。
.It Ic .endif
条件文の本体を終了させます。
.El
.Pp
オペレータ
.Ar operator
は、以下のうちのいずれかです。
.Bl -tag -width "Cm XX"
.It Cm \&|\&|
論理 OR。
.It Cm \&&&
論理 AND。
.Ic ||
より優先順位が上です。
.El
.Pp
C 言語と同様、
.Nm make
は条件式を、式の値を決定するのに必要なところまでしか評価しません。
評価順序を変更するには括弧を使います。論理オペレータ
.Ql Ic \&!
は条件式全体の値を反転するのに使用します。
.Ql Ic \&!
は
.Ql Ic \&&&
より優先順位が上です。
.Pp
式
.Ar expression
は、以下のいずれかの形式です:
.Bl -tag -width Ic defined
.It Ic defined
引数として変数名をとり、変数が定義されていれば true となる。
.It Ic make
引数としてターゲット名をとり、そのターゲットが
.Nm make
のコマンドライン引数に指定されているか、デフォルトのターゲット
.Pq 明示的なものも暗黙的なものも含む。 Va .MAIN の項を参照
として宣言されている場合に true となる。
.It Ic empty
引数として変数名
.Pq と修飾子
をとり、展開した結果が空文字列ならば true となる。
.It Ic exists
引数としてファイル名をとり、ファイルが存在すれば true となる。
ファイルはシステム検索パス
.Pq Va .PATH の項を参照
にそって検索される。
.It Ic target
引数としてターゲット名をとり、ターゲットが定義されているなら true となる。
.El
.Pp
条件式
.Ar expression
としては、数値あるいは文字列の比較を用いることもできます。比較オペレータの
両辺は、変数展開が適用されたあとに比較されます。値が 0x で始まるなら 16 進数
であると解釈し、さもなければ 10 進数と解釈します。8 進数はサポートして
いません。標準的な C 言語の関係オペレータは全て利用可能です。
変数展開後、
.Ql Ic ==
または
.Ql Ic "!="
の左辺値または右辺値のいずれかが数値とは認められない場合、文字列として
比較を行います。関係オペレータが指定されなかった場合、展開された変数と 0 とを
比較します。
.Pp
条件式を評価中に、評価できない単語が出現した場合は、条件式の形式によって、
.Dq make
または
.Dq defined
オペレータを適用します。条件式が
.Ql Ic .ifdef
または
.Ql Ic .ifndef
ならば
.Dq defined
を、条件式が
.Ql Ic .ifmake
または
.Ql Ic .ifnmake
ならば
.Dq make
を、それぞれ適用します。
.Pp
条件式が true と評価されたなら、makefile の解析はそのまま続行されます。
false と評価されたなら、
.Ql Ic .else
または
.Ql Ic .endif
が見つかるまで 
makefile の解析をスキップします。
.Pp 
for ループは、いくつかのルールを一連のファイルに適用するのによく
用いられます。以下がループの形式です:
.Bl -tag -width Ds
.It Xo
.Ic \&.for
.Ar variable 
.Ic in 
.Ar expression
.Xc
.It Xo
<make-rules>
.Xc
.It Xo
.Ic \&.endfor
.Xc
.El
.Ic expression
は評価されたあとに単語に分解され、それぞれを
.Ic variable
に代入
しながら、
.Ic make-rules
部分を繰り返し展開します。
.Sh コメント
コメントはハッシュ記号
.Pq Ql \&#
から始まり、シェルコマンド行以外のどこにでも置くことができます。
コメントは改行で終わります。
.Sh 特殊ソース
.Bl -tag -width Ic .IGNORE
.It Ic .IGNORE
本ターゲットに関連したコマンドでのエラーを無視します。シェルコマンドの
先頭にダッシュ
.Ql \-
を指定したのと等価です。
.It Ic .MAKE
たとえ、
.Fl n や
.Fl t
オプションが指定されていても、このターゲットに関連したシェルコマンドを
実行します。通常、再帰的な
.Nm make
のために用いられます。
.It Ic .NOTMAIN
通常
.Nm make
は、最初に発見したターゲットをデフォルトのターゲットとみなします。
.Ic .NOTMAIN
が指定されたターゲットはデフォルトのターゲットとはみなされなくなります。
.It Ic .OPTIONAL
もし
.Ic .OPTIONAL
が指定されたターゲットの作り方がわからなくても、エラーとはせず、
そのターゲットは必要ないか、すでに存在しているものとみなします。
.It Ic .PRECIOUS
通常
.Nm make
が中断されたときは、作成途中のターゲットは削除されます。本ソースを
指定することで、そのターゲットを削除しなくなります。
.It Ic .SILENT
指定されたターゲットに関連づけられたシェルコマンドを実行するときに
エコーを行いません。シェルコマンドの先頭に
.Ql @
を指定したのと等価です。
.It Ic .USE
指定されたターゲットをマクロ的に扱います。
.Ic .USE
をソースに持つターゲット
.Pq 以下ではマクロと呼びます
が別のターゲットのソースとなった場合、その
ターゲットはコマンド、ソース、属性(
.Ic .USE
は除く)
をマクロから受け取ります。もし、すでにターゲットにコマンドが指定されていた
場合は、マクロのコマンドが追加されます。
.It Ic .WAIT
特別な
.Ic .WAIT
ソースが依存関係行に現れた時には、ソースはその行中でソースが
作成されるまで待ちます。ループは検出されず、ループ形式のターゲットは
単に無視されます。
.El
.Sh 特殊ターゲット
特殊ターゲットは、他のターゲットとともに使用してはいけません。すなわち、
依存関係記述行の唯一のターゲットとして指定する必要があります。
.Bl -tag -width Ic .BEGIN
.It Ic .BEGIN
本ターゲットに指定されたシェルコマンドは他の処理に先立って実行されます。
.It Ic .DEFAULT
これは、作成方法がわからないどんなターゲットにも適用される
.Ic .USE
ルールのようなものです。シェルスクリプトのみを使用します。
.Ic .DEFAULT
に指定されたコマンド中の
.Ic .IMPSRC
変数はターゲット自身の名前に置換されます。
.It Ic .END
本ターゲットに指定されたシェルコマンドは、他のすべての処理の終了後に
実行されます。
.It Ic .IGNORE
指定されたソースに
.Ic .IGNORE
属性を付与します。もしソースが指定されていなければ、
.Fl i
オプションを指定したのと同じ意味になります。
.It Ic .INTERRUPT
.Nm make
が中断されたとき、本ターゲットに指定されたコマンドを実行します。
.It Ic .MAIN
ターゲットを指定せずに
.Nm make
が起動された場合、本ターゲットを処理します。
.It Ic .MAKEFLAGS
ソースにおいて、
.Nm make
に指定するフラグを指定します。フラグはシェルでタイプしたのと同様に
渡されますが、
.Fl f
オプションは無効になります。
.\" XXX: NOT YET!!!!
.\" .It Ic .NOTPARALLEL
.\" この名前のターゲットは、並列モードを使わすに実行されます。
.\" ターゲットが指定されていない時には、全てのターゲットが非並列モード
 \" で実行されます。
.It Ic .NOTPARALLEL
並列モードを使いません。
.It Ic .NO_PARALLEL
上と同じですが、 pmake の変種のための互換性のためにあります。
.It Ic .ORDER
シーケンス中の名前付きターゲットが作成されます。
.\" XXX: NOT YET!!!!
.\" .It Ic .PARALLEL
.\" 名前付きターゲットが並列モードで実行されます。
.\" ターゲットが指定されない時には、全てのターゲットが並列モードで実行
.\" されます。
.It Ic .PATH
カレントディレクトリに発見できなかったときのファイルの検索パスを、
本ターゲットのソースとして指定します。ソースが指定されなかった場合、
以前に設定されていたディレクトリが無効になります。
.It Ic .PHONY
.Ic .PHONY
属性を指定したソースに適用します。この属性を持ったターゲットは
いつでも更新されていると考えられます。
.It Ic .PRECIOUS
指定されたソースに
.Ic .PRECIOUS
属性を付与します。もし、ソースが指定されなかった場合、
すべてのターゲットに
.Ic .PRECIOUS
属性を与えます。
.It Ic .SILENT
指定されたソースに
.Ic .SILENT
属性を付与します。もし、ソースが指定されなかった場合、
ファイル中のすべてのコマンドに
.Ic .SILENT
属性を与えます。
.It Ic .SUFFIXES
ソースにおいて、
.Nm make
で用いる拡張子を指定します。ソースが指定されなかった場合は、
以前の指定が無効になります。
.Sh 環境変数
.Nm make
は以下の環境変数の値を用います:
.Ev MACHINE ,
.Ev MAKE ,
.Ev MAKEFLAGS ,
.Ev MAKEOBJDIR ,
.Ev MAKEOBJDIRPREFIX ,
.Ev PWD 
.Sh 関連ファイル
.Bl -tag -width /usr/share/doc/psd/12.make -compact
.It .depend
依存関係リスト
.It Makefile
依存関係リスト
.It makefile
依存関係リスト
.It sys.mk
システム定義の makefile
.It /usr/share/mk
システム定義の makefile が置かれるディレクトリ
.It /usr/share/doc/psd/12.make
PMake のチュートリアル
.El
.Sh 関連項目
.Xr mkdep 1
.Rs
.%T "PMake - A Tutorial"
.Re
.Sh 歴史
.Nm make
は
.At v7
において追加されました。