Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Alvaro Herrera
Peter Eisentraut escribió: > What I would like to see is getting rid of the sections the parameters are > grouped in and put them all in alphabetical order. I find the current > arrangement completely unusable; nine times out of ten I cannot find the > right section. The topical grouping of t

Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Peter Eisentraut
Bruce Momjian wrote: > There isn't much additional text except a description of each item. That's the way it should be: Each parameter explains what it does. There can be more extensive documentation about how they all fit together elsewhere. What I would like to see is getting rid of the secti

Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Bruce Momjian
Alvaro Herrera wrote: > > > Perhaps it would be better to have prose explaining all the stuff > > > structured like Scott proposes, and make the postgresql.conf be just a > > > reference linking to that. I don't think making postgresql.conf be the > > > primary documentation is very nice. > > > >

Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Alvaro Herrera
Bruce Momjian escribió: > Alvaro Herrera wrote: > > Bruce Momjian escribi?: > > > Scott Marlowe wrote: > > > > > > Well, if you say so. It seems like a natural part of it to me, but > > > > the modifications required to move things like that are pretty big, > > > > and I really don't feel comfort

Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Bruce Momjian
Alvaro Herrera wrote: > Bruce Momjian escribi?: > > Scott Marlowe wrote: > > > > Well, if you say so. It seems like a natural part of it to me, but > > > the modifications required to move things like that are pretty big, > > > and I really don't feel comfortable enough in sgml to get it right. >

Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Alvaro Herrera
Bruce Momjian escribió: > Scott Marlowe wrote: > > Well, if you say so. It seems like a natural part of it to me, but > > the modifications required to move things like that are pretty big, > > and I really don't feel comfortable enough in sgml to get it right. > > Right now we have all postgres

Re: [DOCS] Email contact address for pg_standby

2008-05-07 Thread Alvaro Herrera
Simon Riggs wrote: > Could somebody re-add my email address to the pg_standby docs page? Done. -- Alvaro Herrerahttp://www.CommandPrompt.com/ The PostgreSQL Company - Command Prompt, Inc. -- Sent via pgsql-docs mailing list ([email protected]) To make ch

[DOCS] Email contact address for pg_standby

2008-05-07 Thread Simon Riggs
Could somebody re-add my email address to the pg_standby docs page? It appears to have been removed while adding it to the main docs. Thanks, -- Simon Riggs 2ndQuadrant http://www.2ndQuadrant.com -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your sub

Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Bruce Momjian
Scott Marlowe wrote: > On Wed, May 7, 2008 at 10:39 AM, Bruce Momjian <[EMAIL PROTECTED]> wrote: > > Scott Marlowe wrote: > > > The more I read the docs, the more moving client authentication seems > > > to make sense. In fact, the authentication problems section is > > > probably the perfect f

Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Scott Marlowe
On Wed, May 7, 2008 at 10:39 AM, Bruce Momjian <[EMAIL PROTECTED]> wrote: > Scott Marlowe wrote: > > The more I read the docs, the more moving client authentication seems > > to make sense. In fact, the authentication problems section is > > probably the perfect final bit to the Connections and

Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Bruce Momjian
Scott Marlowe wrote: > The more I read the docs, the more moving client authentication seems > to make sense. In fact, the authentication problems section is > probably the perfect final bit to the Connections and Authentication > section. I'd move it up a level, so that it looked something like

Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Bruce Momjian
Scott Marlowe wrote: > I was just looking for something in the admin docs, and it seems like > the ordering of sections is sub-optimal. > > 17. Operating System Environment > 18. Server Configuration > 19. Database Roles and Privileges > 20. Managing Databases > 21. Client Authentication > > Seem

Re: [DOCS] order of entries in admin docs

2008-05-07 Thread Bruce Momjian
Tom Lane wrote: > Something else that ought to be considered here is that now that we have > CONNECT privilege for databases, manipulating privileges is a lot saner > way to control who-can-connect-where than setting up fancy combinations > of user and database entries in pg_hba.conf. AFAIR there