Sun WorkShop TeamWare User's Guide

Chapter 5

Managing Files

Once you have created TeamWare workspaces, you can start work on your project files. Coordinating write access to source files is important when changes will be made by several people. Maintaining a record of file updates allows you to determine when and why changes were made. Versioning is the TeamWare tool you use to manage files. This chapter shows you how to do these basic tasks in Versioning:

• Starting Versioning
• Adding Files to a Workspace
• Checking Out a File
• Editing a File
• Changing Your Default Editor
• Checking In a File
• Reversing Changes to a File
• Integrating Changes By Putting Back Files

Starting Versioning

The Versioning tool allows you to control write access to source files and monitor changes made to those files. Versioning allows only one user at a time to update a file, and it records all changes in a history file.

• To start Versioning, choose TeamWare Versioning in the Configuring window.

  When you start Sun WorkShop TeamWare Versioning, the Versioning window opens. The Versioning main window displays the directories and files of the current directory (see FIGURE 5-1).

FIGURE 5-1   Versioning Window

The Versioning window displays the directories and files of your project. Versioning displays all directories, but displays only files that are under SCCS control. See Adding Files to a Workspace.

TABLE 5-1 describes the Versioning window menus.

TABLE 5-1   Versioning Window Menus

Menu	Description
File	Provides commands for managing files.
View	Provides commands to control and update the icons shown in the directory pane.
Commands	Provides commands for checking files in and out.
Workspace	Provides commands for finding, deleting, and moving files under SCCS control.
TeamWare	Provides commands for starting other TeamWare tools.
Help	Provides commands to display online help and release documentation.

Directories are shown whether or not they contain files that are under SCCS control. A directory is a container for files and directories and can possibly contain SCCS files and directories further down the hierarchy. Files are shown only in the Versioning window if they are under SCCS control. To look at the non-SCCS files in a directory, use the Check in New window.

Adding Files to a Workspace

For the Sun WorkShop TeamWare configuration management tools to be able to recognize files, the files must be under SCCS version control.

To add files to a TeamWare workspace:

1. Start Configuring.

2. Load the workspace you want to work with by choosing File Load Workspaces.

If the directory is not yet a TeamWare workspace, see Creating a Parent Workspace.

3. Click on the workspace to select it.

4. Choose TeamWare Versioning.

5. In the Versioning Window, choose Commands Check In New.

6. In the Check In New dialog box, select the files you want to add to the workspace.

You can Shift-click to select multiple files.

7. Click OK.

The files you have checked in are now displayed in the Versioning window.

Checking Out a File

Versioning requires that you check out a file before you modify it. When a file is checked out from a workspace, no other user is allowed to check out the file. If you have two users who need access to the same file, have one user create a child workspace so they can have their own copy of the file.

To check out a file:

1. In the Configuring Window, choose TeamWare Versioning.

2. In the Versioning Window, navigate to the directory where the files exist and select the icon of the first file you want to change.

You can shift-click to select several files.

3. Choose Commands Check Out.

If you choose Commands Check Out and Edit, Versioning starts up an editor for you.

A check mark is displayed on the file icon of the selected file. If you want to use a different editor than the default, see Changing Your Default Editor.

Editing a File

To edit a Sun WorkShop TeamWare file:

1. In the Configuring Window, choose File Load Workspaces to load your workspace.

2. Click the workspace to select it.

3. Choose Teamware Versioning.

The Versioning Window appears.

4. In the Versioning window, select the file you want to edit by clicking on it.

5. Choose Commands Check Out and Edit.

This opens the file in the default editor. If you want to use a different editor, see "Changing Your Default Editor."

6. After you have edited and saved the file, check in the file.

See Checking In a File.

Changing Your Default Editor

To change your default editor:

1. In the Configuring Window, choose TeamWare Versioning.

2. In the Versioning Window, choose View Options.

3. In the Options dialog box, select the editor you want to use.

4. If you choose Other, type the path to your editor in the box that appears.

Checking In a File

To check in a file:

1. In the Versioning Window, navigate to the directory where the files are stored.

2. Click the icon for file you want to check in.

You can Shift-click to select multiple files. Files that are checked out have a red check mark on the icon.

3. Choose Commands Check In.

4. In the Check In dialog box, type a comment.

5. Click OK.

Sun WorkShop TeamWare saves your comments and checks in the file. To integrate the changes to the parent workspace, see Integrating Changes By Putting Back Files.

Reversing Changes to a File

Versioning also provides a way to return a file to the state it was in before it was checked out. This is useful if you have made changes to a file, but don't want those changes checked back in.

To reverse the changes made to a checked-out file:

1. In the Configuring Window, choose TeamWare Versioning.

2. In the Versioning Window, navigate to the directory where the checked-out file is stored.

The icon of the file should have red check mark, indicating it is checked out.

3. Click on the file to select it.

Shift-click to select multiple files.

4. Choose Commands Uncheckout.

This reverses the most recent changes to the document and returns the file to its previous state.

Integrating Changes By Putting Back Files

After you have made changes to the files in your workspace, you need to put back these changes to the parent workspace. This makes your changes available to the other members of your team.

To put back files to a parent workspace:

1. In the Configuring Window, choose Actions Putback.

2. In the Putback tab, select the files you want to put back.

3. Click in the Comments text box and type a comment.

Depending on how your administrator has set up email notification, many people may see this comment.

4. Click Putback.

The Transactions Output window is displayed and shows information about the putback. If there is a conflict during a putback, Configuring automatically takes you to the Resolve Tab (see Chapter 6).

5. Click Close to close the Transactions Output window.

---

Note – For a more detailed description of performing a putback, see Putting Back Changes to a Parent Workspace.

---