Various minor improvements to the SGML documentation: fix some incorrect

SGML markup, add a "deprecated features" section to the 8.0 release notes, untabify release.sgml and runtime.sgml, and make some other minor improvements.

Various minor improvements to the SGML documentation: fix some incorrect
SGML markup, add a "deprecated features" section to the 8.0 release notes, untabify release.sgml and runtime.sgml, and make some other minor improvements.
cda1bd6c · Neil Conway · 4dbb880d · cda1bd6c · cda1bd6c · cda1bd6c
Commit cda1bd6c authored Aug 24, 2004 by Neil Conway
13 changed files
--- a/doc/src/sgml/errcodes.sgml
+++ b/doc/src/sgml/errcodes.sgml
-<!-- $PostgreSQL: pgsql/doc/src/sgml/errcodes.sgml,v 1.7 2004/07/31 23:04:54 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/errcodes.sgml,v 1.8 2004/08/24 00:06:50 neilc Exp $ -->
 <appendix id="errcodes-appendix">
 <title><productname>PostgreSQL</productname> Error Codes</title>
@@ -1133,7 +1133,7 @@
 <row>
 <entry>Class 58</entry>
-<entry>System Error (errors external to PostgreSQL itself)</entry>
+<entry>System Error (errors external to <productname>PostgreSQL</> itself)</entry>
 </row>
 <row>

--- a/doc/src/sgml/problems.sgml
+++ b/doc/src/sgml/problems.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/problems.sgml,v 2.18 2004/03/09 16:57:46 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/problems.sgml,v 2.19 2004/08/24 00:06:50 neilc Exp $
 -->
 <sect1 id="bug-reporting">
@@ -11,8 +11,7 @@ $PostgreSQL: pgsql/doc/src/sgml/problems.sgml,v 2.18 2004/03/09 16:57:46 neilc E
  <productname>PostgreSQL</productname> more reliable because even the utmost
  care cannot guarantee that every part of
  <productname>PostgreSQL</productname> 
-  will work on every 
+  will work on every platform under every circumstance.
-  platform under every circumstance.
 </para>
 <para>
@@ -241,9 +240,9 @@ $PostgreSQL: pgsql/doc/src/sgml/problems.sgml,v 2.18 2004/03/09 16:57:46 neilc E
      in each new release, so it is quite possible that a bug you have
      encountered in an older release of <productname>PostgreSQL</>
      has already been fixed. We can only provide limited support for
-      sites using older releases of PostgreSQL; if you require more
+      sites using older releases of <productname>PostgreSQL</>; if you
-      than we can provide, consider acquiring a commercial support
+      require more than we can provide, consider acquiring a
-      contract.
+      commercial support contract.
     </para>
     <para>
     </para>

--- a/doc/src/sgml/ref/alter_index.sgml
+++ b/doc/src/sgml/ref/alter_index.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_index.sgml,v 1.3 2004/08/21 16:16:04 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_index.sgml,v 1.4 2004/08/24 00:06:51 neilc Exp $
 PostgreSQL documentation
 -->
@@ -167,7 +167,8 @@ ALTER INDEX distributors SET TABLESPACE fasttablespace;
  <title>Compatibility</title>
  <para>
-	<literal>ALTER INDEX</> is a PostgreSQL extension.
+   <command>ALTER INDEX</> is a <productname>PostgreSQL</productname>
+   extension.
  </para>
 </refsect1>
 </refentry>

--- a/doc/src/sgml/ref/alter_sequence.sgml
+++ b/doc/src/sgml/ref/alter_sequence.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.7 2003/11/29 19:51:38 pgsql Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.8 2004/08/24 00:06:51 neilc Exp $
 PostgreSQL documentation
 -->
@@ -14,7 +14,7 @@ PostgreSQL documentation
   ALTER SEQUENCE
  </refname>
  <refpurpose>
-   alter the definition of a sequence generator
+   change the definition of a sequence generator
  </refpurpose>
 </refnamediv> 

--- a/doc/src/sgml/ref/create_table_as.sgml
+++ b/doc/src/sgml/ref/create_table_as.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.22 2004/08/04 21:33:42 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.23 2004/08/24 00:06:51 neilc Exp $
 PostgreSQL documentation
 -->
@@ -11,7 +11,7 @@ PostgreSQL documentation
 <refnamediv>
  <refname>CREATE TABLE AS</refname>
