public inbox for [email protected]  

help / color / mirror / Atom feed

From: Tom Lane <[email protected]>
To: Daniel Cory <[email protected]>
Cc: [email protected] <[email protected]>
Subject: Re: Documentation for alternate names of functions
Date: Tue, 04 Sep 2018 17:57:23 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <CY1PR03MB14552075064D0C5ED7D3E6CEBC030@CY1PR03MB1455.namprd03.prod.outlook.com>
References: <CY1PR03MB14552075064D0C5ED7D3E6CEBC030@CY1PR03MB1455.namprd03.prod.outlook.com>

Daniel Cory <[email protected]> writes:
> Can we document that "pow" is the same as "power"?

Meh.  power() is the SQL-standard spelling; I don't see a good reason to
encourage people to use the legacy name.  We might hope to get rid of
that name someday (cf commit fc7fd5018).

> Can we document "int4larger" and related functions?

We intentionally do *not* document functions that are only meant to be
used as infrastructure for operators and aggregates.  If we did, the
tables would be far larger and would just encourage people to use
functions we'd prefer they didn't.  As with the pow() case, this'd
basically be enlarging our exposed surface of frozen API, and I don't
think that's desirable.

			regards, tom lane

view thread (3+ messages)

reply

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: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: Documentation for alternate names of functions
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox