=============================Mutable History For Mercurial=============================Evolve Extension=================This package supplies the ``evolve`` extension for Mercurial,**The full implementation of the changeset evolution concept is still inprogress.** Please subscribe to the `evolve-testers mailing list<https://www.mercurial-scm.org/mailman/listinfo/evolve-testers>`_ to stay up todate with changes.This extension:* enables the “changeset evolution” feature of Mercurial core,* provides a set of commands to mutate your history,* issues several warning messages when troubles from some mutable appears in your repository,* provides an ``hg evolve`` command to deal with such "troubles",* improves performance of obsolescence marker exchanges and discovery during push and pull.Documentation-------------We recommend reading the documentation first. An online version isavailable here: https://www.mercurial-scm.org/doc/evolution/How to Install==============Using Pip---------You can install the latest evolution version usin pip:: $ pip install --user hg-evolveThen just enable it in you hgrc:: $ hg config --edit # adds the two line below: [extensions] evolve =From Source-----------To install a local version from source:: $ hg clone https://www.mercurial-scm.org/repo/evolve/ $ cd evolve $ pip install --user .Then just enable it in you hgrc:: $ hg config --edit # adds the two line below: [extensions] evolve =Documentation lives in ``doc/``.Server Only Setup=================It is possible to enable a smaller subset of the extensions aimed at serverserving repository. It skips the additions of the new commands and local UImessages that might add performance overheads. To use the server onlyextension, install the package and use:: $ hg config --edit # adds the two line below: [extensions] evolve.serveronly =Extension Purpose=================The goal of this extension is to provide an appropriate place for code andconcept related to changeset evolution to mature. In this extension we allowfor hackier code, unlocking quick experimentation and faster iterations.In addition, the evolve extensions support a wider set of Mercurial version,allowing us to reach a larger user base for feedback. The Evolve extension isnot tight to the Mercurial release cycle and can release new feature and bugfix at a higher rate if necessary.Once a concept is ready enough, its implementation is moved into Mercurialcore. The maturation period helped us to get a clearer picture of what wasneeded. During the upstreaming process, we can use this clearer picture toclean up the code and upgrade it to an appropriate quality for Mercurial core.How to Contribute=================Discussion happens on the #hg-evolve IRC on freenode_... _freenode: https://freenode.net/Bugs are to be reported on the mercurial's bug tracker (component: `evolution`_):.. _evolution: https://bz.mercurial-scm.org/buglist.cgi?component=evolution&query_format=advanced&resolution=---You can use the patchbomb extension to send email to `mercurial devel<https://www.mercurial-scm.org/mailman/listinfo/mercurial-devel>`_. Please makesure to use the evolve-ext flag when doing so. You can use a command likethis:: $ hg email --to mercurial-devel@mercurial-scm.org --flag evolve-ext --rev '<your patches>'Some of development happens on a public bitbucket repository (`evolve-devel`_) using the topic extension... _`evolve-devel`: https://bitbucket.org/octobus/evolve-develFor guidelines on the patch description, see the `official Mercurial guideline`_... _`official Mercurial guideline`: https://mercurial-scm.org/wiki/ContributingChanges#Patch_descriptionsPlease don't forget to update and run the tests when you fix a bug oradd a feature. To run the tests, you need a working copy of Mercurial,say in $HGSRC:: $ cd tests $ python $HGSRC/tests/run-tests.pyBranch policy-------------The evolve test are highly impacted by changes in core. To deal with this, we use named branches.There are two main branches: "stable" and "default". Tests on these branch aresupposed to pass with the corresponding "default" and "stable" branch from coreMercurial. The documentation is built from the tip of stable.In addition, we have compatibility branches to check tests on older version ofMercurial. They are the "mercurial-x.y" branches. They are used to applyexpected test change only, no code change should happen there.test output change from a changeset in core should adds the following line to their description:CORE-TEST-OUTPUT-UPDATE: <CORE-NODE-ID>