pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
From: Peter Eisentraut <peter_e@gmx.net>
To: Robert Haas <robertmhaas@gmail.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Josh Kupershmidt <schmiddy@gmail.com>
Cc: pgsql-docs@postgresql.org
Subject: Re: Documenting removal of nonnullvalue() and friends
Date: Fri, 15 Oct 2010 18:26:59 +0300
Message-ID: <1287156419.9739.1.camel@vanquo.pezone.net> (raw)
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>

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".




view thread (25+ messages)  latest in thread

Message-ID: <1287156419.9739.1.camel@vanquo.pezone.net>
Permalink:  ../1287156419.9739.1.camel@vanquo.pezone.net/
Also on:    postgresql.org/message-id/1287156419.9739.1.camel@vanquo.pezone.net

 · 

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: peter_e@gmx.net, robertmhaas@gmail.com, tgl@sss.pgh.pa.us, schmiddy@gmail.com
  Subject: Re: Documenting removal of nonnullvalue() and friends
  In-Reply-To: <1287156419.9739.1.camel@vanquo.pezone.net>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox