Creating a New Revision Label and Attaching it to a Folder and its Contents

Determine whether a label is a revision label or a view label by opening the Label view, and double-click the label (or select the label, and then choose Properties from the context menu). A revision label has a name and a description. A view label has a name, description, and a configuration time.

  1. Select a folder in the Server Explorer or from one of the Eclipse Explorers.
  2. Choose StarTeam > Folder > Labels. The Properties dialog box opens.
  3. Right-click the folder and choose Labels to open the Labels dialog box.
  4. Select the revision that will receive the new label.
  5. Right-click the selected item(s) and choose Labels > New . The Attach a New Revision dialog box opens.
  6. Type a name and description for the label. The maximum name length is 64 characters and the description length is 254 characters.
  7. Optionally, check Frozen (that is, cannot be changed) to ensure that only the selected revision can have this label.
  8. Select one of the following:
    Folder Only
    Attaches a label to the selected folder.
    Folder and Items Contained in Folder
    Attaches a label to the folder and its items.
    Everything in Subtree Rooted at Folder
    Attaches a label to the folder, its items, and its child folders and their items.
Note: Because attaching a label to a folder also allows it to be attached to the folder contents, children, and so on, the label is always attached to the current configuration of each folder and item. You cannot label a prior revision of a folder.