Put some kind of grammatical uniformity in the <refpurpose> lines.

doc/src/sgml/ref/abort.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/abort.sgml,v 1.7 2000/03/27 17:14:42 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/abort.sgml,v 1.8 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    ABORT
   </refname>
   <refpurpose>
-   Aborts the current transaction
+   abort the current transaction
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/alter_group.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_group.sgml,v 1.4 2001/08/13 15:24:46 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_group.sgml,v 1.5 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    ALTER GROUP
   </refname>
   <refpurpose>
-   Add users to a group;  remove users from a group
+   add users to a group or remove users from a group
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/alter_table.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.25 2001/05/30 13:01:08 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.26 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    ALTER TABLE
   </refname>
   <refpurpose>
-   Modifies table properties
+   change the definition of a table
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/alter_user.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.15 2001/08/15 18:42:14 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_user.sgml,v 1.16 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    ALTER USER
   </refname>
   <refpurpose>
-   Modifies user account information
+   change a database user account
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/analyze.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/analyze.sgml,v 1.1 2001/05/07 00:43:15 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/analyze.sgml,v 1.2 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    ANALYZE
   </refname>
   <refpurpose>
-   Collect statistics about a <productname>Postgres</productname> database
+   collect statistics about a database
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/begin.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/begin.sgml,v 1.13 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/begin.sgml,v 1.14 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    BEGIN
   </refname>
   <refpurpose>
-   Begins a transaction in chained mode
+   start a transaction block
   </refpurpose>
   
   </refnamediv>

doc/src/sgml/ref/checkpoint.sgml

-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/checkpoint.sgml,v 1.4 2001/03/13 01:17:05 tgl Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/checkpoint.sgml,v 1.5 2001/09/03 12:57:49 petere Exp $ -->
 
 <refentry id="sql-checkpoint">
  <docinfo>
@@ -12,7 +12,7 @@
 
  <refnamediv>
   <refname>CHECKPOINT</refname>
-  <refpurpose>Force transaction log checkpoint</refpurpose>
+  <refpurpose>force a transaction log checkpoint</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/close.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/close.sgml,v 1.7 1999/07/22 15:09:06 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/close.sgml,v 1.8 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CLOSE
   </refname>
   <refpurpose>
-   Close a cursor
+   close a cursor
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/cluster.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/cluster.sgml,v 1.10 2001/01/13 23:58:55 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/cluster.sgml,v 1.11 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CLUSTER
   </refname>
   <refpurpose>
-   Gives storage clustering advice to the server
+   cluster a table according to an index
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/comment.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/comment.sgml,v 1.8 2001/03/05 19:00:39 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/comment.sgml,v 1.9 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    COMMENT
   </refname>
   <refpurpose>
-   Add comment to an object
+   define or change the comment of an object
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/commit.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/commit.sgml,v 1.10 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/commit.sgml,v 1.11 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    COMMIT
   </refname>
   <refpurpose>
-   Commits the current transaction
+   commit the current transaction
   </refpurpose>
  </refnamediv>  
   

doc/src/sgml/ref/copy.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/copy.sgml,v 1.22 2001/08/10 23:09:30 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/copy.sgml,v 1.23 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -13,7 +13,7 @@ Postgres documentation
    COPY
   </refname>
   <refpurpose>
-   Copies data between files and tables
+   copy data between files and tables
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_aggregate.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_aggregate.sgml,v 1.13 2001/01/20 20:59:29 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_aggregate.sgml,v 1.14 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
    CREATE AGGREGATE
   </refname>
   <refpurpose>
-   Defines a new aggregate function
+   define a new aggregate function
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_constraint.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_constraint.sgml,v 1.2 2000/07/22 04:30:27 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_constraint.sgml,v 1.3 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE CONSTRAINT TRIGGER
   </refname>
   <refpurpose>
