Initial setup

-------------

This Mercurial configuration example is used for testing.

.. Various setup

  $ cat >> $HGRCPATH << EOF

  > [ui]

  > # This is change the default output of log for clear tutorial

  > logtemplate ="{node|short} ({phase}): {desc}\n"

  > [diff]

  > # use "git" diff format, clearer and smarter format

  > git = 1

  > [alias]

  > # "-d '0 0'" means that the new commit will be at January 1st 1970.

  > # This is used for stable hash during test

  > # (this tutorial is automatically tested.)

  > amend = amend -d '0 0'

  > EOF

  $ hg init local

  $ cat >> local/.hg/hgrc << EOF

  > [paths]

  > remote = ../remote

  > other = ../other

  > [ui]

  > user = Babar the King

  > EOF

  $ hg init remote

  $ cat >> remote/.hg/hgrc << EOF

  > [paths]

  > local = ../local

  > [ui]

  > user = Celestine the Queen

  > EOF

  $ hg init other

  $ cat >> other/.hg/hgrc << EOF

  > [ui]

  > user = Princess Flore

  > EOF

This tutorial uses the following configuration for Mercurial:

A compact log template with phase data:

  $ hg showconfig ui | grep log

  ui.logtemplate="{node|short} ({phase}): {desc}\n"

Improved git format diff:

  $ hg showconfig diff

  diff.git=1

And of course, we enable the experimental extensions for mutable history:

  $ cat >> $HGRCPATH <<EOF

  > [extensions]

  > evolve = $TESTDIR/../hgext/evolve.py

  > # enabling rebase is also needed for now

  > rebase =

  > EOF

-----------------------

Single Developer Usage

-----------------------

This tutorial shows how to use evolution to rewrite history locally.

Fixing mistake with `hg amend`

--------------------------------

We are versioning a shopping list

  $ cd local

  $ cat  >> shopping << EOF

  > Spam

  > Whizzo butter

  > Albatross

  > Rat (rather a lot)

  > Jugged fish

  > Blancmange

  > Salmon mousse

  > EOF

  $ hg commit -A -m "Monthy Python Shopping list"

  adding shopping

Its first version is shared with the outside.

  $ hg push remote

  pushing to $TESTTMP/remote (glob)

  searching for changes

  adding changesets

  adding manifests

  adding file changes

  added 1 changesets with 1 changes to 1 files

Later I add additional item to my list

  $ cat >> shopping << EOF

  > Egg

  > Suggar

  > Vinegar

  > Oil

  > EOF

  $ hg commit -m "adding condiment"

  $ cat >> shopping << EOF

  > Bananos

  > Pear

  > Apple

  > EOF

  $ hg commit -m "adding fruit"

This history is very linear

  $ hg log -G

  @  d85de4546133 (draft): adding fruit

  |

  o  4d5dc8187023 (draft): adding condiment

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

But a typo was made in Babanas!

  $ hg export tip

  # HG changeset patch

  # User test

  # Date 0 0

  #      Thu Jan 01 00:00:00 1970 +0000

  # Node ID d85de4546133030c82d257bbcdd9b1b416d0c31c

  # Parent  4d5dc81870237d492284826e21840b2ca00e26d1

  adding fruit

  diff --git a/shopping b/shopping

  --- a/shopping

  +++ b/shopping

  @@ -9,3 +9,6 @@

   Suggar

   Vinegar

   Oil

  +Bananos

  +Pear

  +Apple

The faulty changeset is in the "draft" phase because it has not been exchanged with

the outside. The first one has been exchanged and is "public" (immutable).

  $ hg log -G

  @  d85de4546133 (draft): adding fruit

  |

  o  4d5dc8187023 (draft): adding condiment

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

hopefully. I can use `hg commit --amend` to rewrite my faulty changeset!

  $ sed -i'' -e s/Bananos/Banana/ shopping

  $ hg diff

  diff --git a/shopping b/shopping

  --- a/shopping

  +++ b/shopping

  @@ -9,6 +9,6 @@

   Suggar

   Vinegar

   Oil

  -Bananos

  +Banana

   Pear

   Apple

  $ hg commit --amend

A new changeset with the right diff replace the wrong one.

  $ hg log -G

  @  9d0363b81950 (draft): adding fruit

  |

  o  4d5dc8187023 (draft): adding condiment

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

  $ hg export tip

  # HG changeset patch

  # User test

  # Date 0 0

  #      Thu Jan 01 00:00:00 1970 +0000

  # Node ID 9d0363b81950646bc6ad1ec5de8b8197ea586541

  # Parent  4d5dc81870237d492284826e21840b2ca00e26d1

  adding fruit

  diff --git a/shopping b/shopping

  --- a/shopping

  +++ b/shopping

  @@ -9,3 +9,6 @@

   Suggar

   Vinegar

   Oil

  +Banana

  +Pear

  +Apple

Getting rid of branchy history

----------------------------------

While I was working on my list. someone made a change remotely.

  $ cd ../remote

  $ hg up -q

  $ sed -i'' -e 's/Spam/Spam Spam Spam/' shopping

  $ hg ci -m 'SPAM'

  $ cd ../local

