Copying View Labels

Occasionally, you may want to create a view label and attach it to the same item revisions as an existing view label, with a few additions or exceptions. The steps in this procedure explain how to create a view label based on an existing view label. For example, suppose builds are done only after a view has been rolled back to a label and that the build is given the same name as the label. If, in the last build, only one Help file was missing, you would probably change the existing label to include that one file and rebuild. However, if the previous build was already made available to users participating in a field test, using the same label could cause confusion. It would be better to create a new view label as a copy of the older label and then add the missing file to the new label.

Note: You cannot copy a view label unless it already exists in the view in which you are performing this operation. The view configuration must also be current.

Choose StarTeam > View > Labels .
The Properties dialog box opens. Select Labels (for view).
Click New.
The View Label dialog box opens.
Type a name and description for the label. The maximum name length is 64 characters and the description length is 254 characters.
Select the Labeled Configuration option to attach the label to item revisions that have an existing label.
Optionally, uncheck Use As Build Label if you do not want this label to be a build label.
Note: By default all view labels are designated as build labels.
Click OK.
Click Close.
The new view label is now attached to the same revisions as the existing label. You can now use the context menus provided in the Eclipse Explorers or StarTeam views to attach or detach labels for which the new label must differ.
Select the items in the Package or Navigator Explorers, and choose Team > Labels > Detach from the context menu.
Attach the new label to items formerly not included, and/or attach the new label to different revisions of items to which it is already attached. Select the items in the Package or Navigator Explorers, and choose Team > Labels > Attach from the context menu.