Manpages

名 前

diff − 2 つ の フ ァ イ ル 間 の 違 い を 探 す

書 式

diff [−abcdefhilnpqrstuwyBEHNPT] [−LINES] [−x PATTERN] [−C LINES] [−D NAME] [−F REGEXP] [−I REGEXP] [−L LABEL] [−S FILE] [−U LINES] [−W COLUMNS] [−X FILE] [−−binary] [−−brief] [−−changed−group−format=fORMAT] [−−context[=LINES]] [−−diff−program=PROGRAM] [−−ed] [−−exclude=PATTERN] [−−exclude-from=FILE] [−−expand−tabs] [−−forward−ed] [−−from−file=FILE] [−−horizon−lines=LINES] [−−ifdef=NAME] [−−ignore−all−space] [−−ignore−blank−lines] [−−ignore−case] [−−ignore−file−name−case] [−−ignore−matching−lines=REGEXP] [−−ignore−space−change] [−−ignore−tab−expansion] [−−inhibit−hunk−merge] [−−initial−tab] [−−label=LABEL] [−−left−column] [−−line−format=FORMAT] [−−minimal] [−−new−file] [−−new−group−format=FORMAT] [−−new−line−format=FORMAT] [−−no−ignore−file−name−case] [−−old−group−format=FORMAT] [−−old−line−format=FORMAT] [−−paginate] [−−rcs] [−−recursive] [−−report−identical−files] [−−sdiff−merge−assist] [−−show−c−function] [−−show−function−line=REGEXP] [−−side−by−side] [−−speed−large−files] [−−starting−file=FILE] [−−strip−trailing−cr] [−−supress−common−lines] [−−text] [−−to−file=FILE] [−−unchanged−group−format=FORMAT] [−−unchanged−line−format=FORMAT] [−−unidirectional−new−file] [−−unified[=LINES]] [−−width=COLUMNS] FROMFILE TOFILE

diff [−v] [−−help] [−−version]

説 明

diff は 2 つ の フ ァ イ ル を 比 較 し 、 そ れ ら の 違 い を 記 述 し て 出 力 す る 。 も っ と も 簡 単 な 場 合 は 、 比 較 対 象 の フ ァ イ ル は FROMFILE と TOFILE で あ る 。 こ れ ら の フ ァ イ ル の う ち の ど ち ら か は ’−’ と 指 定 し て も 良 い 。 こ の 時 は そ の フ ァ イ ル は 標 準 入 力 か ら 読 み 込 ま れ る 。

FROMFILE が デ ィ レ ク ト リ で TOFILE が デ ィ レ ク ト リ で は な い 場 合 、 diff は デ ィ レ ク ト リ FROMFILE に あ る 、 フ ァ イ ル 名 が TOFILE の フ ァ イ ル を 比 較 対 象 に す る (逆 も 同 様 )。 デ ィ レ ク ト リ で な い 方 の 指 定 を ’−’ に す る こ と は で き な い 。 両 方 が デ ィ レ ク ト リ の と き は 、 diff は 双 方 の デ ィ レ ク ト リ に あ る 、 対 応 す る フ ァ イ ル を ア ル フ ァ ベ ッ ト 順 に そ れ ぞ れ 比 較 す る 。 比 較 は 再 帰 的 に は 行 わ れ な い が 、 −r ま た は −−recursive オ プ シ ョ ン を 指 定 す れ ば 再 帰 的 に な る 。 diff は デ ィ レ ク ト リ の 内 容 そ の も の を フ ァ イ ル の よ う に 比 較 す る こ と は し な い 。 フ ル パ ス 指 定 の フ ァ イ ル は ’−’ で あ っ て は な ら な い 。 な ぜ な ら 標 準 入 力 に は 名 前 が な い の で 、 「 同 名 の フ ァ イ ル 」 と い う 概 念 が 使 え な い か ら で あ る 。

