DIFF(1) GNU Tools DIFF(1)
NAME
diff - 找出两个文件的不同点
总览
diff [选项] 源文件 目标文件
描述
在 最简单的情况是, diff 比较两个文件的内容 (源文件和 目标文件). 文件
名可以是 - 由标准输入设备读入的文本. 作为特别的情况是, diff - - 比较一
份 标 准输入的它自己的拷贝如果 源文件是一个目录和 目标文件不是(目录),
diff 会比较在 源文件(目录)里的文件的中和 目标文件同名的(文件), 反过
来也一样. 非目录文件不能是 -.
如果 源文件和 目标文件都是目录, diff 比较两个目录中相应的文件,依照字母
次序排序;这个比较是不会递归的,除非给出 -r 或者 --recursive. diff 不
把 一 个目录的内容看为它是一个文件来比较。被指定的文件不能是标准的输入,
因为标准的输入是无名的并且"有一样的名字的文件"的观点不适用。 diff 的
选 项由 -, 开始所以正常地 源文件(名)和 目标文件(名)不可以用 - 开头.
然而, -- 可以被它视为保留的即使作为文件名的开头( they begin with -.)
选项
下面是 GNU所接受的 diff 的所有选项的概要. 大多数的选项有两个相同 的 名
字,一个是单个的跟在 - 后面字母, 另一个是由 -- 引出的长名字. 多个单字母
选项(除非它们产生歧义)能够组合为单行的命令行语法 -ac 是等同于 -a -c.
长命名的选项能被缩短到他们的名字的任何唯一的前缀. 用 ([ 和 ]) 括起来显
示选项产生歧义的选项
-行数(一个整数)
显示上下文 行数 (一个整数). 这个选项自身没有指定输出格式,这 是
没 有效果的,除非和 -c 或者 -u 组合使用. 这是已废置的选项,对于
正确的操作, 上下文至少要有两行。
-a 所有的文件都视为文本文件来逐行比较,甚至他们似乎不是文本文件.
-b 忽略空格引起的变化.
-B 忽略插入删除空行引起的变化.
--brief
仅报告文件是否相异,在乎差别的细节.
-c 使用上下文输出格式.
-C 行数(一个整数)
--context[=lines]
使用上下文输出格式,显示以指定 行数 (一个整数), 或者是三行(当
行数没有给出时. 对于正确的操作, 上下文至少要有两行.
--changed-group-format=format
使 用 format 输 出 一 组 包 含 两个文件的不同处的行,其格式是
if-then-else .
-d 改变算法也许发现变化的一个更小的集合.这会使 diff 变慢 ( 有 时 更
慢).
-D name
合并 if-then-else 格式输出, 预处理宏(由name参数提供)条件.
-e
--ed 输出为一个有效的 ed 脚本.
--exclude=pattern
比较目录的时候,忽略和目录中与 pattern(样式)相配的.
--exclude-from=file
比 较目录的时候,忽略和目录中与任何包含在 file(文件)的样式相配
的文件和目录.
--expand-tabs
在输出时扩展tab为空格,保护输入文件的tab对齐方式
-f 产生一个很象 ed 脚本的输出,但是但是在他们在文件出现的顺序有改变
-F regexp
在上下文和统一格式中,对于每一大块的不同,显示出匹配 regexp. 的
一些前面的行.
--forward-ed
产生象 ed 脚本的输出,但是它们在文件出现的顺序有改变。
-h 这选项现在已没作用,它呈现Unix的兼容性.
-H 使用启发规则加速操作那些有许多离散的小差异的大文件.
--horizon-lines=lines
比较给定行数的有共同前缀的最后行,和有共同或缀的最前行.
-i 忽略大小写.
-I regexp
忽略由插入,删除行(由regexp 参数提供参考)带来的改变.
--ifdef=name
合并 if-then-else 格式输出, 预处理宏(由name参数提供)条件.
--ignore-all-space
在比较行的时候忽略空白.
--ignore-blank-lines
忽略插入和删除空行
--ignore-case
忽略大小写.
--ignore-matching-lines=regexp
忽略插入删除行(由regexp 参数提供参考).
--ignore-space-change
忽略空白的数量.
--initial-tab
在文本行(无论是常规的或者格式化的前后文关系)前输出tab代替空格.
引起的原因是tab对齐方式看上去象是常规的一样.
-l 产生通过 pr 编码的输出.
-L label
--label=label
使用 label 给出的字符在文件头代替文件名输出.
--left-column
以并列方式印出两公共行的左边
--line-format=format
使用 format 输出所有的行,在 if-then-else 格式中.
--minimal
改 变 算 法也许发现变化的一个更小的集合.这会使 diff 变慢 (有时更
慢).
-n 输出 RC-格式 diffs; 除了每条指令指定的行数受影响外 象 -f 一样。
-N
--new-file
在目录比较中,如果那个文件只在其中的一个目录中找到,那么它被视为
在另一个目录中是一个空文件.
--new-group-format=format
使 用 format 以if-then-else 格式输出只在第二个文件中取出的一个行
组
--new-line-format=format
使用 format 以if-then-else 格式输出只在第二个文件中取出的一行
--old-group-format=format
使用 format 以if-then-else 格式输出只在第一个文件中取出的一个 行
组
--old-line-format=format
使 用 format 使用 format 以if-then-else 格式输出只在第一个文件中
取出的一行
-p 显示带有c函数的改变.
-P 在目录比较中,如果那个文件只在其中的一个目录中找到,那么它被视为
在另一个目录中是一个空文件.
--paginate
产生通过 pr 编码的输出.
-q 仅报告文件是否相异,不报告详细的差异.
-r 当比较目录时,递归比较任何找到的子目录.
--rcs 输出 RC-格式 diffs; 除了每条指令指定的行数受影响外 象 -f 一样。
--recursive
当比较目录时,递归比较任何找到的子目录.
--report-identical-files
-s 报告两个文件相同.
-S file
当比较目录时,由 file 开始. 这用于继续中断了的比较.
--sdiff-merge-assist
打 印 附加的信息去帮助 sdiff. sdiff 在运行 diff 时使用这些选项.
这些选项不是特意为使用者直接使用而准备的。
--show-c-function
显示带有c函数的改变.
--show-function-line=regexp
在上下文和统一的格式,对于每一大块的差别,显示出匹配 regexp. 的
一些前面的行
--side-by-side
使用并列的输出格式.
--speed-large-files
使用启发规则加速操作那些有许多离散的小差异的大文件.
--starting-file=file
当比较目录时,由 file 开始. 这用于继续中断了的比较.
--suppress-common-lines
在并列格式中不印出公共行。
-t 在输出时扩展tab为空格,保护输入文件的tab对齐方式
-T 在文本行(无论是常规的或者格式化的前后文关系)前输出tab代替空格.
引起的原因是tab对齐方式看上去象是常规的一样.
--text 所有的文件都视为文本文件来逐行比较,甚至他们似乎不是文本文件.
-u 使用统一的输出格式.
--unchanged-group-format=format
使用 format 输出两个文件的公共行组,其格式是if-then-else.
--unchanged-line-format=format
使用 format 输出两个文件的公共行,其格式是if-then-else.
--unidirectional-new-file
在目录比较中,如果那个文件只在其中的一个目录中找到,那么它被视为
在另一个目录中是一个空文件.
-U lines
--unified[=lines]
使用前后关系格式输出,显示以指定 行数 (一个整数), 或者是三行(当
行数没有给出时. 对于正确的操作, 上下文至少要有两行.
-v
--version
输出 diff 版本号.
-w 在比较行时忽略空格
-W columns
--width=columns
在并列格式输出时,使用指定的列宽.
-x pattern
比较目录的时候,忽略和目录中与 pattern(样式)相配的.
-X file
比较目录的时候,忽略和目录中与任何包含在 file(文件)的样式相 配
的文件和目录.
-y 使用并列格式输出
参考
cmp(1), comm(1), diff3(1), ed(1), patch(1), pr(1), sdiff(1).
DIAGNOSTICS
退出状态为0意味着没有差别, 1意味着有一些不同。 2意味很有问题(许多差异
)
[中文版维护人]
Scorpio <[email protected]>
[中文版最新更新]
2000/10/19
《中国Linux论坛man手册页翻译计划》:
http://cmpp.linuxforum.net
GNU Tools 22sep1993 DIFF(1)