s_rcspurge



NAME

      system rcspurge - delete versions of RCS files in a system
      configuration or a part of it.


SYNOPSIS

      system rcspurge [options] system_path [files]


DESCRIPTION

      The command system rcspurge removes specified versions from RCS
      libraries placed in a system configuration or in a part of it. If a
      RCS library is defined as a symbolic link to a library from another
      configuration, the files are not purged.

    PARAMETERS
      system_path
           Specifies a system configuration or a subsystem in a system
           configuration as a top of directory tree where the attributes
           will be defined.

      files
           Specifies files which versions should be deleted. If no file is
           specified then all the files placed in every RCS library in the
           directory tree are looked for, i.e. the default value for files
           is RCS/* for each subsystem.

    OPTIONS
      -q   Quiet mode. Diagnostics are not printed.

      -nt  Do not apply the command on the complete directory tree, but only
           on the directory specified with system_path.

      -ggrp
           Delete versions of all files belonging to the group grp.

      -rrange
           Delete the versions given by range. A range of the form rev1:rev2
           means the versions between rev1 to rev2 on the same branch, :rev
           means from the beginning of the branch containing rev up to rev,
           and rev: means from version rev to the end of the branch. None of
           the outdated versions may have locks. If neither -r, -kr nor -ks
           is specified then the latest version of a file is kept.

      -krrev
           Delete all the versions but that one specified by rev.
           Note, if rev is a version in a branch, only other versions in
           this branch will be removed. All other branches, and the main
           trunk will be kept as before.

      -ksstate
           Delete all the versions but those that have the state status. If
           more than one status should be kept, state is a list of statuses,
           separated by commas.

      -xsuffixes
           Select files specified by the suffixes for RCS files. A nonempty
           suffix matches any pathname ending in the suffix. An empty suffix
           matches any pathname of the form RCS/file or path/RCS/file. The
           -x option can specify a list of suffixes separated by /. For
           example, -x ,v/ specifies two suffixes: ,v and the empty suffix.
           If two or more suffixes are specified, they are tried in order
           when looking for an RCS file; the first one that works is used
           for that file. If no RCS file is found but an RCS file can be
           created, the suffixes are tried in order to determine the new RCS
           file's name. The default for suffixes is installation-dependent;
           normally it is ,v/ for hosts like Unix that permit commas in file
           names, and is empty (i.e. just the empty suffix) for other hosts.


EXAMPLES

      system rcspurge -ksRel,Stable

      deletes all the versions of files, except those that have the statuses
      Rel or Stable.


SEE ALSO

      rcspurge(1), rcs(1), rcsp(1)


AUTHOR

      Ivica Crnkovic, Marco Mohle