From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Wed, 21 Jul 2021 22:03:33 +0000 (-0400)
Subject: Doc: improve documentation about exponentiation operator.
X-Git-Tag: REL_13_4~37
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=8344979d5bbc63aa8fb8c804bd933c887a2abb58;p=thirdparty%2Fpostgresql.git

Doc: improve documentation about exponentiation operator.

Now that we're not having to wedge this into the straitjacket of
the old operator table format, we can add another example to
clarify the point about left-to-right associativity.

Per suggestion from mdione at grulic.org.ar.

https://postgr.es/m/162661954599.693.13700316547731859171@wrigleys.postgresql.org
---

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 5dea1aa986e..32328de46d5 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1007,16 +1007,23 @@ repeat('Pg', 4) <returnvalue>PgPgPgPg</returnvalue>
         <returnvalue>double precision</returnvalue>
        </para>
        <para>
-        Exponentiation (unlike typical mathematical practice, multiple uses of
-        <literal>^</literal> will associate left to right)
+        Exponentiation
        </para>
        <para>
         <literal>2 ^ 3</literal>
         <returnvalue>8</returnvalue>
        </para>
+       <para>
+        Unlike typical mathematical practice, multiple uses of
+        <literal>^</literal> will associate left to right by default:
+       </para>
        <para>
         <literal>2 ^ 3 ^ 3</literal>
         <returnvalue>512</returnvalue>
+       </para>
+       <para>
+        <literal>2 ^ (3 ^ 3)</literal>
+        <returnvalue>134217728</returnvalue>
        </para></entry>
       </row>