From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Peter Eisentraut <peter_e@gmx.net>
Cc: Robert Haas <robertmhaas@gmail.com>
Cc: Josh Kupershmidt <schmiddy@gmail.com>
Cc: pgsql-docs@postgresql.org
Subject: Re: Documenting removal of nonnullvalue() and friends
Date: Sun, 27 Feb 2011 12:41:59 -0500 (EST)
Message-ID: <201102271741.p1RHfxw06463@momjian.us> (raw)
In-Reply-To: <10715.1298828414@sss.pgh.pa.us>
Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > Tom Lane wrote:
> >> I thought about this a bit more last night. It's certainly true that
> >> a lot of "internal" functions have comments that don't suggest that
> >> they're not meant to be used directly. What I think would be a good
> >> plan for functions that underlie operators is that we move any useful
> >> comments from pg_proc to pg_operator, and then install a comment in
> >> pg_proc that says "implementation of operator +" (or whatever the
> >> operator name is).
> >> ...
> >> If that sounds like a reasonable plan, I'm willing to have a go at it
> >> after the commitfest closes.
>
> > Tom, any work on this? A TODO?
>
> I haven't done anything about this yet, but it's still on my to-do list.
> Right now (or at least after I finish the patches I'm working on) would
> probably be about the best possible time to do it, since hopefully we
> have the minimum number of unapplied patches that would need to be
> revised to follow the new convention.
Good point.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ It's impossible for everything to be true. +
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: bruce@momjian.us, tgl@sss.pgh.pa.us, peter_e@gmx.net, robertmhaas@gmail.com, schmiddy@gmail.com
Subject: Re: Documenting removal of nonnullvalue() and friends
In-Reply-To: <201102271741.p1RHfxw06463@momjian.us>
* 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