minor rewording in ceil(), ceiling() and floor() function descriptions
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/12/functions-math.html
Description:
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
References:
- https://proofwiki.org/wiki/Definition:Ceiling_Function
- https://proofwiki.org/wiki/Definition:Floor_Function
PG Doc comments form <noreply@postgresql.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:
/messages/by-id/20160606054056.1385.38085@wrigleys.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