-   Create a trigger to support a constraint
+   define a new constraint trigger
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_database.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_database.sgml,v 1.18 2001/08/26 16:55:59 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_database.sgml,v 1.19 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE DATABASE
   </refname>
   <refpurpose>
-   Creates a new database
+   create a new database
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_function.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.25 2001/08/13 21:34:51 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.26 2001/09/03 12:57:49 petere Exp $
 -->
 
 <refentry id="SQL-CREATEFUNCTION">
@@ -10,7 +10,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.25 2001/08/13
 
  <refnamediv>
   <refname>CREATE FUNCTION</refname>
-  <refpurpose>Defines a new function</refpurpose>
+  <refpurpose>define a new function</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/create_group.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_group.sgml,v 1.3 2001/07/12 18:02:58 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_group.sgml,v 1.4 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE GROUP
   </refname>
   <refpurpose>
-   Creates a new group
+   define a new user group
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_index.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_index.sgml,v 1.22 2001/08/21 16:35:59 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_index.sgml,v 1.23 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE INDEX
   </refname>
   <refpurpose>
-   Constructs a secondary index
+   define a new index
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_language.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_language.sgml,v 1.15 2001/08/13 21:34:51 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_language.sgml,v 1.16 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE LANGUAGE
   </refname>
   <refpurpose>
-   Defines a new language for functions
+   define a new procedural language
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_operator.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.19 2001/05/08 17:51:30 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.20 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE OPERATOR
   </refname>
   <refpurpose>
-   Defines a new user operator
+   define a new operator
   </refpurpose>
   </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_rule.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_rule.sgml,v 1.24 2001/07/09 23:50:31 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_rule.sgml,v 1.25 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -13,7 +13,7 @@ Postgres documentation
    CREATE RULE
   </refname>
   <refpurpose>
-   Defines a new rule
+   define a new rewrite rule
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_sequence.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_sequence.sgml,v 1.18 2001/08/16 20:38:53 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_sequence.sgml,v 1.19 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE SEQUENCE
   </refname>
   <refpurpose>
-   Creates a new sequence number generator
+   define a new sequence
   </refpurpose>
  </refnamediv> 
  <refsynopsisdiv>

doc/src/sgml/ref/create_table.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.44 2001/08/10 20:52:24 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.45 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE TABLE
   </refname>
   <refpurpose>
-   Creates a new table
+   define a new table
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_table_as.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.6 2001/03/20 20:54:41 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.7 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE TABLE AS
   </refname>
   <refpurpose>
-   Creates a new table from the results of a SELECT
+   create a new table from the results of a query
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_trigger.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.14 2001/06/10 03:46:31 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.15 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -13,7 +13,7 @@ Postgres documentation
    CREATE TRIGGER
   </refname>
   <refpurpose>
-   Creates a new trigger
+   define a new trigger
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_type.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_type.sgml,v 1.20 2001/08/03 20:47:40 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_type.sgml,v 1.21 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE TYPE
   </refname>
   <refpurpose>
-   Defines a new base data type
+   define a new data type
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_user.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_user.sgml,v 1.18 2001/08/15 18:42:14 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_user.sgml,v 1.19 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE USER
   </refname>
   <refpurpose>
-   Creates a new database user
+   define a new database user account
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/create_view.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_view.sgml,v 1.11 2001/08/10 23:49:20 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_view.sgml,v 1.12 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    CREATE VIEW
   </refname>
   <refpurpose>
-   Constructs a virtual table
+   define a new view
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/createdb.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.19 2001/08/29 19:11:00 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v 1.20 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>createdb</refname>
-  <refpurpose>Create a new <productname>Postgres</productname> database</refpurpose>
+  <refpurpose>create a new <productname>PostgreSQL</productname> database</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/createlang.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.16 2001/05/09 22:08:18 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v 1.17 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname id="createlang">createlang</refname>
-  <refpurpose>Add a new programming language to a <productname>Postgres</productname> database</refpurpose>
+  <refpurpose>define a new <productname>PostgreSQL</productname> procedural language</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/createuser.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.19 2001/08/26 04:20:36 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v 1.20 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>createuser</refname>
-  <refpurpose>Create a new <productname>Postgres</productname> user</refpurpose>
+  <refpurpose>define a new <productname>PostgreSQL</productname> user account</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/declare.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/declare.sgml,v 1.12 2001/02/15 21:11:17 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/declare.sgml,v 1.13 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DECLARE
   </refname>
   <refpurpose>
