pgsql: Revise GIN README - Mailing list pgsql-committers

From Alexander Korotkov
Subject pgsql: Revise GIN README
Date
Msg-id E1iXAjx-0001cr-Cu@gemulon.postgresql.org
Whole thread Raw
List 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
------
REL_12_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/ca05fa5375eb3124660e24346f1bdc3990c118f2

Modified Files
--------------
src/backend/access/gin/README | 214 ++++++++++++++++++++++++++++++++++--------
1 file changed, 176 insertions(+), 38 deletions(-)


pgsql-committers by date:

Previous
From: Alexander Korotkov
Date:
Subject: pgsql: Fix deadlock between ginDeletePage() and ginStepRight()
Next
From: Alexander Korotkov
Date:
Subject: pgsql: Fix deadlock between ginDeletePage() and ginStepRight()