Adding and Replacing Files in a Label

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. Tag the files with that label using Add/Replace files...

For more information about labels, see Working with Labels.

Add/Replace 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 Add/Replace files in a label:

1. Select the Labels tab.
2. Click on the name of the label to which you want to add or replace files.
3. Select Add/Replace labels... from the pulldown list.

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 add or replace. 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.
   • Files in this list - 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 you will see 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,
   • Click the Preview Add/Replace button to see the results before actually updating the label. If the command has the expected results, click your browser's "Back" button and,
   • Click the Add/Replace button to proceed.