-   Defines a cursor for table access
+   define a cursor
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/delete.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/delete.sgml,v 1.13 2001/05/27 09:59:28 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/delete.sgml,v 1.14 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -13,7 +13,7 @@ Postgres documentation
    DELETE
   </refname>
   <refpurpose>
-   Removes rows from a table
+   delete rows of a table
   </refpurpose>
 
  </refnamediv>

doc/src/sgml/ref/drop_aggregate.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_aggregate.sgml,v 1.11 2001/05/02 20:35:21 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_aggregate.sgml,v 1.12 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP AGGREGATE
   </refname>
   <refpurpose>
-   Removes the definition of an aggregate function
+   remove a user-defined aggregate function
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_database.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_database.sgml,v 1.11 2000/11/11 23:01:43 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_database.sgml,v 1.12 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP DATABASE
   </refname>
   <refpurpose>
-   Removes an existing database
+   remove a database
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_function.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_function.sgml,v 1.12 2001/05/19 09:01:10 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_function.sgml,v 1.13 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP FUNCTION
   </refname>
   <refpurpose>
-   Removes a user-defined C function
+   remove a user-defined function
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_group.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.1 2000/01/14 22:11:32 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_group.sgml,v 1.2 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP GROUP
   </refname>
   <refpurpose>
-   Removes a group
+   remove a user group
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_index.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_index.sgml,v 1.10 2001/05/08 17:51:30 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_index.sgml,v 1.11 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP INDEX
   </refname>
   <refpurpose>
-   Removes an index from the database
+   remove an index
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_language.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_language.sgml,v 1.10 2001/08/13 21:34:51 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_language.sgml,v 1.11 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP LANGUAGE
   </refname>
   <refpurpose>
-   Removes a user-defined procedural language
+   remove a user-defined procedural language
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_operator.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_operator.sgml,v 1.10 2001/05/08 17:51:30 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_operator.sgml,v 1.11 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP OPERATOR
   </refname>
   <refpurpose>
-   Removes an operator from the database
+   remove a user-defined operator
   </refpurpose>
  </refnamediv>
   

doc/src/sgml/ref/drop_rule.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_rule.sgml,v 1.9 2001/08/13 15:24:46 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_rule.sgml,v 1.10 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP RULE
   </refname>
   <refpurpose>
-   Removes rules from the database
+   remove a rewrite rule
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_sequence.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_sequence.sgml,v 1.9 2001/08/13 15:24:46 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_sequence.sgml,v 1.10 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP SEQUENCE
   </refname>
   <refpurpose>
-   Removes sequences from a database
+   remove a sequence
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_table.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_table.sgml,v 1.10 2001/08/13 15:24:46 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_table.sgml,v 1.11 2001/09/03 12:57:49 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP TABLE
   </refname>
   <refpurpose>
-   Removes tables from a database
+   remove a table
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_trigger.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_trigger.sgml,v 1.6 1999/07/22 15:09:11 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_trigger.sgml,v 1.7 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP TRIGGER
   </refname>
   <refpurpose>
-   Removes the definition of a trigger
+   remove a trigger
   </refpurpose> 
  </refnamediv>            
  <refsynopsisdiv>

doc/src/sgml/ref/drop_type.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_type.sgml,v 1.9 2001/01/13 23:58:55 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_type.sgml,v 1.10 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP TYPE
   </refname>
   <refpurpose>
