386BSD 0.1 development
[unix-history] / usr / src / usr.bin / rcs / man / rcsdiff.1
CommitLineData
a688f0c2
WJ
1.TH RCSDIFF 1L "" "Purdue University"
2.SH NAME
3rcsdiff \- compare RCS revisions
4.SH SYNOPSIS
5\fBrcsdiff\fR [ \fB\-biwt\fR ] [ \fB\-cefhn\fR ] [ \fB\-q\fR ] [ \fB\-r\fIrev1\fR ] [ \fB\-r\fIrev2\fR ] file ...
6.SH DESCRIPTION
7.I Rcsdiff
8runs
9.IR diff (1)
10to compare two revisions of each RCS file given.
11A file name ending in ',v' is an RCS file name, otherwise a
12working file name. \fIRcsdiff\fR derives the working file name from the RCS
13file name and vice versa, as explained in
14.IR co (1L).
15Pairs consisting
16of both an RCS and a working file name may also be specified.
17.PP
18The options \fB\-b\fR, \fB\-i\fR, \fB\-w\fR, \fB\-t\fR,
19\fB\-c\fR, \fB\-e\fR, \fB\-f\fR, and \fB\-h\fR,
20have the same effect as described in
21.IR diff (1);
22option
23\fB\-n\fR generates an edit script of the format used by RCS.
24The option \fB\-q\fR suppresses diagnostic output.
25.PP
26If both \fIrev1\fR and \fIrev2\fR
27are omitted, \fIrcsdiff\fR compares the latest revision on the
28default branch (normally the highest branch on the trunk)
29with the contents of the corresponding working file. This is useful
30for determining what you changed since the last checkin.
31.PP
32If \fIrev1\fR is given, but \fIrev2\fR is omitted,
33\fIrcsdiff\fR compares revision \fIrev1\fR of the RCS file with
34the contents of the corresponding working file.
35.PP
36If both \fIrev1\fR and \fIrev2\fR are given,
37\fIrcsdiff\fR compares revisions \fIrev1\fR and \fIrev2\fR of the RCS file.
38.PP
39Both \fIrev1\fR and \fIrev2\fR may be given numerically or symbolically,
40and may actually be attached to any of the options.
41.SH EXAMPLES
42.nf
43The command
44
45.B " rcsdiff f.c
46
47.fi
48runs \fIdiff\fR on the latest revision on the default branch of RCS file f.c,v
49and the contents of working file f.c.
50.SH DIAGNOSTICS
51The exit status is 0 if there were no differences during the last comparison,
521 if there were differences, and 2 if there were errors.
53.SH IDENTIFICATION
54.de VL
55\\$2
56..
57Author: Walter F. Tichy,
58Purdue University, West Lafayette, IN, 47907.
59.sp 0
60Revision Number:
61.VL $Revision: 1.4 $
62; Release Date:
63.VL $Date: 89/08/15 21:16:07 $
64\&.
65.sp 0
66Copyright \(co 1982, 1988, 1989 by Walter F. Tichy.
67.SH SEE ALSO
68ci(1L), co(1L), diff(1), ident(1L), rcs(1L), rcsintro(1L), rcsmerge(1L), rlog(1L)
69.br
70Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control
71System," in \fIProceedings of the 6th International Conference on Software
72Engineering\fR, IEEE, Tokyo, Sept. 1982.