Re: pgsql: Add lock matrix to documentation.

From: "Merlin Moncure" <mmoncure(at)gmail(dot)com>
To: "Oleg Bartunov" <oleg(at)sai(dot)msu(dot)su>
Cc: "Peter Eisentraut" <peter_e(at)gmx(dot)net>, pgsql-committers(at)postgresql(dot)org, pgsql-hackers(at)postgresql(dot)org
Subject: Re: pgsql: Add lock matrix to documentation.
Date: 2007-02-09 14:21:20
Message-ID: b42b73150702090621h551dbec4p8594b8c72d8b9a48@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-hackers

On 2/9/07, Oleg Bartunov <oleg(at)sai(dot)msu(dot)su> wrote:
> On Fri, 9 Feb 2007, Peter Eisentraut wrote:
>
> > Am Donnerstag, 8. Februar 2007 16:32 schrieb Bruce Momjian:
> >> Log Message:
> >> -----------
> >> Add lock matrix to documentation.
> >
> > This needs some revisions. The table needs to be mentioned somewhere in the
> > text, so the reader knows when or why to refer to it. Also, the cryptic
> > abbreviations need to be expanded or explained. And then the concept of
> > lock "compatibility", as the table puts it, is not used anywhere else in the
> > documentation. The table should be put in terms of conflicts instead.
> >
>
> Another version with expanded abbreviations is
> http://mira.sai.msu.su/~megera/pgsql/lockmatrix/c2.html, if remove
> UPDATE EXCLUSIVE.
>
> While compatibility matrix is a commonly accepted termin, I agree, that
> using conficts would be better in context of our docs.

How about changing 'current lock mode' to 'opposing lock mode'?
'current' kind of suggests that you are escalating your own lock.

merlin

In response to

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message Andrew Dunstan 2007-02-09 14:30:23 Re: pgsql: Add lock matrix to documentation.
Previous Message Heikki Linnakangas 2007-02-09 12:19:35 Re: plpsm - plpgpsm: prepare for phantom cid

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2007-02-09 14:28:28 Re: [PATCHES] [pgsql-patches] Phantom Command IDs, updated patch
Previous Message Bruce Momjian 2007-02-09 14:20:45 Re: Variable length varlena headers redux