Re: Railroad diagrams, a-la sqlite

From: Thom Brown <thombrown(at)gmail(dot)com>
To: Joshua Tolley <eggyknap(at)gmail(dot)com>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Steve Atkins <steve(at)blighty(dot)com>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Railroad diagrams, a-la sqlite
Date: 2010-07-19 15:08:11
Message-ID: AANLkTinSbERgI-w6dFSQvHXDTEl2D0dGP3jN2aq40bbI@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On 19 July 2010 15:59, Joshua Tolley <eggyknap(at)gmail(dot)com> wrote:
> On Sat, Jul 17, 2010 at 10:30:13AM -0400, Tom Lane wrote:
>> Steve Atkins <steve(at)blighty(dot)com> 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.
>
> You mean like these from Oracle? http://is.gd/dya2n
>
> In general, looking at those diagrams irritates me, but I think that's mostly
> because Oracle's documentation irritates me generally. The SELECT version
> speicifically is probably not terribly useful, IMO.
>

That page is an abomination! Do they hate their users?

Thom

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Greg Smith 2010-07-19 16:59:56 Re: 9.0 beta 3 pgbench -- documentation issue
Previous Message Joshua Tolley 2010-07-19 14:59:38 Re: Railroad diagrams, a-la sqlite