NAME

workspace − manipulate TeamWare workspaces

SYNOPSIS

workspace command args ...

DESCRIPTION

The workspace command manipulates TeamWare workspaces. TeamWare was formerly known as CodeManager.  A workspace is a directory that contains a subdirectory named Codemgr_wsdata used by teamware to store information about that workspace. 

USAGE

Many of the following subcommands take an optional list of workspaces, [ ws  ... ]. If any workspaces are named, then they are operated upon. If no workspaces are named, 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. 

access [ −l | -q operation=user ] [ ws  ... ]
List or query the file ws/Codemgr_wsdata/access_control.  If the −l option is specified, the command lists the contents of access_control.  If the −q option is specified, the command queries access_control to determine if user has permission to do operation in ws.  The command exits with the following values:

0 = user does not have access
1 = user has access
2 = error

The command also displays a textual message indicating whether or not user has access.  To add, delete, or change user entries, use the teamware GUI Props -> Workspace command, or edit the file ws/Codemgr_wsdata/access_control directly (see access_control(4)). 

children [ −r ] [ ws  ... ]
List ws’s children workspaces. With the −r option, ws’s descendant workspaces are recursively listed, each new generation indented two spaces. If more than one ws is specified, the name of each ws precedes its list. 

create ws ... Create the named workspaces.  If ws is the name of an existing SunOS directory, the command simply creates a Codemgr_wsdata directory directly under that directory.  If ws does not exist, both it and its Codemgr_wsdata subdirectory are created. 

delete [ −d ] [ −f ] ws ...
Delete the named workspaces.  When a workspace is deleted:

• Its name is removed from its parent’s Codemgr_wsdata/children file

• Its name is removed from its children’s Codemgr_wsdata/parent file

• The contents of the workspace are deleted

Since it is a destructive operation, workspace delete prompts for confirmation before actually deleting a workspace.  The −f option forces deletion by bypassing confirmation. 

Used with the −d option, the command deletes only the Codemgr_wsdata subdirectory. 

list [ −r ] [ ws | dir ... ]
List ws if it is a workspace.  List any workspaces found underneath dir.  With the −r option, dir’s workspaces are recursively listed.  If no ws or dir is given, then the value of the shell environment variable CODEMGR_WSPATH is used. 

locks [ −r ] [ ws  ... ]
With no option specified, the locks that are active for ws are listed.  If −r is specified, the locks are listed and the user is prompted for which lock to remove. 

move from_ws to_ws
Move the workspace from_ws to workspace to_ws.  If the move is across file systems, teamware will copy all files to to_ws before it removes from_ws.  The command updates the parent and child workspaces to reflect the new location. 

Note: Do not use the SunOS mv command to rename or move workspaces.  The workspace move command updates files in the workspace’s parent and children, as well as logging the event in the Codemgr_wsdata/history file. 

If you inadvertently use the mv command to move/rename a workspace and discover that it has become "disconnected" from its parent and children, you can use the workspace move command to reconnect it. 

For example, if you used the mv command to rename workspace A to file B:

1. Use the workspace move command to rename B to C.  The command updates the workspace’s new name (C) in the parent and child workspaces. 

2. Lastly, use the workspace move command to change C back to B.  Everything should be reconnected. 

name Name the workspace that the current directory resides in. 

parent [ −f ][ −p newparent ] [ −r ] [ −u ] [ ws ... ]
List ws’s parent workspace, reparent ws or unparent ws.  With no options specified, the ws’s parent is listed. With the −r option, ws’s ancestor workspaces are recursively listed, each new generation indented two spaces. The recursive list begins with the parent workspace and proceeds through the previous generations. If more than one ws is specified, the name of each ws precedes its list.  If the −p option is set, the workspace will be reparented to newparent; ws’s name is removed from its current parent’s children list, and is added to newparent’s children list.  If the old parent no longer exists, use the -f option to force the reparent.  To change the workspace so that it no longer has a parent, use the −u option. 

updatenames [ −z ] [ ws ... ]
Update ws’s name table by searching the workspace for SCCS files.  With the −z option, also update files’ name histories, if they are out of date.  ws can also be the name of an environment.  A workspace’s name table contains an entry for every SCCS file in that workspace.  Each entry consists of a workspace-relative file name and four hexadecimal numbers computed from the file’s first SCCS delta.  The bringover and putback commands rely on the name tables in the parent and child workspaces to detect and propagate renames.  Even if one workspace’s name table has been outdated by a rename in that workspace, bringover and putback can detect the rename by inspecting both workspaces’ name tables.  The bringover and putback commands identify renamed files and update the name table accordingly.  The larger the workspace, the more time required to run this command. 

In some cases when SCCS files have been copied within a workspace, updatenames interactively prompts the user for the current names of some SCCS files. 

ENVIRONMENT

CODEMGR_PATH_ONLY TeamWare commands first search for other TeamWare binaries relative to where their own binary is located in the file system, they then search in the directories specified in the PATH environment variable.  Setting this variable causes TeamWare commands to search for other TeamWare binaries only in PATH. 

CODEMGR_WS Contains the name of a user’s default workspace.  The workspace specified by CODEMGR_WS will automatically be used if -w option is not specified to a command. 

CODEMGR_WSPATH Specifies a list of workspace directories to be automatically loaded into the workspace pane upon tool startup. 

The CODEMGR_WSPATH variable can be to set to one or more directories that contain workspace directories.  For example, to set this variable to the directories /export/home/ws and ~/projects/ws, use the following command:

example% setenv CODEMGR_WSPATH "/export/home/ws ~/projects/ws"

USAGE

SEE ALSO

TeamWareUser’sGuide
bringover(1), def.dir.flp(1), filemerge(1), putback(1), resolve(1), teamware(1), ws_undo(1), access_control(4), args(4), children(4), conflicts(4), history(4), locks(4), nametable(4), notification(4), parent(4)

SunOS WorkShop_4.2  —  Last change: 01 December 1992