Branching with VP Teamwork Server

In teamwork collaboration, the term trunk refers to your main stream of development.  If you create a new project, you will spend the majority of your time making changes and committing them to the trunk of your repository.

Branch is defined as a copy of work derived from a certain point in the trunk. It sets up an extra space for users to work on and make modifications without disturbing the trunk. As soon as the modifications in branch are done, it can be merged back into the trunk.

To create a branch:

Select Tools > Teamwork > Branch... from the main menu.

Select Branch... from the main menu
Select Branch... from the main menu

When the Create Branch dialog box pops out, enter a name in Branch Name for your new branch and select an option from the drop-down menu. Finally, click OK to confirm.

Create Branch dialog box
Create Branch dialog box

The three options in the drop-down menu are Start working in branch, Checkout branch and Stay in trunk. Selecting Start working in branch means you create, checkout and open a new branch and then start working on it. Selecting Checkout branch means you create and checkout a new branch, but just keep it in repository for working on it later on. Selecting Stay in trunk mean you create a new branch, but do not checkout it out and do not show it in repository either.

After you have finished creating a branch and have committed it, you can merge it back into the trunk.

Select Tools > Teamwork > Merge... from the main menu.

Select Merge... from the main menu
Select Merge... from the main menu

When the Merge dialog box pops out, select a branch you want to merge from. A specified revision of project can be merged by checking From revision and selecting ... button from From revision and To revision respectively. Click OK to confirm selecting.

Merge dialog box
Merge dialog box