LABEL CREATE

Description

Applies a label to a changeset and creates the label if required.

Usage

cm label [create] <lbspec> [<csetspec> | <wk_path>] [--allxlinkedrepositories] [-c=<str_comment> | -commentsfile=<comments_file>]

Options

Option / ArgumentDescription
--allxlinkedrepositoriesCreates the new label in all Xlinked repositories.
-cApplies the specified comment to the new label.
-commentsfileApplies the comment in the specified file to the new label.
lbspecThe new label name. (Use 'cm help objectspec' to learn more about label specs.)
csetspecName or full specification of the changeset to label. (Use 'cm help objectspec' to learn more about changeset specs.)
wk_pathPath of the workspace to label. (The changeset that the workspace is pointing will be labeled.)

Help

Remarks

Set the PLASTICEDITOR environment variable to specify an editor for entering comments. If the PLASTICEDITOR environment variable is set, and the comment is empty, the editor will be automatically launched to allow you to specify the comment.

Examples

cm label create lb:BL001 cs:1203 -commentsfile=commentlb001.txt

(Creates label 'BL001' attached to changeset 1203, and applies the comment in the 'commentlb001.txt' file.)

cm label BL002 cs:1203 -c="first release"

(Creates label 'BL002', with a comment, and attached to changeset 1203.)