# HG changeset patch # User Pierre-Yves David # Date 1332778929 -7200 # Node ID c81d286c4a5bc63cb4dead61bc9d3eb53afd5a02 # Parent 92b073d13f2d184d4e8015f50a80568d4aa4e5a7 improved intro about evolve diff -r 92b073d13f2d -r c81d286c4a5b docs/index.rst --- a/docs/index.rst Wed Mar 21 19:09:24 2012 +0100 +++ b/docs/index.rst Mon Mar 26 18:22:09 2012 +0200 @@ -6,7 +6,7 @@ Here are various Materials on planned improvement to mercurial regarding rewriting mutable history. -The effort is splitted in two part: +The effort split in two part: * The **obsolete marker** concept aiming to provide and alternative to strip to get ride of changesets. @@ -23,13 +23,34 @@ Evolve: A robust alternative to MQ ==================================== +Evolve is an experimental history rewriting extensions that use the obsolete +marker. It is inspired from MQ and pbranch but have multiple advantage over +them. -* Using the obsolete marker concept, (see next section for advantage of the - obsolete marker) +* sticks to "Work where you are" philosophy (I'll need better wording + for that) + +* Handle any kind history. Even history with branch and merge. + +* Use robust mercurial's merge mechanism + + simple conflict are handled by real merge tools using appropriate ancestor. + Conflict are much rarer and much more user friendly. -* provide a more robust alternative for mq covering any usage but guard. +* All mutable history available at the same time + + You are do not need to unapply and apply patche to access various part of you + history. -..warning:: The evolve extention and the obsolete marker are at an experimental +* Use plain changeset only. Evole create and exchange real changeset only. + Mutable history can be used in all usual operation 'pull, push, log, diff …) + +* Allow sharing and collaborating mutable history without fear of duplicate. + (thanks to obsolete marker). + +* Cover all mq usage but guard. + +.. warning:: The evolve extention and the obsolete marker are at an experimental stage. While using obsolet you'll likely be exposed to complexe implication of the **obsolete marker** concept. I do not recommend non power user to test this at this stage. @@ -42,7 +63,6 @@ $ mutable-history/enable.sh > ~/.hgrc - .. toctree:: :maxdepth: 1