http://invisible-island.net/ded/cm_tools/

VCS


NAME

vcs − version control system utility

USAGE

vcs [options] [file-specifications]

SYNOPSIS

Vcs is a simple, easy to use interface to rcs (revision control system).

DESCRIPTION

Vcs is a source-control tool which can be used by either the configuration manager or developers. Developers should be able to unlock files that they have locked (i.e., with checkin), or to add new subdirectories to a configuration, or to delete them.

Vcs uses the rcs utility to maintain a special file in the "RCS" directory (named "RCS,v"). This file controls permission on the creation or deletion of files -- or of the entire directory.

OPTIONS

−d

delete archive-directory leaf. If you are on the access list of the vcs-file within which the directory is appended, and if no files have been archived in the RCS directories within, you may delete the given directories.

−i

insert archive-directory leaf. If you are on the access list of the vcs-file within which the directory is appended, vcs will create new archive directories, each of which has an RCS subdirectory.

−n

no-op mode shows the operations that would be performed, but does not attempt them.

−q

quiet mode suppresses messages.

−u

unlock specified files. You must be either the owner of the file, or of at least one lock. If the former, all locks are removed.

−x

direct vcs to retain the pathname when translating between working and archive files, e.g, "path/name" becomes "path/RCS/name,v". If the "−x" option is not set, "path/name" becomes "./RCS/name,v", and "path/RCS/name,v" becomes "./name".

You must specify exactly one of the options "-d", "-i" or "-u".

ENVIRONMENT

Vcs is written in C, and runs on UNIX® systems.

Environment variables imported by vcs include:
RCS_DEBUG

set this variable (e.g., to 1 or 2) to activate debugging-traces in the tool.

RCS_DIR

identifies the name of the RCS subdirectory, and indirectly the name of the vcs file within that directory.

FILES

Vcs uses the following files

permit

to initialize a new vcs-file (i.e., so that its baseline version is compatible).

rcs

to copy access lists from a parent directory to a newly-inserted directory.

ANTICIPATED CHANGES

None.

SEE ALSO

checkin, checkout, ci (1), co (1), rcs (1)

AUTHOR:

Thomas E. Dickey <dickey@invisible-island.net>