Re: [DOCS] Documentation and explanatory diagrams

2010-07-17 Thread Bruce Momjian
Tom Lane wrote: > Steve Atkins writes: > > On Jul 16, 2010, at 7:20 PM, Robert Haas wrote: > >> Unless I'm misunderstanding what you're talking about here, this is a > >> really, really bad idea. > > > You're misunderstanding. > > Yeah, I think that in the main you guys are in violent agreement.

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Tom Lane
Heikki Linnakangas writes: > On 17/07/10 23:36, Thom Brown wrote: >> On 17 July 2010 21:30, Joseph Conway wrote: >>> Oracle SELECT: >>> http://download.oracle.com/docs/cd/B14117_01/server.101/b10759/statements_10002.htm >> Yeah, that kinda chaotic. Looks like a sadistic puzzle from the >> Krypt

Re: [DOCS] Management of External Data (SQL/MED) in core?

2010-07-17 Thread Peter Eisentraut
On fre, 2010-07-16 at 13:25 +0100, Thom Brown wrote: > It's probably me not understanding what is being claimed, but on > http://www.postgresql.org/docs/8.4/static/features.html it says > PostgreSQL core covers ISO/IEC 9075-9 Management of External Data > (SQL/MED). I'm aware the actual SQL/MED fu

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Heikki Linnakangas
On 17/07/10 23:36, Thom Brown wrote: On 17 July 2010 21:30, Joseph Conway wrote: On 7/17/10 1:26 PM, Thom Brown wrote: On 17 July 2010 21:23, Dave Page wrote: On Sat, Jul 17, 2010 at 9:19 PM, Thom Brown wrote: While they're quite attractive, I actually see them being more confusing than he

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Thom Brown
On 17 July 2010 21:30, Joseph Conway wrote: > On 7/17/10 1:26 PM, Thom Brown wrote: >> On 17 July 2010 21:23, Dave Page wrote: >>> On Sat, Jul 17, 2010 at 9:19 PM, Thom Brown wrote: While they're quite attractive, I actually see them being more confusing than helpful personally, but I

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Joseph Conway
On 7/17/10 1:26 PM, Thom Brown wrote: > On 17 July 2010 21:23, Dave Page wrote: >> On Sat, Jul 17, 2010 at 9:19 PM, Thom Brown wrote: >>> While they're quite attractive, I actually see them being more >>> confusing than helpful personally, but I could be wrong. I reckon >>> there might be cleare

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Thom Brown
On 17 July 2010 21:23, Dave Page wrote: > On Sat, Jul 17, 2010 at 9:19 PM, Thom Brown wrote: >> While they're quite attractive, I actually see them being more >> confusing than helpful personally, but I could be wrong.  I reckon >> there might be clearer ways of representing statement options.  T

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Dave Page
On Sat, Jul 17, 2010 at 9:19 PM, Thom Brown wrote: > While they're quite attractive, I actually see them being more > confusing than helpful personally, but I could be wrong.  I reckon > there might be clearer ways of representing statement options.  The > real problems with the railroad design co

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Thom Brown
On 17 July 2010 05:33, Steve Atkins wrote: > Has everyone seen the "railroad diagrams" sqlite use in their docs? > http://www.sqlite.org/lang_createindex.html , as one example. > > Would it be nice to have the same sort of format in the postgresql docs? > (Yeah, I'm volunteering, if people think

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Peter Eisentraut
On lör, 2010-07-17 at 08:30 +0300, Heikki Linnakangas wrote: > Any idea how those sqlite images are generated? http://stackoverflow.com/questions/773371/what-is-a-good-tool-for-creating-railroad-diagrams -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your sub

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Tom Lane
Steve Atkins writes: > Has everyone seen the "railroad diagrams" sqlite use in their docs? > http://www.sqlite.org/lang_createindex.html , as one example. They look great for simple cases, but I can't imagine them being very useful for SELECT, as an example. regards, tom

Re: [DOCS] Documentation and explanatory diagrams

2010-07-17 Thread Tom Lane
Steve Atkins writes: > On Jul 16, 2010, at 7:20 PM, Robert Haas wrote: >> Unless I'm misunderstanding what you're talking about here, this is a >> really, really bad idea. > You're misunderstanding. Yeah, I think that in the main you guys are in violent agreement. > My feeling is that SVG is a

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Hannu Krosing
On Sat, 2010-07-17 at 08:30 +0300, Heikki Linnakangas wrote: > On 17/07/10 07:33, Steve Atkins wrote: > > Has everyone seen the "railroad diagrams" sqlite use in their docs? > > http://www.sqlite.org/lang_createindex.html , as one example. > > > > Would it be nice to have the same sort of format i

Re: [DOCS] Railroad diagrams, a-la sqlite

2010-07-17 Thread Hannu Krosing
On Sat, 2010-07-17 at 10:02 +0300, Hannu Krosing wrote: > On Sat, 2010-07-17 at 08:30 +0300, Heikki Linnakangas wrote: > > On 17/07/10 07:33, Steve Atkins wrote: > > > Has everyone seen the "railroad diagrams" sqlite use in their docs? > > > http://www.sqlite.org/lang_createindex.html , as one exa