.\" Date: Fri, 11 Sep 1998 19:13:45 +0100
.\" From: Edward Betts 
.\" Chinese Version Copyrighted Scorpino, www.linuxforum.net 2000
.\" Derived from the GNU diff info page.
.\" May be distributed under the GPL.
.TH DIFF 1 "22sep1993" "GNU Tools" "GNU Tools"
.SH NAME
diff \- 找出兩個檔案的不同點
.SH 總覽
.B diff
[選項] 原始檔 目標檔案
.SH 描述
在最簡單的情況是, 
.I diff
比較兩個檔案的內容
.I （原始檔
和
.IR 目標檔案） .
檔名可以是
.B \-
由標準輸入裝置讀入的文字.
作為特別的情況是,
.B "diff \- \-"
比較一份標準輸入的它自己的複製
如果 
.I 原始檔
是一個目錄和
.I 目標檔案
不是（目錄）,
.I diff
會比較在
.I 原始檔（目錄）
裡的檔案的中和
.IR 目標檔案同名的（檔案）,
反過來也一樣. 非目錄檔案不能是
.BR \- .

如果
.I 原始檔
和
.I 目標檔案
都是目錄,
.I diff
比較兩個目錄中相應的檔案，
依照字母次序排序；這個比較是不會遞迴的，除非給出
.B \-r
或者
.B \-\-recursive.
.I diff
不把一個目錄的內容看為它是一個檔案來比較。被指定的檔案不
能是標準的輸入, 因為標準的輸入是無名的並且＂有一樣的名字的文
件＂的觀點不適用。
.B diff
的選項由
.BR \- ,
開始
所以正常地
.I 原始檔（名）
和
.I 目標檔案（名）
不可以用
.BR \- 
開頭.
然而,
.B \-\-
可以被它視為保留的即使作為檔名的開頭（
they begin with
.BR \- . ）
.SS 選項
下面是 GNU所接受的
.I diff
的所有選項的概要.
大多數的選項有兩個相同的名字,一個是單個的
跟在 
.BR \- 
後面字母,
另一個是由
.BR \-\- 
引出的長名字.
多個單字母選項（除非它們產生歧義）能夠組合為單行的命令列語法
.B \-ac
是等同於
.BR "\-a \-c" .
長命名的選項能被縮短到他們的名字的任何唯一的字首.
用
.RB ( [
和
.BR ] )
括起來顯示選項產生歧義的選項
.TP
.BI \- 行數（一個整數）
顯示上下文
.I 行數
(一個整數).
這個選項自身沒有指定輸出格式，這是沒有效果的，除非和
.B \-c
或者
.BR \-u 
組合使用.
這是已廢置的選項，對於正確的操作,
上下文至少要有兩行。
.TP
.B \-a
所有的檔案都視為文字檔案來逐行比較，甚至他們似乎不是文字檔案.
.TP
.B \-b
忽略空格引起的變化.
.TP
.B \-B
忽略插入刪除空行引起的變化.
.TP
.B \-\-brief
僅報告檔案是否相異,在乎差別的細節.
.TP
.B \-c
使用上下文輸出格式.
.TP
.BI "\-C " 行數（一個整數）
.br
.ns
.TP
.BI \-\-context[= lines ]
使用上下文輸出格式，顯示以指定
.I 行數
(一個整數), 或者是三行（當
.I 行數
沒有給出時.
對於正確的操作,
上下文至少要有兩行.
.TP
.BI \-\-changed\-group\-format= format
使用
.I format
輸出一組包含兩個檔案的不同處的行，其格式是 if\-then\-else .
.TP
.B \-d
改變演算法也許發現變化的一個更小的集合.這會使
.I diff
變慢 (有時更慢).
.TP
.BI "\-D " name
合併 if\-then\-else 格式輸出, 預處理宏（由name引數提供）條件.
.TP
.B \-e
.br
.ns
.TP
.B \-\-ed
輸出為一個有效的
.I ed
指令碼.
.TP
.BI \-\-exclude= pattern
比較目錄的時候，忽略和目錄中與
.IR pattern （樣式）
相配的.
.TP
.BI \-\-exclude\-from= file
比較目錄的時候，忽略和目錄中與任何包含在
.IR file （檔案）
的樣式相配的檔案和目錄.
.TP
.B \-\-expand\-tabs
在輸出時擴充套件tab為空格，保護輸入檔案的tab對齊方式
.TP
.B \-f
產生一個很象
.I ed
指令碼的輸出，但是但是在他們在檔案出現的順序有改變
.TP
.BI "\-F " regexp
在上下文和統一格式中，對於每一大塊的不同，顯示出匹配
.IR regexp .
的一些前面的行.
.TP
.B \-\-forward\-ed
產生象
.B ed
指令碼的輸出，但是它們在檔案出現的順序有改變。
.TP
.B \-h
這選項現在已沒作用，它呈現Unix的相容性.
.TP
.B \-H
使用啟發規則加速操作那些有許多離散的小差異的大檔案.
.TP
.BI \-\-horizon\-lines= lines
比較給定行數的有共同字首的最後行，和有共同或綴的最前行.
.TP
.B \-i
忽略大小寫.
.TP
.BI "\-I " regexp
忽略由插入，刪除行（由regexp 引數提供參考）帶來的改變.
.TP
.BI \-\-ifdef= name
合併 if\-then\-else 格式輸出, 預處理宏（由name引數提供）條件.
.TP
.B \-\-ignore\-all\-space
在比較行的時候忽略空白.
.TP
.B \-\-ignore\-blank\-lines
忽略插入和刪除空行
.TP
.B \-\-ignore\-case
忽略大小寫.
.TP
.BI \-\-ignore\-matching\-lines= regexp
忽略插入刪除行（由regexp 引數提供參考）.
.TP
.B \-\-ignore\-space\-change
忽略空白的數量.
.TP
.B \-\-initial\-tab
在文字行（無論是常規的或者格式化的前後文關係）前輸出tab代替空格.
引起的原因是tab對齊方式看上去象是常規的一樣.
.TP
.B \-l
產生透過
.I pr
編碼的輸出.
.TP
.BI "\-L " label
.br
.ns
.TP
.BI \-\-label= label
使用
.I label
給出的字元在檔案頭代替檔名輸出.
.TP
.B \-\-left\-column
以並列方式印出兩公共行的左邊
.TP
.BI \-\-line\-format= format
使用
.I format
輸出所有的行，在
if\-then\-else 格式中.
.TP
.B \-\-minimal
改變演算法也許發現變化的一個更小的集合.這會使
.I diff
變慢 (有時更慢).
.TP
.B \-n
輸出 RC\-格式 diffs; 
除了每條指令指定的行數受影響外 象
.B \-f
一樣。
.TP
.B \-N
.br
.ns
.TP
.B \-\-new\-file
在目錄比較中，如果那個檔案只在其中的一個目錄中找到，那麼它被視為在
另一個目錄中是一個空檔案.
.TP
.BI \-\-new\-group\-format= format
使用
.I format
以if\-then\-else 格式輸出只在第二個檔案中取出的一個行組
.TP
.BI \-\-new\-line\-format= format
使用
.I format
以if\-then\-else 格式輸出只在第二個檔案中取出的一行
.TP
.BI \-\-old\-group\-format= format
使用
.I format
以if\-then\-else 格式輸出只在第一個檔案中取出的一個行組
.TP
.BI \-\-old\-line\-format= format
使用
.I format
使用
.I format
以if\-then\-else 格式輸出只在第一個檔案中取出的一行
.TP
.B \-p
顯示帶有c函式的改變.
.TP
.B \-P
在目錄比較中，如果那個檔案只在其中的一個目錄中找到，那麼它被視為在
另一個目錄中是一個空檔案.
.TP
.B \-\-paginate
產生透過
.I pr
編碼的輸出.
.TP
.B \-q
僅報告檔案是否相異,不報告詳細的差異.
.TP
.B \-r
當比較目錄時，遞迴比較任何找到的子目錄.
.TP
.B \-\-rcs
輸出 RC\-格式 diffs; 
除了每條指令指定的行數受影響外 象
.B \-f
一樣。
.TP
.B \-\-recursive
當比較目錄時，遞迴比較任何找到的子目錄.
.TP
.B \-\-report\-identical\-files
.br
.ns
.TP
.B \-s
報告兩個檔案相同.
.TP
.BI "\-S " file
當比較目錄時，由
.IR file 
開始.
這用於繼續中斷了的比較.
.TP
.B \-\-sdiff\-merge\-assist
列印附加的資訊去幫助
.IR sdiff .
.I sdiff
在執行
.IR diff 
時使用這些選項.
這些選項不是特意為使用者直接使用而準備的。
.TP
.B \-\-show\-c\-function
顯示帶有c函式的改變.
.TP
.BI \-\-show\-function\-line= regexp
在上下文和統一的格式，對於每一大塊的差別，顯示出匹配
.IR regexp .
的一些前面的行

