Date: Fri, 2 Jul 2010 18:57:59 -0300 (ADT)
From: "Marc G. Fournier" <scrappy@hub.org>
To: Bruce Momjian <bruce@momjian.us>
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>
Subject: Re: Documentation and explanatory diagrams
In-Reply-To: <201007022143.o62Lh0w26764@momjian.us>
Message-ID: <alpine.BSF.2.00.1007021856560.45189@hub.org>
References: <201007022143.o62Lh0w26764@momjian.us>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed

On Fri, 2 Jul 2010, Bruce Momjian 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.  It's hard enough for people to build the docs as
>>> it is.
>>
>> Why should anyone build the docs?  Its 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.

Good point ... so, part of the Makefile should be modified for a flag to 
disable dia build?  "make NO_DIA=yes" ?  Or, maybe have it default to NO 
and for the tarball build, I'd modify the script for building it?

----
Marc G. Fournier                        Hub.Org Hosting Solutions S.A.
scrappy@hub.org                                     http://www.hub.org

Yahoo:yscrappy    Skype: hub.org    ICQ:7615664    MSN:scrappy@hub.org