Very minor formatting fixup in the refentry id field to remove

the trailing "-1". This makes a cleaner html output file name.
Clean up a few refpurpose fields.

doc/src/sgml/ref/alter_table.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-ALTERTABLE-1">
+<REFENTRY ID="SQL-ALTERTABLE">
 <REFMETA>
 <REFENTRYTITLE>
 ALTER TABLE

doc/src/sgml/ref/alter_user.sgml

@@ -1,4 +1,4 @@
-  <REFENTRY ID="SQL-ALTERUSER-1">
+  <REFENTRY ID="SQL-ALTERUSER">
    <REFMETA>
     <REFENTRYTITLE>
      ALTER USER

doc/src/sgml/ref/begin.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-BEGINWORK-1">
+<REFENTRY ID="SQL-BEGINWORK">
  <REFMETA>
   <REFENTRYTITLE>
    BEGIN WORK

doc/src/sgml/ref/close.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CLOSE-1">
+<REFENTRY ID="SQL-CLOSE">
  <REFMETA>
   <REFENTRYTITLE>
    CLOSE

doc/src/sgml/ref/cluster.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CLUSTER-1">
+<REFENTRY ID="SQL-CLUSTER">
  <REFMETA>
  <REFENTRYTITLE>
   CLUSTER
@@ -10,7 +10,7 @@
   CLUSTER
  </REFNAME>
  <REFPURPOSE>
-  Gives storage clustering advice to PostgreSQL
+  Gives storage clustering advice to the backend
  </REFPURPOSE>
  
  <REFSYNOPSISDIV>

doc/src/sgml/ref/commit.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-COMMIT-1">
+<REFENTRY ID="SQL-COMMIT">
  <REFMETA>
   <REFENTRYTITLE>
    COMMIT

doc/src/sgml/ref/copy.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-COPY-1">
+<REFENTRY ID="SQL-COPY">
  <REFMETA>
   <REFENTRYTITLE>
    COPY

doc/src/sgml/ref/create_aggregate.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATEAGGREGATE-1">
+<REFENTRY ID="SQL-CREATEAGGREGATE">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE AGGREGATE

doc/src/sgml/ref/create_database.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATEDATABASE-1">
+<REFENTRY ID="SQL-CREATEDATABASE">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE DATABASE

doc/src/sgml/ref/create_function.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATEFUNCTION-1">
+<REFENTRY ID="SQL-CREATEFUNCTION">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE FUNCTION

doc/src/sgml/ref/create_index.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATEINDEX-1">
+<REFENTRY ID="SQL-CREATEINDEX">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE INDEX

doc/src/sgml/ref/create_language.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATELANGUAGE-1">
+<REFENTRY ID="SQL-CREATELANGUAGE">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE LANGUAGE

doc/src/sgml/ref/create_operator.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATEOPERATOR-1">
+<REFENTRY ID="SQL-CREATEOPERATOR">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE OPERATOR

doc/src/sgml/ref/create_rule.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATERULE-1">
+<REFENTRY ID="SQL-CREATERULE">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE RULE

doc/src/sgml/ref/create_sequence.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATESEQUENCE-1">
+<REFENTRY ID="SQL-CREATESEQUENCE">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE SEQUENCE

doc/src/sgml/ref/create_table.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATETABLE-1">
+<REFENTRY ID="SQL-CREATETABLE">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE TABLE

doc/src/sgml/ref/create_trigger.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATETRIGGER-1">
+<REFENTRY ID="SQL-CREATETRIGGER">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE TRIGGER

doc/src/sgml/ref/create_type.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATETYPE-1">
+<REFENTRY ID="SQL-CREATETYPE">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE TYPE

doc/src/sgml/ref/create_user.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATEUSER-1">
+<REFENTRY ID="SQL-CREATEUSER">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE USER
@@ -318,4 +318,4 @@ sgml-exposed-tags:nil
 sgml-local-catalogs:"/usr/lib/sgml/catalog"
 sgml-local-ecat-files:nil
 End:
--->
+-->

