Managing labels

Labels can be used to mark important file revisions, for example, the set of file revisions used to build a particular software release. You can use labels to specify groups of related file revisions in operations like sync and integrate.

To use labels, you (1) define the label, then (2) label file revisions in the depot. When you define a label, you specify a label view, which limits the files to which the label can be applied.

To create a label:

  1. Click Specs>New>Label. The New Label dialog is displayed.
  2. Enter a name for the new label and click OK. The Label form is displayed
  3. Enter a description of the label.
  4. Specify the label view one of two ways:
  5. Click OK.

To label files:

  1. Select a file and choose File>Label... The Label Files dialog is displayed.
  2. Select the label you want to use from the Label field list.
  3. Choose the Apply selected label to files option.
  4. Click Label.

Note that the selected file must be in the label view and synced to your client workspace.

To remove a label from a set of files:

  1. Select a file and choose File>Label... The Label Files dialog is displayed.
  2. Select the label you want to use from the Label field list.
  3. Choose the Remove selected label from files option.
  4. Click Label.

To display the labels defined for the server to which you are connected, choose View>Labels.

To display the file revisions in a label, context-click the label and choose Show the list of files.

To edit a label:

  1. Context-click the label and choose Open. The Label form is displayed.
  2. Click Edit, enter your changes, and click OK.

Editing a label does not change the list of files to which the label is applied.

To delete a label, click the label and choose Specs>Delete Label labelname. Deleting a label also removes the label from files.

To sync labeled files into your workspace:

  1. Context-click a label, a file, or a folder and choose Sync... The Sync dialog is displayed.
  2. In the Files field, type in a path or file. (You can also drag a folder or a file into this field.)
  3. Choose "Label" from the To field list.
  4. Choose the desired label from the list of labels.
  5. Click Sync to sync the files revisions to which the label has been applied.