|
Packit |
33f14e |
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.40.4.
|
|
Packit |
33f14e |
.TH DIFF "1" "May 2017" "diffutils 3.6" "User Commands"
|
|
Packit |
33f14e |
.SH NAME
|
|
Packit |
33f14e |
diff \- compare files line by line
|
|
Packit |
33f14e |
.SH SYNOPSIS
|
|
Packit |
33f14e |
.B diff
|
|
Packit |
33f14e |
[\fIOPTION\fR]... \fIFILES\fR
|
|
Packit |
33f14e |
.SH DESCRIPTION
|
|
Packit |
33f14e |
Compare FILES line by line.
|
|
Packit |
33f14e |
.PP
|
|
Packit |
33f14e |
Mandatory arguments to long options are mandatory for short options too.
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-normal\fR
|
|
Packit |
33f14e |
output a normal diff (the default)
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-q\fR, \fB\-\-brief\fR
|
|
Packit |
33f14e |
report only when files differ
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-s\fR, \fB\-\-report\-identical\-files\fR
|
|
Packit |
33f14e |
report when two files are the same
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-c\fR, \fB\-C\fR NUM, \fB\-\-context\fR[=\fINUM\fR]
|
|
Packit |
33f14e |
output NUM (default 3) lines of copied context
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-u\fR, \fB\-U\fR NUM, \fB\-\-unified\fR[=\fINUM\fR]
|
|
Packit |
33f14e |
output NUM (default 3) lines of unified context
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-e\fR, \fB\-\-ed\fR
|
|
Packit |
33f14e |
output an ed script
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-n\fR, \fB\-\-rcs\fR
|
|
Packit |
33f14e |
output an RCS format diff
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-y\fR, \fB\-\-side\-by\-side\fR
|
|
Packit |
33f14e |
output in two columns
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-W\fR, \fB\-\-width\fR=\fINUM\fR
|
|
Packit |
33f14e |
output at most NUM (default 130) print columns
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-left\-column\fR
|
|
Packit |
33f14e |
output only the left column of common lines
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-suppress\-common\-lines\fR
|
|
Packit |
33f14e |
do not output common lines
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-p\fR, \fB\-\-show\-c\-function\fR
|
|
Packit |
33f14e |
show which C function each change is in
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-F\fR, \fB\-\-show\-function\-line\fR=\fIRE\fR
|
|
Packit |
33f14e |
show the most recent line matching RE
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-label\fR LABEL
|
|
Packit |
33f14e |
use LABEL instead of file name and timestamp
|
|
Packit |
33f14e |
(can be repeated)
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-t\fR, \fB\-\-expand\-tabs\fR
|
|
Packit |
33f14e |
expand tabs to spaces in output
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-T\fR, \fB\-\-initial\-tab\fR
|
|
Packit |
33f14e |
make tabs line up by prepending a tab
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-tabsize\fR=\fINUM\fR
|
|
Packit |
33f14e |
tab stops every NUM (default 8) print columns
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-suppress\-blank\-empty\fR
|
|
Packit |
33f14e |
suppress space or tab before empty output lines
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-l\fR, \fB\-\-paginate\fR
|
|
Packit |
33f14e |
pass output through 'pr' to paginate it
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-r\fR, \fB\-\-recursive\fR
|
|
Packit |
33f14e |
recursively compare any subdirectories found
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-no\-dereference\fR
|
|
Packit |
33f14e |
don't follow symbolic links
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-N\fR, \fB\-\-new\-file\fR
|
|
Packit |
33f14e |
treat absent files as empty
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-unidirectional\-new\-file\fR
|
|
Packit |
33f14e |
treat absent first files as empty
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-ignore\-file\-name\-case\fR
|
|
Packit |
33f14e |
ignore case when comparing file names
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-no\-ignore\-file\-name\-case\fR
|
|
Packit |
33f14e |
consider case when comparing file names
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-x\fR, \fB\-\-exclude\fR=\fIPAT\fR
|
|
Packit |
33f14e |
exclude files that match PAT
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-X\fR, \fB\-\-exclude\-from\fR=\fIFILE\fR
|
|
Packit |
33f14e |
exclude files that match any pattern in FILE
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-S\fR, \fB\-\-starting\-file\fR=\fIFILE\fR
|
|
Packit |
33f14e |
start with FILE when comparing directories
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-from\-file\fR=\fIFILE1\fR
|
|
Packit |
33f14e |
compare FILE1 to all operands;
|
|
Packit |
33f14e |
FILE1 can be a directory
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-to\-file\fR=\fIFILE2\fR
|
|
Packit |
33f14e |
compare all operands to FILE2;
|
|
Packit |
33f14e |
FILE2 can be a directory
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-i\fR, \fB\-\-ignore\-case\fR
|
|
Packit |
33f14e |
ignore case differences in file contents
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-E\fR, \fB\-\-ignore\-tab\-expansion\fR
|
|
Packit |
33f14e |
ignore changes due to tab expansion
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-Z\fR, \fB\-\-ignore\-trailing\-space\fR
|
|
Packit |
33f14e |
ignore white space at line end
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-b\fR, \fB\-\-ignore\-space\-change\fR
|
|
Packit |
33f14e |
ignore changes in the amount of white space
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-w\fR, \fB\-\-ignore\-all\-space\fR
|
|
Packit |
33f14e |
ignore all white space
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-B\fR, \fB\-\-ignore\-blank\-lines\fR
|
|
Packit |
33f14e |
ignore changes where lines are all blank
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-I\fR, \fB\-\-ignore\-matching\-lines\fR=\fIRE\fR
|
|
Packit |
33f14e |
ignore changes where all lines match RE
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-a\fR, \fB\-\-text\fR
|
|
Packit |
33f14e |
treat all files as text
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-strip\-trailing\-cr\fR
|
|
Packit |
33f14e |
strip trailing carriage return on input
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-D\fR, \fB\-\-ifdef\fR=\fINAME\fR
|
|
Packit |
33f14e |
output merged file with '#ifdef NAME' diffs
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-GTYPE\-group\-format\fR=\fIGFMT\fR
|
|
Packit |
33f14e |
format GTYPE input groups with GFMT
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-line\-format\fR=\fILFMT\fR
|
|
Packit |
33f14e |
format all input lines with LFMT
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-LTYPE\-line\-format\fR=\fILFMT\fR
|
|
Packit |
33f14e |
format LTYPE input lines with LFMT
|
|
Packit |
33f14e |
.IP
|
|
Packit |
33f14e |
These format options provide fine\-grained control over the output
|
|
Packit |
33f14e |
.IP
|
|
Packit |
33f14e |
of diff, generalizing \fB\-D\fR/\-\-ifdef.
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
LTYPE is 'old', 'new', or 'unchanged'.
|
|
Packit |
33f14e |
GTYPE is LTYPE or 'changed'.
|
|
Packit |
33f14e |
.IP
|
|
Packit |
33f14e |
GFMT (only) may contain:
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%<
|
|
Packit |
33f14e |
lines from FILE1
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%>
|
|
Packit |
33f14e |
lines from FILE2
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%=
|
|
Packit |
33f14e |
lines common to FILE1 and FILE2
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%[\-][WIDTH][.[PREC]]{doxX}LETTER
|
|
Packit |
33f14e |
printf\-style spec for LETTER
|
|
Packit |
33f14e |
.IP
|
|
Packit |
33f14e |
LETTERs are as follows for new group, lower case for old group:
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
F
|
|
Packit |
33f14e |
first line number
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
L
|
|
Packit |
33f14e |
last line number
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
N
|
|
Packit |
33f14e |
number of lines = L\-F+1
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
E
|
|
Packit |
33f14e |
F\-1
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
M
|
|
Packit |
33f14e |
L+1
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%(A=B?T:E)
|
|
Packit |
33f14e |
if A equals B then T else E
|
|
Packit |
33f14e |
.IP
|
|
Packit |
33f14e |
LFMT (only) may contain:
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%L
|
|
Packit |
33f14e |
contents of line
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%l
|
|
Packit |
33f14e |
contents of line, excluding any trailing newline
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%[\-][WIDTH][.[PREC]]{doxX}n
|
|
Packit |
33f14e |
printf\-style spec for input line number
|
|
Packit |
33f14e |
.IP
|
|
Packit |
33f14e |
Both GFMT and LFMT may contain:
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%%
|
|
Packit |
33f14e |
%
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%c'C'
|
|
Packit |
33f14e |
the single character C
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
%c'\eOOO'
|
|
Packit |
33f14e |
the character with octal code OOO
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
C
|
|
Packit |
33f14e |
the character C (other characters represent themselves)
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-d\fR, \fB\-\-minimal\fR
|
|
Packit |
33f14e |
try hard to find a smaller set of changes
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-horizon\-lines\fR=\fINUM\fR
|
|
Packit |
33f14e |
keep NUM lines of the common prefix and suffix
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-speed\-large\-files\fR
|
|
Packit |
33f14e |
assume large files and many scattered small changes
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-color\fR[=\fIWHEN\fR]
|
|
Packit |
33f14e |
colorize the output; WHEN can be 'never', 'always',
|
|
Packit |
33f14e |
or 'auto' (the default)
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-palette\fR=\fIPALETTE\fR
|
|
Packit |
33f14e |
the colors to use when \fB\-\-color\fR is active; PALETTE is
|
|
Packit |
33f14e |
a colon\-separated list of terminfo capabilities
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-\-help\fR
|
|
Packit |
33f14e |
display this help and exit
|
|
Packit |
33f14e |
.TP
|
|
Packit |
33f14e |
\fB\-v\fR, \fB\-\-version\fR
|
|
Packit |
33f14e |
output version information and exit
|
|
Packit |
33f14e |
.PP
|
|
Packit |
33f14e |
FILES are 'FILE1 FILE2' or 'DIR1 DIR2' or 'DIR FILE' or 'FILE DIR'.
|
|
Packit |
33f14e |
If \fB\-\-from\-file\fR or \fB\-\-to\-file\fR is given, there are no restrictions on FILE(s).
|
|
Packit |
33f14e |
If a FILE is '\-', read standard input.
|
|
Packit |
33f14e |
Exit status is 0 if inputs are the same, 1 if different, 2 if trouble.
|
|
Packit |
33f14e |
.SH AUTHOR
|
|
Packit |
33f14e |
Written by Paul Eggert, Mike Haertel, David Hayes,
|
|
Packit |
33f14e |
Richard Stallman, and Len Tower.
|
|
Packit |
33f14e |
.SH "REPORTING BUGS"
|
|
Packit |
33f14e |
Report bugs to: bug\-diffutils@gnu.org
|
|
Packit |
33f14e |
.br
|
|
Packit |
33f14e |
GNU diffutils home page: <http://www.gnu.org/software/diffutils/>
|
|
Packit |
33f14e |
.br
|
|
Packit |
33f14e |
General help using GNU software: <http://www.gnu.org/gethelp/>
|
|
Packit |
33f14e |
.SH COPYRIGHT
|
|
Packit |
33f14e |
Copyright \(co 2017 Free Software Foundation, Inc.
|
|
Packit |
33f14e |
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
|
|
Packit |
33f14e |
.br
|
|
Packit |
33f14e |
This is free software: you are free to change and redistribute it.
|
|
Packit |
33f14e |
There is NO WARRANTY, to the extent permitted by law.
|
|
Packit |
33f14e |
.SH "SEE ALSO"
|
|
Packit |
33f14e |
wdiff(1), cmp(1), diff3(1), sdiff(1), patch(1)
|
|
Packit |
33f14e |
.PP
|
|
Packit |
33f14e |
The full documentation for
|
|
Packit |
33f14e |
.B diff
|
|
Packit |
33f14e |
is maintained as a Texinfo manual. If the
|
|
Packit |
33f14e |
.B info
|
|
Packit |
33f14e |
and
|
|
Packit |
33f14e |
.B diff
|
|
Packit |
33f14e |
programs are properly installed at your site, the command
|
|
Packit |
33f14e |
.IP
|
|
Packit |
33f14e |
.B info diff
|
|
Packit |
33f14e |
.PP
|
|
Packit |
33f14e |
should give you access to the complete manual.
|