Minor cleanup in markup, especially in the Output section.

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>

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>

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>

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>

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>

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>
 

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>

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>

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>

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>

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>

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>

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>

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>

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

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>

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

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>

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>

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>