Index: openacs-4/packages/acs-tcl/tcl/text-html-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-tcl/tcl/text-html-procs.tcl,v
diff -u -r1.67.2.27 -r1.67.2.28
--- openacs-4/packages/acs-tcl/tcl/text-html-procs.tcl	4 May 2017 10:44:59 -0000	1.67.2.27
+++ openacs-4/packages/acs-tcl/tcl/text-html-procs.tcl	31 Jul 2017 16:25:10 -0000	1.67.2.28
@@ -872,7 +872,10 @@
         }
         return {}
     }
-    
+
+    # This proc might be used in order to improve some OpenACS
+    # routines, like util_close_html_tags. As it has some limitations,
+    # this is left to future considerations.
     ad_proc ad_dom_fix_html {
         -html:required
         {-marker "root"}
@@ -1002,6 +1005,11 @@
         return [string trim $html]
     }
 
+    # Original purpose of this proc was to introduce a better way to
+    # enforce some HTML policy on the content submitted by the used
+    # (e.g. forbid some tag/attribute like <script> etc). It has some
+    # limitations that make non-trivial its introduction, therefore is
+    # currently not used around.
     ad_proc ad_dom_sanitize_html {
         -html:required
         -allowed_tags