From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
---|---|
To: | grgbnc(at)gmail(dot)com |
Cc: | pgsql-docs(at)lists(dot)postgresql(dot)org |
Subject: | Re: minor rewording in ceil(), ceiling() and floor() function descriptions |
Date: | 2020-05-05 02:43:08 |
Message-ID: | 15306.1588646588@sss.pgh.pa.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
PG Doc comments form <noreply(at)postgresql(dot)org> writes:
> Proposed rewording for ceil() and ceiling(): "smallest integer..."
> Proposed rewording for floor(): "greatest integer..."
> Rationale: the proposed rewording is more aligned to their respective
> mathematical definitions
Actually, that's very nearly the wording we used to have, and then
changed because people found it confusing:
https://www.postgresql.org/message-id/flat/20160606054056.1385.38085%40wrigleys.postgresql.org
As of just a few days ago in HEAD, we have the room for clarifying examples
that we lacked then, so I added some:
https://www.postgresql.org/docs/devel/functions-math.html#FUNCTIONS-MATH-FUNC-TABLE
So maybe the confusion argument has less force than it used to. Still,
I'm disinclined to go back. In this particular area, I think Matlab's
precedent is at least as strong as Wikipedia's.
regards, tom lane
From | Date | Subject | |
---|---|---|---|
Next Message | Michael Paquier | 2020-05-05 05:17:45 | Re: Roles for pg_basebackup |
Previous Message | Jonathan S. Katz | 2020-05-05 02:12:15 | Re: Another modest proposal for docs formatting: catalog descriptions |