PARTIAL UNDO
Undo changes in a partial replica with the Unity Version Control CLI.
Read time 3 minutesLast updated a day ago
Description
Undoes changes in a workspace.Usage
cm partial undo [<path>[ ...]] [--symlink] [-r | --recursive] [<filter>[ ...]] [--silent | --machinereadable [--startlineseparator=<sep>] [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
Options
Option / Argument | Description |
|---|---|
| --symlink | Applies the undo operation to the symlink and not to the target. |
| -r | --recursive | Executes the undo recursively. |
| --silent | Does not show any output. |
| --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. |
| --checkedout | Select checked-out files and directories. |
| --unchanged | Select files whose content is unchanged. |
| --changed | Select locally changed or checked-out files and directories. |
| --deleted | Select deleted files and directories. |
| --moved | Select moved files and directories. |
| --added | Select added files and directories. |
| path | Path of the files or directories to apply the operation to. Use double quotes (" ") to specify paths containing spaces. Use a whitespace to separate paths. If no path is specified, by default the undo operation will take all of the files in the current directory. |
| filter | Applies the specified filter or filters to the given paths. Use a whitespace to separate filters. See the Filters section for more information. |
Help
Remarks
The undo command is dangerous - it undoes work in an irreversible way. Once the undo has finished, it is not possible to recover the previous state of the files and directories affected by it. If no path is specified in the arguments, by default it will undo every change in the current directory, but not recursively.These are equivalent when executed from the /src directory
- src
- file.txt
- code.cs
- /test
- test_a.py
- test_b.py
cm partial undo
cm partial undo *
cm partial undo file.txt code.cs /test
cm partial undo .
If you want the operation to be recursive, you must specify the '-r' flag. To undo all of the changes below a directory (including changes affecting the directory itself):cm partial undo /src file.txt code.cs
If dirpath is a workspace path, every change in the workspace will be undone.cm partial undo dirpath -r
Filters
If no flag is specified, by default, all changes are undone, but the paths can be filtered using one or more of the flags below. If a file or directory matches one or more of the specified kinds of change, all of the changes on said file or directory will be undone. For example, if you specify both '--checkedout' and '--moved', if a file is both checkedout and moved, both changes will be undone.Examples
(Undoes all changes in the current directory recursively. If executed from the workspace's root, undoes all changes in the entire workspace.)cm partial undo . -r
cm partial co file.txt
(Undoes the checkout on file.txt.) echo content >> file.txtcm partial undo file.txt
(Undoes the local change to file.txt.)cm partial undo file.txt
(Undoes changes to the src directory and its files.)cm partial undo src
(Undo changes in every file and directory contained in src, without affecting src.)cm partial undo src/*
(Undo changes to every file or directory that matches *.cs in the current directory.)cm partial undo *.cs
(Undoes changes on every file or directory that matches *.cs in the current directory and every directory below it.)cm partial undo *.cs -r
echo content >> file1.txtcm partial co file1.txt file2.txt
(Undoes the checkout of unchanged file2.txt, ignoring locally changed file1.txt.) echo content >> file1.txt echo content >> file2.txtcm partial undo --unchanged
cm partial co file1.txt
(Undoes the changes in checked-out file file1.txt, ignoring file2.txt as it is not checked-out.)cm partial undo --checkedout
cm partial add file.txt
(Undoes the add of file.txt, making it once again a private file.) rm file1.txt echo content >> file2.txtcm partial undo file.txt
cm partial add file3.txt
(Undoes the file1.txt delete and file3.txt add, ignoring the file2.txt change.)cm partial undo --deleted --added *