X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org Received: from localhost (av.hub.org [200.46.204.144]) by postgresql.org (Postfix) with ESMTP id 8C4E09DC835 for ; Mon, 2 Jan 2006 22:04:50 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024) with ESMTP id 45272-08 for ; Mon, 2 Jan 2006 22:04:54 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey- Received: from candle.pha.pa.us (candle.pha.pa.us [70.90.9.53]) by postgresql.org (Postfix) with ESMTP id 1092A9DC806 for ; Mon, 2 Jan 2006 22:04:47 -0400 (AST) Received: (from pgman@localhost) by candle.pha.pa.us (8.11.6/8.11.6) id k0324p324245; Mon, 2 Jan 2006 21:04:51 -0500 (EST) From: Bruce Momjian Message-Id: <200601030204.k0324p324245@candle.pha.pa.us> Subject: Re: CONSTRAINT syntax in ALTER TABLE In-Reply-To: <20060102214613.GM39326@pervasive.com> To: "Jim C. Nasby" Date: Mon, 2 Jan 2006 21:04:50 -0500 (EST) CC: pgsql-docs@postgresql.org X-Mailer: ELM [version 2.4ME+ PL121 (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII X-Virus-Scanned: by amavisd-new at hub.org X-Spam-Status: No, score=0.121 required=5 tests=[AWL=0.121] X-Spam-Score: 0.121 X-Spam-Level: X-Archive-Number: 200601/4 X-Sequence-Number: 3394 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. -- Bruce Momjian | http://candle.pha.pa.us pgman@candle.pha.pa.us | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup. | Newtown Square, Pennsylvania 19073