Received: from maia.hub.org (maia-5.hub.org [200.46.204.29])
	by mail.postgresql.org (Postfix) with ESMTP id 552601337BC5
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Fri, 15 Oct 2010 12:27:12 -0300 (ADT)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.29]) (amavisd-maia, port 10024)
	with ESMTP id 95568-04 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Fri, 15 Oct 2010 15:27:04 +0000 (UTC)
X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6
Received: from mail.gmx.net (mailout-de.gmx.net [213.165.64.23])
	by mail.postgresql.org (Postfix) with SMTP id E3F8C1337990
	for <pgsql-docs@postgresql.org>; Fri, 15 Oct 2010 12:27:03 -0300 (ADT)
Received: (qmail invoked by alias); 15 Oct 2010 15:27:01 -0000
Received: from a88-115-218-165.elisa-laajakaista.fi (EHLO [10.0.0.101])
	[88.115.218.165]
	by mail.gmx.net (mp071) with SMTP; 15 Oct 2010 17:27:01 +0200
X-Authenticated: #495269
X-Provags-ID: V01U2FsdGVkX1/m3/xtKPnm4x8NBLg7m2lU9Y3E2eD8+0TXLgMcKx
	Xqno0x1ynj/OjR
Subject: Re: Documenting removal of nonnullvalue() and friends
From: Peter Eisentraut <peter_e@gmx.net>
To: Robert Haas <robertmhaas@gmail.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>, Josh Kupershmidt <schmiddy@gmail.com>,
	pgsql-docs@postgresql.org
In-Reply-To: <AANLkTi=B12qZtFDUnk0jukA+0UBoO4578umqSUPxrDzG@mail.gmail.com>
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>
	<1287064806.9532.5.camel@vanquo.pezone.net>
	<AANLkTikXfVVpnaDptPZpmShokB3caP9xA0ewOzMqE0Q_@mail.gmail.com>
	<5718.1287094063@sss.pgh.pa.us>
	<AANLkTikUKtngdLHCeqi=iERU6ydvQRcsW8EoaSwkrT3o@mail.gmail.com>
	<6841.1287098143@sss.pgh.pa.us>
	<AANLkTi=B12qZtFDUnk0jukA+0UBoO4578umqSUPxrDzG@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
Date: Fri, 15 Oct 2010 18:26:59 +0300
Message-ID: <1287156419.9739.1.camel@vanquo.pezone.net>
Mime-Version: 1.0
X-Mailer: Evolution 2.30.3 
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	RCVD_IN_DNSWL_NONE=-0.0001, T_RP_MATCHES_RCVD=-0.01
X-Spam-Level: 
X-Archive-Number: 201010/41
X-Sequence-Number: 6182

On tor, 2010-10-14 at 19:17 -0400, Robert Haas wrote:
> Part of the problem, I think, is that people don't necessarily find
> this stuff via the documentation.  They fire up psql or pgAdmin and
> start typing backslash commands.  They see something good, so they use
> it.  How are they to know it's undocumented?

This could possibly be addressed if we more diligently maintained the
system catalogs comments, and then possibly default the comments of
undocumented objects to "internal object, don't use".