.

wcfs/internal/xbtree/xbtreetest/testing.go

@@ -58,7 +58,7 @@ func N(short, medium, long int) int {
 
 // NewRand returns new random-number generator and seed that was used to initialize it.
 //
-// The seed can be controlled via -randseed optiong.
+// The seed can be controlled via -randseed option.
 func NewRand() (rng *rand.Rand, seed int64) {
 	seed = *randseedFlag
 	if seed == -1 {

wcfs/internal/xbtree/xbtreetest/treegen.go

@@ -182,6 +182,14 @@ func StartAllStructsSrv() (_ *AllStructsSrv, err error) {
 
 
 // Commit creates new commit with underlying tree changed to specified tree topology.
+//
+// The following topologies are treated specially:
+//
+//	- "ø" requests deletion of the tree, and
+//	- "øf" requests deletion of ZBigFile, that is referencing the tree.
+//	- "t<kv> D<data-kv>" changes both tree natively, and ZBlk data objects.
+//
+// see treegen.py for details.
 func (tg *TreeSrv) Commit(tree string) (_ zodb.Tid, err error) {
 	defer xerr.Contextf(&err, "tree.srv %s: commit %s", tg.zurl, tree)
 

wcfs/internal/xbtree/xbtreetest/treegen.py

@@ -65,7 +65,9 @@ session example:
     S: 03d85dd871718899
     ...
 
-XXX describe ø command
+The following topology is treated specially:
+
+    - "ø" requests deletion of the tree.
 
 
 allstructs
@@ -114,7 +116,12 @@ session example:
 ΔFtail support
 --------------
 
-XXX describe øf and `t... D...` commands.
+In addition to pure-tree mode, the following topologies are treated specially
+by `treegen trees`:
+
+    - "øf" requests deletion of ZBigFile, that is referencing the tree,
+    - "t<kv> D<data-kv>" changes both tree natively, and ZBlk data objects
+      referenced via root['treegen/values'].
 
 
 --------
@@ -195,7 +202,7 @@ class ZCtx(object):
         zctx.valdict = valdict
         commit('treegen/values: init %r' % valv, skipIfEmpty=True)
 
-    # close release resources associated with zctx.
+    # close releases resources associated with zctx.
     def close(zctx):
         zctx.zconn.close()
         zctx.db.close()

wcfs/internal/xbtree/xbtreetest/xbtreetest.go

@@ -18,7 +18,6 @@
 // See https://www.nexedi.com/licensing for rationale and options.
 
 // Package xbtreetest provides infrastructure for testing LOBTree with ZBlk values.
-// XXX -> treetest?
 package xbtreetest
 
 import (

wcfs/internal/xzodb/xzodb.go

@@ -126,7 +126,7 @@ func IsErrNoData(err error) bool {
 	}
 }
 
-// XidOf return string representation of object xid.
+// XidOf returns string representation of object xid.
 func XidOf(obj zodb.IPersistent) string {
 	if obj == nil || reflect.ValueOf(obj).IsNil() {
 		return "ø"