rcsdiff.1 revision 9 
1.de Id
2.ds Rv \\$3
3.ds Dt \\$4
4..
5.Id $Id: rcsdiff.1,v 5.3 1991/04/21 12:00:46 eggert Exp $
6.ds r \&\s-1RCS\s0
7.if n .ds - \%--
8.if t .ds - \(em
9.TH RCSDIFF 1 \*(Dt GNU
10.SH NAME
11rcsdiff \- compare RCS revisions
12.SH SYNOPSIS
13.B rcsdiff
14[
15.BI \-k subst
16] [
17.B \-q
18] [
19.BI \-r rev1
20[
21.BI \-r rev2
22] ] [
23.BI \-V n
24] [
25.BI \-x suffixes
26] [
27.I "diff options"
28]
29.I "file .\|.\|."
30.SH DESCRIPTION
31.B rcsdiff
32runs
33.BR diff (1)
34to compare two revisions of each \*r file given.
35.PP
36Pathnames matching an \*r suffix denote \*r files;
37all others denote working files.
38Names are paired as explained in
39.BR ci (1).
40.PP
41The option
42.B \-q
43suppresses diagnostic output.
44Zero, one, or two revisions may be specified with
45.BR \-r .
46The option
47.BI \-k subst
48affects keyword substitution when extracting
49revisions, as described in
50.BR co (1);
51for example,
52.B "\-kk\ \-r1.1\ \-r1.2"
53ignores differences in keyword values when comparing revisions
54.B 1.1
55and
56.BR 1.2 .
57To avoid excess output from locker name substitution,
58.B \-kkvl
59is assumed if (1) at most one revision option is given,
60(2) no
61.B \-k
62option is given, (3)
63.B \-kkv
64is the default keyword substitution, and
65(4) the working file's mode would be produced by
66.BR "co\ \-l".
67See
68.BR co (1)
69for details
70about
71.B \-V
72and
73.BR \-x .
74Otherwise, all options of
75.BR diff (1)
76that apply to regular files are accepted, with the same meaning as for
77.BR diff .
78.PP
79If both
80.I rev1
81and
82.I rev2
83are omitted,
84.B rcsdiff
85compares the latest revision on the
86default branch (by default the trunk)
87with the contents of the corresponding working file.  This is useful
88for determining what you changed since the last checkin.
89.PP
90If
91.I rev1
92is given, but
93.I rev2
94is omitted,
95.B rcsdiff
96compares revision
97.I rev1
98of the \*r file with
99the contents of the corresponding working file.
100.PP
101If both
102.I rev1
103and
104.I rev2
105are given,
106.B rcsdiff
107compares revisions
108.I rev1
109and
110.I rev2
111of the \*r file.
112.PP
113Both
114.I rev1
115and
116.I rev2
117may be given numerically or symbolically.
118.SH EXAMPLE
119The command
120.LP
121.B "        rcsdiff  f.c"
122.LP
123compares the latest revision on the default branch of the \*r file
124to the contents of the working file
125.BR f.c .
126.SH ENVIRONMENT
127.TP
128.B \s-1RCSINIT\s0
129options prepended to the argument list, separated by spaces.
130See
131.BR ci (1)
132for details.
133.SH DIAGNOSTICS
134Exit status is 0 for no differences during any comparison,
1351 for some differences, 2 for trouble.
136.SH IDENTIFICATION
137Author: Walter F. Tichy.
138.br
139Revision Number: \*(Rv; Release Date: \*(Dt.
140.br
141Copyright \(co 1982, 1988, 1989 by Walter F. Tichy.
142.br
143Copyright \(co 1990, 1991 by Paul Eggert.
144.SH "SEE ALSO"
145ci(1), co(1), diff(1), ident(1), rcs(1), rcsintro(1), rcsmerge(1), rlog(1)
146.br
147Walter F. Tichy,
148\*r\*-A System for Version Control,
149.I "Software\*-Practice & Experience"
150.BR 15 ,
1517 (July 1985), 637-654.
152.br
153