-   Removes user-defined types from the system catalogs
+   remove a user-defined data type
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_user.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_user.sgml,v 1.11 2000/03/27 17:14:42 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_user.sgml,v 1.12 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP USER
   </refname>
   <refpurpose>
-   Removes a user
+   remove a database user account
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/drop_view.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_view.sgml,v 1.9 2001/08/13 15:24:46 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_view.sgml,v 1.10 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    DROP VIEW
   </refname>
   <refpurpose>
-   Removes views from the database
+   remove a view
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/dropdb.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropdb.sgml,v 1.10 2001/08/13 15:24:46 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropdb.sgml,v 1.11 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>dropdb</refname>
-  <refpurpose>Removes a <productname>Postgres</productname> database</refpurpose>
+  <refpurpose>remove a <productname>PostgreSQL</productname> database</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/droplang.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.11 2001/08/13 15:24:46 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.12 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname id="droplang">droplang</refname>
-  <refpurpose>Removes a programming language from a <productname>Postgres</productname> database</refpurpose>
+  <refpurpose>remove a <productname>PostgreSQL</productname> procedural language</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/dropuser.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropuser.sgml,v 1.12 2001/08/13 15:24:46 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/dropuser.sgml,v 1.13 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>dropuser</refname>
-  <refpurpose>Removes a <productname>Postgres</productname> user</refpurpose>
+  <refpurpose>remove a <productname>PostgreSQL</productname> user account</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/ecpg-ref.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/ecpg-ref.sgml,v 1.9 2001/08/24 22:37:36 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/ecpg-ref.sgml,v 1.10 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
    <application>ecpg</application>
   </refname>
   <refpurpose>
-   Embedded SQL C preprocessor
+   embedded SQL C preprocessor
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/end.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/end.sgml,v 1.4 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/end.sgml,v 1.5 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    END
   </refname>
   <refpurpose>
-   Commits the current transaction
+   commit the current transaction
   </refpurpose>
  </refnamediv>  
   

doc/src/sgml/ref/explain.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/explain.sgml,v 1.11 2000/10/05 19:48:18 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/explain.sgml,v 1.12 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    EXPLAIN
   </refname>
   <refpurpose>
-   Shows statement execution plan
+   show the execution plan of a statement
   </refpurpose>
  </refnamediv>
 

doc/src/sgml/ref/fetch.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/fetch.sgml,v 1.14 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/fetch.sgml,v 1.15 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    FETCH
   </refname>
   <refpurpose>
-   Gets rows using a cursor
+   retrieve rows from a table using a cursor
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/grant.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/grant.sgml,v 1.11 2001/06/09 23:21:54 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/grant.sgml,v 1.12 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -11,7 +11,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>GRANT</refname>
-  <refpurpose>Grants access privileges to a user, a group, or all users</refpurpose>
+  <refpurpose>define access privileges</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/initdb.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/initdb.sgml,v 1.15 2001/01/20 22:09:24 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/initdb.sgml,v 1.16 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>initdb</refname>
-  <refpurpose>Create a new <productname>Postgres</productname> database cluster</refpurpose>
+  <refpurpose>create a new <productname>PostgreSQL</productname> database cluster</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/initlocation.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/initlocation.sgml,v 1.11 2000/11/11 23:01:45 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/initlocation.sgml,v 1.12 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>initlocation</refname>
-  <refpurpose>Create a secondary <productname>Postgres</productname> database storage area</refpurpose>
+  <refpurpose>create a secondary <productname>PostgreSQL</productname> database storage area</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/insert.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/insert.sgml,v 1.14 2001/05/27 09:59:28 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/insert.sgml,v 1.15 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -13,7 +13,7 @@ Postgres documentation
    INSERT
   </refname>
   <refpurpose>
