Re: Alpha 1 release notes - Mailing list pgsql-hackers

From Mike
Subject Re: Alpha 1 release notes
Date
Msg-id 20090811172345.40726d7b@ipso.snappymail.ca
Whole thread Raw
In response to Re: Alpha 1 release notes  (Albert Cervera i Areny <albert@nan-tic.com>)
Responses Re: Alpha 1 release notes  (Alvaro Herrera <alvherre@commandprompt.com>)
List pgsql-hackers
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


pgsql-hackers by date:

Previous
From: Greg Stark
Date:
Subject: Re: pgindent timing (was Re: [COMMITTERS] pgsql: Refactor NUM_cache_remove calls in error report path to a PG_TRY)
Next
From: Alvaro Herrera
Date:
Subject: Re: Alpha 1 release notes