pgsql: Revise GIN README

From: Alexander Korotkov <akorotkov(at)postgresql(dot)org>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Revise GIN README
Date: 2019-11-19 21:15:49
Message-ID: E1iXAqj-0001ih-C7@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Revise GIN README

We find GIN concurrency bugs from time to time. One of the problems here is
that concurrency of GIN isn't well-documented in README. So, it might be even
hard to distinguish design bugs from implementation bugs.

This commit revised concurrency section in GIN README providing more details.
Some examples are illustrated in ASCII art.

Also, this commit add the explanation of how is tuple layout in internal GIN
B-tree page different in comparison with nbtree.

Discussion: https://postgr.es/m/CAPpHfduXR_ywyaVN4%2BOYEGaw%3DcPLzWX6RxYLBncKw8de9vOkqw%40mail.gmail.com
Author: Alexander Korotkov
Reviewed-by: Peter Geoghegan
Backpatch-through: 9.4

Branch
------
REL9_4_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/91ce01a6e07b27e8c293abe4d2d565e0d8ae4021

Modified Files
--------------
src/backend/access/gin/README | 209 +++++++++++++++++++++++++++++++++---------
1 file changed, 168 insertions(+), 41 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Alexander Korotkov 2019-11-19 21:19:39 pgsql: Fix page modification outside of critical section in GIN
Previous Message Alexander Korotkov 2019-11-19 21:15:43 pgsql: Revise GIN README