Re: Documentation for create unique index is insuficient and (because of that) incorrect
Tom Lane <tgl@sss.pgh.pa.us>
From: Tom Lane <tgl@sss.pgh.pa.us>
To: "Jonathan S. Katz" <jkatz@postgresql.org>
Cc: Bruce Momjian <bruce@momjian.us>, emilioplatzer@gmail.com,
pgsql-docs@lists.postgresql.org
Date: 2018-11-20T14:59:18Z
Lists: pgsql-docs
"Jonathan S. Katz" <jkatz@postgresql.org> writes: > On 11/19/18 9:05 PM, Bruce Momjian wrote: >> On Tue, Oct 23, 2018 at 06:29:55PM +0000, PG Doc comments form wrote: >>> In https://www.postgresql.org/docs/11/static/indexes-unique.html there are >>> omited clausules >> The first URL is an example and is not intended to be the complete >> syntax. > In fairness, the "INCLUDE" clause was added, which is new to PostgreSQL > 11, so it could raise the question as to why aren't other clauses there. Yes. That was a dumb idea; the correct fix is to take that out, because it's not appropriate here. There might be room for an additional section later in the chapter that discusses INCLUDE, but we shouldn't be cluttering the discussion of fundamental concepts like unique indexes with that. regards, tom lane
Commits
-
Doc: rework introductory documentation about covering indexes.
- 2c0791376aed 11.2 landed
- fe375d33a184 12.0 landed