agora inbox for pgsql-docs@postgresql.org  

help / color / mirror / Atom feed

From: Fujii Masao <masao.fujii@oss.nttdata.com>
To: Masahiko Sawada <sawada.mshk@gmail.com>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Fix incorrect UUID index entry in function documentation
Date: Mon, 23 Jun 2025 23:40:36 +0900
Message-ID: <274659ec-3eed-40fb-85d3-bc35014c57a1@oss.nttdata.com> (raw)
In-Reply-To: <CAD21AoCm=a=rohh6ULRqNahX4m_Q5USPv9SHTnoBEHEPjZxBsw@mail.gmail.com>
References: <f33e0493-5773-4296-87c5-7ce459054cfe@oss.nttdata.com>
	<CAD21AoCm=a=rohh6ULRqNahX4m_Q5USPv9SHTnoBEHEPjZxBsw@mail.gmail.com>



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

view thread (7+ messages)  latest in thread

Message-ID: <274659ec-3eed-40fb-85d3-bc35014c57a1@oss.nttdata.com>
Permalink:  ../274659ec-3eed-40fb-85d3-bc35014c57a1@oss.nttdata.com/
Also on:    postgresql.org/message-id/274659ec-3eed-40fb-85d3-bc35014c57a1@oss.nttdata.com

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: masao.fujii@oss.nttdata.com, sawada.mshk@gmail.com, pgsql-docs@lists.postgresql.org
  Subject: Re: Fix incorrect UUID index entry in function documentation
  In-Reply-To: <274659ec-3eed-40fb-85d3-bc35014c57a1@oss.nttdata.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox