docs: document TRIM "comma" syntax

bmomjian · bmomjian · commit 5368a23eeb1f · 2013-08-14T17:26:36.000-04:00
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
@@ -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>
