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.

To launch the Revision Graph, right-click a file or folder in the Depot pane, Workspace pane, or Revision History dialog and select Revision Graph.

Read 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:

When multiple revisions contribute to an integration, the 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), right-click the changelist number.

Navigate the revision graph

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, 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 checkbox in the File Filter Tree.
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, 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 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.
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.

Display details

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, right-click the revision on the Integration tab. To view integrated revisions in the main window, click the corresponding icon on the Integrations tab.