Index: openacs-4/packages/acs-tcl/tcl/defs-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-tcl/tcl/defs-procs.tcl,v
diff -u -N -r1.81.2.23 -r1.81.2.24
--- openacs-4/packages/acs-tcl/tcl/defs-procs.tcl	7 Feb 2023 13:32:19 -0000	1.81.2.23
+++ openacs-4/packages/acs-tcl/tcl/defs-procs.tcl	7 Feb 2023 13:36:36 -0000	1.81.2.24
@@ -362,16 +362,21 @@
     return 1
 }
 
-# for pages that have optional decoration
-
-ad_proc ad_decorate_top {
+ad_proc -deprecated ad_decorate_top {
     simple_headline
     potential_decoration
 } {
     Use this for pages that might or might not have an image
     defined in ad.ini; if the second argument isn't the empty
     string, ad_decorate_top will make a one-row table for the
     top of the page
+
+    DEPRECATED: use the template system, e.g. master and slave tags to
+                achieve better control of headers.
+
+    @see /doc/acs-templating/tagref/master
+    @see /doc/acs-templating/tagref/slave
+    @see /doc/acs-templating/tagref/include
 } {
     if { $potential_decoration eq "" } {
         return $simple_headline