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

2010-07-19 Thread Joshua Tolley
On Sat, Jul 17, 2010 at 10:30:13AM -0400, Tom Lane wrote:
> 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.

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.

--
Joshua Tolley / eggyknap
End Point Corporation
http://www.endpoint.com


signature.asc
Description: Digital signature


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

2010-07-19 Thread Thom Brown
On 19 July 2010 15:59, Joshua Tolley  wrote:
> On Sat, Jul 17, 2010 at 10:30:13AM -0400, Tom Lane wrote:
>> 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.
>
> 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

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


Re: [DOCS] 9.0 beta 3 pgbench -- documentation issue

2010-07-19 Thread Greg Smith

Josh Berkus wrote:

However, in the documentation the variable :scale is never set,
resulting in it defaulting to 1.  The example script needs to start with:

\set scale 10
  


Look at table F-15 "pgbench benchmarking options", specifically the 
section for "-s scale_factor".  That describes how the scale is set for 
the internal tests, and that you need to set it manually using "-s 
" for custom scripts run using "-f