[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    diff3(1) manual page Table of Contents

Name

diff3 - 3-way differential file comparison

Synopsis

diff3 [ -exEX3 ] filename1 filename2 filename3

Availability

SUNWesu

Description

diff3 compares three versions of a file, and publishes disagreeing ranges of text flagged with these codes:
====
all three files differ
====1
filename1 is different
====2
filename2 is different
====3
filename3 is different

The type of change suffered in converting a given range of a given file to some other is indicated in one of these ways:

f : n1 a
Text is to be appended after line number n1 in file f, where f = 1, 2, or 3.
f : n1 , n2 c
Text is to be changed in the range line n1 to line n2. If n1 = n2, the range may be abbreviated to n1.

The original contents of the range follows immediately after a c indication. When the contents of two files are identical, the contents of the lower-numbered file is suppressed.

The following command will apply the resulting script to filename1.

   (cat script; echo fm1,$pfm) | ed - filename1

Options

-e
Produce a script for the editor ed(1) that will incorporate into filename1 all changes between filename2 and filename3, i.e., the changes that normally would be flagged ==== and ====3.
-x
Produce a script to incorporate only changes flagged ====.
-3
Produce a script to incorporate only changes flagged ====3.
-E
Produce a script that will incorporate all changes between filename2 and filename3, but treat overlapping changes (that is, changes that would be flagged with ==== in the normal listing) differently. The overlapping lines from both files will be inserted by the edit script, bracketed by <<<<<< and >>>>>> lines.
-X
Produce a script that will incorporate only changes flagged ====, but treat these changes in the manner of the -E option.

Files

/tmp/d3*
/usr/lib/diff3prog

See Also

diff(1)

Notes

Text lines that consist of a single ‘.’ will defeat -e.

Files longer than 64 Kbytes will not work.


Table of Contents