Commit 39f69bc3 authored by Thomas G. Lockhart's avatar Thomas G. Lockhart

Start updating for the v7.0 release.

Use "generic functions" for math and other routines.
Use SQL92 "type 'literal'" syntax rather than Postgres "'literal'::type".
parent 2dabd2cd
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
<para> <para>
<productname>PostgreSQL</productname> is available without cost. This manual <productname>PostgreSQL</productname> is available without cost. This manual
describes version 6.5 of <productname>PostgreSQL</productname>. describes version 7.0 of <productname>PostgreSQL</productname>.
</para> </para>
<para> <para>
...@@ -21,7 +21,7 @@ ...@@ -21,7 +21,7 @@
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode:sgml
sgml-omittag:nil sgml-omittag:nil
sgml-shorttag:t sgml-shorttag:t
sgml-minimize-attributes:nil sgml-minimize-attributes:nil
...@@ -31,7 +31,7 @@ sgml-indent-data:t ...@@ -31,7 +31,7 @@ sgml-indent-data:t
sgml-parent-document:nil sgml-parent-document:nil
sgml-default-dtd-file:"./reference.ced" sgml-default-dtd-file:"./reference.ced"
sgml-exposed-tags:nil sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog" sgml-local-catalogs:("/usr/lib/sgml/catalog")
sgml-local-ecat-files:nil sgml-local-ecat-files:nil
End: End:
--> -->
This diff is collapsed.
This diff is collapsed.
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/abort.sgml,v 1.6 2000/03/26 18:32:27 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/abort.sgml,v 1.7 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -129,7 +129,7 @@ ABORT WORK; ...@@ -129,7 +129,7 @@ ABORT WORK;
SQL92 SQL92
</title> </title>
<para> <para>
This command is a <productname>PostgreSQL</productname> extension present This command is a <productname>Postgres</productname> extension present
for historical reasons. <command>ROLLBACK</command> is the <acronym>SQL92</acronym> for historical reasons. <command>ROLLBACK</command> is the <acronym>SQL92</acronym>
equivalent command. equivalent command.
</para> </para>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.10 2000/01/29 16:58:27 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.11 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -247,7 +247,7 @@ ALTER TABLE distributors RENAME TO suppliers; ...@@ -247,7 +247,7 @@ ALTER TABLE distributors RENAME TO suppliers;
<para> <para>
SQL92 specifies some additional capabilities for <command>ALTER TABLE</command> SQL92 specifies some additional capabilities for <command>ALTER TABLE</command>
statement which are not yet directly supported by <productname>PostgreSQL</productname>: statement which are not yet directly supported by <productname>Postgres</productname>:
<variablelist> <variablelist>
<varlistentry> <varlistentry>
...@@ -308,8 +308,8 @@ DROP TABLE temp; ...@@ -308,8 +308,8 @@ DROP TABLE temp;
</para> </para>
<para> <para>
The clauses to rename columns and tables are <productname>PostgreSQL</productname> The clauses to rename columns and tables are <productname>Postgres</productname>
extensions. SQL92 does not provide for them. extensions from SQL92.
</para> </para>
</refsect2> </refsect2>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.10 2000/01/14 22:11:32 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.11 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -138,7 +138,7 @@ ERROR: ALTER USER: user "username" does not exist ...@@ -138,7 +138,7 @@ ERROR: ALTER USER: user "username" does not exist
</title> </title>
<para> <para>
<command>ALTER USER</command> is used to change the attributes of a user's <command>ALTER USER</command> is used to change the attributes of a user's
<productname>PostgreSQL</productname> account. Only a database superuser <productname>Postgres</productname> account. Only a database superuser
can change privileges and password expiration with this command. Ordinary can change privileges and password expiration with this command. Ordinary
users can only change their own password. users can only change their own password.
</para> </para>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/begin.sgml,v 1.10 2000/01/29 16:58:27 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/begin.sgml,v 1.11 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -95,7 +95,7 @@ NOTICE: BEGIN: already a transaction in progress ...@@ -95,7 +95,7 @@ NOTICE: BEGIN: already a transaction in progress
</title> </title>
<para> <para>
By default, <productname>PostgreSQL</productname> executes transactions By default, <productname>Postgres</productname> executes transactions
in <firstterm>unchained mode</firstterm> in <firstterm>unchained mode</firstterm>
(also known as <quote>autocommit</quote> in other database (also known as <quote>autocommit</quote> in other database
systems). systems).
...@@ -116,7 +116,7 @@ NOTICE: BEGIN: already a transaction in progress ...@@ -116,7 +116,7 @@ NOTICE: BEGIN: already a transaction in progress
<para> <para>
The default transaction isolation level in The default transaction isolation level in
<productname>PostgreSQL</productname> <productname>Postgres</productname>
is READ COMMITTED, where queries inside the transaction see only changes is READ COMMITTED, where queries inside the transaction see only changes
committed before query execution. So, you have to use committed before query execution. So, you have to use
<command>SET TRANSACTION ISOLATION LEVEL SERIALIZABLE</command> <command>SET TRANSACTION ISOLATION LEVEL SERIALIZABLE</command>
...@@ -128,7 +128,7 @@ NOTICE: BEGIN: already a transaction in progress ...@@ -128,7 +128,7 @@ NOTICE: BEGIN: already a transaction in progress
</para> </para>
<para> <para>
If the transaction is committed, <productname>PostgreSQL</productname> If the transaction is committed, <productname>Postgres</productname>
will ensure either that all updates are done or else that none of will ensure either that all updates are done or else that none of
them are done. Transactions have the standard <acronym>ACID</acronym> them are done. Transactions have the standard <acronym>ACID</acronym>
(atomic, consistent, isolatable, and durable) property. (atomic, consistent, isolatable, and durable) property.
...@@ -185,7 +185,7 @@ BEGIN WORK; ...@@ -185,7 +185,7 @@ BEGIN WORK;
<para> <para>
<command>BEGIN</command> <command>BEGIN</command>
is a <productname>PostgreSQL</productname> language extension. is a <productname>Postgres</productname> language extension.
There is no explicit <command>BEGIN</command> There is no explicit <command>BEGIN</command>
command in <acronym>SQL92</acronym>; command in <acronym>SQL92</acronym>;
transaction initiation is always implicit and it terminates either transaction initiation is always implicit and it terminates either
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_database.sgml,v 1.12 2000/03/26 18:32:27 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_database.sgml,v 1.13 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -157,7 +157,7 @@ CREATE DATABASE <replaceable class="PARAMETER">name</replaceable> [ WITH LOCATIO ...@@ -157,7 +157,7 @@ CREATE DATABASE <replaceable class="PARAMETER">name</replaceable> [ WITH LOCATIO
</title> </title>
<para> <para>
<command>CREATE DATABASE</command> creates a new <command>CREATE DATABASE</command> creates a new
<productname>PostgreSQL</productname> database. <productname>Postgres</productname> database.
The creator becomes the owner of the new database. The creator becomes the owner of the new database.
</para> </para>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.12 2000/03/26 18:32:27 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.13 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -20,26 +20,24 @@ Postgres documentation ...@@ -20,26 +20,24 @@ Postgres documentation
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <refsynopsisdivinfo>
<date>1999-10-02</date> <date>2000-03-25</date>
</refsynopsisdivinfo> </refsynopsisdivinfo>
<synopsis> <synopsis>
CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceable class="parameter">ftype</replaceable> [, ...] ] ) CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceable class="parameter">ftype</replaceable> [, ...] ] )
RETURNS <replaceable class="parameter">rtype</replaceable> RETURNS <replaceable class="parameter">rtype</replaceable>
[ WITH ( <replaceable class="parameter">attribute</replaceable> [, ...] ) ]
AS <replaceable class="parameter">definition</replaceable> AS <replaceable class="parameter">definition</replaceable>
LANGUAGE '<replaceable class="parameter">langname</replaceable>' LANGUAGE '<replaceable class="parameter">langname</replaceable>'
[ WITH ( <replaceable class="parameter">attribute</replaceable> [, ...] ) ]
CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceable class="parameter">ftype</replaceable> [, ...] ] ) CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceable class="parameter">ftype</replaceable> [, ...] ] )
RETURNS <replaceable class="parameter">rtype</replaceable> RETURNS <replaceable class="parameter">rtype</replaceable>
[ WITH ( <replaceable class="parameter">attribute</replaceable> [, ...] ) ]
AS <replaceable class="parameter">obj_file</replaceable> , <replaceable class="parameter">link_symbol</replaceable> AS <replaceable class="parameter">obj_file</replaceable> , <replaceable class="parameter">link_symbol</replaceable>
LANGUAGE 'C' LANGUAGE 'C'
[ WITH ( <replaceable class="parameter">attribute</replaceable> [, ...] ) ]
</synopsis> </synopsis>
<refsect2 id="R2-SQL-CREATEFUNCTION-1"> <refsect2 id="R2-SQL-CREATEFUNCTION-1">
<refsect2info> <refsect2info>
<date>1998-09-09</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
Inputs Inputs
...@@ -143,7 +141,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab ...@@ -143,7 +141,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab
<refsect2 id="R2-SQL-CREATEFUNCTION-2"> <refsect2 id="R2-SQL-CREATEFUNCTION-2">
<refsect2info> <refsect2info>
<date>1998-09-09</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
Outputs Outputs
...@@ -168,7 +166,7 @@ CREATE ...@@ -168,7 +166,7 @@ CREATE
<refsect1 id="R1-SQL-CREATEFUNCTION-1"> <refsect1 id="R1-SQL-CREATEFUNCTION-1">
<refsect1info> <refsect1info>
<date>1998-09-09</date> <date>2000-03-25</date>
</refsect1info> </refsect1info>
<title> <title>
Description Description
...@@ -177,28 +175,29 @@ CREATE ...@@ -177,28 +175,29 @@ CREATE
<command>CREATE FUNCTION</command> allows a <command>CREATE FUNCTION</command> allows a
<productname>Postgres</productname> user <productname>Postgres</productname> user
to register a function to register a function
with a database. Subsequently, this user is treated as the with a database. Subsequently, this user is considered the
owner of the function. owner of the function.
</para> </para>
<refsect2 id="R2-SQL-CREATEFUNCTION-3"> <refsect2 id="R2-SQL-CREATEFUNCTION-3">
<refsect2info> <refsect2info>
<date>1998-09-09</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
Notes Notes
</title> </title>
<para> <para>
Refer to the chapter in Refer to the chapter in the
the <citetitle>PostgreSQL Programmer's Guide</citetitle> <citetitle>PostgreSQL Programmer's Guide</citetitle>
on extending on the topic of extending
<productname>Postgres</productname> via functions <productname>Postgres</productname> via functions
for further information on writing external functions. for further information on writing external functions.
</para> </para>
<para> <para>
Use <command>DROP FUNCTION</command> Use <command>DROP FUNCTION</command>
to drop user-defined functions. to remove user-defined functions.
</para> </para>
<para> <para>
...@@ -207,7 +206,17 @@ CREATE ...@@ -207,7 +206,17 @@ CREATE
so long as they have distinct argument types. This facility must so long as they have distinct argument types. This facility must
be used with caution for <literal>internal</literal> and be used with caution for <literal>internal</literal> and
C-language functions, however. C-language functions, however.
</para> </para>
<para>
The full <acronym>SQL92</acronym> type syntax is allowed for
input arguments and return value. However, some details of the
type specification (e.g. the precision field for
<type>numeric</type> types) are the responsibility of the
underlying function implementation and are silently swallowed
(e.g. not recognized or
enforced) by the <command>CREATE FUNCTION</command> command.
</para>
<para> <para>
Two <literal>internal</literal> Two <literal>internal</literal>
...@@ -242,18 +251,18 @@ CREATE ...@@ -242,18 +251,18 @@ CREATE
<para> <para>
To create a simple SQL function: To create a simple SQL function:
<programlisting> <programlisting>
CREATE FUNCTION one() RETURNS int4 CREATE FUNCTION one() RETURNS int4
AS 'SELECT 1 AS RESULT' AS 'SELECT 1 AS RESULT'
LANGUAGE 'sql'; LANGUAGE 'sql';
SELECT one() AS answer; SELECT one() AS answer;
<computeroutput> <computeroutput>
answer answer
-------- --------
1 1
</computeroutput> </computeroutput>
</programlisting> </programlisting>
</para> </para>
<para> <para>
...@@ -317,7 +326,7 @@ Point * complex_to_point (Complex *z) ...@@ -317,7 +326,7 @@ Point * complex_to_point (Complex *z)
<refsect2 id="R2-SQL-CREATEFUNCTION-4"> <refsect2 id="R2-SQL-CREATEFUNCTION-4">
<refsect2info> <refsect2info>
<date>1998-04-15</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
SQL92 SQL92
...@@ -331,7 +340,7 @@ Point * complex_to_point (Complex *z) ...@@ -331,7 +340,7 @@ Point * complex_to_point (Complex *z)
<refsect2 id="R2-SQL-CREATEFUNCTION-5"> <refsect2 id="R2-SQL-CREATEFUNCTION-5">
<refsect2info> <refsect2info>
<date>1998-09-09</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
SQL/PSM SQL/PSM
...@@ -364,7 +373,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ...@@ -364,7 +373,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
Local variables: Local variables:
mode: sgml mode:sgml
sgml-omittag:nil sgml-omittag:nil
sgml-shorttag:t sgml-shorttag:t
sgml-minimize-attributes:nil sgml-minimize-attributes:nil
...@@ -374,7 +383,7 @@ sgml-indent-data:t ...@@ -374,7 +383,7 @@ sgml-indent-data:t
sgml-parent-document:nil sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced" sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog" sgml-local-catalogs:("/usr/lib/sgml/catalog")
sgml-local-ecat-files:nil sgml-local-ecat-files:nil
End: End:
--> -->
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_group.sgml,v 1.1 2000/01/14 22:11:32 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_group.sgml,v 1.2 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -53,7 +53,7 @@ CREATE GROUP <replaceable class="PARAMETER">name</replaceable> ...@@ -53,7 +53,7 @@ CREATE GROUP <replaceable class="PARAMETER">name</replaceable>
<listitem> <listitem>
<para> <para>
The <literal>SYSID</literal> clause can be used to choose The <literal>SYSID</literal> clause can be used to choose
the <productname>PostgreSQL</productname> group id of the new the <productname>Postgres</productname> group id of the new
group. It is not necessary to do so, however. group. It is not necessary to do so, however.
</para> </para>
<para> <para>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.12 2000/03/18 18:03:12 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.13 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -20,7 +20,7 @@ Postgres documentation ...@@ -20,7 +20,7 @@ Postgres documentation
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <refsynopsisdivinfo>
<date>1999-07-20</date> <date>2000-03-25</date>
</refsynopsisdivinfo> </refsynopsisdivinfo>
<synopsis> <synopsis>
CREATE OPERATOR <replaceable>name</replaceable> ( PROCEDURE = <replaceable class="parameter">func_name</replaceable> CREATE OPERATOR <replaceable>name</replaceable> ( PROCEDURE = <replaceable class="parameter">func_name</replaceable>
...@@ -32,7 +32,7 @@ CREATE OPERATOR <replaceable>name</replaceable> ( PROCEDURE = <replaceable class ...@@ -32,7 +32,7 @@ CREATE OPERATOR <replaceable>name</replaceable> ( PROCEDURE = <replaceable class
<refsect2 id="R2-SQL-CREATEOPERATOR-1"> <refsect2 id="R2-SQL-CREATEOPERATOR-1">
<refsect2info> <refsect2info>
<date>1999-04-14</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
Inputs Inputs
...@@ -138,7 +138,7 @@ CREATE OPERATOR <replaceable>name</replaceable> ( PROCEDURE = <replaceable class ...@@ -138,7 +138,7 @@ CREATE OPERATOR <replaceable>name</replaceable> ( PROCEDURE = <replaceable class
<refsect2 id="R2-SQL-CREATEOPERATOR-2"> <refsect2 id="R2-SQL-CREATEOPERATOR-2">
<refsect2info> <refsect2info>
<date>1999-04-14</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
Outputs Outputs
...@@ -162,7 +162,7 @@ CREATE ...@@ -162,7 +162,7 @@ CREATE
<refsect1 id="R1-SQL-CREATEOPERATOR-1"> <refsect1 id="R1-SQL-CREATEOPERATOR-1">
<refsect1info> <refsect1info>
<date>1999-04-14</date> <date>2000-03-25</date>
</refsect1info> </refsect1info>
<title> <title>
Description Description
...@@ -248,13 +248,13 @@ CREATE ...@@ -248,13 +248,13 @@ CREATE
Hence, the query optimizer could freely convert: Hence, the query optimizer could freely convert:
<programlisting> <programlisting>
"0,0,1,1"::box &gt;&gt;&gt; MYBOXES.description box '((0,0),(1,1))' &gt;&gt;&gt; MYBOXES.description
</programlisting> </programlisting>
to to
<programlisting> <programlisting>
MYBOXES.description &lt;&lt;&lt; "0,0,1,1"::box MYBOXES.description &lt;&lt;&lt; box '((0,0),(1,1))'
</programlisting> </programlisting>
</para> </para>
<para> <para>
...@@ -269,11 +269,11 @@ MYBOXES.description &lt;&lt;&lt; "0,0,1,1"::box ...@@ -269,11 +269,11 @@ MYBOXES.description &lt;&lt;&lt; "0,0,1,1"::box
equal, !==. equal, !==.
The negator link allows the query optimizer to simplify The negator link allows the query optimizer to simplify
<programlisting> <programlisting>
NOT MYBOXES.description === "0,0,1,1"::box NOT MYBOXES.description === box '((0,0),(1,1))'
</programlisting> </programlisting>
to to
<programlisting> <programlisting>
MYBOXES.description !== "0,0,1,1"::box MYBOXES.description !== box '((0,0),(1,1))'
</programlisting> </programlisting>
</para> </para>
<para> <para>
...@@ -331,7 +331,7 @@ MYBOXES.description !== "0,0,1,1"::box ...@@ -331,7 +331,7 @@ MYBOXES.description !== "0,0,1,1"::box
The RESTRICT and JOIN options assist the query optimizer in estimating The RESTRICT and JOIN options assist the query optimizer in estimating
result sizes. If a clause of the form: result sizes. If a clause of the form:
<programlisting> <programlisting>
MYBOXES.description &lt;&lt;&lt; "0,0,1,1"::box MYBOXES.description &lt;&lt;&lt; box '((0,0),(1,1))'
</programlisting> </programlisting>
is present in the qualification, is present in the qualification,
then <productname>Postgres</productname> may have to then <productname>Postgres</productname> may have to
...@@ -342,7 +342,7 @@ MYBOXES.description &lt;&lt;&lt; "0,0,1,1"::box ...@@ -342,7 +342,7 @@ MYBOXES.description &lt;&lt;&lt; "0,0,1,1"::box
<command>CREATE FUNCTION</command>) which accepts arguments of the correct <command>CREATE FUNCTION</command>) which accepts arguments of the correct
data types and returns a floating point number. The data types and returns a floating point number. The
query optimizer simply calls this function, passing the query optimizer simply calls this function, passing the
parameter "0,0,1,1" and multiplies the result by the relation parameter <literal>((0,0),(1,1))</literal> and multiplies the result by the relation
size to get the expected number of instances. size to get the expected number of instances.
</para> </para>
<para> <para>
...@@ -356,11 +356,11 @@ MYBOXES.description &lt;&lt;&lt; "0,0,1,1"::box ...@@ -356,11 +356,11 @@ MYBOXES.description &lt;&lt;&lt; "0,0,1,1"::box
<para> <para>
The difference between the function The difference between the function
<programlisting> <programlisting>
my_procedure_1 (MYBOXES.description, "0,0,1,1"::box) my_procedure_1 (MYBOXES.description, box '((0,0),(1,1))')
</programlisting> </programlisting>
and the operator and the operator
<programlisting> <programlisting>
MYBOXES.description === "0,0,1,1"::box MYBOXES.description === box '((0,0),(1,1))'
</programlisting> </programlisting>
is that <productname>Postgres</productname> is that <productname>Postgres</productname>
attempts to optimize operators and can attempts to optimize operators and can
...@@ -373,7 +373,7 @@ MYBOXES.description === "0,0,1,1"::box ...@@ -373,7 +373,7 @@ MYBOXES.description === "0,0,1,1"::box
<refsect2 id="R2-SQL-CREATEOPERATOR-3"> <refsect2 id="R2-SQL-CREATEOPERATOR-3">
<refsect2info> <refsect2info>
<date>1999-04-14</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
Notes Notes
...@@ -418,7 +418,7 @@ CREATE OPERATOR === ( ...@@ -418,7 +418,7 @@ CREATE OPERATOR === (
<refsect2 id="R2-SQL-CREATEOPERATOR-4"> <refsect2 id="R2-SQL-CREATEOPERATOR-4">
<refsect2info> <refsect2info>
<date>1999-04-14</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
SQL92 SQL92
......
This diff is collapsed.
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.8 1999/07/22 15:09:08 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.9 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -20,7 +20,7 @@ Postgres documentation ...@@ -20,7 +20,7 @@ Postgres documentation
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <refsynopsisdivinfo>
<date>1999-07-20</date> <date>2000-03-25</date>
</refsynopsisdivinfo> </refsynopsisdivinfo>
<synopsis> <synopsis>
CREATE TRIGGER <replaceable class="PARAMETER">name</replaceable> { BEFORE | AFTER } { <replaceable class="PARAMETER">event</replaceable> [OR ...] } CREATE TRIGGER <replaceable class="PARAMETER">name</replaceable> { BEFORE | AFTER } { <replaceable class="PARAMETER">event</replaceable> [OR ...] }
...@@ -152,7 +152,7 @@ CREATE ...@@ -152,7 +152,7 @@ CREATE
Only the relation owner may create a trigger on this relation. Only the relation owner may create a trigger on this relation.
</para> </para>
<para> <para>
As of the current release (v6.4), STATEMENT triggers are not implemented. As of the current release (v7.0), STATEMENT triggers are not implemented.
</para> </para>
<para> <para>
Refer to <command>DROP TRIGGER</command> for information on how to Refer to <command>DROP TRIGGER</command> for information on how to
...@@ -217,11 +217,6 @@ CREATE TABLE distributors ( ...@@ -217,11 +217,6 @@ CREATE TABLE distributors (
); );
</programlisting> </programlisting>
</para> </para>
<para>
However, foreign keys are not yet implemented (as of version 6.5) in
<productname>Postgres</productname>.
</para>
</refsect2> </refsect2>
</refsect1> </refsect1>
</refentry> </refentry>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_type.sgml,v 1.11 1999/08/06 13:50:30 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_type.sgml,v 1.12 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -289,8 +289,8 @@ CREATE ...@@ -289,8 +289,8 @@ CREATE
A "regular" Postgres type can only be 8192 bytes in A "regular" Postgres type can only be 8192 bytes in
length. If you need a larger type you must create a Large length. If you need a larger type you must create a Large
Object type. The interface for these types is discussed Object type. The interface for these types is discussed
at length in at length in the
<citetitle>The PostgreSQL Programmer's Guide</citetitle>. <citetitle>PostgreSQL Programmer's Guide</citetitle>.
The length of all large object types is always VARIABLE. The length of all large object types is always VARIABLE.
</para> </para>
</refsect2> </refsect2>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_user.sgml,v 1.13 2000/01/14 22:11:32 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_user.sgml,v 1.14 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -56,7 +56,7 @@ CREATE USER <replaceable class="PARAMETER">username</replaceable> ...@@ -56,7 +56,7 @@ CREATE USER <replaceable class="PARAMETER">username</replaceable>
<listitem> <listitem>
<para> <para>
The <literal>SYSID</literal> clause can be used to choose The <literal>SYSID</literal> clause can be used to choose
the <productname>PostgreSQL</productname> user id of the user the <productname>Postgres</productname> user id of the user
that is being created. It is not at all necessary that those that is being created. It is not at all necessary that those
match the <acronym>UNIX</acronym> user ids, but some people match the <acronym>UNIX</acronym> user ids, but some people
choose to keep the numbers the same. choose to keep the numbers the same.
...@@ -164,7 +164,7 @@ CREATE USER <replaceable class="PARAMETER">username</replaceable> ...@@ -164,7 +164,7 @@ CREATE USER <replaceable class="PARAMETER">username</replaceable>
</title> </title>
<para> <para>
CREATE USER will add a new user to an instance of CREATE USER will add a new user to an instance of
<productname>PostgreSQL</productname>. Refer to the adminstrator's <productname>Postgres</productname>. Refer to the adminstrator's
guide for information about managing users and authentication. guide for information about managing users and authentication.
You must be a database superuser to use this command. You must be a database superuser to use this command.
</para> </para>
...@@ -173,7 +173,7 @@ CREATE USER <replaceable class="PARAMETER">username</replaceable> ...@@ -173,7 +173,7 @@ CREATE USER <replaceable class="PARAMETER">username</replaceable>
to change a user's password and privileges, and <xref linkend="SQL-DROPUSER" to change a user's password and privileges, and <xref linkend="SQL-DROPUSER"
endterm="SQL-DROPUSER-title"> to remove a user. endterm="SQL-DROPUSER-title"> to remove a user.
Use <command>ALTER GROUP</command> to add or remove the user from other groups. Use <command>ALTER GROUP</command> to add or remove the user from other groups.
<productname>PostgreSQL</productname> <productname>Postgres</productname>
comes with a script <xref linkend="APP-CREATEUSER" comes with a script <xref linkend="APP-CREATEUSER"
endterm="APP-CREATEUSER-title"> endterm="APP-CREATEUSER-title">
which has the same functionality as this command (in fact, it calls this command) which has the same functionality as this command (in fact, it calls this command)
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_view.sgml,v 1.8 2000/03/26 18:32:27 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_view.sgml,v 1.9 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -20,15 +20,15 @@ Postgres documentation ...@@ -20,15 +20,15 @@ Postgres documentation
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo> <refsynopsisdivinfo>
<date>1999-07-20</date> <date>2000-03-25</date>
</refsynopsisdivinfo> </refsynopsisdivinfo>
<synopsis> <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> </synopsis>
<refsect2 id="R2-SQL-CREATEVIEW-1"> <refsect2 id="R2-SQL-CREATEVIEW-1">
<refsect2info> <refsect2info>
<date>1998-09-21</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
Inputs Inputs
...@@ -62,7 +62,7 @@ CREATE VIEW <replaceable class="PARAMETER">view</replaceable> AS SELECT <replace ...@@ -62,7 +62,7 @@ CREATE VIEW <replaceable class="PARAMETER">view</replaceable> AS SELECT <replace
<refsect2 id="R2-SQL-CREATEVIEW-2"> <refsect2 id="R2-SQL-CREATEVIEW-2">
<refsect2info> <refsect2info>
<date>1998-09-21</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
Outputs Outputs
...@@ -97,13 +97,15 @@ NOTICE create: attribute named "<replaceable class="parameter">column</replaceab ...@@ -97,13 +97,15 @@ NOTICE create: attribute named "<replaceable class="parameter">column</replaceab
<para> <para>
The view will be created having a column with an unknown type The view will be created having a column with an unknown type
if you do not specify it. For example, the following command gives if you do not specify it. For example, the following command gives
an error: a warning:
<programlisting> <programlisting>
CREATE VIEW vista AS SELECT 'Hello World' CREATE VIEW vista AS SELECT 'Hello World'
</programlisting> </programlisting>
whereas this command does not: whereas this command does not:
<programlisting> <programlisting>
CREATE VIEW vista AS SELECT 'Hello World'::text CREATE VIEW vista AS SELECT text 'Hello World'
</programlisting> </programlisting>
</para> </para>
</listitem> </listitem>
...@@ -115,7 +117,7 @@ CREATE VIEW vista AS SELECT 'Hello World'::text ...@@ -115,7 +117,7 @@ CREATE VIEW vista AS SELECT 'Hello World'::text
<refsect1 id="R1-SQL-CREATEVIEW-1"> <refsect1 id="R1-SQL-CREATEVIEW-1">
<refsect1info> <refsect1info>
<date>1998-09-21</date> <date>2000-03-25</date>
</refsect1info> </refsect1info>
<title> <title>
Description Description
...@@ -129,7 +131,7 @@ CREATE VIEW vista AS SELECT 'Hello World'::text ...@@ -129,7 +131,7 @@ CREATE VIEW vista AS SELECT 'Hello World'::text
<refsect2 id="R2-SQL-CREATEVIEW-3"> <refsect2 id="R2-SQL-CREATEVIEW-3">
<refsect2info> <refsect2info>
<date>1998-09-21</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
Notes Notes
...@@ -176,7 +178,7 @@ SELECT * FROM kinds; ...@@ -176,7 +178,7 @@ SELECT * FROM kinds;
<refsect2 id="R2-SQL-CREATEVIEW-5"> <refsect2 id="R2-SQL-CREATEVIEW-5">
<refsect2info> <refsect2info>
<date>1998-09-21</date> <date>2000-03-25</date>
</refsect2info> </refsect2info>
<title> <title>
SQL92 SQL92
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.9 2000/02/10 20:08:55 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.10 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -15,7 +15,7 @@ Postgres documentation ...@@ -15,7 +15,7 @@ Postgres documentation
<application>createdb</application> <application>createdb</application>
</refname> </refname>
<refpurpose> <refpurpose>
Create a new <productname>PostgreSQL</productname> database Create a new <productname>Postgres</productname> database
</refpurpose> </refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
...@@ -120,7 +120,7 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c ...@@ -120,7 +120,7 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
<listitem> <listitem>
<para> <para>
Specifies the name of the database to be created. The name must be Specifies the name of the database to be created. The name must be
unique among all <productname>PostgreSQL</productname> databases in this installation. unique among all <productname>Postgres</productname> databases in this installation.
The default is to create a database with the same name as the The default is to create a database with the same name as the
current system user. current system user.
</para> </para>
...@@ -196,7 +196,7 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c ...@@ -196,7 +196,7 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
Description Description
</title> </title>
<para> <para>
<application>createdb</application> creates a new <productname>PostgreSQL</productname> <application>createdb</application> creates a new <productname>Postgres</productname>
database. The user who executes this command becomes the database owner. database. The user who executes this command becomes the database owner.
</para> </para>
...@@ -204,7 +204,7 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c ...@@ -204,7 +204,7 @@ createdb [ <replaceable class="parameter">options</replaceable> ] <replaceable c
<application>createdb</application> is a shell script wrapper around the <application>createdb</application> is a shell script wrapper around the
<acronym>SQL</acronym> command <acronym>SQL</acronym> command
<xref linkend="SQL-CREATEDATABASE" endterm="SQL-CREATEDATABASE-title"> via <xref linkend="SQL-CREATEDATABASE" endterm="SQL-CREATEDATABASE-title"> via
the <productname>PostgreSQL</productname> interactive terminal the <productname>Postgres</productname> interactive terminal
<xref linkend="APP-PSQL" endterm="APP-PSQL-title">. Thus, there is nothing <xref linkend="APP-PSQL" endterm="APP-PSQL-title">. Thus, there is nothing
special about creating databases via this or other methods. This means special about creating databases via this or other methods. This means
that the <application>psql</application> must be found by the script and that that the <application>psql</application> must be found by the script and that
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.4 2000/01/19 20:08:22 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.5 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -15,7 +15,7 @@ Postgres documentation ...@@ -15,7 +15,7 @@ Postgres documentation
<application>createlang</application> <application>createlang</application>
</refname> </refname>
<refpurpose> <refpurpose>
Add a new programming language to a <productname>PostgreSQL</productname> database Add a new programming language to a <productname>Postgres</productname> database
</refpurpose> </refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
...@@ -145,7 +145,7 @@ createlang [ <replaceable class="parameter">connection options</replaceable> ] - ...@@ -145,7 +145,7 @@ createlang [ <replaceable class="parameter">connection options</replaceable> ] -
<para> <para>
<application>createlang</application> is a utility for adding a new <application>createlang</application> is a utility for adding a new
programming language to a <productname>PostgreSQL</productname> database. programming language to a <productname>Postgres</productname> database.
<application>createlang</application> currently accepts two <application>createlang</application> currently accepts two
languages, <literal>plsql</literal> and <literal>pltcl</literal>. languages, <literal>plsql</literal> and <literal>pltcl</literal>.
</para> </para>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.8 2000/01/12 19:36:34 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.9 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -15,7 +15,7 @@ Postgres documentation ...@@ -15,7 +15,7 @@ Postgres documentation
<application>createuser</application> <application>createuser</application>
</refname> </refname>
<refpurpose> <refpurpose>
Create a new <productname>PostgreSQL</productname> user Create a new <productname>Postgres</productname> user
</refpurpose> </refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
...@@ -139,8 +139,8 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab ...@@ -139,8 +139,8 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab
<term><replaceable class="parameter">username</replaceable></term> <term><replaceable class="parameter">username</replaceable></term>
<listitem> <listitem>
<para> <para>
Specifies the name of the <productname>PostgreSQL</productname> user to be created. Specifies the name of the <productname>Postgres</productname> user to be created.
This name must be unique among all <productname>PostgreSQL</productname> users. This name must be unique among all <productname>Postgres</productname> users.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -203,7 +203,7 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab ...@@ -203,7 +203,7 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab
</title> </title>
<para> <para>
<application>createuser</application> creates a <application>createuser</application> creates a
new <productname>PostgreSQL</productname> user. new <productname>Postgres</productname> user.
Only users with <literal>usesuper</literal> set in Only users with <literal>usesuper</literal> set in
the <literal>pg_shadow</literal> class can create the <literal>pg_shadow</literal> class can create
new <productname>Postgres</productname> users. new <productname>Postgres</productname> users.
...@@ -213,7 +213,7 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab ...@@ -213,7 +213,7 @@ createuser [ <replaceable class="parameter">options</replaceable> ] [ <replaceab
<application>createuser</application> is a shell script wrapper around the <application>createuser</application> is a shell script wrapper around the
<acronym>SQL</acronym> command <acronym>SQL</acronym> command
<xref linkend="SQL-CREATEUSER" endterm="SQL-CREATEUSER-title"> via <xref linkend="SQL-CREATEUSER" endterm="SQL-CREATEUSER-title"> via
the <productname>PostgreSQL</productname> interactive terminal the <productname>Postgres</productname> interactive terminal
<xref linkend="APP-PSQL" endterm="APP-PSQL-title">. Thus, there is nothing <xref linkend="APP-PSQL" endterm="APP-PSQL-title">. Thus, there is nothing
special about creating users via this or other methods. This means special about creating users via this or other methods. This means
that the <application>psql</application> must be found by the script and that that the <application>psql</application> must be found by the script and that
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_user.sgml,v 1.10 2000/01/14 22:11:32 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_user.sgml,v 1.11 2000/03/27 17:14:42 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -109,7 +109,7 @@ DROP USER: user "<replaceable class="parameter">name</replaceable>" owns databas ...@@ -109,7 +109,7 @@ DROP USER: user "<replaceable class="parameter">name</replaceable>" owns databas
Use <xref linkend="SQL-CREATEUSER" endterm="SQL-CREATEUSER-title"> Use <xref linkend="SQL-CREATEUSER" endterm="SQL-CREATEUSER-title">
to add new users, and <xref linkend="SQL-ALTERUSER" to add new users, and <xref linkend="SQL-ALTERUSER"
endterm="SQL-ALTERUSER-title"> to change a user's properties. endterm="SQL-ALTERUSER-title"> to change a user's properties.
<productname>PostgreSQL</productname> <productname>Postgres</productname>
comes with a script <xref linkend="APP-DROPUSER" comes with a script <xref linkend="APP-DROPUSER"
endterm="APP-DROPUSER-title"> endterm="APP-DROPUSER-title">
which has the same functionality as this command (in fact, it calls this command) which has the same functionality as this command (in fact, it calls this command)
......
This diff is collapsed.
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.2 2000/01/19 20:08:22 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.3 2000/03/27 17:14:43 thomas Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -15,7 +15,7 @@ Postgres documentation ...@@ -15,7 +15,7 @@ Postgres documentation
<application>droplang</application> <application>droplang</application>
</refname> </refname>
<refpurpose> <refpurpose>
Remove a programming language from a <productname>PostgreSQL</productname> database Remove a programming language from a <productname>Postgres</productname> database
</refpurpose> </refpurpose>
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
...@@ -146,7 +146,7 @@ droplang [ <replaceable class="parameter">connection options</replaceable> ] --l ...@@ -146,7 +146,7 @@ droplang [ <replaceable class="parameter">connection options</replaceable> ] --l
<para> <para>
<application>droplang</application> is a utility for removing an <application>droplang</application> is a utility for removing an
existing programming language from a existing programming language from a
<productname>PostgreSQL</productname> database. <productname>Postgres</productname> database.
<application>droplang</application> currently accepts two <application>droplang</application> currently accepts two
languages, <literal>plsql</literal> and <literal>pltcl</literal>. languages, <literal>plsql</literal> and <literal>pltcl</literal>.
</para> </para>
......
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment