# HG changeset patch # User Greg Ward # Date 1446921446 18000 # Node ID 0e8936e7cb89ad9fdc1099e57dbc5f13d2b4daa3 # Parent 0edb2c25f8063c6bf081231cdaf604868593d812 evolve: improve the confusing docstring for _orderrevs() diff -r 0edb2c25f806 -r 0e8936e7cb89 hgext/evolve.py --- a/hgext/evolve.py Sat Nov 07 09:48:04 2015 -0500 +++ b/hgext/evolve.py Sat Nov 07 13:37:26 2015 -0500 @@ -1497,14 +1497,14 @@ def _orderrevs(repo, revs): """Compute an ordering to solve instability for the given revs - - Takes revs a list of instable revisions - - - Returns the same revisions ordered to solve their instability from the + revs is a list of unstable revisions. + + Returns the same revisions ordered to solve their instability from the bottom to the top of the stack that the stabilization process will produce eventually. - This ensure the minimal number of stabilization as we can stabilize each - revision on its final, stabilized, destination. + This ensures the minimal number of stabilizations, as we can stabilize each + revision on its final stabilized destination. """ # Step 1: Build the dependency graph dependencies, rdependencies = builddependencies(repo, revs)