Re: Alpha 1 release notes

If I didn't read this email I would still be trying to figure out how
to use the explain XML patch. Thanks Albert.

I found the syntax for the explain xml format to be quite difficult to
understand at first, it would be nice to give an example or two, ie:

EXPLAIN (ANALYZE, FORMAT XML) SELECT * FROM foo WHERE i = 4;

The thing that caused me the most trouble was that the "," wasn't very
noticeable sitting near the end of this line:

EXPLAIN [ ( { ANALYZE boolean | VERBOSE boolean | COSTS boolean |
FORMAT { TEXT | XML | JSON } } [, ...] ) ] statement

It may just be me, but I read that as the comma being optional, not
mandatory in circumstances where you want to specify more then one
option. 

Nonetheless, an additional example with multiple options would sure
help.

Thanks.


On Wed, 12 Aug 2009 01:08:54 +0200
Albert Cervera i Areny <albert@nan-tic.com> wrote:

> A Dimecres, 12 d'agost de 2009, Peter Eisentraut va escriure:
> > OK, since there was no clear consensus or volunteer for preparing
> > release notes for alpha 1, I have started something.  Let me know
> > what you think.
> >
> > (reStructuredText, if you want to play around)
> 
> Maybe I'd be interesting to add development docs URL [1] so testers
> can easily find the syntax of new features, or given that they'll be
> downloading the alpha tarball they should use that documentation?
> 
> [1] http://developer.postgresql.org/pgdocs/postgres/index.html
> 


-- 
Mike