−−from−file=FILE オ プ シ ョ ン が 与 え ら れ る と 、 任 意 の 数 の フ ァ イ ル 名 を 与 え る こ と が で き 、 そ れ ぞ れ の フ ァ イ ル は FILE と 比 較 さ れ る 。 同 様 に 、 −−to−file=FILE オ プ シ ョ ン が 与 え ら れ る と 、 そ れ ぞ れ 指 定 さ れ た フ ァ イ ル は FILE と 比 較 さ れ る 。 [訳 注 : 2.7 に は こ れ ら の オ プ シ ョ ン は 存 在 し な い ]

オ プ シ ョ ン

る 。 こ の オ プ シ ョ ン は 出 力 形 式 自 体 の 指 定 は 行 わ な い 。 し た が っ て −c や −u オ プ シ ョ ン と 一 緒 に 用 い な い と 、 な ん の 効 果 も 持 た な い 。 こ の オ プ シ ョ ン は obsolete で あ る 。 patch(1) が 正 し く 動 作 す る に は 、 少 な く と も 2 行 の コ ン テ ク ス ト が 必 要 で あ る 。

−a, −−text フ ァ イ ル が テ キ ス ト に は 見 え な い よ う な 場 合 で も 、 全 て の フ ァ イ ル を テ キ ス ト と み な し て 1 行 ず つ 比 較 を 行 う 。
−b, −−ignore−space−change ス ペ ー ス の 数 だ け が 違 う 場 合 に は 違 い を 無 視 す る 。 不 完 全 な 行 は 無 視 さ れ る 。

−d, −−minimal ア ル ゴ リ ズ ム を 変 更 し 、 よ り 小 さ な 差 分 が 生 成 で き る よ う に す る 。 こ れ を 使 う と diff は 遅 く な る (非 常 に 遅 く な る 場 合 も あ る )。
−e, −−ed

ed(1) の ス ク リ プ ト 形 式 で 出 力 す る 。

−f, −−forward−ed

ed の ス ク リ プ ト と 一 見 同 じ よ う な 出 力 を す る 。 し か し 出 力 に 現 れ る 順 序 が 異 な る [訳 注 : し た が っ て ed で は 使 え な い ]。

こ れ は 推 奨 さ れ な い 。

−i, −−ignore−case 英 大 文 字 と 小 文 字 の 違 い を 無 視 す る 。
−l, −−paginate 出 力 を pr(1) に 通 し て ペ ー ジ 付 け を 行 う 。
−n, −−rcs

RCS 形 式 の diff を 出 力 す る 。 −f と 似 て い る が 、 そ れ ぞ れ の コ マ ン ド は 処 理 す る 行 数 を 指 定 す る 。

−p, −−show−c−function 変 更 が ど の C 関 数 で 行 わ れ た の か を 表 示 す る 。 ’−F’^[_a−zA−Z$]’’ と 同 じ 。
−q, −−brief フ ァ イ ル が 違 う か ど う か だ け を 報 告 す る 。 違 い の 詳 細 は 報 告 し な い 。
−r, −−recursive デ ィ レ ク ト リ を 比 較 す る と き 、 見 付 か っ た サ ブ デ ィ レ ク ト リ を す べ て 再 帰 的 に 比 較 す る 。
−s, −−report−identical−files

2 つ の フ ァ イ ル が 同 じ だ っ た と き も 報 告 す る 。

−t, −−expand−tabs 入 力 フ ァ イ ル で の タ ブ に よ る 位 置 あ わ せ を 保 存 す る た め 、 出 力 の タ ブ を ス ペ ー ス に 展 開 す る 。

−w, −−ignore−all−space 行 を 比 較 す る と き ス ペ ー ス を 無 視 す る 。 不 完 全 な 行 は 無 視 さ れ る 。
−x PATTERN, −−exclude=PATTERN デ ィ レ ク ト リ を 比 較 す る と き 、 フ ァ イ ル 名 の base 部 が PATTERN に マ ッ チ す る フ ァ イ ル や サ ブ デ ィ レ ク ト リ を 無 視 す る 。
−y, −−side−by−side

