Index: openacs-4/packages/acs-templating/tcl/data-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-templating/tcl/data-procs.tcl,v
diff -u -N -r1.23.2.3 -r1.23.2.4
--- openacs-4/packages/acs-templating/tcl/data-procs.tcl	7 Oct 2019 13:54:58 -0000	1.23.2.3
+++ openacs-4/packages/acs-templating/tcl/data-procs.tcl	7 Oct 2019 16:49:45 -0000	1.23.2.4
@@ -524,8 +524,8 @@
     message_ref
 } {
   Checks whether the submitted value is contained in the list of values provided via 
-  the "-options" paramater of "::template::element::create". If the 
-  paramter "-options" is not set on the element, the value is validated as "text".
+  the "-options" parameter of "::template::element::create". If the 
+  parameter "-options" is not set on the element, the value is validated as "text".
 
   @param value_ref Reference variable to the submitted value
   @param message_ref Reference variable for returning an error message
Index: openacs-4/packages/acs-templating/tcl/element-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-templating/tcl/element-procs.tcl,v
diff -u -N -r1.37.2.4 -r1.37.2.5
--- openacs-4/packages/acs-templating/tcl/element-procs.tcl	5 Jul 2019 10:55:04 -0000	1.37.2.4
+++ openacs-4/packages/acs-templating/tcl/element-procs.tcl	7 Oct 2019 16:49:45 -0000	1.37.2.5
@@ -101,14 +101,16 @@
                           are allowed (checkbox groups and multiselect widgets)
 
     @option validate      A list of custom validation blocks in the form
-                          { name { expression } { message } \
-                            name { expression } { message } ...}
+                          { name { script } { message } \
+                            name { script } { message } ...}
                           where name is a unique identifier for the validation
-                          step, expression is a block to Tcl code that evaluates to
-                          1 or 0, and message is to be displayed to the user when
+                          step, expression is a block to Tcl code (script) that should
+                          set the result to 1 or 0, and message is to be displayed to the user when
                           the validation step fails, that is, if the expression
                           evaluates to 0. Use the special variable <tt>$value</tt>
                           to refer to the value entered by the user in that field.
+                          Note that e.g. in ad_form, all blocks are substituted,
+                          therefore, the script might require escaping.
 
     @option sign          specify for a hidden widget that its value should be
                           signed