Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1phlkg-0002d5-SR
	for pgsql-hackers@arkaria.postgresql.org; Thu, 30 Mar 2023 06:27:14 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1phlkf-00060z-Op
	for pgsql-hackers@arkaria.postgresql.org; Thu, 30 Mar 2023 06:27:13 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <kop@karlpinc.com>)
	id 1phlkf-00060q-F8
	for pgsql-hackers@lists.postgresql.org; Thu, 30 Mar 2023 06:27:13 +0000
Received: from janus.karlpinc.com ([173.161.46.12] helo=smtp.karlpinc.com)
	by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <kop@karlpinc.com>)
	id 1phlkc-0005bF-NL
	for pgsql-hackers@lists.postgresql.org; Thu, 30 Mar 2023 06:27:13 +0000
Received: from slate.karlpinc.com (unknown [192.168.1.14])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256)
	(No client certificate requested)
	by smtp.karlpinc.com (Postfix) with ESMTPS id D2BA6A37E;
	Thu, 30 Mar 2023 01:27:07 -0500 (CDT)
Received: from slate.karlpinc.com (localhost [IPv6:::1])
	by slate.karlpinc.com (Postfix) with ESMTPS id 8123D3FBBF;
	Thu, 30 Mar 2023 01:27:07 -0500 (CDT)
Date: Thu, 30 Mar 2023 01:27:05 -0500
From: "Karl O. Pinc" <kop@karlpinc.com>
To: Noah Misch <noah@leadboat.com>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>, PostgreSQL Hackers
 <pgsql-hackers@lists.postgresql.org>
Subject: Re: Doc: Rework contrib appendix -- informative titles, tweaked
 sentences
Message-ID: <20230330012705.7295be34@slate.karlpinc.com>
In-Reply-To: <20230330043205.GA449577@rfd.leadboat.com>
References: <20230120191203.7nyqjbw3qe7xx4ru@alvherre.pgsql>
	<20230120191238.ds5l4ehuxve4zn42@alvherre.pgsql>
	<20230120142225.3d3be8a3@slate.karlpinc.com>
	<20230121081143.322bcf9f@slate.karlpinc.com>
	<20230122080903.693b171a@slate.karlpinc.com>
	<20230122144246.0ff87372@slate.karlpinc.com>
	<20230330043205.GA449577@rfd.leadboat.com>
X-Mailer: Claws Mail 3.17.8 (GTK+ 2.24.33; x86_64-pc-linux-gnu)
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
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/20230330012705.7295be34%40slate.karlpinc.com>
Precedence: bulk

On Wed, 29 Mar 2023 21:32:05 -0700
Noah Misch <noah@leadboat.com> wrote:

> On Sun, Jan 22, 2023 at 02:42:46PM -0600, Karl O. Pinc wrote:
> > v10-0001-List-trusted-and-obsolete-extensions.patch  
> 
> > + <para id="contrib-obsolete">
> > +   These modules and extensions are obsolete:
> > +
> > +   <simplelist type="inline">
> > +     <member><xref linkend="intagg"/></member>
> > +     <member><xref linkend="xml2"/></member>
> > +   </simplelist>
> > + </para>  
> 
> Commit a013738 incorporated this change.  Since xml2 is the only
> in-tree way to use XSLT from SQL, I think xml2 is not obsolete.  Some
> individual functions, e.g. xml_valid(), are obsolete.  (There are
> years-old threats to render the module obsolete, but this has never
> happened.)

Your point seems valid but this is above my station.
I have no idea as to how to best resolve this, or even how to make the
resolution happen now that the change has been committed.
Someone who knows more than me about the situation is needed
to change the phrasing, or re-categorize, or rework the xml2
module docs, or come up with new categories of obsolescence-like 
states, or provide access to libxslt from PG, or something.

I am invested in the patch and appreciate being cc-ed.

Regards,

Karl <kop@karlpinc.com>
Free Software:  "You don't pay back, you pay forward."
                 -- Robert A. Heinlein