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

From Bruce Momjian
Subject Re: Documentation and explanatory diagrams
Date
Msg-id 20120712181636.GC11063@momjian.us
Whole thread Raw
In response to Re: Documentation and explanatory diagrams  (Thom Brown <thombrown@gmail.com>)
List pgsql-docs
On Sun, Jun 12, 2011 at 10:08:05PM +0100, Thom Brown wrote:
> On 27 September 2010 15:29, Thom Brown <thombrown@gmail.com> wrote:
> > On 18 July 2010 11:58, Rafael Martinez <r.m.guerrero@usit.uio.no> wrote:
> >> -----BEGIN PGP SIGNED MESSAGE-----
> >> Hash: SHA1
> >>
> >> Thom Brown wrote:
> >>
> >>> Okay, I just edited an existing dia file: pgclient_server.dia.  All I
> >>> did was change the font size of the text "client application" at the
> >>> top of the diagram, and changed the properties of a line so the
> >>> arrowhead was no longer on the end.  I used dia 0.97.1 to edit the
> >>> file. The result when saving is attached in the diff file.  That's a
> >>> lot of file changes for what I did.
> >>>
> >>> Thom
> >>>
> >>
> >> Indeed.
> >>
> >> The only explanation I can find to this is that I used dia.0.96.1 to
> >> generate the file and you have used 0.97.1 to edit it.
> >>
> >> Almost all changes are to the attributes:
> >>  <dia:rectangle val=....
> >>  <dia:point val=....
> >>
> >> I suspect that these changes have been done because 'something' have
> >> changed between the two main versions in the way they deal with these
> >> attributes :(
> >
> > Has anyone yet come up with a reliable and sensible format we can use?
>
> Obviously nothing for this happened in time to make it for 9.1.  So
> are diagrams still something we plan to have?

One year later, we have made no progress on diagrams in our
documentation.  Do we at least have an agreed-up approach?

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + It's impossible for everything to be true. +

pgsql-docs by date:

Previous
From: Magnus Hagander
Date:
Subject: Re: Search in devel docs?
Next
From: vilpesh
Date:
Subject: Re: postgresql manuals