P4V User Guide (2017.1)

Each revision of a file is represented by a shape. The shape denotes the action that created the revision. For example, the following shape indicates that the revision was created by branching the file:

When multiple revisions contribute to an integration, Revision Graph displays a bracket below the contributing revision, as shown in the following figure:

To display details about the meaning of the shapes and the lines that connect them, click the Legend tab in the lower right pane.

The top bar of the revision graph displays the changelist that created the file revision. To view the changelist (or sync to it or integrate it), context-click the changelist number.

To select revisions, click them or use the arrow keys. Details about the selected revision are displayed in the lower right-hand pane. To select multiple revisions, control-click (Windows) or command-click (Mac) them.

For files that have a large history, Revision Graph displays a portion of the graph in its main window, and a map of the graph in the lower left Navigator tab. A box in the Navigator outlines the portion displayed in the main window.

To navigate the diagram, do one of the following:

To zoom in or out, move the slider in the toolbar or hold down the CTRL key and use the mouse wheel.

Highlighting shows the revisions that have contributed content to the selected revision or received content from it. To highlight file revisions, select the revision of interest and choose an option from the Highlight menu.

To diff two revisions, drag one revision to another or select the revisions, then context-click and choose Diff Revisions.

To move a line of revisions up or down: select it and click CTRL-up arrow or CTRL-down arrow.

To reduce the detail displayed in the main window, you can filter the information. To remove a file or folder from the main window, uncheck it in the File Filter tree.

To enter a more precise file filter, click Advanced…​ and enter the file specification for the files and folders you want to retain in the main window (or, for files and folders you want to exclude, exclusionary lines preceded by "-"), check any filtering options you want to apply, then click Filter. To retain this filter in effect for future invocations of Revision Graph, click Set as Default.

To further compress the detail displayed in the main window, toggle the options on the View menu as follows:

To compress file rename operations by omitting intervening revisions, choose View > File Renames Collapsed. Revision Graph displays the original and renamed file, indicating the operation with an angled arrow, as follows:

To display details about a file revision, click the revision in the main window. Details are displayed in the lower left pane.

Related revisions are listed on the Integrations tab. To get the revision, diff it, or display its history, context-click the revision on the Integration tab. To view integrated revisions in the main window, click the corresponding icon on the Integrations tab.