-   Inserts new rows into a table
+   create new rows in a table
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/ipcclean.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/ipcclean.sgml,v 1.3 2000/11/11 23:01:45 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/ipcclean.sgml,v 1.4 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>ipcclean</refname>
-  <refpurpose>Clean up shared memory and semaphores from aborted backends</refpurpose>
+  <refpurpose>remove shared memory and semaphores from an aborted <productname>PostgreSQL</productname> server</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/listen.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/listen.sgml,v 1.9 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/listen.sgml,v 1.10 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    LISTEN
   </refname>
   <refpurpose>
-   Listen for a response on a notify condition
+   listen for a notification
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/load.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/load.sgml,v 1.8 2001/05/19 09:01:10 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/load.sgml,v 1.9 2001/09/03 12:57:50 petere Exp $
 -->
 
 <refentry id="SQL-LOAD">
@@ -10,7 +10,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/ref/load.sgml,v 1.8 2001/05/19 09:01:10 pet
 
  <refnamediv>
   <refname>LOAD</refname>
-  <refpurpose>Loads a shared object file</refpurpose>
+  <refpurpose>load or reload a shared object file</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/lock.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/lock.sgml,v 1.27 2001/08/10 14:30:14 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/lock.sgml,v 1.28 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    LOCK
   </refname>
   <refpurpose>
-   Explicitly lock a table / tables inside a transaction
+   explicitly lock a table
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/move.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/move.sgml,v 1.10 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/move.sgml,v 1.11 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    MOVE
   </refname>
   <refpurpose>
-   Moves cursor position
+   position a cursor on a specified row of a table
   </refpurpose>
  </refnamediv>                
  <refsynopsisdiv>

doc/src/sgml/ref/notify.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/notify.sgml,v 1.13 2000/10/05 19:48:18 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/notify.sgml,v 1.14 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    NOTIFY
   </refname>
   <refpurpose>
-   Signals all frontends and backends listening on a notify condition
+   generate a notification
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/pg_config-ref.sgml

-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v 1.6 2001/08/28 14:20:26 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v 1.7 2001/09/03 12:57:50 petere Exp $ -->
 
 <refentry id="app-pgconfig">
  <docinfo>
@@ -13,7 +13,7 @@
 
  <refnamediv>
   <refname>pg_config</refname>
-  <refpurpose>Provides information about the installed version of <productname>PostgreSQL</></refpurpose>
+  <refpurpose>retrieve information about the installed version of <productname>PostgreSQL</></refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/pg_ctl-ref.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_ctl-ref.sgml,v 1.7 2001/04/27 01:31:56 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_ctl-ref.sgml,v 1.8 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>pg_ctl</refname>
-  <refpurpose>Starts, stops, or restarts postmaster</refpurpose>
+  <refpurpose>start, stop, or restart a <productname>PostgreSQL</productname> server</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/pg_dump.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.35 2001/08/22 20:23:23 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.36 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -20,7 +20,7 @@ Postgres documentation
   <refname>pg_dump</refname>
 
   <refpurpose>
-   Extract a <productname>Postgres</productname> database into a script file or other archive file 
+   extract a <productname>PostgreSQL</productname> database into a script file or other archive file 
   </refpurpose>
  </refnamediv>
 

doc/src/sgml/ref/pg_dumpall.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.22 2001/05/17 21:12:48 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v 1.23 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>pg_dumpall</refname>
-  <refpurpose>Extract all databases into a script file</refpurpose>
+  <refpurpose>extract all <productname>PostgreSQL</productname> databases into a script file</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/pg_passwd.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pg_passwd.sgml,v 1.7 2001/06/18 16:11:30 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pg_passwd.sgml,v 1.8 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>pg_passwd</refname>
-  <refpurpose>Manipulate a secondary password file</refpurpose>
+  <refpurpose>change a secondary password file</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/pg_restore.sgml

-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.14 2001/08/22 20:23:23 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.15 2001/09/03 12:57:50 petere Exp $ -->
 
 <refentry id="APP-PGRESTORE">
  <docinfo>
@@ -17,8 +17,7 @@
   <refname>pg_restore</refname>
 
   <refpurpose>
