Doc: improve documentation about width_bucket(). REL_14_STABLE github/REL_14_STABLE
authorTom Lane <[email protected]>
Sat, 21 Jun 2025 16:52:37 +0000 (12:52 -0400)
committerTom Lane <[email protected]>
Sat, 21 Jun 2025 16:52:37 +0000 (12:52 -0400)
commit9bd588f87de8ff3949b00d4f544abb4db4bb7e54
tree6ac68a16131d7557ffbaa1454b4a17e06fa0cb81
parent27af8b9be8c05d96d4e8207a93230ef0412bf149
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 <[email protected]>
Author: Robert Treat <[email protected]>
Co-authored-by: Tom Lane <[email protected]>
Reviewed-by: Dean Rasheed <[email protected]>
Discussion: https://postgr.es/m/2BD74F86-5B89-4AC1-8F13-23CED3546AC1@gmail.com
Backpatch-through: 13
doc/src/sgml/func.sgml
src/backend/utils/adt/float.c
src/backend/utils/adt/numeric.c