From: Tom Lane <tgl@sss.pgh.pa.us>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: Robert Haas <robertmhaas@gmail.com>
Cc: Josh Kupershmidt <schmiddy@gmail.com>
Cc: pgsql-docs@postgresql.org
Subject: Re: Documenting removal of nonnullvalue() and friends
Date: Thu, 14 Oct 2010 10:33:26 -0400
Message-ID: <17941.1287066806@sss.pgh.pa.us> (raw)
In-Reply-To: <1287064708.9532.3.camel@vanquo.pezone.net>
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>
<AANLkTi=iZiPF88Zt46S35rs0RnvvMB86MoOfEBWD2bcB@mail.gmail.com>
<1287064708.9532.3.camel@vanquo.pezone.net>
Peter Eisentraut <peter_e@gmx.net> writes:
> On tor, 2010-10-14 at 08:50 -0400, Robert Haas wrote:
>> Still, I don't think it would be unreasonable to add a note to the
>> prior-release documentation saying - hey, these functions exist. They
>> are for internal use only, and do not exist in later versions. Don't
>> use 'em. Now, how many people will actually see that note? Probably
>> not many. But it wouldn't bother me to have it there.
> Just like there is a philosophical argument against changing the release
> notes after the release, there is an argument against changing a past
> release to "retroactively predict" how future releases behave. We have
> made exceptions to both points on occasion, but usually only for
> critical upgrade-related issues.
I would put this whole issue in the category of "if you use undocumented
features, you should not be surprised when they undocumentedly break".
There are many many places where it's possible to see undocumented
implementation details in Postgres. If we put in release-note warnings
every time we changed one of those details, the release notes would be
twice as long and half as useful as they are now.
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, peter_e@gmx.net, robertmhaas@gmail.com, schmiddy@gmail.com
Subject: Re: Documenting removal of nonnullvalue() and friends
In-Reply-To: <17941.1287066806@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