Re: Documentation and explanatory diagrams

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.