From: | Bruce Momjian <bruce(at)momjian(dot)us> |
---|---|
To: | "Marc G(dot) Fournier" <scrappy(at)hub(dot)org> |
Cc: | Robert Haas <robertmhaas(at)gmail(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Alvaro Herrera <alvherre(at)commandprompt(dot)com>, Peter Eisentraut <peter_e(at)gmx(dot)net>, Rafael Martinez <r(dot)m(dot)guerrero(at)usit(dot)uio(dot)no>, pgsql-docs <pgsql-docs(at)postgresql(dot)org> |
Subject: | Re: Documentation and explanatory diagrams |
Date: | 2010-07-02 22:04:29 |
Message-ID: | 201007022204.o62M4Tj29920@momjian.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
Marc G. Fournier wrote:
> 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(at)momjian(dot)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?
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.
--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ None of us is going to be here forever. +
From | Date | Subject | |
---|---|---|---|
Next Message | Marc G. Fournier | 2010-07-02 22:06:31 | Re: Documentation and explanatory diagrams |
Previous Message | Robert Haas | 2010-07-02 21:59:17 | Re: Documentation and explanatory diagrams |