-   Restore a <PRODUCTNAME>Postgres</PRODUCTNAME> database from an archive file created by
-<command>pg_dump</command>
+   restore a <productname>PostgreSQL</productname> database from an archive file created by pg_dump
   </refpurpose>
  </refnamediv>
 

doc/src/sgml/ref/pgaccess-ref.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pgaccess-ref.sgml,v 1.10 2001/05/17 21:50:18 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pgaccess-ref.sgml,v 1.11 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>pgaccess</refname>
-  <refpurpose><productname>PostgreSQL</productname> graphical client</refpurpose>
+  <refpurpose>a graphical <productname>PostgreSQL</productname> client application</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/postgres-ref.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/postgres-ref.sgml,v 1.17 2001/03/17 16:27:31 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/postgres-ref.sgml,v 1.18 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>postgres</refname>
-  <refpurpose>Run a <productname>PostgreSQL</productname> single-user backend</refpurpose>
+  <refpurpose>run a <productname>PostgreSQL</productname> server in single-user mode</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/postmaster.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/postmaster.sgml,v 1.19 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/postmaster.sgml,v 1.20 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname id="postmaster-ref">postmaster</refname>
-  <refpurpose><productname>PostgreSQL</productname> multi-user database server</refpurpose>
+  <refpurpose><productname>PostgreSQL</productname> multiuser database server</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>
@@ -45,7 +45,7 @@ Postgres documentation
 
   <para>
    <application>postmaster</application> is the
-   <productname>PostgreSQL</productname> multi-user database server.
+   <productname>PostgreSQL</productname> multiuser database server.
    In order for a client application to access a database it connects
    (over a network or locally) to a running
    <application>postmaster</application>.  The

doc/src/sgml/ref/psql-ref.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.57 2001/07/15 13:45:03 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.58 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -17,7 +17,7 @@ Postgres documentation
   <refnamediv>
     <refname><application>psql</application></refname>
     <refpurpose>
-      <productname>Postgres</productname> interactive terminal
+      <productname>PostgreSQL</productname> interactive terminal
     </refpurpose>
   </refnamediv>
 

doc/src/sgml/ref/reindex.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/reindex.sgml,v 1.3 2000/10/05 19:48:18 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/reindex.sgml,v 1.4 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    REINDEX
   </refname>
   <refpurpose>
-   Recover corrupted system indexes under stand-alone Postgres
+   recover a corrupted system index
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/reset.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/reset.sgml,v 1.11 2001/06/07 04:50:56 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/reset.sgml,v 1.12 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -10,7 +10,7 @@ Postgres documentation
  </refmeta>
  <refnamediv>
   <refname>RESET</refname>
-  <refpurpose>Restores run-time parameters to default values</refpurpose>
+  <refpurpose>restore the value of a run-time parameter to a default value</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
   <synopsis>

doc/src/sgml/ref/revoke.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/revoke.sgml,v 1.15 2001/06/09 23:21:54 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/revoke.sgml,v 1.16 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -11,7 +11,7 @@ Postgres documentation
 
  <refnamediv>
   <refname>REVOKE</refname>
-  <refpurpose>Revokes access privilege from a user, a group, or all users.</refpurpose>
+  <refpurpose>remove access privileges</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/rollback.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/rollback.sgml,v 1.8 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/rollback.sgml,v 1.9 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    ROLLBACK
   </refname>
   <refpurpose>
-   Aborts the current transaction
+   abort the current transaction
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/select.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/select.sgml,v 1.43 2001/06/10 03:46:31 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/select.sgml,v 1.44 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -13,7 +13,7 @@ Postgres documentation
    SELECT
   </refname>
   <refpurpose>
-   Retrieves rows from a table or view
+   retrieve rows from a table or view
   </refpurpose></refnamediv>
  <refsynopsisdiv>
   <refsynopsisdivinfo>

