pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: grgbnc@gmail.com
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: minor rewording in ceil(), ceiling() and floor() function descriptions
Date: Mon, 04 May 2020 22:43:08 -0400
Message-ID: <15306.1588646588@sss.pgh.pa.us> (raw)
In-Reply-To: <158864091845.671.12957258466953428623@wrigleys.postgresql.org>
References: <158864091845.671.12957258466953428623@wrigleys.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





view thread (2+ messages)

Message-ID: <15306.1588646588@sss.pgh.pa.us>
Permalink:  ../15306.1588646588@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/15306.1588646588@sss.pgh.pa.us

 · 

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: tgl@sss.pgh.pa.us, grgbnc@gmail.com, pgsql-docs@lists.postgresql.org
  Subject: Re: minor rewording in ceil(), ceiling() and floor() function descriptions
  In-Reply-To: <15306.1588646588@sss.pgh.pa.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

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