To: Alvaro Herrera <alvherre@commandprompt.com>
cc: Peter Eisentraut <peter_e@gmx.net>, John Gage <jsmgage@numericable.fr>,
	PostgreSQL - General <pgsql-general@postgresql.org>
Subject: Re: Cognitive dissonance 
In-reply-to: <1276182912-sup-2656@alvh.no-ip.org> 
References: <29FD1BB6-9AD8-485C-B5D2-23D66C15DC97@numericable.fr>
	<1276152614.32193.0.camel@fsopti579.F-Secure.com>
	<1276182912-sup-2656@alvh.no-ip.org>
Comments: In-reply-to Alvaro Herrera <alvherre@commandprompt.com>
	message dated "Thu, 10 Jun 2010 11:16:37 -0400"
Date: Thu, 10 Jun 2010 11:24:00 -0400
Message-ID: <16964.1276183440@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>

Alvaro Herrera <alvherre@commandprompt.com> writes:
> Excerpts from Peter Eisentraut's message of jue jun 10 02:50:14 -0400 2010:
>> As I said back then, doing this is straightforward, but we kind of need
>> more than one user who asks for it before we make it part of a regular
>> service, which comes with maintenance costs.

> Hey, count me as another interested person in a single-file plain-text
> doc output format.

Well, there are two separate things here:

* providing a Makefile target to build plain-text output.

* shipping prebuilt plain text docs in standard distributions.

I am for #1, not so much for #2, mainly on the grounds of size.  But
given #1 it would be possible for packagers to make their own choices
about whether to include plain-text docs.

			regards, tom lane