Re: Update docs for UUID data type

From: Andy Alsup <bluesbreaker(at)gmail(dot)com>
To: Masahiko Sawada <sawada(dot)mshk(at)gmail(dot)com>
Cc: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>, Pgsql-Hackers Mailing List <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Update docs for UUID data type
Date: 2025-02-28 21:44:24
Message-ID: CADOZ7s4fcQCEX-Vxcwu9yV4Dbbx1743qGFdTj=DHp=H8ikXPXw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Masahiko,

I like the change you've made.

Thanks,
Andy Alsup

On Fri, Feb 28, 2025 at 2:05 PM Masahiko Sawada <sawada(dot)mshk(at)gmail(dot)com>
wrote:

> On Thu, Feb 27, 2025 at 5:50 PM Andy Alsup <bluesbreaker(at)gmail(dot)com> wrote:
> >
> > Masahiko,
> >
> > I have combined the gen_random_uuid() and uuidv4() into a single row, as
> you suggested. Please find the v5 patch, which has been squashed into a
> single commit.
>
> Thank you for updating the patch!
>
> I like that the patch adds the reference to the uuid data type. But I
> think we might want to adjust terminology:
>
> + <para>
> + See <xref linkend="datatype-uuid"/> for how details on the UUID
> datatype in
> + <productname>PostgreSQL</productname>.
> + </para>
>
> On 9.14. UUID Functions section, we use the word 'UUID' for data that
> are generated based on algorithms defined by RFC9562 whereas we use
> uuid (i.e., <type>uuid</type> in func.sgml) to a PostgreSQL data type.
> IIUC you want to refer 'UUID datatype' in the above change to the
> latter, PostgreSQL's uuid data type. Is that correct? If so, how about
> the following change?
>
> See <xref linkend="datatype-uuid"/> for details on the data type
> <type>uuid</type> in <productname>PostgreSQL</productname>.
>
> I've attached the updated patch that incorporates the above change,
> and updated the commit message too.
>
> Regards,
>
> --
> Masahiko Sawada
> Amazon Web Services: https://aws.amazon.com
>

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Corey Huinker 2025-02-28 21:52:02 Re: Statistics Import and Export
Previous Message Jeff Davis 2025-02-28 21:24:57 Re: Statistics Import and Export