side-by-side 出 力 形 式 を 用 い る 。

−B, −−ignore−blank−lines 空 行 を 挿 入 ・ 削 除 す る だ け の 変 更 を 無 視 す る 。
−C LINES, −−context[=LINES]

context 出 力 形 式 を 用 い 、 LINES 行 (整 数 値 ) の コ ン テ ク ス ト を 表 示 す る 。 LINES が 与 え ら れ な け れ ば 3 行 表 示 す る 。 patch が 正 し く 動 作 す る た め に は 、 少 な く と も 2 行 の コ ン テ ク ス ト が 必 要 で あ る こ と が 多 い 。

−D NAME, −−ifdef=NAME

if-then-else 形 式 で マ ー ジ さ れ た 出 力 を 行 い 、 プ リ プ ロ セ ッ サ の 条 件 マ ク ロ に NAME を 用 い る 。

−E, −−ignore−tab−expansion タ ブ 展 開 に よ る ス ペ ー ス の 変 更 を 無 視 す る 。
−F REGEXP, −−show−function−line=REGEXP

context 形 式 と unified 形 式 に お い て 、 各 差 分 hunk (テ キ ス ト ブ ロ ッ ク ) に 対 し 、 そ の 前 方 で REGEXP に マ ッ チ し た 最 後 の 行 の 一 部 を 表 示 す る 。

−H, −−speed−large−files 小 さ な 変 更 が 大 量 に あ る よ う な 大 き な フ ァ イ ル を 高 速 に 扱 う た め に 、 ヒ ュ ー リ ス テ ィ ッ ク な 手 法 を 用 い る 。 短 縮 形 式 −H は 推 奨 さ れ な く な っ た 。
−I REGEXP, −−ignore−matching−lines=REGEXP

REGEXP に マ ッ チ す る よ う な 行 を 挿 入 ・ 削 除 す る だ け の 変 更 を 無 視 す る 。

−L LABEL, −−label=LABEL

context 形 式 と unified 形 式 の ヘ ッ ダ に 、 フ ァ イ ル 名 で は な く LABEL を 用 い る 。 短 縮 形 式 −L は 推 奨 さ れ な く な っ た 。

−N, −−new−file デ ィ レ ク ト リ を 比 較 す る 際 、 片 方 の デ ィ レ ク ト リ に の み フ ァ イ ル が 存 在 し て い た ら 、 も う 片 方 の デ ィ レ ク ト リ に は 同 名 の 空 っ ぽ の フ ァ イ ル が あ る よ う に 動 作 す る 。
−P, −−unidirectional−new−file デ ィ レ ク ト リ を 比 較 す る 際 、 2 番 目 の デ ィ レ ク ト リ に の み フ ァ イ ル が 存 在 し て い た ら 、 1 番 目 の デ ィ レ ク ト リ に は 同 名 の 空 っ ぽ の フ ァ イ ル が あ る よ う に 動 作 す る 。 短 縮 形 式 −P は 推 奨 さ れ な く な っ た 。
−S FILE, −−starting−file=FILE デ ィ レ ク ト リ を 比 較 す る 際 、 FILE か ら 始 め る 。 中 断 し た 比 較 を 続 行 す る 際 に 利 用 で き る 。
−T, −−initial−tab

normal 形 式 や context 形 式 で 、 テ キ ス ト の 前 に ス ペ ー ス で な く タ ブ を 出 力 す る 。 こ う す る と 行 中 で の タ ブ に よ る 桁 揃 え が 普 通 に 見 え る 。

−U LINES, −−unified[=LINES]

unified 出 力 形 式 を 用 い 、 LINES 行 (整 数 値 ) の コ ン テ ク ス ト を 表 示 す る 。 LINES が 与 え ら れ な け れ ば 3 行 表 示 す る 。 patch が 正 し く 動 作 す る た め に は 、 少 な く と も 2 行 の コ ン テ ク ス ト が 必 要 で あ る こ と が 多 い 。

