rcsclean removes files that are not being worked on.
rcsclean -u also unlocks and removes files that are being worked on
but have not changed.
For each
file given,
rcsclean compares the working file and a revision in the corresponding
r file. If it finds a difference, it does nothing.
Otherwise, it first unlocks the revision if the
-u option is given,
and then removes the working file
unless the working file is writable and the revision is locked.
It logs its actions by outputting the corresponding
rcs -u and
rm -f commands on the standard output.
Files are paired as explained in
ci(1) . If no
file is given, all working files in the current directory are cleaned.
Pathnames matching an r suffix denote r files;
all others denote working files.
The number of the revision to which the working file is compared
may be attached to any of the options
-n , -q , -r , or
-u . If no revision number is specified, then if the
-u option is given and the caller has one revision locked,
rcsclean uses that revision; otherwise
rcsclean uses the latest revision on the default branch, normally the root.
rcsclean is useful for
clean targets in makefiles.
See also
rcsdiff(1) , which prints out the differences,
and
ci(1) , which
normally reverts to the previous revision
if a file was not changed.
OPTIONS
-k subst
Use
subst style keyword substitution when retrieving the revision for comparison.
See
co(1) for details.
-n [<2>rev]
Do not actually remove any files or unlock any revisions.
Using this option will tell you what
rcsclean would do without actually doing it.
-q [<2>rev]
Do not log the actions taken on standard output.
-r [<2>rev]
This option has no effect other than specifying the revision for comparison.
-T
Preserve the modification time on the r file
even if the r file changes because a lock is removed.
This option can suppress extensive recompilation caused by a
make(1) dependency of some other copy of the working file on the r file.
Use this option with care; it can suppress recompilation even when it is needed,
i.e. when the lock removal
would mean a change to keyword strings in the other working file.
-u [<2>rev]
Unlock the revision if it is locked and no difference is found.
options prepended to the argument list, separated by spaces.
A backslash escapes spaces within an option.
The
RCSINIT options are prepended to the argument lists of most r commands.
Useful
RCSINIT options include
-q , -V , -x , and
-z .
DIAGNOSTICS
The exit status is zero if and only if all operations were successful.
Missing working files and r files are silently ignored.