.TP
.B \-\-side\-by\-side
使用並列的輸出格式.
.TP
.B \-\-speed\-large\-files
使用啟發規則加速操作那些有許多離散的小差異的大檔案.
.TP
.BI \-\-starting\-file= file
當比較目錄時，由
.IR file 
開始.
這用於繼續中斷了的比較.
.TP
.B \-\-suppress\-common\-lines
在並列格式中不印出公共行。
.TP
.B \-t
在輸出時擴充套件tab為空格，保護輸入檔案的tab對齊方式
.TP
.B \-T
在文字行（無論是常規的或者格式化的前後文關係）前輸出tab代替空格.引起的原因
是tab對齊方式看上去象是常規的一樣.
.TP
.B \-\-text
所有的檔案都視為文字檔案來逐行比較，甚至他們似乎不是文字檔案.
.TP
.B \-u
使用統一的輸出格式.
.TP
.BI \-\-unchanged\-group\-format= format
使用
.I format
輸出兩個檔案的公共行組，其格式是if\-then\-else.
.TP
.BI \-\-unchanged\-line\-format= format
使用
.I format
輸出兩個檔案的公共行，其格式是if\-then\-else.
.TP
.B \-\-unidirectional\-new\-file
在目錄比較中，如果那個檔案只在其中的一個目錄中找到，那麼它被視為在
另一個目錄中是一個空檔案.
.TP
.BI "\-U " lines
.br
.ns
.TP
.BI \-\-unified[= lines ]
使用前後關係格式輸出，顯示以指定
.I 行數
(一個整數), 或者是三行（當
.I 行數
沒有給出時.
對於正確的操作,
上下文至少要有兩行.
.TP
.B \-v
.br
.ns
.TP
.B \-\-version
輸出
.IR diff 
版本號.
.TP
.B \-w
在比較行時忽略空格
.TP
.BI "\-W " columns
.br
.ns
.TP
.BI \-\-width= columns
在並列格式輸出時，使用指定的列寬.
.TP
.BI "\-x " pattern
比較目錄的時候，忽略和目錄中與
.IR pattern （樣式）
相配的.
.TP
.BI "\-X " file
比較目錄的時候，忽略和目錄中與任何包含在
.IR file （檔案）
的樣式相配的檔案和目錄.
.TP
.B \-y
使用並列格式輸出
.SH 參考
cmp(1), comm(1), diff3(1), ed(1), patch(1), pr(1), sdiff(1).
.SH DIAGNOSTICS
退出狀態為0意味著沒有差別，
1意味著有一些不同。
2意味很有問題（許多差異）
.br

.SH "[中文版維護人]"
.B Scorpio <rawk@chinese.com>
.SH "[中文版最新更新]"
.BR 2000/10/19
.SH "《中國Linux論壇man手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR