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


vcs(man)


NAME

       vcs - version control system utility


USAGE

       vcs [options] [file-specifications]


SYNOPSIS

       Vcs  is  a  simple, easy to use interface to rcs (revision control sys-
       tem).


DESCRIPTION

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

       Vcs uses the rcs utility to maintain a special file in the "RCS" direc-
       tory (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 cre-
           ate 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 POSIX 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>

                                                                        VCS(1)