https://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
       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 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)