From: Bruce Momjian <bruce@momjian.us>
To: claytonjsalem@gmail.com
To: pgsql-docs@lists.postgresql.org
Subject: Re: Numeric documentation paragraph reverse argument order.
Date: Sun, 24 Jun 2018 18:08:00 -0400
Message-ID: <20180624220800.GE17816@momjian.us> (raw)
In-Reply-To: <152967566691.1268.1062965601465200209@wrigleys.postgresql.org>
References: <152967566691.1268.1062965601465200209@wrigleys.postgresql.org>
On Fri, Jun 22, 2018 at 01:54:26PM +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/10/static/datatype-numeric.html
> Description:
>
> This is not a correction, but a clarification. In the paragraph describing
> the Numeric type,
> https://www.postgresql.org/docs/10/static/datatype-numeric.html#DATATYPE-NUMERIC-DECIMAL
> the description of the arguments is reversed from the order of the
> arguments, i.e. scale before numeric, while the argument is numeric before
> scale. My suggestion is to change the following paragraph:
>
> > We use the following terms below: The scale of a numeric is the count of
> decimal digits in the fractional part, to the right of the decimal point.
> The precision of a numeric is the total count of significant digits in the
> whole number, that is, the number of digits to both sides of the decimal
> point. So the number 23.5141 has a precision of 6 and a scale of 4. Integers
> can be considered to have a scale of zero.
>
> to:
>
> > We use the following terms below: The precision of a numeric is the total
> count of significant digits in the whole number, that is, the number of
> digits to both sides of the decimal point. The scale of a numeric is the
> count of decimal digits in the fractional part, to the right of the decimal
> point. So the number 23.5141 has a precision of 6 and a scale of 4. Integers
> can be considered to have a scale of zero.
>
> That way the order in the paragraph (precision, scale), matches the argument
> order `NUMERIC(precision, scale)`
Now that is an excellent suggestion. Change applied back through 9.3.
Thanks.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ As you are, so once was I. As I am, so you will be. +
+ Ancient Roman grave inscription +
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: bruce@momjian.us, claytonjsalem@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Numeric documentation paragraph reverse argument order.
In-Reply-To: <20180624220800.GE17816@momjian.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