C and C++ SoftBench User's Guide

Contents
9
Understanding SoftBench CM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Getting Started - A Brief Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Managing the Archive System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Browsing Local Network Servers and Archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Creating an Archive Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Creating a Mapping between an Archive Directory and Local Directory . . . . . . . . . 98
Modifying Mappings between Local and Archive Directories . . . . . . . . . . . . . . . . . . 99
Managing Archive Files and Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Creating Initial Archive Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Checking Out Archive Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Cancelling Archive File Check Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Updating a Local Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Viewing Contents of Archive Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Deleting Archive Files and Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Locking an Archive File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Breaking a Lock on an Archive File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Viewing the Revision History of Archive Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Setting Archive Display Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Managing Local Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Modifying Local Source Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Checking In Modified Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Creating a Default Symbolic Name for Archive Files . . . . . . . . . . . . . . . . . . . . . . . . . 112
Understanding Symbolic Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Defining Symbolic Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Symbolic Name Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Using the SoftBench CM Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . . . 115
4. Using SoftBench Editors
Using Editors with Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Configuring an Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Configuring SoftBench vi Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Configuring SoftBench Program Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Starting the Configured SoftBench Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Editing with SoftBench XEmacs Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Using SoftBench XEmacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Accessing Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Editing Multiple Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Editing with SoftBench vi Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126