Received: from maia.hub.org (maia-3.hub.org [200.46.204.243])
	by mail.postgresql.org (Postfix) with ESMTP id C0B936330EC
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Fri,  2 Jul 2010 23:16:33 -0300 (ADT)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.243]) (amavisd-maia,
	port 10024) with ESMTP id 13323-04 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Sat,  3 Jul 2010 02:16:23 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from sss.pgh.pa.us (sss.pgh.pa.us [66.207.139.130])
	by mail.postgresql.org (Postfix) with ESMTP id C04DA632F66
	for <pgsql-docs@postgresql.org>; Fri,  2 Jul 2010 23:16:25 -0300 (ADT)
Received: from sss2.sss.pgh.pa.us (tgl@localhost [127.0.0.1])
	by sss.pgh.pa.us (8.14.2/8.14.2) with ESMTP id o632GHl4001326;
	Fri, 2 Jul 2010 22:16:17 -0400 (EDT)
To: Robert Haas <robertmhaas@gmail.com>
cc: Bruce Momjian <bruce@momjian.us>, "Marc G. Fournier" <scrappy@hub.org>,
	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>
Subject: Re: Documentation and explanatory diagrams 
In-reply-to: <AANLkTinIlVKtG4jGF7sbBRkMb8LMUJqfK9Ikm6Y-XB_B@mail.gmail.com> 
References: <alpine.BSF.2.00.1007021905470.45189@hub.org>
	<201007022207.o62M7mX02724@momjian.us>
	<AANLkTinIlVKtG4jGF7sbBRkMb8LMUJqfK9Ikm6Y-XB_B@mail.gmail.com>
Comments: In-reply-to Robert Haas <robertmhaas@gmail.com>
	message dated "Fri, 02 Jul 2010 19:02:15 -0400"
Date: Fri, 02 Jul 2010 22:16:17 -0400
Message-ID: <1325.1278123377@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	T_RP_MATCHES_RCVD=-0.01
X-Spam-Level: 
X-Archive-Number: 201007/27
X-Sequence-Number: 5683

Robert Haas <robertmhaas@gmail.com> writes:
> Is it at all practical to ship the PNGs as well as the DIA files in
> CVS, and make rebuilding the PNGs from the DIAs a separate step?

Other than the bulky file sizes I see nothing wrong with that approach.
We have traditionally not required developers to have autoconf installed
unless they wanted to muck with the configure script, and this seems
more or less equivalent.

> Also, I think we need to review these images carefully before adding
> any of them into our docs.

Sure.  These are proof of concept not ready-to-ship diagrams.  What we
ought to be looking at is what the source representation is like and how
easy it is for people to adjust the diagrams.

			regards, tom lane