Creating and applying a Rational Team Concert source control patch

A Rational Team Concert™ source control patch is a file that captures the differences between a project in a local workspace and its counterpart in the repository.

About this task

A patch is similar to a change set, but can be shared with users of other SCM systems and also with Rational Team Concert source control users in other repositories. A patch can capture the differences between a project in a local workspace and its counterpart in the repository, or it can capture the combined effect of a number of change sets.

Note: Only ASCII text files can be included in a patch. For information about changing the properties of a file that is incorrectly classified as binary, see Specifying file properties and line delimiter types.

Procedure

To create a Rational Team Concert source control patch:
1. In the Pending Changes view, right-click the change set or Unresolved folder that contains the files that you want to include in the patch and click New > Patch (You can also right-click a project or file in the Change Explorer view and click New > Patch).
2. In the Create Patch window, review the set of files that will be included in the patch, and clear any that you do not want to include.
3. Specify where to save the patch file. Select File to save the patch to a file and type a path name to use, or click Browse to browse for a location Select Clipboard to save the patch file on the system clipboard.
4. Click OK to create the patch.
To apply a Rational Team Concert source control patch:
1. On the Eclipse main menu, click Project > Apply Patch.
2. In the Apply Patch window, specify where to find the patch file. Select File and type the path name of the file or click Browse to browse for it. On Windows®, you can select Clipboard to specify that the file is on the system clipboard.
3. Click OK. Patches appear in a special Pending Patches folder in the Pending Changes view. Review the files that are included in the patch, and clear the selection for any that you do not want to apply, then take one of the following actions:
  - To merge a patch into your workspace, right-click the patch and click Merge into Workspace. The patch is merged into the workspace.
  - To apply the patch to a different target, click Change Target. This option allows you to apply a patch if the target has been moved since the patch was created and Rational Team Concert source control is unable to find the target at its new location.
  - To remove some or all of the patch from the Pending Patches folder without applying it (for example, if you have finished merging the patch, or decide that you do not want to apply it), click Remove from View.