Re: Math function description issue - Mailing list pgsql-docs

From Michael Paquier
Subject Re: Math function description issue
Date
Msg-id CAB7nPqSiJwS_YTyy_v5ZDKV-ywGs5wV9YrXwT=uOp1hMS-oY=A@mail.gmail.com
Whole thread Raw
In response to Math function description issue  (npistud@gmail.com)
Responses Re: Math function description issue
List pgsql-docs
On Mon, Jun 6, 2016 at 2:40 PM,  <npistud@gmail.com> wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/9.5/static/functions-math.html
> Description:
>
> https://www.postgresql.org/docs/9.5/static/functions-math.html
>
> Same issue for other versions.
> Please, check ceil, ceiling and floor functions. Example is correct, but
> description is wrong.
>
> For ceil in docs
> Description: smallest integer not less than argument.
> Example: ceil(-42.8) = -42
>
> But -42.8 < -42
> So, description should be "Biggest integer".
>
> Vice versa for floor.

We could make things indeed more precise. Say for ceil, we use
"smallest *following* integer", and for floor, "largest *previous*
integer", and we keep the mention to "not less/greater than argument"
to show the fact that a numeric already rounded to an integer is equal
to itself. See the patch attached.
--
Michael

Attachment

pgsql-docs by date:

Previous
From: npistud@gmail.com
Date:
Subject: Math function description issue
Next
From: Michael Paquier
Date:
Subject: Re: Typo