From: | "Jim C(dot) Nasby" <jnasby(at)pervasive(dot)com> |
---|---|
To: | Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us> |
Cc: | pgsql-docs(at)postgresql(dot)org |
Subject: | Re: CONSTRAINT syntax in ALTER TABLE |
Date: | 2006-01-04 02:12:29 |
Message-ID: | 20060104021229.GI82560@pervasive.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On Mon, Jan 02, 2006 at 09:04:50PM -0500, Bruce Momjian wrote:
> Jim C. Nasby wrote:
> > Maybe it's just me, but I find it annoying that the ALTER TABLE docs
> > say to look at the CREATE TABLE docs for info on CONSTRAINT syntax. ISTM
> > it would be much better to:
> >
> > Include the docs in both places, or
> > Break constraint syntax/info into it's own page
> >
> > A last-resort would be to still refer to CREATE TABLE, but at least make
> > it link to the actual constraint section, instead of just linking to the
> > top of the page as it does now.
>
> I like that last idea. I don't think duplicate documentation or a
> separate section are a win.
By #2 I assume you mean my 'last resort'. One thing I dislike about that
is (I assume) it would do nothing to help \h ALTER TABLE in psql. Maybe
a good compromise would be to include the table_constraint section of
the CREATE TABLE syntax in the ALTER TABLE syntax.
--
Jim C. Nasby, Sr. Engineering Consultant jnasby(at)pervasive(dot)com
Pervasive Software http://pervasive.com work: 512-231-6117
vcard: http://jim.nasby.net/pervasive.vcf cell: 512-569-9461
From | Date | Subject | |
---|---|---|---|
Next Message | Jim C. Nasby | 2006-01-04 02:19:58 | Re: Supplemental contrib docs (was: [GENERAL] DBlink documentation) |
Previous Message | Joe Conway | 2006-01-04 00:20:38 | Supplemental contrib docs (was: [GENERAL] DBlink documentation) |