.po 1i
.TH SDIFF 1 Bell
.V 08/15/84 17:03:32
.\" @[$]sdiff.1	1.7 08/15/84 17:03:32 - Zilog Inc.
.ad
.fi
.SH NAME
sdiff \- side-by-side difference program
.SH SYNOPSIS
.B sdiff
[ \fB-losw\fR \.\.\. ]
\fIfile1 file2\fR
.SH DESCRIPTION
.B Sdiff\^
uses the output of
.BR diff (1)
to produce a side-by-side listing of two files indicating
those lines that are different.
Each line of the two files is printed with a blank gutter
between them if the lines are identical, a "<" in the gutter
if the line only exists in
.IR file1 ,
a ">" in the gutter if the line only exists in
.IR file2 ,
and a "|" for lines that are different.
.PP
For example:
.PP
.RS 11
.nf
	x	|	y
	a		a
	b	<
	c	<
	d		d
		>	c
.fi
.RE
.PP
.SH OPTIONS
.TP
.B \-l
Only print the left side of any lines that are identical.
.TP
.BI \-o "  output\^"
Use the next argument,
.IR output ,
as the name of a third file that is created as a user
controlled merging of 
.I file1\^
and
.IR file2 .
Identical lines of
.I file1\^
and
.I file2\^
are copied to 
.IR output .
Sets of differences, as produced by
.BR diff (1),
are printed where a set of differences share a common gutter character.
After printing each set of differences,
.B sdiff\^
prompts the user with a "%"
and waits for one of the following user-typed commands:
.RS 10
.TP
.B e
call the editor
.B ed(1)
with a zero length file
.TP
.B "e  b"
call the editor
.B ed(1)
with both (the concatenation of) left and right
.TP
.B "e  l"
call the editor
.B ed(1)
with the left column
.TP
.B "e  r"
call the editor
.B ed(1)
with the right column
.TP
.B l
append the left column to the output file
.TP
.B q
exit from the program
.TP
.B r
append the right column to the output file
.TP
.B s
turn on silent mode; do not print identical lines
.TP
.B v
verbose; turn off silent mode
.RE
.IP
On exit from the editor
.B ed(1),
the resulting file is concatenated to the end of the
.I output\^
file.
.TP
.B \-s
Do not print identical lines.
.TP
.BI \-w "  n\^"
Use the next argument,
.IR n ,
as the width of the output line.
The default line length is 130 characters.
.SH EXAMPLES
.nf
% cat list1

boat
boathouse
boatload
boatman
boatmen
boatyard

% cat list2

boa
boar
board
boardinghouse
boast
boat
boathouse
boatload
boatman
boatmen

% sdiff list1 list2
                                  >  boa
                                  >  boar
                                  >  board
                                  >  boardinghouse
                                  >  boast
boat                                 boat
boathouse                            boathouse
boatload                             boatload
boatman                              boatman
boatmen                              boatmen
boatyard                          <  

% sdiff -s list1 list2

0a1,5
                                  >  boa
                                  >  boar
                                  >  board
                                  >  boardinghouse
                                  >  boast
6d10
boatyard                          <  

% sdiff -l list1 list2

                                  >  boa
                                  >  boar
                                  >  board
                                  >  boardinghouse
                                  >  boast
boat
boathouse
boatload
boatman
boatmen
boatyard                          <  

% 
.fi
.SH SEE ALSO
diff(1), ed(1).