.\" jpman %Id: diff3.1,v 1.2 1997/06/02 15:34:32 horikawa Stab %
.TH DIFF3 1 "22sep1993" "GNU Tools" "GNU Tools"
.SH 名称
diff3 \- 3 つのテキストファイルの差を求める
.SH 書式
.B diff3
[options] mine older yours
.SH 解説
.I diff3
は、3 つのファイルの間で比較を行ない、それらの違いを出力します。

比較するファイルは
.IR mine ,
.IR older ,
.I yours
です。
これらのうち、1 つは
.BR \-
を使用しても良く、これはファイルの代わりに標準入力を読むことを
.I diff3
に指示します。
.SS オプション
以下が GNU
.I diff3
が受け付ける全てのオプションのまとめです。
(引数を取らない限り)1 文字のオプションをまとめて
1 つのコマンドライン引数に出来ます。
.TP
.B \-a
テキストファイルでないようなものについても、
全てのファイルをテキストとみなして、1 行づつ比較していきます。
.TP
.B \-A
.I older
から
.I yours
への変更の全てを、
.I mine
に統合します。同じ行への変更で矛盾が出る部分は、ブラケット行で囲みます。
.TP
.B \-B
-A の古い挙動です。矛盾のある部分を表示しません。
.TP
.B \-e
.I older
から
.I yours
への変更の全てを、
.IR mine
に統合するような
.I ed
のスクリプトを生成します。
.TP
.B \-E
.B \-e
と同様ですが、
mine と yours とで重複する変更行をブラケットで括ります。
.B \-e
では重複する行については、次のように出力されます:
.sp
.nf
<<<<<<< \fImine\fP
lines from \fImine\fP
=======
lines from \fIyours\fP
>>>>>>> \fIyours\fP
.fi
.TP
.B \-\-ed
.I older
から
.I yours
への変更の全てを、
.IR mine
に統合するような
.I ed
のスクリプトを生成します。
.TP
.B \-\-easy\-only
mine と yours の変更箇所が重複するような行を出力しない事を除いては、
.B \-e
と同等です。
.TP
.B \-i
System V との互換のため、
.I ed
のスクリプトの最後に、
.B w
と
.B q
を出力します。このオプションは、オプション
.B \-AeExX3
のどれか 1 つと組み合わせて使われなけれなまりません。また、オプション
.B \-m
と組み合わせる事はできません。
.TP
.B \-\-initial\-tab
出力行の前に、通常の 2 文字の空白の代わりにタブを入れます。
各行の見た目が、タブ位置に揃います。
.TP
.BI "\-L " label
.ns
.TP
.BI \-\-label= label
.BR \-A ,
.BR \-E ,
.B \-X
の各オプションで出力されるブラケットの部分に出力されるファイル名の代わりに
label で指定したラベルを使用します。このオプションは、
mine, older, yours の 3 つのファイルに対応して、3 回指定できます。
デフォルトは入力ファイル名です。
.B "diff3 \-L X \-L Y \-L Z \-m A B C"
は
.B "diff3 \-m A B C"
と比べると、
.BR A ,
.BR B ,
.B C
が出力される代わりに、ラベル
.BR X ,
.BR Y , 
.B Z
が出力されます。
.TP
.B \-m
.br
.ns
.TP
.B \-\-merge
mine を生成するエディットスクリプトをつくり、結果を標準出力に送ります。
.I diff3
の出力を
.IR ed
にパイプでつなぐのと異なり、
バイナリファイルや不完全な行に対しても適用できます。
エディットスクリプトのオプションが指定されてない場合は、
.B \-A
として処理します。
.TP
.B \-\-overlap\-only
mine と yours の変更箇所が重複する行だけを出力する点を除いて、
.BR \-e
と同様です。
.TP
.B \-\-show\-all
older から yours への変更を mine に統合します。重複する部分は、
ブラケット行で囲みます。
.TP
.B \-\-show\-overlap
.B \-e
と同様ですが、mine と yours で重なる変更行をブラケットで括ります。
.TP
.B \-T
出力行の前に、通常の 2 文字の空白の代わりにタブを入れます。
各行の見た目が、タブ位置に揃います。
.TP
.B \-\-text
テキストファイルでないようなものについても、
全てのファイルをテキストとみなして、1 行づつ比較していきます。
.TP
.B \-v
.br
.ns
.TP
.B \-\-version
.I diff3
のバージョン番号を表示します。
.TP
.B \-x
.B \-e
と似ていますが、重なる変更のみを表示します。
.TP
.B \-X
.B \-E
と同様ですが、重なる変更のみを表示します。
言い替えると、
.B \-x
と同様ですが、
.B \-E
と同じように変更をブラケットで括ります。
.TP
.B \-3
.B \-e
と同様ですが、重ならない変更部分のみを出力します。
.SH 関連項目
cmp(1), comm(1), diff(1), ed(1), patch(1), sdiff(1).
.SH 診断
.I diff3
が成功した場合は 0 を、なんらかの矛盾が発見された場合は 1 を、何かエラーが
おきた場合は 2 を返します。