DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:date:message-id:subject:from:to
	:cc:content-type:content-transfer-encoding;
	b=vZxkBai7n+NqbZqf5ii2IgQlMpBEge4M0iUt9Xmyk7IOQMcDzMqqLjzflbv7ac9EGL
	/x14kjaU5gqxUpzEQtsRVtkLpD6EnCfnYQrUN+h6E0uLm+aIYvvEyoxbFArwt8P4qDOl
	71PeayMLybykJ5ZvX9jiW2viN3KHFay29WkF0=
MIME-Version: 1.0
In-Reply-To: <201007022143.o62Lh0w26764@momjian.us>
References: <alpine.BSF.2.00.1007021839540.45189@hub.org>
	<201007022143.o62Lh0w26764@momjian.us>
Date: Fri, 2 Jul 2010 17:59:17 -0400
Message-ID: <AANLkTimMqNQqDi2cuIwUzLmIWARfFblZboyQSrTbNZMQ@mail.gmail.com>
Subject: Re: Documentation and explanatory diagrams
From: Robert Haas <robertmhaas@gmail.com>
To: Bruce Momjian <bruce@momjian.us>
Cc: "Marc G. Fournier" <scrappy@hub.org>, Tom Lane <tgl@sss.pgh.pa.us>,
	Alvaro Herrera <alvherre@commandprompt.com>,
	Peter Eisentraut <peter_e@gmx.net>,
	Rafael Martinez <r.m.guerrero@usit.uio.no>,
	pgsql-docs <pgsql-docs@postgresql.org>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On Fri, Jul 2, 2010 at 5:43 PM, Bruce Momjian <bruce@momjian.us> wrote:
> Marc G. Fournier wrote:
>> On Fri, 2 Jul 2010, Robert Haas wrote:
>>
>> > On Fri, Jul 2, 2010 at 5:28 PM, Bruce Momjian <bruce@momjian.us> wrote=
:
>> >> OK, everyone seems to like requiring dia.
>> >
>> > I don't like it a bit. =A0It's hard enough for people to build the doc=
s as
>> > it is.
>>
>> Why should anyone build the docs? =A0Its part of the tarball process, so=
 the
>> only ppl that should be doing it are those coming from CVS, no ... ?
>
> People often built them to verify the SGML markup and to view the
> content/markup before submitting a doc patch.

Actually, they often DON'T, which is a problem, and adding more
requirements is only going to make it worse.

There is not much reason for an end-user to build the docs - most
end-users will install from RPMs or one-click installers or whatever.
But everyone who is a developer needs to be able to build them, many
can't already, and we have quite a lot of developers.  Adding dia will
also create knock-on work for packagers, although that should be
mostly a one-time thing.  I like the idea of being able to have
pictures in our documentation, but I'm a little nervous about the
ramifications.

--=20
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise Postgres Company