Differences between revisions 9 and 10
Revision 9 as of 2013-06-01 10:04:52
Size: 2242
Editor: adsl-ull-38-234
Comment: added double quoting to get variable interpolation in bash and "-e" option to echo to get escape sequence right. Also leading '\n' because you never know.
Revision 10 as of 2013-06-01 10:38:44
Size: 2522
Editor: adsl-ull-38-234
Comment: better installation instructions
Deletions are marked like this. Additions are marked like this.
Line 48: Line 48:

Setting up the evolve extension is simple:
First you have to download the extension code. Pick a directory {{{<dir>}}} in your working environment, {{{cd}}} into that and clone evolve. Like this:
Line 52: Line 51:
  $ hg clone https://bitbucket.org/marmoute/mutable-history -u stable
  $ echo -e "\n[extensions]\nevolve=$PWD/mutable-history/hgext/evolve.py" >> ~/.hgrc
$ cd <dir>
$
hg clone https://bitbucket.org/marmoute/mutable-history -u stable
}}}

Then configure your ''`.hgrc`'' to enable the extension by adding the following lines (remember to replace {{{<dir>}}} with the path where you just cloned the extension):

{{{
[extensions]
evolve = <dir>/mutable-history/hgext/evolve.py

Evolve Extension

This extension is not distributed along with Mercurial releases

Author: Pierre-Yves David for Logilab

/!\ This feature is experimental, to be used only by experienced Mercurial users that understand the underlying concepts

Code repository: https://bitbucket.org/marmoute/mutable-history

1. Introduction

The evolve extension is an experimental implementation of the ChangesetEvolution concept. Most of its content has been moved into core except:

  • additional history rewriting commands
  • the evolve command to automatically solve troubles
  • some user interface warning messages related to obsolete changeset troubles

/!\ The evolve extension enables the ChangesetEvolution feature, changing some of Mercurial's default behavior.

  • history rewriting commands do not strip changesets anymore; they make them obsolete.
  • history rewriting commands will work on any changesets, possibly creating unstable changesets.
  • pull and push exchange obsolescence data with other evolve-enabled repositories - this may have a performance impact!

Current official home page: http://hg-lab.logilab.org/doc/mutable-history/html/

2. Additional Commands

uncommit
extracts changes from a commit into the working directory
fold
gathers changes from multiple changesets into a single one
prune
discards changesets (using obsolescence markers)
touch
replaces a changeset with a different one containing the same payload, but with a different hash
gdown
moves to the parent of the current changeset
gup
moves to the child of the current changeset
evolve
automatically resolves troubles affecting changesets

3. Additional UI Messages

  • a warning is issued when the current working directory parent becomes obsolete
  • a warning is issued when a command results in more troubled changesets

4. Setup

First you have to download the extension code. Pick a directory <dir> in your working environment, cd into that and clone evolve. Like this:

$ cd <dir>
$ hg clone https://bitbucket.org/marmoute/mutable-history -u stable

Then configure your .hgrc to enable the extension by adding the following lines (remember to replace <dir> with the path where you just cloned the extension):

[extensions]
evolve = <dir>/mutable-history/hgext/evolve.py

/!\ Evolve requires the latest Mercurial version: 2.5

EvolveExtension (last edited 2017-08-30 12:42:33 by RyanMcElroy)