.

wcfs/testprog/treegen.py

@@ -44,7 +44,8 @@ Tree states are specified on stdin as topology-encoded strings, 1 state per 1 li
 For every request the tree is changed and modifications are committed to database.
 For every made commit corresponding transaction ID is printed to stdout.
 
-The tree, that `treegen trees` works on, is also accessible via zconn.root()['treegen/tree'].
+The tree, that `treegen trees` generates and works on, is also accessible via
+zconn.root()['treegen/tree'].
 
 Trees protocol specification:
 
@@ -71,10 +72,12 @@ allstructs
 `treegen allstructs` generates topologies for subset of all possible tree
 changes in between two trees specified by two key->value dicts.
 
-For every kv the following tree topologies are used: 1) native (the one that
-ZODB would usually create natively via regular usage), and 2) n random ones.
-Then tree topologies are emitted corresponding to tree1->tree2 and tree1<-tree2
-transitions for all combinations of (tree1, tree2) pairs.
+For every kv the following tree topologies are considered: 1) native (the one
+that ZODB would usually create natively via regular usage), and 2) n random
+ones. Then tree topologies are emitted corresponding to tree1->tree2 and
+tree1<-tree2 transitions for all combinations of (tree1, tree2) pairs.
+
+The output of `treegen allstructs` is valid input for `treegen trees`.
 
 Allstructs protocol specification: