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 ""} {