Re: cmax docs seem misleading

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Paul A Jungwirth <pj(at)illuminatedcomputing(dot)com>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: cmax docs seem misleading
Date: 2026-03-30 22:26:26
Message-ID: 2584452.1774909586@sss.pgh.pa.us
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Paul A Jungwirth <pj(at)illuminatedcomputing(dot)com> writes:
> On Sun, Mar 29, 2026 at 12:45 PM Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>> Yeah, this is a mess. Nobody ever updated this text when we decided we
>> could pack those fields into one. I think it would be better to do
>> what you suggest:

>>> ... And maybe we should be more drastic: combine cmin &
>>> cmax into one entry, and explain that they are two names for the same
>>> value, which might signify the insert cid, the delete cid, or a
>>> combocid.

> I agree that is plenty of detail for user-facing documentation. I
> think your suggested text is a big improvement.

Done like that, then.

regards, tom lane

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Paul A Jungwirth 2026-03-30 23:30:57 Re: Correct docs about GiST leaf page structure
Previous Message Tom Lane 2026-03-30 22:06:01 Re: Correct docs about GiST leaf page structure