Re: Documenting removal of nonnullvalue() and friends

From: Robert Haas <robertmhaas(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Peter Eisentraut <peter_e(at)gmx(dot)net>, Josh Kupershmidt <schmiddy(at)gmail(dot)com>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Documenting removal of nonnullvalue() and friends
Date: 2010-10-14 23:04:56
Message-ID: AANLkTikUKtngdLHCeqi=iERU6ydvQRcsW8EoaSwkrT3o@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Thu, Oct 14, 2010 at 6:07 PM, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> Robert Haas <robertmhaas(at)gmail(dot)com> writes:
>> I find the idea of things being intentionally undocumented quite
>> difficult.  How is someone coming along supposed to know which things
>> are intentionally undocumented and which things are unintentionally
>> undocumented?
>
> They should assume the lack of documentation is intentional.  Six or
> seven years ago your argument might have held some water, but we've
> been quite rigorous about requiring externally-visible features to be
> documented from the get-go.

That just doesn't match my experience. We goof. People find it.

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2010-10-14 23:15:43 Re: Documenting removal of nonnullvalue() and friends
Previous Message Tom Lane 2010-10-14 22:07:43 Re: Documenting removal of nonnullvalue() and friends