Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bA6YS-0005ua-8V for pgsql-docs@arkaria.postgresql.org; Tue, 07 Jun 2016 02:15:44 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.84_2) (envelope-from ) id 1bA6YR-0004Sz-NK for pgsql-docs@arkaria.postgresql.org; Tue, 07 Jun 2016 02:15:43 +0000 Received: from makus.postgresql.org ([2001:4800:1501:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1bA6YQ-0004S4-9p for pgsql-docs@postgresql.org; Tue, 07 Jun 2016 02:15:42 +0000 Received: from mail-vk0-x234.google.com ([2607:f8b0:400c:c05::234]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.84_2) (envelope-from ) id 1bA6YN-0000XV-2x for pgsql-docs@postgresql.org; Tue, 07 Jun 2016 02:15:41 +0000 Received: by mail-vk0-x234.google.com with SMTP id c66so70620495vkb.3 for ; Mon, 06 Jun 2016 19:15:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc; bh=VhALBoPn1Ftxyf8CbGYg1Gubh5+bu7mfY8UMYfSm6wo=; b=aauUoYTnWVup8/94eONjhKLEAoVuku+EW/L+1mWZ1pWsJiWm6MPv7rdYroqKC60lkN oIfbzJM/3f1KX0gDjm1zKjKLY3RW5rg7MKlpiPZjq/+EAyryzn5Jr6p8duO4WAVI02sX 7ksx09xFQ8c7FLATD2/rUTZgfnl8YEowd2EfG/vBfz5rXAnM+corri5rilidoL+TFiJx TYWv1JBw/qjv2JOPRtxihqCPg++4vZLtJ/XK4PfQWVUIaKjjfz05b2mY102MmRW8gYps zuP/x22L0LtXGV6khAgzNjGP5uFsRzP/3/6aRdix+JVwzzeCXXINeGdoJV2OunAmQ6aF NKZQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc; bh=VhALBoPn1Ftxyf8CbGYg1Gubh5+bu7mfY8UMYfSm6wo=; b=h2jI4AKwLpvT0I13swobAiZNvmtElm/7pcMMN0SaEGt75aOKBBpMu8wU81iQ7P0C/0 0ZWApSQ25pkhcZzkhZjodag4rk0C6Ba1fVsvTxxlttuX2/YRr0wzmglbeZD/jZJxQTTc q8Wsd8gDS8nsYlBOWhRKOGj+IN1zBpZAUBISLHIbJWhXrvEzxNgvonN9Jmuj4A5/gSW4 hTID3SAhmiYzzMLIM5eVXVPTs7L/NUz4b5BlVfeYsQ484tA5y2fvUhJkZmtO6H27F3P/ FBKCD0EQX4pctS5jE7WUjQEDF81IVXgvhMlB4P44bIMxLHhXZLwVgQ0bSstLxJJLvfeY Ai2w== X-Gm-Message-State: ALyK8tLQB8r/+vgDsBhfhEBLrjybiJUP859l6+sZpjuJPC9fAkBgeOzAVL5f7OXz14kY+X5VoGlrqoHlScCXvw== X-Received: by 10.176.0.238 with SMTP id 101mr5831433uaj.107.1465265738122; Mon, 06 Jun 2016 19:15:38 -0700 (PDT) MIME-Version: 1.0 Received: by 10.103.137.197 with HTTP; Mon, 6 Jun 2016 19:15:37 -0700 (PDT) In-Reply-To: <20160606054056.1385.38085@wrigleys.postgresql.org> References: <20160606054056.1385.38085@wrigleys.postgresql.org> From: Michael Paquier Date: Tue, 7 Jun 2016 11:15:37 +0900 Message-ID: Subject: Re: Math function description issue To: npistud@gmail.com Cc: pgsql-docs@postgresql.org Content-Type: multipart/mixed; boundary=001a113cf426d2b18e0534a6c3f4 X-Pg-Spam-Score: -2.7 (--) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org --001a113cf426d2b18e0534a6c3f4 Content-Type: text/plain; charset=UTF-8 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. > 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 --001a113cf426d2b18e0534a6c3f4 Content-Type: text/x-diff; charset=US-ASCII; name="doc-floor-ceil.patch" Content-Disposition: attachment; filename="doc-floor-ceil.patch" Content-Transfer-Encoding: base64 X-Attachment-Id: f_ip4tdgbv0 ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9mdW5jLnNnbWwgYi9kb2Mvc3Jj L3NnbWwvZnVuYy5zZ21sCmluZGV4IGZmNzU0NWQuLjk4MGYxYzQgMTAwNjQ0 Ci0tLSBhL2RvYy9zcmMvc2dtbC9mdW5jLnNnbWwKKysrIGIvZG9jL3NyYy9z Z21sL2Z1bmMuc2dtbApAQCAtNzAyLDcgKzcwMiw3IEBACiAgICAgICAgIDxs aXRlcmFsPjxmdW5jdGlvbj5jZWlsKDx0eXBlPmRwPC90eXBlPiBvciA8dHlw ZT5udW1lcmljPC90eXBlPik8L2Z1bmN0aW9uPjwvbGl0ZXJhbD4KICAgICAg ICA8L2VudHJ5PgogICAgICAgIDxlbnRyeT4oc2FtZSBhcyBpbnB1dCk8L2Vu dHJ5PgotICAgICAgIDxlbnRyeT5zbWFsbGVzdCBpbnRlZ2VyIG5vdCBsZXNz IHRoYW4gYXJndW1lbnQ8L2VudHJ5PgorICAgICAgIDxlbnRyeT5zbWFsbGVz dCBmb2xsb3dpbmcgaW50ZWdlciBub3QgbGVzcyB0aGFuIGFyZ3VtZW50PC9l bnRyeT4KICAgICAgICA8ZW50cnk+PGxpdGVyYWw+Y2VpbCgtNDIuOCk8L2xp dGVyYWw+PC9lbnRyeT4KICAgICAgICA8ZW50cnk+PGxpdGVyYWw+LTQyPC9s aXRlcmFsPjwvZW50cnk+CiAgICAgICA8L3Jvdz4KQEAgLTcxNSw3ICs3MTUs NyBAQAogICAgICAgICA8bGl0ZXJhbD48ZnVuY3Rpb24+Y2VpbGluZyg8dHlw ZT5kcDwvdHlwZT4gb3IgPHR5cGU+bnVtZXJpYzwvdHlwZT4pPC9mdW5jdGlv bj48L2xpdGVyYWw+CiAgICAgICAgPC9lbnRyeT4KICAgICAgICA8ZW50cnk+ KHNhbWUgYXMgaW5wdXQpPC9lbnRyeT4KLSAgICAgICA8ZW50cnk+c21hbGxl c3QgaW50ZWdlciBub3QgbGVzcyB0aGFuIGFyZ3VtZW50IChhbGlhcyBmb3Ig PGZ1bmN0aW9uPmNlaWw8L2Z1bmN0aW9uPik8L2VudHJ5PgorICAgICAgIDxl bnRyeT5zbWFsbGVzdCBmb2xsb3dpbmcgaW50ZWdlciBub3QgbGVzcyB0aGFu IGFyZ3VtZW50IChhbGlhcyBmb3IgPGZ1bmN0aW9uPmNlaWw8L2Z1bmN0aW9u Pik8L2VudHJ5PgogICAgICAgIDxlbnRyeT48bGl0ZXJhbD5jZWlsaW5nKC05 NS4zKTwvbGl0ZXJhbD48L2VudHJ5PgogICAgICAgIDxlbnRyeT48bGl0ZXJh bD4tOTU8L2xpdGVyYWw+PC9lbnRyeT4KICAgICAgIDwvcm93PgpAQCAtNzY4 LDcgKzc2OCw3IEBACiAgICAgICAgIDxsaXRlcmFsPjxmdW5jdGlvbj5mbG9v cig8dHlwZT5kcDwvdHlwZT4gb3IgPHR5cGU+bnVtZXJpYzwvdHlwZT4pPC9m dW5jdGlvbj48L2xpdGVyYWw+CiAgICAgICAgPC9lbnRyeT4KICAgICAgICA8 ZW50cnk+KHNhbWUgYXMgaW5wdXQpPC9lbnRyeT4KLSAgICAgICA8ZW50cnk+ bGFyZ2VzdCBpbnRlZ2VyIG5vdCBncmVhdGVyIHRoYW4gYXJndW1lbnQ8L2Vu dHJ5PgorICAgICAgIDxlbnRyeT5sYXJnZXN0IHByZXZpb3VzIGludGVnZXIg bm90IGdyZWF0ZXIgdGhhbiBhcmd1bWVudDwvZW50cnk+CiAgICAgICAgPGVu dHJ5PjxsaXRlcmFsPmZsb29yKC00Mi44KTwvbGl0ZXJhbD48L2VudHJ5Pgog ICAgICAgIDxlbnRyeT48bGl0ZXJhbD4tNDM8L2xpdGVyYWw+PC9lbnRyeT4K ICAgICAgIDwvcm93Pgo= --001a113cf426d2b18e0534a6c3f4 Content-Type: text/plain Content-Disposition: inline Content-Transfer-Encoding: 8bit MIME-Version: 1.0 -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs --001a113cf426d2b18e0534a6c3f4--