X-Original-To: pgsql-docs-postgresql.org@postgresql.org Received: from localhost (mx1.hub.org [200.46.208.251]) by postgresql.org (Postfix) with ESMTP id D7CCC9FB341 for ; Fri, 11 Aug 2006 00:07:27 -0300 (ADT) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.208.251]) (amavisd-new, port 10024) with ESMTP id 16706-02 for ; Fri, 11 Aug 2006 00:07:23 -0300 (ADT) X-Greylist: from auto-whitelisted by SQLgrey- Received: from momjian.us (momjian.us [70.90.9.53]) by postgresql.org (Postfix) with ESMTP id 1E5C59FB335 for ; Fri, 11 Aug 2006 00:07:17 -0300 (ADT) Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id k7B37AA22420; Thu, 10 Aug 2006 23:07:10 -0400 (EDT) From: Bruce Momjian Message-Id: <200608110307.k7B37AA22420@momjian.us> Subject: Re: Values list-of-targetlists patch for comments (was Re: In-Reply-To: To: Gavin Sherry Date: Thu, 10 Aug 2006 23:07:10 -0400 (EDT) CC: Peter Eisentraut , pgsql-docs@postgresql.org, Tom Lane , Joe Conway X-Mailer: ELM [version 2.4ME+ PL122k (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="US-ASCII" X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=0.06 tagged_above=0 required=5 tests=AWL, SPF_HELO_PASS, SPF_PASS X-Spam-Level: X-Archive-Number: 200608/31 X-Sequence-Number: 3649 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. +