Re: blatantly a bug in the documentation - Mailing list pgsql-hackers

From Dave Page
Subject Re: blatantly a bug in the documentation
Date
Msg-id 937d27e10811250532q13c7b02fh15958615dab2e645@mail.gmail.com
Whole thread Raw
In response to Re: blatantly a bug in the documentation  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-hackers
On Tue, Nov 25, 2008 at 1:23 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> "Dave Page" <dpage@pgadmin.org> writes:
>> I'm in favour of including it by default (at initdb), so it's there
>> for new users to play with on any fresh install - however, there is
>> only a point to that if all the documentation examples are based on
>> that database to allow copy-paste-play.
>
> You would also have to assume that all the examples are non-destructive,
> and that no one ever extends an example in a destructive way.

That's a good point.

> This
> seems like a non-starter.  Better to provide the sample database in a
> form in which it can be easily dropped/reloaded.  I'm envisioning that
> there's a source file in $sharedir and we tell people
>
>        createdb example
>        psql -f $sharedir/example.sql example

I was assuming that it would be in such a form anyway - similar to
system_views.sql for example. I'd be happy with that setup - it's far
better than referring people to pgFoundry, and should be simple for
anyone to use.


-- 
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com


pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Exporting PGINTERVALSTYLE prevents access to older server versions
Next
From: "Pavan Deolasee"
Date:
Subject: Re: Review: Hot standby