pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedminor rewording in ceil(), ceiling() and floor() function descriptions
2+ messages / 2 participants
[nested] [flat]
* minor rewording in ceil(), ceiling() and floor() function descriptions
@ 2020-05-05 01:08 PG Doc comments form <noreply@postgresql.org>
2020-05-05 02:43 ` Re: minor rewording in ceil(), ceiling() and floor() function descriptions Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 2+ messages in thread
From: PG Doc comments form @ 2020-05-05 01:08 UTC (permalink / raw)
To: pgsql-docs@lists.postgresql.org; +Cc: grgbnc@gmail.com
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
^ permalink raw reply [nested|flat] 2+ messages in thread
* Re: minor rewording in ceil(), ceiling() and floor() function descriptions
2020-05-05 01:08 minor rewording in ceil(), ceiling() and floor() function descriptions PG Doc comments form <noreply@postgresql.org>
@ 2020-05-05 02:43 ` Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 2+ messages in thread
From: Tom Lane @ 2020-05-05 02:43 UTC (permalink / raw)
To: grgbnc@gmail.com; +Cc: pgsql-docs@lists.postgresql.org
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:
https://www.postgresql.org/message-id/flat/20160606054056.1385.38085%40wrigleys.postgresql.org
https://git.postgresql.org/gitweb/?p=postgresql.git&a=commitdiff&h=7feb60c1bb0b1e9c97561171e...
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
^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2020-05-05 02:43 UTC | newest]
Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2020-05-05 01:08 minor rewording in ceil(), ceiling() and floor() function descriptions PG Doc comments form <noreply@postgresql.org>
2020-05-05 02:43 ` 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