Index: openacs-4/packages/xowiki/tcl/form-field-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/xowiki/tcl/form-field-procs.tcl,v
diff -u -r1.288 -r1.289
--- openacs-4/packages/xowiki/tcl/form-field-procs.tcl	18 Sep 2024 14:10:09 -0000	1.288
+++ openacs-4/packages/xowiki/tcl/form-field-procs.tcl	23 Oct 2024 12:14:49 -0000	1.289
@@ -2118,7 +2118,7 @@
     }
 
     #
-    # Make sure that we do not mis-interprete spaces in paths or file
+    # Make sure that we do not mis-interpret spaces in paths or file
     # names in the foreach loop.
     #
     if {[llength ${:content-type}] == 1} {
@@ -3501,7 +3501,7 @@
     #
     # The default for the :preset variable is set to "standard", but
     # may be overridden by subclasses. This provides a hook for
-    # site-wide customization via a tcl proc, which enables to inject
+    # site-wide customization via a Tcl proc, which enables to inject
     # e.g. information coming from the connection context or other tcl
     # commands, not possible via parameter alone.
     #
Index: openacs-4/packages/xowiki/tcl/package-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/xowiki/tcl/package-procs.tcl,v
diff -u -r1.335 -r1.336
--- openacs-4/packages/xowiki/tcl/package-procs.tcl	11 Sep 2024 06:15:56 -0000	1.335
+++ openacs-4/packages/xowiki/tcl/package-procs.tcl	23 Oct 2024 12:14:49 -0000	1.336
@@ -10,6 +10,11 @@
 
 namespace eval ::xowiki {
   nx::Object create ::xowiki::CSS {
+    #
+    # CSS property manager. This class is used for agnostic handling
+    # of icons, CSS class names, or styling preferences of a
+    # subsite/instance.
+    #
     :public object method clear {} {
       #
       # Clear the cached toolkit name, such that it is reloads the
Index: openacs-4/packages/xowiki/tcl/xowiki-mode-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/xowiki/tcl/xowiki-mode-procs.tcl,v
diff -u -r1.6 -r1.7
--- openacs-4/packages/xowiki/tcl/xowiki-mode-procs.tcl	11 Sep 2024 06:15:56 -0000	1.6
+++ openacs-4/packages/xowiki/tcl/xowiki-mode-procs.tcl	23 Oct 2024 12:14:49 -0000	1.7
@@ -10,7 +10,6 @@
 namespace eval ::xowiki {
 
   nx::Class create ::xowiki::Mode {
-
     #
     # Mode handler to set for the current session some application
     # specific mode (like e.g. admin-mode, developer-mode,
@@ -63,6 +62,10 @@
   # Create a sample "admin" mode handler.
   #
   ::xowiki::Mode create ::xowiki::mode::admin {
+    #
+    # Sample admin mode handler object to toggle "admin" mode on and
+    # off.
+    #
     :public object method default {} {
       # Admins are per default in admin-mode
       return [::xo::cc permission \
Index: openacs-4/packages/xowiki/tcl/xowiki-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/xowiki/tcl/xowiki-procs.tcl,v
diff -u -r1.546 -r1.547
--- openacs-4/packages/xowiki/tcl/xowiki-procs.tcl	8 Oct 2024 15:16:27 -0000	1.546
+++ openacs-4/packages/xowiki/tcl/xowiki-procs.tcl	23 Oct 2024 12:14:49 -0000	1.547
@@ -656,7 +656,15 @@
         -package_key xowiki \
         -parameter Cache \
         -default_size 600000 \
-        -partitions 2
+        -partitions 2 {
+          #
+          # Xowiki cache. This partitioned cache is used for various
+          # caching purposes for xowiki. It is used for example for
+          # caching includlets (when requested), or for full file
+          # names of xowiki::File objects.  In case of bottlenecks,
+          # increase the number of partitions and the cache size.
+          #          
+        }
   }
 
   #############################
Index: openacs-4/packages/xowiki/tcl/test/xowiki-test-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/xowiki/tcl/test/xowiki-test-procs.tcl,v
diff -u -r1.2 -r1.3
--- openacs-4/packages/xowiki/tcl/test/xowiki-test-procs.tcl	3 Sep 2024 15:37:55 -0000	1.2
+++ openacs-4/packages/xowiki/tcl/test/xowiki-test-procs.tcl	23 Oct 2024 12:14:49 -0000	1.3
@@ -1463,7 +1463,7 @@
 
                 #
                 # On a standard installation, the page title is set to
-                # the (potentially unvalidated) FormPage title. Here
+                # the (potentially no yet validated) FormPage title. Here
                 # we make sure that our injection attempt has not been
                 # rendered "raw" to the client.
                 #