Skip to content
Snippets Groups Projects
Commit d4019b7c authored by Tom Lane's avatar Tom Lane
Browse files

Remove a bunch of content-free Diagnostics sections, as per previous 

discussion.  (Still have some work to do editing the remainder.)
parent 1815f617
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
Showing
with 195 additions and 612 deletions
doc/src/sgml/ref/abort.sgml
+ 19
− 28
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/abort.sgml,v 1.14 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/abort.sgml,v 1.15 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -31,7 +31,8 @@ ABORT [ WORK | TRANSACTION ] ...@@ -31,7 +31,8 @@ ABORT [ WORK | TRANSACTION ]
<command>ABORT</command> rolls back the current transaction and causes <command>ABORT</command> rolls back the current transaction and causes
all the updates made by the transaction to be discarded. all the updates made by the transaction to be discarded.
This command is identical This command is identical
in behavior to the standard <acronym>SQL</acronym> command <command>ROLLBACK</command>, in behavior to the standard <acronym>SQL</acronym> command
<xref linkend="SQL-ROLLBACK" endterm="SQL-ROLLBACK-TITLE">,
and is present only for historical reasons. and is present only for historical reasons.
</para> </para>
</refsect1> </refsect1>
...@@ -52,36 +53,17 @@ ABORT [ WORK | TRANSACTION ] ...@@ -52,36 +53,17 @@ ABORT [ WORK | TRANSACTION ]
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ROLLBACK</computeroutput></term>
<listitem>
<para>
Message returned if successful.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>WARNING: ROLLBACK: no transaction in progress</computeroutput></term>
<listitem>
<para>
If there is not any transaction currently in progress.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Notes</title> <title>Notes</title>
<para> <para>
Use <command>COMMIT</command> to successfully Use <xref linkend="SQL-COMMIT" endterm="SQL-COMMIT-TITLE"> to
terminate a transaction. successfully terminate a transaction.
</para>
<para>
Issuing <command>ABORT</> when not inside a transaction does
no harm, but it will provoke a warning message.
</para> </para>
</refsect1> </refsect1>
...@@ -106,6 +88,15 @@ ABORT; ...@@ -106,6 +88,15 @@ ABORT;
</para> </para>
</refsect1> </refsect1>
<refsect1>
<title>See Also</title>
<simplelist type="inline">
<member><xref linkend="sql-begin" endterm="sql-begin-title"></member>
<member><xref linkend="sql-commit" endterm="sql-commit-title"></member>
<member><xref linkend="sql-rollback" endterm="sql-rollback-title"></member>
</simplelist>
</refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
......
doc/src/sgml/ref/alter_aggregate.sgml
+ 3
− 18
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_aggregate.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_aggregate.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -29,8 +29,8 @@ ALTER AGGREGATE <replaceable>name</replaceable> ( <replaceable>type</replaceable ...@@ -29,8 +29,8 @@ ALTER AGGREGATE <replaceable>name</replaceable> ( <replaceable>type</replaceable
<para> <para>
<command>ALTER AGGREGATE</command> changes the definition of an <command>ALTER AGGREGATE</command> changes the definition of an
aggregate function. The only functionality is to rename the aggregate function. The only currently available functionality is to
aggregate function. rename the aggregate function.
</para> </para>
</refsect1> </refsect1>
...@@ -67,21 +67,6 @@ ALTER AGGREGATE <replaceable>name</replaceable> ( <replaceable>type</replaceable ...@@ -67,21 +67,6 @@ ALTER AGGREGATE <replaceable>name</replaceable> ( <replaceable>type</replaceable
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER AGGREGATE</computeroutput></term>
<listitem>
<para>
Message returned if the command was successful.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Examples</title> <title>Examples</title>
......
doc/src/sgml/ref/alter_conversion.sgml
+ 3
− 17
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_conversion.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_conversion.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -29,7 +29,8 @@ ALTER CONVERSION <replaceable>name</replaceable> RENAME TO <replaceable>newname< ...@@ -29,7 +29,8 @@ ALTER CONVERSION <replaceable>name</replaceable> RENAME TO <replaceable>newname<
<para> <para>
<command>ALTER CONVERSION</command> changes the definition of a <command>ALTER CONVERSION</command> changes the definition of a
conversion. The only functionality is to rename the conversion. conversion. The only currently available functionality is to rename the
conversion.
</para> </para>
</refsect1> </refsect1>
...@@ -56,21 +57,6 @@ ALTER CONVERSION <replaceable>name</replaceable> RENAME TO <replaceable>newname< ...@@ -56,21 +57,6 @@ ALTER CONVERSION <replaceable>name</replaceable> RENAME TO <replaceable>newname<
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER CONVERSION</computeroutput></term>
<listitem>
<para>
Message returned if the command was successful.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Examples</title> <title>Examples</title>
......
doc/src/sgml/ref/alter_database.sgml
+ 1
− 26
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_database.sgml,v 1.8 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_database.sgml,v 1.9 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -103,31 +103,6 @@ ALTER DATABASE <replaceable class="PARAMETER">name</replaceable> RENAME TO <repl ...@@ -103,31 +103,6 @@ ALTER DATABASE <replaceable class="PARAMETER">name</replaceable> RENAME TO <repl
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER DATABASE</computeroutput></term>
<listitem>
<para>
Message returned if the alteration was successful.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>ERROR: database "dbname" does not exist</computeroutput></term>
<listitem>
<para>
Error message returned if the specified database is not known
to the system.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Notes</title> <title>Notes</title>
......
doc/src/sgml/ref/alter_domain.sgml
+ 81
− 116
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_domain.sgml,v 1.8 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_domain.sgml,v 1.9 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -23,9 +23,6 @@ PostgreSQL documentation ...@@ -23,9 +23,6 @@ PostgreSQL documentation
</indexterm> </indexterm>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo>
<date>2002-11-27</date>
</refsynopsisdivinfo>
<synopsis> <synopsis>
ALTER DOMAIN <replaceable class="PARAMETER">domain</replaceable> ALTER DOMAIN <replaceable class="PARAMETER">domain</replaceable>
{ SET DEFAULT <replaceable class="PARAMETER">value</replaceable> | DROP DEFAULT } { SET DEFAULT <replaceable class="PARAMETER">value</replaceable> | DROP DEFAULT }
...@@ -38,116 +35,11 @@ ALTER DOMAIN <replaceable class="PARAMETER">domain</replaceable> ...@@ -38,116 +35,11 @@ ALTER DOMAIN <replaceable class="PARAMETER">domain</replaceable>
ALTER DOMAIN <replaceable class="PARAMETER">domain</replaceable> ALTER DOMAIN <replaceable class="PARAMETER">domain</replaceable>
OWNER TO <replaceable class="PARAMETER">new_owner</replaceable> OWNER TO <replaceable class="PARAMETER">new_owner</replaceable>
</synopsis> </synopsis>
<refsect2 id="R2-SQL-ALTERDOMAIN-1">
<refsect2info>
<date>2002-11-27</date>
</refsect2info>
<title>
Inputs
</title>
<para>
<variablelist>
<varlistentry>
<term><replaceable class="PARAMETER"> domain </replaceable></term>
<listitem>
<para>
The name (possibly schema-qualified) of an existing domain to
alter.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="PARAMETER"> domain_constraint </replaceable></term>
<listitem>
<para>
New domain constraint for the domain.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="PARAMETER"> constraint_name </replaceable></term>
<listitem>
<para>
Name of an existing constraint to drop.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>CASCADE</term>
<listitem>
<para>
Automatically drop objects that depend on the constraint.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RESTRICT</term>
<listitem>
<para>
Refuse to drop the constraint if there are any dependent
objects. This is the default behavior.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="PARAMETER">new_owner</replaceable></term>
<listitem>
<para>
The user name of the new owner of the domain.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect2>
<refsect2 id="R2-SQL-ALTERDOMAIN-2">
<refsect2info>
<date>1998-04-15</date>
</refsect2info>
<title>
Outputs
</title>
<para>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER DOMAIN</computeroutput></term>
<listitem>
<para>
Message returned from domain alteration.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>ERROR</computeroutput></term>
<listitem>
<para>
Message returned if domain is not available.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect2>
</refsynopsisdiv> </refsynopsisdiv>
<refsect1 id="R1-SQL-ALTERDOMAIN-1"> <refsect1>
<refsect1info> <title>Description</title>
<date>2002-11-27</date>
</refsect1info>
<title>
Description
</title>
<para> <para>
<command>ALTER DOMAIN</command> changes the definition of an existing domain. <command>ALTER DOMAIN</command> changes the definition of an existing domain.
There are several sub-forms: There are several sub-forms:
...@@ -213,10 +105,74 @@ ALTER DOMAIN <replaceable class="PARAMETER">domain</replaceable> ...@@ -213,10 +105,74 @@ ALTER DOMAIN <replaceable class="PARAMETER">domain</replaceable>
</para> </para>
</refsect1> </refsect1>
<refsect1 id="R1-SQL-ALTERDOMAIN-2"> <refsect1>
<title> <title>Parameters</title>
Usage
</title> <para>
<variablelist>
<varlistentry>
<term><replaceable class="PARAMETER"> domain </replaceable></term>
<listitem>
<para>
The name (possibly schema-qualified) of an existing domain to
alter.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="PARAMETER"> domain_constraint </replaceable></term>
<listitem>
<para>
New domain constraint for the domain.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="PARAMETER"> constraint_name </replaceable></term>
<listitem>
<para>
Name of an existing constraint to drop.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>CASCADE</term>
<listitem>
<para>
Automatically drop objects that depend on the constraint.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>RESTRICT</term>
<listitem>
<para>
Refuse to drop the constraint if there are any dependent
objects. This is the default behavior.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="PARAMETER">new_owner</replaceable></term>
<listitem>
<para>
The user name of the new owner of the domain.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1>
<title>Examples</title>
<para> <para>
To add a NOT NULL constraint to a domain: To add a NOT NULL constraint to a domain:
<programlisting> <programlisting>
...@@ -243,6 +199,15 @@ ALTER DOMAIN zipcode DROP CONSTRAINT zipchk; ...@@ -243,6 +199,15 @@ ALTER DOMAIN zipcode DROP CONSTRAINT zipchk;
</para> </para>
</refsect1> </refsect1>
<refsect1>
<title>Compatibility</title>
<para>
The <command>ALTER DOMAIN</command> statement is compatible with SQL99,
except for the <literal>OWNER</> variant, which is a
<productname>PostgreSQL</productname> extension.
</para>
</refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
......
doc/src/sgml/ref/alter_function.sgml
+ 1
− 16
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_function.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_function.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -65,21 +65,6 @@ ALTER FUNCTION <replaceable>name</replaceable> ( [ <replaceable class="parameter ...@@ -65,21 +65,6 @@ ALTER FUNCTION <replaceable>name</replaceable> ( [ <replaceable class="parameter
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER FUNCTION</computeroutput></term>
<listitem>
<para>
Message returned if the command was successful.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Examples</title> <title>Examples</title>
......
doc/src/sgml/ref/alter_group.sgml
+ 1
− 16
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_group.sgml,v 1.11 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_group.sgml,v 1.12 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -78,21 +78,6 @@ ALTER GROUP <replaceable class="PARAMETER">groupname</replaceable> RENAME TO <re ...@@ -78,21 +78,6 @@ ALTER GROUP <replaceable class="PARAMETER">groupname</replaceable> RENAME TO <re
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER GROUP</computeroutput></term>
<listitem>
<para>
Message returned if the alteration was successful.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Examples</title> <title>Examples</title>
<para> <para>
......
doc/src/sgml/ref/alter_language.sgml
+ 1
− 16
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_language.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_language.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -58,21 +58,6 @@ ALTER LANGUAGE <replaceable>name</replaceable> RENAME TO <replaceable>newname</r ...@@ -58,21 +58,6 @@ ALTER LANGUAGE <replaceable>name</replaceable> RENAME TO <replaceable>newname</r
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER LANGUAGE</computeroutput></term>
<listitem>
<para>
Message returned if the alteration was successful.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Compatibility</title> <title>Compatibility</title>
......
doc/src/sgml/ref/alter_opclass.sgml
+ 1
− 16
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_opclass.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_opclass.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -67,21 +67,6 @@ ALTER OPERATOR CLASS <replaceable>name</replaceable> USING <replaceable class="p ...@@ -67,21 +67,6 @@ ALTER OPERATOR CLASS <replaceable>name</replaceable> USING <replaceable class="p
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER OPERATOR CLASS</computeroutput></term>
<listitem>
<para>
Message returned if the command was successful.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Compatibility</title> <title>Compatibility</title>
......
doc/src/sgml/ref/alter_schema.sgml
+ 1
− 16
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_schema.sgml,v 1.2 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_schema.sgml,v 1.3 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -59,21 +59,6 @@ ALTER SCHEMA <replaceable>name</replaceable> RENAME TO <replaceable>newname</rep ...@@ -59,21 +59,6 @@ ALTER SCHEMA <replaceable>name</replaceable> RENAME TO <replaceable>newname</rep
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER SCHEMA</computeroutput></term>
<listitem>
<para>
Message returned if the alteration was successful.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Compatibility</title> <title>Compatibility</title>
......
doc/src/sgml/ref/alter_sequence.sgml
+ 35
− 103
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.3 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.4 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -23,24 +23,27 @@ PostgreSQL documentation ...@@ -23,24 +23,27 @@ PostgreSQL documentation
</indexterm> </indexterm>
<refsynopsisdiv> <refsynopsisdiv>
<refsynopsisdivinfo>
<date>1999-07-20</date>
</refsynopsisdivinfo>
<synopsis> <synopsis>
ALTER SEQUENCE <replaceable class="parameter">seqname</replaceable> [ INCREMENT [ BY ] <replaceable class="parameter">increment</replaceable> ] ALTER SEQUENCE <replaceable class="parameter">seqname</replaceable> [ INCREMENT [ BY ] <replaceable class="parameter">increment</replaceable> ]
[ MINVALUE <replaceable class="parameter">minvalue</replaceable> | NO MINVALUE ] [ MAXVALUE <replaceable class="parameter">maxvalue</replaceable> | NO MAXVALUE ] [ MINVALUE <replaceable class="parameter">minvalue</replaceable> | NO MINVALUE ] [ MAXVALUE <replaceable class="parameter">maxvalue</replaceable> | NO MAXVALUE ]
[ RESTART [ WITH ] <replaceable class="parameter">start</replaceable> ] [ CACHE <replaceable class="parameter">cache</replaceable> ] [ [ NO ] CYCLE ] [ RESTART [ WITH ] <replaceable class="parameter">start</replaceable> ] [ CACHE <replaceable class="parameter">cache</replaceable> ] [ [ NO ] CYCLE ]
</synopsis> </synopsis>
</refsynopsisdiv>
<refsect2 id="R2-SQL-ALTERSEQUENCE-1">
<refsect2info>
<date>1998-09-11</date>
</refsect2info>
<title>
Inputs
</title>
<para>
<refsect1>
<title>Description</title>
<para>
<command>ALTER SEQUENCE</command> changes the parameters of an existing
sequence generator. Any parameter not specifically set in the
<command>ALTER SEQUENCE</command> command retains its prior setting.
</para>
</refsect1>
<refsect1>
<title>Parameters</title>
<para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">seqname</replaceable></term> <term><replaceable class="parameter">seqname</replaceable></term>
...@@ -100,8 +103,8 @@ ALTER SEQUENCE <replaceable class="parameter">seqname</replaceable> [ INCREMENT ...@@ -100,8 +103,8 @@ ALTER SEQUENCE <replaceable class="parameter">seqname</replaceable> [ INCREMENT
<listitem> <listitem>
<para> <para>
The optional <option>RESTART WITH The optional <option>RESTART WITH
<replaceable class="parameter">start</replaceable> <replaceable class="parameter">start</replaceable></option>
clause</option> enables the sequence to re-begin anywhere. clause changes the current value of the sequence.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -151,78 +154,11 @@ ALTER SEQUENCE <replaceable class="parameter">seqname</replaceable> [ INCREMENT ...@@ -151,78 +154,11 @@ ALTER SEQUENCE <replaceable class="parameter">seqname</replaceable> [ INCREMENT
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
</refsect2> </refsect1>
<refsect2 id="R2-SQL-ALTERSEQUENCE-2">
<refsect2info>
<date>1998-09-11</date>
</refsect2info>
<title>
Outputs
</title>
<para>
<variablelist>
<varlistentry>
<term><computeroutput>
ALTER SEQUENCE
</computeroutput></term>
<listitem>
<para>
Message returned if the command is successful.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>
ERROR: AlterSequence: MINVALUE (<replaceable class="parameter">start</replaceable>) can't be >= MAXVALUE (<replaceable class="parameter">max</replaceable>)
</computeroutput></term>
<listitem>
<para>
If the specified starting value is out of range.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>
ERROR: AlterSequence: START value (<replaceable class="parameter">start</replaceable>) can't be < MINVALUE (<replaceable class="parameter">min</replaceable>)
</computeroutput></term>
<listitem>
<para>
If the specified starting value is out of range.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>
ERROR: AlterSequence: MINVALUE (<replaceable class="parameter">min</replaceable>) can't be >= MAXVALUE (<replaceable class="parameter">max</replaceable>)
</computeroutput></term>
<listitem>
<para>
If the minimum and maximum values are inconsistent.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect2>
</refsynopsisdiv>
<refsect1 id="R1-SQL-ALTERSEQUENCE-1"> <refsect1>
<title> <title>Examples</title>
Description
</title>
<para>
See <xref linkend="SQL-CREATESEQUENCE"> for limitations, and uses
of sequences.
</para>
</refsect1>
<refsect1 id="R1-SQL-ALTERSEQUENCE-2">
<title>
Usage
</title>
<para> <para>
Restart a sequence called <literal>serial</literal>, at 105: Restart a sequence called <literal>serial</literal>, at 105:
</para> </para>
...@@ -231,35 +167,31 @@ ALTER SEQUENCE serial RESTART WITH 105; ...@@ -231,35 +167,31 @@ ALTER SEQUENCE serial RESTART WITH 105;
</programlisting> </programlisting>
</refsect1> </refsect1>
<refsect1 id="R1-SQL-ALTERSEQUENCE-5"> <refsect1>
<title> <title>Notes</title>
Notes
</title>
<para> <para>
To avoid blocking of concurrent transactions that obtain numbers from the same To avoid blocking of concurrent transactions that obtain numbers from the
sequence, a nextval operation is never rolled back; that is, once a value has same sequence, <command>ALTER SEQUENCE</command> is never rolled back;
been fetched it is considered used, even if the transaction that did the nextval the changes take effect immediately and are not reversible.
later aborts. This means that aborted transactions may leave unused "holes" in
the sequence of assigned values. setval operations are never rolled back, either.
</para> </para>
<para> <para>
<command>ALTER SEQUENCE</command> will not immediately affect backends, other than the <command>ALTER SEQUENCE</command> will not immediately affect
current one, which have cached sequence values. They must use up all cached values <literal>nextval</> results in backends,
prior to noticing the changed sequence parameters. The current backend will be other than the current one, that have preallocated (cached) sequence
immediatly affected. values. They will use up all cached values prior to noticing the changed
sequence parameters. The current backend will be affected immediately.
</para> </para>
</refsect1> </refsect1>
<refsect1 id="R1-SQL-ALTERSEQUENCE-3"> <refsect1>
<title> <title>
Compatibility Compatibility
</title> </title>
<refsect2 id="R2-SQL-ALTERSEQUENCE-4"> <refsect2>
<refsect2info>
<date>2003-03-02</date>
</refsect2info>
<title> <title>
SQL99 SQL99
</title> </title>
......
doc/src/sgml/ref/alter_table.sgml
+ 1
− 25
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.60 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.61 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -331,30 +331,6 @@ ALTER TABLE <replaceable class="PARAMETER">table</replaceable> ...@@ -331,30 +331,6 @@ ALTER TABLE <replaceable class="PARAMETER">table</replaceable>
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER TABLE</computeroutput></term>
<listitem>
<para>
Message returned if successful.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>ERROR</computeroutput></term>
<listitem>
<para>
Message returned if table or column does not exist.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Notes</title> <title>Notes</title>
......
doc/src/sgml/ref/alter_trigger.sgml
+ 2
− 27
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_trigger.sgml,v 1.5 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_trigger.sgml,v 1.6 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -41,7 +41,7 @@ ALTER TRIGGER <replaceable class="PARAMETER">trigger</replaceable> ON <replaceab ...@@ -41,7 +41,7 @@ ALTER TRIGGER <replaceable class="PARAMETER">trigger</replaceable> ON <replaceab
</refsect1> </refsect1>
<refsect1> <refsect1>
<title>Parameter</title> <title>Parameters</title>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
...@@ -73,31 +73,6 @@ ALTER TRIGGER <replaceable class="PARAMETER">trigger</replaceable> ON <replaceab ...@@ -73,31 +73,6 @@ ALTER TRIGGER <replaceable class="PARAMETER">trigger</replaceable> ON <replaceab
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER TRIGGER</computeroutput></term>
<listitem>
<para>
Message returned if successful.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>ERROR</computeroutput></term>
<listitem>
<para>
If the trigger does not exist, or the new name is a duplicate of
another existing trigger on the table.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Examples</title> <title>Examples</title>
......
doc/src/sgml/ref/alter_user.sgml
+ 1
− 26
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.29 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.30 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -175,31 +175,6 @@ ALTER USER <replaceable class="PARAMETER">username</replaceable> RESET <replacea ...@@ -175,31 +175,6 @@ ALTER USER <replaceable class="PARAMETER">username</replaceable> RESET <replacea
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ALTER USER</computeroutput></term>
<listitem>
<para>
Message returned if the alteration was successful.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>ERROR: ALTER USER: user "username" does not exist</computeroutput></term>
<listitem>
<para>
Error message returned if the specified user is not known to
the database system.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Notes</title> <title>Notes</title>
......
doc/src/sgml/ref/analyze.sgml
+ 1
− 16
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/analyze.sgml,v 1.13 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/analyze.sgml,v 1.14 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -77,21 +77,6 @@ ANALYZE [ VERBOSE ] [ <replaceable class="PARAMETER">table</replaceable> [ (<rep ...@@ -77,21 +77,6 @@ ANALYZE [ VERBOSE ] [ <replaceable class="PARAMETER">table</replaceable> [ (<rep
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>ANALYZE</computeroutput></term>
<listitem>
<para>
The command is complete.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Notes</title> <title>Notes</title>
......
doc/src/sgml/ref/begin.sgml
+ 29
− 36
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/begin.sgml,v 1.25 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/begin.sgml,v 1.26 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -28,21 +28,25 @@ BEGIN [ WORK | TRANSACTION ] ...@@ -28,21 +28,25 @@ BEGIN [ WORK | TRANSACTION ]
<title>Description</title> <title>Description</title>
<para> <para>
By default, <productname>PostgreSQL</productname> executes
transactions in <quote>autocommit</quote> mode, that is, each
statement is executed in its own transaction and a commit is
implicitly performed at the end of the statement (if execution was
successful, otherwise a rollback is done).
<command>BEGIN</command> initiates a transaction block, that is, <command>BEGIN</command> initiates a transaction block, that is,
all statements after <command>BEGIN</command> command will be all statements after <command>BEGIN</command> command will be
executed in a single transaction until an explicit <xref executed in a single transaction until an explicit <xref
linkend="sql-commit" endterm="sql-commit-title"> or <xref linkend="sql-commit" endterm="sql-commit-title"> or <xref
linkend="sql-rollback" endterm="sql-rollback-title">. Statements linkend="sql-rollback" endterm="sql-rollback-title"> is given.
are executed more quickly in a transaction block, because By default (without <command>BEGIN</command>),
<productname>PostgreSQL</productname> executes
transactions in <quote>autocommit</quote> mode, that is, each
statement is executed in its own transaction and a commit is
implicitly performed at the end of the statement (if execution was
successful, otherwise a rollback is done).
</para>
<para>
Statements are executed more quickly in a transaction block, because
transaction start/commit requires significant CPU and disk transaction start/commit requires significant CPU and disk
activity. Execution of multiple statements inside a transaction is activity. Execution of multiple statements inside a transaction is
also useful to ensure consistency when changing several related also useful to ensure consistency when making several related changes:
tables: other sessions will be unable to see the intermediate states other sessions will be unable to see the intermediate states
wherein not all the related updates have been done. wherein not all the related updates have been done.
</para> </para>
</refsect1> </refsect1>
...@@ -63,31 +67,6 @@ BEGIN [ WORK | TRANSACTION ] ...@@ -63,31 +67,6 @@ BEGIN [ WORK | TRANSACTION ]
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>BEGIN</computeroutput></term>
<listitem>
<para>
This signifies that a new transaction has been started.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>WARNING: BEGIN: already a transaction in progress</computeroutput></term>
<listitem>
<para>
This indicates that a transaction was already in progress. The
current transaction is not affected.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Notes</title> <title>Notes</title>
...@@ -100,7 +79,12 @@ BEGIN [ WORK | TRANSACTION ] ...@@ -100,7 +79,12 @@ BEGIN [ WORK | TRANSACTION ]
<para> <para>
Use <xref linkend="SQL-COMMIT" endterm="SQL-COMMIT-TITLE"> or Use <xref linkend="SQL-COMMIT" endterm="SQL-COMMIT-TITLE"> or
<xref linkend="SQL-ROLLBACK" endterm="SQL-ROLLBACK-TITLE"> <xref linkend="SQL-ROLLBACK" endterm="SQL-ROLLBACK-TITLE">
to terminate a transaction. to terminate a transaction block.
</para>
<para>
Issuing <command>BEGIN</> when already inside a transaction block will
provoke a warning message. The state of the transaction is not affected.
</para> </para>
</refsect1> </refsect1>
...@@ -138,6 +122,15 @@ BEGIN; ...@@ -138,6 +122,15 @@ BEGIN;
about the transaction semantics when porting database applications. about the transaction semantics when porting database applications.
</para> </para>
</refsect1> </refsect1>
<refsect1>
<title>See Also</title>
<simplelist type="inline">
<member><xref linkend="sql-commit" endterm="sql-commit-title"></member>
<member><xref linkend="sql-rollback" endterm="sql-rollback-title"></member>
</simplelist>
</refsect1>
</refentry> </refentry>
<!-- Keep this comment at the end of the file <!-- Keep this comment at the end of the file
......
doc/src/sgml/ref/close.sgml
+ 5
− 30
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/close.sgml,v 1.17 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/close.sgml,v 1.18 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -37,9 +37,10 @@ CLOSE <replaceable class="PARAMETER">cursor</replaceable> ...@@ -37,9 +37,10 @@ CLOSE <replaceable class="PARAMETER">cursor</replaceable>
<para> <para>
Every non-holdable open cursor is implicitly closed when a Every non-holdable open cursor is implicitly closed when a
transaction is terminated by <command>COMMIT</command> or transaction is terminated by <command>COMMIT</command> or
<command>ROLLBACK</command>. Holdable cursors are implicitely <command>ROLLBACK</command>. A holdable cursor is implicitly
closed if the transaction that created them aborts via closed if the transaction that created it aborts via
<command>ROLLBACK</command>; if this does not happen, the holdable <command>ROLLBACK</command>. If the creating transaction successfully
commits, the holdable
cursor remains open until an explicit <command>CLOSE</command> is cursor remains open until an explicit <command>CLOSE</command> is
executed, or the client disconnects. executed, or the client disconnects.
</para> </para>
...@@ -59,32 +60,6 @@ CLOSE <replaceable class="PARAMETER">cursor</replaceable> ...@@ -59,32 +60,6 @@ CLOSE <replaceable class="PARAMETER">cursor</replaceable>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>CLOSE CURSOR</computeroutput></term>
<listitem>
<para>
Message returned if the cursor is successfully closed.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>ERROR: cursor "<replaceable class="PARAMETER">cursor</replaceable>" does not exist</computeroutput></term>
<listitem>
<para>
Message returned if <replaceable
class="PARAMETER">cursor</replaceable> is not declared or has
already been closed.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Notes</title> <title>Notes</title>
......
doc/src/sgml/ref/cluster.sgml
+ 1
− 16
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/cluster.sgml,v 1.27 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/cluster.sgml,v 1.28 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -97,21 +97,6 @@ CLUSTER ...@@ -97,21 +97,6 @@ CLUSTER
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>CLUSTER</computeroutput></term>
<listitem>
<para>
The clustering was done successfully.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Notes</title> <title>Notes</title>
......
doc/src/sgml/ref/clusterdb.sgml
+ 7
− 32
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/clusterdb.sgml,v 1.12 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/clusterdb.sgml,v 1.13 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -54,6 +54,12 @@ PostgreSQL documentation ...@@ -54,6 +54,12 @@ PostgreSQL documentation
library will apply. library will apply.
</para> </para>
<para>
In case of difficulty, see <xref linkend="SQL-CLUSTER"
endterm="sql-cluster-title"> and <xref linkend="APP-PSQL"> for
discussions of potential problems and error messages.
</para>
</refsect1> </refsect1>
...@@ -176,37 +182,6 @@ PostgreSQL documentation ...@@ -176,37 +182,6 @@ PostgreSQL documentation
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<para>
<variablelist>
<varlistentry>
<term><computeroutput>CLUSTER</computeroutput></term>
<listitem>
<para>
The database was successfully clustered.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><computeroutput>clusterdb: Cluster failed.</computeroutput></term>
<listitem>
<para>
Something went wrong. <application>clusterdb</application> is only a wrapper
script. See <xref linkend="SQL-CLUSTER" endterm="sql-cluster-title">
and <xref linkend="APP-PSQL"> for a detailed
discussion of error messages and potential problems.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1> <refsect1>
<title>Environment</title> <title>Environment</title>
......
doc/src/sgml/ref/comment.sgml
+ 1
− 16
View file @ d4019b7c
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/comment.sgml,v 1.22 2003/08/31 17:32:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/comment.sgml,v 1.23 2003/09/09 18:28:52 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
...@@ -96,21 +96,6 @@ COMMENT ON ...@@ -96,21 +96,6 @@ COMMENT ON
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1>
<title>Diagnostics</title>
<variablelist>
<varlistentry>
<term><computeroutput>COMMENT</computeroutput></term>
<listitem>
<para>
Message returned if the comment was successfully changed.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1> <refsect1>
<title>Notes</title> <title>Notes</title>
......
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