Index: openacs-4/packages/acs-bootstrap-installer/tcl/00-proc-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-bootstrap-installer/tcl/00-proc-procs.tcl,v
diff -u -r1.66.2.9 -r1.66.2.10
--- openacs-4/packages/acs-bootstrap-installer/tcl/00-proc-procs.tcl	13 Jul 2020 12:02:33 -0000	1.66.2.9
+++ openacs-4/packages/acs-bootstrap-installer/tcl/00-proc-procs.tcl	24 Jul 2020 11:50:30 -0000	1.66.2.10
@@ -1103,6 +1103,10 @@
     @param arg_name The name of the argument to check
     @param allowed_values_list The list of values that are permissible for the argument
 
+    Deprecated: this proc can be replaced via very simple expr or if idioms
+
+    @see native if or expr idioms
+
     @return Returns 1 if the argument has a valid value, throws an informative
                     error otherwise.
 
Index: openacs-4/packages/acs-tcl/tcl/deprecated-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-tcl/tcl/deprecated-procs.tcl,v
diff -u -r1.29.2.5 -r1.29.2.6
--- openacs-4/packages/acs-tcl/tcl/deprecated-procs.tcl	13 Jul 2020 12:02:33 -0000	1.29.2.5
+++ openacs-4/packages/acs-tcl/tcl/deprecated-procs.tcl	24 Jul 2020 11:59:45 -0000	1.29.2.6
@@ -2035,6 +2035,15 @@
 
 ad_proc -deprecated ad_custom_form {return_url item_group item} {
     sets up the head of a form to feed to /tools/form-custom.tcl
+
+    Deprecated: there are many better ways now to create forms in
+    OpenACS
+
+    @see ad_form
+    @see template::form
+    @see ::Generic::Form
+    @see ::xowiki::Form
+    @see ::xowiki::FormPage
 } {
     append html "<form method=\"get\" action=\"/tools/form-custom\">\n"
     if {$return_url ne ""} {
Index: openacs-4/packages/acs-tcl/tcl/utilities-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-tcl/tcl/utilities-procs.tcl,v
diff -u -r1.189.2.56 -r1.189.2.57
--- openacs-4/packages/acs-tcl/tcl/utilities-procs.tcl	13 Jul 2020 12:02:33 -0000	1.189.2.56
+++ openacs-4/packages/acs-tcl/tcl/utilities-procs.tcl	24 Jul 2020 11:52:57 -0000	1.189.2.57
@@ -2353,6 +2353,10 @@
 
 ad_proc -deprecated -public ad_call_proc_if_exists { proc args } {
     Calls a procedure with particular arguments, only if the procedure is defined.
+
+    Deprecated: very simple tcl commands idioms can replace this proc
+
+    @see "info commands" based idioms
 } {
     if { [info commands $proc] ne "" } {
         $proc {*}$args