unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



rcsclean(1)							  rcsclean(1)
Free Software Foundation			     Free Software Foundation



NAME

  rcsclean - clean up working files

SYNOPSIS

  rcsclean [options] [file...]

OPTIONS

  -ksubst
      Use subst	style keyword substitution when	retrieving 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 com-
      parison.

  -u[rev]
      Unlock the revision if it	is locked and no difference is found.

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

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

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.
  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.

  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.



RESTRICTIONS

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

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.

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.

FILES

  rcsclean accesses files much as ci(1)	does.

IDENTIFICATION

  Author: Walter F. Tichy.
  Revision Number: 1.1.6.2; Release Date: 1993/10/07.
  Copyright  1982, 1988, 1989 by Walter F. Tichy.
  Copyright  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.