Initial setup

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

This Mercurial configuration example is used for testing.

.. Various setup

  $ cat >> $HGRCPATH << EOF

  > [ui]

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

  > [diff]

  > 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

  > amend = amend -d '0 0'

  > [extensions]

  > hgext.graphlog=

  > 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

  ui.slash=True

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

Improved git format diff:

  $ hg showconfig diff

  diff.git=1

And the graphlog extension

  $ hg showconfig extensions

  extensions.hgext.graphlog=

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

  $ $(dirname $TESTDIR)/enable.sh >> $HGRCPATH 2> /dev/null

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

Single Developer Usage

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

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

Fixing mistake with `hg amend`

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

We are versionning 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

  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 glog

  @  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

  # 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 glog

  @  d85de4546133 (draft): adding fruit

  |

  o  4d5dc8187023 (draft): adding condiment

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

hopefully. I can use hg 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 amend

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

  $ hg glog

  @  0cacb48f4482 (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

  # Node ID 0cacb48f44828d2fd31c4e45e18fde32a5b2f07b

  # 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 help made a change remotly.

  $ 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

  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

  |

  | @  0cacb48f4482 (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 -d 9ca060c80d74 -s 4d5dc8187023

  merging shopping

  merging shopping

My local work is now rebased on the remote one.

  $ hg log -G

  @  387187ad9bd9 (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

  @  d58c77aa15d7 (draft): transport

  |

  o  387187ad9bd9 (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 387187ad9bd9

The silly changeset is gone.

  $ hg log -G

  @  387187ad9bd9 (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

  @  c48f32fb1787 (draft): SPAM SPAM

  |

  o  8d39a843582d (draft): bathroom stuff

  |

  o  387187ad9bd9 (draft): adding fruit

  |

  o  dfd3a2d7691e (draft): adding condiment

  |

  o  9ca060c80d74 (public): SPAM

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

.. note: don'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 'rebase -r' or 'graft -O' for that:

  $ hg up 'p1(8d39a843582d)' # going on "bathroom stuff" parent

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

  $ hg graft -O c48f32fb1787 # moving "SPAM SPAM" to the working directory parent

  grafting revision 10

  merging shopping

  $ hg log -G

  @  a2fccc2e7b08 (draft): SPAM SPAM

  |

  | o  8d39a843582d (draft): bathroom stuff

  |/

  o  387187ad9bd9 (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

  # Node ID a2fccc2e7b08bbce6af7255b989453f7089e4cf0

  # Parent  387187ad9bd9d8f9a00a9fa804a26231db547429

  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.

  $ hg phase --force --secret 8d39a843582d

we can now push our change:

  $ hg push remote

  pushing to $TESTTMP/remote

  searching for changes

  adding changesets

  adding manifests

  adding file changes

  added 3 changesets with 3 changes to 1 files

for simplicity shake we get the bathroom change in line again

  $ hg rebase -r 8d39a843582d -d a2fccc2e7b08

  merging shopping

  $ hg phase --draft .

  $ hg log -G

  @  8a79ae8b029e (draft): bathroom stuff

  |

  o  a2fccc2e7b08 (public): SPAM SPAM

  |

  o  387187ad9bd9 (public): adding fruit