Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps  (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1tIvzT-00HX88-Hr
	for pgsql-hackers@arkaria.postgresql.org; Wed, 04 Dec 2024 20:28:55 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.94.2)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1tIvzP-002Jac-EL
	for pgsql-hackers@arkaria.postgresql.org; Wed, 04 Dec 2024 20:28:52 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps  (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1tIvzP-002JaU-4J
	for pgsql-hackers@lists.postgresql.org; Wed, 04 Dec 2024 20:28:52 +0000
Received: from sss.pgh.pa.us ([68.162.161.243])
	by makus.postgresql.org with esmtps  (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
	(Exim 4.94.2)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1tIvzJ-0013yh-Hh
	for pgsql-hackers@postgresql.org; Wed, 04 Dec 2024 20:28:50 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 4B4KSaBN2391664;
	Wed, 4 Dec 2024 15:28:36 -0500
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Peter Eisentraut <peter@eisentraut.org>
cc: Noah Misch <noah@leadboat.com>, "David E. Wheeler" <david@justatheory.com>,
        Aleksander Alekseev <aleksander@timescale.com>,
        pgsql-hackers <pgsql-hackers@postgresql.org>,
        Marco Slot <marco.slot@gmail.com>,
        Alvaro Herrera <alvherre@alvh.no-ip.org>,
        Christoph Berg <myon@debian.org>,
        Pavan Deolasee <pavan.deolasee@gmail.com>
Subject: Re: Potential ABI breakage in upcoming minor releases
In-reply-to: <c02230d4-47ea-46dd-94cc-545c3c874c7b@eisentraut.org>
References: <CAJ7c6TPcUJq_Bwo69f6ysRA1UbmSh_hOOEzJ2EvM0cW=3VEh5w@mail.gmail.com> <CAFMSG9Hy-2-8tfmmKy7noCbA3Yn1UY2SFUwYj7wHODTO8gDm8w@mail.gmail.com> <CAJ7c6TMCc85YoiSKex5Sztz6bEmV-0YqL7FY=_MxxcyoMGTDfQ@mail.gmail.com> <2443809.1731683394@sss.pgh.pa.us> <20241115175223.68.nmisch@google.com> <2483970.1731702561@sss.pgh.pa.us> <2500050.1731705196@sss.pgh.pa.us> <900DE0C9-48C4-474C-BDC9-AD495D8D3F59@justatheory.com> <2638276.1731717056@sss.pgh.pa.us> <1576843.1732586210@sss.pgh.pa.us> <20241129203937.c8@rfd.leadboat.com> <c02230d4-47ea-46dd-94cc-545c3c874c7b@eisentraut.org>
Comments: In-reply-to Peter Eisentraut <peter@eisentraut.org>
	message dated "Wed, 04 Dec 2024 20:29:57 +0100"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <2391662.1733344116.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Wed, 04 Dec 2024 15:28:36 -0500
Message-ID: <2391663.1733344116@sss.pgh.pa.us>
List-Id: <pgsql-hackers.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-hackers@lists.postgresql.org>
List-Owner: <mailto:pgsql-hackers-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-hackers>
Archived-At: <https://www.postgresql.org/message-id/2391663.1733344116%40sss.pgh.pa.us>
Precedence: bulk

Peter Eisentraut <peter@eisentraut.org> writes:
> On 29.11.24 21:39, Noah Misch wrote:
>> I'd say the source tree's <sect2 id=3D"xfunc-api-abi-stability-guidance=
">, which
>> David Wheeler mentioned, is authoritative.  It currently matches
>> postgr.es/c/e54a42a.  Let's update both or change that wiki heading to =
point
>> to the authoritative doc section.

> I don't know if this proposing to merge the text in the wiki into the do=
cs?

> The text in the docs is describing to extension authors what they can =

> expect.  The text in the wiki is advice for server developers how to =

> attempt to satisfy those expectations.  So I think those can be separate=
 =

> pieces of text.

Yes, that was my feeling as well.  The text on the wiki contemplates
that we'd merge it into the main docs whenever it seems stable enough,
but I'm not sure we're there yet (this discussion suggests not ;-)).
In any case it feels like it should be a different chunk of text than
xfunc-api-abi-stability-guidance, which is aimed at extension
developers not core developers.

			regards, tom lane