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-docs-owner+archive@lists.postgresql.org>)
	id 1t2Ahb-002Jey-05
	for pgsql-docs@arkaria.postgresql.org; Sat, 19 Oct 2024 14:45:11 +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-docs-owner+archive@lists.postgresql.org>)
	id 1t2AhY-003ikd-Fr
	for pgsql-docs@arkaria.postgresql.org; Sat, 19 Oct 2024 14:45:08 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	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 1t2AhY-003ikV-8C
	for pgsql-docs@lists.postgresql.org; Sat, 19 Oct 2024 14:45:08 +0000
Received: from sss.pgh.pa.us ([68.162.161.243])
	by magus.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 1t2AhS-001ujY-Ce
	for pgsql-docs@lists.postgresql.org; Sat, 19 Oct 2024 14:45:07 +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 49JEiu7i1093072;
	Sat, 19 Oct 2024 10:44:56 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: =?utf-8?Q?=C3=81lvaro?= Herrera <alvherre@alvh.no-ip.org>
cc: alvaro@datadoghq.com, pgsql-docs@lists.postgresql.org
Subject: Re: ALTER INDEX documentation is incomplete
In-reply-to: <202410191125.ikk6d335ngxo@alvherre.pgsql>
References: <202410191125.ikk6d335ngxo@alvherre.pgsql>
Comments: In-reply-to =?utf-8?Q?=C3=81lvaro?= Herrera
 <alvherre@alvh.no-ip.org>
	message dated "Sat, 19 Oct 2024 13:25:40 +0200"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <1093070.1729349096.1@sss.pgh.pa.us>
Date: Sat, 19 Oct 2024 10:44:56 -0400
Message-ID: <1093071.1729349096@sss.pgh.pa.us>
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Archived-At: 
 <https://www.postgresql.org/message-id/1093071.1729349096%40sss.pgh.pa.us>
Precedence: bulk

=?utf-8?Q?=C3=81lvaro?= Herrera <alvherre@alvh.no-ip.org> writes:
> How about the attached patch?

Instead of

+      Causes the possibly schema-qualified named index to become attached

I think something like

+      Causes the named index (possibly schema-qualified) to become attached

would be more readable and closer to what we write elsewhere.

			regards, tom lane