docs/index.rst
changeset 163 92b073d13f2d
parent 161 4e3f25ba5401
child 164 c81d286c4a5b
equal deleted inserted replaced
162:1a6ae8d8f104 163:92b073d13f2d
     6 Here are various Materials on planned improvement to mercurial regarding
     6 Here are various Materials on planned improvement to mercurial regarding
     7 rewriting mutable history.
     7 rewriting mutable history.
     8 
     8 
     9 The effort is splitted in two part:
     9 The effort is splitted in two part:
    10 
    10 
    11  * The **obsolete marker** concept that
    11  * The **obsolete marker** concept aiming to provide and alternative to strip to
    12  
    12    get ride of changesets.
    13  
       
    14  
       
    15     add an alternative to strip to remove changeset from a repository.
       
    16 
    13 
    17  * The changeset evolution UI
    14  * A mercurial extension: **evolve** that rewrite using *obsolete marker*
    18 
    15    under the hood.
    19     to replace mq.
       
    20  
       
    21  
       
    22  adding in mercurial core an new concept of **obsolete marker** in mercurial
       
    23    core,
       
    24 
       
    25  * 
       
    26 
    16 
    27 
    17 
       
    18 regarding mercurial internals, the first and most important step is the
       
    19 **obsolete marker**. However most user will never be directly exposed to the
       
    20 concept. For this reason document about changeset evolution are put first.
    28 
    21 
    29 
    22 
       
    23 Evolve: A robust alternative to MQ
       
    24 ====================================
    30 
    25 
    31 Evolve: A new UI to replace MQ
       
    32 =================================
       
    33 
    26 
    34 For user
    27 * Using the obsolete marker concept, (see next section for advantage of the
       
    28   obsolete marker)
       
    29 
       
    30 * provide a more robust alternative for mq covering any usage but guard.
       
    31 
       
    32 ..warning:: The evolve extention and the obsolete marker are at an experimental
       
    33             stage. While using obsolet you'll likely be exposed to complexe
       
    34             implication of the **obsolete marker** concept. I do not recommend
       
    35             non power user to test this at this stage.
       
    36 
       
    37             Production ready version should hide such details to normal user.
       
    38 
       
    39 To enable the evolve extension use::
       
    40 
       
    41     $ hg clone http://hg-dev.octopoid.net/hgwebdir.cgi/mutable-history/
       
    42     $ mutable-history/enable.sh > ~/.hgrc
       
    43 
       
    44 
    35 
    45 
    36 .. toctree::
    46 .. toctree::
    37    :maxdepth: 1
    47    :maxdepth: 1
    38 
    48 
    39    evolve-intro
       
    40    tutorial
    49    tutorial
    41    evolve-faq
    50    evolve-faq
    42    from-mq
    51    from-mq
    43 
    52 
    44 A new UI to replace MQ
    53 A new UI to replace MQ