1.de Id 2.ds Rv \\$3 3.ds Dt \\$4 4.. |
5.Id $Id: rcsclean.1,v 1.12 1993/11/03 17:42:27 eggert Exp $ |
6.ds r \&\s-1RCS\s0 7.if n .ds - \%-- 8.if t .ds - \(em 9.TH RCSCLEAN 1 \*(Dt GNU 10.SH NAME 11rcsclean \- clean up working files 12.SH SYNOPSIS 13.B rcsclean 14.RI [ options "] [ " file " .\|.\|. ]" 15.SH DESCRIPTION 16.B rcsclean |
17removes files that are not being worked on. 18.B "rcsclean \-u" 19also unlocks and removes files that are being worked on 20but have not changed. 21.PP |
22For each 23.I file 24given, 25.B rcsclean 26compares the working file and a revision in the corresponding 27\*r file. If it finds a difference, it does nothing. 28Otherwise, it first unlocks the revision if the 29.B \-u 30option is given, 31and then removes the working file 32unless the working file is writable and the revision is locked. 33It logs its actions by outputting the corresponding 34.B "rcs \-u" 35and 36.B "rm \-f" 37commands on the standard output. 38.PP |
39Files are paired as explained in 40.BR ci (1). |
41If no 42.I file 43is given, all working files in the current directory are cleaned. 44Pathnames matching an \*r suffix denote \*r files; 45all others denote working files. |
46.PP 47The number of the revision to which the working file is compared 48may be attached to any of the options 49.BR \-n , 50.BR \-q , 51.BR \-r , 52or 53.BR \-u . 54If no revision number is specified, then if the 55.B \-u 56option is given and the caller has one revision locked, 57.B rcsclean 58uses that revision; otherwise 59.B rcsclean 60uses the latest revision on the default branch, normally the root. 61.PP 62.B rcsclean 63is useful for 64.B clean |
65targets in makefiles. |
66See also 67.BR rcsdiff (1), 68which prints out the differences, 69and 70.BR ci (1), 71which |
72normally reverts to the previous revision 73if a file was not changed. |
74.SH OPTIONS 75.TP 76.BI \-k subst 77Use 78.I subst 79style keyword substitution when retrieving the revision for comparison. 80See 81.BR co (1) --- 6 unchanged lines hidden (view full) --- 88would do without actually doing it. 89.TP 90.BR \-q [\f2rev\fP] 91Do not log the actions taken on standard output. 92.TP 93.BR \-r [\f2rev\fP] 94This option has no effect other than specifying the revision for comparison. 95.TP |
96.B \-T 97Preserve the modification time on the \*r file 98even if the \*r file changes because a lock is removed. 99This option can suppress extensive recompilation caused by a 100.BR make (1) 101dependency of some other copy of the working file on the \*r file. 102Use this option with care; it can suppress recompilation even when it is needed, 103i.e. when the lock removal 104would mean a change to keyword strings in the other working file. 105.TP |
106.BR \-u [\f2rev\fP] 107Unlock the revision if it is locked and no difference is found. 108.TP |
109.BI \-V 110Print \*r's version number. 111.TP |
112.BI \-V n 113Emulate \*r version 114.IR n . 115See 116.BR co (1) 117for details. 118.TP 119.BI \-x "suffixes" 120Use 121.I suffixes 122to characterize \*r files. 123See 124.BR ci (1) 125for details. |
126.TP 127.BI \-z zone 128Use 129.I zone 130as the time zone for keyword substitution; 131see 132.BR co (1) 133for details. |
134.SH EXAMPLES 135.LP 136.RS 137.ft 3 138rcsclean *.c *.h 139.ft 140.RE 141.LP --- 25 unchanged lines hidden (view full) --- 167The 168.B \s-1RCSINIT\s0 169options are prepended to the argument lists of most \*r commands. 170Useful 171.B \s-1RCSINIT\s0 172options include 173.BR \-q , 174.BR \-V , |
175.BR \-x , |
176and |
177.BR \-z . |
178.SH DIAGNOSTICS 179The exit status is zero if and only if all operations were successful. 180Missing working files and \*r files are silently ignored. 181.SH IDENTIFICATION 182Author: Walter F. Tichy. 183.br |
184Manual Page Revision: \*(Rv; Release Date: \*(Dt. |
185.br |
186Copyright \(co 1982, 1988, 1989 Walter F. Tichy. |
187.br |
188Copyright \(co 1990, 1991, 1992, 1993 Paul Eggert. |
189.SH "SEE ALSO" 190ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1), 191rcsfile(5) 192.br 193Walter F. Tichy, 194\*r\*-A System for Version Control, 195.I "Software\*-Practice & Experience" 196.BR 15 , 1977 (July 1985), 637-654. 198.SH BUGS 199At least one 200.I file 201must be given in older Unix versions that 202do not provide the needed directory scanning operations. 203.br |