rcspurge



NAME

      rcspurge - delete versions of a file in a RCS library.


SYNOPSIS

      rcspurge [options] [files]


DESCRIPTION

      The command rcspurge deletes versions of a file placed in a RCS
      library.

    PARAMETERS
      files
           Specifies files which versions should be deleted. If no file is
           specified then all the files in the RCS library are taken, i.e.
           the default value is RCS/*.

    OPTIONS
      -q   Quiet mode. Diagnostics are not printed.

      -ggrp
           Purge 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, -o, -kr nor
           -ks is specified then the latest version of a file is kept.

      -orange
           Delete the versions given by range. Normally this option can be
           used to delete a specified version. If a range is specified, note
           that also the specified versions are deleted. None of the
           outdated versions may have locks. If neither -r, -o, -kr nor -ks
           is specified then the latest version of a file is kept.

      -l   Purge the files from the RCS even if the RCS library is defined
           as a symbolic link. By default, if a RCS library is defined as a
           symbolic link, it will not be purged.

      -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

      rcspurge -r:1.5 file1

      deletes all the versions of file1 up to the 1.5 version (not including
      the 1.5 version).

      rcspurge -r1.1:1.5 file1

      deletes all versions between 1.1 and 1.5 of file1.

      rcspurge -o1.1 file1

      delete version 1.1 of file1.

      rcspurge -rR1_0:R2_0

      deletes all versions between R1_0 and R2_0 of all files in the RCS
      library in the current directory.


SEE ALSO

      s_rcspurge(1), rcs(1), rcsp(1)


AUTHOR

      Ivica Crnkovic, Marco Mohle