-  <refpurpose>create a new table from the results of a query</refpurpose>
+  <refpurpose>define a new table from the results of a query</refpurpose>
 </refnamediv>
 <indexterm zone="sql-createtableas">

--- a/doc/src/sgml/ref/create_tablespace.sgml
+++ b/doc/src/sgml/ref/create_tablespace.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_tablespace.sgml,v 1.3 2004/08/02 04:25:37 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_tablespace.sgml,v 1.4 2004/08/24 00:06:51 neilc Exp $
 PostgreSQL documentation
 -->
@@ -34,8 +34,8 @@ CREATE TABLESPACE <replaceable class="parameter">tablespacename</replaceable> [
  </para>
  <para>
-   A tablespace allows superusers to define an alternative location on the
+   A tablespace allows superusers to define an alternative location on
-   file system where the data files representing database objects
+   the file system where the data files containing database objects
   (such as tables and indexes) may reside.
  </para>

--- a/doc/src/sgml/ref/psql-ref.sgml
+++ b/doc/src/sgml/ref/psql-ref.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.120 2004/08/14 23:49:07 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.121 2004/08/24 00:06:51 neilc Exp $
 PostgreSQL documentation
 -->
@@ -771,7 +771,7 @@ testdb=>
        <listitem>
        <para>
        Shows the copyright and distribution terms of
-        <application>PostgreSQL</application>.
+        <productname>PostgreSQL</productname>.
        </para>
        </listitem>
      </varlistentry>

--- a/doc/src/sgml/ref/release_savepoint.sgml
+++ b/doc/src/sgml/ref/release_savepoint.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/release_savepoint.sgml,v 1.1 2004/08/12 19:12:21 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/release_savepoint.sgml,v 1.2 2004/08/24 00:06:51 neilc Exp $
 PostgreSQL documentation
 -->
@@ -77,7 +77,7 @@ RELEASE [ SAVEPOINT ] <replaceable>savepoint_name</replaceable>
  <para>
   It is not possible to release a savepoint when the transaction is in
-   aborted state.
+   an aborted state.
  </para>
  <para>
@@ -108,9 +108,11 @@ COMMIT;
  <title>Compatibility</title>
  <para>
-   The SQL2003 standard specifies that the keyword SAVEPOINT is mandatory.
+   The SQL2003 standard specifies that the keyword
-   <productname>PostgreSQL</productname> allows the SAVEPOINT keyword to be
+   <literal>SAVEPOINT</literal> is mandatory.
-   omitted. Otherwise, this command is fully conforming.
+   <productname>PostgreSQL</productname> allows the
+   <literal>SAVEPOINT</literal> keyword to be omitted. Otherwise, this
+   command is fully conforming.
  </para>
 </refsect1>

--- a/doc/src/sgml/ref/rollback_to.sgml
+++ b/doc/src/sgml/ref/rollback_to.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/rollback_to.sgml,v 1.2 2004/08/12 19:12:21 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/rollback_to.sgml,v 1.3 2004/08/24 00:06:51 neilc Exp $
 PostgreSQL documentation
 -->
@@ -128,13 +128,15 @@ COMMIT;
  <title>Compatibility</title>
  <para>
-   The SQL2003 standard specifies that the keyword SAVEPOINT is mandatory.
+   The SQL2003 standard specifies that the keyword
-   <productname>PostgreSQL</productname> and <productname>Oracle</productname>
+   <literal>SAVEPOINT</> is mandatory.  <productname>PostgreSQL</> and
-   allow the SAVEPOINT keyword to be omitted.  SQL2003 allows only
+   <productname>Oracle</> allow the <literal>SAVEPOINT</literal>
-   WORK, not TRANSACTION, as a noise word after ROLLBACK.  Also, SQL2003
+   keyword to be omitted.  SQL2003 allows only <literal>WORK</>, not
-   has an optional clause AND [ NO ] CHAIN which is not currently supported
+   <literal>TRANSACTION</>, as a noise word after
-   by <productname>PostgreSQL</productname>.  Otherwise, this command is
+   <literal>ROLLBACK</>.  Also, SQL2003 has an optional clause
-   fully conforming.
+   <literal>AND [ NO ] CHAIN</> which is not currently supported by
+   <productname>PostgreSQL</>.  Otherwise, this command is fully
+   conforming.
  </para>
 </refsect1>

--- a/doc/src/sgml/ref/select_into.sgml
+++ b/doc/src/sgml/ref/select_into.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/select_into.sgml,v 1.29 2004/08/04 21:33:42 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/select_into.sgml,v 1.30 2004/08/24 00:06:51 neilc Exp $
 PostgreSQL documentation
 -->
@@ -11,7 +11,7 @@ PostgreSQL documentation
 <refnamediv>
  <refname>SELECT INTO</refname>
-  <refpurpose>create a new table from the results of a query</refpurpose>
+  <refpurpose>define a new table from the results of a query</refpurpose>
 </refnamediv>
 <indexterm zone="sql-selectinto">

--- a/doc/src/sgml/release.sgml
+++ b/doc/src/sgml/release.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.288 2004/08/24 00:06:50 neilc Exp $
 -->
 <appendix id="release">
@@ -27,36 +27,38 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
      <listitem>
       <para>
-        This is the first PostgreSQL release to natively run on Microsoft
+        This is the first <productname>PostgreSQL</productname>
-        Windows as a server. It can run as a Windows service. This release
+        release to natively run on Microsoft Windows as a server. It
-	supports NT-based Windows releases like Win2000, XP, Win2003.
+        can run as a Windows service. This release supports NT-based
-        Older releases like Windows 95, 98, and ME are not supported because
+        Windows releases like Win2000, XP, Win2003.  Older releases
-	these operating systems do not have the infrastructure to
+        like Windows 95, 98, and ME are not supported because these
-	support PostgreSQL.  A separate installer project has been created 
+        operating systems do not have the infrastructure to support
-        to ease installation on Windows: 
+        <productname>PostgreSQL</productname>.  A separate installer
+        project has been created to ease installation on Windows:
        <ulink url="http://pgfoundry.org/projects/pginstaller">
        http://pgfoundry.org/projects/pginstaller</ulink>.
       </para>
       <para>
        Previous releases required the Unix emulation toolkit Cygwin for
-        Win32 server support. PostgreSQL has always supported clients on Win32.
+        Win32 server support. <productname>PostgreSQL</productname>
+        has always supported clients on Win32.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term>
-       Savepoints Improve Transaction Control
+       Savepoints
      </term>
      <listitem>
       <para>
        Savepoints allow specific parts of a transaction to be aborted
        without affecting the remainder of the transaction. Prior
-        releases had no such capability; there was no way to recover from
+        releases had no such capability; there was no way to recover
-        a statement failure within a transaction except by aborting the whole
+        from a statement failure within a transaction except by
-	transaction. This feature is valuable
+        aborting the whole transaction. This feature is valuable for
-        for application writers who require error recovery within a
+        application writers who require error recovery within a
        complex transaction.
       </para>
      </listitem>
@@ -64,40 +66,41 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
     <varlistentry>
      <term>
-       Point-In-Time Recovery Increases Reliability
+       Point-In-Time Recovery
      </term>
      <listitem>
       <para>
-        Though PostgreSQL is very reliable, in previous releases there
+        Though <productname>PostgreSQL</productname> is very reliable,
-        was no way to recover from disk drive failure except to restore
+        in previous releases there was no way to recover from disk
-        from a previous backup or use a standby replication server.
+        drive failure except to restore from a previous backup or use
-	Point-in-time recovery allows continuous backup of the server.
+        a standby replication server.  Point-in-time recovery allows
-	You can recover either to the point of failure or to some
+        continuous backup of the server.  You can recover either to
-	transaction in the past.
+        the point of failure or to some transaction in the past.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term>
-       Tablespaces Simplify Disk Layout
+       Tablespaces
      </term>
      <listitem>
       <para>
-        Tablespaces allow administrators
+        Tablespaces allow administrators to select the file systems
-        to select the file systems used for storage of databases,
+        used for storage of databases, schemas, tables, or
-        schemas, tables, or indexes. This improves performance and
+        indexes. This improves performance and control over disk space
-        control over disk space usage. Prior releases used
+        usage. Prior releases used <application>initlocation</> and
-        <literal>initlocation</> and manual symlink management for such tasks.
+        manual symlink management for such tasks.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term>
-       Improved Buffer Management, CHECKPOINT, VACUUM
+       Improved Buffer Management, <command>CHECKPOINT</command>,
+       <command>VACUUM</command>
      </term>
      <listitem>
@@ -117,7 +120,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
      <listitem>
       <para>
-        A column's data type can now be changed with ALTER TABLE.
+        A column's data type can now be changed with <command>ALTER
+        TABLE</command>.
       </para>
      </listitem>
     </varlistentry>
@@ -138,14 +142,14 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
     <varlistentry>
      <term>
-       COPY Handles Comma-Separated-Value Files
+        CSV support in <command>COPY</command>
      </term>
      <listitem>
       <para>
-        COPY can now read and write comma-separated-value (CSV) files. It
+        <command>COPY</command> can now read and write
-        has the flexibility to interpret non-standard quoting and
+        comma-separated-value (CSV) files. It has the flexibility to
-        separation characters too.
+        interpret non-standard quoting and separation characters too.
       </para>
      </listitem>
     </varlistentry>
@@ -181,9 +185,10 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
     <listitem>
      <para>
       Server configuration parameters <varname>SortMem</> and
-       <varname>VacuumMem</> have been renamed to <varname>work_mem</> and
+       <varname>VacuumMem</> have been renamed to <varname>work_mem</>
-       <varname>maintenance_work_mem</> to better reflect their use. The
+       and <varname>maintenance_work_mem</> to better reflect their
-       original names are still supported in SET and SHOW.
+       use. The original names are still supported in
+       <command>SET</command> and <command>SHOW</command>.
      </para>
     </listitem>
@@ -246,8 +251,9 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
     <listitem>
      <para>
-       The server now warns of empty strings passed to oid/float4/float8
+       The server now warns of empty strings passed to
-       data types. In the next major release, doing this will generate an
+       <type>oid</type>/<type>float4</type>/<type>float8</type> data
+       types. In the next major release, doing this will generate an
       error.
      </para>
     </listitem>
@@ -292,8 +298,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
     <listitem>
      <para>
-       EXECUTE now returns a completion tag that matches the executed
+       <command>EXECUTE</command> now returns a completion tag that
-       statement.
+       matches the executed statement.
      </para>
     </listitem>
@@ -307,8 +313,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
     <listitem>
      <para>
-       Now that tablespaces have been implemented, initlocation has been
+       Now that tablespaces have been implemented,
-       removed.
+       <application>initlocation</> has been removed.
      </para>
     </listitem>
@@ -321,15 +327,43 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
       ignored as well as leading whitespace (which has always been ignored).
      </para>
     </listitem>
+    </itemizedlist>
+   </para>
+  </sect2>
+  <sect2>
+   <title>Deprecated Features</title>
+   <para>
+    Some aspects of <productname>PostgreSQL</productname>'s behavior
+    have been determined to be suboptimal. For the sake of backward
+    compatibility these have not been removed in 8.0, but they are
+    considered deprecated and will be removed in the next major
+    release.
+    </para>
+   <itemizedlist>
+    <listitem>
+     <para>
+      The 8.1 release will remove the function
+       <literal>to_char(interval)</literal>.
+     </para>
+    </listitem>
    <listitem>
     <para>
-       The 8.1 release will remove the function <literal>to_char(interval)
+      By default, tables in <productname>PostgreSQL</productname> 8.0
-       </literal>.
+      and earlier are created with OIDs. In the next release, this
+      will <emphasis>not</emphasis> be the case: to create a table
+      that contains OIDs, the <literal>WITH OIDS</literal> clause must
+      be specified or the <varname>default_with_oids</varname>
+      configuration parameter must be enabled. Users are encouraged to
+      explicitely specify <literal>WITH OIDS</literal> if their tables
+      require OIDs for compatibility with future releases of
+      <productname>PostgreSQL</productname>.
     </para>
    </listitem>
   </itemizedlist>
-   </para>
  </sect2>
  <sect2>
@@ -396,10 +430,11 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
      Add ability to prolong vacuum to reduce performance impact (Jan)
     </para>
     <para>
-      On busy systems, VACUUM performs many I/O requests which can hurt
+      On busy systems, <command>VACUUM</command> performs many I/O
-      performance for other users. This release allows you to slow down
+      requests which can hurt performance for other users. This
-      VACUUM to reduce its impact on other users, though this increases the
+      release allows you to slow down <command>VACUUM</command> to
-      total duration of VACUUM.
+      reduce its impact on other users, though this increases the
+      total duration of <command>VACUUM</command>.
     </para>
    </listitem>
@@ -469,7 +504,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Add type-specific ANALYZE statistics capability (Mark Cave-Ayland)
+      Add type-specific <command>ANALYZE</command> statistics
+      capability (Mark Cave-Ayland)
     </para>
     <para>
      This feature allows more flexibility in generating statistics
@@ -479,7 +515,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Allow collection of ANALYZE statistics for expression indexes (Tom)
+      Allow collection of <command>ANALYZE</command> statistics for
+      expression indexes (Tom)
     </para>
     <para>
      Expression indexes (also called functional indexes) allow users to
@@ -493,7 +530,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      New two-stage sampling method for ANALYZE (Manfred Koizar)
+      New two-stage sampling method for <command>ANALYZE</command>
+      (Manfred Koizar)
     </para>
     <para>
      This gives better statistics for asymmetric data distributions.
@@ -502,11 +540,11 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Speed up TRUNCATE (Tom)
+      Speed up <command>TRUNCATE</command> (Tom)
     </para>
     <para>
      This buys back some of the performance loss observed in 7.4, while still
-      keeping TRUNCATE transaction-safe.
+      keeping <command>TRUNCATE</command> transaction-safe.
     </para>
    </listitem>
@@ -671,23 +709,27 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Allow DECLARE CURSOR to take parameters (Oliver Jowett)
+      Allow <command>DECLARE CURSOR</command> to take parameters
+      (Oliver Jowett)
     </para>
     <para>
-      It is now useful to issue DECLARE CURSOR in a Parse message with
+      It is now useful to issue <command>DECLARE CURSOR</command> in a
-      parameters.  The parameter values sent at Bind time will be substituted
+      Parse message with parameters.  The parameter values sent at
-      into the execution of the cursor's query.
+      Bind time will be substituted into the execution of the cursor's
+      query.
     </para>
    </listitem>
    <listitem>
     <para>
-      Fix hash joins and aggregates of INET and CIDR data types (Tom)
+      Fix hash joins and aggregates of <type>inet</type> and
+      <type>cidr</type> data types (Tom)
     </para>
     <para>
-      Release 7.4 handled hashing of mixed INET and CIDR values incorrectly.
+      Release 7.4 handled hashing of mixed <type>inet</type> and
-      (This bug did not exist in prior releases because they wouldn't try
+      <type>cidr</type> values incorrectly.  (This bug did not exist
-      to hash either datatype.)
+      in prior releases because they wouldn't try to hash either
+      datatype.)
     </para>
    </listitem>
@@ -719,8 +761,9 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Allow BEGIN WORK to specify transaction isolation levels like START
+      Allow <command>BEGIN WORK</command> to specify transaction
-      TRANSACTION (Bruce)
+      isolation levels like <command>START TRANSACTION</command> does
+      (Bruce)
     </para>
    </listitem>
@@ -824,12 +867,13 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Change EXECUTE to return a completion tag matching the executed statement
+      Change <command>EXECUTE</command> to return a completion tag
-      (Kris Jurka)
+      matching the executed statement (Kris Jurka)
     </para>
     <para>
-      Previous releases return an EXECUTE tag for any EXECUTE call. In
+      Previous releases return an <command>EXECUTE</command> tag for
-      this release, the tag returned will reflect the command executed.
+      any <command>EXECUTE</command> call. In this release, the tag
+      returned will reflect the command executed.
     </para>
    </listitem>
@@ -864,14 +908,15 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
      control whether tables are created with OIDs by default (Neil)
     </para>
     <para>
-      This allows administrators to default all CREATE TABLE commands to
+      This allows administrators to default all <command>CREATE
-      create tables without OID columns.
+      TABLE</command> commands to create tables without OID columns.
     </para>
    </listitem>
    <listitem>
     <para>
-      Add WITH / WITHOUT OIDS clause to CREATE TABLE AS (Neil)
+      Add WITH / WITHOUT OIDS clause to <command>CREATE TABLE
+      AS</command> (Neil)
     </para>
    </listitem>
@@ -911,7 +956,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Allow multiple ALTER actions in a single ALTER TABLE command (Rod)
+      Allow multiple ALTER actions in a single <command>ALTER
+      TABLE</command> command (Rod)
     </para>
     <para>
      This is particularly useful for ALTER commands that rewrite the
@@ -923,7 +969,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Allow ALTER TABLE to add SERIAL columns (Tom)
+      Allow <command>ALTER TABLE</command> to add <type>serial</type>
+      columns (Tom)
     </para>
     <para>
      This is related to the new capability of adding defaults for new
@@ -996,13 +1043,15 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Allow CREATE SCHEMA to create triggers, indexes, and sequences (Neil)
+      Allow <command>CREATE SCHEMA</command> to create triggers,
+      indexes, and sequences (Neil)
     </para>
    </listitem>
    <listitem>
     <para>
-      Add ALSO keyword to CREATE RULE (Fabien Coelho)
+      Add ALSO keyword to <command>CREATE RULE</command> (Fabien
+      Coelho)
     </para>
     <para>
      This allows ALSO to be added to rule creation to contrast it with
@@ -1012,23 +1061,25 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Add NOWAIT option to LOCK command (Tatsuo)
+      Add NOWAIT option to <command>LOCK</command> (Tatsuo)
     </para>
     <para>
-      This allows the LOCK command to fail if it would have to wait for
+      This allows the <command>LOCK</command> command to fail if it
-      the requested lock.
+      would have to wait for the requested lock.
     </para>
    </listitem>
    <listitem>
     <para>
-      Allow COPY to read and write comma-separated-value (CSV) files (Andrew, Bruce)
+      Allow <command>COPY</command> to read and write
+      comma-separated-value (CSV) files (Andrew, Bruce)
     </para>
    </listitem>
    <listitem>
     <para>
-      Generate error if the COPY delimiter and NULL string conflict (Bruce)
+      Generate error if the <command>COPY</command> delimiter and NULL
+      string conflict (Bruce)
     </para>
    </listitem>
@@ -1040,7 +1091,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Avoid locking conflict between CREATE INDEX and CHECKPOINT (Tom)
+      Avoid locking conflict between <command>CREATE INDEX</command>
+      and <command>CHECKPOINT</command> (Tom)
     </para>
     <para>
      In 7.3 and 7.4, a long-running btree index build could block concurrent
@@ -1051,14 +1103,16 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Database-wide ANALYZE does not hold locks across tables (Tom)
+      Database-wide <command>ANALYZE</command> does not hold locks
+      across tables (Tom)
     </para>
     <para>
-      This reduces the potential for deadlocks against other backends that
+      This reduces the potential for deadlocks against other backends
-      want exclusive locks on tables.  To get the benefit of this change,
+      that want exclusive locks on tables.  To get the benefit of this
-      do not execute database-wide ANALYZE inside a transaction block
+      change, do not execute database-wide <command>ANALYZE</command>
-      (BEGIN block); it must be able to commit and start a new transaction
+      inside a transaction block (<command>BEGIN</command> block); it
-      for each table.
+      must be able to commit and start a new transaction for each
+      table.
     </para>
    </listitem>
@@ -1067,11 +1121,12 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
      Erase MD5 user passwords when a user is renamed (Bruce)
     </para>
     <para>
-      PostgreSQL uses the user name as salt when encrypting passwords
+      <productname>PostgreSQL</productname> uses the user name as salt
-      via MD5. When a user name is changed, their salt no longer matches
+      when encrypting passwords via MD5. When a user name is changed,
-      the stored MD5 password, so the stored password becomes useless.
+      their salt no longer matches the stored MD5 password, so the
-      In this release a notice is generated and the password
+      stored password becomes useless.  In this release a notice is
-      is cleared.  A new password must then be assigned.
+      generated and the password is cleared.  A new password must then
+      be assigned.
     </para>
    </listitem>
@@ -1127,7 +1182,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
      Reject non-rectangular array literals as erroneous (Joe)
     </para>
     <para>
-      Formerly, array_in would silently build a surprising result.
+      Formerly, <literal>array_in</literal> would silently build a
+      surprising result.
     </para>
    </listitem>
@@ -1174,11 +1230,11 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Change factorial function to return NUMERIC (Gavin)
+      Change factorial function to return <type>numeric</type> (Gavin)
     </para>
     <para>
-      Returning NUMERIC allows the factorial function to work for a wider
+      Returning <type>numeric</type> allows the factorial function to
-      range of input values.
+      work for a wider range of input values.
     </para>
    </listitem>
@@ -1217,7 +1273,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Better support for IEEE Infinity and NaN values in float4, float8 (Neil)
+      Better support for IEEE Infinity and NaN values in
+      <type>float4</type>, <type>float8</type> (Neil)
     </para>
     <para>
      These should now work on all platforms that support IEEE-compliant
@@ -1448,7 +1505,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Make psql \copy match COPY command syntax fully (Tom)
+      Make psql \copy match <command>COPY</command> command syntax
+      fully (Tom)
     </para>
    </listitem>
@@ -1460,7 +1518,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Add CLUSTER information to psql \d display (Bruce)
+      Add <command>CLUSTER</command> information to psql \d display
+      (Bruce)
     </para>
    </listitem>
@@ -1478,7 +1537,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Add global psql config file, psqlrc.sample (Bruce)
+      Add global psql config file, <filename>psqlrc.sample</filename>
+      (Bruce)
     </para>
     <para>
      This allows a central file where global psql startup commands can
@@ -1594,8 +1654,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      Allow PQoidValue(), PQcmdTuples(), and PQoidStatus() to work
+      Allow PQoidValue(), PQcmdTuples(), and PQoidStatus() to work on
-      on EXECUTE commands (Neil)
+      <command>EXECUTE</command> commands (Neil)
     </para>
    </listitem>
@@ -1665,10 +1725,11 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
      New "PostgreSQL" CVS tag (Marc)
     </para>
     <para>
-      This was done to make it easier for organizations to manage their own
+      This was done to make it easier for organizations to manage
-      copies of the PostgreSQL CVS repository.  File version stamps from the
+      their own copies of the <productname>PostgreSQL</productname>
-      master repository will not get munged by checking into or out of
+      CVS repository.  File version stamps from the master repository
-      a copied repository.
+      will not get munged by checking into or out of a copied
+      repository.
     </para>
    </listitem>
@@ -1880,7 +1941,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.287 2004/08/21 03:25:34 momjian
    <listitem>
     <para>
-      New /contrib/trgm, trigram matching for PostgreSQL (Teodor)
+      New /contrib/trgm, trigram matching for
+      <productname>PostgreSQL</productname> (Teodor)
     </para>
    </listitem>
@@ -2037,7 +2099,7 @@ names from outer query levels.
 <para>
  This fixes a difficult-to-exploit security hole.
 </para></listitem>
-<listitem><para>Avoid locking conflict between ANALYZE and LISTEN/NOTIFY</para></listitem>
+<listitem><para>Avoid locking conflict between <command>ANALYZE</command> and <command>LISTEN</command>/<command>NOTIFY</command></para></listitem>
 <listitem><para>Numerous translation updates (various contributors)</para></listitem>
 </itemizedlist>

--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.278 2004/08/16 02:12:29 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.279 2004/08/24 00:06:50 neilc Exp $
 -->
 <Chapter Id="runtime">
@@ -1206,17 +1206,16 @@ SET ENABLE_SEQSCAN TO OFF;
       <listitem>
        <para>
         Specifies the delay between activity rounds for the
-         background writer.  In each round the writer issues writes for some
+         background writer.  In each round the writer issues writes
-         number of dirty buffers (controllable by the following parameters).
+         for some number of dirty buffers (controllable by the
-         The selected buffers will always be the
+         following parameters).  The selected buffers will always be
-         least recently used ones among the currently dirty buffers.
+         the least recently used ones among the currently dirty
-         It then sleeps for <varname>bgwriter_delay</varname> milliseconds,
+         buffers.  It then sleeps for <varname>bgwriter_delay</>
-         and repeats.
+         milliseconds, and repeats.  The default value is 200. Note
-         Note that on many systems, the effective resolution
+         that on many systems, the effective resolution of sleep
-         of sleep delays is 10 milliseconds; setting
+         delays is 10 milliseconds; setting <varname>bgwriter_delay</>
-         <varname>bgwriter_delay</varname> to a value that is
+         to a value that is not a multiple of 10 may have the same
-         not a multiple of 10 may have the same results as setting it
+         results as setting it to the next higher multiple of 10.
-         to the next higher multiple of 10.
         This option can only be set at server start or in the
         <filename>postgresql.conf</filename> file.
        </para>
@@ -1227,10 +1226,10 @@ SET ENABLE_SEQSCAN TO OFF;
       <term><varname>bgwriter_percent</varname> (<type>integer</type>)</term>
       <listitem>
        <para>
-         In each round, no more than this percentage of the currently dirty
+         In each round, no more than this percentage of the currently
-         buffers will be written (rounding up any fraction to the next whole
+         dirty buffers will be written (rounding up any fraction to
-         number of buffers).
+         the next whole number of buffers).  The default value is
-         This option can only be set at server start or in the
+         1. This option can only be set at server start or in the
         <filename>postgresql.conf</filename> file.
        </para>
       </listitem>
@@ -1240,8 +1239,9 @@ SET ENABLE_SEQSCAN TO OFF;
       <term><varname>bgwriter_maxpages</varname> (<type>integer</type>)</term>
       <listitem>
        <para>
-         In each round, no more than this many dirty buffers will be written.
+         In each round, no more than this many dirty buffers will be
-         This option can only be set at server start or in the
+         written. The default value is 100. This option can only be
+         set at server start or in the
         <filename>postgresql.conf</filename> file.
        </para>
       </listitem>
@@ -1250,9 +1250,10 @@ SET ENABLE_SEQSCAN TO OFF;
     <para>
      Smaller values of <varname>bgwriter_percent</varname> and
-      <varname>bgwriter_maxpages</varname> reduce the extra I/O load caused by
+      <varname>bgwriter_maxpages</varname> reduce the extra I/O load
-      the background writer, but leave more work to be done at checkpoint
+      caused by the background writer, but leave more work to be done
-      time.  To reduce load spikes at checkpoints, increase the values.
+      at checkpoint time.  To reduce load spikes at checkpoints,
+      increase the values.
     </para>
    </sect3>

--- a/doc/src/sgml/xfunc.sgml
+++ b/doc/src/sgml/xfunc.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/xfunc.sgml,v 1.85 2004/07/30 12:26:39 petere Exp $
+$PostgreSQL: pgsql/doc/src/sgml/xfunc.sgml,v 1.86 2004/08/24 00:06:50 neilc Exp $
 -->
 <sect1 id="xfunc">
@@ -1618,17 +1618,18 @@ concat_text(PG_FUNCTION_ARGS)
   </indexterm>
   <para>
-    If you are thinking about distributing your PostgreSQL extension
+    If you are thinking about distributing your
-    modules, setting up a portable build system for them can be fairly
+    <productname>PostgreSQL</> extension modules, setting up a
-    difficult.  Therefore the PostgreSQL installation provides a build
+    portable build system for them can be fairly difficult.  Therefore
+    the <productname>PostgreSQL</> installation provides a build
    infrastructure for extensions, called <acronym>PGXS</acronym>, so
    that simple extension modules can be built simply against an
    already installed server.  Note that this infrastructure is not
    intended to be a universal build system framework that can be used
-    to build all software interfacing to PostgreSQL; it simply
+    to build all software interfacing to <productname>PostgreSQL</>;
-    automates common build rules for simple server extension modules.
+    it simply automates common build rules for simple server extension
-    For more complicated packages, you need to write your own build
+    modules.  For more complicated packages, you need to write your
-    system.
+    own build system.
   </para>
   <para>
@@ -1807,14 +1808,13 @@ include $(PGXS)
    <title>Composite-Type Arguments in C-Language Functions</title>
    <para>
-     Composite types do not  have  a  fixed  layout  like  C
+     Composite types do not have a fixed layout like C structures.
-     structures.   Instances of a composite type may contain
+     Instances of a composite type may contain null fields.  In
-     null fields.  In addition,  composite  types  that  are
+     addition, composite types that are part of an inheritance
-     part  of  an  inheritance  hierarchy may have different
+     hierarchy may have different fields than other members of the
-     fields than other members of the same inheritance hierarchy.    
+     same inheritance hierarchy.  Therefore,
-     Therefore,  <productname>PostgreSQL</productname>  provides  
+     <productname>PostgreSQL</productname> provides a function
-     a function interface for accessing fields of composite types  
+     interface for accessing fields of composite types from C.
-     from C.
    </para>
    <para>