Re: Math function description issue

From: Michael Paquier <michael(dot)paquier(at)gmail(dot)com>
To: npistud(at)gmail(dot)com
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: Math function description issue
Date: 2016-06-07 02:15:37
Message-ID: CAB7nPqSiJwS_YTyy_v5ZDKV-ywGs5wV9YrXwT=uOp1hMS-oY=A@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Mon, Jun 6, 2016 at 2:40 PM, <npistud(at)gmail(dot)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 &lt; -42
> So, description should be &quot;Biggest integer&quot;.
>
> 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 Content-Type Size
doc-floor-ceil.patch text/x-diff 1.5 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Michael Paquier 2016-06-07 02:44:02 Re: Typo
Previous Message Peter Eisentraut 2016-06-06 19:56:01 Re: Docbook 5.x