The Stream Diff (Files) Tab
(Show Diff By Files command)

Opening a Stream Diff (Files) Tab

Stream Diff (Files) Tab Layout

Working in a Stream Diff (Files) Tab

Commands That Operate on the Selected Version

Commands That Operate on the Overall Element

The Stream Diff (Files) tab displays the element-by-element differences between two streams. Each stream can be a dynamic stream A stream whose configuration changes over time, with new versions promoted from child workspaces and/or from other dynamic streams. It also inherits versions from its parent stream., a snapshot An immutable (frozen, static) stream that captures the configuration of another stream at a particular time. A snapshot cannot be renamed or modified in any way., or a workspace stream The private stream that is built into a workspace. All new versions of elements are originally created in workspaces; AccuRev records these versions in workspace streams.. AccuRev determines the differences by examining the elements' version-ID The unique identifier for a version, consisting of two parts: (1) the name or number of the workspace or stream in which the version was created; (2) an integer. Examples: talon_dvt_mary/14, 245\19.s in each stream. It does not compare the contents of file versions (but you can, using this tab's Show Difference command).

A stream comparison can report these differences

Opening a Stream Diff (Files) Tab

  1. In the Stream Browser, select a stream, snapshot, or workspace.

  2. Choose the Show Diff by Files command from the selection's context menu, or click the button on the Stream Browser's toolbar.

  3. The mouse pointer changes to . Left-click another stream, snapshot, or workspace.

Stream Diff (Files) Tab Layout

The Stream Diff (Files) tab contains a table, each row of which details one element. Above the table is the name of the Destination Stream (the one you selected with the mouse pointer) and Source Stream (the one you selected before invoking the command).

The columns of this table are:

Element #2 (or two columns: Name #2, In Folder #2)

[note A user preference controls whether the element pathnames are displayed in a single column, or in two columns.] The pathname of the same element in the destination stream. If empty, the element is present only in the source stream.

eid #2

The element-ID The unique, immutable integer identifier by which AccuRev tracks the changes to a particular file element or directory element. An element's name or pathname can change, but its element-ID never changes. of the element.

Version #2

The version-ID The unique identifier for a version, consisting of two parts: (1) the name or number of the workspace or stream in which the version was created; (2) an integer. Examples: talon_dvt_mary/14, 245\19. of the destination stream's version of the element.

Element #1 (or two columns: Name #1, In Folder #1)

[note A user preference controls whether the element pathnames are displayed in a single column, or in two columns.] The pathname of the element in the source stream. If empty, the element is present only in the destination stream.

eid #1

Same as eid #2. (The element-ID is immutable. It is unique within the depot, but not within the entire repository.)

Version #1

The version-ID The unique identifier for a version, consisting of two parts: (1) the name or number of the workspace or stream in which the version was created; (2) an integer. Examples: talon_dvt_mary/14, 245\19. of the source stream's version of the element.

Working in a Stream Diff (Files) Tab

In any row of the Stream Diff table, you can left-click to select an element's version in either stream/workspace:

Then, you can invoke a command, using the Stream Diff tab toolbar or the selection's context menu. Some commands operate on the particular version you selected; other commands operate on the overall element.

Commands That Operate on the Selected Version

Open (equivalent to double-click)

Windows: run the appropriate command on the file, according to its file type. [note The Windows file-typing system ("file associations") does not provide for assigning a file type if the filename has no suffix.] UNIX: open a text editor on the file.

View

(text files only) Open a text editor on a temporary copy of the selected version.

Save As

Copy the selected version to another filename.

Commands That Operate on the Overall Element

Browse Versions

Open a Version Browser tab, showing all the versions of the selected element, and their interrelationships (ancestry).

Browse Stream Versions

Open a Stream Version Browser tab for the selected element. This tab displays the depot's stream hierarchy, much like the Stream Browser. But on this tab, each stream represents the version of the specified element that appears in that stream.

Show History

Open a History Browser tab, containing the transactions involving the selected element.

Show Difference

(file elements only) Compares the contents of the two streams' versions of the selected element. [note When analyzing the contents of a workspace, this command always uses the version currently in the workspace stream The private stream that is built into a workspace. All new versions of elements are originally created in workspaces; AccuRev records these versions in workspace streams. (which might be inherited from a higher-level stream). This version differs from the file in the workspace tree The ordinary directory tree, located in the user’s disk storage, in which the user performs development tasks and executes AccuRev commands. if the file has (modified) status.]