docs: document TRIM "comma" syntax

This syntax is supported by the parser, but is non-standard.

_Not_ backpatched to 9.3 in case we change our minds.

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 615462195b4806a715bf36dc58f2da7dabb775d3..b21c433565c72a0cd0ad3fe74d05b4b830e737ab 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1293,6 +1293,25 @@
        <entry><literal>Tom</literal></entry>
       </row>
 
+      <row>
+       <entry>
+        <indexterm>
+         <primary>trim</primary>
+        </indexterm>
+        <literal><function>trim(<optional>leading | trailing
+        | both</optional> <optional>from</optional>
+        <parameter>string</parameter>
+        <optional><parameter>, characters</parameter></optional>
+        )</function></literal>
+       </entry>
+       <entry><type>text</type></entry>
+       <entry>
+        Non-standard version of <function>trim()</>
+       </entry>
+       <entry><literal>trim(both from 'xTomxx', 'x')</literal></entry>
+       <entry><literal>Tom</literal></entry>
+      </row>
+
       <row>
        <entry>
         <indexterm>