doc/src/sgml/ref/select_into.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/select_into.sgml,v 1.10 2001/03/20 20:54:41 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/select_into.sgml,v 1.11 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    SELECT INTO
   </refname>
   <refpurpose>
-   Creates a new table from the results of a SELECT
+   create a new table from the results of a query
   </refpurpose></refnamediv>
  <refsynopsisdiv>
   <refsynopsisdivinfo>

doc/src/sgml/ref/set.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/set.sgml,v 1.52 2001/03/05 19:00:01 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/set.sgml,v 1.53 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -10,7 +10,7 @@ Postgres documentation
  </refmeta>
  <refnamediv>
   <refname>SET</refname>
-  <refpurpose>Set run-time parameters</refpurpose>
+  <refpurpose>change a run-time parameter</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
   <synopsis>

doc/src/sgml/ref/set_constraints.sgml

-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_constraints.sgml,v 1.2 2000/07/14 15:27:14 thomas Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_constraints.sgml,v 1.3 2001/09/03 12:57:50 petere Exp $ -->
 <refentry id="SQL-SET-CONSTRAINTS">
  <refmeta>
   <refentrytitle id="SQL-SET-CONSTRAINTS-title">SET CONSTRAINTS</refentrytitle>
@@ -6,7 +6,7 @@
  </refmeta>
  <refnamediv>
   <refname>SET CONSTRAINTS</refname>
-  <refpurpose>Set the constraint mode of the current SQL-transaction</refpurpose>
+  <refpurpose>set the constraint mode of the current transaction</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
   <refsynopsisdivinfo>

doc/src/sgml/ref/set_session_auth.sgml

-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_session_auth.sgml,v 1.1 2001/05/08 21:06:42 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_session_auth.sgml,v 1.2 2001/09/03 12:57:50 petere Exp $ -->
 <refentry id="SQL-SET-SESSION-AUTHORIZATION">
  <docinfo>
   <date>2001-04-21</date>
@@ -11,8 +11,8 @@
 
  <refnamediv>
   <refname>SET SESSION AUTHORIZATION</refname>
-  <refpurpose>Set the session user identifier and the current user identifier
-         of the current SQL-session context</refpurpose>
+  <refpurpose>set the session user identifier and the current user identifier
+         of the current session</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/set_transaction.sgml

-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_transaction.sgml,v 1.4 2001/06/30 22:03:25 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set_transaction.sgml,v 1.5 2001/09/03 12:57:50 petere Exp $ -->
 <refentry id="SQL-SET-TRANSACTION">
  <docinfo>
   <date>2000-11-24</date>
@@ -11,7 +11,7 @@
 
  <refnamediv>
   <refname>SET TRANSACTION</refname>
-  <refpurpose>Set the characteristics of the current SQL-transaction</refpurpose>
+  <refpurpose>set the characteristics of the current transaction</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/ref/show.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.12 2001/06/07 04:50:56 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.13 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -10,7 +10,7 @@ Postgres documentation
  </refmeta>
  <refnamediv>
   <refname>SHOW</refname>
-  <refpurpose>Shows run-time parameters</refpurpose>
+  <refpurpose>show the value of a run-time parameter</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
   <synopsis>

doc/src/sgml/ref/truncate.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/truncate.sgml,v 1.2 1999/10/01 15:24:09 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/truncate.sgml,v 1.3 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    TRUNCATE
   </refname>
   <refpurpose>
-   Empty a table
+   empty a table
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/unlisten.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/unlisten.sgml,v 1.14 2001/01/13 23:58:55 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/unlisten.sgml,v 1.15 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    UNLISTEN
   </refname>
   <refpurpose>
-   Stop listening for notification
+   stop listening for a notification
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/update.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/update.sgml,v 1.15 2001/05/27 09:59:28 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/update.sgml,v 1.16 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -13,7 +13,7 @@ Postgres documentation
    UPDATE
   </refname>
   <refpurpose>
