.

wcfs/internal/wcfs_test.pyx

@@ -20,7 +20,8 @@
 # cython: language_level=2
 # distutils: language=c++
 
-"""Module wcfs_test complements wcfs_test.py with things that are not to implement in Python"""
+"""Module wcfs_test.pyx complements wcfs_test.py with things that cannot be
+implemented in Python."""
 
 from posix.signal cimport sigaction, sigaction_t, siginfo_t, SA_SIGINFO
 from libc.signal cimport SIGBUS

wcfs/wcfs.go

@@ -31,13 +31,17 @@
 // head/bigfile/<bigfileX> which represents always latest bigfile data.
 // Clients that want to get isolation guarantee should subscribe for
 // invalidations and re-mmap invalidated regions to file with pinned bigfile revision for
-// the duration of their transaction. See "Isolation protocol" for details.
+// the duration of their transaction(*). See "Isolation protocol" for details.
 //
 // In the usual situation when bigfiles are big, and there are O(1)/δt updates,
 // there should be no need for any cache besides shared kernel cache of latest
 // bigfile data.
 //
-// XXX reference to wcfs client library.
+// --------
+//
+// (*) wcfs servers comes accompanied by Python and C++ client packages that take
+// care about isolation protocol details and provide to clients simple
+// interface similar to regular files.
 //
 //
 // Filesystem organization