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