Sun WorkShop TeamWare: User's Guide: Contents

## Sun WorkShop TeamWare: User's Guide

# Contents

## Preface

## 1. QuickStart

  Basic Concepts
    Parent and Child Workspaces
    Source Code Control System
    Changing Names

  Versioning

  Freezepointing

  Distributed Make

## 2. Introduction

  How to Use the Documentation Supplied with TeamWare

## 3. Introduction to TeamWare Configuring

  Coordinating the Work of Software Developers

  Copy-Modify-Merge Model
    Copy-Modify-Merge Example

  Default Configuring
    Workspace
    Copying Files between Workspaces
    Resolving Conflicts

## 4. Introduction to Merging

  Differences Defined
    Difference
    Current, Next, and Previous Difference
    Resolved and Remaining Difference

  Graphical Overview
    Merging Window
    Merging Glyphs

## 5. Starting a Project

  Moving an Existing SCCS-Based Project to Sun Workshop TeamWare

  Moving a Non-SCCS Software Development Project to Workshop TeamWare

  Converting an RCS Project to Workshop TeamWare
    Further User Notes

  Starting a New Software Development Project with Workshop TeamWare
    Configuring a Workspace Hierarchy
    File Transfer Considerations

  Product Release Considerations

  Coordinating Access to Source Files
    Branches

## 6. TeamWare Configuring User Interfaces

  TeamWare Configuring Command-Line Interface

  TeamWare Configuring Graphical User Interface

  Starting TeamWare Configuring
    TeamWare Configuring Windows
    Configuring Window
    Customizing the Configuring Program Using Properties
    Accelerators

## 7. TeamWare Configuring Workspace

  The Workspace Metadata Directory

  Creating a Workspace
    Using Workspace Create
    Using the Bringover Create Transaction

  Deleting a Workspace

  Moving and Renaming a Workspace
    A Note About Moving Workspaces

  Reparenting a Workspace
    Two Ways to Reparent Workspaces
    Reasons to Change a Workspace's Parent

  Controlling Access to Workspaces
    Viewing and Changing Access Control Values

  How to Notify Users of Changes to Workspaces
    Viewing and Changing Notification Entries
    Notes About Registering Notification Events

  Viewing Workspace Command History

  Ensuring Consistency through Workspace Locking

  Configuring Environment Variables
    The CODEMGR_WS Variable
    The CODEMGR_WSPATH Variable

## 8. Copying Files between Workspaces

  Configuring Transaction Model

  General File Copying Information
    SCCS History Files
    Viewing Transaction Output
    Specifying Directories and Files for Transactions

  Copying Files from a Parent to a Child Workspace (Bringover)
    Creating a New Child Workspace (Bringover Create)
    Notes about the Bringover Create Transaction
    Updating an Existing Child Workspace (Bringover Update)
    Notes about the Bringover Update Transaction
    Bringover Action Summary

  Copying Files from a Child to a Parent Workspace (Putback)
    Updating a Parent Workspace Using Putback
    Notes about the Putback Transaction
    Putback Action Summary

  Reversing Bringover and Putback Transactions with Undo
    Notes about the Undo Transaction
    How the Undo Transaction Works

  Renaming, Moving, or Deleting Files
    Renaming Files
    Deleting Files
    Notes about Renaming Files

## 9. Resolving Conflicts

  Conflict Resolution Process
    Changing Names

  Detecting Conflicts
    Detecting Conflicts during Bringover Update Transactions
    Preparing Files for Conflict Resolution

  Resolving Conflicts
    Resolve Transaction

## 10. Administering the Workspace

  Starting a Project with the Configuring Program
    Moving an Existing Project
    Starting a New Project

  Structuring Your Workspace Hierarchy
    File Transfer Considerations
    Product Release Considerations

## 11. How the Configuring Program
Merges SCCS Files

  Merging Files That Do Not Conflict

  Merging Files That Conflict
    An Example of Merging

## 12. Configuring Example

  Creating Workspaces

  Putting Back Changes

  Updating a Workspace

  Resolving Conflicts

## 13. Error and Warning Messages

  Error Messages

  Warnings Messages

## 14. Performing Basic SCCS Functions with Versioning

  Typical Sessions
    Changing Names
    Putting a Project Under SCCS Control
    Working with a Project Under SCCS Control
    Getting Help on the GUI or the CLI

  Commands: Manipulating Files
    Checking Out and Checking In Files
    Editing a Checked-Out File
    Checking in a New File
    Unchecking Out a File

  View Option: Changing Versioning Properties
    Changing the Main File List Display
    Defining an Editor
    Changing the Double-Click Action
    Changing the History Graph Display
    Changing the History Information Display

## 15. Starting and Loading Merging

  Changing Names

  Starting Merging from Sun WorkShop

  Starting Merging from Sun WorkShop TeamWare

  Loading Files from the Merging Window

  Starting Merging from the Command Line
    Basic Startup Command
    Command-Line Synopsis
    Loading Two Files at Startup
    Loading Three Files at Startup
    Loading Files from a List File

  Saving the Output File

## 16. Examining Differences

  Moving Between Differences

  Resolving Differences

  Automatic Merging

  An Example
    Starting Merging
    Examining Differences
    Saving Output File

## 17. Introduction to FreezePointing

  Changing Names

  How FreezePointing Works

  Starting FreezePointing

  Creating a Freezepoint File

  Viewing or Modifying a Freezepoint File

  Recreating (Extracting) a Source Hierarchy
    Notes about Using FreezePointing

  Details about the Freezepoint File
    What is a SMID?
    Why are SMIDs Necessary?

  SMID/SID Translation
    Translating SIDs to SMIDs
    Translating SMIDS to SIDS

## 18. Troubleshooting Versioning
and FreezePointing

  Troubleshooting Checklist

  Reporting Problems

  Error Messages

  Display Problems

## 19. Building Programs in Sun Workshop TeamWare

  Building a TeamWare Target

  Building With Default Values

  Building With NonDefault Values

  Modifying a TeamWare Target

  Fixing Build Errors

## 20. Using DistributedMake

  Basic Concept of Distributed Make
    Configuration Files
    The DMake Host
    The Build Server

  What You Should Know About DMake Before You Use It
    DMake's Impact on Makefiles

  How to Use DMake
    Notes
    Controlling DistributedMake Jobs
    Getting Help on the GUI or the CLI

## 21. Dealing With Release Matters

  Integrating Your Changes

  Performing Master Builds
    Establishing Nightly Builds

  Performing Releases
    Organizing a Release
    How the Release Process Works

## Index