Re: Confusion in section 8.7.3. Type Safety

From: David Rowley <dgrowleyml(at)gmail(dot)com>
To: dejan(dot)spasic(at)bitweise(dot)biz, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Confusion in section 8.7.3. Type Safety
Date: 2025-09-23 11:14:10
Message-ID: CAApHDvptZTx5-m0-o5qijs96wOgcTaRE+JrLrxcP2JhRxteLmQ@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, 23 Sept 2025 at 20:59, PG Doc comments form
<noreply(at)postgresql(dot)org> wrote:
> Page: https://www.postgresql.org/docs/17/datatype-enum.html
> Description:
>
> In section 8.7.3. Type Safety one can observe a the following statement in
> the examples.
>
> INSERT INTO holidays(num_weeks,happiness) VALUES (2, 'sad');
>
> This is somewhat confusing since type happiness doesn't contain 'sad'. I
> would suggest to remove the statement or to add an enum 'sad' in type
> happiness.

Thank you for the report. I think you might have missed that this
section is demonstrating that the statement does not work due to the
column's type not containing an enum value for 'sad' and that enum
values are specific to the particular enum, rather than global to all
enum types, as one *could* have assumed.

Your proposed modification would make the bogus INSERT statement work,
which would defeat the purpose of the section demonstrating that it
doesn't work.

David

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Dejan Spasic 2025-09-23 13:35:32 Re: Confusion in section 8.7.3. Type Safety
Previous Message PG Doc comments form 2025-09-23 07:09:42 Confusion in section 8.7.3. Type Safety