Merge Dialog

Introduction

With the Merge dialog you can merge changes from a branch line to the main line. For example, a fix that you applied in a maintenance branch line can be merged back to the main line so that you do not have to apply the fix by hand again. Also if you completed developing a large feature in a separate branch line you can use merge to incorporate that feature into the main line.

To access the Merge dialog, open Version Control menu > Merge Changes Here:

The following merge scenarios are supported:

Port Fix

This merge scenario allows you to merge a fix from a maintenance branch line to the main line. If you just want to merge a small fix, a single commit is often enough. It is however also possible to merge multiple commits at once.

Branch Line

Choose the branch line from which you want to merge the fix.

One Revision / Multiple Revisions

Choose whether you want to merge just a single commit or a whole range of commits from the maintenance branch line. In the latter case both the start and end revisions must be selected. The start revision is the revision with the lowest number and the end revision is the revision with the highest number. Note that all revisions that are contained within the specified range are merged.

Merge Feature Branch

This merge scenario allows you to merge a complete feature branch line to the main line.

Branch Line

Choose the branch line that you want to merge. It’s not necessary to select individual revisions in this case, because all revisions of the branch line are merged automatically.

Advanced Merge

This scenario may be used for merge actions that are only needed in exceptional circumstances. Use this option with caution.

While normally you would only merge (revisions of) a branch line to the main line, the advanced merge scenario offers the possibility to merge from the main line to a branch line, or from one branch line to another.

Branch Line

Choose the branch line that you want to merge, or select ‘Main line’ when you want to merge (revisions of) the main line to the current branch line.

Start / End Revision

Select the start revision (revision with the lowest number) and the end revision (revision with the highest number) of the range you want to merge. If you want to merge all commits of the selected branch line, simply select the first and the last revision of the branch. It’s not necessary to select the ‘Create branch’ revision.