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

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

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Gavin Sherry <swm(at)linuxworld(dot)com(dot)au>
Cc: 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 03:07:10
Message-ID: 200608110307.k7B37AA22420@momjian.us (view raw or flat)
Thread:
Lists: pgsql-docspgsql-hackerspgsql-patches
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(at)momjian(dot)us
  EnterpriseDB    http://www.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +

In response to

Responses

pgsql-docs by date

Next:From: Michael GlaesemannDate: 2006-08-11 04:35:46
Subject: Re: Values list-of-targetlists patch for comments (was Re:
Previous:From: Peter EisentrautDate: 2006-08-10 15:00:07
Subject: Re: During compiling sgml files, there is a error message...

pgsql-hackers by date

Next:From: Bruce MomjianDate: 2006-08-11 03:20:12
Subject: Re: 8.2 features status
Previous:From: Christopher Kings-LynneDate: 2006-08-11 03:05:55
Subject: Bison Version

pgsql-patches by date

Next:From: Bruce MomjianDate: 2006-08-11 03:48:30
Subject: Re: [pstehule@ilikethis.cz: plperl enhancing return
Previous:From: Tom LaneDate: 2006-08-11 00:17:00
Subject: Re: Plugins redux (was Re: [PATCHES] PL instrumentation

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