P4Web User Guide - Labelsync

P4Web Release 2002.2 User Guide
[Getting Started] [How To...] [Browser Tips] [Glossary] [Road Map]

Labelsync

There are essentially two steps to creating a label:

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

Labelsync associates a set of files with the label and applies the label name to that set of files. Once you have performed the labelsync, you can refer to a set of files by their label name.

For more information about labels, see Working with Labels.

Labelsync restrictions

Bear in mind that you cannot use labelsync to update a label if:

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

For more information about a label's fields, see Creating and Editing Labels.

To perform a labelsync:

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

OR...

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

On the Labelsync page,

Under Revision: select one of the following radio buttons:
- Workspace Revision - populates the label with the file revisions currently synced in your workspace.
- Head Revision - populates the label with the file revisions that are currently the latest versions in the depot.
- Label, Changelist or Date - enter a label name, a changelist number, or a date to populate the label with files at revisions matching that criteria.
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.
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.
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.