From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: claytonjsalem@gmail.com
Subject: Numeric documentation paragraph reverse argument order.
Date: Fri, 22 Jun 2018 13:54:26 +0000
Message-ID: <152967566691.1268.1062965601465200209@wrigleys.postgresql.org> (raw)
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)`
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: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, claytonjsalem@gmail.com
Subject: Re: Numeric documentation paragraph reverse argument order.
In-Reply-To: <152967566691.1268.1062965601465200209@wrigleys.postgresql.org>
* 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