docs: change `troubled` references to `unstable`
authorMatt Harbison <matt_harbison@yahoo.com>
Sat, 27 Apr 2019 21:27:54 -0400
changeset 4619 93514c421528
parent 4618 803d32f4e498
child 4620 a05bfdf372fb
docs: change `troubled` references to `unstable` Per https://www.mercurial-scm.org/wiki/CEDVocabulary
docs/concepts.rst
docs/obs-terms.rst
docs/sharing.rst
docs/tutorial/slides.md
--- a/docs/concepts.rst	Sat Apr 27 21:24:18 2019 -0400
+++ b/docs/concepts.rst	Sat Apr 27 21:27:54 2019 -0400
@@ -92,7 +92,7 @@
 think of the traditional parent/child DAG as the first derivative of
 your source code, and the obsolescence DAG as the second derivative.)
 
-Troubled changesets (orphan, bumped, divergent)
+Unstable changesets (orphan, bumped, divergent)
 -----------------------------------------------
 
 Evolving history can introduce problems that need to be solved. For
@@ -133,17 +133,17 @@
 public phase; only mutable changesets are divergent).
 
 The collective term for orphan, bumped, and divergent changeset is
-*troubled*::
+*unstable*::
 
-  troubled = orphan ∪ bumped ∪ divergent
+  unstable = orphan ∪ bumped ∪ divergent
 
-It is possible for a changeset to be in any of the troubled categories
+It is possible for a changeset to be in any of the unstable categories
 at the same time: it might be an orphan and divergent, or bumped and
 divergent, or whatever.
 
-  [diagram: Venn diagram of troubled changesets, showing overlap]
+  [diagram: Venn diagram of unstable changesets, showing overlap]
 
-The presence of troubled changesets indicates the need to run ``hg
+The presence of unstable changesets indicates the need to run ``hg
 evolve``.
 
 Hidden (and visible) changesets
@@ -192,7 +192,7 @@
   hidden = hideable ∖ ancestors((repo ∖ hideable) ∪ blockers)
 
 This will probably be clearer with a worked example. First, here's a
-repository with some obsolete changesets, some troubled changesets,
+repository with some obsolete changesets, some unstable changesets,
 one bookmark, a working copy, and some hidden changesets::
 
         x-x
--- a/docs/obs-terms.rst	Sat Apr 27 21:24:18 2019 -0400
+++ b/docs/obs-terms.rst	Sat Apr 27 21:27:54 2019 -0400
@@ -92,16 +92,16 @@
 |                     |                          |                             |
 |                     +--------------------------+-----------------------------+
 |                     |                          |                             |
-|                     | **troubled**             | **orphan**                  |
+|                     | **unstable**             | **orphan**                  |
 |                     |                          |                             |
-|                     | *troubled*    has        | *orphan* is a changeset     |
+|                     | *unstable*    has        | *orphan* is a changeset     |
 |                     | unresolved issue caused  | with obsolete ancestors.    |
 |                     | by *obsolete* relations. |                             |
 |                     |                          |                             |
 |                     | Possible issues are      | It must be rebased on a     |
-|                     | listed in the next       | non *troubled*    base to   |
+|                     | listed in the next       | non *unstable*    base to   |
 |                     | column. It is possible   | solve the problem.          |
-|                     | for *troubled*           |                             |
+|                     | for *unstable*           |                             |
 |                     | changeset to combine     | (possible alternative name: |
 |                     | multiple issue at once.  | precarious)                 |
 |                     | (a.k.a. divergent   and  |                             |
@@ -151,7 +151,7 @@
 |                     +--------------------------+-----------------------------+
 |                     |                                                        |
 |                     | Mutable changesets which are neither *obsolete* or     |
-|                     | *troubled*    are *"ok"*.                              |
+|                     | *unstable*    are *"ok"*.                              |
 |                     |                                                        |
 |                     | Do we really need a name for it ? *"ok"* is a pretty   |
 |                     | crappy name :-/ other possibilities are:               |
--- a/docs/sharing.rst	Sat Apr 27 21:24:18 2019 -0400
+++ b/docs/sharing.rst	Sat Apr 27 21:27:54 2019 -0400
@@ -509,7 +509,7 @@
 with a spoon?)
 
 In the user guide, we saw examples of *orphan* changesets, which are
-the most common type of troubled changeset. (Recall that a
+the most common type of unstable changeset. (Recall that a
 non-obsolete changeset with obsolete ancestors is an orphan.)
 
 Two other types of instability can happen: *divergent* and
@@ -685,7 +685,7 @@
 2:e011 is now public, so it can't be obsolete. When that changeset was
 obsolete, it made perfect sense for it to have a successor, namely
 Bob's amendment of Alice's fix (changeset 4:fe88). But it's illogical
-for a public changeset to have a successor, so 4:fe88 is troubled:
+for a public changeset to have a successor, so 4:fe88 is unstable:
 it has become *bumped*.
 
   [figure SG07: 2:e011 now public not obsolete, 4:fe88 now bumped]
@@ -701,7 +701,7 @@
 changeset 5:227d—albeit with a software-generated commit message. (Bob
 should probably amend that changeset to improve the commit message.)
 But the important thing is that his repository no longer has any
-troubled changesets, thanks to ``evolve``.
+unstable changesets, thanks to ``evolve``.
 
   [figure SG08: 5:227d is new, formerly bumped changeset 4:fe88 now hidden]
 
@@ -713,7 +713,7 @@
 dull knife (never mind a rusty spoon). At the same time, an
 inattentive or careless user can do harm to himself or others.
 Mercurial with ``evolve`` goes to great lengths to limit the harm you
-can do by trying to handle all possible types of “troubled”
+can do by trying to handle all possible types of “unstable”
 changesets. Nevertheless, having a first-aid kit nearby does not mean
 you should stop being careful with sharp knives.
 
--- a/docs/tutorial/slides.md	Sat Apr 27 21:24:18 2019 -0400
+++ b/docs/tutorial/slides.md	Sat Apr 27 21:27:54 2019 -0400
@@ -1908,7 +1908,7 @@
    split                  (on branch: default, 1 changesets, <span style="color:teal;">492 behind</span>)
    stack_orphan_bug     (on branch: default, 1 changesets, <span style="color:teal;">474 behind</span>)
    tutorial               (on branch: default, 2 changesets, <span style="color:teal;">492 behind</span>)
-<span style="color:green;"> * </span><span style="color:green;">tutorialtypos         </span> (on branch: default, 3 changesets, <span style="color:red;">1 troubled</span>, <span style="color:olive;">2 heads</span>, <span style="color:teal;">2 behind</span>)
+<span style="color:green;"> * </span><span style="color:green;">tutorialtypos         </span> (on branch: default, 3 changesets, <span style="color:red;">1 unstable</span>, <span style="color:olive;">2 heads</span>, <span style="color:teal;">2 behind</span>)
 </pre>
 
 #### Log