LABEL CREATE
Create and apply labels with the Unity Version Control CLI.
Read time 1 minuteLast updated 10 months ago
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 / Argument | Description |
|---|---|
| --allxlinkedrepositories | Creates the new label in all Xlinked repositories. |
| -c | Applies the specified comment to the new label. |
| -commentsfile | Applies the comment in the specified file to the new label. |
| lbspec | The new label name. (Use 'cm help objectspec' to learn more about label specs.) |
| csetspec | Name or full specification of the changeset to label. (Use 'cm help objectspec' to learn more about changeset specs.) |
| wk_path | Path 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.)