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