Documentation Home
> Sun WorkShop TeamWare 2.1 User's Guide
Sun WorkShop TeamWare 2.1 User's Guide
Book Information
Preface
Chapter 1 QuickStart
Basic Concepts
Parent and Child Workspaces
Source Code Control System
Changing Names
Using TeamWare Configuring
Getting Started
Creating a New Workspace
Creating a Workspace From an Existing Hierarchy of Files
Creating an Empty Workspace
Creating a Child Workspace
Changing Files in a Child Workspace
Putting Back Changes to the Parent WorkSpace
Updating the Child Workspace
Resolving Conflicts
Using TeamWare Versioning
Starting Versioning
Checking Files In and Out of SCCS
Checking a File Out
Checking a File In
Viewing and Comparing a File's Delta History
Merging Previously Unmerged Branch Deltas
Using TeamWare Freezepointing
Starting Freezepointing
Creating and Extracting Freezepoints
Creating a Freezepoint File
Extracting a Source Hierarchy
Distributed Make
Chapter 2 Introduction
Chapter 3 Introduction to TeamWare Configuring
Coordinating the Work of Software Developers
Copy-Modify-Merge Model
Copy-Modify-Merge Example
Default Configuring
Workspace
Parent and Child Relationship
Reparenting
Codemgr_wsdata Directory
Modifying Files
Copying Files between Workspaces
Source Code Control System Files
Bringover and Putback Transactions
Relationships between Files in Parent and Child Workspaces
Case 1
Case 2
Case 4
Summary
Resolving Conflicts
Chapter 4 Introduction to Merging
Differences Defined
Difference
Current, Next, and Previous Difference
Resolved and Remaining Difference
Merging Window
Merging Window at Startup
Merging Glyphs
Two Input Files
Three Input Files
Chapter 5 Starting a Project
Moving an Existing SCCS-Based Project to Sun Workshop TeamWare
Moving a Non-SCCS Software Development Project to Sun Workshop TeamWare
Converting an RCS Project to Sun Workshop TeamWare
Using rcs2ws
Starting a New Software Development Project with Sun Workshop TeamWare
Configuring a Workspace Hierarchy
File Transfer Considerations
File System Accessibility
Flat Hierarchy vs. Multitiered Hierarchy
Advantages of a Flat Hierarchy
Disadvantages of a Flat Hierarchy
Advantages of a Multitiered Hierarchy
Disadvantages of a Multitiered Hierarchy
Product Release Considerations
Coordinating Access to Source Files
Branches
Chapter 6 TeamWare Configuring User Interfaces
TeamWare Configuring Command-Line Interface
TeamWare Configuring Graphical User Interface
Starting TeamWare Configuring
TeamWare Configuring Windows
Configuring Window
Workspace Graph Pane
Loading Workspaces into the Workspace Graph Pane
Layout
Workspace Name Fields
Dragging and Dropping Workspace Icons
Double-Click Action
Customizing Configuring Using Tool Properties
Configuring Defaults Files
Configuring Pane
Bringover/Putback Pane
Resolve Pane
Keyboard Shortcuts
Chapter 7 TeamWare Configuring Workspace
The Workspace Metadata Directory
Creating a Workspace
Using Create Workspace
Using the Bringover Create Transaction
Deleting a Workspace
Moving and Renaming a Workspace
Reparenting a Workspace
Two Ways to Reparent Workspaces
Drag and Drop Workspace Icons
The Parent Command
Reasons to Change a Workspace's Parent
A Reparenting Example
Controlling Access to Workspaces
Viewing and Changing Access Control Values
Viewing Access Control Status
Changing Access Control Values
How to Notify Users of Changes to Workspaces
Viewing and Changing Notification Entries
Creating a New Notification Entry
Modifying a Existing Entry
Viewing Workspace Command History
Ensuring Consistency Through Workspace Locking
Configuring Environment Variables
The CODEMGR_WS Environment Variable
The CODEMGR_WSPATH Environment Variable
Chapter 8 Copying Files between Workspaces
Configuring Transaction Model
General File Copying Information
SCCS History Files
Viewing Transaction Output
Specifying Directories and Files for Transactions
Grouping Files for Transfer Using File List Programs
Constructing Directory and File Lists in the File List Pane
Selecting Files in the File List Pane
Loading and Saving Default Lists
Changing the Contents of the File List Pane
Add Files Dialog Box
Copying Files from a Parent to a Child Workspace (Bringover)
Creating a New Child Workspace (Bringover Create)
Checked-out files
Transaction Output Window
Workspace Locks
History File
Updating an Existing Child Workspace (Bringover Update)
Checked-out files
Transaction Output Window
Conflicts
Workspace Locks
History File
Bringover Action Summary
Copying Files from a Child to a Parent Workspace (Putback)
Updating a Parent Workspace Using Putback
Checked-out files
Transaction Output Window
Workspace Locks
History File
Putback Action Summary
Reversing Bringover and Putback Transactions with Undo
Workspace Locks
History File
How the Undo Transaction Works
Renaming, Moving, or Deleting Files
Renaming Files
Renaming Example
Name History
Rename Conflicts
Deleting Files
Chapter 9 Resolving Conflicts
Conflict Resolution Process
Detecting Conflicts
Detecting Conflicts During Bringover Update Transactions
Preparing Files for Conflict Resolution
Resolving Conflicts
Resolve Transaction
Merging
Merging Window
Marking of Differences
Resolving Differences
Chapter 10 How Configuring Merges SCCS Files
Merging Files That Do Not Conflict
Merging Files That Conflict
An Example of Merging
Chapter 11 Configuring Example
Creating Workspaces
Putting Back Changes
Updating a Workspace
Resolving Conflicts
Chapter 12 Performing Basic SCCS Functions with Versioning
Introduction to Versioning
Branches
Deltas and Versions
History Files
SCCS Delta ID (SID)
Versioning Window
History Dialog Box
Typical Sessions
Putting a Project Under SCCS Control
Working with a Project Under SCCS Control
Using Commands to Manipulate Files
Checking Out and Checking In Files
Checking Out Files
Checking In Files
Editing a Checked-Out File
Checking in a New File
Unchecking Out a File
Changing Versioning Properties
Chapter 13 Starting Merging and Loading Files
Starting Merging
Starting Merging from the Command Line
Loading Two Files at Startup
Loading Three Files at Startup
Loading Files from a List File
Starting Merging From Sun WorkShop or From Another TeamWare Tool
Loading Files from the Merging Window
Saving the Output File
Chapter 14 Examining Differences
Moving Between Differences
Resolving Differences
Automatic Merging
Reloading Files
An Example
Examining Differences
Glyphs
Resolving a Difference
Editing the Output File
Saving Output File
Chapter 15 Preserving Project State With Freezepointing
Introduction to Freezepointing
How Freezepointing Works
Freezepoint Files
Creation
Extraction
Source Workspace
Destination Directory
Starting Freezepointing
Creating a Freezepoint File
Recreating (Extracting) a Source Hierarchy
Chapter 16 Troubleshooting Versioning and FreezePointing
Troubleshooting Checklist
Reporting Problems
Error Messages
Display Problems
Chapter 17 Building Programs in Sun Workshop TeamWare
Building a TeamWare Target
Building Window
Building a Program
Define New Target and Edit Target Dialog Boxes
Building With Default Values
Default Makefile and Make Target
Using Default Values
Building With Nondefault Values
Collecting Build Output
Saving Build Output
Modifying a TeamWare Target
Removing a TeamWare Target
Customizing a Build
Specifying Make Options
Specifying a Build Mode
Serial Mode
Parallel Mode
Distributed Mode
Using Makefile Macros
Adding a Macro
Deleting a Macro
Changing a Macro
Reviewing and Overriding Makefile Macros
Using Environment Variables
Adding an Environment Variable
Deleting an Environment Variable
Changing the Value of an Environment Variable
Reviewing and Overriding Environment Variables
Fixing Build Errors
Displaying the Source of an Error
Fixing an Error
Running a Distributed Build
Preparing for a Distributed Build
.dmakerc File
dmake.conf File
Examining Multiple Build Jobs
Exiting Building
Chapter 18 Using the dmake Utility
Basic Concepts
Configuration Files
Runtime Configuration File
Build Server Configuration File
The dmake Host
The Build Server
Understanding the dmake Utility
Impact of the dmake Utility on Makefiles
Using Makefile Templates
Building Targets Concurrently
Limitations on Makefiles
Dependency Lists
Explicit Ordering of Dependency Lists
Concurrent File Modification
Concurrent Library Update
Multiple Targets
Restricting Parallelism
Nested Invocations of Distributed Make
Using the dmake Utility
Controlling dmake Jobs
Chapter 19 Error and Warning Messages
Error Messages
Warnings Messages
Appendix A About SCCS Mergeable IDs
Why SMIDs Are Necessary
SMID/SID Translation
Translating SIDs to SMIDs
Examples
Translating SMIDS to SIDS
Examples
Glossary
© 2010, Oracle Corporation and/or its affiliates