Thread: pgsql: Revise GIN README

pgsql: Revise GIN README

From
Alexander Korotkov
Date:
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_6_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/84dcf5235984f45458d13a9e0e486caf97f152ea

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