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_15_2~79
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e10799aa252c2232a3d4f73f4875532423f3f7b4;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 0fa2f80b4a3..40d0645bcdf 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>