Cc: PostgreSQL - General <pgsql-general@postgresql.org>,
	Bruce Momjian <bruce@momjian.us>
Message-Id: <A24ED58C-FFD7-4084-908F-AD9852682DD6@numericable.fr>
From: John Gage <jsmgage@numericable.fr>
To: Tom Lane <tgl@sss.pgh.pa.us>
In-Reply-To: <25416.1276348229@sss.pgh.pa.us>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed; delsp=yes
Content-Transfer-Encoding: quoted-printable
Mime-Version: 1.0 (Apple Message framework v936)
Subject: Re: Cognitive dissonance 
Date: Sat, 12 Jun 2010 16:34:17 +0200
References: <201006120120.o5C1KpJ11286@momjian.us>
	<E8548B2E-AE22-4A4D-B30A-C97A6CB722F9@numericable.fr>
	<1276336574.10097.5.camel@vanquo.pezone.net>
	<25416.1276348229@sss.pgh.pa.us>

It was.  But if the compromise is single file html, that is a vast =20
improvement over the current system imho.

What I want is the thing that is maximally amenable to being searched =20=

conveniently using all the tools at our disposal especially regular =20
expressons.  The point has been made that Google is the best system to =20=

search for Postgres documentation/knowledge/etc.  Frankly, I don't =20
necessarily agree with that, particularly for the novice.  The =20
documentation is where it is at, and it is the documentation that is =20
referenced the most in these posts.

But there are no dichotomies here.  It is not either or.  It is a =20
balance between what is easiest to produce and maintain and what is =20
most productive to use.

And the background for my request is my respect for the extraordinary =20=

power and elegance of postgres.

John


On Jun 12, 2010, at 3:10 PM, Tom Lane wrote:

> Peter Eisentraut <peter_e@gmx.net> writes:
>> On l=F6r, 2010-06-12 at 11:18 +0200, John Gage wrote:
>>> A one file html version would be a godsend.
>
>> I've committed a build target for that now.  Use 'make =20
>> postgres.html' in
>> doc/src/sgml/.
>
> Huh, is that actually worth anything?  How many browsers will open it
> without crashing, or will navigate the page with decent performance
> if they do manage to open it?
>
> (Not that I object to providing this Make target.  But I thought the
> discussion was about plain-text output.)
>
> 			regards, tom lane
>
> --=20
> Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
> To make changes to your subscription:
> http://www.postgresql.org/mailpref/pgsql-general