I'll get this remote changeset when pulling

  $ hg pull remote

  pulling from $TESTTMP/remote (glob)

  searching for changes

  adding changesets

  adding manifests

  adding file changes

  added 1 changesets with 1 changes to 1 files (+1 heads)

  (run 'hg heads' to see heads, 'hg merge' to merge)

I now have a new heads. Note that this remote head is immutable

  $ hg log -G

  o  9ca060c80d74 (public): SPAM

  |

  | @  9d0363b81950 (draft): adding fruit

  | |

  | o  4d5dc8187023 (draft): adding condiment

  |/

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

instead of merging my head with the new one. I'm going to rebase my work

  $ hg diff

  $ hg rebase --dest 9ca060c80d74 --source 4d5dc8187023

  rebasing 1:4d5dc8187023 "adding condiment"

  merging shopping

  rebasing 4:9d0363b81950 "adding fruit"

  merging shopping

My local work is now rebased on the remote one.

  $ hg log -G

  @  41aff6a42b75 (draft): adding fruit

  |

  o  dfd3a2d7691e (draft): adding condiment

  |

  o  9ca060c80d74 (public): SPAM

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

Removing changesets

------------------------

I add new item to my list

  $ cat >> shopping << EOF

  > car

  > bus

  > plane

  > boat

  > EOF

  $ hg ci -m 'transport'

  $ hg log -G

  @  1125e39fbf21 (draft): transport

  |

  o  41aff6a42b75 (draft): adding fruit

  |

  o  dfd3a2d7691e (draft): adding condiment

  |

  o  9ca060c80d74 (public): SPAM

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

I have a new commit but I realize that don't want it. (transport shop list does

not fit well in my standard shopping list)

  $ hg prune . # "." is for working directory parent

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  working directory now at 41aff6a42b75

  1 changesets pruned

The silly changeset is gone.

  $ hg log -G

  @  41aff6a42b75 (draft): adding fruit

  |

  o  dfd3a2d7691e (draft): adding condiment

  |

  o  9ca060c80d74 (public): SPAM

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

Reordering changesets

------------------------

We create two changesets.

  $ cat >> shopping << EOF

  > Shampoo

  > Toothbrush

  > ... More bathroom stuff to come

  > Towel

  > Soap

  > EOF

  $ hg ci -m 'bathroom stuff' -q # XXX remove the -q

  $ sed -i'' -e 's/Spam/Spam Spam Spam/g' shopping

  $ hg ci -m 'SPAM SPAM'

  $ hg log -G

  @  fac207dec9f5 (draft): SPAM SPAM

  |

  o  10b8aeaa8cc8 (draft): bathroom stuff

  |

  o  41aff6a42b75 (draft): adding fruit

  |

  o  dfd3a2d7691e (draft): adding condiment

  |

  o  9ca060c80d74 (public): SPAM

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

.. note:: We can't amend changeset 7e82d3f3c2cb or 9ca060c80d74 as they are immutable.

 I now want to push to remote all my changes except the bathroom one, which I'm

 not totally happy with yet. To be able to push "SPAM SPAM" I need a version of

 "SPAM SPAM" which is not a child of "bathroom stuff"

You can use the 'grab' alias for that.

.. note: grab is an alias for `hg rebase --dest . --rev <target>; hg up <there>`

  $ hg up 'p1(10b8aeaa8cc8)' # going on "bathroom stuff" parent

  1 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ hg grab fac207dec9f5 # moving "SPAM SPAM" to the working directory parent

  rebasing 10:fac207dec9f5 "SPAM SPAM" (tip)

  merging shopping

  ? files updated, 0 files merged, 0 files removed, 0 files unresolved (glob)

  $ hg log -G

  @  a224f2a4fb9f (draft): SPAM SPAM

  |

  | o  10b8aeaa8cc8 (draft): bathroom stuff

  |/

  o  41aff6a42b75 (draft): adding fruit

  |

  o  dfd3a2d7691e (draft): adding condiment

  |

  o  9ca060c80d74 (public): SPAM

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

We have a new SPAM SPAM version without the bathroom stuff

  $ grep Spam shopping  # enough spam

  Spam Spam Spam Spam Spam Spam Spam Spam Spam

  $ grep Toothbrush shopping # no Toothbrush

  [1]

  $ hg export .

  # HG changeset patch

  # User test

  # Date 0 0

  #      Thu Jan 01 00:00:00 1970 +0000

  # Node ID a224f2a4fb9f9f828f608959912229d7b38b26de

  # Parent  41aff6a42b7578ec7ec3cb2041633f1ca43cca96

  SPAM SPAM

  diff --git a/shopping b/shopping

  --- a/shopping

  +++ b/shopping

  @@ -1,4 +1,4 @@

  -Spam Spam Spam

  +Spam Spam Spam Spam Spam Spam Spam Spam Spam

   Whizzo butter

   Albatross

   Rat (rather a lot)

To make sure I do not push unready changeset by mistake I set the "bathroom

stuff" changeset in the secret phase.