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 d10be7f2905..023f12e606a 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 4af03bccfaa..84e99b5a063 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 2084404f050..55e0f21b0b9 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>
--
GitLab