pgsql: Doc: improve explanation of GiST compress/decompress methods.

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Doc: improve explanation of GiST compress/decompress methods.
Date: 2026-03-31 15:23:36
Message-ID: E1w7awJ-002KGJ-0l@gemulon.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Doc: improve explanation of GiST compress/decompress methods.

The docs previously didn't explain that leaf and non-leaf keys
could be treated differently, even though many of our opclasses
do exactly that. It also wasn't explained how that relates to
the STORAGE option, particularly since only one storage type
can be specified for both leaf and non-leaf keys.

While here, reorganize the text slightly, rather than sticking
additional detail into what's supposed to be a brief summary
paragraph.

Author: Paul A Jungwirth <pj(at)illuminatedcomputing(dot)com>
Co-authored-by: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Discussion: https://postgr.es/m/CA+renyWs5Np+FLSYfL+eu20S4U671A3fQGb-+7e22HLrD1NbYw@mail.gmail.com

Branch
------
master

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

Modified Files
--------------
doc/src/sgml/gist.sgml | 31 +++++++++++++++++++++++--------
src/backend/access/gist/README | 9 ++++++++-
2 files changed, 31 insertions(+), 9 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Tom Lane 2026-03-31 15:49:59 pgsql: Doc: remove bogus claim that tsvectors can have up to 2^64 entri
Previous Message Heikki Linnakangas 2026-03-31 14:17:53 pgsql: Change the signature of dynahash's alloc function