changeset 3795:b8b4ff86feb8

evolve: add a help topic `Interrupted-Evolve` This help topic contains description on how the various flags work during interrupted evolve. This help topic will be included in error message during interrupted evolve in next patch.
author Pulkit Goyal <7895pulkit@gmail.com>
date Wed, 23 May 2018 01:11:59 +0530
parents b89108d3eca0
children ededd22e7c7b
files hgext3rd/evolve/__init__.py hgext3rd/evolve/evolvecmd.py
diffstat 2 files changed, 44 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/hgext3rd/evolve/__init__.py	Tue Jun 05 03:37:15 2018 +0200
+++ b/hgext3rd/evolve/__init__.py	Wed May 23 01:11:59 2018 +0530
@@ -182,6 +182,28 @@
         successor
       - "successors" a sorted list of locally know successors node ids
       - "markers" the raw list of changesets.
+
+Interrupted-Evolve
+==================
+
+The `hg evolve` command is an all purpose tool that solve all kind of
+instabilities in your repository. Sometimes, instability resolution will lead
+to merge conflict that cannot be solved without a human intervention (same as
+`hg merge`). This can lead to an "interrupted state" where human assistance is
+requested. There are three things which you can do when you face a similar
+situation:
+
+  - `hg evolve --continue`:
+     fix all the conflicts using `hg resolve` and then run this to continue the
+     interrupted evolve
+
+  - `hg evolve --stop`:
+     stops the current interrupted evolve,. keeping all the successful steps,
+     but delaying to resolution of the remaining step for later.
+
+  - `hg evolve --abort`:
+     aborts the interrupted evolve and undoes all the resolution which have
+     happened
 """
 
 evolutionhelptext = """
--- a/hgext3rd/evolve/evolvecmd.py	Tue Jun 05 03:37:15 2018 +0200
+++ b/hgext3rd/evolve/evolvecmd.py	Wed May 23 01:11:59 2018 +0530
@@ -1202,6 +1202,28 @@
     You can also use the evolve command to list the troubles affecting your
     repository by using the --list flag. You can choose to display only some
     categories of troubles with the --unstable, --divergent or --bumped flags.
+
+    Interrupted-Evolve
+    ==================
+
+    The `hg evolve` command is an all purpose tool that solve all kind of
+    instabilities in your repository. Sometimes, instability resolution will lead
+    to merge conflict that cannot be solved without a human intervention (same as
+    `hg merge`). This can lead to an "interrupted state" where human assistance is
+    requested. There are three things which you can do when you face a similar
+    situation:
+
+      - `hg evolve --continue`:
+         fix all the conflicts using `hg resolve` and then run this to continue the
+         interrupted evolve
+
+      - `hg evolve --stop`:
+         stops the current interrupted evolve,. keeping all the successful steps,
+         but delaying to resolution of the remaining step for later.
+
+      - `hg evolve --abort`:
+         aborts the interrupted evolve and undoes all the resolution which have
+         happened
     """
 
     opts = _checkevolveopts(repo, opts)