help: add examples to phases topic stable
authorMatt Mackall <mpm@selenic.com>
Fri, 27 Jan 2012 18:43:41 -0600
branchstable
changeset 16011 f2c49d9dee57
parent 16010 c7811ca6fb94
child 16015 2494a8b42dfb
help: add examples to phases topic
mercurial/help/phases.txt
--- a/mercurial/help/phases.txt	Fri Jan 27 13:12:56 2012 -0600
+++ b/mercurial/help/phases.txt	Fri Jan 27 18:43:41 2012 -0600
@@ -58,4 +58,23 @@
   Servers running older versions of Mercurial are treated as
   publishing.
 
-See :hg:`help phase` for information on manually manipulating phases.
+Examples
+--------
+
+ - list changesets in draft or secret phase::
+
+     hg log -r "not public()"
+
+ - change all secret changesets to draft::
+
+     hg phase --draft "secret()"
+
+ - forcibly move the current changeset and descendants from public to draft::
+
+     hg phase --force --draft .
+
+ - show a list of changeset revision and phase::
+
+     hg log --template "{rev} {phase}\n"
+
+See :hg:`help phase` for more information on manually manipulating phases.