Doc: clarify that CREATE TABLE discards redundant unique constraints.
authorTom Lane <[email protected]>
Tue, 8 Dec 2020 18:09:48 +0000 (13:09 -0500)
committerTom Lane <[email protected]>
Tue, 8 Dec 2020 18:09:48 +0000 (13:09 -0500)
commit14db9579222138b3fba2f73c285ff3f9e4bf9465
tree9b5100f450651810beff64d7388dece4a3704e72
parent0921b86ca1e451c70642c3007feb25f7efb34f65
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