Content-Type: text/plain; charset=us-ascii
Mime-Version: 1.0 (Apple Message framework v1081)
Subject: Re: Documentation and explanatory diagrams
From: Steve Atkins <steve@blighty.com>
In-Reply-To: <AANLkTilcXNTMNB-NypnELe8utn2iDkzAEauzslih-3Qm@mail.gmail.com>
Date: Sat, 3 Jul 2010 16:29:15 -0700
Content-Transfer-Encoding: 7bit
Message-Id: <4182F022-F336-4D04-8A1D-6D048020386B@blighty.com>
References: <1278124002.25901.12.camel@vanquo.pezone.net>
	<201007030241.o632fZ609530@momjian.us>
	<AANLkTilEpIJrgmpZi2CgL9HvLkVxN-9U26REqhLyye0u@mail.gmail.com>
	<AANLkTikNVB8sKyV3WDU74JqSYzQUwbaPz87Qh2FfVlqu@mail.gmail.com>
	<AANLkTimPf3_PmCXDOLknTGM2PEUdrEfaIh-JqhtJ5vyZ@mail.gmail.com>
	<18382.1278198852@sss.pgh.pa.us>
	<AANLkTilcXNTMNB-NypnELe8utn2iDkzAEauzslih-3Qm@mail.gmail.com>
To: pgsql-docs <pgsql-docs@postgresql.org>


On Jul 3, 2010, at 4:16 PM, Robert Haas wrote:

> On Sat, Jul 3, 2010 at 7:14 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> Robert Haas <robertmhaas@gmail.com> writes:
>>> Seems like a good one.  But I'd still like to know the answer to the
>>> question I asked upthread - how is anyone supposed to generate images
>>> this way?
>> 
>> Hmm, judging from
>> http://live.gnome.org/Dia
>> 
>> the answer is that .dia files aren't meant to be human readable but only
>> to be a storage format for WYSIWYG editing.  I find this less than
>> thrilling: it essentially means you *can't* edit the images any other
>> way than using dia.  (I'd bet a nickel that any small change results in
>> massive changes in the file contents, too, which will be un-fun for
>> keeping them in a VCS.)
> 
> Anyone know of any other alternatives we could investigate?

SVG is one option.

Natively supported in all web browsers but one (and that has a
workaround), vector based, and there are a bunch of editors for it.

There are several rasterizers to png, I'm not sure which would be
least painful as part of a build chain.

( http://www.mediawiki.org/wiki/Manual:%24wgSVGConverters )

Cheers,
  Steve