Skip site navigation (1) Skip section navigation (2)

Re: Values list-of-targetlists patch for comments (was Re:

From: Michael Glaesemann <grzm(at)seespotcode(dot)net>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Gavin Sherry <swm(at)linuxworld(dot)com(dot)au>, Peter Eisentraut <peter_e(at)gmx(dot)net>, pgsql-docs(at)postgresql(dot)org, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Joe Conway <mail(at)joeconway(dot)com>
Subject: Re: Values list-of-targetlists patch for comments (was Re:
Date: 2006-08-11 04:35:46
Message-ID: 6C7F4101-7D91-480A-8540-7185174290B3@seespotcode.net (view raw or flat)
Thread:
Lists: pgsql-docspgsql-hackerspgsql-patches
On Aug 11, 2006, at 12:07 , Bruce Momjian wrote:

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

Perhaps it may be confusing, but at the same time, it's educational  
to put VALUES at the top level. Having not read the SQL spec in  
detail, I do rely on the Postgres documentation as a quick reference.  
Thanks to the high-level of SQL-spec compliance, the Postgres  
documentation is pretty helpful in that way. And I'm always  
pleasantly surprised when I learn something new just from looking  
indices such as this.

Michael Glaesemann
grzm seespotcode net




In response to

pgsql-docs by date

Next:From: Peter EisentrautDate: 2006-08-11 06:26:53
Subject: Re: During compiling sgml files, there is a error message...
Previous:From: Bruce MomjianDate: 2006-08-11 03:07:10
Subject: Re: Values list-of-targetlists patch for comments (was Re:

pgsql-hackers by date

Next:From: Michael GlaesemannDate: 2006-08-11 04:36:39
Subject: Re: [GENERAL] different sort order in windows and linux version
Previous:From: Bruce MomjianDate: 2006-08-11 04:31:05
Subject: Re: [GENERAL] different sort order in windows and linux version

pgsql-patches by date

Next:From: Bruce MomjianDate: 2006-08-11 04:48:08
Subject: Re: Interval aggregate regression failure (expected seems
Previous:From: Bruce MomjianDate: 2006-08-11 04:18:49
Subject: Re: [PATCHES] Adding fulldisjunctions to the contrib

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group