pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
pgsql: Doc: improve documentation about width_bucket().
6+ messages / 1 participants
[nested] [flat]

* pgsql: Doc: improve documentation about width_bucket().
@ 2025-06-21 17:02  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 6+ messages in thread

From: Tom Lane @ 2025-06-21 17:02 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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



^ permalink  raw  reply  [nested|flat] 6+ messages in thread

* pgsql: Doc: improve documentation about width_bucket().
@ 2025-06-21 17:02  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 6+ messages in thread

From: Tom Lane @ 2025-06-21 17:02 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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_15_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/ccfe3dbaa4392ec1cf50224c57eccd0f34ce8d1d

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



^ permalink  raw  reply  [nested|flat] 6+ messages in thread

* pgsql: Doc: improve documentation about width_bucket().
@ 2025-06-21 17:02  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 6+ messages in thread

From: Tom Lane @ 2025-06-21 17:02 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/ea06263c4aa5abadc97a6928c6b2aff0e29698ae

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



^ permalink  raw  reply  [nested|flat] 6+ messages in thread

* pgsql: Doc: improve documentation about width_bucket().
@ 2025-06-21 17:02  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 6+ messages in thread

From: Tom Lane @ 2025-06-21 17:02 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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



^ permalink  raw  reply  [nested|flat] 6+ messages in thread

* pgsql: Doc: improve documentation about width_bucket().
@ 2025-06-21 17:02  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 6+ messages in thread

From: Tom Lane @ 2025-06-21 17:02 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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_13_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/34a6c679ae35a0cc4645206f1a55d344766dbe1f

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



^ permalink  raw  reply  [nested|flat] 6+ messages in thread

* pgsql: Doc: improve documentation about width_bucket().
@ 2025-06-21 17:02  Tom Lane <tgl@sss.pgh.pa.us>
  0 siblings, 0 replies; 6+ messages in thread

From: Tom Lane @ 2025-06-21 17:02 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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_17_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/9575e540f6665f0992db8b68b27e152548c75e36

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



^ permalink  raw  reply  [nested|flat] 6+ messages in thread


end of thread, other threads:[~2025-06-21 17:02 UTC | newest]

Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2025-06-21 17:02 pgsql: Doc: improve documentation about width_bucket(). Tom Lane <tgl@sss.pgh.pa.us>
2025-06-21 17:02 pgsql: Doc: improve documentation about width_bucket(). Tom Lane <tgl@sss.pgh.pa.us>
2025-06-21 17:02 pgsql: Doc: improve documentation about width_bucket(). Tom Lane <tgl@sss.pgh.pa.us>
2025-06-21 17:02 pgsql: Doc: improve documentation about width_bucket(). Tom Lane <tgl@sss.pgh.pa.us>
2025-06-21 17:02 pgsql: Doc: improve documentation about width_bucket(). Tom Lane <tgl@sss.pgh.pa.us>
2025-06-21 17:02 pgsql: Doc: improve documentation about width_bucket(). Tom Lane <tgl@sss.pgh.pa.us>

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox