.

wcfs/client/client_test.py

@@ -94,6 +94,7 @@ def fhpinned(t, fh):
     return p
 
 # test_wcfs_virtmem unit-tests virtmem layer of wcfs client.
+# XXX naming confusing: virtmem layer is not used here
 @func
 def test_wcfs_virtmem():
     t = tDB(); zf = t.zfile; at0=t.at0
@@ -163,6 +164,3 @@ def test_wcfs_virtmem():
     # XXX wconn.open()      after wconn.close() -> error
     # XXX wconn.resync()    after wconn.close() -> error
     # XXX all fileh / mappings become invalid after wconn.close
-
-
-

wcfs/client/wcfs.h

@@ -20,10 +20,11 @@
 // Package wcfs provides WCFS client integrated with user-space virtual memory manager.
 //
 // This client package takes care about WCFS isolation protocol details and
-// provides to clients simple interface to isolated file data similar to
-// regular files: given a particular revision of database @at, it provides
-// synthetic read-only bigfile mappings with data corresponding to @at state,
-// but using /head/bigfile/* most of the time to build and maintain the mappings.
+// provides to clients simple interface to isolated view of bigfile data on
+// WCFS similar to regular files: given a particular revision of database @at,
+// it provides synthetic read-only bigfile memory mappings with data
+// corresponding to @at state, but using /head/bigfile/* most of the time to
+// build and maintain the mappings.
 //
 // For its data a mapping to bigfile X mostly reuses kernel cache for
 // /head/bigfile/X with amount of data not associated with kernel cache for
@@ -33,7 +34,7 @@
 // the kernel cache for /head/bigfile/* is being used almost 100% of the time.
 //
 // A mapping for bigfile X @at is built from OS-level memory mappings of
-// on-WCFS files as
+// on-WCFS files as follows:
 //
 //                                           ___        /@revA/bigfile/X
 //         __                                           /@revB/bigfile/X
@@ -90,7 +91,7 @@
 //
 // --------
 //
-// (*) see wcfs.go documentation for overview and details of WCFS isolation protocol.
+// (*) see wcfs.go documentation for WCFS isolation protocol overview and details.
 // (+) see also XXX -> virtmem docs about layering
 
 #ifndef _NXD_WCFS_H_