Re: Documentation and explanatory diagrams - Mailing list pgsql-docs

From Tom Lane
Subject Re: Documentation and explanatory diagrams
Date
Msg-id 1257.1278123201@sss.pgh.pa.us
Whole thread Raw
In response to Re: Documentation and explanatory diagrams  (Robert Haas <robertmhaas@gmail.com>)
List pgsql-docs
Robert Haas <robertmhaas@gmail.com> writes:
> On Fri, Jul 2, 2010 at 5:43 PM, Bruce Momjian <bruce@momjian.us> wrote:
>> People often built them to verify the SGML markup and to view the
>> content/markup before submitting a doc patch.

> Actually, they often DON'T, which is a problem, and adding more
> requirements is only going to make it worse.

> There is not much reason for an end-user to build the docs - most
> end-users will install from RPMs or one-click installers or whatever.
> But everyone who is a developer needs to be able to build them,

I think that adding dia to the set of requirements isn't that big a
deal, assuming that it's a widely available package.  It's just one
program and should be a lot easier to install and configure than our
other doc toolchain requirements.

What I'm more worried about at the moment is whether it's a reasonable
choice of tool.  If the "source" for a diagram is larger than the PNG
image representation, there is something seriously wrong with the
language design.

            regards, tom lane

pgsql-docs by date:

Previous
From: Peter Eisentraut
Date:
Subject: Re: Documentation and explanatory diagrams
Next
From: Bruce Momjian
Date:
Subject: Re: Documentation and explanatory diagrams