Revision Graph

Revision Graph displays file integration history, showing when a file was added, branched, edited, integrated, and deleted. To launch Revision Graph, context-click a file or folder in the Depot pane, Workspace pane, or Revision History dialog and choose Revision Graph.

Reading 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, 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.


Navigating 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 (Macintosh) 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:

To zoom in or out, move the slider in the toolbar or use the mouse wheel.

To highlight file revisions that are direct ancestors or descendents of the selected file revision, click and choose the relationships you want to highlight. Highlighting show the revisions that have contributed content to the selected revision or received content from it.

To diff two revisions, drag one revision in the main window and drop it on another or select the two revisions and click .

Filtering the Revision Graph

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 exclusionary lines, preceded by "-", for files and folders you want to exclude), 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, click and enable one or more of the following options:

Displaying Details

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

On the Integrations tab, related revisions are listed. 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.