-   Replaces values of columns in a table
+   update rows of a table
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/vacuum.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/vacuum.sgml,v 1.18 2001/08/26 16:55:59 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/vacuum.sgml,v 1.19 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -15,7 +15,7 @@ Postgres documentation
    VACUUM
   </refname>
   <refpurpose>
-   Clean and optionally analyze a <productname>Postgres</productname> database
+   garbage-collect and optionally analyze a database
   </refpurpose>
  </refnamediv>
  <refsynopsisdiv>

doc/src/sgml/ref/vacuumdb.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/vacuumdb.sgml,v 1.17 2001/07/10 22:09:28 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/vacuumdb.sgml,v 1.18 2001/09/03 12:57:50 petere Exp $
 Postgres documentation
 -->
 
@@ -16,7 +16,7 @@ Postgres documentation
 
  <refnamediv>
   <refname id="vacuumdb">vacuumdb</refname>
-  <refpurpose>Clean and analyze a <productname>Postgres</productname> database</refpurpose>
+  <refpurpose>garbage-collect and analyze a <productname>PostgreSQL</productname> database</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>

doc/src/sgml/reference.sgml

 <!-- reference.sgml
-$Header: /cvsroot/pgsql/doc/src/sgml/reference.sgml,v 1.17 2001/05/08 21:06:42 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/reference.sgml,v 1.18 2001/09/03 12:57:49 petere Exp $
 
 PostgreSQL Reference Manual
 -->
@@ -12,13 +12,36 @@ PostgreSQL Reference Manual
   &legal;
  </bookinfo>
 
+ <preface id="reference-preface">
+  <title>Preface</title>
+
+  <para>
+   The entries in this <citetitle>Reference Manual</citetitle> are
+   meant to provide in reasonable length an authorative, complete, and
+   formal summary about the respective subjects.  More information
+   about the use of <productname>PostgreSQL</productname>, in
+   narrative, tutorial, or example form, may be found in other parts
+   of the <productname>PostgreSQL</productname> documentation set.
+   See the cross-references listed on each reference page.
+  </para>
+
+  <para>
+   The <citetitle>Reference Manual</citetitle> entries are also
+   available as traditional <quote>man</quote> pages.
+  </para>
+ </preface>
+
  <reference id="sql-commands">
   <title>SQL Commands</title>
 
   <partintro>
    <para>
-    This is reference information for the <acronym>SQL</acronym>
-    commands supported by <productname>Postgres</productname>.
+    This part contains reference information for the
+    <acronym>SQL</acronym> commands supported by
+    <productname>PostgreSQL</productname>.  By <quote>SQL</quote> the
+    language in general is meant; information about the standards
+    conformance and compatibility of each command can be found on the
+    respective reference page.
    </para>
   </partintro>
 
@@ -120,15 +143,20 @@ Disable this chapter until we have more functions documented.
 
   <partintro>
    <para>
-    This is reference information for
-    <productname>Postgres</productname> client applications and
-    utilities.
+    This part contains reference information for
+    <productname>PostgreSQL</productname> client applications and
+    utilities.  Not all of these commands are of general utility, some
+    may require special privileges.  The common feature of these
+    applications is that they can be run on any host, independent of
+    where the database server resides.
    </para>
   </partintro>
 
    &createdb;
+   &createlang;
    &createuser;
    &dropdb;
+   &droplang;
    &dropuser;
    &ecpgRef;
    &pgAccess;
@@ -148,14 +176,14 @@ Disable this chapter until we have more functions documented.
 
   <partintro>
    <para>
-    This is reference information for
-    <productname>Postgres</productname>
-    server applications and support utilities.
+    This part contains reference information for
+    <productname>PostgreSQL</productname> server applications and
+    support utilities.  These commands can only be run usefully on the
+    host where the database server resides.  Other utility programs
+    are listed in <xref linkend="reference-client">.
    </para>
   </partintro>
 
-   &createlang;
-   &droplang;
    &initdb;
    &initlocation;
    &ipcclean;