diff docs/evolve-faq.rst @ 325:43a686709ded

doc: readme and uncommit reference

--- a/docs/evolve-faq.rst	Wed Jun 27 12:48:16 2012 +0200
+++ b/docs/evolve-faq.rst	Wed Jun 27 14:48:44 2012 +0200
@@ -93,11 +93,30 @@
 
 you can use amend -c to collapse multiple changeset in a single one.
 
+Getting changes out of a commit
+------------------------------------------------------------
+
+the ``hg uncommit`` commands allow you to rewrite the current commit to not
+include change for some file. The content of target files are not altered on
+disk and back as "modified"::
+
+  $ hg st
+  M babar
+  M celestine
+  $ hg commit babar celestine
+  $ hg st
+  $ hg uncommit celestine
+  $ hg status
+  M celestine
+
 Split a changeset
 -----------------------
 
-There is no official command to split a changeset. However is it easily achieved
-by manual operation::
+I you just want to split whole file, you can just use the ``uncommit`` command.
+
+
+If you need fine grained split, there is no official command for that yet.
+However is it easily achieved by manual operation::
 
   ### you want to split changeset A: 42
   # update to A parent
@@ -169,12 +188,7 @@
 Export to mq: ``synchronize``
 ------------------------------------------------------------
 
-Another extension allows to export.
-
-View change to your file
-------------------------------------------------------------
-
-Another extension allows to export.
+Another extension allows to export. you changes to mq
 
 View diff from the last amend
 ------------------------------------------------------------
@@ -183,7 +197,7 @@
 
 :: 
     [alias]
-    odiff = diff --rev 'limit(obsparents(.),1)' --rev .
+    odiff = diff --rev 'limit(precursors(.),1)' --rev .
 
 View obsolete markers
 ------------------------------------------------------------
@@ -193,6 +207,12 @@
 
     $ hg clone http://hg-dev.octopoid.net/hgwebdir.cgi/hgview/
 
+You can also use a debug command
+
+    $ hg debugsuccessors
+      5eb72dbe0cb4 e8db4aa611f6
+      c4cbebac3751 4f1c269eab68
+
 
 
 Important Note
@@ -203,7 +223,8 @@
 
 Extinct changesets are hidden using the *hidden* feature of mercurial.
 
-Only ``hg log`` and ``hgview`` support it. ``hg glog`` or other visual viewer don't.
+Only ``hg log`` and ``hgview`` support it. ``hg glog`` Only support that since
+2.2. Other visual viewer don't.