Initially, the StreamBrowser displays all of the depot's currently active dynamic streams, along with workspaces for the current user. It does not display any snapshots, nor any item that you have deactivated with the
Remove command.
Note: If you have applied a Stream Favorite, only a subset of the streams in the depot appear.
A Stream Favorite is a way to limit the
stream hierarchy shown in the StreamBrowser to the
stream path of a specific stream and all its children. See
Using Stream Favorites on page 143 for more information.
The
Filter Users/Groups 
button on the main AccuRev toolbar allows you to restrict the set of users and groups displayed in the StreamBrowser and other locations in the AccuRev GUI. See
Filter Users/Groups (Tools > Filter > Users/Groups Command) on page 36 for more information.
Tip: You can also create
Stream Favorites to limit the
stream hierarchy shown in the StreamBrowser and any list of streams available in the AccuRev GUI. See
Using Stream Favorites on page 143 for more information.
In the graphical display mode, each stream that has "children" (workspaces and/or snapshots) is displayed with an expand/collapse control. Collapsing causes the entire hierarchy below the stream to disappear from the screen. This affects the StreamBrowser display only. It does not affect the operation of the stream in any way.
If the Enable StreamBrowser History preference is checked (
AccuRev Preferences (Tools > Preferences Command) on page 38), a set of
history controls are added to the toolbar. This enables you to view the stream hierarchy as it existed at any point in the past.

The StreamBrowser can show the development activity currently taking place in each stream or workspace.

A control below the stream or workspace opens or closes a subwindow that displays the details of the development activity. The activity details can appear in several ways --
by element,
by transaction, or
by issue record.
Use the development-activity mode controls at the right side of the StreamBrowser toolbar to determine how the activity details will be displayed. (The icons on the controls below the streams and workspace change accordingly.) You can change modes either before or after opening an activity subwindow.

•
|
workspace: the intersection of the results of a Default Group search and the results of a Pending search
|
See Active Versions vs. Pending Changes in a Workspace on page 128 for more information on the relationship (and differences) between these two searches.

When displaying a stream's activity by element, the subwindow displays the transactions that created the versions that are currently active in the stream. This display is the same as that in the Summary pane of an Active Transaction tab; see
The Active Transactions Tab (Show Active Transactions command) on page 167. You can select one or more transactions and perform commands on them, just as in the Active Transactions tab.
When displaying a stream's activity by issue record, the subwindow displays the issue records that are in a particular stream. This display is the same as that in the Issues pane of a Stream Issues tab (see
The Stream Issues and Stream Diff (Issues) Tabs on page 156). You can select one or more issue records and perform commands on them, just as in the Stream Issues tab.
AccuRev lets you change the backing stream (parent stream) of any dynamic stream or workspace. The StreamBrowser makes it simple: you just drag-and-drop a stream or workspace from its current location in the hierarchy to its new parent.

The entire subhierarchy moves to the new location. Changing a data structure's location in the stream hierarchy is called
reparenting. If the StreamBrowser display contains many streams or the stream structure is very complex, an alternative method of reparenting a stream is to select
Reparent from the context menu of the stream or workspace, then navigate to and click the new parent stream. You are asked to confirm the operation.
Important: After you change the location of a workspace, be sure to
Update it. This ensures that the workspace contains the correct set of versions, many of which it will inherit from its new parent. Likewise, after changing the location of a stream, all workspaces in the subhierarchy below that stream should be
Update'd.
If you reparent a time-based stream, AccuRev asks whether you wish to retain the basis time or remove it.
Although you can give a new name to an existing stream, you cannot proceed to create a new stream with the old name. The old name remains associated with its stream. The only way to reuse a stream name is to completely remove the stream's depot from the AccuRev repository, using the AccuRev administration utility,
maintain.
By default, a stream inherits all versions from its parent, no matter when those versions were created. If you assign a
basis time to a stream, it inherits only those versions created before the specified point in time. (The File Browser's
include/exclude facility provides another way to restrict which versions get inherited from the parent stream.)
The context menu of any data structure in the StreamBrowser includes commands for creating new structures at that point in the hierarchy.
New Stream and
New Snapshot display dialogs similar to that of
Change Stream. The
New Workspace command invokes a wizard that steps you through the process of defining a new workspace: you specify a name and a location on disk; you can also make some optional settings, such as controlling how line endings in text files are to be handled.
Using a File Browser tab, display the entire contents of the selected stream, snapshot, or workspace.
After confirmation, hide the selected stream, snapshot, or workspace. This removes the object from the StreamBrowser display.
Undo a Remove command for the selected stream, snapshot, or workspace.
Open a WIP tab, displaying the active elements in workspaces and/or streams related to the selected stream.
(Workspace only) Using an Overlaps tab: for active file elements (those in the workspace's default group), display all overlaps involving versions in the workspace's entire backing chain (higher-level streams) -- not just overlaps between the workspace and its immediate parent stream.
Element mode: open a File Browser tab on the selected stream, and execute a search for active elements.
Transaction mode: open an Active Transactions tab, showing the transactions that created the versions currently in the selected stream's default group.
Issue Record mode: open a Stream Issues tab, showing the change packages that have been (partially or completely) incorporated into the selected stream.
The way the three commands appear on a stream's context menu varies with the development-activity mode: the command for the current mode appears at the top-level of the context menu; the commands for the other two modes are in a submenu. For example, the following illustration shows how the menu choices appear if the StreamBrowser is currently displaying activity by issue record.
Using a History Browser, display the transactions that created versions in the selected stream.
Using a Stream Issues window, show the differences between the selected stream and another stream (which AccuRev prompts you to specify). The differences are shown in terms of change packages instead of individual elements.
Using a Patch List tab, list all the individual versions whose changes are in the selected stream, but are not in another stream (which AccuRev prompts you to specify).