From 3d83e28b2b3c1fda477256a21e153c99c5611bbd Mon Sep 17 00:00:00 2001 From: "Thomas G. Lockhart" <lockhart@fourpalms.org> Date: Fri, 30 Oct 1998 19:34:40 +0000 Subject: [PATCH] Minor cleanup in markup, especially in the Output section. --- doc/src/sgml/ref/alter_table.sgml | 15 +------ doc/src/sgml/ref/alter_user.sgml | 16 +------- doc/src/sgml/ref/begin.sgml | 17 +------- doc/src/sgml/ref/close.sgml | 17 +------- doc/src/sgml/ref/cluster.sgml | 12 +----- doc/src/sgml/ref/commands.sgml | 6 +++ doc/src/sgml/ref/commit.sgml | 15 +------ doc/src/sgml/ref/copy.sgml | 15 +------ doc/src/sgml/ref/create_aggregate.sgml | 15 +------ doc/src/sgml/ref/create_database.sgml | 18 ++------- doc/src/sgml/ref/create_function.sgml | 15 +------ doc/src/sgml/ref/create_index.sgml | 14 +------ doc/src/sgml/ref/create_language.sgml | 14 ------- doc/src/sgml/ref/create_operator.sgml | 19 ++------- doc/src/sgml/ref/create_rule.sgml | 16 ++------ doc/src/sgml/ref/create_sequence.sgml | 16 +------- doc/src/sgml/ref/create_table.sgml | 20 ++------- doc/src/sgml/ref/create_trigger.sgml | 15 +------ doc/src/sgml/ref/create_type.sgml | 25 +++--------- doc/src/sgml/ref/create_user.sgml | 12 ------ doc/src/sgml/ref/create_view.sgml | 15 +------ doc/src/sgml/ref/createdb.sgml | 2 + doc/src/sgml/ref/createuser.sgml | 2 +- doc/src/sgml/ref/current_date.sgml | 41 +++---------------- doc/src/sgml/ref/current_time.sgml | 43 +++----------------- doc/src/sgml/ref/current_timestamp.sgml | 44 ++++---------------- doc/src/sgml/ref/current_user.sgml | 43 ++++---------------- doc/src/sgml/ref/declare.sgml | 1 - doc/src/sgml/ref/delete.sgml | 15 +------ doc/src/sgml/ref/destroyuser.sgml | 2 +- doc/src/sgml/ref/drop_aggregate.sgml | 15 +------ doc/src/sgml/ref/drop_database.sgml | 16 +------- doc/src/sgml/ref/drop_function.sgml | 16 +------- doc/src/sgml/ref/drop_index.sgml | 15 +------ doc/src/sgml/ref/drop_language.sgml | 15 +------ doc/src/sgml/ref/drop_operator.sgml | 16 +------- doc/src/sgml/ref/drop_rule.sgml | 14 ------- doc/src/sgml/ref/drop_sequence.sgml | 15 +------ doc/src/sgml/ref/drop_table.sgml | 14 ------- doc/src/sgml/ref/drop_trigger.sgml | 20 ++------- doc/src/sgml/ref/drop_type.sgml | 15 +------ doc/src/sgml/ref/drop_user.sgml | 13 +----- doc/src/sgml/ref/drop_view.sgml | 54 +++++++++---------------- doc/src/sgml/ref/explain.sgml | 8 ---- doc/src/sgml/ref/fetch.sgml | 3 +- doc/src/sgml/ref/grant.sgml | 37 +++++++++-------- doc/src/sgml/ref/initdb.sgml | 5 ++- doc/src/sgml/ref/insert.sgml | 9 +---- doc/src/sgml/ref/listen.sgml | 12 ------ doc/src/sgml/ref/load.sgml | 9 ----- doc/src/sgml/ref/lock.sgml | 9 ----- doc/src/sgml/ref/notify.sgml | 15 +------ doc/src/sgml/ref/pg_dump.sgml | 4 +- doc/src/sgml/ref/psql-ref.sgml | 12 ++++-- doc/src/sgml/ref/reset.sgml | 9 ----- doc/src/sgml/ref/revoke.sgml | 36 ++++++++--------- doc/src/sgml/ref/select.sgml | 22 +++------- doc/src/sgml/ref/set.sgml | 11 +---- doc/src/sgml/ref/show.sgml | 9 ----- doc/src/sgml/ref/unlisten.sgml | 16 +------- doc/src/sgml/ref/update.sgml | 2 +- 61 files changed, 168 insertions(+), 818 deletions(-) diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml index fe898b0dbe1..c2fb66e6a9a 100644 --- a/doc/src/sgml/ref/alter_table.sgml +++ b/doc/src/sgml/ref/alter_table.sgml @@ -100,13 +100,7 @@ Inputs Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -137,12 +131,7 @@ Outputs <LISTITEM> <PARA> Message returned if table or column is not available. -</PARA> -</LISTITEM> -</VARLISTENTRY> -</VARIABLELIST> -</LISTITEM> -</VARLISTENTRY> + </VARIABLELIST> </REFSECT2> diff --git a/doc/src/sgml/ref/alter_user.sgml b/doc/src/sgml/ref/alter_user.sgml index 674fdcff99b..95a72ce2e46 100644 --- a/doc/src/sgml/ref/alter_user.sgml +++ b/doc/src/sgml/ref/alter_user.sgml @@ -92,14 +92,6 @@ ALTER USER <replaceable class="PARAMETER">username</replaceable> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -120,13 +112,7 @@ ALTER USER <replaceable class="PARAMETER">username</replaceable> <PARA> Error message returned if the user specified doesn't exist. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> - </para> - </listitem> - </varlistentry> + </variablelist> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/begin.sgml b/doc/src/sgml/ref/begin.sgml index 279ed6db3aa..ab8a0fea2df 100644 --- a/doc/src/sgml/ref/begin.sgml +++ b/doc/src/sgml/ref/begin.sgml @@ -41,14 +41,7 @@ BEGIN [ WORK | TRANSACTION ] Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -68,13 +61,7 @@ BEGIN [ WORK | TRANSACTION ] <PARA> This indicates that a transaction was already in progress. The current transaction is not affected. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </para> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/close.sgml b/doc/src/sgml/ref/close.sgml index 4c8c3f2032f..fb9a9598847 100644 --- a/doc/src/sgml/ref/close.sgml +++ b/doc/src/sgml/ref/close.sgml @@ -51,16 +51,6 @@ CLOSE <REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <replaceable> - status - </replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -81,12 +71,7 @@ CLOSE <REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE> This warning is given if <REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE> is not declared or has already been closed. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> diff --git a/doc/src/sgml/ref/cluster.sgml b/doc/src/sgml/ref/cluster.sgml index b195cb4dc35..050fee754eb 100644 --- a/doc/src/sgml/ref/cluster.sgml +++ b/doc/src/sgml/ref/cluster.sgml @@ -62,14 +62,6 @@ CLUSTER <REPLACEABLE CLASS="PARAMETER">indexname</REPLACEABLE> ON <REPLACEABLE C Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -109,9 +101,7 @@ CLUSTER <REPLACEABLE CLASS="PARAMETER">indexname</REPLACEABLE> ON <REPLACEABLE C </PARA> </LISTITEM> </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> diff --git a/doc/src/sgml/ref/commands.sgml b/doc/src/sgml/ref/commands.sgml index 812bfeb9153..18830352a16 100644 --- a/doc/src/sgml/ref/commands.sgml +++ b/doc/src/sgml/ref/commands.sgml @@ -63,6 +63,10 @@ commands supported by <productname>Postgres</productname>. </Chapter> +<!-- +Disable this chapter until we have more functions documented. +- thomas 1998-10-27 + <chapter Id="sql-functions"> <title>SQL Functions</title> @@ -78,6 +82,8 @@ functions supported by <productname>Postgres</productname>. </chapter> +--> + <chapter Id="utilities"> <title>Utility Applications</title> diff --git a/doc/src/sgml/ref/commit.sgml b/doc/src/sgml/ref/commit.sgml index 0ffc07effec..689220993a7 100644 --- a/doc/src/sgml/ref/commit.sgml +++ b/doc/src/sgml/ref/commit.sgml @@ -42,13 +42,7 @@ None Outputs </TITLE> <PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -67,12 +61,7 @@ Message returned if the transaction is successfully committed. <LISTITEM> <PARA> If there is no transaction in progress. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/copy.sgml b/doc/src/sgml/ref/copy.sgml index 174fd260782..77e652849ee 100644 --- a/doc/src/sgml/ref/copy.sgml +++ b/doc/src/sgml/ref/copy.sgml @@ -116,13 +116,7 @@ Specifies that output goes to a pipe or terminal. Outputs </TITLE> <PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <Replaceable>status</Replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -141,12 +135,7 @@ Specifies that output goes to a pipe or terminal. <LISTITEM> <PARA> The copy failed for the reason stated in the error message. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/create_aggregate.sgml b/doc/src/sgml/ref/create_aggregate.sgml index a5b04daa269..273d6087a92 100644 --- a/doc/src/sgml/ref/create_aggregate.sgml +++ b/doc/src/sgml/ref/create_aggregate.sgml @@ -163,14 +163,7 @@ The initial value for the second transition function argument. Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -179,12 +172,6 @@ The initial value for the second transition function argument. <LISTITEM> <PARA> Message returned if the command completes successfully. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> - </LISTITEM> - </VARLISTENTRY> </VARIABLELIST> </REFSECT2> diff --git a/doc/src/sgml/ref/create_database.sgml b/doc/src/sgml/ref/create_database.sgml index c6fff50184d..77a1a8d2e02 100644 --- a/doc/src/sgml/ref/create_database.sgml +++ b/doc/src/sgml/ref/create_database.sgml @@ -65,14 +65,7 @@ CREATE DATABASE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> [ WITH LOCATIO Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -102,13 +95,8 @@ CREATE DATABASE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> [ WITH LOCATIO <LISTITEM> <PARA> There was a problem with creating the required directory; this operation will - need permissions for the <literal>postgres</literal> user on the specified location. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> +need permissions for the <literal>postgres</literal> user on the specified location. + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/create_function.sgml b/doc/src/sgml/ref/create_function.sgml index 96cce89bd9a..e639845a7c5 100644 --- a/doc/src/sgml/ref/create_function.sgml +++ b/doc/src/sgml/ref/create_function.sgml @@ -100,14 +100,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -116,12 +109,6 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab <LISTITEM> <PARA> This is returned if the command completes successfully. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml index c77226039f3..b5523611566 100644 --- a/doc/src/sgml/ref/create_index.sgml +++ b/doc/src/sgml/ref/create_index.sgml @@ -165,13 +165,6 @@ SELECT am.amname AS acc_name, </TITLE> <PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -191,12 +184,7 @@ SELECT am.amname AS acc_name, <LISTITEM> <PARA> This error occurs if it is impossible to create the index. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> diff --git a/doc/src/sgml/ref/create_language.sgml b/doc/src/sgml/ref/create_language.sgml index 5b2bbaa5a45..7554f7dcae2 100644 --- a/doc/src/sgml/ref/create_language.sgml +++ b/doc/src/sgml/ref/create_language.sgml @@ -104,14 +104,6 @@ superuser privilege can use Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -133,12 +125,6 @@ superuser privilege can use This error is returned if the function <replaceable class="parameter">funcname</replaceable>() is not found. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/create_operator.sgml b/doc/src/sgml/ref/create_operator.sgml index 5322927fac0..5cb21cda5cc 100644 --- a/doc/src/sgml/ref/create_operator.sgml +++ b/doc/src/sgml/ref/create_operator.sgml @@ -18,8 +18,8 @@ <DATE>1998-09-09</DATE> </REFSYNOPSISDIVINFO> <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> [, LEFTARG = <replaceable class="parameter">type1</replaceable> ] [, RIGHTARG = <replaceable class="parameter">type2</replaceable> ] [, COMMUTATOR = <replaceable class="parameter">com_op</replaceable> ] @@ -155,14 +155,6 @@ Operator to use for sorting. Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -171,12 +163,7 @@ Operator to use for sorting. <LISTITEM> <PARA> Message returned if the operator is successfully created. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/create_rule.sgml b/doc/src/sgml/ref/create_rule.sgml index 67215937c2b..132eddf1513 100644 --- a/doc/src/sgml/ref/create_rule.sgml +++ b/doc/src/sgml/ref/create_rule.sgml @@ -102,14 +102,6 @@ CREATE RULE <replaceable class="parameter">name</replaceable> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -118,11 +110,7 @@ CREATE RULE <replaceable class="parameter">name</replaceable> <LISTITEM> <PARA> Message returned if the rule is successfully created. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> + </VARLISTENTRY> </VARIABLELIST> @@ -204,6 +192,7 @@ Without of the following two rule definitions are accepted by <productname>Postgres</productname>, the retrieve command will cause <productname>Postgres</productname> to crash: + <example> <title>Example of a circular rewrite rule combination.</title> <programlisting> @@ -222,6 +211,7 @@ create rule bad_rule_combination_2 is select * from EMP </programlisting></para> </example> + </para> <para> You must have rule definition access to a class in order diff --git a/doc/src/sgml/ref/create_sequence.sgml b/doc/src/sgml/ref/create_sequence.sgml index 63644c88ff3..e8fb57f3b4f 100644 --- a/doc/src/sgml/ref/create_sequence.sgml +++ b/doc/src/sgml/ref/create_sequence.sgml @@ -148,14 +148,7 @@ CREATE SEQUENCE <replaceable class="parameter">seqname</replaceable> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -204,12 +197,7 @@ CREATE SEQUENCE <replaceable class="parameter">seqname</replaceable> <LISTITEM> <PARA> If the minimum and maximum values are inconsistant. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml index 4affd2cb26c..b0525ff6ed3 100644 --- a/doc/src/sgml/ref/create_table.sgml +++ b/doc/src/sgml/ref/create_table.sgml @@ -163,14 +163,7 @@ requires the <REPLACEABLE CLASS="PARAMETER">column_constraint_clause</REPLACEABL Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <ReturnValue>status</ReturnValue> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -208,14 +201,7 @@ amcreate: "<replaceable class="parameter">table</replaceable>" relation already <PARA> if data type of default value doesn't match the column definition's data type. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> - </PARA> - </LISTITEM> - </VARLISTENTRY> </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> @@ -1675,13 +1661,13 @@ affect a column or a table. <REFENTRY ID="SQL-CREATETABLEAS"> <REFMETA> <REFENTRYTITLE> - CREATE TABLE + CREATE TABLE AS </REFENTRYTITLE> <REFMISCINFO>SQL - Language Statements</REFMISCINFO> </REFMETA> <REFNAMEDIV> <REFNAME> - CREATE TABLE + CREATE TABLE AS </REFNAME> <REFPURPOSE> Creates a new table diff --git a/doc/src/sgml/ref/create_trigger.sgml b/doc/src/sgml/ref/create_trigger.sgml index 891cf209fd8..a871a59cce8 100644 --- a/doc/src/sgml/ref/create_trigger.sgml +++ b/doc/src/sgml/ref/create_trigger.sgml @@ -84,14 +84,6 @@ CREATE TRIGGER <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> { BEFORE | AFTE Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -100,12 +92,7 @@ CREATE TRIGGER <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> { BEFORE | AFTE <LISTITEM> <PARA> This message is returned if the trigger is successfully created. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/create_type.sgml b/doc/src/sgml/ref/create_type.sgml index 71858819cfb..1fd0066c52f 100644 --- a/doc/src/sgml/ref/create_type.sgml +++ b/doc/src/sgml/ref/create_type.sgml @@ -18,12 +18,9 @@ </REFSYNOPSISDIVINFO> <SYNOPSIS> 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> - , INTERNALLENGTH = (<replaceable class="parameter">internallength</replaceable> | VARIABLE) + 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> ] @@ -169,14 +166,7 @@ EXTERNALLENGTH <replaceable class="parameter">externallength</replaceable> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -185,12 +175,7 @@ EXTERNALLENGTH <replaceable class="parameter">externallength</replaceable> <LISTITEM> <PARA> Message returned if the type is successfully created. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> diff --git a/doc/src/sgml/ref/create_user.sgml b/doc/src/sgml/ref/create_user.sgml index 3744d5ea3ae..2f041e83d94 100644 --- a/doc/src/sgml/ref/create_user.sgml +++ b/doc/src/sgml/ref/create_user.sgml @@ -141,13 +141,6 @@ CREATE USER<REPLACEABLE CLASS="PARAMETER"> username</REPLACEABLE> </TITLE> <PARA> </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -169,11 +162,6 @@ CREATE USER<REPLACEABLE CLASS="PARAMETER"> username</REPLACEABLE> </PARA> <comment>I don't understand this and I don't know how to get this error message.</comment> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/create_view.sgml b/doc/src/sgml/ref/create_view.sgml index 07c3d966398..575e7df1531 100644 --- a/doc/src/sgml/ref/create_view.sgml +++ b/doc/src/sgml/ref/create_view.sgml @@ -65,14 +65,6 @@ An SQL query which will provide the columns and rows of the view. Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -112,12 +104,7 @@ An SQL query which will provide the columns and rows of the view. <programlisting> CREATE VIEW vista AS SELECT 'Hello World'::text </programlisting> - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/createdb.sgml b/doc/src/sgml/ref/createdb.sgml index 090f68ccdf0..9f0ce35fd25 100644 --- a/doc/src/sgml/ref/createdb.sgml +++ b/doc/src/sgml/ref/createdb.sgml @@ -208,12 +208,14 @@ Usage <PARA> To create the database <literal>demo</literal> using the postmaster on the local host, port 5432: + <programlisting> createdb demo </programlisting> To create the database <literal>demo</literal> using the postmaster on host eden, port 5000: + <programlisting> createdb -p 5000 -h eden demo </programlisting> diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml index f06b3c025bb..ad51ae5c666 100644 --- a/doc/src/sgml/ref/createuser.sgml +++ b/doc/src/sgml/ref/createuser.sgml @@ -213,7 +213,7 @@ and <envar>PGREALM</envar> environment variables will be passed on to <application>psql</application> -and processed as described in <xref linkend="app-psql" endterm="app-psql">. +and processed as described in <xref linkend="app-psql" endterm="psql-ref">. Once invoked, <application>createuser</application> will ask a series of questions to obtain parameters not specified on diff --git a/doc/src/sgml/ref/current_date.sgml b/doc/src/sgml/ref/current_date.sgml index 9c76ebabfc7..7d0e1ec8817 100644 --- a/doc/src/sgml/ref/current_date.sgml +++ b/doc/src/sgml/ref/current_date.sgml @@ -7,7 +7,7 @@ </REFMETA> <REFNAMEDIV> <REFNAME> - SQL_CURRENT_DATE + CURRENT_DATE </REFNAME> <REFPURPOSE> Returns the current date @@ -28,27 +28,7 @@ Returns the current date Inputs </TITLE> <PARA> - </PARA> -<VARIABLELIST> - <VARLISTENTRY> - <TERM> - </TERM> - <LISTITEM> - <PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <ReturnValue>None</ReturnValue> - </TERM> - <LISTITEM> - <PARA> - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> +None. </REFSECT2> <REFSECT2 ID="R2-SQL-CURRENT-DATE-2"> @@ -59,26 +39,15 @@ Returns the current date Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> - <ReturnValue>Returns "<replaceable class="parameter">today</replaceable>"</ReturnValue> +<replaceable>date</replaceable> + </TERM> <LISTITEM> <PARA> - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + Returns "<replaceable class="parameter">today</replaceable>". </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/current_time.sgml b/doc/src/sgml/ref/current_time.sgml index e6b4f21af63..be03cc0bcda 100644 --- a/doc/src/sgml/ref/current_time.sgml +++ b/doc/src/sgml/ref/current_time.sgml @@ -7,7 +7,7 @@ </REFMETA> <REFNAMEDIV> <REFNAME> - SQL_CURRENT_TIME + CURRENT_TIME </REFNAME> <REFPURPOSE> Returns the current local time @@ -28,27 +28,7 @@ Returns the current local time Inputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - </TERM> - <LISTITEM> - <PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <ReturnValue>None</ReturnValue> - </TERM> - <LISTITEM> - <PARA> - </PARA> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> +None. </REFSECT2> @@ -60,26 +40,15 @@ Returns the current local time Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> - <ReturnValue>Returns "<replaceable class="parameter">now</replaceable>"</ReturnValue> - </TERM> + <replaceable>time</replaceable> + <LISTITEM> <PARA> - </PARA> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> - </LISTITEM> - </VARLISTENTRY> + <ReturnValue>Returns "<replaceable class="parameter">now</replaceable>"</ReturnValue> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/current_timestamp.sgml b/doc/src/sgml/ref/current_timestamp.sgml index ef68c5fe371..35a84807c10 100644 --- a/doc/src/sgml/ref/current_timestamp.sgml +++ b/doc/src/sgml/ref/current_timestamp.sgml @@ -7,7 +7,7 @@ </REFMETA> <REFNAMEDIV> <REFNAME> - SQL_CURRENT_TIMESTAMP + CURRENT_TIMESTAMP </REFNAME> <REFPURPOSE> Returns the current date and time @@ -30,27 +30,8 @@ Inputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - </TERM> - <LISTITEM> - <PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <ReturnValue>None</ReturnValue> - </TERM> - <LISTITEM> - <PARA> - </PARA> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> +None. + </REFSECT2> <REFSECT2 ID="R2-SQL-CURRENT-TIMESTAMP-2"> @@ -61,26 +42,15 @@ Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> - <ReturnValue>Returns "<replaceable class="parameter">today</replaceable>" and "<replaceable class="parameter">now</replaceable>".</ReturnValue> - </TERM> +<replaceable>timestamp</replaceable> + <LISTITEM> <PARA> - </PARA> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> - </LISTITEM> - </VARLISTENTRY> + Returns "<replaceable class="parameter">today</replaceable>" and "<replaceable class="parameter">now</replaceable>". + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/current_user.sgml b/doc/src/sgml/ref/current_user.sgml index c13951dffdc..a70d7682b27 100644 --- a/doc/src/sgml/ref/current_user.sgml +++ b/doc/src/sgml/ref/current_user.sgml @@ -7,7 +7,7 @@ </REFMETA> <REFNAMEDIV> <REFNAME> - SQL_CURRENT_USER + CURRENT_USER </REFNAME> <REFPURPOSE> Returns the current user name @@ -28,27 +28,8 @@ Inputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - </TERM> - <LISTITEM> - <PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <ReturnValue>None</ReturnValue> - </TERM> - <LISTITEM> - <PARA> - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> + +None. </REFSECT2> <REFSECT2 ID="R2-SQL-CURRENT-USER-2"> @@ -59,26 +40,16 @@ Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> - <ReturnValue>The name of the current user.</ReturnValue> + <replaceable>username</replaceable> </TERM> <LISTITEM> <PARA> - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> +The name of the current user. + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/declare.sgml b/doc/src/sgml/ref/declare.sgml index b941815b509..954b3b4af03 100644 --- a/doc/src/sgml/ref/declare.sgml +++ b/doc/src/sgml/ref/declare.sgml @@ -148,7 +148,6 @@ provokes an informational error message. Outputs </TITLE> <PARA> - </PARA> <VARIABLELIST> <VARLISTENTRY> diff --git a/doc/src/sgml/ref/delete.sgml b/doc/src/sgml/ref/delete.sgml index 36c85dcba4b..4a77e02210a 100644 --- a/doc/src/sgml/ref/delete.sgml +++ b/doc/src/sgml/ref/delete.sgml @@ -68,14 +68,6 @@ Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -90,12 +82,7 @@ <PARA> If <replaceable class="parameter">count</replaceable> is 0, no rows were deleted. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/destroyuser.sgml b/doc/src/sgml/ref/destroyuser.sgml index aeda6a560e0..03bce6e14e7 100644 --- a/doc/src/sgml/ref/destroyuser.sgml +++ b/doc/src/sgml/ref/destroyuser.sgml @@ -190,7 +190,7 @@ and <envar>PGREALM</envar> environment variables will be passed on to <application>psql</application> -and processed as described in <xref linkend="app-psql" endterm="app-psql">. +and processed as described in <xref linkend="app-psql" endterm="psql-ref">. <para> Once invoked, <application>destroyuser</application> diff --git a/doc/src/sgml/ref/drop_aggregate.sgml b/doc/src/sgml/ref/drop_aggregate.sgml index b4cdd0a408c..068d69e4924 100644 --- a/doc/src/sgml/ref/drop_aggregate.sgml +++ b/doc/src/sgml/ref/drop_aggregate.sgml @@ -65,14 +65,6 @@ DROP AGGREGATE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> <REPLACEABLE CL Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -92,12 +84,7 @@ DROP AGGREGATE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> <REPLACEABLE CL <PARA> This message occurs if the aggregate function specified does not exist in the database. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_database.sgml b/doc/src/sgml/ref/drop_database.sgml index 5fe7b48ad5b..d9f42906a25 100644 --- a/doc/src/sgml/ref/drop_database.sgml +++ b/doc/src/sgml/ref/drop_database.sgml @@ -51,14 +51,7 @@ DROP DATABASE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -87,12 +80,7 @@ DROP DATABASE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> <LISTITEM> <PARA> This message occurs if the specified database does not exist. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_function.sgml b/doc/src/sgml/ref/drop_function.sgml index 54f2b42d56f..9a63ac71e10 100644 --- a/doc/src/sgml/ref/drop_function.sgml +++ b/doc/src/sgml/ref/drop_function.sgml @@ -62,14 +62,7 @@ DROP FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceable Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -89,12 +82,7 @@ DROP FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceable <PARA> This message is given if the function specified does not exist in the current database. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_index.sgml b/doc/src/sgml/ref/drop_index.sgml index 05559b57610..8e91465a7b9 100644 --- a/doc/src/sgml/ref/drop_index.sgml +++ b/doc/src/sgml/ref/drop_index.sgml @@ -51,14 +51,6 @@ DROP INDEX <REPLACEABLE CLASS="PARAMETER">index_name</REPLACEABLE> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -78,12 +70,7 @@ DROP INDEX <REPLACEABLE CLASS="PARAMETER">index_name</REPLACEABLE> <PARA> This message occurs if <REPLACEABLE CLASS="PARAMETER">index_name</REPLACEABLE> is not an index in the database. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_language.sgml b/doc/src/sgml/ref/drop_language.sgml index 78a2db5f3b8..4eb3545736f 100644 --- a/doc/src/sgml/ref/drop_language.sgml +++ b/doc/src/sgml/ref/drop_language.sgml @@ -51,14 +51,6 @@ DROP PROCEDURAL LANGUAGE '<REPLACEABLE CLASS="PARAMETER">langname</REPLACEABLE>' Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -80,12 +72,7 @@ DROP PROCEDURAL LANGUAGE '<REPLACEABLE CLASS="PARAMETER">langname</REPLACEABLE>' This message occurs if the language "<replaceable class="parameter">langname</replaceable>" is not found. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_operator.sgml b/doc/src/sgml/ref/drop_operator.sgml index 48e3e60d025..df488aa5f59 100644 --- a/doc/src/sgml/ref/drop_operator.sgml +++ b/doc/src/sgml/ref/drop_operator.sgml @@ -63,14 +63,7 @@ DROP OPERATOR <REPLACEABLE CLASS="PARAMETER">id</REPLACEABLE> ( <REPLACEABLE CLA Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -111,12 +104,7 @@ DROP OPERATOR <REPLACEABLE CLASS="PARAMETER">id</REPLACEABLE> ( <REPLACEABLE CLA <PARA> This message occurs if the specified right unary operator specified does not exist. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_rule.sgml b/doc/src/sgml/ref/drop_rule.sgml index 6b543b4d359..f53bd77994e 100644 --- a/doc/src/sgml/ref/drop_rule.sgml +++ b/doc/src/sgml/ref/drop_rule.sgml @@ -51,14 +51,6 @@ DROP RULE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -77,12 +69,6 @@ DROP RULE <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> <LISTITEM> <PARA> This message occurs if the specified rule does not exist. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_sequence.sgml b/doc/src/sgml/ref/drop_sequence.sgml index 8288ff08d37..ace32b0850c 100644 --- a/doc/src/sgml/ref/drop_sequence.sgml +++ b/doc/src/sgml/ref/drop_sequence.sgml @@ -51,14 +51,7 @@ DROP SEQUENCE <REPLACEABLE CLASS="PARAMETER">seqname</REPLACEABLE> [, ...] Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -77,12 +70,6 @@ DROP SEQUENCE <REPLACEABLE CLASS="PARAMETER">seqname</REPLACEABLE> [, ...] <LISTITEM> <PARA> This message occurs if the specified sequence does not exist. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_table.sgml b/doc/src/sgml/ref/drop_table.sgml index d8fb78f5f0f..80527cf01a3 100644 --- a/doc/src/sgml/ref/drop_table.sgml +++ b/doc/src/sgml/ref/drop_table.sgml @@ -52,14 +52,6 @@ DROP TABLE <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> [, ...] Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -78,12 +70,6 @@ DROP TABLE <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> [, ...] <LISTITEM> <PARA> If the specified table or view does not exist in the database. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_trigger.sgml b/doc/src/sgml/ref/drop_trigger.sgml index c4319a35f46..d2729bda824 100644 --- a/doc/src/sgml/ref/drop_trigger.sgml +++ b/doc/src/sgml/ref/drop_trigger.sgml @@ -61,15 +61,8 @@ DROP TRIGGER <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> ON <REPLACEABLE C Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> - <VARIABLELIST> + +<VARIABLELIST> <VARLISTENTRY> <TERM> <ReturnValue>DROP</ReturnValue> @@ -87,13 +80,8 @@ DROP TRIGGER <REPLACEABLE CLASS="PARAMETER">name</REPLACEABLE> ON <REPLACEABLE C <LISTITEM> <PARA> This message occurs if the trigger specified does not exist. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> + +</VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_type.sgml b/doc/src/sgml/ref/drop_type.sgml index d3a25b0309a..baad378c0db 100644 --- a/doc/src/sgml/ref/drop_type.sgml +++ b/doc/src/sgml/ref/drop_type.sgml @@ -51,14 +51,6 @@ DROP TYPE <REPLACEABLE CLASS="PARAMETER">typename</REPLACEABLE> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -77,12 +69,7 @@ DROP TYPE <REPLACEABLE CLASS="PARAMETER">typename</REPLACEABLE> <LISTITEM> <PARA> This message occurs if the specified type is not found. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_user.sgml b/doc/src/sgml/ref/drop_user.sgml index 1ab89c284b2..3de3deaa193 100644 --- a/doc/src/sgml/ref/drop_user.sgml +++ b/doc/src/sgml/ref/drop_user.sgml @@ -52,14 +52,6 @@ DROP USER <REPLACEABLE CLASS="PARAMETER">username</REPLACEABLE> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -81,10 +73,7 @@ DROP USER <REPLACEABLE CLASS="PARAMETER">username</REPLACEABLE> </PARA> </LISTITEM> </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> - </VARIABLELIST> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/drop_view.sgml b/doc/src/sgml/ref/drop_view.sgml index 90a7bf98a69..e49701815ed 100644 --- a/doc/src/sgml/ref/drop_view.sgml +++ b/doc/src/sgml/ref/drop_view.sgml @@ -51,42 +51,28 @@ DROP VIEW <REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE> Outputs </TITLE> <PARA> - </PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> -<replaceable>status</replaceable> - </TERM> - <LISTITEM> - <PARA> - <VARIABLELIST> - <VARLISTENTRY> - <TERM> - <ReturnValue>DROP</ReturnValue> - </TERM> - <LISTITEM> + +<VARIABLELIST> +<VARLISTENTRY> +<TERM> +<ReturnValue>DROP</ReturnValue> +</TERM> +<LISTITEM> <PARA> The message returned if the command is successful. - </PARA> - </LISTITEM> - </VARLISTENTRY> - <VARLISTENTRY> - <TERM> - <ReturnValue> - ERROR: RewriteGetRuleEventRel: rule "_RET<REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE>" not found</ReturnValue> - </TERM> - <LISTITEM> - <PARA> - This message occurs if the specified view does not exist in - the database. - </PARA> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </LISTITEM> - </VARLISTENTRY> - </variablelist> - </REFSECT2> + +<VARLISTENTRY> +<TERM> +<ReturnValue> +ERROR: RewriteGetRuleEventRel: rule "_RET<REPLACEABLE CLASS="PARAMETER">view</REPLACEABLE>" not found</ReturnValue> +</TERM> +<LISTITEM> +<PARA> +This message occurs if the specified view does not exist in +the database. +</variablelist> + +</REFSECT2> </REFSYNOPSISDIV> <REFSECT1 ID="R1-SQL-DROPVIEW-1"> diff --git a/doc/src/sgml/ref/explain.sgml b/doc/src/sgml/ref/explain.sgml index 9b2d989964d..6ae69d7abc8 100644 --- a/doc/src/sgml/ref/explain.sgml +++ b/doc/src/sgml/ref/explain.sgml @@ -70,13 +70,6 @@ NOTICE: QUERY PLAN: <PARA> Explicit query plan from the <productname>Postgres</productname> backend. -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> <VARLISTENTRY> <TERM> EXPLAIN @@ -85,7 +78,6 @@ EXPLAIN <PARA> Flag sent after query plan is shown. -</VARIABLELIST> </VARIABLELIST> </REFSECT2> diff --git a/doc/src/sgml/ref/fetch.sgml b/doc/src/sgml/ref/fetch.sgml index fe2a3718192..10d5df0c6d7 100644 --- a/doc/src/sgml/ref/fetch.sgml +++ b/doc/src/sgml/ref/fetch.sgml @@ -19,7 +19,8 @@ Gets rows using a cursor <SYNOPSIS> FETCH [ <REPLACEABLE CLASS="PARAMETER">selector</REPLACEABLE> ] [ <REPLACEABLE CLASS="PARAMETER">count</REPLACEABLE> ] { IN | FROM } <REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE> -FETCH [ RELATIVE ] [ { [ <REPLACEABLE CLASS="PARAMETER">#</REPLACEABLE> | ALL | NEXT | PRIOR ] } ] FROM ] <REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE> +FETCH [ RELATIVE ] [ { [ <REPLACEABLE CLASS="PARAMETER">#</REPLACEABLE> | ALL | NEXT | PRIOR ] } ] + FROM ] <REPLACEABLE CLASS="PARAMETER">cursor</REPLACEABLE> </SYNOPSIS> <REFSECT2 ID="R2-SQL-FETCH-1"> diff --git a/doc/src/sgml/ref/grant.sgml b/doc/src/sgml/ref/grant.sgml index ce517dbac6d..aefb6251b89 100644 --- a/doc/src/sgml/ref/grant.sgml +++ b/doc/src/sgml/ref/grant.sgml @@ -104,16 +104,24 @@ Grant all privileges. <PARA> The name of an object to which to grant access. The possible objects are: -<simplelist> -<member> - table -<member> - view -<member> - sequence -<member> - index -</simplelist> + +<itemizedlist mark="bullet" spacing="compact"> +<listitem> +<para> +table + +<listitem> +<para> +view + +<listitem> +<para> +sequence + +<listitem> +<para> +index +</itemizedlist> <VARLISTENTRY> <TERM> @@ -154,14 +162,6 @@ Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> - <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -183,7 +183,6 @@ if it is impossible to give privileges to the specified group or users. </VARIABLELIST> -</VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml index dbbed5958e9..ccfcd4bb81c 100644 --- a/doc/src/sgml/ref/initdb.sgml +++ b/doc/src/sgml/ref/initdb.sgml @@ -93,8 +93,9 @@ Or just let it default to you (the Unix user who runs <note> <para> -Only the Unix superuser can create a database system with a -different user as <productname>Postgres</productname> superuser. +Only the Unix superuser (<literal>root</literal>) + can create a database system with an owner +different from the <productname>Postgres</productname> superuser. </note> </variablelist> diff --git a/doc/src/sgml/ref/insert.sgml b/doc/src/sgml/ref/insert.sgml index 7b32f58bd49..2d90cc65fe0 100644 --- a/doc/src/sgml/ref/insert.sgml +++ b/doc/src/sgml/ref/insert.sgml @@ -76,13 +76,7 @@ A valid query. Refer to the SELECT statement for a further description Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -105,7 +99,6 @@ Message returned if more than one rows were inserted. is the number of rows inserted. </VARIABLELIST> -</VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/listen.sgml b/doc/src/sgml/ref/listen.sgml index 97cb349a890..c9ef49ab980 100644 --- a/doc/src/sgml/ref/listen.sgml +++ b/doc/src/sgml/ref/listen.sgml @@ -52,13 +52,6 @@ Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -78,11 +71,6 @@ Message returned upon successful completion of registration. <PARA> If this backend is already registered for that notify condition. </PARA> -</LISTITEM> -</VARLISTENTRY> -</variablelist> -</LISTITEM> -</VARLISTENTRY> </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/load.sgml b/doc/src/sgml/ref/load.sgml index 6614e732451..66fafdc887a 100644 --- a/doc/src/sgml/ref/load.sgml +++ b/doc/src/sgml/ref/load.sgml @@ -54,14 +54,6 @@ Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> - <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -81,7 +73,6 @@ Message returned if the specified file is not found. The file must be visible <emphasis>to the <productname>Postgres</productname> backend</emphasis>, with the appropriate full path name specified, to avoid this message. -</VARIABLELIST> </VARIABLELIST> </REFSECT2> diff --git a/doc/src/sgml/ref/lock.sgml b/doc/src/sgml/ref/lock.sgml index e4f8c1bb1e9..ca973654104 100644 --- a/doc/src/sgml/ref/lock.sgml +++ b/doc/src/sgml/ref/lock.sgml @@ -51,14 +51,6 @@ Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> - <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -81,7 +73,6 @@ Message returned if <REPLACEABLE CLASS="PARAMETER">table</REPLACEABLE> does not exist. </VARIABLELIST> -</VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/notify.sgml b/doc/src/sgml/ref/notify.sgml index 414b951f93d..73eb7754268 100644 --- a/doc/src/sgml/ref/notify.sgml +++ b/doc/src/sgml/ref/notify.sgml @@ -54,14 +54,6 @@ Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> - <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -70,12 +62,7 @@ NOTIFY <LISTITEM> <PARA> Acknowledgement that notify command has executed. -</PARA> -</LISTITEM> -</VARLISTENTRY> -</variablelist> -</LISTITEM> -</VARLISTENTRY> + <VARLISTENTRY> <TERM> Notify events diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index 3909f651d2d..2a4f59cba88 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -1,12 +1,12 @@ <REFENTRY ID="APP-PG-DUMP"> <REFMETA> -<REFENTRYTITLE> +<REFENTRYTITLE id="pg-dump"> <application>pg_dump</application> </REFENTRYTITLE> <REFMISCINFO>Application</REFMISCINFO> </REFMETA> <REFNAMEDIV> -<REFNAME id="pg-dump"> +<REFNAME> <application>pg_dump</application> </REFNAME> <REFPURPOSE> diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml index a1cf38cb732..2a71416abed 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -1,12 +1,12 @@ <REFENTRY ID="APP-PSQL"> <REFMETA> -<REFENTRYTITLE> +<REFENTRYTITLE id="psql-ref"> <application>psql</application> </REFENTRYTITLE> <REFMISCINFO>Application</REFMISCINFO> </REFMETA> <REFNAMEDIV> -<REFNAME id="psql-ref"> +<REFNAME> <application>psql</application> </REFNAME> <REFPURPOSE> @@ -68,7 +68,7 @@ A single query to run. <application>psql</application> will exit on completion. </variablelist> <para> -The full set of command-line arguments and meta-commands are described in a following +The full set of command-line arguments and meta-commands are described in a subsequent section. <para> @@ -106,6 +106,8 @@ to be used, rather than the default local Unix domain sockets. </TERM> <LISTITEM> <PARA> +The port number on which a <productname>Postgres</productname> server is listening. +Defaults to <literal>5432</literal>. </PARA> </LISTITEM> </VARLISTENTRY> @@ -116,6 +118,8 @@ to be used, rather than the default local Unix domain sockets. </TERM> <LISTITEM> <PARA> +The target for display of messages from the client support library. +Not required. </PARA> </LISTITEM> </VARLISTENTRY> @@ -128,7 +132,7 @@ to be used, rather than the default local Unix domain sockets. <PARA> If <envar>PGOPTION</envar> is specified, then the options it contains are parsed -.BR before +<emphasis>before</emphasis> any command-line options. </PARA> </LISTITEM> diff --git a/doc/src/sgml/ref/reset.sgml b/doc/src/sgml/ref/reset.sgml index fbd5313717c..a1292d3f64a 100644 --- a/doc/src/sgml/ref/reset.sgml +++ b/doc/src/sgml/ref/reset.sgml @@ -52,14 +52,6 @@ Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> - <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -71,7 +63,6 @@ RESET VARIABLE <REPLACEABLE CLASS="PARAMETER">variable</REPLACEABLE> is successfully reset to its default value.. -</VARIABLELIST> </VARIABLELIST> </REFSECT2> diff --git a/doc/src/sgml/ref/revoke.sgml b/doc/src/sgml/ref/revoke.sgml index fcedc85d313..abbd2439d8e 100644 --- a/doc/src/sgml/ref/revoke.sgml +++ b/doc/src/sgml/ref/revoke.sgml @@ -109,16 +109,23 @@ Rescind all privileges. <PARA> The name of an object from which to revoke access. The possible objects are: -<simplelist> -<member> - table -<member> - view -<member> - sequence -<member> - index -</simplelist> +<itemizedlist mark="bullet" spacing="compact"> +<listitem> +<para> +table + +<listitem> +<para> +view + +<listitem> +<para> +sequence + +<listitem> +<para> +index +</itemizedlist> <VARLISTENTRY> <TERM> @@ -166,14 +173,6 @@ Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> - <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -193,7 +192,6 @@ ERROR to revoke privileges from a group or users. </VARIABLELIST> -</VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml index 491f7a16ae8..a1b0ec4fe33 100644 --- a/doc/src/sgml/ref/select.sgml +++ b/doc/src/sgml/ref/select.sgml @@ -1,13 +1,13 @@ <refentry id="SQL-SELECT"> <refmeta> <refentrytitle> - SELECT +SELECT </refentrytitle> <refmiscinfo>SQL - Language Statements</refmiscinfo> </refmeta> <refnamediv> <refname> - SELECT +SELECT </refname> <refpurpose> Retrieve rows from a table or view. @@ -170,14 +170,6 @@ SELECT [ALL|DISTINCT [ON <replaceable class="PARAMETER">column</replaceable>] ] </listitem> </varlistentry> - <varlistentry> - <term> - <replaceable>status</replaceable> - </term> - <listitem> - <para> - - <variablelist> <varlistentry> <term> <returnvalue><replaceable>count</replaceable></returnvalue> @@ -185,10 +177,6 @@ SELECT [ALL|DISTINCT [ON <replaceable class="PARAMETER">column</replaceable>] ] <listitem> <para> The count of rows returned by the query. - </para> - </listitem> - </varlistentry> - </variablelist> </variablelist> </refsect2> @@ -569,16 +557,16 @@ SELECT actors.name <refentry id="SQL-SELECTINTO"> <refmeta> <refentrytitle> - SELECT INTO +SELECT INTO </refentrytitle> <refmiscinfo>SQL - Language Statements</refmiscinfo> </refmeta> <refnamediv> <refname> - SELECT INTO +SELECT INTO </refname> <refpurpose> - Create a new table from an existing table or view +Create a new table from an existing table or view </refpurpose></refnamediv> <refsynopsisdiv> <refsynopsisdivinfo> diff --git a/doc/src/sgml/ref/set.sgml b/doc/src/sgml/ref/set.sgml index d187d46bb8a..3328d73341e 100644 --- a/doc/src/sgml/ref/set.sgml +++ b/doc/src/sgml/ref/set.sgml @@ -470,14 +470,6 @@ Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> - <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -494,8 +486,7 @@ Outputs <LISTITEM> <PARA> If the command fails to set variable. -</VARLISTENTRY> -</VARIABLELIST> + </VARIABLELIST> </REFSECT2> diff --git a/doc/src/sgml/ref/show.sgml b/doc/src/sgml/ref/show.sgml index 4bbc18e9d52..36d605eacc9 100644 --- a/doc/src/sgml/ref/show.sgml +++ b/doc/src/sgml/ref/show.sgml @@ -52,14 +52,6 @@ Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<REPLACEABLE>status</REPLACEABLE> -</TERM> -<LISTITEM> -<PARA> - <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -92,7 +84,6 @@ SHOW VARIABLE If the TZ environment variable is not set. </VARIABLELIST> -</VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> diff --git a/doc/src/sgml/ref/unlisten.sgml b/doc/src/sgml/ref/unlisten.sgml index cc187576751..46ed06c9033 100644 --- a/doc/src/sgml/ref/unlisten.sgml +++ b/doc/src/sgml/ref/unlisten.sgml @@ -60,13 +60,6 @@ Outputs </TITLE> <PARA> -<VARIABLELIST> -<VARLISTENTRY> -<TERM> -<replaceable>status</replaceable> -</TERM> -<LISTITEM> -<PARA> <VARIABLELIST> <VARLISTENTRY> <TERM> @@ -75,12 +68,7 @@ Outputs <LISTITEM> <PARA> Acknowledgement that statement has executed. -</PARA> -</LISTITEM> -</VARLISTENTRY> -</variablelist> -</LISTITEM> -</VARLISTENTRY> + </VARIABLELIST> </REFSECT2> </REFSYNOPSISDIV> @@ -102,7 +90,7 @@ The special condition wildcard "*" cancels all listener registrations for the current session. <para> -<xref linkend="sql-notify-ref" endterm="sql-notify-ref"> +<xref linkend="sql-notify" endterm="sql-notify-ref"> contains a more extensive discussion of the use of <command>LISTEN</command> and <command>NOTIFY</command>. diff --git a/doc/src/sgml/ref/update.sgml b/doc/src/sgml/ref/update.sgml index 3de2b83f6de..a02e022329f 100644 --- a/doc/src/sgml/ref/update.sgml +++ b/doc/src/sgml/ref/update.sgml @@ -92,7 +92,7 @@ The name of a column in <REPLACEABLE CLASS="PARAMETER">table</replaceable>. Outputs </TITLE> <PARA> -</PARA> + <VARIABLELIST> <VARLISTENTRY> <TERM> -- GitLab