DIFF
Section: GNU Tools (1)
Updated: 22sep1993
Index
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 <rawk@chinese.com>
[中文版最新更新]
2000/10/19
《中国Linux论坛man手册页翻译计划》:
http://cmpp.linuxforum.net
Index
- NAME
-
- 总览
-
- 描述
-
- 选项
-
- 参考
-
- DIAGNOSTICS
-
- [中文版维护人]
-
- [中文版最新更新]
-
- 《中国Linux论坛man手册页翻译计划》:
-
This document was created by
man2html,
using the manual pages.
Time: GMT, January 14, 2004