gnu/usr.bin/rcs/rcsdiff/rcsdiff.1

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