From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Mon, 28 Dec 2015 17:09:00 +0000 (-0500)
Subject: Document the exponentiation operator as associating left to right.
X-Git-Tag: REL9_6_BETA1~940
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=54aaafe95f65c95fd9ba085826af87d778c94613;p=postgresql

Document the exponentiation operator as associating left to right.

Common mathematical convention is that exponentiation associates right to
left.  We aren't going to change the parser for this, but we could note
it in the operator's description.  (It's already noted in the operator
precedence/associativity table, but users might not look there.)
Per bug #13829 from Henrik Pauli.
---

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index e08bf60b9e..d230c6073d 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -505,7 +505,7 @@
 
       <row>
        <entry> <literal>^</literal> </entry>
-       <entry>exponentiation</entry>
+       <entry>exponentiation (associates left to right)</entry>
        <entry><literal>2.0 ^ 3.0</literal></entry>
        <entry><literal>8</literal></entry>
       </row>