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:
- Click Specs>New>Label. The New Label dialog is displayed.
- Enter a name for the new label and click OK. The Label form
is displayed
- Enter a description of the label.
- Specify the label view one of two ways:
- Graphically: on the View tab, select depot paths, or
- Textually: on the Form tab, specify the depot location of the
files in the View field.
- Click OK.
To label files:
- Select a file and choose File>Label... The Label Files
dialog is displayed.
- Select the label you want to use from the Label field list.
- Choose the Apply selected label to files option.
- 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:
- Select a file and choose File>Label... The Label Files
dialog is displayed.
- Select the label you want to use from the Label field list.
- Choose the Remove selected label from files option.
- 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:
- Context-click the label and choose Open. The Label form is
displayed.
- 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:
- Context-click a label, a file, or a folder and choose Sync...
The Sync dialog is displayed.
- In the Files field, type in a path or file. (You can also drag a
folder or a file into this field.)
- Choose "Label" from the To field list.
- Choose the desired label from the list of labels.
- Click Sync to sync the files revisions to which the label has been
applied.