Debian Codegraph @

upstream/debian-unstable/man1/rcsdiff.1

raw
1 .ds Rv 5.10.1
2 .ds Dt 2025-12-02
3 .ds i \&\s-1ISO\s0
4 .ds r \&\s-1RCS\s0
5 .ds u \&\s-1UTC\s0
6 .ds o \*r file
7 .if n .ds - \%--
8 .if t .ds - \(em
9 .TH RCSDIFF 1 "\*(Dt" "GNU RCS \*(Rv"
10 .SH NAME
11 rcsdiff \- 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
36 runs
37 .BR diff (1)
38 to compare two revisions of each \*o given.
39 .PP
40 Filenames matching an \*r suffix denote \*os;
41 all others denote working files.
42 Names are paired as explained in
43 .BR ci (1).
44 .PP
45 The option
46 .B \-q
47 suppresses diagnostic output.
48 Zero, one, or two revisions may be specified with
49 .BR \-r .
50 The option
51 .BI \-k subst
52 affects keyword substitution when extracting
53 revisions, as described in
54 .BR co (1);
55 for example,
56 .B "\-kk\ \-r1.1\ \-r1.2"
57 ignores differences in keyword values when comparing revisions
58 .B 1.1
59 and
60 .BR 1.2 .
61 To avoid excess output from locker name substitution,
62 .B \-kkvl
63 is assumed if (1) at most one revision option is given,
64 (2) no
65 .B \-k
66 option is given, (3)
67 .B \-kkv
68 is the default keyword substitution, and
69 (4) the working file's mode would be produced by
70 .BR "co\ \-l".
71 See
72 .BR co (1)
73 for details
74 about
75 .BR \-T ,
76 .BR \-V ,
77 .B \-x
78 and
79 .BR \-z .
80 Otherwise, all options of
81 .BR diff (1)
82 that apply to regular files are accepted, with the same meaning as for
83 .BR diff .
84 .PP
85 If both
86 .I rev1
87 and
88 .I rev2
89 are omitted,
90 .B rcsdiff
91 compares the latest revision on the
92 default branch (by default the trunk)
93 with the contents of the corresponding working file. This is useful
94 for determining what you changed since the last checkin.
95 .PP
96 If
97 .I rev1
98 is given, but
99 .I rev2
100 is omitted,
101 .B rcsdiff
102 compares revision
103 .I rev1
104 of the \*o with
105 the contents of the corresponding working file.
106 .PP
107 If both
108 .I rev1
109 and
110 .I rev2
111 are given,
112 .B rcsdiff
113 compares revisions
114 .I rev1
115 and
116 .I rev2
117 of the \*o.
118 .PP
119 Both
120 .I rev1
121 and
122 .I rev2
123 may be given numerically or symbolically.
124 .SH EXAMPLE
125 The command
126 .LP
127 .B " rcsdiff f.c"
128 .LP
129 compares the latest revision on the default branch of the \*o
130 to the contents of the working file
131 .BR f.c .
132 .SH ENVIRONMENT
133 .TP
134 .B \s-1RCSINIT\s0
135 Options prepended to the argument list, separated by spaces.
136 A backslash escapes spaces within an option.
137 The
138 .B \s-1RCSINIT\s0
139 options are prepended to the argument lists of most \*r commands.
140 Useful
141 .B \s-1RCSINIT\s0
142 options include
143 .BR \-q ,
144 .BR \-V ,
145 .BR \-x ,
146 and
147 .BR \-z .
148 .TP
149 .B \s-1RCS_MEM_LIMIT\s0
150 Normally, for speed, commands either memory map or copy into memory
151 the \*o if its size is less than the
152 .IR memory-limit ,
153 currently defaulting to ``unlimited''.
154 Otherwise (or if the initially-tried speedy ways fail),
155 the commands fall back to using
156 standard i/o routines.
157 You can adjust the memory limit by setting
158 .B \s-1RCS_MEM_LIMIT\s0
159 to a numeric value
160 .IR lim
161 (measured in kilobytes).
162 An empty value is silently ignored.
163 As a side effect, specifying
164 .B \s-1RCS_MEM_LIMIT\s0
165 inhibits fall-back to slower routines.
166 .TP
167 .B \s-1TMPDIR\s0
168 Name of the temporary directory.
169 If not set, the environment variables
170 .B \s-1TMP\s0
171 and
172 .B \s-1TEMP\s0
173 are inspected instead and the first value found is taken;
174 if none of them are set,
175 a host-dependent default is used, typically
176 .BR /tmp .
177 .SH DIAGNOSTICS
178 Exit status is 0 for no differences during any comparison,
179 1 for some differences, 2 for trouble.
180 .ds EY 1990, 1991, 1992, 1993
181 .SH IDENTIFICATION
182 Author: Walter F. Tichy.
183 .br
184 Manual Page Revision: \*(Rv; Release Date: \*(Dt.
185 .br
186 Copyright \(co 2010-2022 Thien-Thi Nguyen.
187 .br
188 Copyright \(co \*(EY Paul Eggert.
189 .br
190 Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
191 .br
192 .SH "SEE ALSO"
193 .BR ci (1),
194 .BR co (1),
195 .BR diff (1),
196 .BR ident (1),
197 .BR rcs (1),
198 .BR rcsmerge (1),
199 .BR rlog (1).
200 .PP
201 Walter F. Tichy,
202 \*r\*-A System for Version Control,
203 .I "Software\*-Practice & Experience"
204 .BR 15 ,
205 7 (July 1985), 637-654.
206 .PP
207 The full documentation for \*r is maintained as a Texinfo manual.
208 If the
209 .BR info (1)
210 and \*r programs are properly installed at your site, the command
211 .IP
212 .B info rcs
213 .PP
214 should give you access to the complete manual.
215 Additionally, the \*r homepage:
216 .IP
217 .B http://www.gnu.org/software/rcs/
218 .PP
219 has news and links to the latest release, development site, etc.