pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feeduser guide
9+ messages / 7 participants
[nested] [flat]
* user guide
@ 2001-08-06 11:40 Tony Grant <tony@animaproductions.com>
2001-08-06 15:35 ` Re: user guide David Wheeler <David@Wheeler.net>
0 siblings, 1 reply; 9+ messages in thread
From: Tony Grant @ 2001-08-06 11:40 UTC (permalink / raw)
To: postgres list <pgsql-general@postgresql.org>
hello,
This weekend I read the User guide front to back. I hadn't done that
since 6.2 or thereabouts...
I have one request for improvement:
In the CREATE DATABASE chapter it may be usefull to include the options
for LATIN1 etc. I was a bit surprized that they weren't there seeing the
international following of the software. For a newcomer this could save
a certain number of hours of headscratching when the accentuated
characters don't show up...
If I was to rate the manual I would say "better than many manuals for
shrinkwrap software but loses steam towards the end".
Cheers
Tony Grant
--
RedHat Linux on Sony Vaio C1XD/S
http://www.animaproductions.com/linux2.html
Macromedia UltraDev with PostgreSQL
http://www.animaproductions.com/ultra.html
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: user guide
2001-08-06 11:40 user guide Tony Grant <tony@animaproductions.com>
@ 2001-08-06 15:35 ` David Wheeler <David@Wheeler.net>
2001-08-06 16:19 ` Re: user guide Tom Lane <tgl@sss.pgh.pa.us>
2001-08-06 16:27 ` Re: user guide Peter Eisentraut <peter_e@gmx.net>
2001-08-06 23:05 ` Re: user guide Chris <csmith@squiz.net>
0 siblings, 3 replies; 9+ messages in thread
From: David Wheeler @ 2001-08-06 15:35 UTC (permalink / raw)
To: postgres list <pgsql-general@postgresql.org>
On 6 Aug 2001, Tony Grant wrote:
> hello,
>
> This weekend I read the User guide front to back. I hadn't done that
> since 6.2 or thereabouts...
>
> I have one request for improvement:
<snip>
I have a suggestion, as well: I think the PostgreSQL documentatio could
use a section that discusses all the maintenance issues in one place.
Documentation for VACUUM is stuck in the Reference section, when I think
it makes sense to also cover it in the Admin Section. Here's waht I'd like
to see in Adin:
Backup and Restor (already there)
Database Mainentence
VACUUM
VACUUM ANALYZE
Rebuilding Indexes (Does this even apply to PG?)
Thanks,
David
--
David Wheeler AIM: dwTheory
David@Wheeler.net ICQ: 15726394
Yahoo!: dew7e
Jabber: Theory@jabber.org
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: user guide
2001-08-06 11:40 user guide Tony Grant <tony@animaproductions.com>
2001-08-06 15:35 ` Re: user guide David Wheeler <David@Wheeler.net>
@ 2001-08-06 16:19 ` Tom Lane <tgl@sss.pgh.pa.us>
2 siblings, 0 replies; 9+ messages in thread
From: Tom Lane @ 2001-08-06 16:19 UTC (permalink / raw)
To: David Wheeler <David@Wheeler.net>; +Cc: postgres list <pgsql-general@postgresql.org>
David Wheeler <David@Wheeler.net> writes:
> I have a suggestion, as well: I think the PostgreSQL documentatio could
> use a section that discusses all the maintenance issues in one place.
I agree. Do I hear a volunteer to write it?
regards, tom lane
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: user guide
2001-08-06 11:40 user guide Tony Grant <tony@animaproductions.com>
2001-08-06 15:35 ` Re: user guide David Wheeler <David@Wheeler.net>
@ 2001-08-06 16:27 ` Peter Eisentraut <peter_e@gmx.net>
2001-08-07 00:07 ` Re: user guide Thomas Lockhart <lockhart@alumni.caltech.edu>
2 siblings, 1 reply; 9+ messages in thread
From: Peter Eisentraut @ 2001-08-06 16:27 UTC (permalink / raw)
To: David Wheeler <David@Wheeler.net>; +Cc: postgres list <pgsql-general@postgresql.org>
David Wheeler writes:
> I have a suggestion, as well: I think the PostgreSQL documentatio could
> use a section that discusses all the maintenance issues in one place.
This is already on the TODO list.
--
Peter Eisentraut peter_e@gmx.net http://funkturm.homeip.net/~peter
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: user guide
2001-08-06 11:40 user guide Tony Grant <tony@animaproductions.com>
2001-08-06 15:35 ` Re: user guide David Wheeler <David@Wheeler.net>
2001-08-06 16:27 ` Re: user guide Peter Eisentraut <peter_e@gmx.net>
@ 2001-08-07 00:07 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2001-08-07 23:11 ` Re: [GENERAL] user guide Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 9+ messages in thread
From: Thomas Lockhart @ 2001-08-07 00:07 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; PostgreSQL Hackers Mailing List <pgsql-hackers@postgresql.org>; +Cc: David Wheeler <David@Wheeler.net>; postgres list <pgsql-general@postgresql.org>
> > I have a suggestion, as well: I think the PostgreSQL documentatio could
> > use a section that discusses all the maintenance issues in one place.
> This is already on the TODO list.
I've started expanding the Admin chapter on database recovery (expanding
was easy; it has been "Any volunteers to write this?" for two or three
years now). At the moment, I've split the info into two chapters on
"Failure" (discussing various failure scenarios) and "Recovery".
Comments and organizational suggestions are welcome. Will commit
sometime soon so others can contribute if they would like.
- Thomas
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [GENERAL] user guide
2001-08-06 11:40 user guide Tony Grant <tony@animaproductions.com>
2001-08-06 15:35 ` Re: user guide David Wheeler <David@Wheeler.net>
2001-08-06 16:27 ` Re: user guide Peter Eisentraut <peter_e@gmx.net>
2001-08-07 00:07 ` Re: user guide Thomas Lockhart <lockhart@alumni.caltech.edu>
@ 2001-08-07 23:11 ` Peter Eisentraut <peter_e@gmx.net>
2001-08-08 01:19 ` Re: [GENERAL] user guide Thomas Lockhart <lockhart@fourpalms.org>
0 siblings, 1 reply; 9+ messages in thread
From: Peter Eisentraut @ 2001-08-07 23:11 UTC (permalink / raw)
To: thomas@pgsql.com; +Cc: pgsql-docs
Thomas Lockhart writes:
> I've started expanding the Admin chapter on database recovery (expanding
> was easy; it has been "Any volunteers to write this?" for two or three
> years now). At the moment, I've split the info into two chapters on
> "Failure" (discussing various failure scenarios) and "Recovery".
Seems like that should be only one chapter.
--
Peter Eisentraut peter_e@gmx.net http://funkturm.homeip.net/~peter
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [GENERAL] user guide
2001-08-06 11:40 user guide Tony Grant <tony@animaproductions.com>
2001-08-06 15:35 ` Re: user guide David Wheeler <David@Wheeler.net>
2001-08-06 16:27 ` Re: user guide Peter Eisentraut <peter_e@gmx.net>
2001-08-07 00:07 ` Re: user guide Thomas Lockhart <lockhart@alumni.caltech.edu>
2001-08-07 23:11 ` Re: [GENERAL] user guide Peter Eisentraut <peter_e@gmx.net>
@ 2001-08-08 01:19 ` Thomas Lockhart <lockhart@fourpalms.org>
0 siblings, 0 replies; 9+ messages in thread
From: Thomas Lockhart @ 2001-08-08 01:19 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: thomas@pgsql.com; pgsql-docs
> > I've started expanding the Admin chapter on database recovery (expanding
> > was easy; it has been "Any volunteers to write this?" for two or three
> > years now). At the moment, I've split the info into two chapters on
> > "Failure" (discussing various failure scenarios) and "Recovery".
> Seems like that should be only one chapter.
Yes, maybe. Easy enough to merge back together. I split them because
there is not a one to one correspondence between potential failures and
recovery procedures.
- Thomas
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: user guide
2001-08-06 11:40 user guide Tony Grant <tony@animaproductions.com>
2001-08-06 15:35 ` Re: user guide David Wheeler <David@Wheeler.net>
@ 2001-08-06 23:05 ` Chris <csmith@squiz.net>
2001-08-07 00:14 ` Re: [GENERAL] Re: user guide Tom Lane <tgl@sss.pgh.pa.us>
2 siblings, 1 reply; 9+ messages in thread
From: Chris @ 2001-08-06 23:05 UTC (permalink / raw)
To: pgsql-general@postgresql.org
Hi,
> > I have a suggestion, as well: I think the PostgreSQL documentatio could
> > use a section that discusses all the maintenance issues in one place.
>
>I agree. Do I hear a volunteer to write it?
I'd be interested in looking at it.
Is it just this todo item : Add mention of VACUUM, log rotation to
Administrator's Guide ?
-----------------
Chris Smith
http://www.squiz.net/
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [GENERAL] Re: user guide
2001-08-06 11:40 user guide Tony Grant <tony@animaproductions.com>
2001-08-06 15:35 ` Re: user guide David Wheeler <David@Wheeler.net>
2001-08-06 23:05 ` Re: user guide Chris <csmith@squiz.net>
@ 2001-08-07 00:14 ` Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 9+ messages in thread
From: Tom Lane @ 2001-08-07 00:14 UTC (permalink / raw)
To: Chris <csmith@squiz.net>; +Cc: pgsql-general@postgresql.org; pgsql-docs
Chris <csmith@squiz.net> writes:
>>> I have a suggestion, as well: I think the PostgreSQL documentatio could
>>> use a section that discusses all the maintenance issues in one place.
>>
>> I agree. Do I hear a volunteer to write it?
> I'd be interested in looking at it.
> Is it just this todo item : Add mention of VACUUM, log rotation to
> Administrator's Guide ?
That was added as a result of the thread starting at
http://fts.postgresql.org/db/mw/msg.html?mid=115811
There are two things I think we need: one is a discussion of each of
these topics (which AFAIR are presently discussed nowhere); the other
is a short "checklist of maintenance concerns" that links to longer
discussions of each relevant topic. For example, there's already a
discussion of backup methods, but it'd be good if that were listed in a
checklist of things for the budding admin to think about.
Or you could reorganize the Admin Guide so that backup and these other
things are sections in a Maintenance chapter. Not sure if that'd be
better.
regards, tom lane
^ permalink raw reply [nested|flat] 9+ messages in thread
end of thread, other threads:[~2001-08-08 01:19 UTC | newest]
Thread overview: 9+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2001-08-06 11:40 user guide Tony Grant <tony@animaproductions.com>
2001-08-06 15:35 ` David Wheeler <David@Wheeler.net>
2001-08-06 16:19 ` Tom Lane <tgl@sss.pgh.pa.us>
2001-08-06 16:27 ` Peter Eisentraut <peter_e@gmx.net>
2001-08-07 00:07 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2001-08-07 23:11 ` Peter Eisentraut <peter_e@gmx.net>
2001-08-08 01:19 ` Thomas Lockhart <lockhart@fourpalms.org>
2001-08-06 23:05 ` Chris <csmith@squiz.net>
2001-08-07 00:14 ` Tom Lane <tgl@sss.pgh.pa.us>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox