This patch includes more SGML markup fixes as well as a few minor

additions to the docs.

Neil Conway

doc/src/sgml/ddl.sgml

-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ddl.sgml,v 1.10 2002/11/15 03:11:15 momjian Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/ddl.sgml,v 1.11 2003/02/19 03:13:24 momjian Exp $ -->
 
 <chapter id="ddl">
  <title>Data Definition</title>
@@ -189,7 +189,7 @@ DROP TABLE products;
       individual table a row came from.  The
       <structfield>tableoid</structfield> can be joined against the
       <structfield>oid</structfield> column of
-      <classname>pg_class</classname> to obtain the table name.
+      <structname>pg_class</structname> to obtain the table name.
      </para>
     </listitem>
    </varlistentry>
@@ -904,9 +904,9 @@ WHERE c.altitude &gt; 500;
    139798 | Madison   |      845
 </programlisting>
 
-   (If you try to reproduce this example, you will probably get different
-   numeric OIDs.)  By doing a join with pg_class you can see the actual table
-   names:
+   (If you try to reproduce this example, you will probably get
+   different numeric OIDs.)  By doing a join with
+   <structname>pg_class</> you can see the actual table names:
 
 <programlisting>
 SELECT p.relname, c.name, c.altitude

doc/src/sgml/ref/create_table.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.61 2003/01/19 00:13:29 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_table.sgml,v 1.62 2003/02/19 03:13:25 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -230,7 +230,10 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
       for large tables, since it will reduce OID consumption and
       thereby postpone wraparound of the 32-bit OID counter.  Once the
       counter wraps around, uniqueness of OIDs can no longer be
-      assumed, which considerably reduces their usefulness.
+      assumed, which considerably reduces their usefulness. Specifying
+      <literal>WITHOUT OIDS</literal> also reduces the space required
+      to store the table on disk by 4 bytes per row of the table,
+      thereby improving performance.
      </para>
     </listitem>
    </varlistentry>
@@ -881,8 +884,8 @@ CREATE ASSERTION <replaceable>name</replaceable> CHECK ( <replaceable>condition<
 
 <!--    
     <para>
-     Domain constraints are defined by CREATE DOMAIN or ALTER DOMAIN
-     statements:
+     Domain constraints are defined by <command>CREATE
+     DOMAIN</command> or <command>ALTER DOMAIN</command> statements:
     </para>
     <para>
      Domain constraint: 

doc/src/sgml/ref/create_type.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_type.sgml,v 1.38 2003/01/19 00:13:29 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_type.sgml,v 1.39 2003/02/19 03:13:25 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -218,7 +218,8 @@ CREATE TYPE
   <para>
    The first form of <command>CREATE TYPE</command> creates a new base type
    (scalar type).  It  requires  the
-   registration of two functions (using CREATE FUNCTION) before defining the
+   registration of two functions (using <command>CREATE
+   FUNCTION</command>) before defining the
    type. The representation of a new base type is determined by
    <replaceable class="parameter">input_function</replaceable>, which
    converts the type's external  representation  to  an  internal
@@ -400,8 +401,8 @@ CREATE TYPE
    <para>
     User-defined type names cannot begin with the underscore character
     (<quote><literal>_</literal></quote>) and can only be 62
-    characters long (or in general <literal>NAMEDATALEN-2</>, rather than
-    the <literal>NAMEDATALEN-1</> characters allowed for other names).
+    characters long (or in general <symbol>NAMEDATALEN</symbol> - 2, rather than
+    the <symbol>NAMEDATALEN</symbol> - 1 characters allowed for other names).
     Type names beginning with underscore are
     reserved for internally-created array type names.
    </para>

doc/src/sgml/syntax.sgml

 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/syntax.sgml,v 1.74 2002/11/15 03:11:17 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/syntax.sgml,v 1.75 2003/02/19 03:13:24 momjian Exp $
 -->
 
 <chapter id="sql-syntax">
@@ -121,9 +121,9 @@ INSERT INTO MY_TABLE VALUES (3, 'hi there');
     characters of an identifier; longer names can be written in
     commands, but they will be truncated.  By default,
     <symbol>NAMEDATALEN</symbol> is 64 so the maximum identifier
-    length is 63 (but at the time <productname>PostgreSQL</> is built,
-    <symbol>NAMEDATALEN</symbol> can be changed in
-    <filename>src/include/postgres_ext.h</filename>).
+    length is 63. If this limit is problematic, it can be raised by
+    changing the <symbol>NAMEDATALEN</symbol> constant in
+    <filename>src/include/postgres_ext.h</filename>.
    </para>
 
    <para>
@@ -541,8 +541,8 @@ CAST ( '<replaceable>string</replaceable>' AS <replaceable>type</replaceable> )
      <para>
       A dollar sign (<literal>$</literal>) followed by digits is used
       to represent the positional parameters in the body of a function
-      definition.  In other contexts the dollar sign may be part of an
-      operator name.
+      definition or a prepared statement.  In other contexts the
+      dollar sign may be part of an operator name.
      </para>
     </listitem>