UPDATE
Description
Updates the workspace and downloads latest changes.
Usage
cm update [<item_path> | --last] [--changeset=<csetspec>] [--cloaked] [--dontmerge] [--forced] [--ignorechanges] [--override] [--recursewk] [--skipchangedcheck] [--silent] [--verbose] [--xml[=<output_file>]] [--encoding=<name>] [--machinereadable [--startlineseparator=<sep>] [--endlineseparator=<sep>] [--fieldseparator=<sep>]] [--forcedetailedprogress] [--noinput]
Options
Option / Argument | Description |
---|---|
--changeset | Updates the workspace to a specific changeset. (Use 'cm help objectspec' to learn more about changeset specs.) |
--cloaked | Includes the cloaked items in the update operation. If this option is not specified, those items that are cloaked will be ignored in the operation. |
--dontmerge | In case an update merge is required during the update operation, does not perform it. |
--forced | Forces updating items to the revision specified in the selector. |
--ignorechanges | Ignores the pending changes warning message that is shown if there are pending changes detected when updating the workspace. |
--noinput | Skips the interactive questions to continue the operation with pending changes or to shelve them. |
--override | Overrides changed files outside Unity VCS control. Their content will be overwritten with the server content. |
--recursewk | Updates all the workspaces found within the current path. Useful to update all the workspaces contained in a specific path. |
--skipchangedcheck | Checks if there are local changes in your workspace before starting. If you always checkout before modifying a file, you can use this check and speed up the operation. |
--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). |
--machinereadable | Outputs the result in an easy-to-parse format. |
--startlineseparator | Used with the '--machinereadable' flag, specifies how the lines should start. |
--endlineseparator | Used with the '--machinereadable' flag, specifies how the lines should end. |
--fieldseparator | Used with the '--machinereadable' flag, specifies how the fields should be separated. --forcedetailedprogress Forces detailed progress even when standard output is redirected. |
--last | Changes the workspace selector from a changeset configuration or a label configuration to a branch configuration before updating. The selector is changed to the branch the changeset or label belongs to. |
item_path | Path to update. Use . to apply update to current directory. If no path is specified, then the current workspace is fully updated. |
Help
Remarks
The 'update' command only downloads needed files.
The command assumes recursive operation.
When the '--last' option is used, it is not necessary to specify a path. In this case, the workspace the current working directory belongs to will be updated. (Remember that specifying this flag could cause the workspace selector to be changed to a branch configuration if the selector was previously pointing to a changeset or a label.)
Examples
cm update
(Updates all in the current workspace.)
cm update .
(Updates current directory, and all children items.)
cm update . --forced --verbose
(Forces retrieval of all revisions.)
cm update --last
cm update . --machinereadable --startlineseparator=">"
(Updates current directory and prints the result in a simplified easier-to-parse format, starting the lines with the specified strings.)