add split example
authorPierre-Yves David <pierre-yves.david@logilab.fr>
Wed, 28 Mar 2012 11:24:30 +0200
changeset 188 627dde054cd0
parent 187 6b6dc6feb8f7
child 189 e7d7201e79ce
add split example
docs/evolve-faq.rst
--- a/docs/evolve-faq.rst	Wed Mar 28 11:19:07 2012 +0200
+++ b/docs/evolve-faq.rst	Wed Mar 28 11:24:30 2012 +0200
@@ -93,10 +93,25 @@
 
 you can use amend -c to collapse multiple changeset in a single one.
 
-Split changesets?
+Split changesets
 -----------------------
 
-**TODO: Is it possible to split changesets, for example with record or crecord?**
+There is no official command to split a changeset. However is it easily achieved
+by manual operation::
+
+  ### you want to split changeset A: 42
+  # update to A parent
+  $ hg up 42^
+  # restore content from A
+  $ hg revert -r 42 --all
+  # partially commit the first part
+  $ hg record
+  # commit the second part
+  $ hg commit
+  # informs mercurial of what appened
+  # current changeset (.) and previous one (.) replace A (42)
+  $ hg kill --new . --new .^ 42
+
 
 Move multiple changesets: ``rebase``
 ------------------------------------------------------------