.

wcfs/wcfs_test.py

@@ -126,6 +126,9 @@ def test_join_autostart():
 
 
 # ---- infrastructure for data access tests ----
+#
+# Testing infrastructure consists of tDB, tFile, tWatch and tWatchLink that
+# jointly organize wcfs behaviour testing. See individual classes for details.
 
 # many tests need to be run with some reasonable timeout to detect lack of wcfs
 # response. with_timeout and timeout provide syntactic shortcuts to do so.
@@ -452,6 +455,9 @@ class tFile:
     #
     # pinokByWLink: {} tWatchLink -> {} blk -> at.
     # pinokByWLink can be omitted - in that case it is computed only automatically.
+    #
+    # The automatic computation of pinokByWLink is verified against explicitly
+    # provided pinokByWLink when it is present.
     @func
     def assertBlk(t, blk, dataok, pinokByWLink=None):
         #print('assertBlk #%d' % blk)
@@ -839,7 +845,10 @@ class tSrvReq:
 # During setup it verifies that wcfs sends correct initial pins.
 #
 # pinok: {} blk -> rev
-# pinok can be None - in that case it is computed automatically.
+# pinok can be omitted - in that case it is computed automatically.
+#
+# The automatic computation of pinok is verified against explicitly provided
+# pinok when it is present.
 @func(tWatchLink)
 def watch(twlink, zf, at, pinok=None):   # XXX -> tWatch ?
     t = twlink.tdb