Contents | < Browse | Browse >
Options to `diff'
=================
Below is a summary of all of the options that GNU `diff' accepts.
Most options have two equivalent names, one of which is a single letter
preceded by `-', and the other of which is a long name preceded by
`--'. Multiple single letter options (unless they take an argument)
can be combined into a single command line word: `-ac' is equivalent to
`-a -c'. Long named options can be abbreviated to any unique prefix of
their name. Brackets ([ and ]) indicate that an option takes an
optional argument.
`-LINES'
Show LINES (an integer) lines of context. This option does not
specify an output format by itself; it has no effect unless it is
combined with `-c' (Context Format) or `-u'
(Unified Format). This option is obsolete. For proper
operation, `patch' typically needs at least two lines of context.
`-a'
Treat all files as text and compare them line-by-line, even if they
do not seem to be text. Binary
`-b'
Ignore changes in amount of white space. White Space
`-B'
Ignore changes that just insert or delete blank lines.
Blank Lines
`--brief'
Report only whether the files differ, not the details of the
differences. Brief
`-c'
Use the context output format. Context Format
`-C LINES'
`--context[=LINES]'
Use the context output format, showing LINES (an integer) lines of
context, or three if LINES is not given. Context Format
For proper operation, `patch' typically needs at least two lines of
context.
`--changed-group-format=FORMAT'
Use FORMAT to output a line group containing differing lines from
both files in if-then-else format. Line Group Formats
`-d'
Change the algorithm perhaps find a smaller set of changes. This
makes `diff' slower (sometimes much slower).
diff Performance
`-D NAME'
Make merged `#ifdef' format output, conditional on the preprocessor
macro NAME. If-then-else
`-e'
`--ed'
Make output that is a valid `ed' script. ed Scripts
`--exclude=PATTERN'
When comparing directories, ignore files and subdirectories whose
basenames match PATTERN. Comparing Directories
`--exclude-from=FILE'
When comparing directories, ignore files and subdirectories whose
basenames match any pattern contained in FILE.
Comparing Directories
`--expand-tabs'
Expand tabs to spaces in the output, to preserve the alignment of
tabs in the input files. Tabs
`-f'
Make output that looks vaguely like an `ed' script but has changes
in the order they appear in the file. Forward ed
`-F REGEXP'
In context and unified format, for each hunk of differences, show
some of the last preceding line that matches REGEXP.
Specified Headings
`--forward-ed'
Make output that looks vaguely like an `ed' script but has changes
in the order they appear in the file. Forward ed
`-h'
This option currently has no effect; it is present for Unix
compatibility.
`-H'
Use heuristics to speed handling of large files that have numerous
scattered small changes. diff Performance
`--horizon-lines=LINES'
Do not discard the last LINES lines of the common prefix and the
first LINES lines of the common suffix. diff Performance
`-i'
Ignore changes in case; consider upper- and lower-case letters
equivalent. Case Folding
`-I REGEXP'
Ignore changes that just insert or delete lines that match REGEXP.
Specified Folding
`--ifdef=NAME'
Make merged if-then-else output using FORMAT. If-then-else
`--ignore-all-space'
Ignore white space when comparing lines. White Space
`--ignore-blank-lines'
Ignore changes that just insert or delete blank lines.
Blank Lines
`--ignore-case'
Ignore changes in case; consider upper- and lower-case to be the
same. Case Folding
`--ignore-matching-lines=REGEXP'
Ignore changes that just insert or delete lines that match REGEXP.
Specified Folding
`--ignore-space-change'
Ignore changes in amount of white space. White Space
`--initial-tab'
Output a tab rather than a space before the text of a line in
normal or context format. This causes the alignment of tabs in
the line to look normal. Tabs
`-l'
Pass the output through `pr' to paginate it. Pagination
`-L LABEL'
Use LABEL instead of the file name in the context format
(Context Format) and unified format (Unified Format)
headers. RCS
`--label=LABEL'
Use LABEL instead of the file name in the context format
(Context Format) and unified format (Unified Format)
headers.
`--left-column'
Print only the left column of two common lines in side by side
format. Side by Side Format
`--line-format=FORMAT'
Use FORMAT to output all input lines in if-then-else format.
Line Formats
`--minimal'
Change the algorithm to perhaps find a smaller set of changes.
This makes `diff' slower (sometimes much slower).
diff Performance
`-n'
Output RCS-format diffs; like `-f' except that each command
specifies the number of lines affected. RCS
`-N'
`--new-file'
In directory comparison, if a file is found in only one directory,
treat it as present but empty in the other directory.
Comparing Directories
`--new-group-format=FORMAT'
Use FORMAT to output a group of lines taken from just the second
file in if-then-else format. Line Group Formats
`--new-line-format=FORMAT'
Use FORMAT to output a line taken from just the second file in
if-then-else format. Line Formats
`--old-group-format=FORMAT'
Use FORMAT to output a group of lines taken from just the first
file in if-then-else format. Line Group Formats
`--old-line-format=FORMAT'
Use FORMAT to output a line taken from just the first file in
if-then-else format. Line Formats
`-p'
Show which C function each change is in. C Fuction Headings .
`-P'
When comparing directories, if a file appears only in the second
directory of the two, treat it as present but empty in the other.
Comparing Directories
`--paginate'
Pass the output through `pr' to paginate it. Pagination
`-q'
Report only whether the files differ, not the details of the
differences. Brief
`-r'
When comparing directories, recursively compare any subdirectories
found. Comparing Directories
`--rcs'
Output RCS-format diffs; like `-f' except that each command
specifies the number of lines affected. RCS
`--recursive'
When comparing directories, recursively compare any subdirectories
found. Comparing Directories
`--report-identical-files'
Report when two files are the same. Comparing Directories
`-s'
Report when two files are the same. Comparing Directories
`-S FILE'
When comparing directories, start with the file FILE. This is
used for resuming an aborted comparison.
Comparing Directories
`--sdiff-merge-assist'
Print extra information to help `sdiff'. `sdiff' uses this option
when it runs `diff'. This option is not intended for users to use
directly.
`--show-c-function'
Show which C function each change is in. C Function Headings .
`--show-function-line=REGEXP'
In context and unified format, for each hunk of differences, show
some of the last preceding line that matches REGEXP.
Specified Headings
`--side-by-side'
Use the side by side output format. Side by Side Format
`--speed-large-files'
Use heuristics to speed handling of large files that have numerous
scattered small changes. diff Performance
`--starting-file=FILE'
When comparing directories, start with the file FILE. This is
used for resuming an aborted comparison.
Comparing Directories
`--suppress-common-lines'
Do not print common lines in side by side format.
Side by Side Format
`-t'
Expand tabs to spaces in the output, to preserve the alignment of
tabs in the input files. Tabs
`-T'
Output a tab rather than a space before the text of a line in
normal or context format. This causes the alignment of tabs in
the line to look normal. Tabs
`--text'
Treat all files as text and compare them line-by-line, even if they
do not appear to be text. Binary
`-u'
Use the unified output format. Unified Format
`--unchanged-group-format=FORMAT'
Use FORMAT to output a group of common lines taken from both files
in if-then-else format. Line Group Formats
`--unchanged-line-format=FORMAT'
Use FORMAT to output a line common to both files in if-then-else
format. Line Formats
`--unidirectional-new-file'
When comparing directories, if a file appears only in the second
directory of the two, treat it as present but empty in the other.
Comparing Directories
`-U LINES'
`--unified[=LINES]'
Use the unified output format, showing LINES (an integer) lines of
context, or three if LINES is not given. Unified Format
For proper operation, `patch' typically needs at least two lines of
context.
`-v'
`--version'
Output the version number of `diff'.
`-w'
Ignore white space when comparing lines. White Space
`-W COLUMNS'
`--width=COLUMNS'
Use an output width of COLUMNS in side by side format.
Side by Side Format
`-x PATTERN'
When comparing directories, ignore files and subdirectories whose
basenames match PATTERN. Comparing Directories
`-X FILE'
When comparing directories, ignore files and subdirectories whose
basenames match any pattern contained in FILE.
Comparing Directories
`-y'
Use the side by side output format. Side by Side Format