pgsql: Doc: improve documentation about width_bucket().

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Doc: improve documentation about width_bucket().
Date: 2025-06-21 17:02:51
Message-ID: E1uT1cB-002iwu-0e@gemulon.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Doc: improve documentation about width_bucket().

Specify whether the bucket bounds are inclusive or exclusive,
and improve some other vague language. Explain the behavior that
occurs when the "low" bound is greater than the "high" bound.
Make width_bucket_numeric's comment more like that for
width_bucket_float8, in particular noting that infinite
bounds are rejected (since they became possible in v14).

Reported-by: Ben Peachey Higdon <bpeacheyhigdon(at)gmail(dot)com>
Author: Robert Treat <rob(at)xzilla(dot)net>
Co-authored-by: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Reviewed-by: Dean Rasheed <dean(dot)a(dot)rasheed(at)gmail(dot)com>
Discussion: https://postgr.es/m/2BD74F86-5B89-4AC1-8F13-23CED3546AC1@gmail.com
Backpatch-through: 13

Branch
------
REL_16_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/7a93bd5986e4b741fc3fdd8406431c77161c6d12

Modified Files
--------------
doc/src/sgml/func.sgml | 18 ++++++++++++++----
src/backend/utils/adt/float.c | 4 ++--
src/backend/utils/adt/numeric.c | 7 ++++---
3 files changed, 20 insertions(+), 9 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Alexander Korotkov 2025-06-22 00:16:10 Re: pgsql: Improve runtime and output of tests for replication slots checkp
Previous Message Bruce Momjian 2025-06-21 03:53:39 pgsql: doc PG 18 relnotes: update to current, add one commit