.

wcfs/__init__.py

@@ -20,8 +20,10 @@
 
 """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.
+Join(zurl) joins wcfs server for ZODB at zurl and returns WCFS object that
+represents filesystem-level connection to wcfs server. If wcfs server for zurl
+is not yet running, it will be automatically started if join is given
+`autostart=True` option.
 
 The rest of wcfs.py merely wraps C++ wcfs client package:
 
@@ -37,7 +39,7 @@ A path from WCFS to Mapping is as follows:
   Conn.open(foid)                     -> FileH
   FileH.mmap([blk_start +blk_len))    -> Mapping
 
-Please see wcfs/client/wcfs.h for further details.
+Please see wcfs/client/wcfs.h for more thorough overview and further details.
 
 Classes in wcfs module logically mirror classes in ZODB: