Add a few more xrefs, where they seemed appropriate: for example, refer

to the discussion of planner statistics in the documentation for the
default_statistics_target GUC var.

diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml
index d10be7f2905653f5d9529d8e6e39c6d0e34f9385..023f12e606a3d30b390bbc14c09f0dabd1c37eba 100644 (file)
--- a/doc/src/sgml/ref/alter_table.sgml
+++ b/doc/src/sgml/ref/alter_table.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.64 2003/12/01 22:07:58 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.65 2004/03/01 17:58:39 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -114,7 +114,10 @@ ALTER TABLE <replaceable class="PARAMETER">name</replaceable>
       sets the per-column statistics-gathering target for subsequent
       <xref linkend="sql-analyze" endterm="sql-analyze-title"> operations.
       The target can be set in the range 0 to 1000; alternatively, set it
-      to -1 to revert to using the system default statistics target.
+      to -1 to revert to using the system default statistics
+      target. For more information on the use of statistics by the
+      <productname>PostgreSQL</productname> query planner, refer to
+      <xref linkend="planner-stats">.
      </para>
     </listitem>
    </varlistentry>

diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index 4af03bccfaac701c70517fb1dbb90b8d56b24405..84e99b5a063e5357952e427718d82d5936be79c0 100644 (file)
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_table.sgml,v 1.77 2003/12/01 22:07:58 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_table.sgml,v 1.78 2004/03/01 17:58:39 neilc Exp $
 PostgreSQL documentation
 -->
 
@@ -151,7 +151,10 @@ and <replaceable class="PARAMETER">table_constraint</replaceable> is:
     <term><replaceable class="PARAMETER">data_type</replaceable></term>
     <listitem>
      <para>
-      The data type of the column. This may include array specifiers.
+      The data type of the column. This may include array
+      specifiers. For more information on the data types included with
+      <productname>PostgreSQL</productname>, refer to <xref
+      linkend="datatype">.
      </para>
     </listitem>
    </varlistentry>

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 2084404f0505ade65e80367506bc7542cf4ab616..55e0f21b0b9b3e2572208c0392485596585ca845 100644 (file)
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.242 2004/02/23 20:45:58 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.243 2004/03/01 17:58:39 neilc Exp $
 -->
 
 <Chapter Id="runtime">
@@ -1562,11 +1562,13 @@ SET ENABLE_SEQSCAN TO OFF;
       <term><varname>default_statistics_target</varname> (<type>integer</type>)</term>
       <listitem>
        <para>
-        Sets the default statistics target for table columns that have not
-        had a column-specific target set via <command>ALTER TABLE SET
-        STATISTICS</>.  Larger values increase the time needed to do
-        <command>ANALYZE</>, but may improve the quality of the planner's
-        estimates. The default is 10.
+        Sets the default statistics target for table columns that have
+        not had a column-specific target set via <command>ALTER TABLE
+        SET STATISTICS</>.  Larger values increase the time needed to
+        do <command>ANALYZE</>, but may improve the quality of the
+        planner's estimates. The default is 10. For more information
+        on the use of statistics by the <productname>PostgreSQL</>
+        query planner, refer to <xref linkend="planner-stats">.
        </para>
       </listitem>
      </varlistentry>