The Streams tab lists streams or displays a Stream Graph that shows the relationships between parent and child streams in a selected depot.
Select a display option by clicking the Show streams in a graph,
list or tree icon:
Search for streams or restrict the streams that are displayed by using a filter:
For the Stream Graph, filter using the Configure the stream graph display.
For more information about filters, see Searching and filtering.
In the Streams tab, the Stream Graph provides a graphical view of stream relationships and provides tools and shortcuts for working with streams.
The graph uses location and color to depict stream types: mainline streams are gray and placed in the middle of the graph, release streams are orange and appear above the mainline, and development streams are blue and appear below.
Status indicators between streams tell you which streams have changes to contribute and where the changes can be copied or merged:
Merge indicator:
Copy indicator:
The arrows are color-coded to indicate status:
For example, the following arrows above the dev-2.1M2
stream indicate that you must update it by merging down from its parent,
after which you can copy up changes to the parent.
The workspace icon indicates the stream you are
currently working in.
You can drag the workspace icon to another stream to switch your workspace to that stream. The Stream field value in the workspace definition changes to the new stream.
In the Stream Graph view, click the filter icon on the
Streams tab toolbar.
The Graph View Options dialog is displayed.
To select the streams you want displayed in the graph, click Select Streams and choose the display option, or check the individual streams that you want displayed in the graph.
You may need to expand the tree within the dialog pane to view the streams you want to select.
To view the actual depot location of the selected streams in the Stream Graph, select Stream Root as your Display stream option.
The full depot path appears in the stream node for each stream:
This is useful if you have parent streams with child task streams that are located in other depots. To change the size of the stream node to accommodate long depot paths, you can move the Stream node width slider. You can also select these display preferences in P4V > Preferences > Streams (Mac) or Edit > Preferences > Streams (Windows).
Click Apply.
The Stream Graph displays the streams that you specified.
(Optional) Click the Graph Navigator icon or
button to open the Graph Navigator dialog, where you can configure
the size of the Stream Graph display and select which portion of the
Stream Graph to view.
Use your mouse or cursor keys on the navigator pane to select the portion of the image you want to view.
Double-click a stream to view a popup that contains status details:
To work in a stream or switch from one stream to another, do one of the following:
Double-click the stream and select Work in this stream.
A warning dialog pops up and asks you to switch workspaces or create
a new one. Click the Switch Workspaces button to switch your
workspace. If more than one workspace is associated with the stream,
the Select Workspace dialog opens, where you can search for
and select the workspace you want. The workspace icon appears on the
stream you are now working in.
If you have set your stream operations preference in the Preferences dialog to use the same workspace when you switch between streams — or you are using P4Sandbox — then P4V does not prompt you to switch workspaces. Instead the workspace view changes to include the stream you are switching to.
Drag the workspace icon from the stream you are currently working in to another stream.
When you switch streams this way, the workspace view changes to include the stream you are switching to, no matter what you set as your stream operations preference.
To create a new development or release branch, you create a child stream from a parent. You can also create virtual siblings of your mainline stream by branching.
You can create task streams by creating a child stream from a parent, but you can also create parentless task streams. For more information about how branch a task stream, see Working with Task Streams.
To create a child stream:
In the Stream:New dialog, define the new stream.
See Creating new streams.
Verify that the new stream appears correctly in the stream graph.
If you have specified the stream type correctly, more stable streams are displayed above the parent and less stable streams below the parent.
You can also reparent streams that have already been branched. To reparent a stream, do one of the following:
You cannot reparent task streams.