HISTORY
View history with the Unity Version Control CLI.
Read time 3 minutesLast updated 8 days ago
Description
Displays the history of a file or directory.
Usage
cm history | hist <item_path>[ ...] [--long | --format=<str_format>] [--symlink] [--xml[=<output_file>]] [--encoding=<name>] [--moveddeleted]
Options
Option / Argument | Description |
|---|---|
| Shows additional information. |
| Retrieves the output message in a specific format. See Remarks for more info. This option cannnot be combined with |
| Applies the history operation to the symlink and not to the target. |
| Prints the output in XML format to the standard output. It is possible to specify an output file. This option cannot be combined with |
| Used with the |
| Include move and remove operations in the history. |
| Displays the N most recent revisions for the specified items, sorted by date and changeset id. If a negative number is supplied, it will return an empty list. If a number higher than the number of revisions is supplied, it will return all the available revisions regarding that item. |
| Item's path. Use a whitespace to separate paths. Use double quotes ( |
Help
Remarks
This command shows a list of revisions for a given item, and label, branch, and comment info for each revision.
Output format parameters (--format option
)
--format optionThis command accepts a format string to show the output. The output parameters of this command are the following:
Option / Argument | Description |
|---|---|
| Date. |
| Changeset number. |
| Branch. |
| Comment. |
| Owner. |
| Revision id. |
| Repository. |
| Server. |
| Repository spec. |
| Availability of the revision data. |
| Path or spec passed as |
| Item Id. |
| Size. |
| Hash code. |
| Inserts a tab space. |
| Inserts a new line. |
Examples
Displays the history of two files in the current directory. Use double quotes for paths that contain spaces.
cm history file1.txt "file 2.txt"
Displays the history of a file in a subfolder of the workspace. The path is relative to the current directory.
cm history Assets\Scripts\PlayerController.cs
Displays the history of a file by using its full local path.
cm history c:\workspace\Assets\Scripts\PlayerController.cs
On macOS and Linux, use forward slashes in the path.
cm history Assets/Scripts/PlayerController.cs
Displays the history of a folder.
cm history Assets\Scripts
Displays all information.
cm hist c:\workspace --long
Applies the history operation to the symlink file and not to the target.
cm history link --symlink
Retrieves the revision history from a server path in a given branch.
cm history serverpath:/Assets/Scripts/PlayerController.cs#br:/main/task001@myserver
Retrieves the last two revisions for and .
PlayerController.csGameManager.cscm history PlayerController.cs GameManager.cs --long --limit=2