Doc: clarify that CREATE TABLE discards redundant unique constraints.
authorTom Lane <tgl@sss.pgh.pa.us>
Tue, 8 Dec 2020 18:09:47 +0000 (13:09 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Tue, 8 Dec 2020 18:09:47 +0000 (13:09 -0500)
commitf2a69b352de1dffc534c4835010e736018aa94de
tree68e1f9cadaa2c75ba7840dd3cf9448d8ba0e24bd
parent9a2641911aeaa7f6523dc2a465088051d4c85901
Doc: clarify that CREATE TABLE discards redundant unique constraints.

The SQL standard says that redundant unique constraints are disallowed,
but we long ago decided that throwing an error would be too
user-unfriendly, so we just drop redundant ones.  The docs weren't very
clear about that though, as this behavior was only explained for PRIMARY
KEY vs UNIQUE, not UNIQUE vs UNIQUE.

While here, I couldn't resist doing some copy-editing and markup-fixing
on the adjacent text about INCLUDE options.

Per bug #16767 from Matthias vd Meent.

Discussion: https://postgr.es/m/16767-1714a2056ca516d0@postgresql.org
doc/src/sgml/ref/create_table.sgml