Copying Revision Labels

Occasionally, you may want to copy a revision label. For example, if you move or share an item from one view (source view) to another (target view), labels from the source view do not become part of target view. However, by copying the revision labels after the move or share, you can selectively maintain revision labels on the moved or shared items.

Copying a revision label immediately attaches it to the same revisions of the same items as the original revision label. If the two revision labels are in the same view, each label will be attached to the same number of items. However, if the two revision labels are in different views, the new label becomes attached to the same revisions of the same items only if the items and their revisions exist in the new label's view at the time of the copy operation.

Although you can copy revision labels in a variety of ways, the following procedure allows you to copy a revision label whether it is in the current view or in another accessible view. It assumes that you are dealing with files, but can be adapted for other types of items.

  1. Select the folder in the Server Explorer or the Eclipse Explorers that contains the item to modify.
  2. Choose StarTeam > View > Labels from the main menu.

    The Properties dialog box opens.
  3. Click the Revision tab.
  4. Click New.
    The Revision Label dialog box opens.
  5. Type a name and description for the label. The maximum name length is 64 characters and the description length is 254 characters.
  6. Check Copy From Another Revision Label.
  7. Click Select to open the Copy a Revision dialog box.
  8. Select a project from Project from the list, a view in the View tree, and a revision label in the Labels list.
  9. Click OK.
  10. Click OK.
  11. Click Close.

    The new revision label is attached to the same revisions as the existing label.

  12. Do one of the following:
    • Check in the changed file or files using the new revision label.
    • Check in the changed file and attach the new revision label manually to the changed file revisions. To do this, select the checked in file and click the Label tab in the lower pane. Drag the new revision label to the correct (probably tip) revision in the Label pane. Repeat for any other changed files.
    Note: If you have added a new file, use File > Labels > Attach to attach the label.