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
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
A file element has been modified in one or both streams. [note ]
An element has been renamed in one or both streams.
A new element has been added to one of the workspaces (Add to Depot command) or streams (Promote command)
An element has been removed from one of the streams (Defunct command).
In the Stream Browser, select a stream, snapshot, or workspace.
Choose the Show Diff by Files command from the selection's context menu, or click the button on the Stream Browser's toolbar.
The mouse pointer changes to . Left-click another stream, snapshot, or workspace.
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 ] 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 ] 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.
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.
Open (equivalent to double-click)
Windows: run the appropriate command on the file, according to its file type. [note ] 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.
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.
(file elements only) Compares the contents of the two streams' versions of the selected element. [note ]