From: Bruce Momjian <bruce@momjian.us>
Date: Wed, 31 Jan 2007 04:13:28 +0000 (+0000)
Subject: Document need for periodic REINDEX in VACUUM FULL cases.
X-Git-Tag: REL8_2_2~10
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8c14912cc1d907fc10c94c3c52b98cde21c715a5;p=thirdparty%2Fpostgresql.git

Document need for periodic REINDEX in VACUUM FULL cases.
---

diff --git a/doc/src/sgml/maintenance.sgml b/doc/src/sgml/maintenance.sgml
index 4b321ca31bf..764d378bb68 100644
--- a/doc/src/sgml/maintenance.sgml
+++ b/doc/src/sgml/maintenance.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.64 2006/11/05 22:42:07 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.64.2.1 2007/01/31 04:13:28 momjian Exp $ -->
 
 <chapter id="maintenance">
  <title>Routine Database Maintenance Tasks</title>
@@ -613,9 +613,7 @@ analyze threshold = analyze base threshold + analyze scale factor * number of tu
    for inefficient use of space: if all but a few index keys on a page have
    been deleted, the page remains allocated.  So a usage pattern in which all
    but a few keys in each range are eventually deleted will see poor use of
-   space.  The potential for bloat is not indefinite &mdash; at worst there
-   will be one key per page &mdash; but it may still be worthwhile to schedule
-   periodic reindexing for indexes that have such usage patterns.
+   space.  For such usage patterns, periodic reindexing is recommended.
   </para>
 
   <para>
diff --git a/doc/src/sgml/ref/vacuum.sgml b/doc/src/sgml/ref/vacuum.sgml
index cf039113f64..86bdeb9291c 100644
--- a/doc/src/sgml/ref/vacuum.sgml
+++ b/doc/src/sgml/ref/vacuum.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/vacuum.sgml,v 1.43 2006/11/05 22:42:07 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/vacuum.sgml,v 1.43.2.1 2007/01/31 04:13:28 momjian Exp $
 PostgreSQL documentation
 -->
 
@@ -167,6 +167,9 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] ANALYZE [ <replaceable class="PARAMETER">
     most of the rows in a table and would like the table to physically shrink
     to occupy less disk space.  <command>VACUUM FULL</command> will usually
     shrink the table more than a plain <command>VACUUM</command> would.
+    The <option>FULL</option> option does not shrink indexes; a periodic
+    <command>REINDEX</> is still recommended.  In fact, it is often faster
+    to drop all indexes, <command>VACUUM FULL</>, and recreate the indexes.
    </para>
 
    <para>