Typically, you will want to split a stream under the following conditions:
To fix a bug in an old version of a project, or
To store project variants or a developer's private work in a separate stream.
When splitting a stream you always split at a pre-defined point in time. This is called the initial state of the new stream. When you split a stream, the initial state is always a version.
There are two options for splitting a stream:
Choose this option if you are splitting based on an existing project version. This is often done, for example, to fix a bug in a previous version of your project.
1. |
From the Repositories view, bring up the context menu. Select the New > Stream... menu item to bring up the New Stream wizard. |
2. |
In the New Stream wizard, select the repository that contains the stream you want to split. Enter a name for the new stream. Click the Finish button of the wizard. |
3. |
Add a project version to the new stream (this sets the initial state of the stream). In the Repositories view, select the new stream and from the context menu select the Copy Version To Stream... menu item. A version selection dialog will appear. Select the projects and their versions that you wish to copy to the stream.
|
4. |
Expand the new stream to see the projects. You will see the resources that are in the project version you added to the stream. |
5. |
Select the project you want to add to the workspace. From the context menu, select the Add to Workspace menu item. Changes released from the project will now go to the new stream. Note: If you enable Show Version Info via the drop down menu in the navigator's toolbar, you will see the new stream name shown to the right of the project. |
Sometimes you don't want to release your changes to everyone in the team but would still like to version them. You may want to do this if your changes aren't stable yet or if it will take a long time before you are ready to release them to the team. In this case you will want to create a new stream to release your changes to:
Step |
Action |
---|---|
1. |
First you must create a version of your project from the workspace to capture the state before you made any changes. This version will contain the base versions of the project's resources. The changes you have made from the base versions will later be released to the new stream. Select your project in the Navigator view and from the context menu choose the Version From Workspace menu item. |
2. | Complete the Version Selected Resources dialog (see Versioning Your Project). Whilst versioning, a dialog will warn you of your outgoing changes. This is expected. Review the changes listed in the details window. |
3. |
Create a new stream. From the Repositories view, bring up the context menu. Select the New > Stream... menu item to bring up the New Stream wizard. |
4. | In the New Stream wizard, select the repository that contains the stream you want to split. Enter a name for the new stream. Click the Finish button of the wizard. |
5. |
Add the project version to the new stream (this sets the initial state of the stream). In the Repositories view, select the new stream and from the context menu select the Copy Version To Stream... menu item. A version selection dialog will appear. Select the project and the version created in Step 2. |
6. |
Select the project in the Navigator view and change the sharing of the project to the new stream. See Associating a Project with a Stream. |
7. |
Synchronize the project with the new stream. Your changes will appear as outgoing to the new stream. Release them into the new stream. |
Associating a Project with a Stream
See Merging from a Stream