From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Thu, 1 Dec 2022 17:26:12 +0000 (-0500)
Subject: Doc: add example of round(v, s) with negative s.
X-Git-Tag: REL_16_BETA1~1195
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=a109a0bb50ad47812b8818e9c98e4f311672d659;p=thirdparty%2Fpostgresql.git

Doc: add example of round(v, s) with negative s.

This has always worked, but you'd be unlikely to guess it
from the documentation.  Add an example showing it.

Lack of docs noted by David Johnston.  Back-patch to v13;
the documentation layout we used before that was not very
amenable to squeezing in multiple examples.

Discussion: https://postgr.es/m/CAKFQuwZ4Vy1Xty0G5Ok+ot=NDrU3C6hzF1JwUk-FEkwe3V9_RA@mail.gmail.com
---

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 22204f16c20..2052d3c8445 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1598,6 +1598,10 @@ repeat('Pg', 4) <returnvalue>PgPgPgPg</returnvalue>
        <para>
         <literal>round(42.4382, 2)</literal>
         <returnvalue>42.44</returnvalue>
+       </para>
+       <para>
+        <literal>round(1234.56, -1)</literal>
+        <returnvalue>1230</returnvalue>
        </para></entry>
       </row>