Skip site navigation (1) Skip section navigation (2)

Re: Documenting removal of nonnullvalue() and friends

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Robert Haas <robertmhaas(at)gmail(dot)com>
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 22:07:43
Message-ID: 5718.1287094063@sss.pgh.pa.us (view raw or flat)
Thread:
Lists: pgsql-docs
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.

			regards, tom lane

In response to

Responses

pgsql-docs by date

Next:From: Robert HaasDate: 2010-10-14 23:04:56
Subject: Re: Documenting removal of nonnullvalue() and friends
Previous:From: Tom LaneDate: 2010-10-14 22:05:48
Subject: Re: [HACKERS] Docs for archive_cleanup_command are poor

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group