Re: Incomplete or misleading explanation of the data types formathematical operators

On Wed, Jan 29, 2020 at 07:35:18PM +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
> 
> Page: https://www.postgresql.org/docs/12/functions-math.html
> Description:
> 
> "The bitwise operators work only on integral data types, whereas the others
> are available for all numeric data types. "
> Many math operators silently convert integral data types to double for
> calculations, so the result will not be the same data type as what was
> provided.
> select pg_typeof(10^2::bigint),pg_typeof(10^2::numeric)
> select pg_typeof(|/25::int), pg_typeof(|/25::numeric)
> select pg_typeof(10*10::bigint), pg_typeof(10*10::numeric) 
> 
> Multiplication preserves data type, exponentiation silently converts bigint
> to double, but preserves numeric data type, square root silently converts
> both int and numeric types to double.
> The best would be to explain this behaivior of operators like it was done
> for mathematical functions.

Uh, how does this relate to bitwise operators?  Why would we mention
type changes for things like exponentiation in the bitwise operator
documentation section?

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EnterpriseDB                             https://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +