BUG #15356: Inconsistent documentation about CREATE TYPE

From: PG Bug reporting form <noreply(at)postgresql(dot)org>
To: pgsql-bugs(at)lists(dot)postgresql(dot)org
Cc: lukas(dot)eder(at)gmail(dot)com
Subject: BUG #15356: Inconsistent documentation about CREATE TYPE
Date: 2018-08-28 12:56:50
Message-ID: 153546101062.1489.8367867109281960574@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-bugs

The following bug has been logged on the website:

Bug reference: 15356
Logged by: Lukas Eder
Email address: lukas(dot)eder(at)gmail(dot)com
PostgreSQL version: 10.5
Operating system: Windows
Description:

Hello,

The CREATE TYPE documentation [1] specifies that enum types without any enum
labels are possible:

CREATE TYPE name AS ENUM ( [ 'label' [, ... ] ] )

I can confirm this. The following statement works well:

CREATE TYPE e AS ENUM ();

However, further down in the same documentation page, we can see:

"Enum types take a list of one or more quoted labels"

It should read "zero or more quoted labels". I suspect this should be
adapted on all documentation pages from PostgreSQL 9.0 onwards. In 8.4, the
documentation was consistent [2]

[1]: https://www.postgresql.org/docs/current/static/sql-createtype.html
[2]: https://www.postgresql.org/docs/8.4/static/sql-createtype.html

Responses

Browse pgsql-bugs by date

  From Date Subject
Next Message Michael Paquier 2018-08-28 12:59:45 Re: BUG #15346: Replica fails to start after the crash
Previous Message Stephen Frost 2018-08-28 12:23:11 Re: BUG #15346: Replica fails to start after the crash