Man Page rcs2ws.1




NAME

     rcs2ws - produce a Sun WorkShop TeamWare workspace  from  an
     RCS source hiearchy


SYNOPSIS

     rcs2ws  -p parentdir [ -g] [ -n ] [ -V ] [ -w cws ] files or
     dirs


DESCRIPTION

     rcs2ws produces a Sun WorkShop TeamWare  workspace  from  an
     RCS  source  hierarchy.  Sun  WorkShop TeamWare was formerly
     known as CodeManager.  rcs2ws is  analogous  to  the  bring-
     over(1)  command  but  in  this  case the "parent" is an RCS
     source hierarchy.

     rcs2ws operates on RCS files under parentdir, converts  them
     to  SCCS  files, and puts the resulting SCCS files under the
     cws workspace.  If necessary,  cws  will  be  created.   The
     parentdir hierarchy is unaffected by rcs2ws.

     To convert files, rcs2ws invokes the RCS co command and  the
     SCCS admin, get, and delta commands.  These commands will be
     found using the user's PATH variable.  If the SCCS  commands
     can't be found, then they will be sought in the /usr/ccs/bin
     directory.


OPTIONS

     -p parentdir
               Names  the  RCS  source  hierarchy.   This  is   a
               required option.

     -w cws    Names the child workspace.  If the  -w  option  is
               not   specified,  then  the  value  of  the  shell
               environment  variable  CODEMGR_WS  is  used.    If
               CODEMGR_WS is not set and the current directory is
               contained  within  a  workspace,  the   containing
               workspace  is  used.   If cws does not exist, then
               rcs2ws will create it.

     -g        Don't do SCCS gets after converting  files.   Nor-
               mally,  g-files  are extracted after they are con-
               verted.

     -n        Show what would be  done  without  actually  doing
               anything.

     -V        Display the version being run on standard output.

     Some notes about the file and dir arguments:

     o  The "." directory may be used to specify that  every  RCS
        file under parentdir should be converted.

     o  Relative files names are interpreted as being relative to
        parentdir.

     o  Directories are searched recursively.


ENVIRONMENT

     The following variables are used by rcs2ws.

     CODEMGR_WS     Contains  the  name  of  a   user's   default
                    workspace.   The   workspace   specified   by
                    CODEMGR_WS is automatically used  if  the  -w
                    option is not specified.


NOTES

     rcs2ws does not convert RCS keywords to SCCS keywords.  Key-
     words are treated as text in the SCCS


EXIT CODES

     0         rcs2ws was successful.

     1         rcs2ws failed due to conditions such as  parentdir
               not  existing, being unable to find the co, admin,
               delta, and get commands, or a failure when  creat-
               ing cws.


SEE ALSO

     Sun WorkShop TeamWare User's Guide

     bringover(1), codemgr(1), def.dir.flp(1), dmake(1), freezept(1),
     putback(1), resolve(1), teamware(1), twbuild(1), twfreeze(1),
     twmerge(1), twversion(1), workspace(1), ws_undo(1),
     access_control(4), args(4), children(4), conflicts(4),
     description(4), freezepointfile(4), history(4), locks(4),
     nametable(4), notification(4), parent(4), putback.cmt(4)