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 1uTiLl-008fM0-VI
	for pgsql-docs@arkaria.postgresql.org; Mon, 23 Jun 2025 14:40:45 +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 1uTiLj-003eLk-NJ
	for pgsql-docs@arkaria.postgresql.org; Mon, 23 Jun 2025 14:40:44 +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 <masao.fujii@oss.nttdata.com>)
	id 1uTiLj-003eLc-Fq
	for pgsql-docs@lists.postgresql.org; Mon, 23 Jun 2025 14:40:44 +0000
Received: from oss.nttdata.com ([49.212.34.109])
	by makus.postgresql.org with smtp (Exim 4.96)
	(envelope-from <masao.fujii@oss.nttdata.com>)
	id 1uTiLh-003Yti-1x
	for pgsql-docs@lists.postgresql.org;
	Mon, 23 Jun 2025 14:40:43 +0000
Received: from [192.168.11.9] (p1696134-ipoe.ipoe.ocn.ne.jp [118.0.93.133])
	by oss.nttdata.com (Postfix) with ESMTPSA id CB684600FF;
	Mon, 23 Jun 2025 23:40:36 +0900 (JST)
X-Virus-Status: Clean
X-Virus-Scanned: clamav-milter 0.103.11 at oss.nttdata.com
Message-ID: <274659ec-3eed-40fb-85d3-bc35014c57a1@oss.nttdata.com>
Date: Mon, 23 Jun 2025 23:40:36 +0900
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: Fix incorrect UUID index entry in function documentation
To: Masahiko Sawada <sawada.mshk@gmail.com>
Cc: pgsql-docs@lists.postgresql.org
References: <f33e0493-5773-4296-87c5-7ce459054cfe@oss.nttdata.com>
 <CAD21AoCm=a=rohh6ULRqNahX4m_Q5USPv9SHTnoBEHEPjZxBsw@mail.gmail.com>
Content-Language: en-US
From: Fujii Masao <masao.fujii@oss.nttdata.com>
In-Reply-To: 
 <CAD21AoCm=a=rohh6ULRqNahX4m_Q5USPv9SHTnoBEHEPjZxBsw@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: quoted-printable
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/274659ec-3eed-40fb-85d3-bc35014c57a1%40oss.nttdata.com>
Precedence: bulk



On 2025/06/21 9:55, Masahiko Sawada wrote:
> On Fri, Jun 20, 2025 at 11:33=E2=80=AFPM Fujii Masao
> <masao.fujii@oss.nttdata.com> wrote:
>>
>> Hi,
>>
>> Both the UUID data type and UUID functions pages define an index entry
>> for "UUID" that points to the data type section. As a result, the inde=
x
>> includes two identical entries linking to the UUID type docs,
>> which seems strange.
>>
>> I believe the UUID functions page should instead define its own index
>> entry that links to itself. Currently, the indexterm is written as:
>>
>> --------------------
>>    <sect1 id=3D"functions-uuid">
>>     <title>UUID Functions</title>
>>
>>     <indexterm zone=3D"datatype-uuid">
>>      <primary>UUID</primary>
>>      <secondary>generating</secondary>
>>     </indexterm>
>> --------------------
>>
>> I suspect that "datatype-uuid" is a copy-paste error and should be
>> "functions-uuid" to reflect the correct section. The attached patch
>> updates this accordingly.
>>
>> Thoughts?
>=20
> +1. I think it also makes sense that "UUID generating" has the link to
> "UUID Functions".

Yes, and the proposed change ensures that as well.

So barring any objections, I will commit the patch.

Regards,

--=20
Fujii Masao
NTT DATA Japan Corporation