added comments in cache, thanks Michele

2012-10-10 15:16:21 -05:00
parent eaadd12c0e
commit b3841e19d2
2 changed files with 14 additions and 1 deletions
@@ -1 +1 @@
-Version 2.1.0 (2012-10-10 12:20:21) dev
+Version 2.1.0 (2012-10-10 15:15:45) dev
@@ -46,6 +46,19 @@ class CacheAbstract(object):
    Main function is now to provide referenced api documentation.

    Use CacheInRam or CacheOnDisk instead which are derived from this class.
+    
+    Attentions, Michele says:
+
+    There are signatures inside gdbm files that are used directly
+    by the python gdbm adapter that often are lagging behind in the
+    detection code in python part.
+    On every occasion that a gdbm store is probed by the python adapter, 
+    the probe fails, because gdbm file version is newer.
+    Using gdbm directly from C would work, because there is backward
+    compatibility, but not from python!
+    The .shelve file is discarded and a new one created (with new
+    signature) and it works until it is probed again...
+    The possible consequences are memory leaks and broken sessions.
    """

    cache_stats_name = 'web2py_cache_statistics'