Re: Documentation for alternate names of functions

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Daniel Cory <dcory(at)tableau(dot)com>
Cc: "pgsql-docs(at)postgresql(dot)org" <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Documentation for alternate names of functions
Date: 2018-09-04 21:57:23
Message-ID: 3047.1536098243@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Daniel Cory <dcory(at)tableau(dot)com> 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

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2018-09-05 02:35:35 Re: AT TIME ZONE correction
Previous Message David G. Johnston 2018-09-04 21:36:59 Re: Documentation for alternate names of functions