Differences between revisions 10 and 11
Revision 10 as of 2013-06-01 10:38:44
Size: 2522
Editor: adsl-ull-38-234
Comment: better installation instructions
Revision 11 as of 2013-08-26 09:15:27
Size: 416
Editor: LonaRosa
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#pragma section-numbers 2
= Evolve Extension =
'''This extension is not distributed along with Mercurial releases'''

''Author: Pierre-Yves David for Logilab''

<<TableOfContents>>


/!\ 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

== 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/

== 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

== 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

== 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
Most of the name of the writer is Lakesha and she totally loves this name. The thing she adores most is acting but she's been taking on new things these days. Bookkeeping is her profession and she's doing pretty good financially. For a while she's been in Wisconsin. She is working out and maintaining a blog here: http://lopezonzz.tumblr.com/post/58999329627/how-i-built-a-cpanel-hosting-environment-on-aws-part-3

Most of the name of the writer is Lakesha and she totally loves this name. The thing she adores most is acting but she's been taking on new things these days. Bookkeeping is her profession and she's doing pretty good financially. For a while she's been in Wisconsin. She is working out and maintaining a blog here: http://lopezonzz.tumblr.com/post/58999329627/how-i-built-a-cpanel-hosting-environment-on-aws-part-3

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