Penguin
Annotated edit history of rcsclean(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 RCSCLEAN
2 !!!RCSCLEAN
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 EXAMPLES
8 FILES
9 ENVIRONMENT
10 DIAGNOSTICS
11 IDENTIFICATION
12 SEE ALSO
13 BUGS
14 ----
15 !!NAME
16
17
18 rcsclean - clean up working files
19 !!SYNOPSIS
20
21
22 __rcsclean__ [[''options''] [[ ''file'' ...
23 ]
24 !!DESCRIPTION
25
26
27 __rcsclean__ removes files that are not being worked on.
28 __rcsclean -u__ also unlocks and removes files that are
29 being worked on but have not changed.
30
31
32 For each ''file'' given, __rcsclean__ compares the
33 working file and a revision in the corresponding
34 RCS file. If it finds a difference, it does
35 nothing. Otherwise, it first unlocks the revision if the
36 __-u__ option is given, and then removes the working file
37 unless the working file is writable and the revision is
38 locked. It logs its actions by outputting the corresponding
39 __rcs -u__ and __rm -f__ commands on the standard
40 output.
41
42
43 Files are paired as explained in ci(1). If no
44 ''file'' is given, all working files in the current
45 directory are cleaned. Pathnames matching an
46 RCS suffix denote RCS files;
47 all others denote working files.
48
49
50 The number of the revision to which the working file is
51 compared may be attached to any of the options __-n__,
52 __-q__, __-r__, or __-u__. If no revision number is
53 specified, then if the __-u__ option is given and the
54 caller has one revision locked, __rcsclean__ uses that
55 revision; otherwise __rcsclean__ uses the latest revision
56 on the default branch, normally the root.
57
58
59 __rcsclean__ is useful for __clean__ targets in
60 makefiles. See also rcsdiff(1), which prints out the
61 differences, and ci(1), which normally reverts to the
62 previous revision if a file was not changed.
63 !!OPTIONS
64
65
66 __-k__''subst''
67
68
69 Use ''subst'' style keyword substitution when retrieving
70 the revision for comparison. See co(1) for
71 details.
72
73
74 __-n__[[''rev'']
75
76
77 Do not actually remove any files or unlock any revisions.
78 Using this option will tell you what __rcsclean__ would
79 do without actually doing it.
80
81
82 __-q__[[''rev'']
83
84
85 Do not log the actions taken on standard
86 output.
87
88
89 __-r__[[''rev'']
90
91
92 This option has no effect other than specifying the revision
93 for comparison.
94
95
96 __-T__
97
98
99 Preserve the modification time on the RCS
100 file even if the RCS file changes because a
101 lock is removed. This option can suppress extensive
102 recompilation caused by a make(1) dependency of some
103 other copy of the working file on the RCS
104 file. Use this option with care; it can suppress
105 recompilation even when it is needed, i.e. when the lock
106 removal would mean a change to keyword strings in the other
107 working file.
108
109
110 __-u__[[''rev'']
111
112
113 Unlock the revision if it is locked and no difference is
114 found.
115
116
117 __-V__
118
119
120 Print RCS 's version number.
121
122
123 __-V__''n''
124
125
126 Emulate RCS version ''n''. See
127 co(1) for details.
128
129
130 __-x__''suffixes''
131
132
133 Use ''suffixes'' to characterize RCS
134 files. See ci(1) for details.
135
136
137 __-z__''zone''
138
139
140 Use ''zone'' as the time zone for keyword substitution;
141 see co(1) for details.
142 !!EXAMPLES
143
144
145 __rcsclean *.c *.h__
146
147
148 removes all working files ending in __.c__ or __.h__
149 that were not changed since their checkout.
150
151
152 __rcsclean__
153
154
155 removes all working files in the current directory that were
156 not changed since their checkout.
157 !!FILES
158
159
160 __rcsclean__ accesses files much as ci(1)
161 does.
162 !!ENVIRONMENT
163
164
165 __RCSINIT__
166
167
168 options prepended to the argument list, separated by spaces.
169 A backslash escapes spaces within an option. The
170 __RCSINIT__ options are prepended to the
171 argument lists of most RCS commands. Useful
172 __RCSINIT__ options include __-q__,
173 __-V__, __-x__, and __-z__.
174 !!DIAGNOSTICS
175
176
177 The exit status is zero if and only if all operations were
178 successful. Missing working files and RCS
179 files are silently ignored.
180 !!IDENTIFICATION
181
182
183 Author: Walter F. Tichy.
184 Manual Page Revision: 1.12; Release Date: 1993/11/03.
185 Copyright 1982, 1988, 1989 Walter F. Tichy.
186 Copyright 1990, 1991, 1992, 1993 Paul Eggert.
187 !!SEE ALSO
188
189
190 ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1),
191 rcsmerge(1), rlog(1), rcsfile(5)
192 Walter F. Tichy, RCS --A System for Version
193 Control, ''Software--Practice ''
194 __15__, 7 (July 1985), 637-654.
195 !!BUGS
196
197
198 At least one ''file'' must be given in older Unix
199 versions that do not provide the needed directory scanning
200 operations.
201 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.