MAN page from RedHat Other rcs-5.7-8.i386.rpm
RCSCLEAN
Section: User Commands (1)
Updated: 1993/11/03
Index NAME
rcsclean - clean up working files
SYNOPSIS
rcsclean[
options] [
file ... ]
DESCRIPTION
rcscleanremoves files that are not being worked on.
rcsclean -ualso unlocks and removes files that are being worked onbut have not changed.
For eachfilegiven,rcscleancompares the working file and a revision in the correspondingRCS file. If it finds a difference, it does nothing.Otherwise, it first unlocks the revision if the-uoption is given,and then removes the working fileunless the working file is writable and the revision is locked.It logs its actions by outputting the correspondingrcs -uandrm -fcommands on the standard output.
Files are paired as explained inci(1).If nofileis given, all working files in the current directory are cleaned.Pathnames matching an RCS suffix denote RCS files;all others denote working files.
The number of the revision to which the working file is comparedmay be attached to any of the options-n,-q,-r,or-u.If no revision number is specified, then if the-uoption is given and the caller has one revision locked,rcscleanuses that revision; otherwisercscleanuses the latest revision on the default branch, normally the root.
rcscleanis useful forcleantargets in makefiles.See alsorcsdiff(1),which prints out the differences,andci(1),whichnormally reverts to the previous revisionif a file was not changed.
OPTIONS
- -ksubst
- Usesubststyle keyword substitution when retrieving the revision for comparison.Seeco(1)for details.
- -n[rev]
- Do not actually remove any files or unlock any revisions.Using this option will tell you whatrcscleanwould do without actually doing it.
- -q[rev]
- Do not log the actions taken on standard output.
- -r[rev]
- This option has no effect other than specifying the revision for comparison.
- -T
- Preserve the modification time on the RCS fileeven if the RCS file changes because a lock is removed.This option can suppress extensive recompilation caused by amake(1)dependency of some other copy of the working file on the RCS file.Use this option with care; it can suppress recompilation even when it is needed,i.e. when the lock removalwould mean a change to keyword strings in the other working file.
- -u[rev]
- Unlock the revision if it is locked and no difference is found.
- -V
- Print RCS's version number.
- -Vn
- Emulate RCS versionn.Seeco(1)for details.
- -xsuffixes
- Usesuffixesto characterize RCS files.Seeci(1)for details.
- -zzone
- Usezoneas the time zone for keyword substitution;seeco(1)for details.
EXAMPLES
- rcsclean *.c *.h
removes all working files ending in.cor.hthat were not changedsince their checkout.
- rcsclean
removes all working files in the current directorythat were not changed since their checkout.
FILES
rcscleanaccesses files much as
ci(1)does.
ENVIRONMENT
- RCSINIT
- options prepended to the argument list, separated by spaces.A backslash escapes spaces within an option.TheRCSINIToptions are prepended to the argument lists of most RCS commands.UsefulRCSINIToptions include-q,-V,-x,and-z.
DIAGNOSTICS
The exit status is zero if and only if all operations were successful.Missing working files and
RCS files are silently ignored.
IDENTIFICATION
Author: Walter F. Tichy.
Manual Page Revision: 1.12; Release Date: 1993/11/03.
Copyright © 1982, 1988, 1989 Walter F. Tichy.
Copyright © 1990, 1991, 1992, 1993 Paul Eggert.
SEE ALSO
ci(1),
co(1),
ident(1),
rcs(1),
rcsdiff(1),
rcsintro(1),
rcsmerge(1),
rlog(1),
rcsfile(5)
Walter F. Tichy,
RCS--A System for Version Control,
Software--Practice & Experience15,7 (July 1985), 637-654.
BUGS
At least one
filemust be given in older Unix versions thatdo not provide the needed directory scanning operations.
Index
- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- EXAMPLES
- FILES
- ENVIRONMENT
- DIAGNOSTICS
- IDENTIFICATION
- SEE ALSO
- BUGS
This document was created byman2html,using the manual pages.