−W COLUMNS, −−width=COLUMNS

side-by-side 形 式 で 、 出 力 の 幅 を COLUMNS に す る 。

−XFILE, −−exclude−from=FILE デ ィ レ ク ト リ を 比 較 す る 際 、 フ ァ イ ル 名 の base 部 が FILE の パ タ ー ン の い ず れ か に マ ッ チ す る フ ァ イ ル や サ ブ デ ィ レ ク ト リ を 無 視 す る 。
−−binary デ ー タ を バ イ ナ リ モ ー ド で 読 み 書 き す る (Linux や そ の 他 の POSIX ホ ス ト で は 意 味 な し )。
−−changed−group−format=FORMAT

if-then-else 形 式 で 、 両 方 の フ ァ イ ル で 異 な る 行 グ ル ー プ の 出 力 に FORMAT を 用 い る 。

−−diff−program= PROGRAM フ ァ イ ル の 比 較 す る た め に diff と 互 換 性 の あ る 外 部 プ ロ グ ラ ム PROGRAM を 用 い る 。
−−from−file=FILE

FILE を 各 オ ペ ラ ン ド と 比 較 す る (FILE は デ ィ レ ク ト リ で も 良 い )。 [訳 注 : 2.7 に は こ の オ プ シ ョ ン は 存 在 し な い ]

−−horizon−lines=LINES 差 分 を も っ と も コ ン パ ク ト に 出 力 す る た め に 、 違 う 部 分 の 前 後 に あ る 共 通 部 分 の そ れ ぞ れ LINES 行 を 捨 て ず に 保 存 す る 。
−−ignore−file−name−case フ ァ イ ル を 比 較 す る 際 に フ ァ イ ル 名 の 大 文 字 小 文 字 を 無 視 す る 。 そ の た め ’’foo’’ と ’’Foo’’ は 同 じ と さ れ る の で 、 互 い に 比 較 さ れ る 。
−−inhibit−hunk−merge 隣 接 す る hunk の 境 界 を 移 動 し て hunk を マ ー ジ す る 動 作 を 行 わ な い 。
−−left−column

side-by-side 形 式 で 、 共 通 な 行 は 左 側 の 列 に し か 表 示 し な い 。

−−line−format=FORMAT

if-then-else 形 式 で 、 全 て の 入 力 行 の 出 力 に FORMAT を 用 い る 。

−−new−group−format=FORMAT

if-then-else 形 式 で 、 2 番 目 の フ ァ イ ル だ け に あ る 行 グ ル ー プ の 出 力 に FORMAT を 用 い る 。

−−new−line−format=FORMAT

if-then-else 形 式 で 、 2 番 目 の フ ァ イ ル だ け に あ る 行 の 出 力 に FORMAT を 用 い る 。

−−no−ignore−file−name−case フ ァ イ ル を 比 較 す る 際 に 、 フ ァ イ ル 名 の 大 文 字 小 文 字 を 考 慮 す る 。 そ の た め ’’foo’’ と ’’Foo’’ は 同 じ も の と さ れ な い 。 −−ignore−file−name−case を 参 照 す る こ と 。
−−old−group−format=FORMAT

if-then-else 形 式 で 、 1 番 目 の フ ァ イ ル だ け に あ る 行 グ ル ー プ の 出 力 に FORMAT を 用 い る 。

−−old−line−format=FORMAT

if-then-else 形 式 で 、 1 番 目 の フ ァ イ ル だ け に あ る 行 の 出 力 に FORMAT を 用 い る 。

−−sdiff−merge−assist

sdiff(1) 用 に 追 加 情 報 を 表 示 す る 。 sdiff が diff を 実 行 す る と き に こ の オ プ シ ョ ン を 用 い る 。 通 常 の ユ ー ザ ー が こ の オ プ シ ョ ン を 直 接 指 定 す る 場 合 は あ ま り 想 定 さ れ て い な い 。

