| rcsclean.1 (9) | rcsclean.1 (11891) |
|---|---|
| 1.de Id 2.ds Rv \\$3 3.ds Dt \\$4 4.. | 1.de Id 2.ds Rv \\$3 3.ds Dt \\$4 4.. |
| 5.Id $Id: rcsclean.1,v 1.8 1991/11/03 01:09:19 eggert Exp $ | 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 | 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 working files that were checked out and never modified. | 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 |
| 18For each 19.I file 20given, 21.B rcsclean 22compares the working file and a revision in the corresponding 23\*r file. If it finds a difference, it does nothing. 24Otherwise, it first unlocks the revision if the 25.B \-u 26option is given, 27and then removes the working file 28unless the working file is writable and the revision is locked. 29It logs its actions by outputting the corresponding 30.B "rcs \-u" 31and 32.B "rm \-f" 33commands on the standard output. 34.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). |
|
| 35If no 36.I file 37is given, all working files in the current directory are cleaned. 38Pathnames matching an \*r suffix denote \*r files; 39all others denote working files. | 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. |
| 40Names are paired as explained in 41.BR ci (1). | |
| 42.PP 43The number of the revision to which the working file is compared 44may be attached to any of the options 45.BR \-n , 46.BR \-q , 47.BR \-r , 48or 49.BR \-u . 50If no revision number is specified, then if the 51.B \-u 52option is given and the caller has one revision locked, 53.B rcsclean 54uses that revision; otherwise 55.B rcsclean 56uses the latest revision on the default branch, normally the root. 57.PP 58.B rcsclean 59is useful for 60.B clean | 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 |
| 61targets in Makefiles. | 65targets in makefiles. |
| 62See also 63.BR rcsdiff (1), 64which prints out the differences, 65and 66.BR ci (1), 67which | 66See also 67.BR rcsdiff (1), 68which prints out the differences, 69and 70.BR ci (1), 71which |
| 68normally asks whether to check in a file 69if it was not changed. | 72normally reverts to the previous revision 73if a file was not changed. |
| 70.SH OPTIONS 71.TP 72.BI \-k subst 73Use 74.I subst 75style keyword substitution when retrieving the revision for comparison. 76See 77.BR co (1) --- 6 unchanged lines hidden (view full) --- 84would do without actually doing it. 85.TP 86.BR \-q [\f2rev\fP] 87Do not log the actions taken on standard output. 88.TP 89.BR \-r [\f2rev\fP] 90This option has no effect other than specifying the revision for comparison. 91.TP | 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 |
|
| 92.BR \-u [\f2rev\fP] 93Unlock the revision if it is locked and no difference is found. 94.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 |
|
| 95.BI \-V n 96Emulate \*r version 97.IR n . 98See 99.BR co (1) 100for details. 101.TP 102.BI \-x "suffixes" 103Use 104.I suffixes 105to characterize \*r files. 106See 107.BR ci (1) 108for details. | 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. |
|
| 109.SH EXAMPLES 110.LP 111.RS 112.ft 3 113rcsclean *.c *.h 114.ft 115.RE 116.LP --- 25 unchanged lines hidden (view full) --- 142The 143.B \s-1RCSINIT\s0 144options are prepended to the argument lists of most \*r commands. 145Useful 146.B \s-1RCSINIT\s0 147options include 148.BR \-q , 149.BR \-V , | 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 , |
|
| 150and | 176and |
| 151.BR \-x . | 177.BR \-z . |
| 152.SH DIAGNOSTICS 153The exit status is zero if and only if all operations were successful. 154Missing working files and \*r files are silently ignored. 155.SH IDENTIFICATION 156Author: Walter F. Tichy. 157.br | 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 |
| 158Revision Number: \*(Rv; Release Date: \*(Dt. | 184Manual Page Revision: \*(Rv; Release Date: \*(Dt. |
| 159.br | 185.br |
| 160Copyright \(co 1982, 1988, 1989 by Walter F. Tichy. | 186Copyright \(co 1982, 1988, 1989 Walter F. Tichy. |
| 161.br | 187.br |
| 162Copyright \(co 1990, 1991 by Paul Eggert. | 188Copyright \(co 1990, 1991, 1992, 1993 Paul Eggert. |
| 163.SH "SEE ALSO" 164ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1), 165rcsfile(5) 166.br 167Walter F. Tichy, 168\*r\*-A System for Version Control, 169.I "Software\*-Practice & Experience" 170.BR 15 , 1717 (July 1985), 637-654. 172.SH BUGS 173At least one 174.I file 175must be given in older Unix versions that 176do not provide the needed directory scanning operations. 177.br | 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 |