From: Bruce Momjian <bruce@momjian.us>
To: Gavin Sherry <swm@linuxworld.com.au>
Cc: Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-docs@postgresql.org, Tom Lane <tgl@sss.pgh.pa.us>
Cc: Joe Conway <mail@joeconway.com>
Subject: Re: Values list-of-targetlists patch for comments (was Re:
Date: Thu, 10 Aug 2006 23:07:10 -0400 (EDT)
Message-ID: <200608110307.k7B37AA22420@momjian.us> (raw)
In-Reply-To: <Pine.LNX.4.58.0608041042551.16622@linuxworld.com.au>
Gavin Sherry wrote:
> > A few examples on the command references pages to show how it can be
> > useful are probably OK, but the big picture shoulbd be developed in
> > chapter 7 or so.
>
> What do we want to do about documenting:
>
> regression=# values(1);
> column1
> ---------
> 1
> (1 row)
>
> It seems to me that if this isn't in the command reference we'll see an
> email every few months say 'is this an undocumented feature?'. We can
> cover it easily in Part II, 7.2 but people wont look there. Then again, it
> just doesn't seem right to put it in the command reference as a 'top
> level' command.
How many people are going to think of doing a VALUES(1)? Isn't it just
like SELECT 1? We can try making VALUES a non-toplevel command, and if
people get confused, we can promote in the documenation. I think
starting it at top-level is perhaps confusing.
--
Bruce Momjian bruce@momjian.us
EnterpriseDB http://www.enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
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 from your mail client; the link fills in
the headers below: reply via email
Some clients, webmail especially, drop In-Reply-To and References from
a link, and the reply then starts a new thread: use the mbox below.
To: pgsql-docs@postgresql.org
Cc: bruce@momjian.us, swm@linuxworld.com.au, peter_e@gmx.net, tgl@sss.pgh.pa.us, mail@joeconway.com
Subject: Re: Values list-of-targetlists patch for comments (was Re:
In-Reply-To: <200608110307.k7B37AA22420@momjian.us>
References: <Pine.LNX.4.58.0608041042551.16622@linuxworld.com.au> <200608110307.k7B37AA22420@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