PARTIAL UPDATE
Perform updates in a partial replica with the Unity Version Control CLI.
Read time 2 minutesLast updated 10 months ago
Description
Updates the partial workspace and downloads latest changes.
Usage
cm partial update [<item_path>[ ...]] [--changeset=<number>] [--silent | --report] [--dontmerge] [--xml[=<output_file>]] [--machinereadable [--startlineseparator=<sep>] [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
Options
Option / Argument | Description |
|---|---|
| --changeset | Updates the partial workspace to a specific changeset. |
| --silent | No output is shown unless an error happens. |
| --xml | Prints the output in XML format to the standard output. It is possible to specify an output file. |
| --report | Prints a list of the applied changes when the command is finished. Using '--silent' will override this setting. |
| --dontmerge | Does not merge the file conflicts, it just skips them. The other changes are properly applied. This option can be useful for automation to avoid user interaction. |
| --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. |
| item_path | Items to be updated. Use double quotes (" ") to specify paths containing spaces. Use a whitespace to separate paths. Use . to apply update to current directory. If no path is specified, then the current partial workspace is fully updated. |
Help
Remarks
The 'partial update' command updates the out-of-date files.
The command assumes recursive operation.
If all the specified paths are files inside the same Xlink when using the '--changeset' option, then the versions to download are searched in the specified changeset of the Xlinked repository.
Examples
cm partial update
(Updates all in the current partial workspace.)
cm partial update .
(Updates all current directory children items.)
cm partial update backgroud-blue.png
(Updates 'backgroud-blue.png' item.)
cm partial update soft_black.png soft-grey.png
(Updates 'soft_black.png' and 'soft-grey.png' items.)
cm partial update src --report
(Updates all 'src' directory children items, printing the applied changes list at the end.)
cm partial update src --changeset=4
(Updates all 'src' directory children items to the content they loaded in the changeset 4.)
cm partial update xlink/first.png --changeset=4
(Updates 'xlink/first.png' item to the content it loaded in the changeset 4 of the Xlinked repository.)
cm partial update . --changeset=2 --xml=output.xml 2>errors.txt
(Updates all current directory children items to the content they loaded in the changeset 2, reporting the result in XML format. The output is stored in a file named 'output.xml' and errors are redirected to the file 'errors.txt'. NOTE: redirection syntax rely on the shell.)