989d921f5d
I'm very pleased to announce the release of our new website and documentation using the new toolchain with Hugo and AsciiDoctor. To get more information about the new toolchain please read the FreeBSD Documentation Project Primer[1], Hugo docs[2] and AsciiDoctor docs[3]. Acknowledgment: Benedict Reuschling <bcr@> Glen Barber <gjb@> Hiroki Sato <hrs@> Li-Wen Hsu <lwhsu@> Sean Chittenden <seanc@> The FreeBSD Foundation [1] https://docs.FreeBSD.org/en/books/fdp-primer/ [2] https://gohugo.io/documentation/ [3] https://docs.asciidoctor.org/home/ Approved by: doceng, core
190 lines
3.6 KiB
Groff
190 lines
3.6 KiB
Groff
.\" $FreeBSD$
|
|
.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 を返します。
|