On Thu, Oct 14, 2010 at 10:00 AM, Peter Eisentraut <[email protected]> wrote: > 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.
Fair enough. I still think that we shouldn't be intentionally leaving features undocumented, as it just leads to confusion down the road (e.g. trying to figure out what some legacy code is doing, without documentation). I'm curious now, though: are there any other functions which we're leaving intentionally undocumented? The only similar one I've run across are the deprecated "-a" and "-A" arguments to the createuser command. (There's another argument for documenting deprecated features/arguments: it's easier to know what needs to be ripped out in future releases). Josh -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
