Branching

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 Teamwork > Branch... from the main menu.

When the Create Branch dialog box pops out, enter a name in Branch Name for your new branch and decide whether to work on the created branch now or later by selecting the appropriate option from the drop-down menu. You can create branch from a specific revision of trunk by selecting Specific revision in the repository and entering the revision number. On the other hand, select HEAD revision in the repository if you want to create a branch from the latest revision in trunk. Finally, click OK button to confirm.

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 Teamwork > Merge... from the main menu.

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

Merge dialog box