Index: openacs-4/packages/acs-tcl/tcl/acs-cache-init.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-tcl/tcl/acs-cache-init.tcl,v
diff -u -r1.2 -r1.3
--- openacs-4/packages/acs-tcl/tcl/acs-cache-init.tcl	3 Sep 2024 15:37:34 -0000	1.2
+++ openacs-4/packages/acs-tcl/tcl/acs-cache-init.tcl	23 Oct 2024 10:28:48 -0000	1.3
@@ -1,10 +1,24 @@
 #
-# The acs::misc_cache is a potential successor of the util_memoize_cache,
-# but in a partitioned fashion to make it scalable. It should only be
-# used for situation, where not wild-card flushes are required.
+# The acs::misc_cache is a successor of the util_memoize_cache, but in
+# a partitioned fashion to make it scalable. It should only be used
+# for situation, where no wild-card flushes are required.
 #
 set cacheType [expr {[::acs::icanuse "ns_hash"] ? "HashKeyPartitionedCache" : "Cache"}]
 ::acs::$cacheType create ::acs::misc_cache \
     -package_key acs-tcl \
     -parameter MiscCache \
-    -default_size 100KB
+    -default_size 100KB {
+        #
+        # Generic cache. This cache is a successor of the
+        # util_memoize_cache, but in a partitioned fashion to make it
+        # scalable. It should only be used for situation, where no
+        # wild-card flushes are required.        
+    }
+
+
+# Local variables:
+#    mode: tcl
+#    tcl-indent-level: 4
+#    indent-tabs-mode: nil
+# End:
+
Index: openacs-4/packages/acs-tcl/tcl/acs-permissions-init.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-tcl/tcl/acs-permissions-init.tcl,v
diff -u -r1.4 -r1.5
--- openacs-4/packages/acs-tcl/tcl/acs-permissions-init.tcl	3 Sep 2024 15:37:34 -0000	1.4
+++ openacs-4/packages/acs-tcl/tcl/acs-permissions-init.tcl	23 Oct 2024 10:28:48 -0000	1.5
@@ -1,6 +1,6 @@
 #
 # Create permission caches. The sizes can be tailored in the config
-            # file like the following:
+# file like the following:
 #
 # ns_section ns/server/${server}/acs/acs-tcl
 #   ns_param PermissionCacheSize        100KB
@@ -10,7 +10,12 @@
     -package_key acs-tcl \
     -parameter PermissionCache \
     -default_size 100KB \
-    -partitions 2
+    -partitions 2 {
+        #
+        # Permission cache. This partitioned cache manages partition caching.
+        # In case of bottlenecks, increase the number of partitions and the cache size.
+        #
+    }
 
 
 # Local variables: