Re: Documenting removal of nonnullvalue() and friends - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: Documenting removal of nonnullvalue() and friends
Date
Msg-id 1287064806.9532.5.camel@vanquo.pezone.net
Whole thread Raw
In response to Re: Documenting removal of nonnullvalue() and friends  (Josh Kupershmidt <schmiddy@gmail.com>)
Responses Re: Documenting removal of nonnullvalue() and friends  (Robert Haas <robertmhaas@gmail.com>)
List pgsql-docs
On ons, 2010-10-13 at 23:25 -0400, Josh Kupershmidt wrote:
> Would anyone favor instead back-patching the documentation for the
> 8.3, 8.2, and 8.1 branches to include mentions of these
> previously-undocumented functions, instead? In
> <http://archives.postgresql.org/pgsql-docs/2004-08/msg00015.php>, Tom
> opined that they should be left undocumented, but I really don't agree
> with that.

The sets of intentionally documented and undocumented functions is part
of the API specification of a release, and we're not changing that after
the release, especially not when a future release ends up reverting the
change.


pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Documenting removal of nonnullvalue() and friends
Next
From: Brendan Jurd
Date:
Subject: Re: [HACKERS] Docs for archive_cleanup_command are poor