[Zope-Checkins] CVS: Zope/lib/python/Products/StandardCacheManagers - RAMCacheManager.py:1.10.68.2

[Paul Winkler]

Update of /cvs-repository/Zope/lib/python/Products/StandardCacheManagers
In directory cvs.zope.org:/tmp/cvs-serv10151/Products/StandardCacheManagers

Modified Files:
      Tag: Zope-2_7-branch
	RAMCacheManager.py 
Log Message:

backport from HEAD: doc fixes for collector 724


=== Zope/lib/python/Products/StandardCacheManagers/RAMCacheManager.py 1.10.68.1 => 1.10.68.2 ===
--- Zope/lib/python/Products/StandardCacheManagers/RAMCacheManager.py:1.10.68.1	Thu Jan  8 18:33:54 2004
+++ Zope/lib/python/Products/StandardCacheManagers/RAMCacheManager.py	Thu Apr 29 16:08:00 2004
@@ -323,7 +323,22 @@
 PRODUCT_DIR = __name__.split('.')[-2]
 
 class RAMCacheManager (CacheManager, SimpleItem):
-    ' '
+    """Manage a RAMCache, which stores rendered data in RAM. 
+
+    This is intended to be used as a low-level cache for
+    expensive Python code, not for objects published
+    under their own URLs such as web pages.
+
+    RAMCacheManager *can* be used to cache complete publishable
+    pages, such as DTMLMethods/Documents and Page Templates, 
+    but this is not advised: such objects typically do not attempt
+    to cache important out-of-band data such as 3xx HTTP responses,
+    and the client would get an erroneous 200 response.
+
+    Such objects should instead be cached with an                             
+    AcceleratedHTTPCacheManager and/or downstream                               
+    caching.
+    """
 
     __ac_permissions__ = (
         ('View management screens', ('getSettings',