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.29 -r1.67.2.30
--- openacs-4/packages/acs-tcl/tcl/text-html-procs.tcl	31 Jul 2017 16:26:45 -0000	1.67.2.29
+++ openacs-4/packages/acs-tcl/tcl/text-html-procs.tcl	31 Jul 2017 16:31:01 -0000	1.67.2.30
@@ -873,7 +873,10 @@
         return {}
     }
 
-    # This proc might be used in order to improve some OpenACS
+    # This was created in order to pre-process some content to be fed
+    # to tDOM in ad_sanitize_html. In fact, even with its least picky
+    # behavior, tDOM cannot swallow whatever markup you give it. This
+    # proc might also 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 {