Mutable Branches

Author: Gideon Sireling

Repository: http://code.accursoft.com/mutable-branches/

Issue tracker: http://code.accursoft.com/mutable-branches/issues

1. Overview

The mutable-branches extension allows named branches to be renamed, without rewriting history. This is achieved by separating a branch's identity from its name.

2. Renaming Branches

To start renaming branches, create a file called .hgbranches in the root of the working directory, and check it in. Each line in .hgbranches consists of a space-delimited pair such as oldBranch newBranch. If the branch name contains spaces, it should be quoted.

There are no changes to Mercurial's UI, other than not scolding the user when they create a new branch.

3. Local Branches

If the user creates a local branch which they do not intend pushing, it can be recorded in .hg/localbranches. This feature has not yet been implemented.

4. Future Development

Other fields could be added to .hgbranches, such as the branch's description or owner.


CategoryExtensionsByOthers