Re: cmax docs seem misleading - Mailing list pgsql-docs

From Tom Lane
Subject Re: cmax docs seem misleading
Date
Msg-id 2584452.1774909586@sss.pgh.pa.us
Whole thread Raw
In response to Re: cmax docs seem misleading  (Paul A Jungwirth <pj@illuminatedcomputing.com>)
List pgsql-docs
Paul A Jungwirth <pj@illuminatedcomputing.com> writes:
> On Sun, Mar 29, 2026 at 12:45 PM Tom Lane <tgl@sss.pgh.pa.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



pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Correct docs about GiST leaf page structure
Next
From: Paul A Jungwirth
Date:
Subject: Re: Correct docs about GiST leaf page structure