Mutable History and collaboration

=====================================================================

.. warning:: need heavy update

Single Developer Usage

======================

This tutorial shows how to use evolution to replace the basics of *mq*.

Amending a changeset

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

First there is some setup phase you will understand later.

there is a local repository and a remote one.

  $ cat >> $HGRCPATH << EOF

  > [ui]

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

  > [diff]

  > git = 1

  > [alias]

  > amend = amend -d '0 0'

  > [extensions]

  > hgext.graphlog=

  > hgext.rebase=

  > EOF

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

  $ hg init local

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

  > [paths]

  > remote = ../remote

  > [ui]

  > user = Babar the King

  > EOF

  $ hg init remote

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

  > [paths]

  > local = ../local

  > [ui]

  > user = Celestine the Queen

  > EOF

  $ cd local

You can reopen you eyes.

Now we make a first version of our shopping list.

  $ 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

We share this first version 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"

I now have the following history:

  $ hg log

  d85de4546133 (draft): adding fruit

  4d5dc8187023 (draft): adding condiment

  7e82d3f3c2cb (public): Monthy Python Shopping list

But, I just notice, I made a typo in Banana.

  $ 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 he was not exchanged with the outside. The first one have been exchanged and is an immutable public changeset

  $ hg log

  d85de4546133 (draft): adding fruit

  4d5dc8187023 (draft): adding condiment

  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 log

  0cacb48f4482 (draft): adding fruit

  4d5dc8187023 (draft): adding condiment

  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 Ride of branchy history

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

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

close your eyes

  $ cd ../remote

  $ hg up -q

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

  $ hg ci -m 'SPAM'

  $ cd ../local

open your eyes

  $ 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 the remote head is immutable

  $ hg log

  9ca060c80d74 (public): SPAM

  0cacb48f4482 (draft): adding fruit

  4d5dc8187023 (draft): adding condiment

  7e82d3f3c2cb (public): Monthy Python Shopping list

  $ 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

  387187ad9bd9 (draft): adding fruit

  dfd3a2d7691e (draft): adding condiment

  9ca060c80d74 (public): SPAM

  7e82d3f3c2cb (public): Monthy Python Shopping list

  $ hg log -G

  @  387187ad9bd9 (draft): adding fruit

  |

  o  dfd3a2d7691e (draft): adding condiment

  |

  o  9ca060c80d74 (public): SPAM

  |

  o  7e82d3f3c2cb (public): Monthy Python Shopping list

Removing changeset

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

I add new item to my list

  $ cat >> shopping << EOF

  > car

  > bus

  > plane

  > boat

  > EOF

  $ hg ci -m 'transport'

  $ hg log

  d58c77aa15d7 (draft): transport

  387187ad9bd9 (draft): adding fruit

  dfd3a2d7691e (draft): adding condiment

  9ca060c80d74 (public): SPAM

  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 kill . # . 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

  387187ad9bd9 (draft): adding fruit

  dfd3a2d7691e (draft): adding condiment

  9ca060c80d74 (public): SPAM

  7e82d3f3c2cb (public): Monthy Python Shopping list

Reordering changeset

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

We create two changeset.

  $ 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

  c48f32fb1787 (draft): SPAM SPAM

  8d39a843582d (draft): bathroom stuff

  387187ad9bd9 (draft): adding fruit

  dfd3a2d7691e (draft): adding condiment

  9ca060c80d74 (public): SPAM

  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 change but the bathroom one that i'm not totally happy with yet.

To be able to push "SPAM SPAM" I need a version of "SPAM SPAM" not children 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  # enouth spamm

  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 -Dr 8d39a843582d -d a2fccc2e7b08

  merging shopping

  $ hg phase --draft .

Splitting change

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

To be done (currently achieve with "two commit + debugobsolete")

Collapsing change

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

To be done (currently achieve with "revert + debugobsolete" or "rebase --collapse")

collaboration

====================

sharing mutable changeset

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

To share mutable changeset with other just check that the repo you interact

with is "not publishing". Otherwise you will get the previously observe

behavior where exchanged changeset are automatically published.

  $ cd ../remote

  $ hg -R ../local/ showconfig phases

the localrepo does not have any specific configuration for `phases.publish`. It is ``true`` by default.

  $ hg pull local

  pulling from $TESTTMP/local

  searching for changes

  adding changesets

  adding manifests

  adding file changes

  added 1 changesets with 1 changes to 1 files

  (run 'hg update' to get a working copy)

  $ hg log

  8a79ae8b029e (public): bathroom stuff

  a2fccc2e7b08 (public): SPAM SPAM

  387187ad9bd9 (public): adding fruit

  dfd3a2d7691e (public): adding condiment

  9ca060c80d74 (public): SPAM