名 前
diff3 − 3 つ の フ ァ イ ル 間 に あ る 違 い を 探 す
書 式
diff3 [−3aeimxAETX] [-L LABEL] [−−easy−only] [−−ed] [−−initial−tab] [−−label=LABEL] [−−merge] [−−overlap−only] [−−show−all] [−−show−overlap] [−−text] MINE OLDER YOUR
diff3 [−v] [−−help] [−−version]
説 明
diff3 は 3 つ の フ ァ イ ル を 比 較 し 、 そ れ ら の 違 い の 説 明 を 出 力 す る 。 比 較 対 象 と な る フ ァ イ ル は MINE, OLDER, YOURS で あ る 。 こ れ ら 三 つ の フ ァ イ ル の う ち の 一 つ を ’−’ と し て も よ く 、 そ の 場 合 そ の フ ァ イ ル は 標 準 入 力 か ら 読 み 込 ま れ る 。 通 常 diff3 は 自 分 の 作 業 の た め に diff を 起 動 す る 。 し か し BDIFF 環 境 変 数 に 他 の プ ロ グ ラ ム を 設 定 す れ ば 、 そ の プ ロ グ ラ ム を 使 う よ う に 変 更 で き る 。
オ プ シ ョ ン
−3, −−easy−only
−e と 似 て い る が 、 重 複 し て い な い 変 更 部 分 だ け を 出 力 す る 。
−a,
−−text フ ァ イ ル
が テ キ ス ト に
は 見 え な い よ
う な 場 合 で も
、 全 て の フ ァ
イ ル を テ キ ス
ト と み な し て 1
行 ず つ 比 較 を
行 う 。
−e, −−ed
OLDER か ら YOURS へ の す べ て の 変 更 を MINE に マ ー ジ す る よ う な ed ス ク リ プ ト を 生 成 す る 。
−i |
System V 互 換 性 の た め に 、 ed ス ク リ プ ト の 末 尾 に ’w’ コ マ ン ド と ’q’ コ マ ン ド を 生 成 す る 。 こ の オ プ シ ョ ン は −AeExX3 の い ず れ か の オ プ シ ョ ン と 共 に 用 い な け れ ば な ら な い 。 ま た −m と 同 時 に 指 定 す る こ と は で き な い 。 |
−m, -−merge
ed ス ク リ プ ト を 1 番 目 の フ ァ イ ル に 適 用 し 、 そ の 結 果 を 標 準 出 力 に 送 る 。 diff3 の 出 力 を ed に 送 る の と 異 な り 、 こ の オ プ シ ョ ン の 動 作 は バ イ ナ リ フ ァ イ ル や 改 行 さ れ て い な い 行 に も 適 用 で き る 。 ed ス ク リ プ ト の オ プ シ ョ ン が 何 も 指 定 さ れ な け れ ば 、 −A を 暗 黙 の う ち に 指 定 す る 。
−x, −−overlap−only
−e と 似 て い る が 、 重 複 し て い る 変 更 だ け を 出 力 す る 点 が 異 な る 。
−A, −−show−all
OLDER か ら YOURS へ の 全 て の 変 更 を MINE に マ ー ジ す る 。 重 複 し て い る 変 更 は ブ ラ ケ ッ ト 行 で 囲 っ て 出 力 す る 。
−E, −−show−overlap
−e と 似 て い る が 、 重 複 部 分 の ブ ラ ケ ッ ト 行 の 第 1・ 第 3 行 が 異 な る 。 −E で は 重 複 し て い る 変 更 は 以 下 の よ う に な る 。
<<<<<<<
MINE
lines from MINE
=======
lines from YOURS >>>>>>>
YOURS
−L LABEL, −−label=LABEL
−A, −E, −X オ プ シ ョ ン の ブ ラ ケ ッ ト 行 に 、 ラ ベ ル LABEL を 用 い る 。 こ の オ プ シ ョ ン は そ れ ぞ れ の 入 力 フ ァ イ ル に 対 応 し て 3 つ ま で 与 え る こ と が で き る 。 デ フ ォ ル ト の ラ ベ ル は 入 力 フ ァ イ ル の フ ァ イ ル 名 で あ る 。 し た が っ て diff3 −L X −L Y −L Z −m A B C は diff3 −m A B C と 同 じ よ う に 動 作 す る が 、 入 力 が A, B, C で は な く X, Y, Z の も の で あ る か の よ う な 出 力 と な る 。
−T, −−initial−tab
−X |
−E と 似 て い る が 、 重 複 し て い る 変 更 だ け を 出 力 す る 点 が 異 な る 。 別 の 言 い 方 を す れ ば 、 −x と 似 て い る が 、 −E の よ う に 変 更 を ブ ラ ケ ッ ト 行 で 囲 う 点 が 異 な る 。 | ||
−−help |
標 準 出 力 に 使 用 方 法 の メ ッ セ ー ジ を 出 力 し て 正 常 終 了 す る 。
−v, −−version |
diff3 の バ ー ジ ョ ン 番 号 を 出 力 す る 。
出 力 形 式
そ れ ぞ れ の hunk (違 い を 表 す テ キ ス ト ブ ロ ッ ク ) は ’====’ と い う 行 か ら 始 ま る 。 3 フ ァ イ ル と も 異 な る hunk で は た だ の ’====’ と な り 、 1 フ ァ イ ル が 異 な っ て い る hunk で は ’1’, ’2’, ’3’ の い ず れ か が 、 そ の 異 な っ て い る フ ァ イ ル を 示 す た め に 付 加 さ れ る 。 hunk に は 2 つ 、 ま た は 3 つ の 入 力 行 の セ ッ ト が 含 ま れ 、 そ れ ぞ れ に 行 セ ッ ト が ど の フ ァ イ ル 由 来 の も の か を 示 す 1 つ ま た は 2 つ の コ マ ン ド が 前 置 さ れ る 。 デ フ ォ ル ト の 動 作 で は 、 入 力 行 の 前 に は 2 つ の ス ペ ー ス が 置 か れ 、 コ マ ン ド と 区 別 で き る よ う に な っ て い る 。 −T が 指 定 さ れ る と 、 代 わ り に タ ブ を 用 い る の で 、 入 力 に あ っ た タ ブ に よ る 桁 揃 え が 正 し く 保 存 さ れ る 。 コ マ ン ド 形 式
FILE:La
こ の hunk は FILE の
L 行 以 降 に 現
れ る べ き も の
で 、 そ の フ ァ
イ ル に は 存 在
し て い な い 。
こ の フ ァ イ ル
を 修 正 し て 他
の フ ァ イ ル と
同 じ に す る に
は 、 他 の 行 か
ら の hunk の 行 を 追
加 し な け れ ば
な ら な い 。 例
え ば ’1:11a’ は 、
そ の hunk は フ ァ イ
ル 1 の 11 行 目 以 降
に 追 加 す べ き
も の で 、 フ ァ
イ ル 1 に は 含 ま
れ て い な い こ
と 示 す 。
FILE:Rc こ の hunk
に は 、 FILE の 行
範 囲 R が 含 ま
れ て い る 。 行
範 囲 R は 2 つ の
行 番 号 を コ ン
マ で 区 切 っ た
も の で あ る 。
数 字 が 一 つ だ
っ た ら 1 行 だ け
の 範 囲 と 解 釈
さ れ る 。 こ の
フ ァ イ ル を 編
集 し て 他 の フ
ァ イ ル と 同 じ
に す る に は 、
そ の 行 範 囲 を
、 他 の フ ァ イ
ル か ら と っ て
き て 変 更 し な
け れ ば な ら な
い 。 例 え ば
’2:11,13c’ は 、 こ の
hunk は 2 番 目 の フ ァ
イ ル の 11〜 13 行 目
か ら と っ て き
た も の で あ る
こ と を 示 す 。
入 力 行 セ ッ ト
の 最 後 の 行 が
改 行 で 終 わ っ
て い な い 場 合
は 、 出 力 の 次
の 行 が ’\’ で
始 ま る の で 、
改 行 で 終 わ っ
て い る 場 合 と
区 別 で き る 。
返 り 値
diff3 は 以 下 の ど れ か の 値 で 終 了 す る :
0 |
diff3 は 成 功 し 、 重 複 し て い る 変 更 (衝 突 ) は 存 在 し な か っ た 。 | ||
1 |
重 複 が 見 付 か っ た 。
2 何 ら か の エ ラ ー が 起 こ っ た 。 |
関 連 項 目
cmp(1), comm(1), diff(1), ed(1), patch(1), sdiff(1),
注 意
プ ロ グ ラ ム の バ グ に つ い て は bug-gnu-utils [AT] gnu.org に 報 告 し て く だ さ い 。 ペ ー ジ の 更 新 は Ragnar Hojland Espinosa <ragnar [AT] ragnar-hojland.com> が 行 っ て い ま す 。