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

From Simon Riggs
Subject Re: blatantly a bug in the documentation
Date
Msg-id 1227814703.20796.113.camel@hp_dx2400_1
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, 2008-11-25 at 08:23 -0500, Tom Lane 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.  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

Sounds good.

Please could we do this in a way that allows the example database to be
localised. It will help beginners understand things better if we have
table and column names in the local language. One more thing to
translate maybe, but lets leave the door open for localisation.

-- Simon Riggs           www.2ndQuadrant.comPostgreSQL Training, Services and Support



pgsql-hackers by date:

Previous
From: Simon Riggs
Date:
Subject: Re: New trigger file in pg_standby to promote the standby to the primary
Next
From: Heikki Linnakangas
Date:
Subject: Re: Visibility map, partial vacuums