rcsclean - clean up working files

SYNOPSIS

       rcsclean [options] [ file ... ]

DESCRIPTION

       rcsclean  removes  working files that were checked out and
       never modified.  For each file  given,  rcsclean  compares
       the  working  file and a revision in the corresponding RCS
       file.  If it finds a difference, it does nothing.   Other-
       wise,  it  first  unlocks the revision if the -u option is
       given, and then removes the working file unless the  work-
       ing  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.

       If  no  file  is  given,  all working files in the current
       directory are cleaned.  Pathnames matching an  RCS  suffix
       denote  RCS files; all others denote working files.  Names
       are paired as explained in ci(1).

       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 asks whether to check in a  file  if
       it was not changed.

OPTIONS

       -ksubst
              Use  subst style keyword substitution when retriev-
              ing the revision for  comparison.   See  co(1)  for
              details.

       -n[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[rev]
              Do not log the actions taken on standard output.

       -r[rev]
              This option has no effect other than specifying the
              revision for comparison.

       -u[rev]

       -Vn    Emulate RCS version n.  See co(1) for details.

       -xsuffixes
              Use  suffixes to characterize RCS files.  See ci(1)
              for details.

EXAMPLES

              rcsclean  *.c  *.h

       removes all working files ending in .c or .h that were not
       changed since their checkout.

              rcsclean

       removes  all  working  files in the current directory that
       were not changed since their checkout.

FILES

       rcsclean accesses files much as ci(1) does.

ENVIRONMENT

       RCSINIT
              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  RCS  commands.   Useful
              RCSINIT options include -q, -V, and -x.

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.
       Revision Number: 1.8; Release Date: 1991/11/03.
       Copyright (C) 1982, 1988, 1989 by Walter F. Tichy.
       Copyright (C) 1990, 1991 by 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  &  Experience  15,  7   (July   1985),
       637-654.

BUGS

       At  least  one  file  must be given in older Unix versions
       that do not provide the needed directory  scanning  opera-
       tions.