Received: from maia.hub.org (maia-2.hub.org [200.46.204.251])
	by mail.postgresql.org (Postfix) with ESMTP id 29A71633259
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Fri,  2 Jul 2010 19:07:58 -0300 (ADT)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.251]) (amavisd-maia,
	port 10024) with ESMTP id 99441-10 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Fri,  2 Jul 2010 22:07:56 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from momjian.us (momjian.us [70.90.9.53])
	by mail.postgresql.org (Postfix) with ESMTP id 89C846322F5
	for <pgsql-docs@postgresql.org>; Fri,  2 Jul 2010 19:07:57 -0300 (ADT)
Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id
 o62M7mX02724;
	Fri, 2 Jul 2010 18:07:48 -0400 (EDT)
From: Bruce Momjian <bruce@momjian.us>
Message-Id: <201007022207.o62M7mX02724@momjian.us>
Subject: Re: Documentation and explanatory diagrams
In-Reply-To: <alpine.BSF.2.00.1007021905470.45189@hub.org>
To: "Marc G. Fournier" <scrappy@hub.org>
Date: Fri, 2 Jul 2010 18:07:48 -0400 (EDT)
CC: Robert Haas <robertmhaas@gmail.com>, 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>
X-Mailer: ELM [version 2.4ME+ PL124 (25)]
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"
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/19
X-Sequence-Number: 5675

Marc G. Fournier wrote:
> On Fri, 2 Jul 2010, Bruce Momjian wrote:
> 
> > I am afraid if we don't enable dia by default then we will end up with 
> > production documentation without images.  I think we have to default dia 
> > to on, and give a reasonable error when it doesn't exist, and mention 
> > how to turn it off.
> 
> Okay, I have no problem with either default on or off ... but ... won't th 
> efailure to have prod documentation with images be my fault?  or am I 
> missing something else here?

The point is you will have to explicitly turn off dia/images to build
without images.  That should make anyone building production docs always
generate images, unless they override the default.

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + None of us is going to be here forever. +