Merge Label: merge-label

The merge-label command can be used in two different ways.

• When used with -sourceview: The merge-label command creates a new label, if one does not already exist, in the target view, copying the properties of the source label from the source view. After the label has been created, the command finds the items in the source view attached to the source label, identifies the set of items in the target view that need to be attached to the target label, attaches them at the tip, and moves them back to the revision at which the items were attached in the source.

  While this command supports both view and revision labels, it is more useful for view labels (which are not supported through the StarTeam Cross-Platform Client ), unlike (cross-project) Revision Label copy, which is.

  This command supports attaching labels both to items that have been shared across (in-project) views as well as to items that have been moved across projects.

• When used with -rolluplabels: The merge-label command creates a new label, if one does not already exist, in the target view. After the label has been created, the command rolls up all the revisions of all items of the selected type spanning all the labels and attaches them to the new label at the highest item revision identified.

Syntax

The syntax for this command is:

merge-label [-sourceview "[project name/]view name" | -rolluplabels “pathToFileOfRevisionLabelNames”]
-lbl "label name" {-type typeName}  -p "user:password@host:port/project/view"  -epwdfile –description “label description”

While this command supports both view and revision labels, it is more useful for view labels (which are not supported through the StarTeam Cross-Platform Client ), unlike (cross-project) Revision Label copy, which is.

This command supports attaching labels both to items that have been shared across (in-project) views as well as to items that have been moved across projects.

Parameters

For information about the command parameters, refer to Operation Parameters.

In addition:

Parameter	Description
-description	Specifies a description to be used to create the new label, described by -lbl.