Patchwork [2,of,2,evolve-ext] help: try to document evolution states

login
register
mail settings
Submitter timeless
Date May 25, 2016, 8:06 p.m.
Message ID <3f487659db7b74aecf21.1464206815@gcc2-power8.osuosl.org>
Download mbox | patch
Permalink /patch/15206/
State Changes Requested
Headers show

Comments

timeless - May 25, 2016, 8:06 p.m.
# HG changeset patch
# User timeless@gmail.com
# Date 1464206788 0
#      Wed May 25 20:06:28 2016 +0000
# Node ID 3f487659db7b74aecf2142410c063d69e3bec719
# Parent  1452b262ca30f97da1fdc73c2ca6eb70dd79defd
# Available At https://bitbucket.org/timeless/mutable-history/
#              hg pull https://bitbucket.org/timeless/mutable-history/ -r 3f487659db7b
help: try to document evolution states

Patch

diff -r 1452b262ca30 -r 3f487659db7b hgext/evolve.py
--- a/hgext/evolve.py	Wed May 25 19:41:08 2016 +0000
+++ b/hgext/evolve.py	Wed May 25 20:06:28 2016 +0000
@@ -48,6 +48,45 @@ 
 resolution of edge cases arising from multiple users rewriting the same part
 of history concurrently.
 
+Evolution states
+================
+
+stable:
+  Commit is not superseded, has not been pruned, and all ancestors are stable.
+
+  Typically rendered with an `o` in :hg:`log -G`.
+
+obsolete:
+  Changesets that have been superseded or pruned. Extinct if there are no
+  non-extinct descendants. Suspended otherwise.
+
+  Rendered with an `x` in :hg:`log -G`.
+
+extinct:
+  Obsolete changesets with obsolete descendants only.
+
+unstable:
+  Non-obsolete changesets with obsolete ancestors.
+
+suspended:
+  Obsolete changesets with non-obsolete descendants.
+
+Trouble states
+==============
+
+obsolete:
+  Mutable changeset with a newer version.
+
+troubled:
+  Changesets with troubles.
+
+bumped:
+  Mutable changesets marked as successors of public changesets.
+
+divergent:
+  Final successors of changesets with an alternative set of final
+  successors.
+
 Current feature status
 ======================