CASEVision™/ClearCase User's Guide

Document Number: 007-2369-001

Front Matter

| List of Figures | List of Examples | List of Tables |

Table of Contents

1. Overview of ClearCase Usage
Finding Your Niche
The View as Virtual Workspace
Modifying Elements - the Checkout/Checkin Model
Building and Testing Software
Working in a Parallel Development Environment
Working with Meta-Data

2. Using the ClearCase Command Line Interface
Using cleartool
Using clearmake

3. Using the ClearCase Graphical User Interface
Starting xclearcase
File Browser
Basic Usage Model
Basic Pointer Actions and Keystrokes
The File Menu

4. Setting Up a View
Planning the View
Creating the View
Configuring the View
Starting to Use the View

5. Defining View Configurations
Dynamic `Mainline' View
Frozen View, Defined by Version Labels
Frozen View, Defined by Time
View That Allows an `Old' Configuration to be Modified
View for New Development on a Branch
View That Implements Multiple-Level Branching
View That Selects Versions Using `External Criteria'
View That Shows Only One Developer's Changes
View That Restricts Changes to a Single Directory
View That Uses Results of a Nightly Build
Playing Mix-and-Match with Application Subsystems
Selecting Versions That Built a Particular Program

6. Working in a Parallel Development Environment
Parallel Development Using Branches
Setting Up a View for Parallel Development
Working in a Multiple-View Environment
Merging Versions of an Element
Using Your Own Merge Tools

7. Comparing and Merging Files Graphically with xcleardiff
Invoking xcleardiff
Comparing Files
Comparing Directories
Merging Files

8. Using the ClearCase/SoftBench Integration
Configuring the Development Manager for ClearCase
Configuring HP VUE
Using SoftBench
ClearCase Encapsulation Summary

9. Using the ClearCase/ToolTalk Integration
Standalone Notice Forwarding
ClearCase Encapsulation Summary

10. Building with clearmake; Some Basic Pointers
Accommodating clearmake's Build Avoidance
Continuing to Work During a Build / Reference Time
Using Config Spec `Time Rules' to Increase Your View's Isolation
Problems with `Forced Builds'
Wink-in, Permissions on Derived Objects, and clearcase_bld_umask

11. Derived Objects and Configuration Records
Extended Naming Scheme for Derived Objects
More on CRs and Configuration Lookup
Management of DOs and CRs

12. Makefile Optimization
Pathnames in Build Scripts
Declaring Source Dependencies in Makefiles
Build-Order Dependencies
Build Sessions, Subsessions, and Hierarchical Builds
Incremental Updating of Derived Objects
Build Auditing and Background Processes

13. Setting Up a Distributed Build
Overview of Distributed Building
Client-Side Setup
Server-Side Setup
Starting a Distributed Build

14. Building Software for Multiple Architectures
Issues in Multiple-Architecture Development
Handling Source Code Differences
Handling Build Procedure Differences
Segregating the Derived Objects of Different Variants
Multiple-Architecture Example, Using `imake'

15. Setting Up a Build on a Non-ClearCase Host
Setting Up an Export View
Mounting the VOB through the Export View
Revising the Build Script
Performing an Audited Build in the Export View

16. Adding a Timestamp to an Executable
Creating a `what' String
Implementing a `-Ver' Option

17. Compatibility between clearmake and Other make Variants
`clearmake' Compatibility With Standard `make'
`clearmake' Compatibility Modes
Supported SGI `smake' Features
Supported SGI `pmake' Features
Supported Sun `make' Features
Supported `Gnu make' Features
Compatibility Limitations

18. Customizing the Graphical Interface
Group File Syntax
Group File Processing and Macro Expansion
xclearcase Macros
Customization Procedures
Resource Schemes
Icon Display in the File Browser

19. Type Managers and Customized Processing of File Elements
File Typing
Element Types and Type Managers
Predefined and User-Defined Element Types
Predefined and User-Defined Type Managers
Type Manager for Manual Page Source Files
Icon Usage by GUI Browsers

20. Using Triggers, Attributes, and Locks to Implement Development Policies
Scenario: Requiring Good Documentation of Changes
Scenario: Tracking State Transitions
Scenario: Recording a Released Configuration
Scenario: Isolating Work on a Bugfix
Scenario: Isolating All Users from Each Other
Scenario: Freezing Certain Data
Scenario: Customized Change Notification
Scenario: Enforcing Quality Standards
Scenario: Associating Changes with Change Orders
Scenario: Requirements Tracing
Scenario: Change Sets

21. Using ClearCase to Organize and Implement Parallel Development
Project Overview
Development Strategy
Creating Branch Types
Creating Project-Standard Config Specs
Creating, Configuring, and Registering Views
Development Begins
Creating Baselevel 1
Synchronizing Ongoing Development
Creating Baselevel 2
Final Validation - Creating Release 2.0