Viewing codeline history in the revision graph

The Revision Graph displays file integration history, showing when a file was added, branched, edited, merged, copied, or deleted, or when a revision of the file was undone. You can view multiple Revision Graphs at the same time.

To launch the Revision Graph for a file:

  1. Select a file or folder in the Depot or Workspace tree, or a file or revision in the History tab.

  2. On the toolbar, click Revision Graph icon (hover).

    The Revision Graph opens in a separate window.

Alternatively, you can also right-click any of these entities and select Revision Graph.

Read the revision graph

In the Revision Graph, 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:

p4v revgraph branch

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

p4v revgraph bracket

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 names of the shapes in the legend reflect the action that occurred during the integration and resolve process that created the revision. You can view more details about the actions related to a particular revision by selecting the revision in the graph and then looking at the Integrations tab in the lower left pane. For details on the integration actions, see p4 integrated in the Helix Core Command-Line (P4) Reference.

To view details about a revision, such as the changelist number, date, or action performed, click the Details tab in the lower left pane. To view the changelist (or sync to it or integrate it), click the changelist number in the Details tab or right-click a revision in the graph and select View Changelist.

Navigate the revision graph

To select revisions, click them or use the arrow keys. Details about the selected revision are displayed in the Details tab in the lower left pane. To select two revisions, control-click (Windows) or command-click (Mac) them. In this case, the Navigator and Legend tabs disappear and P4V displays a second set of Details, Integrations, Labels, and Preview tabs in the lower right pane.

For files that have a large history, the 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 tab outlines the portion displayed in the main window.

To navigate the diagram, do one of the following:

  • Drag the box inside the Navigator pane.
  • Use the scrollbars in the main window pane.
  • In the main window pane, use the mouse wheel or middle button.

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 right-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.

Filter the revision graph

To reduce the detail displayed in the main window pane, you can filter the information:

  • To remove a file or folder from the main window, clear the respective check box in the File Filter Tree on the left.
  • To enter a more precise file filter, click Filter Options and enter the file specification for the files and folders you want to retain in the main window pane (or, for files and folders you want to exclude, exclusionary lines preceded by "-"), check any filtering options you want to apply, and then click Filter. To retain this filter in effect for future invocations of the Revision Graph, click Set As Default.

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

  • File Renames Collapsed: Displays the original and renamed files on a single line instead of multiple lines by omitting intervening revisions. An angled arrow indicates the operation, as shown in the following figure.

    rename
  • Compressed Integration History: Displays only revisions that were branched or integrated.

To switch between displaying only ancestors and descendants (linear history), which is the default view, and showing the full revision history, use the branch history button Switch between full and partial history. To change the default behavior, go to Edit > Preferences > Tools. For details, see Tools preferences.

Display details

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

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