Index: openacs-4/packages/forums/tcl/messages-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/forums/tcl/messages-procs.tcl,v
diff -u -r1.59.2.10 -r1.59.2.11
--- openacs-4/packages/forums/tcl/messages-procs.tcl	7 Jan 2020 12:20:44 -0000	1.59.2.10
+++ openacs-4/packages/forums/tcl/messages-procs.tcl	7 Jan 2020 12:27:09 -0000	1.59.2.11
@@ -413,14 +413,21 @@
     return [attachments::get_attachments -object_id $message_id]
 }
 
-ad_proc -public forum::message::subject_sort_filter {
+ad_proc -deprecated forum::message::subject_sort_filter {
     -forum_id:required
     -order_by:required
 } {
     @return A piece of HTML for toggling the sort order of threads (subjects)
             in a forum. The user can either sort by the first postings in
             subjects (the creation date of the subjects) or the last one.
 
+    DEPRECATED: this proc is not mentioned anywhere in current
+                upstream codebase. Furthermore, it refers to a very
+                specific UI (e.g. sorting properties, styling...) and
+                does therefore provide little value in general.
+
+    @see idioms in the specific UI
+
     @author Peter Marklund
 } {
     set subject_label [_ forums.lt_First_post_in_subject]