SWITCH
Description
Switches the workspace to a branch, changeset, label, or shelveset.
Usage
cm switch (<brspec> | <csetspec> | <lbspec> | <shspec>) [--workspace=<path>] [--repository=<name>] [--forcedetailedprogress] [--silent] [--verbose] [--xml[=<output_file>]] [--encoding=<name>] [--forcedetailedprogress] [--noinput]
Options
Option / Argument | Description |
---|---|
--workspace | Path where the workspace is located. |
--repository | Switches to the specified repository. |
--forcedetailedprogress | Forces detailed progress even when standard output is redirected. |
--noinput | Skips the interactive questions to continue the operation with pending changes or to shelve them. |
--silent | No output is shown unless an error happens. |
--verbose | Shows additional information. |
--xml | Prints the output in XML format to the standard output. It is possible to specify an output file. |
--encoding | Used with the --xml option, specifies the encoding to use in the XML output, i.e.: utf-8. See the MSDN documentation at http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx to get the table of supported encodings and its format, (at the end of the page, in the "Name" column). |
brspec | Target branch. (Use 'cm help objectspec' to learn more about branch specs.) |
csetspec | Target changeset. (Use 'cm help objectspec' to learn more about changeset specs.) |
lbspec | Target label. (Use 'cm help objectspec' to learn more about label specs.) |
shspec | Target shelveset. (Use 'cm help objectspec' to learn more about shelveset specs.) |
Help
Remarks
This command allows users to update the workspace tree to the contents of the specified object (branch, label, shelveset, or changeset).
Examples
cm switch br:/main
cm switch lb:Rel1.1
cm switch br:/main/scm002 --repository=rep2
cm switch cs:4375
cm switch sh:2