Received: from maia.hub.org (maia-2.hub.org [200.46.204.251]) by mail.postgresql.org (Postfix) with ESMTP id 5119C1337C04 for ; Tue, 5 Apr 2011 15:18:27 -0300 (ADT) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.251]) (amavisd-maia, port 10024) with ESMTP id 06778-05 for ; Tue, 5 Apr 2011 18:18:09 +0000 (UTC) X-Greylist: from auto-whitelisted by SQLgrey-1.7.6 Received: from mailout-de.gmx.net (mailout-de.gmx.net [213.165.64.22]) by mail.postgresql.org (Postfix) with SMTP id B98A51337BD0 for ; Tue, 5 Apr 2011 15:18:08 -0300 (ADT) Received: (qmail invoked by alias); 05 Apr 2011 18:18:06 -0000 Received: from a88-115-218-165.elisa-laajakaista.fi (EHLO [10.0.0.101]) [88.115.218.165] by mail.gmx.net (mp012) with SMTP; 05 Apr 2011 20:18:06 +0200 X-Authenticated: #495269 X-Provags-ID: V01U2FsdGVkX191umsy1dh19mihCIussBeOqT9weyJYcXbnI8zCwZ YfYRBufom26pAj Subject: Re: [HACKERS] Uppercase SGML entity declarations From: Peter Eisentraut To: Robert Haas Cc: Christopher Browne , Susanne Ebrecht , Tom Lane , Gabriele Bartolini , pgsql-docs@postgresql.org, PostgreSQL-development In-Reply-To: References: <4D998B49.8050000@2ndQuadrant.it> <4D99F09D.3000606@2ndQuadrant.it> <1503.1301935044@sss.pgh.pa.us> <4D99FF55.9070301@2ndQuadrant.com> Content-Type: text/plain; charset="UTF-8" Date: Tue, 05 Apr 2011 21:18:04 +0300 Message-ID: <1302027484.27487.13.camel@vanquo.pezone.net> Mime-Version: 1.0 X-Mailer: Evolution 2.32.2 Content-Transfer-Encoding: 8bit X-Y-GMX-Trusted: 0 X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.909 tagged_above=-5 required=5 tests=BAYES_00=-1.9, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, T_RP_MATCHES_RCVD=-0.01 X-Spam-Level: X-Archive-Number: 201104/41 X-Sequence-Number: 6612 On mån, 2011-04-04 at 15:02 -0400, Robert Haas wrote: > AFAICT, the biggest problem with our existing toolchain is that it's > hard for some people to get it working. In theory, we have > documentation that explains this: > > http://www.postgresql.org/docs/current/static/docguide-toolsets.html > > However, in contrast to the vast majority of our documentation, it > stinks. Umm, if you look under "Debian Packages", there is a one-line command to execute, which, as far as I can tell, is pretty much guaranteed to get you going. If that doesn't apply to the OS you are working, then either a) You haven't contributed better installation documentation, or b) The makers of your OS haven't bothered to package it properly. No other toolchain will make that principle easier.