doc/src/sgml/ref/create_view.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CREATEVIEW-1">
+<REFENTRY ID="SQL-CREATEVIEW">
  <REFMETA>
   <REFENTRYTITLE>
    CREATE VIEW
@@ -282,4 +282,4 @@ sgml-exposed-tags:nil
 sgml-local-catalogs:"/usr/lib/sgml/catalog"
 sgml-local-ecat-files:nil
 End:
--->
+-->

doc/src/sgml/ref/current_date.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CURRENT-DATE-1">
+<REFENTRY ID="SQL-CURRENT-DATE">
  <REFMETA>
   <REFENTRYTITLE>
    SQL_CURRENT_DATE
@@ -10,7 +10,7 @@
    SQL_CURRENT_DATE
   </REFNAME>
   <REFPURPOSE>
-- returns the current date, (i.e "today").
+Returns the current date
   </REFPURPOSE>
  <REFSYNOPSISDIV>
   <REFSYNOPSISDIVINFO>
@@ -168,4 +168,4 @@ sgml-exposed-tags:nil
 sgml-local-catalogs:"/usr/lib/sgml/catalog"
 sgml-local-ecat-files:nil
 End:
--->
+-->

doc/src/sgml/ref/current_time.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CURRENT-TIME-1">
+<REFENTRY ID="SQL-CURRENT-TIME">
  <REFMETA>
   <REFENTRYTITLE>
    SQL_CURRENT_TIME
@@ -10,7 +10,7 @@
    SQL_CURRENT_TIME
   </REFNAME>
   <REFPURPOSE>
-    - returns the current local time, (i.e "now").
+Returns the current local time
   </REFPURPOSE>
  <REFSYNOPSISDIV>
   <REFSYNOPSISDIVINFO>
@@ -183,4 +183,4 @@ sgml-exposed-tags:nil
 sgml-local-catalogs:"/usr/lib/sgml/catalog"
 sgml-local-ecat-files:nil
 End:
--->
+-->

doc/src/sgml/ref/current_timestamp.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CURRENT-TIMESTAMP-1">
+<REFENTRY ID="SQL-CURRENT-TIMESTAMP">
  <REFMETA>
   <REFENTRYTITLE>
    SQL_CURRENT_TIMESTAMP
@@ -10,8 +10,7 @@
    SQL_CURRENT_TIMESTAMP
   </REFNAME>
   <REFPURPOSE>
-   returns the current timestamp, (i.e the
+   Returns the current date and time
-   date "today" concatenated with time "now").
   </REFPURPOSE>
   
   
@@ -191,4 +190,4 @@ sgml-exposed-tags:nil
 sgml-local-catalogs:"/usr/lib/sgml/catalog"
 sgml-local-ecat-files:nil
 End:
--->
+-->

doc/src/sgml/ref/current_user.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-CURRENT-USER-1">
+<REFENTRY ID="SQL-CURRENT-USER">
  <REFMETA>
   <REFENTRYTITLE>
    SQL_CURRENT_USER
@@ -10,7 +10,7 @@
    SQL_CURRENT_USER
   </REFNAME>
   <REFPURPOSE>
-   - returns the current user name.
+   Returns the current user name
   </REFPURPOSE>
  <REFSYNOPSISDIV>
   <REFSYNOPSISDIVINFO>
@@ -190,4 +190,4 @@ sgml-exposed-tags:nil
 sgml-local-catalogs:"/usr/lib/sgml/catalog"
 sgml-local-ecat-files:nil
 End:
--->
+-->

doc/src/sgml/ref/delete.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-DELETE-1">
+<REFENTRY ID="SQL-DELETE">
  <REFMETA>
   <REFENTRYTITLE>
    DELETE
@@ -204,4 +204,4 @@ sgml-exposed-tags:nil
 sgml-local-catalogs:"/usr/lib/sgml/catalog"
 sgml-local-ecat-files:nil
 End:
--->
+-->

doc/src/sgml/ref/drop_function.sgml

@@ -1,4 +1,4 @@
-<REFENTRY ID="SQL-DROPFUNCTION-1">
+<REFENTRY ID="SQL-DROPFUNCTION">
  <REFMETA>
   <REFENTRYTITLE>
    DROP FUNCTION