mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Fix up markup to allow building.

Browse Source 
Adjust two-word substitution parameters to be one word only to reduce
 possible ambiguity.
This commit is contained in:
Thomas G. Lockhart 2000-04-12 04:40:03 +00:00
parent 398bb1fcb6
commit 50b10b8a90
1 changed files with 59 additions and 43 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

58
doc/src/sgml/ref/create_table.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.20 2000/04/11 14:43:54 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.21 2000/04/12 04:40:03 thomas Exp $
Postgres documentation Postgres documentation
--> -->
@ -451,8 +451,8 @@ CREATE TABLE distributors (
[ CONSTRAINT <replaceable class="parameter">name</replaceable> ] { [ [ CONSTRAINT <replaceable class="parameter">name</replaceable> ] { [
NULL | NOT NULL ] | UNIQUE | PRIMARY KEY | CHECK <replaceable NULL | NOT NULL ] | UNIQUE | PRIMARY KEY | CHECK <replaceable
class="parameter">constraint</replaceable> | REFERENCES class="parameter">constraint</replaceable> | REFERENCES
<replaceable class="parameter">referenced table</replaceable> <replaceable class="parameter">reftable</replaceable>
(<replaceable class="parameter">referenced column</replaceable>) (<replaceable class="parameter">refcolumn</replaceable>)
[ MATCH <replaceable class="parameter">matchtype</replaceable> ] [ MATCH <replaceable class="parameter">matchtype</replaceable> ]
[ ON DELETE <replaceable class="parameter">action</replaceable> ] [ ON DELETE <replaceable class="parameter">action</replaceable> ]
[ ON UPDATE <replaceable class="parameter">action</replaceable> ] [ ON UPDATE <replaceable class="parameter">action</replaceable> ]
@ -938,7 +938,7 @@ ERROR: Cannot insert a duplicate key into a unique index.
</title> </title>
<synopsis> <synopsis>
[ CONSTRAINT <replaceable class="parameter">name</replaceable> ] REFERENCES [ CONSTRAINT <replaceable class="parameter">name</replaceable> ] REFERENCES
<replaceable class="parameter">referenced table</replaceable> [ ( <replaceable class="parameter"> referenced column</replaceable> ) ] <replaceable class="parameter">reftable</replaceable> [ ( <replaceable class="parameter">refcolumn</replaceable> ) ]
[ MATCH <replaceable class="parameter">matchtype</replaceable> ] [ MATCH <replaceable class="parameter">matchtype</replaceable> ]
[ ON DELETE <replaceable class="parameter">action</replaceable> ] [ ON DELETE <replaceable class="parameter">action</replaceable> ]
[ ON UPDATE <replaceable class="parameter">action</replaceable> ] [ ON UPDATE <replaceable class="parameter">action</replaceable> ]
@ -954,6 +954,7 @@ ERROR: Cannot insert a duplicate key into a unique index.
<refsect3 id="R3-SQL-REFERENCES-1"> <refsect3 id="R3-SQL-REFERENCES-1">
<title>Inputs</title> <title>Inputs</title>
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -964,21 +965,23 @@ ERROR: Cannot insert a duplicate key into a unique index.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">referenced table</replaceable></term> <term><replaceable class="parameter">reftable</replaceable></term>
<listitem> <listitem>
<para> <para>
The table that contains the data to check against. The table that contains the data to check against.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">referenced column</replaceable></term> <term><replaceable class="parameter">refcolumn</replaceable></term>
<listitem> <listitem>
<para> <para>
The column in the <replaceable class="parameter">referenced table</replaceable> The column in <replaceable class="parameter">reftable</replaceable>
to check the data against. If this is not specified, the PRIMARY KEY of the to check the data against. If this is not specified, the PRIMARY KEY of the
<replaceable class="parameter">referenced table</replaceable> is used. <replaceable class="parameter">reftable</replaceable> is used.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1096,6 +1099,7 @@ ERROR: Cannot insert a duplicate key into a unique index.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> [ NOT ] DEFERRABLE </term> <term> [ NOT ] DEFERRABLE </term>
<listitem> <listitem>
@ -1105,24 +1109,31 @@ ERROR: Cannot insert a duplicate key into a unique index.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>INITIALLY <replaceable class="parameter">checktime</replaceable></term> <term>INITIALLY <replaceable class="parameter">checktime</replaceable></term>
<listitem> <listitem>
<para> <para>
<replaceable class="parameter">checktime</replaceable> has two possible values <replaceable class="parameter">checktime</replaceable> has two possible values
which specify the default time to check the constraint. which specify the default time to check the constraint.
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>DEFERRED</term> <term>DEFERRED</term>
<listitem>
<para> <para>
Check this constraint at the end of the transaction. Check this constraint at the end of the transaction.
</para> </para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>IMMEDIATE</term> <term>IMMEDIATE</term>
<listitem>
<para> <para>
Check this constraint after each statement. Check this constraint after each statement.
</para> </para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
@ -1150,7 +1161,7 @@ ERROR: Cannot insert a duplicate key into a unique index.
<varlistentry> <varlistentry>
<term><computeroutput> <term><computeroutput>
ERROR: <replaceable class="parameter">name</replaceable> referential integrity violation - key referenced from ERROR: <replaceable class="parameter">name</replaceable> referential integrity violation - key referenced from
<replaceable class="parameter">table</replaceable> not found in <replaceable class="parameter">referenced table</replaceable> <replaceable class="parameter">table</replaceable> not found in <replaceable class="parameter">reftable</replaceable>
</computeroutput></term> </computeroutput></term>
<listitem> <listitem>
<para> <para>
@ -1193,13 +1204,14 @@ ERROR: <replaceable class="parameter">name</replaceable> referential integrity
</title> </title>
<para> <para>
Currently <productname>Postgres</productname> only supports Currently <productname>Postgres</productname> only supports
MATCH FULL and an unspecified MATCH type. MATCH FULL and an unspecified match type.
In addition, the referenced columns are supposed to be In addition, the referenced columns are supposed to be
the columns of a UNIQUE constraint in the referenced table, the columns of a UNIQUE constraint in the referenced table,
however <productname>Postgres</productname> does not however <productname>Postgres</productname> does not
enforce this. enforce this.
</para> </para>
</refsect3> </refsect3>
</refsect2>
</refsect1> </refsect1>
<refsect1 id="R1-SQL-TABLECONSTRAINT-1"> <refsect1 id="R1-SQL-TABLECONSTRAINT-1">
@ -1211,9 +1223,9 @@ ERROR: <replaceable class="parameter">name</replaceable> referential integrity
[ CONSTRAINT name ] { PRIMARY KEY | UNIQUE } ( <replaceable class="parameter">column</replaceable> [, ...] ) [ CONSTRAINT name ] { PRIMARY KEY | UNIQUE } ( <replaceable class="parameter">column</replaceable> [, ...] )
[ CONSTRAINT name ] CHECK ( <replaceable>constraint</replaceable> ) [ CONSTRAINT name ] CHECK ( <replaceable>constraint</replaceable> )
[ CONSTRAINT name ] FOREIGN KEY ( <replaceable class="parameter">column</replaceable> [, ...] ) [ CONSTRAINT name ] FOREIGN KEY ( <replaceable class="parameter">column</replaceable> [, ...] )
REFERENCES <replaceable class="parameter">referenced table</replaceable> REFERENCES <replaceable class="parameter">reftable</replaceable>
(<replaceable class="parameter">referenced column</replaceable> [, ...] ) (<replaceable class="parameter">refcolumn</replaceable> [, ...] )
[ MATCH <match type> ] [ MATCH <replaceable class="parameter">matchtype</replaceable> ]
[ ON DELETE <replaceable class="parameter">action</replaceable> ] [ ON DELETE <replaceable class="parameter">action</replaceable> ]
[ ON UPDATE <replaceable class="parameter">action</replaceable> ] [ ON UPDATE <replaceable class="parameter">action</replaceable> ]
[ [ NOT ] DEFERRABLE ] [ [ NOT ] DEFERRABLE ]
@ -1464,7 +1476,7 @@ CREATE TABLE distributors (
</refsect3> </refsect3>
</refsect2> </refsect2>
<refsect2 id="R2-SQL-REFERENCES-1"> <refsect2 id="R2-SQL-REFERENCES-2">
<refsect2info> <refsect2info>
<date>2000-02-04</date> <date>2000-02-04</date>
</refsect2info> </refsect2info>
@ -1474,7 +1486,7 @@ CREATE TABLE distributors (
<synopsis> <synopsis>
[ CONSTRAINT <replaceable class="parameter">name</replaceable> ] [ CONSTRAINT <replaceable class="parameter">name</replaceable> ]
FOREIGN KEY ( <replaceable class="parameter">column</replaceable> [, ...] ) REFERENCES FOREIGN KEY ( <replaceable class="parameter">column</replaceable> [, ...] ) REFERENCES
<replaceable class="parameter">referenced table</replaceable> [ ( <replaceable class="parameter">referenced column</replaceable> [, ...] ) ] <replaceable class="parameter">reftable</replaceable> [ ( <replaceable class="parameter">refcolumn</replaceable> [, ...] ) ]
[ MATCH <replaceable class="parameter">matchtype</replaceable> ] [ MATCH <replaceable class="parameter">matchtype</replaceable> ]
[ ON DELETE <replaceable class="parameter">action</replaceable> ] [ ON DELETE <replaceable class="parameter">action</replaceable> ]
[ ON UPDATE <replaceable class="parameter">action</replaceable> ] [ ON UPDATE <replaceable class="parameter">action</replaceable> ]
@ -1488,7 +1500,7 @@ FOREIGN KEY ( <replaceable class="parameter">column</replaceable> [, ...] ) REFE
a FOREIGN KEY table constraint. a FOREIGN KEY table constraint.
</para> </para>
<refsect3 id="R3-SQL-REFERENCES-1"> <refsect3 id="R3-SQL-REFERENCES-5">
<title>Inputs</title> <title>Inputs</title>
<para> <para>
<variablelist> <variablelist>
@ -1509,7 +1521,7 @@ FOREIGN KEY ( <replaceable class="parameter">column</replaceable> [, ...] ) REFE
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">referenced table</replaceable></term> <term><replaceable class="parameter">reftable</replaceable></term>
<listitem> <listitem>
<para> <para>
The table that contains the data to check against. The table that contains the data to check against.
@ -1520,9 +1532,9 @@ FOREIGN KEY ( <replaceable class="parameter">column</replaceable> [, ...] ) REFE
<term><replaceable class="parameter">referenced column</replaceable> [, ...]</term> <term><replaceable class="parameter">referenced column</replaceable> [, ...]</term>
<listitem> <listitem>
<para> <para>
One or more column in the <replaceable class="parameter">referenced table</replaceable> One or more column in the <replaceable class="parameter">reftable</replaceable>
to check the data against. If this is not specified, the PRIMARY KEY of the to check the data against. If this is not specified, the PRIMARY KEY of the
<replaceable class="parameter">referenced table</replaceable> is used. <replaceable class="parameter">reftable</replaceable> is used.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1658,15 +1670,19 @@ FOREIGN KEY ( <replaceable class="parameter">column</replaceable> [, ...] ) REFE
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term>DEFERRED</term> <term>DEFERRED</term>
<listitem>
<para> <para>
Check this constraint at the end of the transaction. Check this constraint at the end of the transaction.
</para> </para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>IMMEDIATE</term> <term>IMMEDIATE</term>
<listitem>
<para> <para>
Check this constraint after each statement. Check this constraint after each statement.
</para> </para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
@ -1675,7 +1691,7 @@ FOREIGN KEY ( <replaceable class="parameter">column</replaceable> [, ...] ) REFE
</variablelist> </variablelist>
</para> </para>
</refsect3> </refsect3>
<refsect3 id="R3-SQL-REFERENCES-2"> <refsect3 id="R3-SQL-REFERENCES-6">
<refsect3info> <refsect3info>
<date>2000-02-04</date> <date>2000-02-04</date>
</refsect3info> </refsect3info>
@ -1692,7 +1708,7 @@ FOREIGN KEY ( <replaceable class="parameter">column</replaceable> [, ...] ) REFE
<varlistentry> <varlistentry>
<term><computeroutput> <term><computeroutput>
ERROR: <replaceable class="parameter">name</replaceable> referential integrity violation - key referenced from ERROR: <replaceable class="parameter">name</replaceable> referential integrity violation - key referenced from
<replaceable class="parameter">table</replaceable> not found in <replaceable class="parameter">referenced table</replaceable> <replaceable class="parameter">table</replaceable> not found in <replaceable class="parameter">reftable</replaceable>
</computeroutput></term> </computeroutput></term>
<listitem> <listitem>
<para> <para>