Re: ALTER TABLE ... CLUSTER ON synopsis

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Josh Kupershmidt <schmiddy(at)gmail(dot)com>
Cc: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: ALTER TABLE ... CLUSTER ON synopsis
Date: 2012-05-21 16:09:25
Message-ID: 17585.1337616565@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Josh Kupershmidt <schmiddy(at)gmail(dot)com> writes:
> The reference page for ALTER TABLE[1] correctly has the synopsis:

> CLUSTER ON <replaceable class="PARAMETER">index_name</replaceable>

> but later leaves off the "ON" keyword:

> <term><literal>CLUSTER</literal></term>

> I think the latter description should match the former, especially
> since 'ON' is mandatory; small patch attached.

Done, though I'm not sure we've ever tried to be consistent for such
things.

The main inconsistency I notice on that page is that some of the
subform descriptions repeat the whole syntax while others only show
the initial keyword(s). Should we try to be more consistent about
that, and if so, in which direction?

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Josh Kupershmidt 2012-05-22 07:22:22 Re: ALTER TABLE ... CLUSTER ON synopsis
Previous Message Simon Riggs 2012-05-21 13:18:54 Re: SQL key word list and SQL:2011