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

From Masahiko Sawada
Subject Re: Fix incorrect UUID index entry in function documentation
Date
Msg-id CAD21AoCm=a=rohh6ULRqNahX4m_Q5USPv9SHTnoBEHEPjZxBsw@mail.gmail.com
Whole thread Raw
In response to Fix incorrect UUID index entry in function documentation  (Fujii Masao <masao.fujii@oss.nttdata.com>)
List pgsql-docs
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".

Regards,

--
Masahiko Sawada
Amazon Web Services: https://aws.amazon.com



pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: Cleanup of syntax.sgml
Next
From: Dean Rasheed
Date:
Subject: Re: Document if width_bucket's low and high are inclusive/exclusive