Labelsync

There are essentially two steps to creating a label:

1. Create the label spec, which defines the name of the label and label view.
2. Perform a labelsync to tag files with the label.

For more information about labels, see Working with Labels.

Labelsync restrictions

• The label's Owner: field is not your userid. You can only update labels you own.
• The label has its Options: field set to locked

To perform a labelsync:

1. Select Go To->Labels.
2. Click on the name of the label that you wish to labelsync.
3. Select Run->Labelsync....

OR...

1. Select Run->Label...
2. Click the Labelsync option and select the name of the label from the drop down list.
3. Click Continue.

1. Under Revision: select one of the following radio buttons:
   • Workspace Revision - tags the file revisions currently synced in your workspace with the label.
   • Head Revision - tags the file revisions that are currently the latest versions in the depot with the label.
   • Label, Changelist or Date - enter a label name, a changelist number, or a date to tag files at revisions matching that criteria.

2. Under Options: select one of the following radio buttons:
   • Replace label contents completely - specified files are added or replaced. Files previously in the label that do not match your specification are removed from the label.
   • Add files to label - adds or replaces only the files that you specify. Labeled files that do not match your specifications are unaffected.
   • Remove files from label - removes the named files from the label.

3. Under Files: you can specify or restrict the files to labelsync. Select one of the following options:
   • All files in label view - includes all files in this label's label view.
   • Files in // [path] - this option is only available when your current path is not the root of the depot tree. Select and subdirectories or at this level only, depending on which files you wish to include, and labelsync includes all files in the specified path.
   • Files in this list - labelsync includes only the files listed in the textbox. You must provide a full pathname for these files, and you can use wildcards. Note that the files you specify must be in the label's view, or labelsync will produce a "No such file" error. You can also specify revisions, but this only works if you have selected the Workspace Revision option above.

4. When you have finished defining the parameters of your labelsync,
   • Click the Preview labelsync button to see the results of your labelsync before actually performing the labelsync. If the labelsync has the expected results, click your browser's "Back" button and,
   • Click the Labelsync button to proceed with the labelsync.