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