Re: Documenting removal of nonnullvalue() and friends

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Robert Haas <robertmhaas(at)gmail(dot)com>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Josh Kupershmidt <schmiddy(at)gmail(dot)com>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Documenting removal of nonnullvalue() and friends
Date: 2010-10-15 15:26:59
Message-ID: 1287156419.9739.1.camel@vanquo.pezone.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2010-10-15 15:40:53 Re: Documenting removal of nonnullvalue() and friends
Previous Message Simon Riggs 2010-10-15 13:48:57 Re: formula about the number of WAL files