.

bigarray/array_zodb.py

@@ -19,9 +19,13 @@
 # See COPYING file for full licensing terms.
 # See https://www.nexedi.com/licensing for rationale and options.
 
-"""BigArray that can be persisted ZODB-way
+"""Package array_zodb provides BigArray backed by ZODB.
 
-TODO text
+ZBigArray provides BigArray with data stored in ZODB.
+
+Please see documentation for BigArray (bigarray/__init__.py) and ZBigFile
+(bigfile/file_zodb.py) as ZBigArray is just a minimal glue for those two and
+inherits most of the properties and specifics from its parents.
 """
 
 from wendelin.bigarray import BigArray

bigfile/file_zodb.py

@@ -90,7 +90,6 @@ speed::
       ZBlk0             fast reads      (default)
       ZBlk1             small changes
 
-
 Description of block formats follow:
 
 To represent BigFile as ZODB objects, each file block is represented separately
@@ -124,7 +123,7 @@ access-time and DB size with just client storing 1 object per file block. This
 will be our future approach after we teach NEO about object deduplication.
 """
 
-# file_zodb organization
+# ZBigFile organization
 #
 # As file pages are changed in RAM with changes being managed by virtmem
 # subsystem, we need to propagate the changes to ZODB objects back at some time.
@@ -730,7 +729,7 @@ Connection.open = Connection_open
 class _ZBigFileH(object):
     # .zfile        ZBigFile we were opened for
 #   # .wcfileh      handle for ZBigFile in wcfs | None
-    # .zfileh       handle for ZBigFile (overlayed over .wcfileh if .wcfile != ø)
+    # .zfileh       handle for ZBigFile (overlayed over .wcfileh if .wcfileh != ø)
 
 #   def __init__(self, zfile, wcfileh):
     def __init__(self, zfile, wc):  # wc: wcfs.WCFS | None