From: Tom Lane <tgl@sss.pgh.pa.us>
To: Josh Kupershmidt <schmiddy@gmail.com>
Cc: Peter Eisentraut <peter_e@gmx.net>
Cc: Robert Haas <robertmhaas@gmail.com>
Cc: pgsql-docs@postgresql.org
Subject: Re: Documenting removal of nonnullvalue() and friends
Date: Thu, 14 Oct 2010 10:38:11 -0400
Message-ID: <18056.1287067091@sss.pgh.pa.us> (raw)
In-Reply-To: <AANLkTim=ExkXOAqGBAd6Uqnnq9X9L6UC9q2_bZGR792a@mail.gmail.com>
References: <AANLkTikr84KaL_EQECtvfnKkq0f=abHi4s+9Cq7LSOSo@mail.gmail.com>
<AANLkTikT01KcHaEfJRBepM6ZGncD59Sn1g9MEE-XPpWX@mail.gmail.com>
<AANLkTi=Av3AJ9DAyyO758OKabzEks-pNQWm=ntTMLHkH@mail.gmail.com>
<AANLkTikH6JF0FrwJBDaYpUN_TW=3t=Syj3pnzJ7CX1-A@mail.gmail.com>
<1287064806.9532.5.camel@vanquo.pezone.net>
<AANLkTim=ExkXOAqGBAd6Uqnnq9X9L6UC9q2_bZGR792a@mail.gmail.com>
Josh Kupershmidt <schmiddy@gmail.com> writes:
> I'm curious now, though: are there any other functions which we're
> leaving intentionally undocumented?
Practically all the functions underlying operators are undocumented, eg
int4pl(int, int). (If you consider IS NOT NULL to be an operator, then
nonnullvalue is exactly one of those.) It's possible for people to use
those directly but it's discouraged. I do *not* want to add them to the
docs, because (a) I do *not* want people to use them directly and (b)
there are a hell of a lot of them, so the docs would get much much
longer with no actual added value.
Perhaps what we should really add to the docs is a statement that use of
undocumented functions is deprecated and we will not be responsible when
your code breaks because one of those is changed or removed.
regards, tom lane
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: tgl@sss.pgh.pa.us, schmiddy@gmail.com, peter_e@gmx.net, robertmhaas@gmail.com
Subject: Re: Documenting removal of nonnullvalue() and friends
In-Reply-To: <18056.1287067091@sss.pgh.pa.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