Displaying revision history

This section explains how to view the revision history of a file, folder, or changelist. For information on file revisions in labels, see Retrieve file revisions in a label

P4V displays a file's revision history, including integration and label history, on the History tab. This tab works in conjunction with the Depot or Workspace tree. P4V gets all file revisions for the file path or directory selected in the tree, up to the selected changelist. If a file revision is currently in your workspace, it is indicated with a red box: p4v file rev have edit.

Files

To display a file’s revision history:

  1. Select a file in the Depot or Workspace tree.

  2. Do one of the following:

    • From the View menu, select History.
    • Right-click and choose File History.

    The History tab opens, listing the revision history for the selected file.

From here, you can:

  • Get a selected revision into your workspace: Right-click a revision on the History tab or a file inside a changelist on the Submitted tab and choose Get This Revision.
  • Get a different revision into your workspace: Right-click a file on the History tab, in the Depot tree, or in the Workspace tree, and choose Get Revision. In the Get Revision dialog, specify the revision you want to get, any applicable options, and click Get Revision.
  • View a preview of a revision’s content: Select the revision on the History tab; then select the Preview tab at the bottom of the Details pane. This shows a preview of any file at any revision. You can resize this tab to view a larger version of the file.

  • Display branching history: Click branchhistory and choose the desired history from the drop-down menu.

    If the file is an image, you can view thumbnails of the image by selecting View > Show Files As and selecting the thumbnail size that you want to view.

  • Compare two file revisions: Click and drag one revision to the other. P4V launches the file diff utility and displays the differences.

Folders

To display a folder’s revision history:

  1. Select a folder in the Depot or Workspace tree.

  2. Do one of the following:

    • From the View menu, select History.
    • Right-click and choose File History.

    The History tab opens, listing the revision history for the selected folder.

From here, you can:

  • Compare two folder revisions: Click and drag one revision to the other. P4V launches the Folder Diff Utility.

Changelists

You can get revisions of a changelist from the Submitted tab. Note that this works independently from the Depot or Workspace tree. In the Submitted tab, P4V gets the revision of all the files in the changelist at the specified changelist, regardless of which file or folder is selected in the tree on the left.

To display a changelist's revision history:

  1. From the View menu, select Submitted Changelists.

    P4V opens the Submitted tab, listing submitted changelists.

  2. Do one of the following:

    • To get the revision of all files in a changelist: Right-click the changelist and choose Get Revisions for Files in Changelist <xyz>.
    • To get the revision of all files in multiple changelists: Right-click the selected changelists and choose Get Revisions for Files in Changelists.
    Warning

    These options immediately force-syncs the files of the respective changelist or changelists to your workspace client. There is no intermediary step that provides you the option to cancel the operation.

    Alternatively, to get a different revision of a changelist into your workspace, right-click the changelist and choose Get Revision. In the Get Revision dialog, specify the files you want to get, the revision number, any applicable options, and click Get Revision.