Branching

This is a Mercurial plugin that enables simpler branch management. Because named branches were only recently added, feature branch workflows that rely heavily on named branches can use a little extra love.

1. Status

This extension is not distributed with Mercurial.

Author: John C Barstow

Repository: https://bitbucket.org/jbowtie/hg-branching

Web page: https://bitbucket.org/jbowtie/hg-branching

2. Overview

This extension adds a small number of commands to make working with named branches more convenient.

harvest

$ hg harvest BRANCH_NAME [TARGET_BRANCH]

Close the specified branch and merge it into the default branch, or the named target branch. If the merge fails, you will need to resolve and commit the merge manually.

close

$ hg close BRANCH_NAME

Close the specified branch. This command does not affect your working directory.

switch

$ hg switch BRANCH_NAME

Switch to the specified branch. This is essentially an alias of hg update -C.

branchdiff

$ hg branchdiff BRANCH_NAME

Shows all the branch changes consolidated into a single diff. Technically this is a diff between the branch creation point and the tip of the branch.

3. Configuration

Configure your .hgrc to enable the extension by adding following lines:

[extensions]
branching = /path/to/branching


CategoryExtensionsByOthers

BranchingExtension (last edited 2013-09-04 16:27:37 by mpm)