Re: [DOCS] Math function description issue

2016-06-09 Thread Tom Lane
Dean Rasheed writes: > Matlab just uses "nearest" for both floor() and ceil(), e.g. "the > nearest integer less than or equal to ...". > To me, that seems clearer than smallest/largest or least/greatest > because you don't have to think about which set of numbers it's trying > to exclude. When th

Re: [DOCS] Math function description issue

2016-06-07 Thread Dean Rasheed
On 8 June 2016 at 00:11, Alvaro Herrera wrote: > Tom Lane wrote: >> =?UTF-8?Q?J=c3=bcrgen_Purtz?= writes: > >> > a) In my opinion this wording is easier to understand because it avoids >> > the negation via "not less". >> >> That's a fair point. >> >> The other difference is least/greatest versus

Re: [DOCS] Math function description issue

2016-06-07 Thread Alvaro Herrera
Tom Lane wrote: > =?UTF-8?Q?J=c3=bcrgen_Purtz?= writes: > > a) In my opinion this wording is easier to understand because it avoids > > the negation via "not less". > > That's a fair point. > > The other difference is least/greatest versus smallest/largest. I'm not > sure if using least/great

Re: [DOCS] Math function description issue

2016-06-07 Thread Tom Lane
=?UTF-8?Q?J=c3=bcrgen_Purtz?= writes: > The standard says: > " computes the least integer greater than or equal to > its argument." Hmm, you're looking at the SQL standard I guess. The existing wording in our docs seems to be taken from the C/POSIX standard, which says "[ceil(x)] shall compute

Re: [DOCS] Math function description issue

2016-06-07 Thread Jürgen Purtz
The standard says: " computes the least integer greater than or equal to its argument." a) In my opinion this wording is easier to understand because it avoids the negation via "not less". b) To dispel the ambiguities concerning what is greater or lesser (with negative numbers) we may add a

Re: [DOCS] Math function description issue

2016-06-06 Thread Tom Lane
Michael Paquier writes: > On Mon, Jun 6, 2016 at 2:40 PM, wrote: >> Please, check ceil, ceiling and floor functions. Example is correct, but >> description is wrong. > We could make things indeed more precise. Say for ceil, we use > "smallest *following* integer", and for floor, "largest *previ

Re: [DOCS] Math function description issue

2016-06-06 Thread Michael Paquier
On Mon, Jun 6, 2016 at 2:40 PM, 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

[DOCS] Math function description issue

2016-06-06 Thread npistud
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. Ex