Received: from localhost (unknown [200.46.204.184]) by developer.postgresql.org (Postfix) with ESMTP id 39A0D2E004B for ; Wed, 7 May 2008 15:27:13 -0300 (ADT) Received: from developer.postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.184]) (amavisd-maia, port 10024) with ESMTP id 77315-02 for ; Wed, 7 May 2008 15:27:04 -0300 (ADT) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from momjian.us (momjian.us [70.90.9.53]) by developer.postgresql.org (Postfix) with ESMTP id E13272E0047 for ; Wed, 7 May 2008 15:27:05 -0300 (ADT) Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id m47IR4j04395; Wed, 7 May 2008 14:27:04 -0400 (EDT) From: Bruce Momjian Message-Id: <200805071827.m47IR4j04395@momjian.us> Subject: Re: order of entries in admin docs In-Reply-To: To: Scott Marlowe Date: Wed, 7 May 2008 14:27:04 -0400 (EDT) CC: Tom Lane , pgsql-docs@postgresql.org X-Mailer: ELM [version 2.4ME+ PL124 (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="US-ASCII" X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200805/6 X-Sequence-Number: 4892 Scott Marlowe wrote: > On Wed, May 7, 2008 at 10:39 AM, Bruce Momjian 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 Authentication > > > section. I'd move it up a level, so that it looked something like > > > this: > > > > > > 18.3. Connections and Authentication > > > > > > 18.3.1. Connection Settings > > > 18.3.2. Security and Authentication > > > 18.3.3. The pg_hba.conf file > > > 18.3.4. Authentication methods > > > 18.3.5. Authentication problems > > > > > > Unless a different level of indentation makes more sense, which I > > > could totally understand. > > > > > > It definitely follows the flow of setting up a pg server better for > > > me. I might even move the pg_hba.conf file to 18.3.1 up there. It is > > > pretty much a firewall. > > > > I don't think this change makes sense --- All the "Connection Settings" > > stuff is in postgresql.conf. Pulling authentication in there will be too > > complex, I am afraid. > > 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 postgresql.conf documentation in the same chapter. To move it would split that up, which I think is confusing. > The other move still makes more sense to me than the way it was > originally though. I did move the Authentication chapter up to after Configuration Settings so the order now is: 17. Operating System Environment 18. Server Configuration 19. Client Authentication 20. Database Roles and Privileges 21. Managing Databases 22. Localization -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. +