pgsql: Doc: improve documentation about width_bucket(). - Mailing list 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@gmail.com>
Author: Robert Treat <rob@xzilla.net>
Co-authored-by: Tom Lane <tgl@sss.pgh.pa.us>
Reviewed-by: Dean Rasheed <dean.a.rasheed@gmail.com>
Discussion: https://postgr.es/m/2BD74F86-5B89-4AC1-8F13-23CED3546AC1@gmail.com
Backpatch-through: 13

Branch
------
REL_14_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/9bd588f87de8ff3949b00d4f544abb4db4bb7e54

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(-)