| 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: | Whole Thread | Raw Message | 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 |