Re: Fix incorrect UUID index entry in function documentation - Mailing list pgsql-docs

From Fujii Masao
Subject Re: Fix incorrect UUID index entry in function documentation
Date
Msg-id 274659ec-3eed-40fb-85d3-bc35014c57a1@oss.nttdata.com
Whole thread Raw
In response to Re: Fix incorrect UUID index entry in function documentation  (Masahiko Sawada <sawada.mshk@gmail.com>)
Responses Re: Fix incorrect UUID index entry in function documentation
List 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




pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Document if width_bucket's low and high are inclusive/exclusive
Next
From: Daniel Gustafsson
Date:
Subject: Re: Fix incorrect UUID index entry in function documentation