From: Peter Eisentraut <peter_e@gmx.net>
Date: Tue, 13 Nov 2018 09:42:43 +0000 (+0100)
Subject: doc: Clarify CREATE TYPE ENUM documentation
X-Git-Tag: REL9_6_12~90
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=390301ce630c9bbececef169130694acc06fafe2;p=postgresql

doc: Clarify CREATE TYPE ENUM documentation

The documentation claimed that an enum type requires "one or more"
labels, but since 1fd9883ff49, zero labels are also allowed.

Reported-by: Lukas Eder <lukas.eder@gmail.com>
Bug: #15356
---

diff --git a/doc/src/sgml/ref/create_type.sgml b/doc/src/sgml/ref/create_type.sgml
index 5a09f1942a..3f54413887 100644
--- a/doc/src/sgml/ref/create_type.sgml
+++ b/doc/src/sgml/ref/create_type.sgml
@@ -117,9 +117,12 @@ CREATE TYPE <replaceable class="parameter">name</replaceable>
    <para>
     The second form of <command>CREATE TYPE</command> creates an enumerated
     (enum) type, as described in <xref linkend="datatype-enum">.
-    Enum types take a list of one or more quoted labels, each of which
+    Enum types take a list of quoted labels, each of which
     must be less than <symbol>NAMEDATALEN</symbol> bytes long (64 bytes in a
-    standard <productname>PostgreSQL</productname> build).
+    standard <productname>PostgreSQL</productname> build).  (It is possible to
+    create an enumerated type with zero labels, but such a type cannot be used
+    to hold values before at least one label is added using <xref
+    linkend="sql-altertype">.)
    </para>
   </refsect2>