.

setup.py

@@ -254,7 +254,7 @@ setup(
                    #   specify either to use e.g. ZODB3.10 or ZODB4 )
                    'ZODB3 >= 3.10',
 
-                   'pygolang >= 0.0.5', # defer, sync.WaitGroup, ...
+                   'pygolang >= 0.0.5', # defer, sync.WaitGroup, pyx/nogil channels ...
 
                    'six',       # compat py2/py3
 

wcfs/__init__.py

@@ -18,17 +18,27 @@
 # See COPYING file for full licensing terms.
 # See https://www.nexedi.com/licensing for rationale and options.
 
-"""Module wcfs.py provides python gateway for spawning and interoperating with wcfs server
+"""Module wcfs.py provides python gateway for spawning and interoperating with wcfs server.
 
 Join(zurl) joins wcfs server. If wcfs server for zurl is not yet running, it
 will be automatically started if `autostart=True` is passed to join.
 It will also be automatically started by default unless
 $WENDELIN_CORE_WCFS_AUTOSTART=no is specified in environment.
 
+WCFS represents filesystem-level connection to wcfs server. XXX created by join.
+Conn represents logical connection that provides view of data on wcfs
+filesystem as of particular database state.
+
 WCFS represents connection to wcfs server obtained by join.
 FileH ... XXX
 XXX
 
+Classes in wcfs module logically mirror classes in ZODB:
+
+    wcfs.WCFS   <->  ZODB.DB
+    wcfs.Conn   <->  ZODB.Connection
+
+
 $WENDELIN_CORE_WCFS_AUTOSTART
 $WENDELIN_CORE_WCFS_OPTIONS
 """
@@ -74,8 +84,8 @@ class WCFS(object):
     # ._proc        wcfs process if it was opened by this WCFS | None
     pass
 
-# Conn represents logical connection viewing data on wcfs filesystem as of
-# particular database state.
+# Conn represents logical connection that provides view of data on wcfs
+# filesystem as of particular database state.
 #
 # It uses /head/bigfile/* and notifications received from /head/watch to
 # maintain isolated database view while at the same time sharing most of data
@@ -96,7 +106,6 @@ class Conn(object):
     #
     # ._pinWG
     # ._pinCancel
-
     pass
 
 # _File represent isolated file view under Conn.