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

From Alvaro Herrera
Subject Re: Documentation and explanatory diagrams
Date
Msg-id 20100405204541.GB5108@alvh.no-ip.org
Whole thread Raw
In response to Re: Documentation and explanatory diagrams  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-docs
Peter Eisentraut wrote:

> Preferably, any tool that we would use would save a reasonably plain
> text source file that we could check into VCS and would provide a tool
> for automatically converting to a variety of target formats.  For
> example, graphviz could work well.  (Not saying that graphviz is the
> right tool for producing the kinds of diagrams that you want, but it
> provides the right toolchain interfaces.)  Dia might, but it would be
> interesting to see how human-readable that XML format really is.  (This
> is necessary for change tracking.  I would like to use a diff tool to
> see what happened to a diagram over various revisions.  If opening the
> file in the editing tool, changing one bit, and saving it produces a
> completely different machine-readable-only XML mush, then it's no good.)

It's ugly, but it seems to work reasonably.  You have to explicitely
tell it not to compress the .dia files.

--
Alvaro Herrera                                http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.

pgsql-docs by date:

Previous
From: Greg Smith
Date:
Subject: Re: Documentation and explanatory diagrams
Next
From: Rafael Martinez
Date:
Subject: Re: Documentation and explanatory diagrams