Re: Fix incorrect UUID index entry in function documentation

Fujii Masao <masao.fujii@oss.nttdata.com>

From: Fujii Masao <masao.fujii@oss.nttdata.com>
To: Masahiko Sawada <sawada.mshk@gmail.com>
Cc: pgsql-docs@lists.postgresql.org
Date: 2025-06-23T14:40:36Z
Lists: pgsql-docs

On 2025/06/21 9:55, Masahiko Sawada wrote:
> On Fri, Jun 20, 2025 at 11:33 PM 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 index
>> 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="functions-uuid">
>>     <title>UUID Functions</title>
>>
>>     <indexterm zone="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?
> 
> +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,

-- 
Fujii Masao
NTT DATA Japan Corporation




Commits

  1. doc: Fix incorrect UUID index entry in function documentation.