From 1a6a27650d835c7d413b3beba2e9400b9af9c23b Mon Sep 17 00:00:00 2001
From: Neil Conway <neilc@samurai.com>
Date: Mon, 1 Mar 2004 17:58:39 +0000
Subject: [PATCH] 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.

---
 doc/src/sgml/ref/alter_table.sgml  |  7 +++++--
 doc/src/sgml/ref/create_table.sgml |  7 +++++--
 doc/src/sgml/runtime.sgml          | 14 ++++++++------
 3 files changed, 18 insertions(+), 10 deletions(-)

diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml
index d10be7f290..023f12e606 100644
--- 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 4af03bccfa..84e99b5a06 100644
--- 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 2084404f05..55e0f21b0b 100644
--- 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>