Re: Documentation for create unique index is insuficient and (because of that) incorrect

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
Cc: Bruce Momjian <bruce(at)momjian(dot)us>, emilioplatzer(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Documentation for create unique index is insuficient and (because of that) incorrect
Date: 2018-11-20 14:59:18
Message-ID: 11323.1542725958@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

"Jonathan S. Katz" <jkatz(at)postgresql(dot)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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Jonathan S. Katz 2018-11-20 15:02:01 Re: Documentation for create unique index is insuficient and (because of that) incorrect
Previous Message Alvaro Herrera 2018-11-20 14:52:42 Re: Documentation for create unique index is insuficient and (because of that) incorrect