pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedSystem application reference pages
7+ messages / 5 participants
[nested] [flat]
* System application reference pages
@ 2000-11-12 00:06 Peter Eisentraut <peter_e@gmx.net>
0 siblings, 2 replies; 7+ messages in thread
From: Peter Eisentraut @ 2000-11-12 00:06 UTC (permalink / raw)
To: pgsql-docs
The manual pages for initdb, initlocation, ipcclean, pg_passwd,
pg_upgrade, postgres, and postmaster should be moved to the
Administrator's Guide, because their usage is subject of the Admin Guide
and not of the User's Guide. Comments?
--
Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: System application reference pages
@ 2000-11-12 04:14 The Hermit Hacker <scrappy@hub.org>
parent: Peter Eisentraut <peter_e@gmx.net>
1 sibling, 1 reply; 7+ messages in thread
From: The Hermit Hacker @ 2000-11-12 04:14 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
On Sun, 12 Nov 2000, Peter Eisentraut wrote:
> The manual pages for initdb, initlocation, ipcclean, pg_passwd,
> pg_upgrade, postgres, and postmaster should be moved to the
> Administrator's Guide, because their usage is subject of the Admin Guide
> and not of the User's Guide. Comments?
Makes sense to me *nod*
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: System application reference pages
@ 2000-11-12 04:42 Lamar Owen <lamar.owen@wgcr.org>
parent: The Hermit Hacker <scrappy@hub.org>
0 siblings, 1 reply; 7+ messages in thread
From: Lamar Owen @ 2000-11-12 04:42 UTC (permalink / raw)
To: The Hermit Hacker <scrappy@hub.org>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
The Hermit Hacker wrote:
> On Sun, 12 Nov 2000, Peter Eisentraut wrote:
> > The manual pages for initdb, initlocation, ipcclean, pg_passwd,
> > pg_upgrade, postgres, and postmaster should be moved to the
> > Administrator's Guide, because their usage is subject of the Admin Guide
> > and not of the User's Guide. Comments?
> Makes sense to me *nod*
Yep. Makes lots of sense.
--
Lamar Owen
WGCR Internet Radio
1 Peter 4:11
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: System application reference pages
@ 2000-11-12 05:58 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Peter Eisentraut <peter_e@gmx.net>
1 sibling, 0 replies; 7+ messages in thread
From: Thomas Lockhart @ 2000-11-12 05:58 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
> The manual pages for initdb, initlocation, ipcclean, pg_passwd,
> pg_upgrade, postgres, and postmaster should be moved to the
> Administrator's Guide, because their usage is subject of the Admin Guide
> and not of the User's Guide. Comments?
I'd originally put them all in the same place to make it easier to find
them (only one place to look) but division by purpose works too.
- Thomas
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: System application reference pages
@ 2000-11-12 06:17 Tom Lane <tgl@sss.pgh.pa.us>
parent: Lamar Owen <lamar.owen@wgcr.org>
0 siblings, 1 reply; 7+ messages in thread
From: Tom Lane @ 2000-11-12 06:17 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
>>>> The manual pages for initdb, initlocation, ipcclean, pg_passwd,
>>>> pg_upgrade, postgres, and postmaster should be moved to the
>>>> Administrator's Guide, because their usage is subject of the Admin Guide
>>>> and not of the User's Guide. Comments?
Surely pg_ctl also belongs in that group.
One could make an argument that pg_dump, pg_dumpall, pg_restore, and
vacuumdb do too, though it'd be a weaker argument. Also createuser,
dropuser, perhaps createlang/droplang. All of these require superuser
privs to be more than marginally useful, so they strike me as primarily
admin tools not user tools.
regards, tom lane
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: System application reference pages
@ 2000-11-12 10:33 Peter Eisentraut <peter_e@gmx.net>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 7+ messages in thread
From: Peter Eisentraut @ 2000-11-12 10:33 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-docs
Tom Lane writes:
> One could make an argument that pg_dump, pg_dumpall, pg_restore, and
> vacuumdb do too, though it'd be a weaker argument. Also createuser,
> dropuser, perhaps createlang/droplang. All of these require superuser
> privs to be more than marginally useful, so they strike me as primarily
> admin tools not user tools.
If we did that, then it would only be logical to also move the associated
SQL commands, which might open a can of worms since one might also argue
for CREATE TYPE, CREATE FUNCTION, etc. in the programmer's guide, and at
the end we'll have them all over the place.
Perhaps it's time to revive the Reference Manual (reference.sgml) as an
extra, parallel document with only the reference pages.
--
Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: System application reference pages
@ 2000-11-12 16:03 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 0 replies; 7+ messages in thread
From: Thomas Lockhart @ 2000-11-12 16:03 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: Tom Lane <tgl@sss.pgh.pa.us>; pgsql-docs
> Perhaps it's time to revive the Reference Manual (reference.sgml) as an
> extra, parallel document with only the reference pages.
That would be fine (in my mind a better choice). *That* wasn't done
originally simply because the other part of the User's Guide was not
very big, but both pieces could now stand on their own.
- Thomas
^ permalink raw reply [nested|flat] 7+ messages in thread
end of thread, other threads:[~2000-11-12 16:03 UTC | newest]
Thread overview: 7+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2000-11-12 00:06 System application reference pages Peter Eisentraut <peter_e@gmx.net>
2000-11-12 04:14 ` The Hermit Hacker <scrappy@hub.org>
2000-11-12 04:42 ` Lamar Owen <lamar.owen@wgcr.org>
2000-11-12 06:17 ` Tom Lane <tgl@sss.pgh.pa.us>
2000-11-12 10:33 ` Peter Eisentraut <peter_e@gmx.net>
2000-11-12 16:03 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2000-11-12 05:58 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
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