rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Editing and markup cleanup.

This commit is contained in:
Thomas G. Lockhart 1998-09-22 15:48:03 +00:00
parent 748e300317
commit 52ca2ab268
23 changed files with 1222 additions and 926 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/src/sgml/ref/alter_table.sgml
View File

@ -182,7 +182,7 @@ The keyword COLUMN is noise and can be omitted.
<Quote>[*]</Quote> following a name of a table indicates that statement
should be run over that table and all tables below it in the
inheritance hierarchy.
The PostgreSQL User's Guide has further
The <citetitle>PostgreSQL User's Guide</citetitle> has further
information on inheritance.
<PARA>

12
doc/src/sgml/ref/create_index.sgml
View File

@ -41,7 +41,7 @@ CREATE [ UNIQUE ] INDEX <replaceable class="parameter">index_name</replaceable>
<LISTITEM>
<PARA>
Causes the system to check for
duplicate values when the index is created (if data
duplicate values in the table when the index is created (if data
already exist) and each time data is added. Attempts to
insert or update non-duplicate data will generate an
error.
@ -76,7 +76,7 @@ CREATE [ UNIQUE ] INDEX <replaceable class="parameter">index_name</replaceable>
<PARA>
the name of the access method which is to be used for
the index. The default access method is BTREE.
Postgres provides three access methods for secondary indices:
Postgres provides three access methods for secondary indexes:
<variablelist>
<varlistentry>
<term>BTREE</term>
@ -208,14 +208,14 @@ SELECT am.amname AS acc_name,
Description
</TITLE>
<PARA>
This command constructs an index
<command>CREATE INDEX</command> constructs an index
<replaceable class="parameter">index_name</replaceable>.
on the specified
<replaceable class="parameter">table</replaceable>.
<tip>
<para>
Indices are primarily used to enhance database performance.
Indexes are primarily used to enhance database performance.
But inappropriate use will result in slower performance.
</tip>
@ -236,7 +236,7 @@ But inappropriate use will result in slower performance.
on the result of a user-defined function
<replaceable class="parameter">func_name</replaceable> applied
to one or more attributes of a single class. These functional
indices can be used to obtain fast access to data
indexes can be used to obtain fast access to data
based on operators that would normally require some
transformation to apply them to the base data.
</para>
@ -250,7 +250,7 @@ But inappropriate use will result in slower performance.
</TITLE>
<PARA>
Currently, only the BTREE access method supports multi-column
indices. Up to 7 keys may be specified.
indexes. Up to 7 keys may be specified.
</PARA>
<para>
Use <command>DROP INDEX</command>

16
doc/src/sgml/ref/create_language.sgml
View File

@ -40,9 +40,10 @@ CREATE [ TRUSTED ] PROCEDURAL LANGUAGE '<replaceable class="parameter">langname<
<PARA>
<function> TRUSTED</function> specifies that the call handler for
the language is safe; that is, it offers an unprivileged user
no functionality to get around access restrictions. If
no functionality to bypass access restrictions. If
this keyword is omitted when registering the language,
only users with the PostgreSQL superuser privilege can use
only users with the <productname>Postgres</productname>
superuser privilege can use
this language to create new functions
(like the 'C' language).
</PARA>
@ -58,17 +59,17 @@ CREATE [ TRUSTED ] PROCEDURAL LANGUAGE '<replaceable class="parameter">langname<
The name of the new procedural language.
The language name is case insensitive. A procedural
language cannot override one of the built-in languages of
PostgreSQL.
<productname>Postgres</productname>.
</PARA>
</LISTITEM>
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<replaceable class="parameter">call_handler</replaceable>
HANDLER <replaceable class="parameter">call_handler</replaceable>
</TERM>
<LISTITEM>
<PARA>
The argument for <function>HANDLER</function> is the name
<replaceable class="parameter">call_handler</replaceable> is the name
of a previously
registered function that will be called to execute the PL
procedures.
@ -86,7 +87,7 @@ CREATE [ TRUSTED ] PROCEDURAL LANGUAGE '<replaceable class="parameter">langname<
inserted in the <literal>LANCOMPILER</literal> attribute
of the new
<filename>pg_language</filename> entry. At present,
PostgreSQL doesn't use
<productname>Postgres</productname> does not use
this attribute in any way.
</PARA>
</LISTITEM>
@ -364,7 +365,8 @@ CREATE PROCEDURAL LANGUAGE 'plsample'
SQL92
</TITLE>
<PARA>
There is no <command>CREATE LANGUAGE</command> statement in SQL92.
There is no <command>CREATE LANGUAGE</command> statement in
<acronym>SQL92</acronym>.
</PARA>
</refsect2>
</refsect1>

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

File diff suppressed because it is too large Load Diff

85
doc/src/sgml/ref/create_trigger.sgml
View File

@ -14,30 +14,24 @@
</REFPURPOSE>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
CREATE TRIGGER <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> { BEFORE | AFTER }
{ <REPLACEABLE CLASS="PARAMETER">event</REPLACEABLE> [OR ...] }
ON <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> FOR EACH { ROW | STATEMENT }
EXECUTE PROCEDURE <REPLACEABLE CLASS="PARAMETER">funcname</REPLACEABLE> ( <REPLACEABLE CLASS="PARAMETER">arguments</REPLACEABLE> )
CREATE TRIGGER <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> { BEFORE | AFTER }
{ <REPLACEABLE CLASS="PARAMETER">event</REPLACEABLE> [OR ...] }
ON <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> FOR EACH { ROW | STATEMENT }
EXECUTE PROCEDURE <REPLACEABLE CLASS="PARAMETER">funcname</REPLACEABLE> ( <REPLACEABLE CLASS="PARAMETER">arguments</REPLACEABLE> )
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-CREATETRIGGER-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
@ -80,14 +74,11 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-CREATETRIGGER-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -97,6 +88,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -120,23 +112,17 @@
<REFSECT1 ID="R1-SQL-CREATETRIGGER-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT1INFO>
<TITLE>
Description
</TITLE>
<PARA>
CREATE TRIGGER will enter a new trigger into the current
<command>CREATE TRIGGER</command> will enter a new trigger into the current
data base. The trigger will be associated with the relation
<replaceable class="parameter">relname</replaceable> and will execute
the specified function <replaceable class="parameter">funcname</replaceable>.
</PARA>
<PARA>
Only the relation owner may create a trigger on this relation.
</PARA>
<PARA>
At release 6.3.2, STATEMENT triggers are not implemented.
</PARA>
<PARA>
The trigger can be specified to fire either before the
operation is attempted on a tuple (before constraints
@ -147,24 +133,32 @@
skip the operation for the current tuple, or change the tuple
being inserted (for INSERT and UPDATE operations only). If
the trigger fires after the event, all changes, including the
last INSERTion, UPDATE or DELETion, are "visible" to the trigger.
last insertion, update, or deletion, are "visible" to the trigger.
</PARA>
<PARA>
Refer to the SPI and trigger programming guides for more
Refer to the chapters on SPI and Triggers in the
<citetitle>PostgreSQL Programmer's Guide</citetitle> for more
information.
</PARA>
<REFSECT2 ID="R2-SQL-CREATETRIGGER-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
CREATE TRIGGER statement is a PostgreSQL language extension.
<command>CREATE TRIGGER</command> is a <productname>Postgres</productname>
language extension.
</PARA>
<PARA>
Only the relation owner may create a trigger on this relation.
</PARA>
<PARA>
As of the current release (v6.4), STATEMENT triggers are not implemented.
</PARA>
<PARA>
Refer to the DROP TRIGGER statement for information on how to
Refer to <command>DROP TRIGGER</command> for information on how to
remove triggers.
</PARA>
@ -179,18 +173,18 @@
table before appending or updating a row in the table films:
</PARA>
<ProgramListing>
CREATE TRIGGER if_dist_exists
BEFORE INSERT OR UPDATE ON films FOR EACH ROW
EXECUTE PROCEDURE check_primary_key ('did', 'distributors', 'did');
CREATE TRIGGER if_dist_exists
BEFORE INSERT OR UPDATE ON films FOR EACH ROW
EXECUTE PROCEDURE check_primary_key ('did', 'distributors', 'did');
</ProgramListing>
<PARA>
Before cancelling a distributor or updating its code, remove every
reference to the table films:
</PARA>
<ProgramListing>
CREATE TRIGGER if_film_exists
BEFORE DELETE OR UPDATE ON distributors FOR EACH ROW
EXECUTE PROCEDURE check_foreign_key (1, 'CASCADE', 'did', 'films', 'did');
CREATE TRIGGER if_film_exists
BEFORE DELETE OR UPDATE ON distributors FOR EACH ROW
EXECUTE PROCEDURE check_foreign_key (1, 'CASCADE', 'did', 'films', 'did');
</ProgramListing>
</REFSECT1>
@ -203,29 +197,30 @@
<REFSECT2 ID="R2-SQL-CREATETRIGGER-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<PARA>
There is no CREATE TRIGGER statement in SQL92.
There is no <command>CREATE TRIGGER</command> in <acronym>SQL92</acronym>.
</PARA>
<PARA>
The second example above may also be done by using a FOREIGN KEY
constraint as in:
</PARA>
<ProgramListing>
CREATE TABLE distributors (
did DECIMAL(3),
name VARCHAR(40),
CONSTRAINT if_film_exists FOREIGN KEY(did) REFERENCES films
ON UPDATE CASCADE ON DELETE CASCADE
);
CREATE TABLE distributors (
did DECIMAL(3),
name VARCHAR(40),
CONSTRAINT if_film_exists
FOREIGN KEY(did) REFERENCES films
ON UPDATE CASCADE ON DELETE CASCADE
);
</ProgramListing>
<PARA>
However, foreign keys are not yet implemented at version 6.3.2 of
PostgreSQL.
However, foreign keys are not yet implemented (as of version 6.4) in
<productname>Postgres</productname>.
</PARA>
</REFENTRY>

84
doc/src/sgml/ref/create_type.sgml
View File

@ -14,46 +14,39 @@
</REFPURPOSE>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
CREATE TYPE <replaceable class="parameter">typename</replaceable> (
INTERNALLENGTH = (<replaceable class="parameter">internallength</replaceable> | VARIABLE)
[, EXTERNALLENGTH = (<replaceable class="parameter">externallength</replaceable> | VARIABLE) ]
CREATE TYPE <replaceable class="parameter">typename</replaceable> (
<comment>
Why are parentheses required around the length parameters?
</comment>
, INPUT = <replaceable class="parameter">input_function</replaceable>
, OUTPUT = <replaceable class="parameter">output_function</replaceable>
[, ELEMENT = <replaceable class="parameter">element</replaceable>]
[, DELIMITER = <replaceable class="parameter">delimiter</replaceable>]
[, DEFAULT = "<replaceable class="parameter">default</replaceable>" ]
[, SEND = <replaceable class="parameter">send_function</replaceable> ]
[, RECEIVE = <replaceable class="parameter">receive_function</replaceable> ]
[, PASSEDBYVALUE])
INPUT = <replaceable class="parameter">input_function</replaceable>
, OUTPUT = <replaceable class="parameter">output_function</replaceable>
, INTERNALLENGTH = (<replaceable class="parameter">internallength</replaceable> | VARIABLE)
[ , EXTERNALLENGTH = (<replaceable class="parameter">externallength</replaceable> | VARIABLE) ]
[ , ELEMENT = <replaceable class="parameter">element</replaceable> ]
[ , DELIMITER = <replaceable class="parameter">delimiter</replaceable> ]
[ , DEFAULT = "<replaceable class="parameter">default</replaceable>" ]
[ , SEND = <replaceable class="parameter">send_function</replaceable> ]
[ , RECEIVE = <replaceable class="parameter">receive_function</replaceable> ]
[ , PASSEDBYVALUE ]
)
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-CREATETYPE-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue>
<replaceable class="parameter">typename</replaceable>
</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
@ -63,9 +56,7 @@ Why are parentheses required around the length parameters?
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
<replaceable class="parameter">internallength</replaceable>
</ReturnValue>
INTERNALLENGTH <replaceable class="parameter">internallength</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -76,9 +67,7 @@ Why are parentheses required around the length parameters?
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
<replaceable class="parameter">externallength</replaceable>
</ReturnValue>
EXTERNALLENGTH <replaceable class="parameter">externallength</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -89,9 +78,7 @@ Why are parentheses required around the length parameters?
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
<replaceable class="parameter">input_function</replaceable>
</ReturnValue>
INPUT <replaceable class="parameter">input_function</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -103,9 +90,7 @@ Why are parentheses required around the length parameters?
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
<replaceable class="parameter">output_function</replaceable>
</ReturnValue>
OUTPUT <replaceable class="parameter">output_function</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -117,9 +102,7 @@ Why are parentheses required around the length parameters?
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
<replaceable class="parameter">element</replaceable>
</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
@ -130,9 +113,7 @@ Why are parentheses required around the length parameters?
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
<replaceable class="parameter">delimiter</replaceable>
</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
@ -142,9 +123,7 @@ Why are parentheses required around the length parameters?
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
<replaceable class="parameter">default</replaceable
></ReturnValue>
</TERM>
<LISTITEM>
<PARA>
@ -155,9 +134,7 @@ Why are parentheses required around the length parameters?
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
<replaceable class="parameter">send_function</replaceable>
</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
@ -170,9 +147,7 @@ Why are parentheses required around the length parameters?
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
<replaceable class="parameter">receive_function</replaceable>
</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
@ -184,14 +159,11 @@ Why are parentheses required around the length parameters?
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-CREATETYPE-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -201,6 +173,7 @@ Why are parentheses required around the length parameters?
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -225,7 +198,7 @@ Why are parentheses required around the length parameters?
<REFSECT1 ID="R1-SQL-CREATETYPE-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT1INFO>
<TITLE>
Description
@ -383,16 +356,19 @@ it with the fact that the data is not present></comment>
</refsect2>
<REFSECT2 ID="R2-SQL-CREATETYPE-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
Refer to DROP TYPE statement to drop types.
Refer to <command>DROP TYPE</command> to remove an existing type.
</PARA>
<PARA>
See also CREATE FUNCTION, CREATE OPERATOR and large_objects.</para>
See also <command>CREATE FUNCTION</command>,
<command>CREATE OPERATOR</command> and the chapter on Large Objects
in the <citetitle>PostgreSQL Programmer's Guide</citetitle>.
</para>
</REFSECT2>
</refsect1>
@ -402,18 +378,16 @@ it with the fact that the data is not present></comment>
Compatibility
</TITLE>
<PARA>
CREATE TYPE statement is a PostgreSQL language extension.
</PARA>
<REFSECT2 ID="R2-SQL-CREATETYPE-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
SQL3
</TITLE>
<PARA>
CREATE TYPE is a SQL3 statement.
<command>CREATE TYPE</command> is an <acronym>SQL3</acronym> statement.
</PARA>
</REFSECT2>

57
doc/src/sgml/ref/create_user.sgml
View File

@ -14,35 +14,25 @@
</REFPURPOSE>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
CREATE USER<REPLACEABLE CLASS="PARAMETER"> username</REPLACEABLE>
[WITH PASSWORD <REPLACEABLE CLASS="PARAMETER">password</REPLACEABLE>]
[CREATEDB | NOCREATEDB]
[CREATEUSER | NOCREATEUSER]
[IN GROUP <REPLACEABLE CLASS="PARAMETER">groupname</REPLACEABLE> [, ...] ]
[VALID UNTIL '<REPLACEABLE CLASS="PARAMETER">abstime</REPLACEABLE>']
CREATE USER<REPLACEABLE CLASS="PARAMETER"> username</REPLACEABLE>
[ WITH PASSWORD <REPLACEABLE CLASS="PARAMETER">password</REPLACEABLE> ]
[ CREATEDB | NOCREATEDB ]
[ CREATEUSER | NOCREATEUSER ]
[ IN GROUP <REPLACEABLE CLASS="PARAMETER">groupname</REPLACEABLE> [, ...] ]
[ VALID UNTIL '<REPLACEABLE CLASS="PARAMETER">abstime</REPLACEABLE>' ]
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-CREATEUSER-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
@ -63,8 +53,8 @@
The WITH PASSWORD clause sets the user's password within
the "<filename>pg_shadow</filename>" table. For this reason,
<filename>"pg_shadow</filename>" is no
longer accessible to the instance of PostgreSQL that the
PostgreSQL user's password is initially set to NULL.
longer accessible to the instance of <productname>Postgres</productname> that the
<productname>Postgres</productname> user's password is initially set to NULL.
<comment>The text here has got garbled.</comment>
When a
user's password in the "<filename>pg_shadow</filename>"
@ -72,7 +62,7 @@
authentication proceeds as it historically has (HBA,
PG_PASSWORD, etc). However, if a password is set for a
user, a new authentication system supplants any other
configured for the PostgreSQL instance, and the password
configured for the <productname>Postgres</productname> instance, and the password
stored in the "<filename>pg_shadow</filename>" table is used
for authentication.
For more details on how this authentication system
@ -105,7 +95,7 @@
<PARA>
These clauses determine whether a user will be permitted to
create new
users in an instance of PostgreSQL.
users in an instance of <productname>Postgres</productname>.
Omitting this clause will set the user's value of this
attribute to be NOCREATEUSER.
</PARA>
@ -128,7 +118,7 @@
<LISTITEM>
<PARA>
The VALID UNTIL clause sets an absolute time after which the
user's PostgreSQL login is no longer valid. Please note that
user's <productname>Postgres</productname> login is no longer valid. Please note that
if a user does not have a password defined in the
"<filename>pg_shadow</filename>"
table, the valid until date will not be checked
@ -140,14 +130,11 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-CREATEUSER-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -157,6 +144,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -192,19 +180,20 @@ this error message.</comment>
<REFSECT1 ID="R1-SQL-CREATEUSER-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT1INFO>
<TITLE>
Description
</TITLE>
<PARA>
CREATE USER will add a new user to an instance of PostgreSQL.
CREATE USER will add a new user to an instance of
<productname>Postgres</productname>.
</PARA>
<PARA>
The new user will be given a <filename>usesysid</filename> of:
'<command>SELECT MAX(usesysid) + 1 FROM pg_shadow</command>'.
This means that
PostgreSQL users' <filename>usesysid</filename>s will not
<productname>Postgres</productname> users' <filename>usesysid</filename>s will not
correspond to their operating
system(OS) user ids. The exception to this rule is
the '<literal>postgres</literal>' user, whose OS user id
@ -213,19 +202,19 @@ this error message.</comment>
If you still want the
OS user id and the <filename>usesysid</filename> to match
for any given user,
use the "createuser" script provided with the PostgreSQL
use the "createuser" script provided with the <productname>Postgres</productname>
distribution.
</PARA>
<REFSECT2 ID="R2-SQL-CREATEUSER-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
CREATE USER statement is a PostgreSQL language extension.
CREATE USER statement is a <productname>Postgres</productname> language extension.
</PARA>
<para>
Use DROP USER or ALTER USER statements to remove or modify a user
@ -292,7 +281,7 @@ this error message.</comment>
<REFSECT2 ID="R2-SQL-CREATEUSER-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
SQL92

67
doc/src/sgml/ref/create_view.sgml
View File

@ -14,28 +14,21 @@ Constructs a virtual table
</REFPURPOSE>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
CREATE VIEW <REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE>
AS SELECT <REPLACEABLE CLASS="PARAMETER">query</REPLACEABLE>
CREATE VIEW <REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE>
AS SELECT <REPLACEABLE CLASS="PARAMETER">query</REPLACEABLE>
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-CREATEVIEW-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
@ -62,14 +55,11 @@ An SQL query which will provide the columns and rows of the view.
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-CREATEVIEW-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -79,6 +69,7 @@ An SQL query which will provide the columns and rows of the view.
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -133,7 +124,7 @@ An SQL query which will provide the columns and rows of the view.
<REFSECT1 ID="R1-SQL-CREATEVIEW-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT1INFO>
<TITLE>
Description
@ -147,7 +138,7 @@ An SQL query which will provide the columns and rows of the view.
<REFSECT2 ID="R2-SQL-CREATEVIEW-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Notes
@ -159,7 +150,7 @@ An SQL query which will provide the columns and rows of the view.
<REFSECT2 ID="R2-SQL-CREATEVIEW-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
Bugs
@ -177,17 +168,17 @@ An SQL query which will provide the columns and rows of the view.
Create a view consisting of all Comedy films:
</PARA>
<ProgramListing>
CREATE VIEW kinds AS
SELECT *
FROM films
WHERE kind = 'Comedy';
CREATE VIEW kinds AS
SELECT *
FROM films
WHERE kind = 'Comedy';
SELECT * FROM kinds;
SELECT * FROM kinds;
code |title |did| date_prod|kind |len
-----+-------------------------+---+----------+----------+------
UA502|Bananas |105|1971-07-13|Comedy | 01:22
C_701|There's a Girl in my Soup|107|1970-06-11|Comedy | 01:36
code |title |did| date_prod|kind |len
-----+-------------------------+---+----------+----------+------
UA502|Bananas |105|1971-07-13|Comedy | 01:22
C_701|There's a Girl in my Soup|107|1970-06-11|Comedy | 01:36
</ProgramListing>
</REFSECT1>
@ -201,7 +192,7 @@ An SQL query which will provide the columns and rows of the view.
<REFSECT2 ID="R2-SQL-CREATEVIEW-5">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-21</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
@ -209,13 +200,13 @@ An SQL query which will provide the columns and rows of the view.
<PARA>
SQL92 specifies some additional capabilities for the CREATE VIEW statement:
</PARA>
<programlisting>
CREATE VIEW <replaceable class="parameter">view</replaceable> [ <replaceable class="parameter">column</replaceable> [, ...] ]
AS SELECT <replaceable class="parameter">expression</replaceable> [AS <replaceable class="parameter">colname</replaceable>] [, ...]
FROM <replaceable class="parameter">table</replaceable>
[WHERE <replaceable class="parameter">condition</replaceable>]
[ WITH [ CASCADE | LOCAL ] CHECK OPTION ]
</programlisting>
<synopsis>
CREATE VIEW <replaceable class="parameter">view</replaceable> [ <replaceable class="parameter">column</replaceable> [, ...] ]
AS SELECT <replaceable class="parameter">expression</replaceable> [AS <replaceable class="parameter">colname</replaceable>] [, ...]
FROM <replaceable class="parameter">table</replaceable>
[ WHERE <replaceable class="parameter">condition</replaceable> ]
[ WITH [ CASCADE | LOCAL ] CHECK OPTION ]
</synopsis>
<VARIABLELIST>
<VARLISTENTRY>
@ -226,7 +217,7 @@ An SQL query which will provide the columns and rows of the view.
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue>CHECK OPTION</ReturnValue>
CHECK OPTION
</TERM>
<LISTITEM>
<PARA> This option is to do with updatable views.
@ -238,7 +229,7 @@ An SQL query which will provide the columns and rows of the view.
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>LOCAL</ReturnValue>
LOCAL
</TERM>
<LISTITEM>
<PARA>
@ -248,7 +239,7 @@ An SQL query which will provide the columns and rows of the view.
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>CASCADE</ReturnValue>
CASCADE
</TERM>
<LISTITEM>
<PARA>

14
doc/src/sgml/ref/declare.sgml
View File

@ -259,6 +259,16 @@ and expect data to come back in a text format.
<productname>Postgres</productname>
does not have an explicit <command>OPEN cursor</command>
statement; a cursor is considered to be open when it is declared.
<note>
<para>
In <acronym>SQL92</acronym> cursors are only available in
embedded applications. <application>ecpg</application>, the
embedded SQL preprocessor for <productname>Postgres</productname>,
supports the <acronym>SQL92</acronym> conventions, including those
involving DECLARE and OPEN statements.
</note>
</PARA>
</REFSECT2>
</refsect1>
@ -271,8 +281,8 @@ and expect data to come back in a text format.
To declare a cursor:
</PARA>
<ProgramListing>
DECLARE liahona CURSOR
FOR SELECT * FROM films;
DECLARE liahona CURSOR
FOR SELECT * FROM films;
</ProgramListing>
</REFSECT1>

50
doc/src/sgml/ref/delete.sgml
View File

@ -31,16 +31,10 @@
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue><replaceable class="parameter">table</replaceable></ReturnValue>
<replaceable class="parameter">table</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -50,7 +44,7 @@
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue><replaceable class="parameter">condition</replaceable></ReturnValue>
<replaceable class="parameter">condition</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -64,9 +58,6 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DELETE-2">
@ -81,6 +72,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -97,7 +89,7 @@
</PARA>
<PARA>
If <replaceable class="parameter">count</replaceable> is 0,
no rows are deleted.
no rows were deleted.
</PARA>
</LISTITEM>
</VARLISTENTRY>
@ -139,26 +131,27 @@
Remove all films but musicals:
</PARA>
<ProgramListing>
DELETE FROM films WHERE kind &lt;&gt; 'Musical';
DELETE FROM films WHERE kind &lt;&gt; 'Musical';
SELECT * FROM films;
SELECT * FROM films;
code |title |did| date_prod|kind |len
-----+-------------------------+---+----------+----------+------
UA501|West Side Story |105|1961-01-03|Musical | 02:32
TC901|The King and I |109|1956-08-11|Musical | 02:13
WD101|Bed Knobs and Broomsticks|111| |Musical | 01:57
code |title |did| date_prod|kind |len
-----+-------------------------+---+----------+----------+------
UA501|West Side Story |105|1961-01-03|Musical | 02:32
TC901|The King and I |109|1956-08-11|Musical | 02:13
WD101|Bed Knobs and Broomsticks|111| |Musical | 01:57
(3 rows)
</ProgramListing>
<para>
Clear the table films:
Clear the table <literal>films</literal>:
</para>
<programlisting>
DELETE FROM films;
DELETE FROM films;
SELECT * FROM films;
code|title|did|date_prod|kind|len
----+-----+---+---------+----+---
(0 rows)
SELECT * FROM films;
code|title|did|date_prod|kind|len
----+-----+---+---------+----+---
(0 rows)
</programlisting>
</REFSECT1>
@ -177,14 +170,15 @@
SQL92
</TITLE>
<PARA>
SQL92 defines a different syntax for a positioned DELETE statement:
<acronym>SQL92</acronym> allows a positioned DELETE statement:
</PARA>
<synopsis>
DELETE FROM <replaceable class="parameter">table</replaceable> WHERE CURRENT OF <replaceable class="parameter">cursor</replaceable>
DELETE FROM <replaceable class="parameter">table</replaceable> WHERE CURRENT OF <replaceable class="parameter">cursor</replaceable>
</synopsis>
<para>
where <replaceable class="parameter">cursor</replaceable> identifies an open cursor.</para>
where <replaceable class="parameter">cursor</replaceable> identifies an open cursor. Interactive cursors in <productname>Postgres</productname> are read-only.
</para>
</refsect2>
</refsect1>
</REFENTRY>

27
doc/src/sgml/ref/drop_aggregate.sgml
View File

@ -17,7 +17,7 @@
<DATE>1998-04-15</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP AGGREGATE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> <REPLACEABLE CLASS="PARAMETER">type</REPLACEABLE>
DROP AGGREGATE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> <REPLACEABLE CLASS="PARAMETER">type</REPLACEABLE>
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPAGGREGATE-1">
@ -29,16 +29,10 @@
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue><replaceable class="parameter">name</replaceable></ReturnValue>
<replaceable class="parameter">name</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -48,12 +42,12 @@
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue><replaceable class="parameter">type</replaceable></ReturnValue>
<replaceable class="parameter">type</replaceable>
</TERM>
<LISTITEM>
<PARA>
The type of an existing aggregate function.
(Refer to PostgreSQL User's Guide chapter 4 for
(Refer to the <citetitle>PostgreSQL User's Guide</citetitle> for
further information about data types).
<comment>This should become a cross-reference rather than a
hard-coded chapter number</comment>
@ -61,9 +55,6 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPAGGREGATE-2">
@ -78,6 +69,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -94,7 +86,7 @@
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>WARN RemoveAggregate: aggregate '<replaceable class="parameter">name</replaceable>' for 'type' does not exist</ReturnValue>
<ReturnValue>WARN RemoveAggregate: aggregate '<replaceable class="parameter">name</replaceable>' for '<replaceable class="parameter">type</replaceable>' does not exist</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
@ -131,7 +123,8 @@
Notes
</TITLE>
<PARA>
The <command>DROP AGGREGATE</command> statement is a PostgreSQL
The <command>DROP AGGREGATE</command> statement is a
<productname>Postgres</productname>
language extension.
</PARA>
<PARA>
@ -150,7 +143,7 @@
<literal>int4</literal>:
</PARA>
<ProgramListing>
DROP AGGREGATE myavg int4;
DROP AGGREGATE myavg int4;
</ProgramListing>
</REFSECT1>
@ -169,7 +162,7 @@
SQL92
</TITLE>
<PARA>
There is no DROP AGGREGATE statement in SQL92.
There is no DROP AGGREGATE statement in <acronym>SQL92</acronym>.
</PARA>
</refsect2>
</refsect1>

46
doc/src/sgml/ref/drop_database.sgml
View File

@ -17,7 +17,7 @@
<DATE>1998-04-15</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP DATABASE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE>
DROP DATABASE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE>
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPDATABASE-1">
@ -29,12 +29,6 @@
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
@ -47,9 +41,6 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPDATABASE-2">
@ -64,6 +55,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -88,6 +80,16 @@
</PARA>
</LISTITEM>
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>ERROR: destroydb cannot be executed on an open database</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
This message occurs if the specified database does not exist.
</PARA>
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
@ -116,17 +118,19 @@
<TITLE>
Notes
</TITLE>
<PARA>
<warning>
<para>
This query should NOT be executed interactively.
The <command>destroydb</command> script should be used instead.
</para>
</warning>
<comment>Some explanation would be desirable here!</comment>
</PARA>
<para>
DROP DATABASE statement is a PostgreSQL language extension.
DROP DATABASE statement is a <productname>Postgres</productname>
language extension.
<tip>
<para>
This query cannot be executed while connected to the target
database. It is usually preferable to use the
<command>destroydb</command> script instead.
</para>
</tip>
</para>
<para>
Refer to the <command>CREATE DATABASE</command> statement for
@ -150,7 +154,7 @@
SQL92
</TITLE>
<PARA>
There is no DROP DATABASE statement in SQL92.
There is no <command>DROP DATABASE</command> in <acronym>SQL92</acronym>.
</PARA>
</refsect2>
</refsect1>

37
doc/src/sgml/ref/drop_function.sgml
View File

@ -18,7 +18,7 @@
<DATE>1998-04-15</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP FUNCTION <replaceable class="parameter">name</replaceable> ( [<replaceable class="parameter">type</replaceable> [, ...]] )
DROP FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceable class="parameter">type</replaceable> [, ...] ] )
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPFUNCTION-1">
@ -30,12 +30,6 @@
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
@ -58,9 +52,6 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPFUNCTION-2">
@ -75,6 +66,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -91,13 +83,12 @@
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>
WARN RemoveFunction: Function "<replaceable class="parameter">name</replaceable>" ("<replaceable class="parameter">types</replaceable>") does not exist</ReturnValue>
<ReturnValue>WARN RemoveFunction: Function "<replaceable class="parameter">name</replaceable>" ("<replaceable class="parameter">types</replaceable>") does not exist</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
This message is given if the function specified does not
exist into database.
exist in the current database.
</PARA>
</LISTITEM>
</VARLISTENTRY>
@ -131,11 +122,12 @@ exist into database.
Notes
</TITLE>
<PARA>
Refer to the <citerefentry>
<refentrytitle>
CREATE FUNCTION</refentrytitle>
Refer to <citerefentry>
<refentrytitle>
CREATE FUNCTION
</refentrytitle>
</citerefentry>
statement to create aggregate functions.
to create aggregate functions.
</PARA>
</REFSECT2>
@ -147,7 +139,7 @@ exist into database.
This command removes the square root function:
</PARA>
<ProgramListing>
DROP FUNCTION sqrt(int4);
DROP FUNCTION sqrt(int4);
</ProgramListing>
</REFSECT1>
<REFSECT1 ID="R1-SQL-DROPFUNCTION-3">
@ -164,8 +156,8 @@ exist into database.
<TITLE>
Compatibility
</TITLE>
<PARA
>DROP FUNCTION statement is a PostgreSQL language extension.
<PARA>
DROP FUNCTION is a <productname>Postgres</productname> language extension.
</PARA>
<REFSECT2 ID="R2-SQL-DROPFUNCTION-4">
@ -176,9 +168,10 @@ exist into database.
SQL/PSM
</TITLE>
<PARA>
The SQL/PSM DROP FUNCTION statement has the following syntax:
SQL/PSM is a proposed standard to enable function extensibility.
The SQL/PSM DROP FUNCTION statement has the following syntax:
<programlisting>
DROP [ SPECIFIC ] FUNCTION <replaceable class="parameter">name</replaceable> { RESTRICT | CASCADE }</programlisting>
DROP [ SPECIFIC ] FUNCTION <replaceable class="parameter">name</replaceable> { RESTRICT | CASCADE }</programlisting>
</PARA>
</refsect2>
</refsect1>

29
doc/src/sgml/ref/drop_index.sgml
View File

@ -17,7 +17,7 @@
<DATE>1998-04-15</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP INDEX <REPLACEABLE CLASS="PARAMETER">index_name</REPLACEABLE>
DROP INDEX <REPLACEABLE CLASS="PARAMETER">index_name</REPLACEABLE>
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPINDEX-1">
@ -29,12 +29,6 @@
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
@ -47,9 +41,6 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPINDEX-2">
@ -64,6 +55,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -84,7 +76,7 @@
</TERM>
<LISTITEM>
<PARA>
This message occurs if "<REPLACEABLE CLASS="PARAMETER">index_name</REPLACEABLE>"
This message occurs if <REPLACEABLE CLASS="PARAMETER">index_name</REPLACEABLE>
is not an index in the database.
</PARA>
</LISTITEM>
@ -117,11 +109,12 @@
Notes
</TITLE>
<PARA>
<command>DROP INDEX</command> is a PostgreSQL language extension.
<command>DROP INDEX</command> is a <productname>Postgres</productname>
language extension.
</PARA>
<PARA>
Refer to the <command>CREATE INDEX</command> statement for
information on how to create indices.
information on how to create indexes.
</PARA>
</REFSECT2>
@ -133,7 +126,7 @@
This command will remove the <literal>title_idx</literal> index:
</PARA>
<ProgramListing>
DROP INDEX title_idx;
DROP INDEX title_idx;
</ProgramListing>
</REFSECT1>
@ -152,9 +145,11 @@
SQL92
</TITLE>
<PARA>
SQL92 defines commands by which to access a generic relational database.
Indices are an implementation-dependent feature and hence
there is no <command>DROP INDEX</command> statement in SQL92.
<acronym>SQL92</acronym> defines commands by which to access
a generic relational database.
Indexes are an implementation-dependent feature and hence
there are no index-specific commands or definitions in the
<acronym>SQL92</acronym> language.
</PARA>
</refsect2>
</refsect1>

25
doc/src/sgml/ref/drop_language.sgml
View File

@ -17,7 +17,7 @@
<DATE>1998-04-15</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP PROCEDURAL LANGUAGE '<REPLACEABLE CLASS="PARAMETER">langname</REPLACEABLE>'
DROP PROCEDURAL LANGUAGE '<REPLACEABLE CLASS="PARAMETER">langname</REPLACEABLE>'
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPLANGUAGE-1">
@ -29,16 +29,10 @@
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue><REPLACEABLE CLASS="PARAMETER">langname</REPLACEABLE></ReturnValue>
<REPLACEABLE CLASS="PARAMETER">langname</REPLACEABLE>
</TERM>
<LISTITEM>
<PARA>
@ -47,9 +41,6 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPLANGUAGE-2">
@ -64,6 +55,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -107,7 +99,7 @@
</TITLE>
<PARA>
<command>DROP PROCEDURAL LANGUAGE</command> will remove the definition
of the previously registered procedural language with the name
of the previously registered procedural language having the name
'<replaceable class="parameter">langname</replaceable>'.
</PARA>
@ -120,10 +112,10 @@
</TITLE>
<PARA>
The <command>DROP PROCEDURAL LANGUAGE</command> statement is
a PostgreSQL language extension.
a <productname>Postgres</productname> language extension.
</PARA>
<PARA>
Refer to the <command>CREATE PROCEDURAL LANGUAGE</command> statement
Refer to <command>CREATE PROCEDURAL LANGUAGE</command>
for information on how to create procedural languages.
</PARA>
</refsect2>
@ -153,7 +145,7 @@
This command removes the PL/Sample language:
</PARA>
<ProgramListing>
DROP PROCEDURAL LANGUAGE 'plsample'
DROP PROCEDURAL LANGUAGE 'plsample'
</ProgramListing>
</REFSECT1>
@ -172,7 +164,8 @@
SQL92
</TITLE>
<PARA>
There is no DROP PROCEDURAL LANGUAGE statement in SQL92.
There is no <command>DROP PROCEDURAL LANGUAGE</command> in
<acronym>SQL92</acronym>.
</PARA>
</refsect2>
</refsect1>

71
doc/src/sgml/ref/drop_operator.sgml
View File

@ -16,31 +16,25 @@
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP OPERATOR <REPLACEABLE CLASS="PARAMETER">id</REPLACEABLE> ( <REPLACEABLE CLASS="PARAMETER">type</REPLACEABLE> | NONE [,...] );
DROP OPERATOR <REPLACEABLE CLASS="PARAMETER">id</REPLACEABLE> ( <REPLACEABLE CLASS="PARAMETER">type</REPLACEABLE> | NONE [,...] )
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPOPERATOR-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue><replaceable class="parameter">id</replaceable></ReturnValue>
<replaceable class="parameter">id</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -50,7 +44,7 @@
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue><replaceable class="parameter">type</replaceable></ReturnValue>
<replaceable class="parameter">type</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -59,14 +53,11 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPOPERATOR-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -76,6 +67,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -92,11 +84,33 @@
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>ERROR: RemoveOperator: ... does not exist</ReturnValue>
<ReturnValue>ERROR: RemoveOperator: binary operator '<REPLACEABLE CLASS="PARAMETER">id</REPLACEABLE>' taking '<REPLACEABLE CLASS="PARAMETER">type1</REPLACEABLE>' and '<REPLACEABLE CLASS="PARAMETER">type2</REPLACEABLE>' does not exist</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
This message occurs if the operator specified doesn't exist.
This message occurs if the specified binary operator does not exist.
</PARA>
</LISTITEM>
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>ERROR: RemoveOperator: left unary operator '<REPLACEABLE CLASS="PARAMETER">id</REPLACEABLE>' taking '<REPLACEABLE CLASS="PARAMETER">type</REPLACEABLE>' does not exist</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
This message occurs if the specified left unary operator
specified does not exist.
</PARA>
</LISTITEM>
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue>ERROR: RemoveOperator: right unary operator '<REPLACEABLE CLASS="PARAMETER">id</REPLACEABLE>' taking '<REPLACEABLE CLASS="PARAMETER">type</REPLACEABLE>' does not exist</ReturnValue>
</TERM>
<LISTITEM>
<PARA>
This message occurs if the specified right unary operator
specified does not exist.
</PARA>
</LISTITEM>
</VARLISTENTRY>
@ -109,7 +123,7 @@
<REFSECT1 ID="R1-SQL-DROPOPERATOR-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT1INFO>
<TITLE>
Description
@ -126,22 +140,23 @@
<REFSECT2 ID="R2-SQL-DROPOPERATOR-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
The <command>DROP OPERATOR</command> statement is a PostgreSQL
The <command>DROP OPERATOR</command> statement is a
<productname>Postgres</productname>
language extension.
</PARA>
<PARA>
Refer to the <command>CREATE OPERATOR</command> statement for
Refer to <command>CREATE OPERATOR</command> for
information on how to create operators.
</PARA>
<PARA>
It is the user's responsibility to remove any access methods,
operator classes, and so on, that rely on the deleted operator.
It is the user's responsibility to remove any access methods and
operator classes that rely on the deleted operator.
</PARA>
</REFSECT2>
@ -153,20 +168,20 @@
Remove power operator <literal>a^n</literal> for <literal>int4</literal>:
</PARA>
<ProgramListing>
DROP OPERATOR ^ (int4, int4);
DROP OPERATOR ^ (int4, int4);
</ProgramListing>
<PARA>
Remove left unary operator <literal>!a</literal> for booleans:
</PARA>
<ProgramListing>
DROP OPERATOR ! (none, bool);
DROP OPERATOR ! (none, bool);
</ProgramListing>
<PARA>
Remove right unary factorial operator <literal>a!</literal> for
<literal>int4</literal>:
</PARA>
<ProgramListing>
DROP OPERATOR ! (int4, none);
DROP OPERATOR ! (int4, none);
</ProgramListing>
</REFSECT1>
@ -179,13 +194,13 @@
<REFSECT2 ID="R2-SQL-DROPOPERATOR-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<PARA>
There is no DROP OPERATOR statement in SQL92.
There is no <command>DROP OPERATOR</command> in <acronym>SQL92</acronym>.
</PARA>
</refsect2>
</refsect1>

41
doc/src/sgml/ref/drop_rule.sgml
View File

@ -14,31 +14,25 @@
</REFPURPOSE>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP RULE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE>
DROP RULE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE>
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPRULE-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue><replaceable class="parameter">name</replaceable></ReturnValue>
<replaceable class="parameter">name</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -47,14 +41,11 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPRULE-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -64,6 +55,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -97,37 +89,40 @@
<REFSECT1 ID="R1-SQL-DROPRULE-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT1INFO>
<TITLE>
Description
</TITLE>
<PARA>
<command>DROP RULE</command> drops a rule from the specified PostgreSQL rule
system. PostgreSQL will immediately cease enforcing it and
<command>DROP RULE</command> drops a rule from the specified
<productname>Postgres</productname> rule
system. <productname>Postgres</productname>
will immediately cease enforcing it and
will purge its definition from the system catalogs.
</PARA>
<REFSECT2 ID="R2-SQL-DROPRULE-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
The <command>DROP RULE</command> statement is a PostgreSQL
The <command>DROP RULE</command> statement is a
<productname>Postgres</productname>
language extension.
</PARA>
<PARA>
Refer to the <command>CREATE RULE</command> statement for
Refer to <command>CREATE RULE</command> for
information on how to create rules.
</PARA>
</refsect2>
<REFSECT2 ID="R2-SQL-DROPRULE-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Bugs
@ -160,13 +155,13 @@
<REFSECT2 ID="R2-SQL-DROPRULE-5">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<PARA>
There is no DROP RULE statement in SQL92.
There is no <command>DROP RULE</command> in SQL92.
</PARA>
</refsect2>
</refsect1>

35
doc/src/sgml/ref/drop_sequence.sgml
View File

@ -14,31 +14,25 @@
</REFPURPOSE>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP SEQUENCE <REPLACEABLE CLASS="PARAMETER">seqname</REPLACEABLE> [, ...]
DROP SEQUENCE <REPLACEABLE CLASS="PARAMETER">seqname</REPLACEABLE> [, ...]
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPSEQUENCE-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue><REPLACEABLE CLASS="PARAMETER">seqname</REPLACEABLE></ReturnValue>
<REPLACEABLE CLASS="PARAMETER">seqname</REPLACEABLE>
</TERM>
<LISTITEM>
<PARA>
@ -47,14 +41,11 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPSEQUENCE-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -64,6 +55,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -84,7 +76,7 @@
</TERM>
<LISTITEM>
<PARA>
This message occurs if the sequence specified does not exist.
This message occurs if the specified sequence does not exist.
</PARA>
</LISTITEM>
</VARLISTENTRY>
@ -97,7 +89,7 @@
<REFSECT1 ID="R1-SQL-DROPSEQUENCE-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT1INFO>
<TITLE>
Description
@ -111,13 +103,14 @@
<REFSECT2 ID="R2-SQL-DROPSEQUENCE-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
The <command>DROP SEQUENCE</command> statement is a PostgreSQL
The <command>DROP SEQUENCE</command> statement is a
<productname>Postgres</productname>
language extension.
</PARA>
<PARA>
@ -134,7 +127,7 @@
To remove sequence <literal>serial</literal> from database:
</PARA>
<ProgramListing>
DROP SEQUENCE serial
DROP SEQUENCE serial
</ProgramListing>
</REFSECT1>
@ -147,13 +140,13 @@
<REFSECT2 ID="R2-SQL-DROPSEQUENCE-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<PARA>
There is no <command>DROP SEQUENCE</command> statement in SQL92.
There is no <command>DROP SEQUENCE</command> in <acronym>SQL92</acronym>.
</PARA>
</refsect2>
</refsect1>

46
doc/src/sgml/ref/drop_table.sgml
View File

@ -15,27 +15,21 @@
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP TABLE <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> [, ...]
DROP TABLE <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> [, ...]
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPTABLE-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
@ -48,14 +42,11 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPTABLE-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -65,6 +56,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -85,7 +77,7 @@
</TERM>
<LISTITEM>
<PARA>
If table/view specified doesn't exist into database.
If the specified table or view does not exist in the database.
</PARA>
</LISTITEM>
</VARLISTENTRY>
@ -98,32 +90,32 @@
<REFSECT1 ID="R1-SQL-DROPTABLE-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT1INFO>
<TITLE>
Description
</TITLE>
<PARA><command>
</command>DROP TABLE removes tables and views from the database.
<PARA>
<command>DROP TABLE</command> removes tables and views from the database.
Only its owner may destroy a table or view. A table
may be emptied of rows, but not destroyed, by using DELETE.
may be emptied of rows, but not destroyed, by using <command>DELETE</command>.
</PARA>
<PARA>
If a table being destroyed has secondary indices on it,
If a table being destroyed has secondary indexes on it,
they will be removed first. The removal of just a
secondary index will not affect the indexed table.
secondary index will not affect the contents of the underlying table.
</PARA>
<REFSECT2 ID="R2-SQL-DROPTABLE-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
Refer to the <command>CREATE TABLE</command> and
<command>ALTER TABLE</command> statements for information on
Refer to <command>CREATE TABLE</command> and
<command>ALTER TABLE</command> for information on
how to create or modify tables.
</PARA>
</REFSECT2>
@ -138,7 +130,7 @@
<command>distributors</command> tables:
</PARA>
<ProgramListing>
DROP TABLE films, distributors
DROP TABLE films, distributors
</ProgramListing>
</REFSECT1>
@ -151,7 +143,7 @@
<REFSECT2 ID="R2-SQL-DROPTABLE-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
@ -160,7 +152,7 @@
SQL92 specifies some additional capabilities for DROP TABLE:
</PARA>
<synopsis>
DROP TABLE <replaceable class="parameter">table</replaceable> { RESTRICT | CASCADE }
DROP TABLE <replaceable class="parameter">table</replaceable> { RESTRICT | CASCADE }
</synopsis>
<variablelist>
<varlistentry>
@ -185,7 +177,7 @@
<tip>
<para>
At present, to remove a referenced view you must drop
it by hand.
it explicitly.
</para>
</tip>
</refsect2>

40
doc/src/sgml/ref/drop_trigger.sgml
View File

@ -14,31 +14,25 @@
</REFPURPOSE>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP TRIGGER <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> ON <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE>
DROP TRIGGER <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> ON <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE>
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPTRIGGER-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue><REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE></ReturnValue>
<REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE>
</TERM>
<LISTITEM>
<PARA>
@ -48,7 +42,7 @@
</VARLISTENTRY>
<VARLISTENTRY>
<TERM>
<ReturnValue><REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE></ReturnValue>
<REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE>
</TERM>
<LISTITEM>
<PARA>
@ -57,14 +51,11 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPTRIGGER-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -74,6 +65,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -108,7 +100,7 @@
<REFSECT1 ID="R1-SQL-DROPTRIGGER-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT1INFO>
<TITLE>
Description
@ -121,17 +113,17 @@
<REFSECT2 ID="R2-SQL-DROPTRIGGER-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
The <command>DROP TRIGGER</command> statement is a PostgreSQL
<command>DROP TRIGGER</command> is a <productname>Postgres</productname>
language extension.
</PARA>
<PARA>
Refer to the <command>CREATE TRIGGER</command> statement for
Refer to <command>CREATE TRIGGER</command> for
information on how to create triggers.
</PARA>
</REFSECT2>
@ -141,10 +133,11 @@
Usage
</TITLE>
<PARA>
Destroy the <literal>if_dist_exists</literal> trigger on table <literal>films</literal>:
Destroy the <literal>if_dist_exists</literal> trigger
on table <literal>films</literal>:
</PARA>
<ProgramListing>
DROP TRIGGER if_dist_exists ON films;
DROP TRIGGER if_dist_exists ON films;
</ProgramListing>
</REFSECT1>
@ -157,13 +150,14 @@
<REFSECT2 ID="R2-SQL-DROPTRIGGER-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<PARA>
There is no <command>DROP TRIGGER</command> statement in SQL92.
There is no <command>DROP TRIGGER</command> statement in
<acronym>SQL92</acronym>.
</PARA>
</refsect2>
</refsect1>

41
doc/src/sgml/ref/drop_type.sgml
View File

@ -14,31 +14,25 @@
</REFPURPOSE>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP TYPE <REPLACEABLE CLASS="PARAMETER">typename</REPLACEABLE>
DROP TYPE <REPLACEABLE CLASS="PARAMETER">typename</REPLACEABLE>
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPTYPE-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue><REPLACEABLE CLASS="PARAMETER">typename</REPLACEABLE></ReturnValue>
<REPLACEABLE CLASS="PARAMETER">typename</REPLACEABLE>
</TERM>
<LISTITEM>
<PARA>
@ -47,14 +41,11 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPTYPE-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -64,6 +55,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -97,7 +89,7 @@
<REFSECT1 ID="R1-SQL-DROPTYPE-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT1INFO>
<TITLE>
Description
@ -112,28 +104,29 @@
<REFSECT2 ID="R2-SQL-DROPTYPE-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
DROP TYPE statement is a PostgreSQL language extension.
DROP TYPE statement is a <productname>Postgres</productname>
language extension.
</PARA>
<PARA>
Refer to the <command>CREATE TYPE</command> statement for
Refer to <command>CREATE TYPE</command> for
inforamation on how to create types.
</PARA>
<PARA>
It is the user's responsibility to remove any operators,
functions, aggregates, access methods, subtypes, classes,
and so on, that use a deleted type.
functions, aggregates, access methods, subtypes, and classes
that use a deleted type.
</PARA>
</refsect2>
<REFSECT2 ID="R2-SQL-DROPTYPE-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Bugs
@ -152,7 +145,7 @@
To remove the <literal>box</literal> type:
</PARA>
<ProgramListing>
DROP TYPE box
DROP TYPE box
</ProgramListing>
</REFSECT1>
@ -165,13 +158,13 @@
<REFSECT2 ID="R2-SQL-DROPTYPE-5">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
SQL3
</TITLE>
<PARA>
DROP TYPE is a SQL3 statement.
DROP TYPE is a <acronym>SQL3</acronym> statement.
</PARA>
</refsect2>
</refsect1>

40
doc/src/sgml/ref/drop_user.sgml
View File

@ -15,31 +15,25 @@
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP USER <REPLACEABLE CLASS="PARAMETER">username</REPLACEABLE>
DROP USER <REPLACEABLE CLASS="PARAMETER">username</REPLACEABLE>
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPUSER-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue><REPLACEABLE CLASS="PARAMETER">username</REPLACEABLE></ReturnValue>
<REPLACEABLE CLASS="PARAMETER">username</REPLACEABLE>
</TERM>
<LISTITEM>
<PARA>
@ -48,14 +42,11 @@
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPUSER-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -65,6 +56,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -98,35 +90,35 @@
<REFSECT1 ID="R1-SQL-DROPUSER-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT1INFO>
<TITLE>
Description
</TITLE>
<PARA>
The <command>DROP USER</command> statement removes the named
<command>DROP USER</command> removes the specified
user from the database,
along with any databases owned by the user. It
does not remove tables, views, or triggers owned by the
named user in databases not owned by the user. This statement
can be used in the place of the <command>destroyuser</command>
can be used in place of the <application>destroyuser</application>
script, regardless of how the user was created.
</PARA>
<REFSECT2 ID="R2-SQL-DROPUSER-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
The <command>DROP USER</command> statement is a PostgreSQL
<command>DROP USER</command> is a <productname>Postgres</productname>
language extension.
</PARA>
<PARA>
Refer to the <command>CREATE USER</command> and
<command>ALTER USER</command> statements for information on
Refer to <command>CREATE USER</command> and
<command>ALTER USER</command> for information on
how to create or modify user accounts.
</PARA>
</REFSECT2>
@ -139,7 +131,7 @@
To drop a user account:
</PARA>
<ProgramListing>
DROP USER Jonathan;
DROP USER Jonathan;
</ProgramListing>
</REFSECT1>
@ -152,13 +144,13 @@
<REFSECT2 ID="R2-SQL-DROPUSER-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<PARA>
There is no <command>DROP USER</command> statement in SQL92.
There is no <command>DROP USER</command> in <acronym>SQL92</acronym>.
</PARA>
</refsect2>
</refsect1>

64
doc/src/sgml/ref/drop_view.sgml
View File

@ -14,47 +14,38 @@
</REFPURPOSE>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
DROP VIEW <REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE>
DROP VIEW <REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE>
</SYNOPSIS>
<REFSECT2 ID="R2-SQL-DROPVIEW-1">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
</TERM>
<LISTITEM>
<PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<ReturnValue><REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE></ReturnValue>
<REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE>
</TERM>
<LISTITEM>
<PARA>
The name of an existing view to drop.
The name of an existing view.
</PARA>
</LISTITEM>
</VARLISTENTRY>
</variablelist>
</LISTITEM>
</VARLISTENTRY>
</VARIABLELIST>
</REFSECT2>
<REFSECT2 ID="R2-SQL-DROPVIEW-2">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
@ -64,6 +55,7 @@
<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<replaceable>status</replaceable>
</TERM>
<LISTITEM>
<PARA>
@ -99,7 +91,7 @@
<REFSECT1 ID="R1-SQL-DROPVIEW-1">
<REFSECT1INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT1INFO>
<TITLE>
Description
@ -112,16 +104,18 @@
<REFSECT2 ID="R2-SQL-DROPVIEW-3">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
The PostgreSQL <command>DROP TABLE</command> statement also drops views.
The <productname>Postgres</productname>
<command>DROP TABLE</command> statement also drops views.
</PARA>
<PARA>
Refer to the<command> CREATE VIEW</command> statement for information on how to create views.
Refer to <command>CREATE VIEW</command>
for information on how to create views.
</PARA>
</REFSECT2>
@ -133,7 +127,7 @@
This command will remove the view called <literal>kinds</literal>:
</PARA>
<ProgramListing>
DROP VIEW kinds
DROP VIEW kinds;
</ProgramListing>
</REFSECT1>
@ -146,19 +140,28 @@
<REFSECT2 ID="R2-SQL-DROPVIEW-4">
<REFSECT2INFO>
<DATE>1998-04-15</DATE>
<DATE>1998-09-22</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<PARA>
SQL92 specifies some additional capabilities for
<acronym>SQL92</acronym> specifies some additional capabilities for
<command>DROP VIEW</command>:
</PARA>
<synopsis>
DROP VIEW <replaceable class="parameter">view</replaceable> {RESTRICT | CASCADE}
DROP VIEW <replaceable class="parameter">view</replaceable> { RESTRICT | CASCADE }
</synopsis>
<REFSECT3 ID="R3-SQL-DROPVIEW-1">
<REFSECT3INFO>
<DATE>1998-09-22</DATE>
</REFSECT3INFO>
<TITLE>
Inputs
</TITLE>
<PARA>
<variablelist>
<varlistentry>
<term>RESTRICT</term>
@ -179,10 +182,21 @@
</listitem>
</varlistentry>
</variablelist>
</refsect3>
<REFSECT3 ID="R3-SQL-DROPVIEW-2">
<REFSECT3INFO>
<DATE>1998-09-22</DATE>
</REFSECT3INFO>
<TITLE>
Notes
</TITLE>
<para>
<tip>
<para>
At present, to remove a referenced view from a PostgreSQL database,
you must drop it by hand.
At present, to remove a referenced view from a
<productname>Postgres</productname> database,
you must drop it explicitly.
</para>
</tip>
</refsect2>