Received: from localhost (unknown [200.46.204.183]) by developer.postgresql.org (Postfix) with ESMTP id BE78A2E0087 for ; Thu, 8 May 2008 22:28:08 -0300 (ADT) Received: from developer.postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.183]) (amavisd-maia, port 10024) with ESMTP id 04319-04 for ; Thu, 8 May 2008 22:28:00 -0300 (ADT) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from an-out-0708.google.com (an-out-0708.google.com [209.85.132.246]) by developer.postgresql.org (Postfix) with ESMTP id CF0592E00AD for ; Thu, 8 May 2008 22:28:05 -0300 (ADT) Received: by an-out-0708.google.com with SMTP id d30so244543and.33 for ; Thu, 08 May 2008 18:28:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; bh=83cSDXT6bYS0Y1x6az1JPcJTCAaquLsWthQq4D/50W4=; b=uX+Jlq8sE7TzknQLtrmIIHD3dg4DtEg1lm52iNc+ZO6uIGl4eDSat4a6IBh2DAc6aZBcRPX4Y8/68938g6PfaJ8Ci8qxL3R7Yv2bGXJpA9dPQ4JoXT4nAgByrGU6Gtn7C1iuSoEKo9TgZRNa1uVWFUFTAmC2sdokapbnTUgkfd4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=oH+rLd8SnwjN/Tbx5nDK/WV/vfCnfx5k9vByyXBoXrMEWmELKxT/NDMOu2clW1tJX37G9Mq/glDg7ozZf248kUZKCrFrz5aJidafIvhhDvidpu1GrNBYFmGGIfuebrHTeZpe4SgpCM5DeP3T+ETdZddKr5SGwnSkQcbFV3qmK6A= Received: by 10.100.194.17 with SMTP id r17mr5214322anf.127.1210296484446; Thu, 08 May 2008 18:28:04 -0700 (PDT) Received: by 10.100.123.17 with HTTP; Thu, 8 May 2008 18:28:04 -0700 (PDT) Message-ID: <1d581afe0805081828m1374f54yd96a75c06fbf618b@mail.gmail.com> Date: Fri, 9 May 2008 10:28:04 +0900 From: "Ian Barwick" To: "Peter Eisentraut" Subject: Re: order of entries in admin docs Cc: pgsql-docs@postgresql.org, "Bruce Momjian" , "Alvaro Herrera" , "Scott Marlowe" , "Tom Lane" In-Reply-To: <200805072358.23996.peter_e@gmx.net> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <200805072134.m47LYlY16758@momjian.us> <200805072358.23996.peter_e@gmx.net> X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200805/15 X-Sequence-Number: 4901 2008/5/8 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 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 the options would be the job of the > more extensive documentation elsewhere I mentioned above. > > I think Postfix has arranged this nicely: > http://www.postfix.org/documentation.html -- You have various sections > explaining how to configure for various jobs, and one big list of all > parameters explained. > > -- > Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) > To make changes to your subscription: > http://www.postgresql.org/mailpref/pgsql-docs > -- http://sql-info.de/index.html