CODEMGRTOOL(1) — USER COMMANDS

NAME

codemgrtool — codemgrtool is an OpenWindows graphical user interface (GUI) tool for CodeManager commands.

SYNOPSIS

codemgrtool [ directory... ]

DESCRIPTION

codemgrtool is the OpenWindows GUI for the CodeManager commands. The main window of the tool presents a view of workspace hierarchies. Workspaces shown in the workspace pane can be loaded in or created. Each workspace is represented by a workspace icon. Arcs drawn between workspaces represent parent-child relationships. File are copied between child and parent workspaces.

Once created, workspaces can be populated with source files by either importing files from a specified directory or bringing over files from an existing parent workspace. To transfer changes in source files between workspaces, the user opens the Transactions window. Here, the parent workspace, child workspace, and the list of files to transfer are specified. Other transactions, such as resolving conflicts on files, and undoing file transfers can also be done in the Transactions window.

To start codemgrtool, type codemgrtool at a shell prompt. An optional argument constists of a list of directories to be loaded into codemgrtool when it starts up. Each directory can be either a workspace directory or a directory which contains workspace directories.

ACCELERATORS

Although all of the functions in codemgrtool are available through the menu buttons, many of them can be accessed by graphical accelerators, such as double-clicking SELECT and drag and drop. The following is a list of the accelerators currently available in codemgrtool:

Workspace Selection
Most of the commands from the menu buttons use the workspaces selected in the workspace pane as arguments. Some commands accept only a single workspace selection (for example, the transaction menu items), while others accept one or more workspace selections (for example, the File=>Unload Workspaces command).

Double-click
Double-click SELECT to look inside of a workspace. As a default, double-clicking SELECT on a workspace launches VersionTool with the selected workspace loaded. The double-click action can be configured through the CodeManager section of the Properties menu. If a workspace contains files in conflict, the default double-click SELECT action activates the Resolve transaction window.

Workspace Reparenting
Reparent workspaces by dragging and dropping workspace icons while pressing the Shift key. Drag the icon of a workspace over the icon of its new parent.

Bringover/Putback Transactions
Dragging an existing workspace icon in the Workspace pane and dropping it on another workspace icon activates the appropriate Transaction window. Dragging a parent over its child activates the Bringover Update window, dragging a child over its parent activates the Putback window and dragging any icon over an open area in the pane activates the Bringover Create window.

Workspace Renaming
Clicking SELECT on the name of a workspace underlines the name and allows the editing of a new name for the workspace. Once a new name is composed, enter the new name by typing Return. To exit the editing mode, click SELECT in an empty area in the window.

ENVIRONMENT

The following variables are used by codemgrtool.

CODEMGR_PATH_ONLY
CodeManager commands first search for other CodeManager 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 CodeManager commands to search for other CodeManager binaries only in PATH.

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

Magnify Help provides context-sensitive help for each control button and area of the tool. To use Magnify Help, move the pointer to an object or area and press the Help key on the keyboard.

Museum

Related Articles