Re: Documentation and explanatory diagrams

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Thom Brown <thombrown(at)gmail(dot)com>
Cc: Rafael Martinez <r(dot)m(dot)guerrero(at)usit(dot)uio(dot)no>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Documentation and explanatory diagrams
Date: 2012-07-12 18:16:36
Message-ID: 20120712181636.GC11063@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Sun, Jun 12, 2011 at 10:08:05PM +0100, Thom Brown wrote:
> On 27 September 2010 15:29, Thom Brown <thombrown(at)gmail(dot)com> wrote:
> > On 18 July 2010 11:58, Rafael Martinez <r(dot)m(dot)guerrero(at)usit(dot)uio(dot)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(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

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

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message vilpesh 2012-07-17 03:26:44 Re: postgresql manuals
Previous Message Magnus Hagander 2012-07-11 17:02:11 Re: Search in devel docs?