Index: openacs-4/packages/acs-lang/tcl/lang-util-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-lang/tcl/lang-util-procs.tcl,v
diff -u -r1.54.2.18 -r1.54.2.19
--- openacs-4/packages/acs-lang/tcl/lang-util-procs.tcl	9 Feb 2023 14:10:13 -0000	1.54.2.18
+++ openacs-4/packages/acs-lang/tcl/lang-util-procs.tcl	10 Feb 2023 12:01:37 -0000	1.54.2.19
@@ -19,7 +19,7 @@
 
 namespace eval lang::util {}
 
-ad_proc -public lang::util::lang_sort {
+ad_proc -deprecated lang::util::lang_sort {
     field
     {locale ""}
 } {
@@ -32,6 +32,14 @@
     insert into lang_testsort values ('lzim');
     </pre>
 
+    DEPRECATED: this api only supports Oracle. It also uses hardcoded
+    mapping between language and collation. It is unclear if an api is
+    needed for this, or if one can just have database-specific SQL in
+    xql files in order to achieve cross-db collation behavior.
+
+    @see https://www.postgresql.org/docs/current/collation.html
+    @see https://docs.oracle.com/cd/B14117_01/server.101/b10759/functions089.htm
+
     @author Jeff Davis (davis@xarg.net)
 
     @param field       Name of Oracle column