Man page - diff(1)

Packages contains this manual

Package: diffutils
apt-get install diffutils

Manuals in package:

Documentations in package:

diffutils

Available languages:

en fr es pl vi nb ko nl da cs tr hu sv ja uk id fi ru ro zh_TW sr el zh_CN de

Manual

DIFF

NAME
总览
描述
选项
参考
DIAGNOSTICS
[中文版维护人 ]
[中文版最新更新 ]
《中国 Linux论坛 man手册页翻译计划》 :
跋

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

跋

本页面中文版由中文 man 手册页计划提供。
中文 man 手册页计划： https://github.com/man-pages-zh/manpages-zh