−−strip−trailing−cr 行 末 の CR を 取 り 除 く 。 行 末 の マ ー カ と し て CRLF を 使 う シ ス テ ム の 出 力 を 処 理 す る と き に 役 立 つ 。
−−suppress−common−lines

side-by-side 形 式 で 共 通 な 行 を 表 示 し な い 。

−−unchanged−group−format=FORMAT

if-then-else 形 式 で 、 両 方 の フ ァ イ ル に 共 通 な 行 グ ル ー プ の 出 力 に FORMAT を 用 い る 。

−−unchanged−line−format=FORMAT

if-then-else 形 式 で 、 両 方 の フ ァ イ ル に 共 通 な 行 の 出 力 に FORMAT を 用 い る 。

−v, −−version

diff の バ ー ジ ョ ン 番 号 を 出 力 す る 。

出 力 の 形 式

context 形 式
context 出 力 形 式 は 2 行 の ヘ ッ ダ か ら は じ ま る 。 こ れ は 以 下 の よ う な も の で あ る :

*** FROMFILE FROMFILE-MODIFICATION-TIME
--- TOFILE TOFILE-MODIFICATION-TIME

−L LABEL を 用 い る と ヘ ッ ダ の 内 容 は 変 化 す る 。 次 に 来 る の は hunk (テ キ ス ト ブ ロ ッ ク ) で あ る 。 繰 り 返 し 登 場 す る こ と も あ る 。 context 形 式 の hunk は 以 下 の よ う な も の で あ る :

***************
*** FROMFILE-LINE-RANGE ****
FROMFILE-LINE
FROMFILE-LINE...
--- TOFILE-LINE-RANGE ----
TOFILE-LINE
TOFILE-LINE... 異 な っ て い る 行 の 周 辺 の コ ン テ ク ス ト の 各 行 に は 、 先 頭 に 2 つ の ス ペ ー ス が つ い て い る 。 2 つ の フ ァ イ ル 間 で 異 な っ て い る 行 に は 、 先 頭 に 表 示 文 字 と ス ペ ー ス が つ く 。

hunk の 全 て の 変 更 が 挿 入 で あ れ ば 、 FROMFILE 各 行 は 省 略 さ れ る 。 ま た 全 て の 変 更 が 削 除 で あ れ ば 、 TOFILE 各 行 は 省 略 さ れ る 。

unified 形 式
--- FROMFILE FROMFILE-MODIFICATION-TIME
+++ TOFILE TOFILE-MODIFICATION-TIME

−L LABEL を 用 い る と ヘ ッ ダ の 内 容 は 変 化 す る 。 次 に 来 る の は hunk (テ キ ス ト ブ ロ ッ ク ) で あ る 。 繰 り 返 し 登 場 す る こ と も あ る 。 そ れ ぞ れ の hunk は フ ァ イ ル の 異 な っ て い る 1 つ 1 つ の 部 分 を 示 し て い る 。 unified 形 式 の hunk は 以 下 の よ う な も の で あ る :

@@ FROMFILE-RANGE TOFILE-RANGE @@
LINE-FROM-EITHER-FILE
LINE-FROM-EITHER-FILE... 両 者 で 共 通 な 行 の 前 に は 1 つ の ス ペ ー ス が 置 か れ る 。 異 な る 行 の 前 に は 以 下 の 表 示 文 字 が 置 か れ る :

side-by-side 形 式 フ ァ イ ル は 2 列 に 表 示 さ れ 、 間 に の ど (gutter) が 置 か れ る 。 の ど に は 以 下 の マ ー カ ー の い ず れ か 1 つ が 含 ま れ る 。

な わ ち 、 折 り 目 に な る と こ ろ ) を 指 す 。

−−ignore オ プ シ ョ ン の い ず れ か に よ っ て 無 視 さ れ た 。

1 番 目 の フ ァ イ ル に だ け こ の 行 が 含 ま れ て い る 。

1 番 目 の フ ァ イ ル に だ け こ の 行 が 含 ま れ て い る が 、 違 い は 無 視 さ れ る 。