Re: Tutorial ?? - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: Tutorial ??
Date
Msg-id Pine.LNX.4.21.0007060318000.347-100000@localhost.localdomain
Whole thread Raw
In response to Tutorial ??  (paul simdars <psimdars@lisco.com>)
List pgsql-docs
paul simdars writes:

> My feeling is that a user's guide should tell a person how to actually
> use the database system.

It could be argued that the user's guide is misnamed. At the end of the
day everybody is a "user". The user's guide as it is essentially
describes the query language environment. (Okay, so "Query language
environment handbook" doesn't sound quite as cool. :)

> First, I believe you are unable to start the postmaster from the
> information in the tutorial.

Everything that has to do with the database server is described in the
administrator's guide. Or at least I'm trying very hard to explain it
there for 7.1. :)

> I believe that is in the RPM readme. Second, (and I don't know how to
> do this) is how to actually get into it.  I have read that somewhere
> but can't remember where.  I think there should be some simple
> instructions somewhere between 'setting up your environment' and
> 'managing a database'.  A tutorial should say " type XXX at the
> prompt" to start postgres for user XXX.

Last time I checked, the tutorial does just that. If the wording is less
than ideal, then please suggest ways to make it better. The tutorial is
the least maintained part of the documentation.


--
Peter Eisentraut                  Sernanders väg 10:115
peter_e@gmx.net                   75262 Uppsala
http://yi.org/peter-e/            Sweden


pgsql-docs by date:

Previous
From: Thomas Lockhart
Date:
Subject: Re: Tutorial ??
Next
From: "David J. MacKenzie"
Date:
Subject: missing PostgreSQL man page